對話(dialogue)
讓村民多說一句話,給玩家幾個可以回答的選項,答案可以改變好感、給東西、發任務或開啟下一句。
這能讓你做什麼#
表裡每一筆是一句村民會說的話(遊戲裡叫一個「節點」),可以附上玩家的回答選項。回答可以接到另一句,形成一小段對話。你能讓某個職業的村民(例如所有旅館主人)或某一位有名字的村民說這句話,並設定條件:好感夠高才說、只在晚上說、玩家身上有某樣東西才說。
有兩種句子:
- 開場句:玩家跟村民搭話時,村民可能會挑來說的第一句。要用
attach指定誰會說。 - 接續句:只能從別句的回答
next接過來,要寫"start": false。接續句不會自己開啟對話,如果沒有任何一句指向它,載入檢查會告訴你「沒有人會說這句話」。
在編輯器裡#
在編輯器左欄「劇情」底下的「對話」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆,一筆就是村民說的一句話。新的一句預設由旅店老闆開口,帶一個「再見」的回答。
這一類有自己的表單,由上到下是:
- 「這句怎麼出現」:選「開場句:村民主動開口」,再指定「所有村民」或「指定職業或村民」;或選「接話:由某個回答接到這裡」,這一句不會自己出現,要在另一句的回答裡把它接過來。另有「可以當作談話的開頭」開關。
- 「台詞」:「村民說的話」,最多 600 字。
- 「出現時機」(不確定就不用動):「優先度」「權重」「隔幾天再說」「只說一次」。
- 「什麼情況下才會說」:用條件卡片,按「加一個條件」。有「關係夠好」「玩家帶著某物品」「世界裡某件事已發生」「在某段時間」「說話的人是某職業」等,也能用「以下全部成立」「以下任一成立」「以下不成立」組合起來。不加就是隨時。
- 「說到這句時會發生」:用效果卡片,按「加一個效果」,例如「改變關係」「讓村民記住一件事」「給玩家物品」「給玩家一個任務」「結束對話」。
- 「玩家的回答」:最多 6 個。每個回答有「回答內容」和「語氣」,也可以設「這個回答什麼時候才出現」。回答可以是「一般回答」,或「要過能力檢定」(填「考哪一種能力」「難度」「運氣浮動」,成功與失敗各自接到不同的句子)。「接到哪一句」可以選已有的一句、「到此結束」,或按「新增一句並接上」直接長出下一句。
表單裡有一棵「對話樹」,綠邊的是開場句,往下是每個回答接到的下一句,點任何一句就跳去編它。沒有人接到、又不是開場句的一句會標出提示,因為它在遊戲裡不會出現。
右邊是「對話預覽」:從選中的這一句開始演,點回答往下走,按「重新開始」重來。預覽不檢查條件,所有回答都會顯示。
進階:手寫 JSON#
下面是同一份內容寫在檔案裡的樣子。編輯器存檔時寫的就是這個格式;你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改,存檔後編輯器會同步過來。表單沒有的欄位,寫在檔案裡也會原樣保留。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。
對話表放在 data/dialogue.json,並在 mod.json 的 content 裡寫 "dialogue": "data/dialogue.json"。
最小可用範例#
旅館主人會說一個傳聞。玩家可以追問,答完好感加 1;也可以直接道別:
[
{
"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 的句子預設就是開場句 |
start | false 表示這是接續句,只能被回答接過來。沒有 attach 時一定要寫 false |
text、texts(必要) | 對白,最長 600 字 |
priority | 1 到 200,預設 40。同時有好幾句可以說時,數字大的先 |
weight | 0.1 到 10。這句被挑中的比重,不寫就是一般比重 |
cooldownDays | 0 到 30 天,預設 1。說過後隔幾天才會再說 |
once | never(預設,可重複)、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_lte | field、value(-100 到 100) | 這位村民對玩家的某項關係至少/至多這麼多。field 可用 affinity(好感)、trust(信任)、respect(尊敬)、fear(恐懼)、debt(虧欠)、intimacy(親密) |
stage_is | stage | 關係階段剛好是:hostile、wary、stranger、acquaintance、friend、trusted、confidant |
player_stat_gte | stat、value(0 到 100) | 玩家的社交能力至少這麼多:persuasion、insight、intimidation、etiquette、deception、leadership |
player_has_item | item、count(1 到 999,預設 1) | 玩家身上有這個物品(原版或模組的) |
player_has_tag | tag | 玩家身上有這個身分標籤 |
memory_exists、memory_missing | tag;memory_exists 另有 minConfidence(0 到 1) | 村民記得(或不記得)帶這個標籤的事 |
world_flag | flag、equals(預設 true) | 世界旗標等於某個值(true、false、數字或文字) |
time_range | from、to(0 到 24) | 現在的遊戲時間落在這個時段(0 到 24 點) |
day_mod | modulo(1 到 30)、equals(0 到 29) | 遊戲天數除以 modulo 的餘數是 equals,例如每 7 天一次 |
role_is | role | 說話的村民是某職業 |
all、any | conditions(最多 12 個) | 全部成立/任一成立 |
not | condition | 條件不成立 |
效果#
onEnter 與選項的 effects 都用這些。每個效果是一個有 type 的物件:
| `type` | 其他欄位 | 意思 |
|---|---|---|
relation_delta | delta:affinity、trust、respect、fear、debt、intimacy,各 -20 到 20 | 改變和這位村民的關係 |
add_memory | tags(最多 6 個)、salience(0 到 100,預設 20)、valence(-100 到 100,預設 0)、privacy(public、personal、secret) | 讓村民記住這件事。之後的條件可以用 memory_exists 判斷 |
set_world_flag | flag、value(預設 true) | 設定一個世界旗標。名稱只能小寫英文、數字、底線,遊戲會自動加上你的模組代號 |
add_identity_tag | tag | 給玩家一個身分標籤,規則同旗標 |
give_item | item、count(1 到 99) | 給玩家物品 |
take_item | item、count(1 到 999) | 拿走玩家的物品 |
change_currency | amount(-1000 到 1000) | 增減金幣 |
offer_quest、turn_in_quest | quest | 發出/交付一個任務。填你自己 任務 表裡的 id,或 @別的模組/id |
adjust_village | field、delta(-15 到 15) | 調整村莊的數字:security、prosperity、foodSupply、morale、outsiderTrust、corruption |
close_conversation | 無 | 結束對話 |
有口才檢定的例子#
衛兵洛川守著關卡。玩家可以出示證明(身上有鐵礦才看得到這個選項),也可以靠說服碰運氣,成功或失敗會接到不同的下一句:
[
{
"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。
相關頁面#
- 模組編輯器:不用手寫檔案,在遊戲裡用表單做模組。
- 任務(quests):用
giver自動替村民加上接任務的對話,或自己用offer_quest發任務。 - 導演事件(directorEvents):用
evt_事件id旗標讓村民在事件期間說話。 - 物種(species)