🔥 如何快速为《最终幻想XIV》国际服注入中文？FFXIVChnTextPatch完整汉化指南

《最终幻想XIV》国际服中文补丁工具（FFXIVChnTextPatch）是一款专为FF14外服玩家设计的开源工具，能够帮助玩家一键为游戏客户端注入中文资源，让英文界面秒变熟悉的中文显示。本工具仅提供中文字库支持，需配合翻译文件使用，操作简单且安全高效！

📋 汉化前必备条件

系统与环境要求

• 操作系统：Windows 7/10/11（64位）
• 运行环境：Java SE 8+（建议Java 11长期支持版）
• 游戏版本：《最终幻想XIV》国际服最新客户端

🚀 3步快速安装指南

1️⃣ 获取项目源码

打开终端，执行以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/ff/FFXIVChnTextPatch

2️⃣ 环境检查

• 按下 Win+R 输入 cmd 打开命令提示符
• 输入 java -version 检查Java是否安装
  ✅ 显示版本号（如1.8.0_301）则正常，否则需先安装Java

3️⃣ 启动汉化工具

进入项目目录，双击运行 src/main/java 目录下的启动程序（通常为 .jar 文件），图形界面将自动打开。

⚙️ 详细操作步骤

选择游戏目录

在工具主界面点击「浏览」按钮，导航至FFXIV游戏根目录（例如 D:\Games\Final Fantasy XIV - A Realm Reborn）。

开始汉化流程

1. 确认路径无误后，点击「汉化」按钮
2. 等待进度条完成（约3-5分钟，取决于电脑配置）
3. 出现「操作成功」提示后，即可启动游戏体验中文界面

💡 小技巧：若汉化失败，可尝试以管理员身份运行工具，或检查游戏文件完整性。

🛠️ 核心功能模块解析

图形界面模块

工具主界面由 src/main/java/name/yumao/ffxiv/chn/swing/TextPatchPanel.java 实现，提供直观的路径选择和进度显示功能，新手也能轻松上手。

汉化核心逻辑

• 文本替换：通过 src/main/java/name/yumao/ffxiv/chn/replace/ReplaceEXDF.java 处理游戏文本数据
• 字体支持：src/main/java/name/yumao/ffxiv/chn/replace/ReplaceFont.java 确保中文字符正常显示

❗ 注意事项

• 本工具仅修改客户端显示语言，不会影响游戏账号安全
• 每次游戏更新后需重新运行汉化程序
• 源码修改需谨慎，建议通过 src/main/java 目录下的Java类进行二次开发

⚠️ 提示：使用前请备份游戏目录下的 game 文件夹，以便需要时恢复！

📚 进阶探索

如果您想深入了解工具原理，可查看以下核心代码目录：

• 数据模型：src/main/java/name/yumao/ffxiv/chn/model/（定义游戏数据结构）
• 工具类：src/main/java/name/yumao/ffxiv/chn/util/（提供文件操作、编码转换等基础功能）

通过本指南，您已掌握FFXIVChnTextPatch的完整使用方法。立即下载体验，让国际服之旅更加顺畅！如有问题，欢迎查阅项目 README.md 或提交Issue反馈。