Terraria 汉化项目

为 Terraria 移动版提供完整的汉化解决方案！只需修改 Localization 文件夹中的翻译文件，即可自定义你的汉化效果。

✨ 功能特性

• 📝 自定义汉化 - 只需修改 Localization 文件夹中的 JSON 文件，轻松实现个性化翻译
• 🔤 字体替换 - 支持自定义中文字体，解决字体显示问题
• 🚀 一键构建 - GitHub Actions 自动生成汉化资源包
• 📦 资源导出/导入 - 完整的 Unity AssetBundle 处理工具链

🚀 快速开始

方法一：使用 GitHub Actions 自动构建（推荐）

1. Fork 本项目到你的 GitHub 账号
2. 修改 Localization 文件夹中的翻译文件
3. 推送到 GitHub，Actions 会自动运行
4. 下载成果：在 Actions 运行完成后，从 "Artifacts" 中下载 localized-data-unity3d

📂 项目结构

UnpackTerrariaTextAsset/
├── UnpackTerrariaTextAsset/       # 主项目 - 资源包处理工具
├── font_work/                      # 字体制作工作区
│   └── XnaFontRebuilder/           # 字体格式转换工具
├── Localization/                    # ⭐ 汉化翻译文件（修改这里！）
│   ├── Base.json
│   ├── Game.json
│   ├── Items.json
│   ├── NPCs.json
│   └── ...
├── scripts/                         # 维护脚本
│   └── upload-data-unity3d.ps1      # 游戏更新后上传最新原版包
└── .github/workflows/               # GitHub Actions 工作流
    ├── build-and-localize.yml       # 汉化构建（自动拉取最新原版包）
    └── cleanup-data-unity3d-releases.yml  # 每月清理旧版原版包，只留最新

🎮 游戏版本更新时：更新原版资源包

构建使用的原版游戏资源 data.unity3d 不再存入 git 历史，而是挂在本仓库的 GitHub Release 附件上（Release 附件不计入 Git LFS 配额，且天然"只保留想要的版本"）。游戏更新后，只需一条命令：

# 1. 安装并登录 GitHub CLI（仅首次）
winget install GitHub.cli
gh auth login

# 2. 上传最新原版包（同名附件自动覆盖，永远只有最新一份）
.\scripts\upload-data-unity3d.ps1 -BundlePath "你提取的新版 data.unity3d 路径"

• 构建工作流会自动从 Release 拉取这份最新原版包，无需在仓库里提交大文件；
• cleanup-data-unity3d-releases.yml 每月自动清理，保证 Release 上只保留最新一份；
• 维护说明见 scripts/README.md。

📝 如何自定义汉化

1. 编辑翻译文件：修改 Localization 文件夹中的 JSON 文件
2. 提交更改：将修改推送到 GitHub
3. 等待构建：GitHub Actions 会自动处理
4. 下载使用：从 Actions 下载生成的 data.unity3d

📥 下载汉化资源

通过 GitHub Actions（推荐）

每次推送到仓库后，Actions 会自动运行并生成资源包：

1. 进入仓库的 Actions 标签页
2. 选择最新的工作流运行
3. 在页面底部的 Artifacts 区域找到 localized-data-unity3d
4. 点击下载即可获得汉化后的 data.unity3d

📱 修改 Terraria 安装包

按照以下步骤将汉化资源应用到 Terraria 游戏中：

步骤 1：准备汉化文件

下载 localized-data-unity3d.zip 文件后解压，将文件重命名为 data.unity3d

步骤 2：打开安装包

使用 MT 管理器找到你要修改的 Terraria 安装包，打开目录 /assets/bin/Data/，你会看到原有的 data.unity3d

步骤 3：替换文件

将下载的 data.unity3d 添加并替换掉原本安装包中的 data.unity3d

重要提示：替换时压缩级别必须选择 "仅存储"（不压缩）

步骤 4：重新签名

最后对修改后的安装包进行重新签名，汉化 Terraria 就完成了！

🧰 克隆与 Git LFS

本仓库通过 Git LFS 存储字体等大文件。普通克隆即可，但本机需要安装 git-lfs（Windows 版 Git 官方安装包自带，git lfs version 可确认）：

git clone https://github.com/UnrealMultiple/TerrariaSinicization.git

• 已安装 git-lfs：checkout 时自动下载大文件，体验与普通仓库一致；
• 未安装 git-lfs：大文件会以几十字节的"指针文本"落盘，需执行 git lfs install && git lfs pull 补充下载；
• 只改翻译、不想下载大文件：用 GIT_LFS_SKIP_SMUDGE=1 git clone <地址> 克隆，提交 PR 不受影响。

🤝 参与汉化，提交 PR

欢迎为这个汉化项目做出贡献！如果你想改进翻译或添加新内容，请按照以下步骤提交 Pull Request：

步骤 1：Fork 项目

1. 点击本项目右上角的 Fork 按钮
2. 将项目 Fork 到你的 GitHub 账号下

步骤 2：克隆并修改

# 克隆你的 Fork 仓库
git clone https://github.com/你的用户名/UnpackTerrariaTextAsset.git

# 进入项目目录
cd UnpackTerrariaTextAsset

# 创建一个新分支（可选但推荐）
git checkout -b improve-translation

步骤 3：修改翻译文件

编辑 Localization 文件夹中的 JSON 文件，改进或添加翻译内容。

步骤 4：提交更改

# 查看修改的文件
git status

# 添加修改的文件
git add Localization/

# 提交更改
git commit -m "改进翻译：简要说明你的修改"

# 推送到你的 Fork
git push origin improve-translation

步骤 5：创建 Pull Request

1. 回到你的 Fork 仓库页面
2. 点击 Compare & pull request 按钮
3. 填写 PR 标题和描述，说明你做了哪些改进
4. 点击 Create pull request 提交

注意事项

• 请保持翻译风格一致
• 确保 JSON 文件格式正确（可以使用在线 JSON 验证工具检查）
• 一次 PR 可以包含多个文件的修改，但请确保修改内容相关
• 提交前请先测试你的修改

感谢你的贡献！🎉

📚 详细文档

• UnpackTerrariaTextAsset - 资源处理工具完整文档
• font_work - 字体制作工具文档
• XnaFontRebuilder - 字体格式转换工具
• scripts - 维护脚本与 LFS 历史清理手册

🛠️ 系统要求

• .NET 8.0 SDK/运行时（本地构建需要）
• Windows 操作系统
• GitHub 账号（使用 Actions 需要）
• Git LFS（克隆仓库需要；Windows 版 Git 官方安装包自带）

📄 许可证

本项目仅供学习和研究使用。

---

⭐ 如果这个项目对你有帮助，请给个 Star！