# 矮人要塞汉化程序

**Repository Path**: vizv/dfint-rust-cjk

## Basic Information

- **Project Name**: 矮人要塞汉化程序
- **Description**: 矮人要塞汉化 dfhooks 动态库，基于 https://github.com/dfint/df-steam-hook-rs
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 117
- **Forks**: 12
- **Created**: 2024-09-04
- **Last Updated**: 2025-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dfint-rust-cjk 矮人要塞汉化程序

这是 Viz 基于上游项目 [df-steam-hook-rs](https://github.com/dfint/df-steam-hook-rs) 开发的矮人要塞汉化程序。从 [cf102ca](https://github.com/dfint/df-steam-hook-rs/commit/cf102ca1dfa1a01fbf991f52771927add7f54691) 分叉并重写了几乎所有的模块，仅使用了上游项目的 hook 框架。

本项目仍处于早期开发阶段，当前版本为 **预览版** ，可能会崩溃以及造成存档损坏、丢失！仅供学习交流。

* 本项目为自由软件，源码托管在 [Gitee:vizv/dfint-rust-cjk](https://gitee.com/vizv/dfint-rust-cjk)
* 项目翻译文件托管在 [Gitee:vizv/df-translations](https://gitee.com/vizv/df-translations)
* 项目偏移文件托管在 [Gitee:vizv/df-offsets](https://gitee.com/vizv/df-offsets)

## 兼容版本

仅兼容以下从官方渠道购买的豪华版 (Premium Edition, 或称之为付费版、图形版) 游戏本体：

* Linux/Windows 系统 [**51.13** Steam 版](https://store.steampowered.com/app/975370/Dwarf_Fortress/)
* Linux/Windows 系统 [**51.13** itch.io 版](https://kitfoxgames.itch.io/dwarf-fortress)

**注意事项：**

* 不兼容官网下载的[经典版](http://www.bay12games.com/dwarves/) (Classic Edition, 或称之为免费版、字符版) 游戏本体，由于技术限制未来也不会支持
* 不支持任何修改过可执行文件的游戏版本，由于汉化程序依赖文件中的各种内存地址偏移未来也不会支持
* 等到冒险模式进入稳定版时才会考虑支持，暂不支持
* 本汉化程序不包含游戏本体的拷贝，请自行到 [itch.io](https://kitfoxgames.itch.io/dwarf-fortress) 或 [Steam](https://store.steampowered.com/app/975370/Dwarf_Fortress/) 平台购买

## 使用步骤

1. 备份你的《矮人要塞》存档
2. 确保你的《矮人要塞》处于受支持的 51.13 版本（对于 Steam 版，提示版本不匹配时在右键「属性」中的「测试版」选项里选择受支持的版本）
3. [从这里](https://gitee.com/vizv/dfint-rust-cjk/releases)下载最新的汉化程序完整包
4. 解压压缩包内的所有文件和文件夹到游戏根目录
5. 正常启动游戏
6. 游戏中可以使用 Ctrl+F2 热键对汉化进行开关操作

## 已知问题

* 汉化程序会影响游戏性能（降低游戏帧数）
* 仍有少数下层文本穿透到上层或与其他文本重合的情况
* 标签宽度渲染不正确
* 很多文本翻译缺失
* 有些需要居中的翻译未居中对齐
* 对于带有省略内容（以「…」结尾），暂时无法正确匹配和翻译
* 因为默认配置下仍会启用 dfint 旧词典，会出现一些翻译不准确或零星翻译的情况
* 含多义词的组合可能会翻译错误（常见的有 ash logs - 白蜡树原木，可能会被错误的翻译成灰烬原木；pig iron - 生铁，可能会被错误翻译成家猪铁碇）

## 鸣谢

* 上游项目 [df-steam-hook-rs](https://github.com/dfint/df-steam-hook-rs) 提供的 hook 框架
* dfint 旧词典来自 [dfint](https://github.com/dfint/autobuild/blob/main/translation_build/csv/Chinese%20Simplified/dfint_dictionary.csv)
* 新版翻译词典由[矮人要塞中文维基](https://dfzh.huijiwiki.com/)翻译人员提供
* 字体来自 [Noto CJK](https://github.com/notofonts/noto-cjk)
* 逆向脚本来自 [DFHack 的 df_misc 仓库](https://github.com/DFHack/df_misc)
* DFHack 提供的 [dfhooks API chainloader](https://github.com/DFHack/dfhooks)
* 矮人要塞吧 QQ 群、矮人要塞中文维基翻译 QQ 群、DFHack 的 Discord 频道中的各位大佬的帮助
* **尤为感谢B站大佬 [WAN1694](https://space.bilibili.com/32828123/) 对翻译和测试的帮助！目前 50% 以上的翻译由他完成，并参与了几乎所有的测试和在发版前找到了无数 bug。**

## 许可证信息

* 本汉化程序版权归 [shevernitskiy](https://github.com/shevernitskiy) 和 [Viz](https://gitee.com/vizv) 所有，同上游项目一样使用 MIT 自由软件许可证授权，见 [Gitee:vizv/dfint-rust-cjk:LICENSE](https://gitee.com/vizv/dfint-rust-cjk/blob/viz-wip/LICENSE)
* 偏移文件版权归 [Viz](https://gitee.com/vizv) 所有，同样使用 MIT 自由软件许可证授权，见 [Gitee:vizv/df-offsets:LICENSE](https://gitee.com/vizv/df-offsets/blob/main/LICENSE)
* 翻译文件版权归「[矮人要塞中文维基](https://dfzh.huijiwiki.com/)」翻译人员所有，并在 [知识共享署名-非商业性使用 4.0 国际 (CC BY-NC 4.0)](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans) 协议下授权，见 [Gitee:vizv/df-translations:LICENSE.md](https://gitee.com/vizv/df-translations/blob/main/LICENSE.md)
* 所用 Noto CJK 字体使用 SIL Open Font License 授权，见 [GitHub:notofonts/noto-cjk:Sans/LICENSE](https://github.com/notofonts/noto-cjk/blob/main/Sans/LICENSE)

## 项目进度

* [x] 适配所有豪华版本
  + [x] 使用统一的压缩包发布
* [x] 改用《矮人要塞》风格的 .txt 配置文件
* [x] 用于修复 Windows 编译器优化导致的函数 inline 问题的 string collector
* [x] 栅格化中文矢量字体
  + [x] 字符缓存
* [x] 独立的屏幕文本管理
  + [x] 文本纹理缓存
* [x] 独立的文本渲染层
  + [x] CP437 和 UTF-8 编码互转
  + [x] 中英文混排
  + [ ] 优化性能问题
  + [ ] 修复文本重叠问题
  + [ ] 修复上下层文本穿透问题
* [x] 可开关翻译
  + [ ] 修复偶发的在关闭翻译时富文本渲染出错的问题
* [x] dfint 旧词典支持
  + [ ] 待界面汉化完善后移除旧词典
* [x] 使用独立的偏移表
* [x] 使用新的词典格式
  + [x] 翻译缓存
  + [x] 实现富文本翻译
    - [x] 教程翻译（待更新到 51.08）
    - [ ] 其他富文本
  + [x] 实现查询树和查询表来匹配和翻译文本
    - [x] 经验技能
    - [x] 职业
    - [x] 职务
    - [x] 生物
    - [x] 植物
    - [x] 宝石
    - [x] 装备（部分完成）
    - [x] 物质
    - [x] 物品（部分完成）
    - [x] 信息标签（部分完成）
    - [x] 构筑菜单
    - [ ] 其他词汇和规则
    - [ ] 优化查询树匹配性能
  + [x] 实现基于上下文的界面翻译
    - [x] 加载页
    - [x] 主界面
    - [x] 游戏菜单
    - [x] 游戏中的时间（年月日和季节）
    - [ ] 其他界面
  + [ ] 基于网络的词典更新

## 构建

1. 参考 [Rust 程序设计语言 / 入门指南 / 安装](https://rustwiki.org/zh-CN/book/ch01-01-installation.html) 章节完成 rustup 以及 Rust 和 C++ 工具链的安装。
2. 安装 nightly 版本：`rustup install nightly`
3. 构建汉化程序：`cargo build --release`
4. 复制 `target/release` 目录下的 `libdfint_hook.so` 或 `dfint_hook.dll` 到游戏目录，并重命名为 `libdfhooks.so` 或 `dfhooks.dll`
5. 复制 `config.txt.example` 到游戏目录下的 `dfint-data/config.txt`
6. 下载 [矮人要塞中文翻译偏移](https://gitee.com/vizv/df-offsets) 中的 `offsets` 目录到 `dfint-data/offsets`
7. 下载 [矮人要塞中文翻译词典](https://gitee.com/vizv/df-translations) 中的 `translations` 目录到 `dfint-data/translations`
8. 下载 [Noto CJK](https://github.com/notofonts/noto-cjk) 并将 `NotoSansMonoCJKsc-Bold.otf` 字体文件移动到 `dfint-data/fonts/NotoSansMonoCJKsc-Bold.otf`
9. 下载 [dfint 旧词典](https://github.com/dfint/autobuild/blob/main/translation_build/csv/Chinese%20Simplified/dfint_dictionary.csv) 到 `dfint-data/legacy-dictionary.csv`

如果搞不定，那就直接从[这里](https://gitee.com/vizv/dfint-rust-cjk/releases)下一个最新版本的压缩包，然后从中解压对应文件