Unity游戏AI翻译教程
所需工具下载
- 大模型对接工具：XUnity-LLMTranslateGUI
- Unity自动翻译对接软件：下载链接
- 翻译工具：XUnity.AutoTranslator
- 汉化版Mono：下载链接
- 汉化版IL2CPP：下载链接
- 中文字体：TMP_Font_AssetBundles_2025-05-12
第一步：检查游戏脚本类型
首先需要确定游戏使用的是哪种脚本后端：
📁 检查游戏目录结构：
- 存在Mono文件夹或Managed文件夹 → Mono脚本
- 存在il2cpp_data文件夹 → IL2CPP脚本
根据脚本类型下载对应的BepInEx框架：
📋 框架版本选择：
Mono脚本：下载名称中不带IL2CPP的版本（通常是BepInEx 5）
示例：XUnity.AutoTranslator-BepInEx-5.4.6.zip
IL2CPP脚本：下载名称中包含IL2CPP的版本
示例：XUnity.AutoTranslator-BepInEx-IL2CPP-5.4.6.zip
第二步：安装BepInEx框架
下载对应的BepInEx插件，将BepInEx插件全部解压到游戏根目录。
温馨提示：确保所有文件都解压到游戏根目录，不要创建额外的子文件夹。
正确安装后，游戏根目录应该包含BepInEx文件夹和其他相关文件。
第三步：安装翻译插件
下载对应的翻译插件，整个文件解压到BepInEx目录中。
确保翻译插件的文件正确放置在BepInEx目录结构内。
第四步：验证安装
进入游戏后按下Alt+0，游戏就会出现一个小窗口。
重要提示：如果没有出现窗口，就检查一下BepInEx\config目录中是否有AutoTranslatorConfig.ini文件，如果没有，就是不支持翻译。
第五步：配置翻译服务
分为两种模式：API调用大模型和本地大模型，按需设置。
API调用大模型（推荐）
下载大模型对接工具后，将软件放到游戏根目录。
支持的大模型API：
- Deepseek：https://platform.deepseek.com/
- 阿里云百炼：https://bailian.console.aliyun.com/?tab=model#/api-key
在对接工具中输入API地址和密钥，选择好模型后就可以启动服务。
本地大模型模式
配置本地大模型（建议不要用深度思考）：密钥留空
Ollma：API地址：http://localhost:11434/v1
LMStudio API地址：http://127.0.0.1:1234/v1
输入后点击获取模型列表，软件会自动搜索本地模型，选择模型后点启动服务。
第六步：配置AutoTranslatorConfig.ini文件
打开BepInEx\config\AutoTranslatorConfig.ini文件，将以下位置的代码直接复制修改：
[Service]
Endpoint=CustomTranslate
FallbackEndpoint=
[General]
Language=zh
FromLanguage=auto
[Custom]
Url=http://localhost:6800
EnableShortDelay=True
DisableSpamChecks=True
配置说明：
- Language：翻译后的语言（zh=中文）
- FromLanguage：目标语言（auto=自动检测）
- Url：翻译服务地址（默认localhost:6800）
支持的语言代码
en - 英语 (English)
zh - 中文 (Chinese)
es - 西班牙语 (Spanish)
fr - 法语 (French)
de - 德语 (German)
ja - 日语 (Japanese)
ru - 俄语 (Russian)
第七步：解决字体口口口问题
将字体压缩包解压到根目录，在AutoTranslatorConfig文件中搜索FallbackFont
将字体文件名称粘贴到=后面，示例：
FallbackFontTextMeshPro=arialuni_sdf_u2018
温馨提示：确保字体文件正确放置在游戏目录中，并且文件名与配置中的名称一致。
常见问题解决
- 翻译窗口不显示：检查BepInEx是否正确安装，确认AutoTranslatorConfig.ini文件存在
- 字体显示口口口：检查字体文件是否正确解压，FallbackFont配置是否正确
- 翻译服务连接失败：确认翻译服务已启动，端口配置正确
- 游戏崩溃：检查BepInEx版本是否与游戏脚本类型匹配
完成以上步骤后，启动游戏即可享受AI实时翻译功能！