> For the complete documentation index, see [llms.txt](https://docs.vntranslator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vntranslator.com/user-guide/unity-games.md).

# Unity Games

## How to Translate Unity Games

VNTranslator can translate Unity-based games in real time using XUAT, an integration that connects VNTranslator with XUnity AutoTranslator and a Unity mod loader. This guide explains how the integration works, how to install it with the XUAT Installer, and what to check if a game isn't fully supported.

***

### How the Integration Works

XUAT connects three separate tools to translate a Unity game in real time:

* **XUnity AutoTranslator** extracts text from the game and injects the translated result back into it
* **A mod loader (BepInEx or MelonLoader)** loads XUnity AutoTranslator into the game
* **VNTranslator** acts as the translation engine endpoint - it receives the extracted text, translates it, and returns the result to XUnity AutoTranslator to be displayed in the game

<table><thead><tr><th valign="top">Tool</th><th valign="top">Integration</th><th valign="top">Source</th></tr></thead><tbody><tr><td valign="top"><strong>XUnity AutoTranslator</strong></td><td valign="top">Extracts and injects translated text into the game</td><td valign="top"><a href="https://github.com/bbepis/XUnity.AutoTranslator">https://github.com/bbepis/XUnity.AutoTranslator</a></td></tr><tr><td valign="top"><strong>BepInEx</strong></td><td valign="top">Unity mod loader (plugin framework)</td><td valign="top"><a href="https://github.com/BepInEx/BepInEx">https://github.com/BepInEx/BepInEx</a></td></tr><tr><td valign="top"><strong>MelonLoader</strong></td><td valign="top">Unity mod loader (plugin framework)</td><td valign="top"><a href="https://github.com/LavaGang/MelonLoader">https://github.com/LavaGang/MelonLoader</a></td></tr></tbody></table>

{% hint style="info" %}
XUnity AutoTranslator, BepInEx, and MelonLoader are independent open-source projects and are not developed by VNTranslator. The XUAT Installer simplifies downloading and installing them together - refer to each project's repository for its full license terms and latest updates.
{% endhint %}

For issues related to game compatibility or XUAT-specific problems, refer to the [XUnity AutoTranslator GitHub Issues page](https://github.com/bbepis/XUnity.AutoTranslator/issues).

***

### What is the XUAT Installer?

The XUAT Installer is a tool built into VNTranslator that simplifies installing XUnity AutoTranslator together with a mod loader into a Unity game, without manually downloading or placing any files yourself.

<div align="left"><figure><img src="/files/cOScxYGxliR8XaJKxMzw" alt=""><figcaption></figcaption></figure></div>

**In the VNTranslator Launcher**

1. Select **XUAT** from the module list
2. Click **Browse** and select the game
3. Click the **Start** button

Clicking **Start** opens the **XUAT Installer** window, where you configure:

* **Unity Engine** - automatically detects the game's build type (Mono x64/x86 or IL2CPP x64/x86)
* **Mod Loader** - choose **BepInEx** or **MelonLoader**. Use the button next to this field to browse and download available mod loader versions directly from GitHub
* **XUAT (XUnity AutoTranslator)** - choose the version to install. Use the button next to this field to browse and download available versions directly from GitHub

Once configured, click **Install** to set up the mod loader and XUnity AutoTranslator into the game automatically.

Once installed, the **Install** button is replaced with two buttons:

* **Launch Game** to start the game with XUAT already applied
* **Uninstall** to remove the mod loader and XUnity AutoTranslator from the game.

***

### Compatibility Notes

* **Not all Unity games are supported.** Compatibility depends on the Unity version, engine modifications, and anti-cheat systems.
* **Some games may crash or freeze** when using XUAT, especially games with custom Unity builds or protection systems.
* **Text frameworks vary.** Some games require enabling specific text frameworks in the configuration file. Refer to the [text frameworks section](https://github.com/bbepis/XUnity.AutoTranslator?tab=readme-ov-file#text-frameworks) of the XUnity AutoTranslator documentation for setup details.

***

### FAQ: Translating Unity Games with VNTranslator

<details>

<summary><strong>What is XUAT?</strong></summary>

XUAT is VNTranslator's integration with XUnity AutoTranslator, a third-party tool that extracts and translates text inside Unity-based games in real time. VNTranslator acts as the translation engine behind this integration.

</details>

<details>

<summary><strong>What's the difference between BepInEx and MelonLoader?</strong></summary>

Both are Unity mod loaders required to run XUnity AutoTranslator inside a game, but they're separate projects with different licenses - BepInEx is LGPL-2.1, MelonLoader is Apache License 2.0 - and different compatibility across games. The XUAT Installer lets you choose either one depending on which the target game supports.

</details>

<details>

<summary><strong>Does XUAT support IL2CPP games?</strong></summary>

Yes. The XUAT Installer automatically detects whether a game uses Mono or IL2CPP (x64/x86) and installs a compatible mod loader and XUnity AutoTranslator build accordingly.

</details>

<details>

<summary><strong>Why isn't all the text in my Unity game being translated?</strong></summary>

Some Unity games use text rendering frameworks that aren't enabled by default in XUnity AutoTranslator's configuration file. Check the [text frameworks documentation](https://github.com/bbepis/XUnity.AutoTranslator?tab=readme-ov-file#text-frameworks) and enable the framework that matches your game.

</details>

<details>

<summary><strong>Can using XUAT get me banned or cause issues in a game?</strong></summary>

Some games use anti-cheat systems that may detect or block mod loaders like BepInEx or MelonLoader, which can cause crashes or other issues. Check the compatibility notes above and the game's community before installing XUAT on games with active anti-cheat protection.

</details>

<details>

<summary><strong>How do I remove XUAT from a game?</strong></summary>

Open the XUAT Installer for that game through the **XUAT** module in the VNTranslator Launcher, then click **Uninstall**. This removes the mod loader and XUnity AutoTranslator from the game folder.

</details>

<details>

<summary><strong>Where can I get help if my game isn't supported by XUAT?</strong></summary>

For compatibility issues specific to XUnity AutoTranslator, BepInEx, or MelonLoader, refer to the [XUnity AutoTranslator GitHub Issues page](https://github.com/bbepis/XUnity.AutoTranslator/issues) or each project's own repository.

</details>

<details>

<summary><strong>How do I change the font size in a Unity game translated with XUAT?</strong></summary>

See the dedicated guide: [How to Change Font Size in Unity.](/user-guide/unity-games/how-to-change-font-size-in-unity.md)

</details>