zh-tw:mtr_addon:nte:eyecandy

Table of Contents

裝飾對象

NTE 允許通過 ”裝飾對象“ 方塊在遊戲內顯示 OBJ 模型。

Teapot

使用

您可在創造模式物品欄 ”車站建築方塊” 一欄中獲得裝飾對象方塊。放置後,使用刷子右鍵它即可設置它所展示的模型。內置了一個 ”茶壺“ 模型供您試用,更多對象模型可通過資源包導入。

此方塊不可見。當您手持刷子時,方塊所在位置會顯示旋轉的刷子圖標,以便您尋找。如果您的資源包內缺少某模型,它將顯示為旋轉的屏障方塊圖標(紅色帶斜線的 0 字)。

按住 Ctrl 的同時按鼠標中鍵,即可拷貝一個保持選定的模型的物品,以便放置多個。不過,考慮到性能影響,不建議您使用得太多。

順帶一提,這個茶壺是在 1975 年由計算機圖形學者馬丁·紐維爾 (Martin Newell) 於猶他大學 (University of Utah) 工作期間創作的,因此得名 “Utah 茶壺”。

製作新對象

您可以通過在 assets/mtrsteamloco/eyecandies 文件夾內添加 JSON 文件來導入模型製作對象。其寫法大致如下:

{
    "name": "茶壺",
    "model": "mtrsteamloco:eyecandies/teapot.obj"
}

在上述例子裡,assets/mtrsteamloco/eyecandies/teapot.json 文件裡有著以上內容,同時 assets/mtrsteamloco/eyecandies/teapot.obj 文件是茶壺的 OBJ 模型。

如上是一個 JSON 文件說明一個對象的寫法。也可以在一個 JSON 文件內說明多個對象。

{
    "key1": {
        "name": "Name1",
        "model": "mtrsteamloco:eyecandies/model1.obj",
    },
    "key2": {
        "name": "Name2",
        "model": "mtrsteamloco:eyecandies/model2.obj",
        "textureId": "mtrsteamloco:textures/eyecandies/foobar.png",
        "translation": [ 0, 0, 0 ],
        "rotation": [ 0, 0, 0 ],
        "scale": [ 1, 1, 1 ],
        "mirror": [ false, false, false ]
    }
}

其中:

  • 在一個 JSON 文件內說明多個對象的寫法中,key1key2 等是內部記錄這個模型時所使用的名稱,可任意選取,不會顯示給玩家,但每個必須不同。在一個 JSON 文件說明一個模型的寫法中,會把 JSON 文件的文件名用作這一用途。

  • name 是這個模型顯示在選擇列表裡的名稱。

  • model 是這個模型所使用的 OBJ 文件的位置。

    需要按照 Minecraft 的 “資源位置” 寫法轉寫,即 assets/mtrsteamloco/eyecandies/teapot.obj 需寫為 mtrsteamloco:eyecandies/teapot.obj

    設置貼圖、渲染批量等的方法與 OBJ 模型相關適配 中相同。

    您使用的 OBJ 文件應當符合:相對於您放置對象時的朝向,X 軸正方向向右,Y 軸正方向向上,Z 軸正方向向後。每個單位長度為 1m。

以上是必填項。以下是可選項:

  • textureId 可用於創建多個同一模型不同貼圖的對象。用法與 OBJ 模型相關適配 中相同。
  • translation 對模型進行平移,後接 X、Y、Z 軸向上的移動距離。
  • rotation 對模型進行旋轉,後接繞 X、Y、Z 軸向上的轉動角度。
  • scale 對模型進行縮放,後接 X、Y、Z 軸向上的縮放比例,1 代表 100%。
  • mirror 對模型進行翻轉,後接三個布爾值,表示是否要對於 YZ、XZ、XY 平面翻轉。

請注意大括號、中括號、雙引號與逗號的使用。同時,所有文件名必須為全英文小寫。

zh-tw/mtr_addon/nte/eyecandy.txt · Last modified: 2023/02/23 12:40 by 127.0.0.1