XUnity 自动翻译器 技术文档

XUnity 自动翻译器 技术文档

XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator

概述

XUnity Auto Translator 是一款高级的插件，专为基于Unity的游戏设计，可自动翻译游戏内容，并提供手动翻译所需工具。该插件需联网以实现自动化翻译功能，若对此有顾虑，请勿使用。

若计划将此插件作为游戏翻译套装的一部分进行再分发，请务必阅读“关于再分发”与“手动翻译”章节，以便深入了解插件运作机制。

安装指南

单独安装（ReiPatcher）

**前提条件：**无需额外依赖

**重要提示：**此方法适合大多数Unity游戏，但若游戏中已使用了支持的插件管理器，则应避免此安装方式以免冲突。

1. 阅读上述“重要提示”。
2. 从发布页面下载XUnity.AutoTranslator-ReiPatcher-{版本号}.zip。
3. 解压缩至游戏目录，确保SetupReiPatcherAndAutoTranslator.exe与其它主程序文件同级。
4. 运行SetupReiPatcherAndAutoTranslator.exe设置ReiPatcher。
5. 使用新生成的带Patch and Run的快捷方式启动游戏。
6. 此后可直接通过游戏原名.exe启动。
7. 默认非所有文本钩子启用，如发现翻译不全，需检查配置文件并启用相应框架。

BepInEx 插件

前提条件：BepInEx插件管理器

1. 下载XUnity.AutoTranslator-BepInEx-{版本号}.zip。
2. 直接解压到游戏目录中的BepInEx文件夹内。
3. 启动游戏。
4. 如有部分游戏内容未正确翻译，请检查配置文件，可能需要启用更多文本框架。

MelonLoader 插件

前提条件：MelonLoader

1. 从[发布页面]下载XUnity.AutoTranslator-MelonMod-{版本号}.zip。
2. 解压至游戏目录的Mods和UserLibs文件夹下。
3. 运行游戏。
4. 确保检查配置以启用适当组件。

其他框架安装方式

对于BepInEx IL2CPP、MelonLoader IL2CPP、IPA插件及UnityInjector插件，安装步骤类似，但需特别注意兼容性和特殊包的选择，并遵循各自框架的特定要求。

项目使用说明

• **配置调整：**首次运行会生成配置文件，用于自定义翻译偏好和启用的文本框架。
• **翻译选择：**支持多种在线翻译服务，可在配置中切换。
• **资源重定向：**可通过插件实现资源指向外部翻译文件的重定向。
• **手动翻译支持：**允许用户对特定难以自动翻译的内容手动处理。

API使用文档

本插件暂无公开API文档。但在实现自定义翻译逻辑或扩展时，可通过插件提供的事件和接口进行定制开发，具体细节需查阅源码注释或社区讨论。

注意事项

• 不同游戏环境下的兼容性可能有所差异，请参照游戏版本和框架更新说明。
• 在使用IL2CPP支持的版本时，确保使用正确的BepInEx构建版本。

此文档提供了XUnity Auto Translator的基本安装、使用指导和一般注意事项，实际操作时请参考最新版本的具体说明和潜在的更新日志。

XUnity.AutoTranslator 项目地址: https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator