物品(items)
新增武器、防具、道具、材料與消耗品:寫名字、種類、數值和外觀,遊戲就多了一樣東西。
物品表可以讓你加入 22 種東西:劍、盾、弓、杖、槍、頭盔、護甲、披風、戒指、提燈、船、釣竿、材料、補血藥等等。每一筆是一個條目,寫上它叫什麼、是哪一種、數值多少、長什麼樣子。欄位就是條目裡的一項設定,例如 name(名字)或 type(種類)。
在編輯器裡#
在編輯器左欄「裝備與道具」底下的「物品」(左欄還沒有這一類的話,從最下面的「加入新的內容」加進來)。按「新增」從空白開始;或按「從原版複製」,挑一件原版物品,它的資料和造型會整份帶進來,名字加上「(複製)」,改一改就是你的。
| 欄位 | 做什麼 |
|---|---|
| 名字、說明 | 玩家看到的名字和說明。底下的「其他語言」可以展開填英文、簡中、繁中 |
| 類型 | 劍、盾、弓、杖、護甲、提燈、船、材料、消耗品等,共 22 種 |
| 稀有度 | 決定名字的顏色 |
| 外觀造型 | 按「畫造型」(已經有造型時是「編輯造型」)打開方塊造型編輯器,自己用方塊畫。不畫的話,會用遊戲內建的同類型造型 |
| 顏色 | 「主色」是圖示與掉落物的底色,「副色」是護手、握把這類配件的顏色 |
| 適用等級 | 裝備才有,大約是幾級的玩家會用它 |
| 數值 | 只列這個類型用得到的,例如攻擊力、出手速度、暴擊率、護甲、血量、魔力/怒氣、格擋率 |
| 使用效果 | 消耗品才有:選藥水(回血)、藥劑(給增益)或食物,再設定「回復血量」「至少回復」「增益效果」「持續時間」 |
| 提燈光線 | 提燈才有:光的顏色、亮度、照多遠 |
| 進階(預設收起) | 「其他數值」、「造型底色」、「圖示」,還有「加入一般掉落」(打開後,它也會照等級從怪物身上掉出來) |
右欄的預覽會讓物品的 3D 造型轉著給你看,並列出數值摘要和「做出它的配方」。還沒有配方的話,可以直接按「為它加一個配方」。
想馬上在遊戲裡看它,按這一筆上方的「試這一個」:編輯器會存檔、進入測試場,並把這個物品放進你的背包。
進階:手寫 JSON#
下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。
物品表是一個 JSON 檔,最外層是 [ ],裡面放很多筆 { }。檔案放在模組資料夾裡,路徑寫進 mod.json 的 content.items。一筆有問題只會略過那一筆,其他照常載入。
最小可用範例#
一把很短的冰劍:六顆方塊拼成劍身,攻擊力 34。貼進 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 }:
{
"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):
[
{
"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 |
[
{
"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重複,或跟別的物品、魚、料理撞名。