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

修改原版(patches)

微調遊戲原本就有的物品、配方、增益和敵人的數字。

修改原版讓你改遊戲本來就有的東西,而不是新增:把鐵劍調得暴擊高一點、讓某條配方低一級就能做、把殭屍的血量調低。每一筆指定一個目標,再寫要改的欄位。

為了不讓一個模組把遊戲弄壞,能改的欄位是白名單,而且有幅度限制:原本有的數字只能調到原值的 0.25 到 4 倍。

在編輯器裡#

在編輯器左欄「規則」底下的「修改原版」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆,一筆改一樣原版的東西。

欄位做什麼
要改哪一樣先選種類:物品、配方、增益或生物,再從搜尋式清單挑一樣原版的。這裡只能改原版;自己模組的東西,請直接到它的分頁改
改成什麼選好之後,只會列出可以改的欄位,旁邊顯示「原版 X → 現在 Y」。你沒動的欄位維持原版
物品能改能力數值(威力、護甲、暴擊率、出手速度等)、顏色(主要顏色、外形顏色、次要顏色),也能加上原本沒有的數值
配方能改需要等級、做出幾個、整份材料(「改材料」換成你指定的,「維持原版材料」則不動)
增益能改效果的數值,也能加上原本沒有的效果
生物能改血量、攻擊傷害、走路速度、追擊速度、攻擊間隔、體型

原本有的數字,只能調到原值的 0.25 到 4 倍。測試的話,按上方的「試玩」進測試場。

進階:手寫 JSON#

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

修改原版的路徑寫進 mod.json 的 content.patches。

最小可用範例#

四種目標各一筆:給鐵劍加暴擊並換個顏色、鐵劍配方降到 3 級、讓原版增益「猛力」變成 +6% 攻擊、殭屍血量設成 60:

data/patches.json
[
  { "target": "item:iron_sword", "set": { "stats": { "crit": 6 }, "color": "#ffd27a" } },
  { "target": "recipe:recipe_iron_sword", "set": { "requiredLevel": 3 } },
  { "target": "buff:meal_might", "set": { "effects": { "powerPct": 6 } } },
  { "target": "species:ZOMBIE", "set": { "maxHp": 60 } }
]

欄位#

欄位必填?意思可以填什麼
target必填要改哪一個。格式是「種類:代號」item:代號 recipe:代號 buff:代號 species:代號。代號是原版的、自己的,或 @模組/代號
set必填要改的欄位和新值,至少一項見下表,依種類不同

每種目標能改什麼#

種類可以改的欄位
itemstats 裡的各欄位(範圍同物品;也可以直接寫在 set 裡,damage 與 attack 當成 power,defense 當成 armor)、color、modelColor、secondaryColor
reciperequiredLevel(1 到 200)、outputCount(1 到 99)、ingredients(1 到 8 種,格式同配方)
buffeffects 裡的各欄位(範圍同增益)
speciesmaxHp、damage、walkSpeed、chaseSpeed、attackCooldownSec、scale

改數字的規則:

  • 原本就有、而且不是 0 的數字:只能改成原值的 0.25 到 4 倍。例如某隻敵人原本血量是 100,就只能設在 25 到 400 之間。
  • 原本是 0 的數字:要維持 0。
  • 原本沒有的欄位(例如一把沒有暴擊的劍加暴擊):用該欄位自己的絕對範圍,例如 crit 是 0 到 60。
  • 不在白名單的欄位一律拒絕,並說「不能用模組修改」。

怎麼引用別的東西#

  • target 裡的代號:原版代號(item:iron_sword、species:ZOMBIE,生物全大寫)、自己的本地代號,或 @模組/代號。
  • 改配方的 ingredients 時,每個 item 可以用原版、自己的或 @模組/代號。
  • 原版配方的代號通常是 recipe_ 開頭,例如 recipe_iron_sword。
  • 修改是在物品與增益載入之後、配方載入之前套用的。所以同一個模組裡,改配方的目標只能指向原版配方(別的模組先載入的配方也可以)。

常見錯誤#

  • target 沒有冒號或種類寫錯(例如 weapon:iron_sword):畫面會說看不懂修改目標,要寫成 item:代號、recipe:代號、buff:代號 或 species:代號。
  • 改太多:原本 100 的血量設成 1000,會看到「最多只能改成原本的 0.25 到 4 倍(原本 100,要改成 1000)」。
  • 改了白名單以外的欄位,例如把物品的 name 放進 set:會看到該欄位不能用模組修改。要改名請用翻譯檔。
  • set 是空的({}):這一筆沒有要做任何事。
  • 目標代號拼錯:畫面會說找不到物品、增益或生物「某某」。
  • 模組編輯器:不用手寫檔案,在遊戲裡用表單做模組。
  • 物品、配方、增益:各欄位的範圍。
  • 生物:想要的是一隻新的敵人,而不是改原本那隻。
  • 規則包:一次調整所有敵人的血量與傷害。