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

對話(dialogue)

讓村民多說一句話,給玩家幾個可以回答的選項,答案可以改變好感、給東西、發任務或開啟下一句。

這能讓你做什麼#

表裡每一筆是一句村民會說的話(遊戲裡叫一個「節點」),可以附上玩家的回答選項。回答可以接到另一句,形成一小段對話。你能讓某個職業的村民(例如所有旅館主人)或某一位有名字的村民說這句話,並設定條件:好感夠高才說、只在晚上說、玩家身上有某樣東西才說。

有兩種句子:

  • 開場句:玩家跟村民搭話時,村民可能會挑來說的第一句。要用 attach 指定誰會說。
  • 接續句:只能從別句的回答 next 接過來,要寫 "start": false。接續句不會自己開啟對話,如果沒有任何一句指向它,載入檢查會告訴你「沒有人會說這句話」。

在編輯器裡#

在編輯器左欄「劇情」底下的「對話」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆,一筆就是村民說的一句話。新的一句預設由旅店老闆開口,帶一個「再見」的回答。

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

  • 「這句怎麼出現」:選「開場句:村民主動開口」,再指定「所有村民」或「指定職業或村民」;或選「接話:由某個回答接到這裡」,這一句不會自己出現,要在另一句的回答裡把它接過來。另有「可以當作談話的開頭」開關。
  • 「台詞」:「村民說的話」,最多 600 字。
  • 「出現時機」(不確定就不用動):「優先度」「權重」「隔幾天再說」「只說一次」。
  • 「什麼情況下才會說」:用條件卡片,按「加一個條件」。有「關係夠好」「玩家帶著某物品」「世界裡某件事已發生」「在某段時間」「說話的人是某職業」等,也能用「以下全部成立」「以下任一成立」「以下不成立」組合起來。不加就是隨時。
  • 「說到這句時會發生」:用效果卡片,按「加一個效果」,例如「改變關係」「讓村民記住一件事」「給玩家物品」「給玩家一個任務」「結束對話」。
  • 「玩家的回答」:最多 6 個。每個回答有「回答內容」和「語氣」,也可以設「這個回答什麼時候才出現」。回答可以是「一般回答」,或「要過能力檢定」(填「考哪一種能力」「難度」「運氣浮動」,成功與失敗各自接到不同的句子)。「接到哪一句」可以選已有的一句、「到此結束」,或按「新增一句並接上」直接長出下一句。

表單裡有一棵「對話樹」,綠邊的是開場句,往下是每個回答接到的下一句,點任何一句就跳去編它。沒有人接到、又不是開場句的一句會標出提示,因為它在遊戲裡不會出現。

右邊是「對話預覽」:從選中的這一句開始演,點回答往下走,按「重新開始」重來。預覽不檢查條件,所有回答都會顯示。

進階:手寫 JSON#

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

對話表放在 data/dialogue.json,並在 mod.json 的 content 裡寫 "dialogue": "data/dialogue.json"。

最小可用範例#

旅館主人會說一個傳聞。玩家可以追問,答完好感加 1;也可以直接道別:

data/dialogue.json
[
  {
    "id": "wolf_rumor",
    "attach": { "roles": ["INNKEEPER"] },
    "text": "旅人們都說,北邊的雪地有狼群出沒,牠們背上帶著霜。",
    "texts": { "en": "Travellers say wolves with frost on their backs roam the snowfields to the north." },
    "priority": 40,
    "cooldownDays": 1,
    "choices": [
      { "id": "more", "text": "還有什麼消息?", "tone": "kind", "next": "wolf_rumor_more" },
      { "id": "bye", "text": "謝謝,我會小心。" }
    ]
  },
  {
    "id": "wolf_rumor_more",
    "start": false,
    "text": "聽說只要不在夜裡落單,牠們就不太敢靠近。",
    "onEnter": [ { "type": "relation_delta", "delta": { "affinity": 1 } } ],
    "choices": [ { "id": "thanks", "text": "好的,謝謝。" } ]
  }
]

text 是主要語言的文字,texts 補其他語言(en、zh-TW、zh-CN)。回答選項的 text 也是同樣的寫法,可以加 texts。沒寫的語言會借用別的語言的文字。

一句話的欄位#

欄位範圍與意思
id(必要)本地名稱,規則同其他表。回答的 next 就是填這個
attach誰會說這句:{ "roles": [職業...] }、{ "npcs": [村民...] }、兩個一起寫,或 "all"(所有職業)。有 attach 的句子預設就是開場句
startfalse 表示這是接續句,只能被回答接過來。沒有 attach 時一定要寫 false
text、texts(必要)對白,最長 600 字
priority1 到 200,預設 40。同時有好幾句可以說時,數字大的先
weight0.1 到 10。這句被挑中的比重,不寫就是一般比重
cooldownDays0 到 30 天,預設 1。說過後隔幾天才會再說
oncenever(預設,可重複)、per_player(每位玩家只說一次)、per_world(整個世界只說一次)
conditions最多 12 個條件,全部成立才會說。見下面「條件」
onEnter說到這句的當下發生的效果,最多 8 個。見下面「效果」
choices玩家的回答,最多 6 個

回答選項#

欄位範圍與意思
id(必要)這句裡獨一無二的名稱
text、texts(必要)玩家要選的那句話,最長 200 字
tone語氣:honest(誠實)、kind(友善)、formal(正式)、bold(大膽)、threatening(威脅)、deceptive(欺騙)、humorous(幽默)、dismissive(輕蔑)
next選了之後接到哪一句(那一句的 id)。不寫就結束對話
effects選了之後發生的效果,最多 8 個
showIf條件,最多 12 個。成立時才看得到這個選項
check口才檢定:{ "kind": 種類, "difficulty": 0 到 60, "random": 0 到 20 }。kind 可用 persuasion、insight、intimidation、deception、etiquette、leadership。random 是隨機浮動的幅度,預設 6
success、failure搭配 check 使用:{ "next": 句子, "effects": [...] },分別是檢定成功與失敗時的結果

誰能說:職業與有名字的村民#

roles 填職業。說話的人是該職業的所有村民,包括有名字的那位。npcs 只針對有名字的那位。

`roles` 的值職業
MERCHANT商人
GUARD衛兵
BLACKSMITH鐵匠
INNKEEPER旅館主人
ELDER村長
FARMER農夫
ADVENTURER冒險者
FERRYMAN渡船人
HEALER醫者
HUNTER獵人
FISHER漁夫
MINER礦工
SCHOLAR學者
BARD吟遊詩人
STOREKEEPER倉庫管理員
STABLEMASTER馬夫
`npcs` 的值村民職業
bailu白露吟遊詩人
haisheng海生漁夫
luqi鹿棲獵人
tanwei譚維學者
yanshu岩姝礦工
qingwu青梧醫者
zhuoying卓瑩鐵匠
lingbo嶺伯村長
luochuan洛川衛兵
henan赫南商人
mira彌菈鐵匠
sukui蘇葵旅館主人

條件#

conditions 和 showIf 裡的每個條件都是一個有 op 的物件。巢狀(all、any、not)最多 4 層。

`op`其他欄位意思
relation_gte、relation_ltefield、value(-100 到 100)這位村民對玩家的某項關係至少/至多這麼多。field 可用 affinity(好感)、trust(信任)、respect(尊敬)、fear(恐懼)、debt(虧欠)、intimacy(親密)
stage_isstage關係階段剛好是:hostile、wary、stranger、acquaintance、friend、trusted、confidant
player_stat_gtestat、value(0 到 100)玩家的社交能力至少這麼多:persuasion、insight、intimidation、etiquette、deception、leadership
player_has_itemitem、count(1 到 999,預設 1)玩家身上有這個物品(原版或模組的)
player_has_tagtag玩家身上有這個身分標籤
memory_exists、memory_missingtag;memory_exists 另有 minConfidence(0 到 1)村民記得(或不記得)帶這個標籤的事
world_flagflag、equals(預設 true)世界旗標等於某個值(true、false、數字或文字)
time_rangefrom、to(0 到 24)現在的遊戲時間落在這個時段(0 到 24 點)
day_modmodulo(1 到 30)、equals(0 到 29)遊戲天數除以 modulo 的餘數是 equals,例如每 7 天一次
role_isrole說話的村民是某職業
all、anyconditions(最多 12 個)全部成立/任一成立
notcondition條件不成立

效果#

onEnter 與選項的 effects 都用這些。每個效果是一個有 type 的物件:

`type`其他欄位意思
relation_deltadelta:affinity、trust、respect、fear、debt、intimacy,各 -20 到 20改變和這位村民的關係
add_memorytags(最多 6 個)、salience(0 到 100,預設 20)、valence(-100 到 100,預設 0)、privacy(public、personal、secret)讓村民記住這件事。之後的條件可以用 memory_exists 判斷
set_world_flagflag、value(預設 true)設定一個世界旗標。名稱只能小寫英文、數字、底線,遊戲會自動加上你的模組代號
add_identity_tagtag給玩家一個身分標籤,規則同旗標
give_itemitem、count(1 到 99)給玩家物品
take_itemitem、count(1 到 999)拿走玩家的物品
change_currencyamount(-1000 到 1000)增減金幣
offer_quest、turn_in_questquest發出/交付一個任務。填你自己 任務 表裡的 id,或 @別的模組/id
adjust_villagefield、delta(-15 到 15)調整村莊的數字:security、prosperity、foodSupply、morale、outsiderTrust、corruption
close_conversation無結束對話

有口才檢定的例子#

衛兵洛川守著關卡。玩家可以出示證明(身上有鐵礦才看得到這個選項),也可以靠說服碰運氣,成功或失敗會接到不同的下一句:

data/dialogue.json
[
  {
    "id": "gate_toll",
    "attach": { "npcs": ["luochuan"] },
    "text": "過關要查驗貨物。你有什麼可以證明身分的東西嗎?",
    "texts": { "en": "I need to inspect your goods. Anything that proves who you are?" },
    "priority": 50,
    "once": "per_player",
    "conditions": [ { "op": "relation_gte", "field": "trust", "value": -10 } ],
    "choices": [
      {
        "id": "show_ore",
        "text": "我是礦工,這是我的礦。",
        "tone": "honest",
        "showIf": [ { "op": "player_has_item", "item": "iron_ore", "count": 1 } ],
        "effects": [ { "type": "set_world_flag", "flag": "gate_open" } ],
        "next": "gate_pass"
      },
      {
        "id": "talk_around",
        "text": "通融一下吧,我趕時間。",
        "tone": "bold",
        "check": { "kind": "persuasion", "difficulty": 25 },
        "success": { "next": "gate_pass", "effects": [ { "type": "relation_delta", "delta": { "respect": 2 } } ] },
        "failure": { "next": "gate_refuse" }
      },
      { "id": "leave", "text": "算了,我晚點再來。" }
    ]
  },
  {
    "id": "gate_pass",
    "start": false,
    "text": "好吧,過去吧。路上小心。",
    "choices": [ { "id": "thanks", "text": "謝謝。" } ]
  },
  {
    "id": "gate_refuse",
    "start": false,
    "text": "不行。規矩就是規矩。",
    "onEnter": [ { "type": "relation_delta", "delta": { "respect": -1 } } ],
    "choices": [ { "id": "fine", "text": "好吧。" } ]
  }
]

常見錯誤#

  • 接續句忘了寫 "start": false,或寫了 attach 又想當接續句。接續句沒有 attach,只靠別句的 next 進來。
  • next 指到不存在(或自己有錯而被跳過)的句子。整個選項所在的句子都會被擋下,載入檢查會指出名字。
  • 有 check 的選項把 effects、next 寫在選項本身,要改放進 success/failure。
  • 一句話超過 6 個回答、或效果超過 8 個。
  • 用大寫或空格當旗標名稱。旗標與標籤只能小寫英文、數字、底線。
  • 在 offer_quest 裡寫了一個你的任務表沒有的名字。
  • 覺得同一句話出現得太頻繁。把 cooldownDays 調高,或加上 once。