Documentation / Order board

📋 Order board 訂單板

What it does 做乜嘢

Six order slots, each wanting one to three goods at level-scaled quantities, paying coins, experience and up to two reputation stars. A completed slot refills after about three minutes; rerolling an order costs 1 cash. 六個訂單位,每個要一到三種貨品,數量按等級調節,俾金幣、經驗同最多兩粒信譽星。做完一個位大約三分鐘之後會補返,重擲訂單要 1 個 Cash。

How it works 點運作

Orders are generated only from goods the player can actually produce, so an impossible order — one asking for a factory or crop the player has not yet unlocked — never appears. This is the mechanism that makes the order board a genuine, always-solvable puzzle rather than a source of player frustration. 訂單淨係會由玩家真係整得到嘅貨品之中生成,所以唔可能出現整唔到嘅訂單(要求一種仲未解鎖嘅工廠或者作物)。呢個機制令訂單板變成一個真正、一定解得到嘅小謎題,而唔係令玩家嬲嘅嘢。

Failure modes 失敗情況

Because generation is constrained to reachable goods, there is no failure mode where a player is permanently blocked by an order board slot; the worst case is waiting for production or paying cash to rush it. 因為生成嘅時候已經限制咗要係整得到嘅貨,所以唔會有玩家俾訂單板永久卡住呢種失敗情況;最壞情況都係等生產,或者俾 Cash 趕時間。

What is not yet implemented 仲未整好嘅部分

The published v0.1.0-22 desktop baseline is available (see the changelog). The order-generation rule (filtering candidate goods against what the player has unlocked) lives in packages/shared and is exercised by the same tick-based tests as the rest of the economy. 已發佈嘅 v0.1.0-22 桌面基準而家可以下載(睇更新日誌)。訂單生成規則(按玩家已解鎖嘅嘢去篩選候選貨品)喺 packages/shared 入面,同其他經濟系統一齊用嗰套 tick 測試去驗證。