版本 2.0.1-fix | Version 2.0.1-fix

缺陷修复 | Bug Fixes

[修复] 服务器崩溃 — 工业定义加载器递归更新

[Fix] Server Crash — Recursive Update in Industrial Definition Loader

• 中文： 修复了在服务端 tick 过程中，IndustrialDefinitionLoader 因在 ConcurrentHashMap.computeIfAbsent 的映射函数内部递归修改同一缓存，触发 IllegalStateException: Recursive update 导致游戏崩溃的问题。
• English: Fixed a crash where IndustrialDefinitionLoader triggered IllegalStateException: Recursive update during server tick, caused by a recursive modification of the same ConcurrentHashMap inside a computeIfAbsent mapping function.

---

[修复] 经济系统 — 服务器挂机导致离线收益堆积

[Fix] Economy — Offline Income Accumulation on Idle Server

• 中文： 修复了服务器空置运行时租金与企业税持续结算的问题。现在每个城市仅在其市长或官员在线时才会触发当日收入结算；若无官员在线，当天跳过结算，不会在下次登录时补发离线期间的所有积累收益。
• English: Fixed an issue where residential rent and enterprise taxes continued to accumulate while no players were online. Income settlement for each city now only triggers when at least one mayor or official of that city is online. Days without an online official are skipped entirely and will not be retroactively paid out upon login.

---

[修复] 经济系统 — 企业税始终显示为 0.00

[Fix] Economy — Enterprise Tax Always Displayed as 0.00

• 中文： 修复了玩家通过商业楼进行货币购买时，营业收入未被记录至数据库的问题。此前仅 NPC 自动交易会写入收入记录，玩家手动购买的营业额从未参与企业税计算，导致企业税恒为 0。现在玩家完成货币交易后，商业收入将正确写入，并在下一日结算时按 25% 税率征收企业税。
• English: Fixed an issue where commercial income from player-initiated purchases was never recorded in the database. Previously, only NPC-automated trades wrote income records; all player purchases were silently excluded from enterprise tax calculation, resulting in a perpetual 0.00 tax display. Commercial income is now correctly recorded on player purchase, and the 25% enterprise tax will be applied at the next daily settlement.

---

[修复] 农田系统 — NPC 农民破坏含水方块

[Fix] Farmland — NPC Farmer Destroying Waterlogged Blocks

• 中文： 修复了农田盒水槽位置放置含水方块（如含水台阶、含水石板等）时，NPC 农民会将其误判为"缺水"并将其挖除、替换为水方块的问题。现在系统对含水方块与水方块同等对待，NPC 不再干预玩家手动设置的含水方块。
• English: Fixed an issue where placing a waterlogged block (e.g. waterlogged slab) in a farmland water trough slot caused NPC farmers to misidentify it as a missing water source, dig it up, and replace it with a plain water block. Waterlogged blocks are now treated equivalently to water blocks; NPC farmers will no longer interfere with player-placed waterlogged blocks in trough positions.

---

[修复] 建筑系统 — 控制箱被摧毁后建筑数据未清除

[Fix] Building System — Building Data Not Cleared on Control Box Destruction

• 中文： 修复了工业控制箱、商业控制箱或建筑箱被破坏后，对应建筑的结构数据（PlacedBuildingRecord）未从数据库中删除的问题。现在破坏任意控制箱时，系统会在解雇绑定 NPC 并清理运行时状态后，自动删除该建筑的结构记录，使该位置可以重新建造。
• English: Fixed an issue where destroying an industrial control box, commercial control box, or build box left the associated building's structural data (PlacedBuildingRecord) intact in the database. The building record is now automatically removed when any control box is destroyed, after the assigned NPC is dismissed and runtime state is cleaned up, allowing the site to be rebuilt.

---

新功能 | New Features

[新增] 雇佣界面 — 排序、搜索与收藏

[Feature] Hire Screen — Sorting, Search, and Favorites

• 中文： 雇佣界面新增与建筑选择列表一致的工具栏，支持：按名字（首字母）或等级排序（升序/降序可切换）；仅显示收藏 NPC；收藏状态持久化保存；一键重置所有筛选条件。每张 NPC 卡片右上角新增收藏按钮（★/☆）。
• English: The hire screen now features a toolbar matching the building list, with: sorting by name (alphabetical) or level (ascending/descending toggle); a favorites-only filter; persistent favorite storage; and a one-click reset. A favorite button (★/☆) has been added to the top-right corner of each NPC card.

Changelog

English

• Changed rent collection to be day-based instead of timer/sleep based.
• Fixed rent issues caused by changing time to night and sleeping.
• Added daily income toast for rent and business tax.
• Added notification when a new citizen joins the city.
• Added NPC name style config: Chinese / English.
• Fixed Linux building package preparation so simukraftbuilding is created/copied correctly.
• Fixed city population and housing capacity showing 0/0.
• Connected city UI stats to real city data.
• Made cities, POIs, chunks, citizens, buildings, and city growth dimension-aware.
• Fixed untranslated citizen overhead text and legacy Citizen xxx display.

⚠️ To use [en_us]official_building.zip, open the mod .jar as an archive, place it into the building folder, and replace the existing official_building.zip.

中文

• 收租改为按游戏天数结算，不再依赖计时器或睡觉。
• 修复调整时间到晚上再睡觉导致连续多天没租金的问题。
• 添加每日房租和商业税收入提示。
• 添加新市民加入城市提示。
• 配置界面新增 NPC 名字风格：中式 / 英式。
• 修复 Linux 下 simukraftbuilding 建筑包目录没有正确创建/复制的问题。
• 修复城市人口和住宅容量显示 0/0。
• 城市界面统计数据接入实际城市数据。
• 城市、POI、区块、市民、建筑和城市发展改为按维度隔离。
• 修复市民头顶文本未翻译，以及旧数据 Citizen xxx 的显示问题。

⚠️ 要使用 [en_us]official_building.zip，请用压缩包工具打开模组 .jar，把它放进 building 文件夹，并替换原有的 official_building.zip。

Urban renewal and upgrading としせいび

New: SimuKraft Update Notes

==================== 繁體中文

本次更新圍繞城市區塊系統、控制盒互動、NPC 行為鏈、本地化適配與介面體驗做了較大規模的整理與修復。整體目標是讓城市經營流程更穩定、控制盒邏輯更統一、NPC 行為更自然，同時進一步完善多語言支援與客戶端顯示表現。

更新亮點

• 新增城市轉帳相關功能與配套介面，完善資金轉移、提示反饋與互動流程。
• 新增區塊取消認領後的聯動處理機制，區塊被取消認領後，會同步處理員工、住宅歸屬與控制盒操作狀態。
• 新增控制盒鎖定邏輯，沒有城市歸屬的區塊中，相關控制盒會自動進入不可操作狀態。
• 新增更完整的多語言支援與本地化適配，覆蓋英語、日語、俄語、繁體中文、文言文等語言。
• 新增 HUD 與城市核心同步優化，提升城市資訊、地圖資料與玩家介面顯示的一致性。

優化調整

• 重構了多套 GUI 介面，包括銀行、商業、工業、物流、農業、挖礦、城市地圖與市民相關介面。
• 優化了城市區塊系統行為，從單純管理認領資料，擴展為同時聯動僱傭關係、住宅歸屬、客戶端可操作狀態與地圖同步。
• 優化了網路同步策略，減少重複廣播與無效重建，提高城市核心與 HUD 資料同步效率。
• 優化了規劃任務與部分世界資料的儲存結構，引入更穩定的快取、髒標記與延遲刷盤邏輯，降低頻繁讀寫帶來的負擔。
• 優化了控制盒資料層與若干世界資料管理邏輯，提升長期遊玩時的穩定性與可維護性。
• 優化了 NPC 的日常行為鏈，包括任務調度、進食、休息、回家、家庭相關與工作恢復邏輯。
• 優化了客戶端本地化接入方式，讓更多介面從硬編碼文本改為統一走語言鍵。
• 優化了商業、城市管理與地圖相關介面體驗，減少狀態不同步、文本顯示不正確或介面操作不一致的問題。

問題修復

• 修復了區塊取消認領後員工仍然留在崗位上的問題，現在會統一解僱並清理殘留狀態。
• 修復了區塊失去城市歸屬後，部分控制盒仍可繼續僱傭、配置或操作的問題。
• 修復了住宅歸屬與居民狀態不同步的問題，區塊狀態變化後住宅記錄會同步刷新與重綁。
• 修復了工業員工晚上回家時誤提示「工作完成」的問題，現已改為僅在缺少原料時提醒一次。
• 修復了礦工、農業、工業、物流等部分工作方塊的僱傭/解僱鏈路殘留問題。
• 修復了 HUD、城市升級、農業盒、挖掘盒、銀行、物流等介面的多語言殘留、鍵名直顯與硬編碼文本問題。
• 修復了部分 NPC 在尋路、工作流、進食、休息與恢復工作時出現的異常行為。
• 修復了若干服務端事件與 Tick 處理中的同步問題，降低了狀態卡住、重複執行或廣播過多的風險。
• 修復了若干空安全、導入與名稱顯示相關問題，提升了整體程式穩定性。

多語言與介面

• 補全並整理了多份語言文件，讓更多介面與提示支援正確的本地化顯示。
• 修正了部分按鈕、職業名稱、控制盒提示、消息通知與 HUD 文本在不同語言下顯示不正確的問題。
• 城市地圖、城市資訊、控制盒頁面和部分舊介面風格也做了同步整理。

其他說明

• 建築資源與部分底層結構仍在持續整理中，後續版本會繼續完善相容與體驗。
• 這次更新不僅包含新功能，也包含大量底層重構與穩定性修復，因此推薦直接使用最新版本體驗完整內容。

簡要總結

這次更新重點完善了城市區塊管理、控制盒邏輯、NPC 行為鏈、HUD 與地圖同步，以及多語言介面體驗。整體遊玩流程會更穩定，介面反饋會更統一，城市經營與控制盒相關功能也會更完整。

==================== English

This update brings a major round of improvements focused on city chunk systems, control box interactions, NPC behavior flow, localization support, and overall UI experience. The goal of this release is to make city management more stable, control box behavior more consistent, NPC routines more natural, and multilingual support more complete.

Highlights

• Added city transfer related features and supporting UI, improving fund transfers, feedback messages, and interaction flow.
• Added linked handling for chunk unclaiming. When a chunk is unclaimed, worker assignments, residence ownership, and control box states are now updated together.
• Added control box locking behavior. Control boxes in chunks without city ownership will now automatically become non-operable.
• Expanded multilingual support and localization coverage, including English, Japanese, Russian, Traditional Chinese, and Classical Chinese.
• Added HUD and city core synchronization improvements for more consistent city information, map data, and on-screen display.

Optimizations

• Reworked multiple GUI screens, including banking, commerce, industry, logistics, farming, mining, city maps, and citizen-related interfaces.
• Improved the city chunk system so it now links chunk ownership with employment, residence assignment, client-side operability, and map synchronization.
• Optimized network synchronization to reduce redundant broadcasts and unnecessary packet rebuilding, especially for city core and HUD updates.
• Improved planning task storage and several world data systems with better caching, dirty marking, and delayed disk flush logic to reduce frequent I/O overhead.
• Improved control box data management and several world-level data systems for better long-term stability and maintainability.
• Improved NPC daily behavior flow, including task scheduling, eating, resting, going home, family-related logic, and work restoration.
• Improved client localization integration so more interfaces now use translation keys instead of hardcoded text.
• Improved commercial, city management, and map-related UI behavior to reduce desync, incorrect text display, and inconsistent interactions.

Fixes

• Fixed an issue where workers could remain assigned after a chunk was unclaimed. They are now properly dismissed and cleaned up.
• Fixed an issue where some control boxes could still be hired, configured, or used after their chunk lost city ownership.
• Fixed residence ownership and resident state desync after chunk ownership changes.
• Fixed an issue where industrial workers incorrectly displayed "work completed" when returning home at night. This now only sends a reminder once when materials are missing.
• Fixed lingering hire/fire state issues for miners, farming, industry, logistics, and some other work blocks.
• Fixed multilingual leftovers, raw translation keys, and hardcoded text in HUD, city upgrades, farming boxes, mining boxes, banking, logistics, and other interfaces.
• Fixed several abnormal NPC behaviors related to pathfinding, workflows, eating, resting, and returning to work.
• Fixed several server-side event and tick synchronization issues, reducing risks of stuck states, repeated execution, and excessive broadcasting.
• Fixed several null-safety, import, and display-name related problems to improve overall code stability.

Localization and UI

• Updated and cleaned up multiple language files so more interfaces and messages are displayed correctly in different languages.
• Fixed incorrect translations for some buttons, job names, control box prompts, message notifications, and HUD text.
• City map screens, city information views, control box pages, and some legacy-style interfaces were also cleaned up and improved.

Additional Notes

• Building resources and some lower-level systems are still being reorganized and will continue to be improved in future versions.
• This release includes not only new features, but also a large amount of backend refactoring and stability fixes, so using the latest version is recommended for the full experience.

Summary

This update mainly improves city chunk management, control box logic, NPC behavior flow, HUD and map synchronization, and multilingual UI experience. Overall gameplay should now feel more stable, interface feedback more consistent, and city management systems more complete.

==================== 日本語

今回のアップデートでは、都市チャンクシステム、制御ボックスの操作、NPC の行動フロー、ローカライズ対応、そして UI 体験を中心に大規模な整理と修正を行いました。都市経営をより安定させ、制御ボックスの挙動をより統一し、NPC の行動をより自然にし、多言語表示をさらに改善することが目的です。

主な更新内容

• 都市間送金機能と関連 UI を追加し、資金移動、通知表示、操作フローを改善しました。
• チャンクの認領解除時に連動処理が行われるようになり、従業員の雇用状態、住宅の所属、制御ボックスの状態がまとめて更新されるようになりました。
• 都市に所属していないチャンク内の制御ボックスは、自動的に操作不可になるロック処理を追加しました。
• 英語、日本語、ロシア語、繁体字中国語、文言文を含む、より完全な多言語対応を追加しました。
• HUD と都市コアの同期処理を改善し、都市情報、地図データ、画面表示の一貫性を向上させました。

最適化

• 銀行、商業、工業、物流、農業、採掘、都市マップ、市民関連など、複数の GUI 画面を再構成しました。
• 都市チャンクシステムを改善し、チャンクの所有情報だけでなく、雇用関係、住宅所属、クライアント側の操作可否、地図同期まで連動するようになりました。
• ネットワーク同期を最適化し、重複ブロードキャストや不要なパケット再構築を減らして、都市コアと HUD の同期効率を向上させました。
• 計画タスクや一部のワールドデータ保存構造を改善し、キャッシュ、ダーティフラグ、遅延保存を導入して頻繁な読み書きの負荷を軽減しました。
• 制御ボックス関連データ層と複数のワールドデータ管理処理を改善し、長期プレイ時の安定性と保守性を向上させました。
• NPC の日常行動フローを改善し、タスクスケジュール、食事、休憩、帰宅、家族関連、仕事復帰ロジックを調整しました。
• クライアント側のローカライズ接続方式を改善し、より多くの画面がハードコード文字列ではなく翻訳キーを使用するようになりました。
• 商業、都市管理、マップ関連の UI 体験を改善し、状態の不一致、誤表示、不統一な操作を減らしました。

不具合修正

• チャンクの認領解除後も従業員が勤務状態のまま残る問題を修正し、現在は正しく解雇と状態整理が行われます。
• 都市所属を失ったチャンクで、一部の制御ボックスが引き続き雇用・設定・操作できてしまう問題を修正しました。
• チャンク状態の変化後に住宅所属と住民状態が同期しない問題を修正しました。
• 工業系 NPC が夜に帰宅する際、誤って「作業完了」と表示される問題を修正し、現在は材料不足時にのみ 1 回だけ通知されます。
• 採掘、農業、工業、物流など一部の作業ブロックで、雇用/解雇状態が残留する問題を修正しました。
• HUD、都市アップグレード、農業ボックス、採掘ボックス、銀行、物流などの画面で、多言語残り、翻訳キー直表示、ハードコード文言の問題を修正しました。
• 経路探索、ワークフロー、食事、休憩、仕事復帰に関する一部 NPC の異常動作を修正しました。
• サーバー側イベントと Tick 処理の同期問題を複数修正し、状態停止、重複実行、過剰送信のリスクを減らしました。
• Null 安全性、import、表示名関連の問題も複数修正し、全体的な安定性を向上させました。

多言語と UI

• 複数の言語ファイルを補完・整理し、より多くの画面や通知が正しいローカライズで表示されるようになりました。
• 一部ボタン、職業名、制御ボックスの説明、通知メッセージ、HUD テキストの翻訳不備を修正しました。
• 都市マップ、都市情報、制御ボックス画面、旧スタイルの一部 UI もあわせて整理しました。

補足

• 建築リソースと一部の下位システムは引き続き整理中であり、今後のバージョンでも改善を続ける予定です。
• このアップデートには新機能だけでなく、大量の内部再構成と安定性修正も含まれているため、完全な体験のために最新バージョンの利用を推奨します。

概要

今回のアップデートでは、都市チャンク管理、制御ボックスのロジック、NPC の行動フロー、HUD とマップ同期、多言語 UI 体験が大きく改善されています。全体として、プレイの安定性、画面フィードバックの統一性、都市経営システムの完成度が向上しています。

==================== Русский

Это обновление включает крупный этап доработки систем городских чанков, взаимодействия с блоками управления, поведенческой цепочки NPC, локализации и пользовательского интерфейса. Главная цель версии - сделать управление городом стабильнее, поведение блоков управления более единообразным, действия NPC более естественными, а многоязычную поддержку более полной.

Основные изменения

• Добавлены функции перевода средств между городами и связанный с ними интерфейс, улучшены уведомления и общий процесс перевода.
• Добавлена связанная обработка при снятии владения с чанка: теперь вместе обновляются рабочие назначения, принадлежность жилья и состояние блоков управления.
• Добавлена логика блокировки блоков управления. Если чанк не принадлежит городу, связанные блоки управления автоматически становятся недоступными.
• Расширена многоязычная поддержка, включая английский, японский, русский, традиционный китайский и классический китайский.
• Улучшена синхронизация HUD и городского ядра для более согласованного отображения городской информации, данных карты и интерфейса игрока.

Оптимизации

• Переработаны многие GUI-экраны, включая банк, торговлю, промышленность, логистику, сельское хозяйство, добычу, карту города и интерфейсы, связанные с жителями.
• Улучшена система городских чанков: теперь она связывает не только данные владения, но и трудовые отношения, жильё, клиентскую доступность управления и синхронизацию карты.
• Оптимизирована сетевая синхронизация, снижено количество лишних рассылок и ненужной пересборки пакетов, особенно для HUD и городских ядер.
• Улучшено хранение задач планирования и части мировых данных: добавлены кэширование, отметки изменений и отложенная запись на диск для снижения нагрузки от частого ввода-вывода.
• Улучшены слой данных блоков управления и ряд мировых менеджеров данных для повышения стабильности и удобства сопровождения при длительной игре.
• Улучшена ежедневная логика поведения NPC, включая планирование задач, приём пищи, отдых, возвращение домой, семейную логику и восстановление работы.
• Улучшена интеграция клиентской локализации: больше экранов теперь используют языковые ключи вместо жёстко прописанного текста.
• Улучшен интерфейс торговли, управления городом и карты, снижено число случаев несинхронного состояния, ошибочного текста и непоследовательного поведения интерфейса.

Исправления

• Исправлена проблема, из-за которой рабочие могли оставаться назначенными после снятия владения с чанка. Теперь они корректно увольняются и очищаются.
• Исправлена проблема, из-за которой некоторые блоки управления можно было продолжать настраивать и использовать после потери городского владения чанком.
• Исправлена рассинхронизация между принадлежностью жилья и состоянием жителей после изменения статуса чанка.
• Исправлена ошибка, при которой промышленные NPC вечером при возвращении домой ошибочно показывали сообщение "работа завершена". Теперь уведомление появляется только один раз при нехватке материалов.
• Исправлены остаточные проблемы найма/увольнения у шахтёров, сельскохозяйственных, промышленных и логистических рабочих блоков.
• Исправлены остатки неверной локализации, отображение сырых ключей перевода и жёстко прописанный текст в HUD, улучшениях города, сельскохозяйственных блоках, шахтёрских блоках, банке, логистике и других интерфейсах.
• Исправлены аномальные поведения некоторых NPC, связанные с поиском пути, рабочими циклами, питанием, отдыхом и возвратом к работе.
• Исправлены несколько проблем серверной синхронизации событий и тиков, что снижает риск зависших состояний, повторного выполнения и лишних рассылок.
• Исправлены некоторые проблемы null-безопасности, import-ов и отображения имён, что повысило общую стабильность кода.

Локализация и интерфейс

• Обновлены и упорядочены несколько языковых файлов, благодаря чему больше экранов и уведомлений теперь корректно отображаются на разных языках.
• Исправлены ошибки перевода для части кнопок, названий профессий, подсказок блоков управления, уведомлений и текста HUD.
• Также были приведены в порядок карта города, экран информации о городе, страницы блоков управления и часть старых интерфейсов.

Дополнительно

• Ресурсы зданий и некоторые низкоуровневые системы всё ещё находятся в процессе реорганизации и будут дорабатываться в будущих версиях.
• Это обновление включает не только новые возможности, но и большой объём внутреннего рефакторинга и исправлений стабильности, поэтому для полного опыта рекомендуется использовать последнюю версию.

Кратко

Это обновление значительно улучшает управление городскими чанками, логику блоков управления, поведенческую цепочку NPC, синхронизацию HUD и карты, а также многоязычный интерфейс. В целом игровой процесс стал стабильнее, интерфейс - более согласованным, а системы управления городом - более завершёнными.

最終アップデートテスト版をリリース 更新内容: APS加工ステーション タービン発電機 経路探索ロジック強化 パフォーマンス問題の修正 プロジェクトのリファクタリング

新增股票市场系统与银行功能 为银行控制箱添加股票交易GUI、大堂经理雇佣/解雇功能与状态展示 在世界每日更新事件中接入股票市场每日刷新调用 完善银行控制箱的U展示与按钮状态同步逻辑 新增银行贷款系统，优化多模块游戏体验 优化大型建筑建造流程：将超大建筑的蓝图准备拆分到多tick执行，避免单tick服务器卡顿 顿；复用建筑任务已有数据，移除重复的蓝图解析逻辑 重构股票市场系统：支持多城市独立股票交易 新增银行贷款全套业务：实现贷款申请、还款功能 优化建筑预览与NPC雇佣：仅渲染预览可见方块面提升性能 更新U与本地化：调整银行界面布局，移除旧的城市管理财务按钮，新增中键批量区块购买提示 修复部分网络包的参数传递问题，完善交易校验逻辑 新增城市理财投资系统 在城市管理界面新增理财入口按钮

新增StartupWarmupCoordinator启动预热协调器，将服务器启动时的批量初始化任务拆分 到多tick延后执行，避免玩家进服出现瞬时卡顿 新增NPCRestDispatchPlanner归家调度规划器与对应单元测试，按距离、工作状态分散NPC 寻路触发时间，消除同tick大量寻路导致的卡顿 重构城市区块同步逻辑，将玩家登录时的全量同步改为队列分帧处理，降低登录加载压力 重构FileUtils与PlacedBuildingManager的加载逻辑，使用快照模式替换原地修改，提升线程 安全性 修复ServerConfig配置读取逻辑，新增带测试降级的缓存获取方法，兼容无Forge上下文的 测试场妟 优化CommercialWorkHandler持久化数据加载时机，延后至启动预热阶段执行 更新模组版本至1.0.5b2-fix0.2

Updated the marriage system, NPC eating system, along with some bugs