💰 Currencies & progression 貨幣同進度

What it does 做乜嘢

Five values track everything the player can spend and earn: Coins, Cash, Experience, Population and Energy, plus Barn space as a shared cap on stored goods. Coins come from orders, the train, the ship, the helicopter, selling goods and town charm, and are spent on seeds, buildings, plots, expansions and barn upgrades. Cash is earned only — from levelling up, the daily-task chest, achievements, ship chests, museum exhibits and selling gems — and is spent on rushing timers, extra queue slots, rerolling orders and zoo decorations. Experience comes from every harvest, production, order, delivery and build, and drives the level curve. Population comes from houses and gates community buildings and factory count. Energy regenerates at +1 every two minutes up to a cap of 100, and is spent one per mine tile. 五個數值追蹤玩家可以用同賺嘅嘢：金幣、Cash、經驗、人口同能量，仲有倉容量做儲存上限。金幣嚟自訂單、火車、船、直升機、賣貨同小鎮人氣，用嚟買種子、建築、田地、擴地同倉庫升級。Cash 淨係靠賺——升級、每日任務寶箱、成就、船寶箱、博物館展品、賣寶石——用嚟加速時間、加隊列位、重擲訂單同動物園裝飾。經驗嚟自每次收成、生產、訂單、送貨同起建築，推動等級曲線。人口嚟自屋，解鎖社區建築同工廠數量。能量每兩分鐘 +1，上限 100，喺礦場每格用一點。

How it works 點運作

The level curve is xpToNext(L) = round(60 · L^1.55) — 60 experience at level 1, about 2,100 at level 10, 12,000 at level 30, 28,000 at level 50, and it continues past level 100. Every level pays coins and 2 cash, and usually unlocks something new (a crop, a factory, a building, a system). Rushing any timer costs max(1, ceil(remainingMinutes / 5)) cash — a five-minute wait costs 1 cash, a twenty-five-minute wait costs 5. A small pool of village helpers also shaves time off timers for free, on a cooldown, as part of the local village system. 等級曲線係 xpToNext(L) = round(60 · L^1.55)——1 級要 60 經驗，10 級大約 2,100，30 級 12,000，50 級 28,000，過咗 100 級都繼續計。每次升級都俾金幣同 2 個 Cash，仲通常會解鎖新嘢（作物、工廠、建築、系統）。趕時間要 max(1, ceil(剩餘分鐘 / 5)) 個 Cash——等五分鐘要 1 Cash，等廿五分鐘要 5 個。村莊系統入面嘅細撮村民助手，喺冷卻時間過後可以免費幫你慳返啲時間。

Failure modes 失敗情況

A full barn does not silently discard progress: production and harvesting report honest partial results, and the interface says plainly when a queue is paused because storage is full. Currency values are simulated as ordinary numbers with no floating-point display rounding surprises expected below very large totals; the balance validator is expected to catch an unreachable unlock or a recipe with no route to it before it ships, rather than the player discovering a dead end in play. 倉滿咗唔會靜雞雞蝕晒你啲嘢：生產同收成會誠實話你部分成功，介面亦會清楚話你知隊列因為倉滿而暫停咗。貨幣數值用普通數字模擬，喺總數未去到好巨大之前，唔會有浮點數顯示嘅奇怪四捨五入問題；平衡驗證工具應該會喺出街之前捕捉到解唔到嘅解鎖或者去唔到嘅配方，而唔係俾玩家喺玩緊嗰陣先發現行唔通。

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

The published v0.1.0-22 desktop baseline is available (see the changelog). The simulation package (packages/shared) is where currencies, the level curve and the rush-cost formula are implemented, and it is checked against long-horizon tick runs rather than eyeballed; the interface that surfaces these numbers to the player is a separate, later concern from getting the arithmetic right. 已發佈嘅 v0.1.0-22 桌面基準而家可以下載（睇更新日誌）。貨幣、等級曲線同趕時間費用公式全部喺模擬套件（packages/shared）入面實作，用長時段嘅 tick 測試去驗證，而唔係靠肉眼睇。至於介面點樣將呢啲數字顯示畀玩家睇，就係之後、獨立嘅一步。