Advanced translator plugin for Unity-based games.
This Thunderstore package provides XUnity.AutoTranslator as a shared dependency for translation mods. It can translate Unity game text automatically and also provides the tools needed for manual, curated translations.
Original project: bbepis/XUnity.AutoTranslator
Original author: bbepis
Thunderstore dependency ID:Hayrizan-XUnity_AutoTranslator
Latest upstream release checked:v5.6.1— 19.04.2026
Use this package when your mod, translation pack, or localization project needs XUnity.AutoTranslator but you do not want to bundle the same XUnity files directly inside your archive.
This is especially useful for Thunderstore packages because multiple DLLs and duplicated XUnity files can cause upload or dependency issues such as:
Package rejected - Invalid submission
Instead of shipping XUnity.AutoTranslator inside every localization archive, add this package as a dependency and keep your own mod archive cleaner.
Install this package through one of the supported Thunderstore-compatible mod managers:
The manager will install this package automatically if another mod lists it as a dependency.
For most BepInEx-based games, configuration files are generated inside:
BepInEx/config/
This Thunderstore package is intended to use translation files from:
BepInEx/config/Translation/<language>/Text/
For example:
BepInEx/config/Translation/es/Text/Translate.txt
BepInEx/config/Translation/ru/Text/Translate.txt
This differs from the original XUnity.AutoTranslator default path, which usually uses BepInEx/Translation/.
For Thunderstore-compatible mod managers, using BepInEx/config/Translation/ is safer because a direct BepInEx/Translation/ folder may be removed, flattened, or not created during installation.
If you are publishing a Thunderstore translation mod, add XUnity.AutoTranslator to your manifest.json dependencies.
Example:
{
"dependencies": [
"Hayrizan-XUnity_AutoTranslator-5.6.1"
]
}
Use the version that matches the package version you are targeting.
If you are publishing a Thunderstore translation pack that depends on this package, do not include XUnity.AutoTranslator DLLs, plugin files, or unnecessary config files inside your own archive.
Add this package as a dependency in manifest.json and include only your translation files, README, manifest, and icon.
The original XUnity.AutoTranslator configuration usually points to Translation\{Lang}\Text:
[Files]
Directory=Translation\{Lang}\Text
OutputFile=Translation\{Lang}\Text\_AutoGeneratedTranslations.txt
SubstitutionFile=Translation\{Lang}\Text\_Substitutions.txt
PreprocessorsFile=Translation\{Lang}\Text\_Preprocessors.txt
PostprocessorsFile=Translation\{Lang}\Text\_Postprocessors.txt
For this Thunderstore package, the [Files] paths should use config\Translation\{Lang}\Text instead:
[Files]
Directory=config\Translation\{Lang}\Text
OutputFile=config\Translation\{Lang}\Text\_AutoGeneratedTranslations.txt
SubstitutionFile=config\Translation\{Lang}\Text\_Substitutions.txt
PreprocessorsFile=config\Translation\{Lang}\Text\_Preprocessors.txt
PostprocessorsFile=config\Translation\{Lang}\Text\_Postprocessors.txt
This means translation packs should place their files here:
BepInEx/config/Translation/<language>/Text/Translate.txt
Examples:
BepInEx/config/Translation/es/Text/Translate.txt
BepInEx/config/Translation/ru/Text/Translate.txt
Avoid packaging translations directly under:
BepInEx/Translation/<language>/Text/Translate.txt
When installed through Thunderstore-compatible mod managers, the direct BepInEx/Translation/ folder may be removed, flattened, or not created, which can cause Translate.txt to be installed in the wrong location.
The latest upstream release checked while updating this README is v5.6.1.
Recent upstream highlights:
v5.6.1 — fixed IL2CPP font asset bundle loading issues and IL2CPP hotkey/GUI unstripping problems.v5.6 — added UIElements support and fixed Papago translator compatibility with the current website structure.v5.5.2 — fixed DeepL API authentication and an IL2CPP override-font issue.v5.5.1 — improved input handling through UnityInput for legacy and new Unity input systems.v5.5.0 — added initialization hooks for other plugins, XUAIGNORETREE, Yandex Translate API v2 support, and a new TMP font asset bundle.See the included changelog for the full version history.
This package exists to make localization mods easier to publish, install, and maintain.