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

任務(quests)

做一個村民會發的委託:打倒生物、收集物品、找到地點、跟人說話,完成後拿到金幣、經驗和物品。

這能讓你做什麼#

一個任務有標題、說明、一到四個目標,和獎勵。你只能用遊戲已經會追蹤的目標種類(打倒、收集、找到地點、跟人說話、提升關係),不能發明新種類。任務可以讓指定職業或指定村民自動發出,也可以從你自己的 對話 裡發。

在編輯器裡#

在編輯器左欄「劇情」底下的「任務」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆,一筆就是一個任務。新任務預設是打倒三隻狼,由旅店老闆給任務,獎勵 50 金幣和 100 經驗值。

這一類有自己的表單,由上到下是:

  • 「任務類別」(個人、村莊、傳聞,只影響任務日誌怎麼分類)、「任務名稱」、「任務說明」。
  • 「目標」:最多 4 個,全部完成才算達成。種類有「擊倒生物」「收集物品」「找到地點」「提升關係」「找人說話」,按「加一個目標」新增。
  • 「獎勵」:「金幣」「經驗值」「物品獎勵」「關係獎勵」,都可以不填。
  • 「時限」:遊戲內的小時,1 到 240。不設就是沒有時限。
  • 「誰會給這個任務」:選了職業或村民,遊戲會自動讓他們說出接任務的話。不選的話,要在對話裡用「給玩家一個任務」。
  • 「接任務時的台詞」:「村民的話」「同意的回答」「婉拒的回答」,另有選填的「同意之後村民說」和「什麼情況下才問」。
  • 「交任務時的台詞」:選填,按「加上交任務台詞」。沒有的話,用村民平常的「交任務」按鈕。目標裡指定了某位村民時,一定要寫。

右邊是「任務日誌」預覽,畫成玩家在日誌裡會看到的卡片。底下的「會給這個任務的對話」會列出哪些對話會把它發出去;還沒有人給時,會提示你到「對話」加一個「給玩家一個任務」,或在這裡指定誰會給。

進階:手寫 JSON#

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

任務表放在 data/quests.json,並在 mod.json 的 content 裡寫 "quests": "data/quests.json"。

最小可用範例#

旅館主人委託玩家打倒五隻餘燼狼,再跟獵人鹿棲說一聲,最後回來領賞:

data/quests.json
[
  {
    "id": "wolf_pack",
    "category": "village",
    "title": "狼群",
    "titles": { "en": "The wolf pack" },
    "description": "打倒五隻餘燼狼,再去和路奇說一聲,最後回旅店找老闆領賞。",
    "descriptions": { "en": "Defeat five ember wolves, tell Luqi about it, then see the innkeeper for your reward." },
    "objectives": [ { "type": "kill", "species": "ember_wolf", "count": 5 }, { "type": "talk", "npc": "luqi" } ],
    "rewards": { "gold": 60, "xp": 150, "items": [ { "item": "wolf_pelt", "count": 1 } ] },
    "giver": { "roles": ["INNKEEPER"] },
    "offer": {
      "text": "最近老有狼在村子外面打轉。你能幫忙趕走牠們嗎?",
      "accept": "交給我。",
      "decline": "現在不行。"
    },
    "turnIn": {
      "text": "怎麼樣,狼群解決了嗎?",
      "handIn": "都處理好了。",
      "notYet": "還在處理。",
      "thanks": "太好了,這是你的謝禮。"
    }
  }
]

title 和 description 的寫法跟別的表一樣:主要語言直接寫,其他語言補在 titles、descriptions(en、zh-TW、zh-CN)。

欄位#

欄位範圍與意思
id(必要)本地名稱,規則同其他表
categorypersonal(個人,預設)、village(村莊)、rumor(傳聞)
title、titles(必要)標題,最長 60 字
description、descriptions(必要)說明,最長 400 字
objectives(必要)目標,1 到 4 個,見下面「目標」。全部達成才能交任務
rewards獎勵,見下面「獎勵」
dueHours時限,1 到 240 個遊戲小時的整數。不寫就沒有時限
giver誰會發這個任務:{ "roles": [職業...] }、{ "npcs": [村民...] }、兩個一起寫,或 "all"。職業與村民的清單見 對話
offer接任務的對白。有 giver 就一定要寫
turnIn交任務的對白。giver 指定了有名字的村民時一定要寫

目標#

`type`其他欄位意思
killspecies、count(1 到 50)打倒這種生物這麼多隻。可以是原版的、你自己物種表裡的,或 @別的模組/id
collectitem、count(1 到 999)身上有這麼多這種物品(原版或模組的)。交任務時才檢查
discoversite找到一個地點,見下面的清單。接任務時,村民會先給這個地點的傳聞
relationshipnpc、field、value(-100 到 100)和某位有名字的村民的關係達到某個數字。field 可用 affinity、trust、respect、fear、debt、intimacy
talknpc 或 role,兩個擇一和某位有名字的村民說話,或和任何一位某職業的村民說話。開始對話就算完成

discover 的 site 只能是遊戲裡已有的地點:

`site`地點
forbidden_mine_entrance禁忌礦坑入口
collapsed_watchtower塌陷的哨塔
drowned_shrine沉沒的神龕
hollow_beneath_the_mill磨坊底下的空洞
saltbone_camp鹽骨營地
old_toll_stone舊收路石
weeping_grove泣林
smugglers_cellar走私者地窖
ashfall_kiln落灰窯
thousand_step_stair千階梯
cracked_wellhead裂口井
lantern_keepers_hut守燈人小屋

獎勵#

欄位範圍
gold金幣,0 到 3000 的整數
xp經驗,0 到 3000 的整數
items最多 5 種:{ "item": 物品, "count": 1 到 99 }
relation最多 4 筆:{ "field": 關係項, "delta": -20 到 20 },給關係項加分或扣分

玩家怎麼拿到任務#

有兩種做法:

  • 寫 giver:遊戲會自動替那些村民加上接任務的對話(先說 offer.text,玩家可選 accept 或 decline)。同一個村民在你接了任務之後,不會再重複提供。要寫 offer;如果 giver 指定了有名字的村民,還要寫 turnIn,遊戲會替那位村民加上交任務的對話。
  • 不寫 giver:自己在 對話 表裡,用一個回答選項的效果 { "type": "offer_quest", "quest": "任務id" } 來發。這樣可以完全控制誰在什麼條件下發任務。
`offer` 的欄位意思
text(必要)村民說的話,最長 600 字
accept(必要)接受的回答,最長 200 字
decline(必要)拒絕的回答,最長 200 字
reply玩家接受後,村民再說的一句
conditions額外的條件(同 對話 的條件),最多 12 個
priority1 到 200,預設 45
`turnIn` 的欄位意思
text(必要)玩家帶著任務回來時,村民說的話
handIn(必要)玩家交任務的回答
notYet(必要)還沒完成時的回答(玩家選這個,任務會重新發出,原本放棄的人也能再接)
thanks交完之後村民再說的一句

想用自己的對話發這個任務時,不寫 giver,而是在對話表加這樣的選項:

json
{ "id": "take_it", "text": "我來處理。", "effects": [ { "type": "offer_quest", "quest": "old_watchtower" } ] }

不用 giver 的例子#

一個傳聞類任務:找到塌陷的哨塔,再帶三塊鐵礦回來。因為沒有 giver,要靠你的對話表用 offer_quest 發出。

data/quests.json
[
  {
    "id": "old_watchtower",
    "category": "rumor",
    "title": "塌陷的哨塔",
    "titles": { "en": "The collapsed watchtower" },
    "description": "有人說北邊的哨塔塌了,裡面還有舊時的鐵礦。去看看,帶三塊鐵礦回來。",
    "descriptions": { "en": "They say the northern watchtower has collapsed, with old iron ore inside. Go and look, then bring back three pieces of iron ore." },
    "objectives": [
      { "type": "discover", "site": "collapsed_watchtower" },
      { "type": "collect", "item": "iron_ore", "count": 3 }
    ],
    "rewards": { "gold": 40, "xp": 100, "relation": [ { "field": "respect", "delta": 3 } ] },
    "dueHours": 72
  }
]

常見錯誤#

  • 寫了 giver 卻沒寫 offer,或指定有名字的村民卻沒寫 turnIn。
  • objectives 超過 4 個,或一個都沒有。
  • talk 同時寫了 npc 和 role。只能擇一。
  • discover 的 site 填了自己編的名字。只能用上面清單裡的地點。
  • kill 的 count 超過 50,或 collect 的 count 超過 999。
  • 在對話表用 offer_quest 發一個你沒定義的任務。載入檢查會指出名字。
  • 獎勵超過上限。金幣與經驗最多各 3000,物品最多 5 種。