配方(recipes)
決定一樣東西用哪些材料做、幾級才能做、哪些職業可以做。
配方表讓玩家可以「合成」東西:你寫要做出什麼、要用哪些材料、需要幾級。可以做你自己新增的物品,也可以替原版物品加一條新做法。
在編輯器裡#
在編輯器左欄「裝備與道具」底下的「配方」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一條配方。
| 欄位 | 做什麼 |
|---|---|
| 做出什麼 | 選這個模組的物品,或遊戲原本的物品。搜尋式清單,不用記代號 |
| 一次做出幾個 | 做一次得到的數量 |
| 材料 | 最多 8 種,至少要有一種。每種選一個物品,再填「需要幾個」 |
| 需要等級 | 玩家要到這個等級才能做 |
| 製作地點 | 營火或爐灶;不選就是隨時隨地都能做 |
| 限定職業 | 都不選就是所有職業都能做 |
測試的話,按上方的「試玩」進測試場。
進階:手寫 JSON#
下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。
配方表是一個 JSON 檔,最外層是 [ ],每一筆 { } 是一條配方。路徑寫進 mod.json 的 content.recipes。
最小可用範例#
用 4 塊鐵礦加 1 根木頭,在 3 級以上做出一把原版的鐵劍,而且只有戰士和忍者能做:
[
{
"id": "iron_sword_cheap",
"output": "iron_sword",
"count": 1,
"level": 3,
"classes": ["WARRIOR", "NINJA"],
"ingredients": [
{ "item": "iron_ore", "count": 4 },
{ "item": "wood", "count": 1 }
]
}
]欄位#
| 欄位 | 必填? | 意思 | 可以填什麼 |
|---|---|---|---|
id | 必填 | 這條配方的代號 | 小寫英文或數字開頭,只能用小寫英文、數字、底線,最長 48 字。同一個檔案不能重複 |
output | 必填 | 做出什麼 | 物品代號:自己的、原版的,或 @模組/代號 |
count | 選填 | 一次做出幾個 | 1 到 99 的整數,預設 1 |
ingredients | 必填 | 材料清單 | 1 到 8 種,每種是 { "item": 物品, "count": 數量 } |
ingredients[].item | 必填 | 材料是什麼 | 物品代號,寫法同 output |
ingredients[].count | 選填 | 要幾個 | 1 到 999 的整數,預設 1 |
level | 選填 | 玩家要幾級才能做 | 1 到 200 的整數,預設 1 |
classes | 選填 | 限定哪些職業才能做;不寫就是所有職業 | WARRIOR(戰士)MAGE(法師)RANGER(遊俠)NINJA(忍者)GUNNER(槍手)NECROMANCER(死靈法師)DRAGOON(龍騎士) |
station | 選填 | 要站在哪裡做;不寫就是到處都能做 | campfire(營火旁)或 stove(爐灶,營火旁也能做) |
怎麼引用別的東西#
output 和每個材料的 item 都可以用三種寫法:
[
{
"id": "frost_blade",
"output": "frost_blade",
"ingredients": [
{ "item": "iron_ore", "count": 4 },
{ "item": "@icepack/frost_shard", "count": 2 }
]
}
]frost_blade:本地代號。遊戲先找你自己模組的物品表有沒有這個代號,沒有就當成原版代號。iron_ore:原版物品代號。@icepack/frost_shard:別的模組icepack的物品。對方一定要列在你的dependsOn,不然會被擋下。
常見錯誤#
- 材料欄位寫成
itemId,要寫item。 - 輸出寫成
outputItemId,要寫output。 - 等級寫成
requiredLevel,要寫level(要改原版配方的等級是另一回事,見修改原版)。 - 材料是空的,或超過 8 種:畫面會說「ingredients」至少要有 1 項,或最多只能 8 項。
- 職業名稱寫成中文或小寫。要寫
WARRIOR這種全大寫英文。 - 畫面顯示「找不到物品「某某」」:代號拼錯,或那個東西是你自己的料理、魚、種子(見上面的提醒),或用了別的模組的東西卻沒列在
dependsOn。