GTNH整合包汉化实战指南：从部署到故障排除的全流程解决方案

适配版本说明

GTNH汉化项目持续跟进整合包版本迭代，当前支持以下版本：

• GTNH 2.4.0+ 完整支持
• GTNH 2.3.x 部分支持（需使用历史版本汉化文件）
• 旧版整合包（2.2及以下）建议升级后使用最新汉化资源

汉化文件结构解析

项目采用模组分类的目录结构设计，核心文件组织如下：

config/
├── GTNewHorizons/          # 核心GT模组配置
│   └── CustomToolTips_zh_CN.xml  # 工具提示汉化
├── InGameInfoXML/          # 游戏内信息面板
│   └── InGameInfo_zh_CN.xml      # 界面元素汉化
├── Betterloadingscreen/    # 加载界面资源
│   └── tips/
│       └── zh_CN.txt       # 加载提示文本
└── txloader/               # 模组语言文件加载器
    ├── forceload/          # 强制加载的语言文件
    └── load/               # 各模组语言文件
        ├── betterquesting/ # 任务系统
        ├── draconicevolution/ # 龙之进化
        ├── thaumcraft/     # 神秘时代
        └── tectech/        # 泰克科技

部署策略：两种安装方式

方案A：文件覆盖部署

1. 下载汉化包并解压
2. 复制解压后的config目录到GTNH整合包根目录
3. 确认文件覆盖提示，选择"替换目标中的文件"
4. 启动游戏，在语言设置中选择"简体中文"

方案B：Git版本控制部署

通过Git实现汉化文件的自动更新：

# 克隆汉化仓库
git clone https://gitcode.com/gh_mirrors/tr/Translation-of-GTNH

# 复制文件到整合包目录（假设整合包位于~/minecraft/GTNH）
cp -r Translation-of-GTNH/* ~/minecraft/GTNH/

# 后续更新操作
cd Translation-of-GTNH
git pull  # 获取最新翻译
cp -r * ~/minecraft/GTNH/  # 同步更新文件

汉化覆盖范围

核心模组支持

• GregTech：全机器界面、物品描述、合成配方
• Thaumcraft：研究系统、魔典内容、元素名称
• Draconic Evolution：设备属性、升级说明、技能树
• Tinkers' Construct：工具属性、材料特性、铸造系统

界面元素覆盖

• 游戏内所有GUI界面文本
• 任务系统与进度提示
• 物品悬浮提示（Tooltips）
• 合成配方描述与提示
• 错误信息与状态通知

风险提示与故障排除

汉化不生效问题

症状	可能原因	解决方案
所有内容未汉化	语言设置错误	游戏选项→语言→选择"简体中文"
部分模组未汉化	文件路径错误	确认汉化文件位于config根目录下
启动报错	文件权限问题	Linux系统执行chmod -R 644 config/赋予读取权限
显示乱码	编码格式错误	使用UTF-8编码重新保存语言文件

常见问题处理

缓存冲突解决：

# 删除缓存目录
rm -rf config/cache/

版本不匹配处理：

1. 查看整合包版本号（在启动器中）
2. 访问汉化项目发布页下载对应版本
3. 完全替换config目录后重启游戏

进阶使用技巧

个性化调整

修改语言文件自定义翻译内容：

# 编辑GT主语言文件
nano config/GregTech.lang

# 查找并修改对应条目
item.ingotCopper=铜锭  # 修改前
item.ingotCopper=电解铜锭  # 修改后

备份策略

建立配置备份脚本：

# 创建备份脚本
cat > backup_gtnh_lang.sh << 'EOF'
#!/bin/bash
BACKUP_DIR=~/gtnh_backups/$(date +%Y%m%d)
mkdir -p $BACKUP_DIR
cp -r config/ $BACKUP_DIR/
echo "备份完成: $BACKUP_DIR"
EOF

# 添加执行权限
chmod +x backup_gtnh_lang.sh

贡献翻译

发现未汉化内容时：

1. 记录未翻译文本的键名和上下文
2. 编辑对应模组的zh_CN.lang文件
3. 提交修改到汉化项目仓库

通过本指南提供的部署方案和故障排除方法，玩家可快速实现GTNH整合包的全中文界面。建议定期更新汉化文件以获取最新翻译内容，确保游戏体验的完整性和准确性。