[TUTORIAL] How to translate Unity games using UABEA

# Info #

In this tutorial you will learn how to deal with translating games on Unity engine.
After following all steps you will be able to export assets from Unity games, make changes and then import them back using UABEA.
You should know that method shown here is not the only one available.
Each game may have an unique way of storing texts,fonts and other assets, so not every game is easy to translate. Keep that in mind!



Here you’ll find a description of basic translating method using UABEA program. This will be guide for beginner users, so every step will be nice and easy.

As an example I’m going to translate a few lines of an example game – „The Escapists 2” on PC/Steam. Let’s assume that the game is installed in the standard Steam directory:
„C:\Program Files (x86)\Steam\steamapps\common\The escapists 2”

For use of this tutorial we will try to replace this text in game:

which occurs at the start of the game before launching a first mission.
So if you’re going to search for some text, you can type in something like „optional holding centre”, because it is very specific and it occurs only in one place in the whole game.


Now let’s start. First please do prerequisites steps as they are needed to deal with assets later.


# Prerequisites Steps #
1. Search for text using method from this tutorial https://ikskoks.pl/searching-text-strings-using-total-commander/ Use the main directory of the game as a base for searching.
2. Download UABEA from this link https://github.com/nesrak1/UABEA
a ) In cases of any issues with the program, download the latest „nightly” version of UABEA instead of a standard release!
b) Double click on „UABEAvalonia.exe” to run the program

# Extracting Texts / Importing Texts #

Using search method from prerequisites step, you know that text is stored in „resources.assets” file.
You can open this file in UABEA:
1. Click File > Open (CTRL+O) in UABEA.

2. Search for „resources.assets” file on your hard drive. It should be in „..\ The escapists 2\TheEscapists2_Data” directory.

3. You will see „Assets Info” windows on your screen:

4. Now you can select all assets with CTRL+A shortcut and click „Export Dump”
5. Use total commander method https://ikskoks.pl/searching-text-strings-using-total-commander/ to search for text strings once again, but this time in the directory with extracted raw files e.g. In „..\ The escapists 2\TheEscapists2_Data\out2” directory.
6. You will find out that texts are stored in „Localization-resources.assets-1867.dat” file after extraction.
7. Now you can go back to „Assets Info” window and you can find files with „Localization” in the name:

8. Select all text assets with „Localization” word in the name (using Shift button on your keyboard) and go to Plugins > Export.txt” > OK

9. Use total commander method once again on new export directory and you will find out that text you searched for is in the file „Localization-resources.assets-1867.txt”

From this moment you can be sure now that text is stored in main Localization text asset:

10. Now you can use Notepad++ to open this file and search for text.
For this example I will replace „optional holding centre” with polish word „więzienie”

11. You can save the file now and do the import. Select the Localization asset in the „Assets Info” window

12. And then go to Plugins > Import.txt > OK
13. Go to File > Save.
14. In the main UABEA window go to File > Save

Note: Remember to save data in „Assets Info” window first and then save it again in main UABEA window! It is important to do this in that order, otherwise you can have problems with seeing changes in the game!

15. Close UABEA.
16. Launch „The Escapists 2” game to see the changes

You can see that text has been changed successfully 🙂

And that’s it. You have translated your first sentence in Unity game. Now you can try to find fonts/graphics in the game and replace them using UABEA method as well.

I’ll consider enhancing this tutorial in the future if there will still be some problems with understanding this method.