Skip to content

hackmud 简体中文汉化补丁 v1.0.0

Choose a tag to compare

View all tags
@DRDRDRRDDRDR DRDRDRRDDRDR released this 28 Sep 11:54
· 9 commits to main since this release
v1.0.0
6510dc1

hackmud 简体中文汉化补丁 v1.0.0

首个公开版本。

内容

  • 256 条界面 / 提示 / 帮助文本简体中文化（终端横幅、命令用法、解析错误、参数校验、帮助清单、脚本执行状态词）
  • 中文字体注入：把游戏自带的 Liberation Sans 与中文黑体子集合并为单一 TTF，替换字体资产，CJK 字形可正常渲染
  • 一键安装 / 回滚 / 校验脚本 install_zh.ps1（自动备份 → 覆盖 → 哈希校验，幂等）
  • 可自行校验安装包：verify_package.py 检查载荷哈希、脚本内嵌常量、编码与必备文件；
    ci_selftest.py 是它的反向自检（人为破坏必须被检出）
  • CI 全绿：每次提交自动跑包完整性、反向自检，以及在 Windows 上的
    install → 幂等 install → verify → rollback 往返测试

技术要点

文本改动做在 .NET 程序集的 #US（user string）堆里，采用等长替换：中文 + 空格填充到原
UTF-16 长度，因此堆大小、元数据 token、所有偏移全部不变，不会影响其它字符串。

刻意保留英文（不译）

保留项 原因
FULLSEC / MIDSEC / HIGHSEC / LOWSEC / NULLSEC 服务器端 scripts.lib().security_level_names 权威取值；客户端用其做 JSON 键查询与相等比较；官方沙盒规则里的安全边界
命令名 / 脚本名（trade、#help、accts.balance、marks.* …） 游戏按英文解析输入，服务端校验
success（小写 JSON 协议字段名） 服务器通信协议的一部分

校验值

文件 SHA256
Managed/Core.dll F6CBF53FC177FE8A04E6384D59C474A78D5120DC81B86C54CADF96C176AD9FD0
resources.assets 5B2345F938D02A4289A76518D3DEA8B604CD3EAEDDE870C3BAE8958CDAB2C6D7

安装

powershell -ExecutionPolicy Bypass -File install_zh.ps1 install

回滚：install_zh.ps1 rollback　校验：install_zh.ps1 verify

已知限制

  • 在线内容无法汉化（服务器下发的其他玩家消息、排行、marks 教学输出不经客户端）
  • 帮助文本的终端表格对齐基于等宽英文，中文 2 倍宽，部分表格列会偏（仅显示问题）
  • 补丁前产生的终端历史记录仍为英文，游戏内输入 clear 可清屏

许可

  • 原创部分（安装脚本 install_zh.ps1、构建脚本 build_release.py、文档）按 MIT 授权，见 LICENSE。
  • 分发的游戏二进制（Managed/Core.dll、resources.assets）不在 MIT 范围内，
    权利归 hackmud 开发者所有；本补丁不含游戏本体，使用前请自行通过 Steam 购买并安装 hackmud。
  • 完整权利归属与免责说明见 NOTICE.md。

⚠️ 风险声明

hackmud 官方规则明确写着 「Modifying any existing files is not permitted」，并把
client file modification 视为 "custom client"，检测到可能导致封号。本补丁修改了
Core.dll 与 resources.assets，使用存在封号风险，请自行判断，风险自负。

分发的二进制为修改后的游戏文件，版权归 hackmud 开发者所有；本项目与官方无关，
仅供学习与汉化交流，若权利人要求将立即移除。

Assets 3
Loading