導演事件(directorEvents)
替村莊的說書人加一件新的事:集市、襲擊、徵兆,並決定它什麼時候容易發生、會改變村莊哪些數字。
這能讓你做什麼#
每座村莊有一位看不見的「說書人」(導演),每天挑一件事讓它發生:商隊來了、夜裡有人襲擊、天空出現怪異的徵兆。你可以替它的候選清單加新事件,用資料描述:這件事算哪一類、持續幾天、什麼情況下容易被挑中、開始和結束時村莊的哪些數字會變、村裡的人會說什麼。
事件開始時,玩家會看到你寫的公告;事件持續期間,村民會說你寫的那句話,物價和閒聊熱絡度也可以跟著變。
在編輯器裡#
在編輯器左欄「世界」底下的「世界事件」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆。
這一類目前沒有表單。選中那一筆,中間會出現一個文字框,你直接在裡面編輯這一筆的內容,寫法跟下面「進階」一節的範例一樣。格式打錯時會顯示「格式不對,還沒套用」,這次的修改不會存進去,改對了才會套用。
上方的「試玩」會載入你的模組,進一個平坦的測試場,可以先確認模組載入沒有問題。測試場沒有村莊、水和農田,要看實際效果,就在「使用模組」打開這個模組,進一個世界玩。
進階:手寫 JSON#
在編輯器的文字框裡看到的,就是下面這個格式。你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改檔,存檔後編輯器會同步過來。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。
世界事件的檔案放在 data/ 底下(名稱隨你,例如 data/director.json),並在 mod.json 的 content 裡寫 "directorEvents": "data/director.json"。
最小可用範例#
一個「霜原集市」:冬天更容易發生,村莊治安夠高才會開,開張時士氣上升 5。
[
{
"id": "frost_fair",
"kind": "opportunity",
"tension": -4,
"days": 2,
"cooldownDays": 14,
"minChapter": 1,
"priceMult": 0.9,
"season": { "winter": 2 },
"weight": {
"base": 4,
"require": [ { "village": "security", "atLeast": 30 } ],
"bonus": [ { "if": { "village": "prosperity", "atLeast": 60 }, "add": 3 } ]
},
"onStart": [ { "village": "morale", "change": 5 } ],
"announce": "霜原集市開張了,商人們帶來了冬天的貨。",
"announces": { "en": "The frost fair is open, with winter goods on sale." },
"line": "聽說集市上的價錢特別實在。"
}
]欄位#
| 欄位 | 範圍與意思 |
|---|---|
id(必要) | 本地名稱,規則同其他表 |
kind(必要) | threat(威脅)、opportunity(機會)、social(社交)、omen(徵兆) |
tension(必要) | -20 到 25。正數讓世界更緊張,負數讓世界更平靜 |
days | 持續幾天,1 到 5 的整數,預設 2 |
cooldownDays | 同一件事隔幾天才能再發生,3 到 60,預設 10 |
minChapter | 最早要主線進行到第幾章才會發生,0 到 8 |
priceMult | 事件期間物價的倍率,0.7 到 1.4 |
chatMult | 事件期間閒聊好感的倍率,1 到 3 |
season | 各季節的機率倍率,0.2 到 3。可用 spring、summer、autumn、winter,例如 { "winter": 1.5 } |
weight(必要) | 被挑中的機率,見下面「機率」 |
onStart | 事件開始時發生的效果清單(最多 8 個) |
onEnd | 事件結束時發生的效果清單(最多 8 個) |
onEndResolved、onEndFailed | 只有 threat 能用:玩家有處理好、沒處理好時各自發生的效果 |
announce、announces(必要) | 事件開始時的公告,最長 160 字。announce 是主要語言的文字,announces 補其他語言(en、zh-TW、zh-CN) |
line、lines | 事件期間村民會說的話,最長 300 字,寫法同上。不寫就沒有 |
機率:weight#
每天說書人把所有候選事件的「分數」算出來,再抽一個。weight 是你的事件的算分方式:
base(必要,0 到 20):起始分數。require:最多 8 個條件,全部成立才可能被挑中,否則分數是 0。bonus:最多 8 筆{ "if": 條件, "add": -20 到 20 },條件成立就加(或扣)分。
分數不會低於 0。數字大小只有跟別的事件比才有意義,所以不用想太細。
條件#
用在 require 和 bonus 裡。每個條件是一個物件:
| 寫法 | 意思 |
|---|---|
{ "village": 軸, "atLeast": n } 或 "below": n | 這座村莊的某項數字(0 到 100)至少/低於 n。可以同時寫 atLeast 和 below |
{ "world": 軸, "atLeast": n } 或 "below": n | 世界的某一軸(-100 到 100)至少/低於 n |
{ "crisis": "標籤" } | 村莊目前有這個危機標記 |
{ "calm": true } | 村莊目前沒有任何危機 |
{ "tensionAtLeast": n }、{ "tensionBelow": n } | 世界的緊張度(0 到 100)至少/低於 n |
{ "tendency": n } | 這座村莊的傾向剛好是 n(-2 到 2 的整數) |
{ "chapterAtLeast": n } | 主線至少進行到第 n 章(0 到 8) |
| 村莊的數字(`village`) | 遊戲裡的名稱 |
|---|---|
security | 治安 |
prosperity | 繁榮 |
foodSupply | 糧食 |
morale | 士氣 |
outsiderTrust | 外人信任 |
corruption | 貪腐 |
| 世界的軸(`world`) | 遊戲裡的名稱 |
|---|---|
stability | 穩定 |
autonomy | 地方自治 |
memory | 記憶保存 |
voidAcceptance | 接納界外 |
extraction | 抽取力量 |
sharedAuthority | 權限共享 |
效果#
| 寫法 | 意思 |
|---|---|
{ "village": 軸, "change": n } | 讓村莊的那項數字增減 n,n 是 -30 到 30 |
{ "crisis": "標籤", "on": true } | 打開(true,預設)或關掉(false)一個危機標記 |
危機標記可以用 raid_watch:打開它會讓村莊進入夜襲的警戒,開始一波襲擊。也可以自己取名(小寫英文、數字、底線),讓你別的事件用 { "crisis": "你的標籤" } 來接續;它會自動加上你的模組代號,不會跟別人的撞名。
一個威脅事件#
威脅事件可以分別處理「玩家解決了」和「沒解決」。這個例子會打開夜襲警戒,解決了治安回升,沒解決治安下降:
[
{
"id": "wolf_night",
"kind": "threat",
"tension": 8,
"days": 2,
"cooldownDays": 12,
"minChapter": 1,
"weight": {
"base": 3,
"require": [ { "village": "security", "below": 70 } ],
"bonus": [ { "if": { "tensionBelow": 30 }, "add": 2 } ]
},
"onStart": [ { "crisis": "raid_watch", "on": true } ],
"onEndResolved": [ { "village": "security", "change": 6 } ],
"onEndFailed": [ { "village": "security", "change": -8 } ],
"announce": "夜裡有狼群在村外徘徊,守衛提高了警戒。",
"announces": { "en": "Wolves prowl outside the village at night. The guards are on alert." },
"line": "晚上別出村,我聽到嚎叫了。"
}
]常見錯誤#
announce沒寫。每個事件都需要一則公告。weight整個沒寫,或沒有base。- 在
opportunity、social、omen事件裡寫onEndResolved或onEndFailed。只有threat能用。 village的數字範圍寫成 -100 到 100。村莊的數字是 0 到 100,世界的軸才是 -100 到 100。days或cooldownDays寫成小數。要用整數。- 以為
tension是機率。它是事件發生後對世界緊張度的影響,機率在weight。
相關頁面#
- 模組編輯器:不用手寫檔案,在遊戲裡用表單做模組。
- 對話(dialogue):用
evt_事件id旗標讓村民在事件期間多說一句。 - 任務(quests)
- 資料夾與 mod.json