GTNH汉化完全指南：Minecraft模组中文补丁安装与进阶技巧

📋 准备篇：汉化前的环境检查与资源获取

🔍 什么是GTNH汉化包？

GTNH（GregTech: New Horizons）汉化包是针对Minecraft 1.7.10经典科技魔法整合包的中文本地化项目，包含2300+任务书文本、数千个物品名称及界面元素的翻译。通过替换游戏内语言文件（Lang Files）实现全中文显示，让中文玩家轻松体验从石器时代到星际文明的超长科技线。

✅ 环境兼容性校验

在开始前请确认以下环境要求：

• Java版本：必须使用Java 8（64位），推荐AdoptOpenJDK 8u312
  java -version # 命令行验证示例，需显示1.8.0_xxx
• 整合包版本：GTNH 2.4.0+（旧版本需对应历史汉化包）
• 文件校验：确保Minecraft目录下存在mods/和config/文件夹

📥 汉化包获取方式

🖱️ 图形化下载（推荐新手）

1. 访问项目仓库页面
2. 点击右侧「下载ZIP」按钮获取最新版汉化包
3. 解压至本地文件夹，得到包含config/和lang/的目录结构

⌨️ 命令行备用方案（开发者推荐）

# 通过Git克隆仓库（需提前安装Git）
git clone https://gitcode.com/gh_mirrors/tr/Translation-of-GTNH
cd Translation-of-GTNH
# 查看版本标签
git tag
# 切换到指定版本（例如v2.3.1）
git checkout v2.3.1

📌 注意：克隆仓库会获取全部历史版本，适合需要频繁更新的用户

🚀 部署篇：汉化包安装与验证

🖥️ 单机版安装步骤

1. 定位游戏目录

   • 启动器中找到GTNH整合包 → 点击「打开文件夹」
   • 典型路径：C:\Users\用户名\AppData\Roaming\.minecraft\Instances\GTNH

2. 覆盖汉化文件

   # 将下载的汉化包内容复制到游戏目录
   cp -r Translation-of-GTNH/* /path/to/GTNH/
   

   📌 关键文件说明：

   • GregTech.lang：格雷科技主语言文件
   • config/txloader/：第三方模组翻译补丁
   • zh_CN_GT5.09.32pre6.lang：GT5.09专用翻译

3. 验证安装结果
   启动游戏后按F3+H显示高级提示，确认：

   • 物品栏显示中文名称
   • 任务书（按B打开）内容为中文
   • 机器界面按钮显示正常

🌐 服务器批量部署方案

1. 服务端安装

   # 假设服务器目录为 /opt/minecraft/gtnh
   unzip GTNH_Translation_v2.3.1.zip -d /opt/minecraft/gtnh
   # 设置文件权限
   chmod -R 755 /opt/minecraft/gtnh/config
   

2. 多版本共存配置
   创建版本隔离目录结构：

   /opt/minecraft/
   ├── gtnh_2.4.0/
   ├── gtnh_2.4.1/
   └── translations/
       ├── v2.3.0/
       └── v2.3.1/
   

   通过软链接动态切换汉化版本：
   ln -s /opt/minecraft/translations/v2.3.1 /opt/minecraft/gtnh_2.4.1/config

3. 客户端同步方案
   在服务器server.properties中添加：
   resource-pack=https://你的服务器地址/gtnh_cn.zip
   强制客户端加载汉化资源包

🔧 场景篇：常见问题排查与优化

🐛 典型故障排除流程

🔤 字体乱码问题

1. 检查config/GTNewHorizons/CustomToolTips_zh_CN.xml是否存在
2. 确保游戏字体设置为「微软雅黑」或「思源黑体」
3. 替换resourcepacks/中的默认字体文件

📝 部分文本未汉化

1. 运行文件完整性检查：

   # 检查关键翻译文件是否存在
   ls -l config/txloader/load/*/lang/zh_CN.lang
   

2. 常见未汉化模组排查：
   • OpenComputers（需单独安装OC汉化补丁）
   • Thaumcraft Addons（神秘时代扩展模组）
3. 提交翻译缺失报告至项目issue区

🔄 版本冲突解决

当升级整合包后出现汉化失效：

1. 备份原config/目录
2. 安装新版汉化包并对比差异：
   diff -r old_config/ new_config/
3. 手动合并自定义配置（如CustomToolTips_zh_CN.xml）

💡 进阶优化技巧

• 内存优化：在启动器中分配≥4GB内存，添加JVM参数：
  -XX:MaxPermSize=512m -Dfml.ignoreInvalidMinecraftCertificates=true
• 翻译加速：删除config/txloader/forceload/下未使用的语言包
• 热更新：使用FML Reload Resource模组实现不重启刷新翻译

📊 扩展篇：版本矩阵与社区贡献

🔄 版本兼容性矩阵

GTNH版本	推荐汉化包版本	支持状态	关键特性
2.4.0	v2.3.1	✅ 完全支持	新增星系模组翻译
2.3.0	v2.2.5	⚠️ 部分支持	无神秘时代6翻译
2.2.0	v2.1.0	❌ 停止维护	仅支持基础科技线

🤝 社区贡献指南

📝 翻译规范

• 术语表：遵循GTNH中文术语表
  例："Machine Hull" → "机器外壳"（非"机械船体"）
• 格式要求：保持原文件缩进，使用UTF-8无BOM编码
• 特殊标记：保留%s、%d等占位符，如：
  tile.gregtech.machine.assembler.name=装配机 %d

🔧 贡献流程

1. Fork项目仓库
2. 创建特性分支：git checkout -b fix/enderstorage-lang
3. 编辑翻译文件（推荐工具：Notepad++带Lang语法高亮）
4. 提交PR时附带上翻译前后对比截图

🎯 贡献者激励

• 活跃贡献者将列入GTNH介绍.txt鸣谢名单
• 参与核心翻译可获得测试版整合包优先体验权
• 优质翻译将被官方整合包采纳

📚 附录：核心文件说明与资源

📂 关键翻译文件位置

• 主语言文件：GregTech.lang（格雷科技基础翻译）
• 任务书文本：config/betterquesting/Quest_Pool.json
• 加载界面提示：config/Betterloadingscreen/tips/zh_CN.txt
• 自定义工具提示：config/GTNewHorizons/CustomToolTips_zh_CN.xml

📌 常用命令参考

# 统计翻译完成度
grep -c "=" GregTech.lang  # 总词条数
grep -c "=/" GregTech.lang  # 未翻译词条数

# 查找特定翻译
grep "item.ingot.Iron" *.lang

通过本指南，你已掌握从环境准备到社区贡献的完整GTNH汉化流程。无论是单机探索2300+任务，还是搭建多版本服务器，这份保姆级教程都能助你轻松开启科魔之旅。如有疑问，欢迎在项目讨论区交流，让我们共同完善这个持续五年的汉化项目！