You are viewing a potentially older version of this package. View all versions.
Hayrizan-XUnity_AutoTranslator-5.6.1 icon

XUnity AutoTranslator

Advanced translator plugin

By Hayrizan
https://github.com/bbepis/XUnity.AutoTranslator
Date uploaded a week ago
Version 5.6.1
Download link Hayrizan-XUnity_AutoTranslator-5.6.1.zip
Downloads 17840
Dependency string Hayrizan-XUnity_AutoTranslator-5.6.1

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

XUnity.AutoTranslator

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

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

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 Thunderstore-compatible mod managers:

  • Thunderstore Mod Manager
  • r2modman
  • Gale Mod Manager

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

Manual installation

  1. Install the required mod loader for your game, usually BepInEx.
  2. Download this package manually from Thunderstore.
  3. Extract the archive into the game folder, where the game executable is located.
  4. 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/

Translation files are usually stored inside:

BepInEx/Translation/

Exact paths can differ depending on the game, loader, and XUnity.AutoTranslator build.

Adding this as a dependency

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.

Important notes

  • XUnity.AutoTranslator can use online translation services. If automatic translation is enabled, untranslated text may be sent to the selected translation endpoint.
  • This package is a dependency/helper package, not an official replacement for the original GitHub repository.
  • For full documentation, advanced configuration, manual translation rules, texture translation, and integration examples, use the original project documentation.
  • If a game already includes another XUnity.AutoTranslator build, avoid installing duplicate versions at the same time.

Upstream status

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.

Useful links

Наши переводы

Credits

  • XUnity.AutoTranslator: bbepis
  • Thunderstore package / redistribution helper: Hayrizan / RTLC
  • Original license: MIT License

This package exists to make localization mods easier to publish, install, and maintain.

CHANGELOG

Changelog

v5.6.1 — 2026-04-19

Fixes

  • Fixed font asset bundle loading failure in IL2CPP by @sorrowmoil in #831.
  • Fixed hotkey unresponsiveness and GUI unstripping errors in IL2CPP by @sorrowmoil in #834.
v5.6.0 — 2026-04-10

Added

  • Added UIElements support by @axxag in #818.

Fixes

  • Fixed Papago translator JS chunk pattern to match the current website structure by @markruler in #820.

Documentation

  • Added AutoPollinationTranslator to the third-party translator list in the README by @kikyo2006 in #823.
v5.5.2 — 2026-03-06

Fixes

  • Fixed DeepL API authentication to use the Authorization header instead of legacy query/body parameters by @markruler in #815.
  • Fixed override font stopping working after some time in IL2CPP.
v5.5.1 — 2026-01-28

Fixes

  • Switched to UnityInput to support both legacy and new Unity input systems by @ManlyMarco in #804.
v5.5.0 — 2025-10-27

Added

  • Added AutoTranslatorState.PluginInitialized property and PluginInitializationCompleted event, allowing other plugins to detect when AutoTranslator has finished loading by @ManlyMarco in #771.
  • Added support for the XUAIGNORETREE tag in GameObject names to prevent translation of entire GameObject trees. Unlike XUAIGNORE, this applies to the full tree instead of only the named GameObject by @ManlyMarco in #772.
  • Added support for Yandex Translate API v2 by @Noobik447 in #774.

TMP_Font_AssetBundles

  • Added arialuni_sdf_u6000 by @Galiathus987 in #787.
v5.4.6 — 2025-09-28

Fixes

  • Replaced culture-sensitive string operations with invariant/ordinal variants by @ManlyMarco in #765.
  • Fixed ResizeUI NullReferenceException when a component is destroyed by @ManlyMarco in #766.
v5.4.5 — 2025-03-28

Added

  • Added basic resizer support for NGUI by @ManlyMarco in #685.

TMP_Font_AssetBundles

  • Added arialuni_sdf-u55to2017 by @djlaser.
  • Added arialuni_sdf_u2021 and arialuni_sdf_u2022 by @ceshizhuanyong895.
v5.4.4 — 2025-01-31

Fixes

  • Added NGUI support to TextGetterCompatibilityMode.
  • Fixed broken Assembly-CSharp-firstpass detection in CallOrigin.
  • Fixed a potential assembly comparison issue in TextGetterCompatModeHelper.
  • Fixed typo in README.md by @eltociear in #660.
v5.4.3 — 2024-12-18

Fixes

  • Added a hotfix for the minor regex performance improvement by @Lmeks in #638.

CustomTranslateEndpoint

  • Added EnableShortDelay and DisableSpamChecks settings by @ManlyMarco in #645.
v5.4.2 — 2024-11-24

Changes

  • Added OS-independent paths for the MelonMod version by @PranitModak in #606.
  • Made Auto Translator plugin config accessible on Android by @PranitModak in #612.
  • Improved translation scoping: if GetScopeFromComponent fails, GetActiveSceneId is used instead of -1 by @Lmeks in #619.
  • Added minor regex performance improvements by @Lmeks in #626.
  • Moved XZipper from DotNetZip to SharpCompress by @ManlyMarco in #629.
v5.4.1

Fixes

  • Fixed crash when changing font if the previous font is null.

Maintenance

  • Moved all version constants into a global props file.
v5.4.0

Changes

  • Updated DeepL supported languages according to the API documentation.
  • Updated to BepInEx 6.0 BE-704.

Fixes

  • Fixed silently failing to get some Il2CppTypes and crashing later.
  • Fixed outline style being lost when overriding TextMeshPro font.
v5.3.1

Changes

  • Used reflection to access Il2CppInteropManager.IL2CPPInteropAssemblyPath.
  • IL2CPP: Shimmed UnityEngine.Input to fix failing to find the type in some games.

Fixes

  • Fixed HandleInputSafe crashing in some games.
  • DeepL: Fixed 404 error when calling GetClientState.

Translation

  • Allowed DeepLTranslator to support auto.
  • Added Indonesian support for DeepL Translate.
v5.3.0 FIX

Fixes

  • Fixed console management error.
v5.3.0

Features

  • Added support for the latest MelonLoader and BepInEx bleeding edge builds for IL2CPP. Use the stable release for Mono. Support for earlier versions was dropped.
  • Added PersistRichTextMode to control how text parsed as rich text during translation is persisted.

Regressions

  • Dropped support for pre-2017 Unity Engine versions for IL2CPP builds due to issues with the new IL2CPP interop. This may be re-added later.

Fixes

  • Fixed several potential NullReferenceException occurrences.
  • Fixed a potential bug during substitution replacements. Thanks to TokcDK.
v5.2.0

Features

  • Added support for Lingo Cloud. Thanks to Kiles Duli.

Fixes

  • Fixed IL2CPP issue where the plugin did not always use correct unhollowed paths for BepInEx.

About

Contact Us Privacy Policy Thunderstore Wiki

Developers

API Docs GitHub Repo Package Format Docs Markdown Preview Manifest Validator

Thunderstore 2024