模組是正式版功能,試玩版沒有。正式版推出後開放,內容可能在推出前調整。

物品(items)

新增武器、防具、道具、材料與消耗品:寫名字、種類、數值和外觀,遊戲就多了一樣東西。

物品表可以讓你加入 22 種東西:劍、盾、弓、杖、槍、頭盔、護甲、披風、戒指、提燈、船、釣竿、材料、補血藥等等。每一筆是一個條目,寫上它叫什麼、是哪一種、數值多少、長什麼樣子。欄位就是條目裡的一項設定,例如 name(名字)或 type(種類)。

在編輯器裡#

在編輯器左欄「裝備與道具」底下的「物品」(左欄還沒有這一類的話,從最下面的「加入新的內容」加進來)。按「新增」從空白開始;或按「從原版複製」,挑一件原版物品,它的資料和造型會整份帶進來,名字加上「(複製)」,改一改就是你的。

欄位做什麼
名字、說明玩家看到的名字和說明。底下的「其他語言」可以展開填英文、簡中、繁中
類型劍、盾、弓、杖、護甲、提燈、船、材料、消耗品等,共 22 種
稀有度決定名字的顏色
外觀造型按「畫造型」(已經有造型時是「編輯造型」)打開方塊造型編輯器,自己用方塊畫。不畫的話,會用遊戲內建的同類型造型
顏色「主色」是圖示與掉落物的底色,「副色」是護手、握把這類配件的顏色
適用等級裝備才有,大約是幾級的玩家會用它
數值只列這個類型用得到的,例如攻擊力、出手速度、暴擊率、護甲、血量、魔力/怒氣、格擋率
使用效果消耗品才有:選藥水(回血)、藥劑(給增益)或食物,再設定「回復血量」「至少回復」「增益效果」「持續時間」
提燈光線提燈才有:光的顏色、亮度、照多遠
進階(預設收起)「其他數值」、「造型底色」、「圖示」,還有「加入一般掉落」(打開後,它也會照等級從怪物身上掉出來)

右欄的預覽會讓物品的 3D 造型轉著給你看,並列出數值摘要和「做出它的配方」。還沒有配方的話,可以直接按「為它加一個配方」。

想馬上在遊戲裡看它,按這一筆上方的「試這一個」:編輯器會存檔、進入測試場,並把這個物品放進你的背包。

進階:手寫 JSON#

下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。

物品表是一個 JSON 檔,最外層是 [ ],裡面放很多筆 { }。檔案放在模組資料夾裡,路徑寫進 mod.json 的 content.items。一筆有問題只會略過那一筆,其他照常載入。

最小可用範例#

一把很短的冰劍:六顆方塊拼成劍身,攻擊力 34。貼進 data/items.json 就能用。

data/items.json
[
  {
    "id": "frost_blade",
    "name": "霜刃",
    "names": { "en": "Frost Blade" },
    "description": "冰冷的刀身,揮起來很輕。",
    "type": "WEAPON",
    "rarity": "RARE",
    "icon": "sword",
    "color": "#9fd8ff",
    "stats": { "power": 34, "tempo": 8 },
    "voxels": [
      { "x": 0, "y": 0, "z": 0, "color": "#3a4a5c" },
      { "x": 0, "y": 1, "z": 0, "color": "#3a4a5c" },
      { "x": 0, "y": 2, "z": 0, "color": "#9fd8ff" },
      { "x": 0, "y": 3, "z": 0, "color": "#9fd8ff" },
      { "x": 0, "y": 4, "z": 0, "color": "#9fd8ff" },
      { "x": 0, "y": 5, "z": 0, "color": "#9fd8ff" }
    ]
  }
]

欄位#

欄位必填?意思可以填什麼
id必填這個模組裡的物品代號,之後別的檔案用它來指這件東西小寫英文或數字開頭,只能用小寫英文、數字、底線,最長 48 字。同一個檔案不能重複
name、names至少寫一個顯示名稱。names 放其他語言,例如 { "en": "Frost Blade" }每個最長 48 字
description、descriptions選填物品說明最長 400 字
type必填這是哪一種東西WEAPON SHIELD BOW STAFF GUN HELMET CHESTPLATE LEGGINGS BOOTS GLIDER LANTERN BOAT HOOK CHARM GLOVES CAPE RING AMULET TOOL ROD MATERIAL CONSUMABLE
rarity選填稀有度(決定名字顏色)COMMON(預設)UNCOMMON RARE EPIC LEGENDARY
icon選填背包裡的小圖示名稱不認得的名字會改用該種類的預設圖示,不會出錯
color、modelColor、secondaryColor選填主色、造型色、副色"#rrggbb" 六位十六進位。沒寫 color 就取造型裡最多的顏色
stats選填數值,見下表只能寫下表的欄位
referenceLevel選填這件裝備相當於幾級的東西1 到 200 的整數
voxels 或 model選填外觀:直接寫方塊,或指向模組裡的造型檔見下面「外觀」
voxelScale選填寫 0.5 代表方塊切得更細(精緻造型)0.5 或 1
lightColor、lightIntensity、lightDistance選填提燈類發的光顏色;強度 0 到 5;距離 0 到 40
use選填消耗品的用法只能用在 CONSUMABLE,見下面「消耗品」
levelPool選填true 時,這件裝備也會出現在一般等級掉落池true 或 false。不寫的話,只會從你在掉落表列出的地方掉

數值(stats)#

stats 裡只收下面這些欄位,每一項都有範圍。超出範圍不會被默默改小,而是整筆不載入,並告訴你「這個欄位應該是 A 到 B,你寫了 C」。

欄位意思範圍
power攻擊力0 到 2000
armor護甲0 到 2000
crit暴擊0 到 60
tempo出手速度-50 到 100
hp生命0 到 20000
mp魔力0 到 2000
resourcePct資源(怒氣、能量等)加成百分比0 到 100
moveSpeed移動速度-30 到 40
magazineSize彈匣容量(槍)1 到 120,整數
reloadMs換彈時間,毫秒(槍)200 到 8000,整數
block格擋(盾)0 到 95
guardStamina格擋時的體力消耗倍率(盾)0.2 到 3

外觀#

外觀就是一堆小方塊:每顆方塊是 { "x", "y", "z", "color" },座標是整數、絕對值不超過 64,一件物品最多 4000 顆,重複的座標只留第一顆。方塊少就直接寫在 voxels;方塊多就放進模組資料夾的 models/ 底下,用 "model": "models/名字.json" 指過去。造型檔可以是方塊清單,也可以是 { "voxels": [...], "voxelScale": 0.5 }:

models/frost_whistle.json
{
  "voxels": [
    { "x": 0, "y": 0, "z": 0, "color": "#cfe8ff" },
    { "x": 1, "y": 0, "z": 0, "color": "#cfe8ff" },
    { "x": 0, "y": 1, "z": 0, "color": "#9fd8ff" }
  ],
  "voxelScale": 0.5
}

不想手寫座標的話,在官網的道具編輯器畫好造型、按「匯出」,再到「創作模組」頁用「貼上道具」,遊戲會自動存成 models/<id>.json 並在物品表加一筆。也可以把匯出的整段文字直接當成物品表的一筆,id 有大寫會自動轉小寫,沒寫 type 就當成材料(MATERIAL):

data/items.json
[
  {
    "schema": "voxel-world-item",
    "id": "Custom_Lantern_Lx2K9",
    "name": "小燈籠",
    "type": "LANTERN",
    "voxels": [
      { "x": 0, "y": 0, "z": 0, "color": "#ffcc00" },
      { "x": 0, "y": 1, "z": 0, "color": "#ffe27a" }
    ]
  }
]

消耗品(use)#

想做一瓶藥或一份食物,type 要寫 CONSUMABLE,再加上 use:

欄位必填?意思可以填什麼
kind必填這是哪一種用法potion(補血藥)tonic(強化藥,一定要有 buff)food(食物)
healPct選填補血的百分比0 到 100
healFloor選填至少補多少血(血量少的時候也補得夠)0 到 1000,整數
buff選填(強化藥必填)吃了得到的增益,見增益原版增益代號、自己的增益或 @模組/代號
minutes選填增益持續幾分鐘1 到 120
data/items.json
[
  {
    "id": "warm_potion",
    "name": "暖身藥水",
    "names": { "en": "Warming Potion" },
    "type": "CONSUMABLE",
    "rarity": "UNCOMMON",
    "color": "#e8a060",
    "use": { "kind": "potion", "healPct": 30, "healFloor": 50, "buff": "meal_hearty", "minutes": 5 }
  }
]

怎麼引用別的東西#

  • use.buff 可以寫遊戲原版的增益代號(例如 meal_hearty)、你自己增益表裡的本地代號,或別的模組的 @模組代號/代號。
  • 別的檔案(配方、掉落、料理)要用到這件物品時,直接寫它的本地代號 frost_blade。找不到你模組裡有這個代號時,遊戲就把它當成原版代號去找。
  • 用到別的模組的東西時寫 @icepack/frost_shard,而且對方要列在你的 dependsOn(見模組資料夾與 mod.json)。

常見錯誤#

  • 忘了 type(只有官網匯出的整段文字可以省略)。畫面會說:缺少「type」。
  • stats 寫了不存在的欄位,例如 attack。要寫 power,不然會看到:「stats.attack」不能用模組修改。
  • use 寫在不是 CONSUMABLE 的物品上。
  • 顏色寫成 #fff。要寫滿六位:#ffffff。
  • 方塊座標不是整數,或超過 64,或超過 4000 顆,會看到:外觀讀不出來,或格子超出範圍。
  • name 超過 48 字,或 id 有大寫、空白、中文。
  • 同一個檔案裡 id 重複,或跟別的物品、魚、料理撞名。
  • 模組編輯器:不用手寫檔案,在遊戲裡用表單做模組。
  • 配方:讓玩家做出你的物品。
  • 掉落:讓敵人掉你的物品。
  • 增益:給消耗品一個效果。
  • 修改原版:調整原版物品的數字。