autotranslator

XUnity Auto Translator

All the basic information about the plugin is located here - XUnity.AutoTranslator

Plugin author: bbepis

Icon:

For translating the whole game, it's recommended to use community translation from Crowdin instead. Check the description of the Crowdin page to learn how to convert json file to game locale files.

The following are some extracted important info for normal users. The full manual can be found in github repo or plugins\README (AutoTranslator).md in the zip package.

Introduction

This is an advanced translator plugin that can be used to translate Unity-based games automatically and also provides the tools required to translate games manually. It does (obviously) go to the internet, in order to provide the automated translation, so if you are not comfortable with that, don't use it.

Key Mapping

The following key inputs are mapped:

• ALT + 0: Toggle XUnity AutoTranslator UI. (That's a zero, not an O)
• ALT + 1: Toggle Translation Aggregator UI.
• ALT + T: Alternate between translated and untranslated versions of all texts provided by this plugin.
• ALT + R: Reload translation files. Useful if you change the text and texture files on the fly. Not guaranteed to work for all textures.
• ALT + U: Manual hooking. The default hooks wont always pick up texts. This will attempt to make lookups manually. Will not hook text components from frameworks not enabled.
• ALT + F: If OverrideFont is configured, will toggle between overridden and default font.
• ALT + Q: Reboot the plugin if it was shutdown. This will only work if the plugin was shut down due to consecutive errors towards the translation endpoint. Should only be used if you have reason to believe you have remedied the problem (such as changed VPN endpoint etc.) otherwise it will just shut down again.

Installation

Via mod manager r2modman.

Manual install:

• Install BepInEx 5.4.17 framework
• Download the mod zip file
• Unzip and put the content into BepInEx folder

core\XUnity.Common.dll -> BepInEx\core

plugins\XUnity.AutoTranslator, plugins\XUnity.ResourceRedirector -> BepInEx\plugins

Configuration

The config file BepInEx\Config\AutoTranslatorConfig.ini will be generated after the game start with this plugin.

In order to translate, change the language settings in the config file and restart to let the config file take effect.

[Service]

Endpoint=GoogleTranslate;Endpoint to use. See the translators section for valid values.

FallbackEndpoint=;Endpoint to automatically fallback to if the primary endpoint fails for a specific translation.

[General]

Language=en;The language to translate into

FromLanguage=ja;The original language of the game. "auto" is also supported for some endpoints, but it is generally not recommended

[Files]

Directory=Translation\{Lang}\Text;Directory to search for cached translation files. Can use placeholder: {GameExeName}, {Lang}

OutputFile=Translation\{Lang}\Text\_AutoGeneratedTranslations.txt;File to insert generated translations into. Can use placeholders: {GameExeName}, {Lang}

SubstitutionFile=Translation\{Lang}\Text\_Substitutions.txt;File that contains substitution applied before translations. Can use placeholders: {GameExeName}, {Lang}

PreprocessorsFile=Translation\{Lang}\Text\_Preprocessors.txt;File that contains preprocessors to be applied before sending a text to a translator. Can use placeholders: {GameExeName}, {Lang}

PostprocessorsFile=Translation\{Lang}\Text\_Postprocessors.txt;File that contains postprocessors to be applied after receiving a text from a translator. Can use placeholders: {GameExeName}, {Lang}

[TextFrameworks]

EnableUGUI=True;Enable or disable UGUI translation

EnableNGUI=True;Enable or disable NGUI translation

EnableTextMeshPro=True;Enable or disable TextMeshPro translation

EnableTextMesh=False;Enable or disable TextMesh translation

EnableIMGUI=False;Enable or disable IMGUI translat