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

導演事件(directorEvents)

替村莊的說書人加一件新的事:集市、襲擊、徵兆,並決定它什麼時候容易發生、會改變村莊哪些數字。

這能讓你做什麼#

每座村莊有一位看不見的「說書人」(導演),每天挑一件事讓它發生:商隊來了、夜裡有人襲擊、天空出現怪異的徵兆。你可以替它的候選清單加新事件,用資料描述:這件事算哪一類、持續幾天、什麼情況下容易被挑中、開始和結束時村莊的哪些數字會變、村裡的人會說什麼。

事件開始時,玩家會看到你寫的公告;事件持續期間,村民會說你寫的那句話,物價和閒聊熱絡度也可以跟著變。

在編輯器裡#

在編輯器左欄「世界」底下的「世界事件」(還沒有的話,從最下面的「加入新的內容」加進來)。按「新增」加一筆。

這一類目前沒有表單。選中那一筆,中間會出現一個文字框,你直接在裡面編輯這一筆的內容,寫法跟下面「進階」一節的範例一樣。格式打錯時會顯示「格式不對,還沒套用」,這次的修改不會存進去,改對了才會套用。

上方的「試玩」會載入你的模組,進一個平坦的測試場,可以先確認模組載入沒有問題。測試場沒有村莊、水和農田,要看實際效果,就在「使用模組」打開這個模組,進一個世界玩。

進階:手寫 JSON#

在編輯器的文字框裡看到的,就是下面這個格式。你也可以按編輯器上方的「開資料夾」,用外面的文字編輯器直接改檔,存檔後編輯器會同步過來。檔案放哪裡、怎麼登記,見模組資料夾與 mod.json。

世界事件的檔案放在 data/ 底下(名稱隨你,例如 data/director.json),並在 mod.json 的 content 裡寫 "directorEvents": "data/director.json"。

最小可用範例#

一個「霜原集市」:冬天更容易發生,村莊治安夠高才會開,開張時士氣上升 5。

data/director.json
[
  {
    "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": "你的標籤" } 來接續;它會自動加上你的模組代號,不會跟別人的撞名。

一個威脅事件#

威脅事件可以分別處理「玩家解決了」和「沒解決」。這個例子會打開夜襲警戒,解決了治安回升,沒解決治安下降:

data/director.json
[
  {
    "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。