XUnity AutoTranslator

XUnity.AutoTranslator

Advanced translator plugin for Unity-based games.

This 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

dependency ID: Hayrizan-XUnity_AutoTranslator

Latest upstream release checked: v5.6.1 — 19.04.2026

What this package is for

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 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.

Features

• Automatic translation for Unity-based games.
• Manual translation support through cached translation files.
• Works well as a base dependency for localization mods.
• Supports text replacement in many Unity UI systems.
• Useful for translating game UI, menus, dialogue, item names, mod text, and other in-game strings.
• Can be used together with curated translation files for better quality than raw machine translation.

Installation

Recommended: mod manager

Install this package through one of the supported -compatible mod managers:

• Mod Manager
• r2modman
• Gale Mod Manager

The manager will install this package automatically if another mod lists it as a dependency.

Manual installation

• Install the required mod loader for your game, usually BepInEx.
• Download this package manually.
• Extract the archive into the game folder, where the game executable is located.
• Start the game once so the plugin can generate its configuration and translation folders.

For most BepInEx-based games, configuration files are generated inside:

BepInEx/config/

This package is intended to use translation files from:

BepInEx/config/Translation//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.-compatible mod managers, using BepInEx/config/Translation/ is safer because a direct BepInEx/Translation/ folder may be removed, flattened, or not created during installation.

Adding this as a dependency

If you are publishing a 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.

Important for translation pack authors

If you are publishing a 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.

Required AutoTranslatorConfig.ini paths

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 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}