矮人要塞社区汉化
本项目是《矮人要塞》的非官方汉化模组。开源的汉化程序由 Viz 开发，游戏文本的翻译与校对由 WAN1694 主导并和矮人要塞中文维基的其他翻译人员共同完成。本项目当前是测试版，可能会崩溃以及造成存档损坏、丢失！仅供学习交流。
版权声明
请勿将本项目用于任何商业用途，亦不得将本项目与任何商业产品或盗版软件捆绑分发。转载请著名出处并保留相关版权声明。Viz 和 WAN1694 保留对违反上述条款的个人或组织采取法律行动的权利。
《矮人要塞》及其相关资产的版权归 Bay 12 Games 所有，本项目不包含任何游戏资产。旧的预览版汉化（Preview
版）和精简版汉化（Lite 版）中的 dfhooks_dfint_cjk.dll 和 libdfhooks_dfint_cjk.so 版权归 Viz 和上游项目 df-steam-hook-rs 的作者所有，由 Viz 独立开发的创意工坊新版 DFI18n
模组版权归 Viz 所有，使用 MIT
自由软件许可证授权。而其中的相关翻译数据版权归矮人要塞中文维基的翻译团队所有，并在知识共享署名-非商业性使用 4.0 国际 (CC BY-NC 4.0) 协议下授权。所使用的
Noto CJK 字体使用
SIL
开源字体许可证授权。程序使用的其他开源库版权归其各自作者所有，详见各自的许可证文件。该发布页面的版权归 Viz
的微子信息技术咨询服务工作室所有。
模组
创意工坊新版 DFI18n 模组已发布到 Steam 创意工坊。新项目将不再基于 df-steam-hook-rs，但是依赖 DFHack 加载汉化程序。
安装步骤
- 从 Steam 商店购买《矮人要塞》并安装
- 从 Steam 商店免费获取模组依赖的 DFHack 并安装
- 从 Steam 创意工坊订阅新版 DFI18n 模组
- 从 Steam 创意工坊订阅 DFI18n 所需的简体中文翻译数据
- 如果之前有安装过适用于 53+ 的 Lite 版汉化，需要移除游戏目录下的
dfhooks_dfint_cjk.dll和libdfhooks_dfint_cjk.so两个文件 - 启动游戏
注意：这个 MOD 是全局生效的，创建新存档不需要选中！
卸载步骤
- 退订上面的两个模组
- 启动游戏
- 点击主菜单的模组或 Mods 按钮
- 在列表中点击任意模组在 Windows 资源管理器中打开模组的文件夹
- 退出游戏防止游戏进程阻止删除已加载模组的文件夹
- 回到 Windows 资源管理器中，进入上层 "mods" 文件夹
- 删除所有的 3613958631 开头的文件夹，就是删除所有的新版 DFI18n 模组
- 删除所有的 3635900931 开头的文件夹，就是删除所有的简体中文翻译数据
- 重启游戏
当前进度
- 优化日志代码：解决汉化程序启动时日志不输出、异步落盘在输出大量日志时不影响游戏性能
- 允许 Lua 调用 Rust 函数：从 Lua 脚本初始化汉化程序需要的信息，提高灵活度
- 从 Lua 脚本传入游戏游戏所运行的操作系统、来源平台、版本号、需要用到的字段偏移
- 从 DFHack Lua 脚本获取当前的视图作为翻译的上下文信息
- 移植了精简版中的内存搜索
- 用 C 重写了 CP437 编码转换成 UTF-8 编码的逻辑
- 用 C 重写了检查一个 UTF-8 编码是否是有效的 CP437 字符的逻辑
- 完成跟主要的文本打印函数的 hooks，能够将截取到的文本输出到日志
- 添加了简单的 DFHack 窗口显示 MOD 加载信息（或者错误）
- 制作了创意工坊的图标
- 补充了大量的代码注释
- hook 多行标记文本加载的函数
- 增加多行色彩文本的序列化（成标记文本）和反序列化
- 从其他创意工坊 MOD 加载汉化数据，方便合并其他 MOD 作者的翻译数据
- 移植简单词典翻译模块，增加标记支持（如标记文本应该居中渲染）
- 移植矢量字体栅格化的字形模块
- 重写 SDL2 渲染文本的模块，提高性能，尝试解决闪屏问题
- 增加了一个调试窗口，方便调整字形渲染位置
- 解决大部分字体穿模的问题
- 抽象翻译接口，增加异步支持，方便今后接入大语言模型动态翻译
- 移植上层文本绘制
- 移植多行文本排版
- 重写匹配替换翻译模块并改名叫规则集翻译器
- 规则集翻译器增加优先级（权重）支持
- 增加主界面的翻译姬 Logo
- 增加了翻译开关 DFHack 指令，并可以通过 DFHack 绑定快捷键
- 增加了翻译热重载 DFHack 命令
- 增加了 DFHack 文本翻译支持
- 给 DFHack 的 Lua 脚本提供了同步和异步翻译 API
- ASCII 模式支持
- 中文外的其他语言支持
- 测试完整的模组
- 发布到创意工坊！
- 迁移更多的翻译数据和提高汉化覆盖率
- 增加色彩文本翻译支持
- 翻译模块增加上下文支持
- 对于缩写（Cow -> Cw）和缩略（以 ... 结尾）的翻译支持
低优先项目
- 低优先：基于大语言模型的实时汉化
- 低优先：调整汉化后的选项卡宽度
- 低优先：基于 Lua 的动态翻译模块支持
- 低优先：修复 DFHack 的部分渲染问题
发布信息
2025-12-31 DFI18n v0.0.9
- 测试版发布
2026-01-01 DFI18n v0.0.10
- 因为帮助文档中按键文本造成的闪退已修复
- 标签垂直对齐的问题已修复
2026-01-02 DFI18n v0.0.11
- 修复 DFHack 的标签没有渲染的问题
2026-01-02 DFI18n v0.0.12
- 修复 ASCII 模式支持
- 增加多语言支持
2026-01-03 DFI18n v0.0.13
- 修复因 ASCII 模式支持导致的上层标记文本渲染问题
2026-01-04 DFI18n v0.1.0
- 发布源代码
- 在主菜单添加 MOD 版本信息
2026-01-05 DFI18n v0.1.1
- 修复长文本居中时显示不全的问题
2026-01-06 DFI18n v0.2.0
- 修复标记文本原文的渲染
- 同一个 MOD 的同一个语言标签允许加载多个简单词典
历史版本
历史版本仅支持从网盘和代码仓库下载，且不再提供技术支持。
2025-12-06 汉化精简版（适用 53.XX 的 Lite 版）
简介：更新了翻译数据
2025-11-27 汉化精简版（适用 53.XX 的 Lite 版）
简介：增加了简易词典存放校对过的旧词典词条，增加用户词典和查询表支持
2025-11-18 汉化精简版（适用 53.XX 的 Lite 版）
简介：适配了 53.XX+ 版，精简了一些功能以方便维护和增加跨版本支持
2025-07-06 汉化预览版（适用 51.13 的 Preview 版）
简介：适配了 51.13 版
2025-03-30 汉化预览版（适用 51.08 的 Preview 版）
简介：适配了 51.08 版
2024-12-22 汉化预览版（适用 50.15 的 Preview 版）
简介：适配了 50.15 版
2024-11-03 汉化预览版（适用 50.14 的 Preview 版）
简介：添加了构筑菜单查询表
2024-10-20 汉化预览版（适用 50.14 的 Preview 版）
简介：添加了新的词典，完善了物品汉化
2024-10-06 汉化预览版（适用 50.14 的 Preview 版）
简介：实现了通用的查询树，适配了 50.14 版
2024-09-22 汉化预览版（适用 50.13 的 Preview 版）
简介：添加上下文支持，第一个不需要单独下载词典的版本
2024-09-15 汉化预览版（适用 50.13 的 Preview 版）
简介：重写了匹配和翻译的逻辑（不再提供网盘下载）
2024-09-08 汉化预览版（适用 50.13 的 Preview 版）
简介：分离配置和词典用独立的仓库管理（不再提供网盘下载）
2024-09-01 汉化预览版（适用 50.13 的 Preview 版）
简介：增加了富文本排版（不再提供网盘下载）
2024-08-25 汉化预览版（适用 50.13 的 Preview 版）
简介：首次发布（不再提供网盘下载）
已知问题
- 汉化程序会影响游戏性能（降低游戏帧数）
- 标签宽度渲染不正确
- 很多文本翻译缺失
- 有些需要居中的翻译未居中对齐
- 对于带有缩写和省略的内容，暂时无法正确匹配和翻译
- 含多义词的组合可能会翻译错误
项目链接
- 项目唯一的发布页（本页面）
- Gitee：新版 DFI18n 汉化模组源码 / GitHub：新版 DFI18n 汉化模组源码
- Gitee：新版 DFI18n 简体中文翻译数据 / GitHub：新版 DFI18n 简体中文翻译数据
- Gitee：旧版 dfint-rust-cjk 汉化程序源码
- Gitee：旧版 df-translations 汉化翻译文件
- GitHub：旧版 df-steam-hook-rs 上游汉化程序源码
项目参与者链接
Viz 的官方帐号：
WAN1694 的官方帐号：
以及矮人要塞中文维基
