Localisation

For your content to reach as many people as possible, it is important to have it translated in users’ natural language. This guide will help you do that!

Languages list

Languages natively supported by Titanfall2 are:

• English

• French

• German

• Italian

• Japanese

• Portuguese

• Russian

• Spanish

• Traditional Chinese ("tchinese")

Create translation files

Here’s what a translation file looks like:

"lang"
{
    "Language" "english"
    "Tokens"
    {
        "MENU_LAUNCH_NORTHSTAR" "Launch Northstar"
        "MENU_TITLE_MODS" "Mods"
        "RELOAD_MODS" "Reload Mods"
        "WARNING" "Warning"
        "CORE_MOD_DISABLE_WARNING" "Disabling core mods can break your client!"
        "DISABLE" "Disable"
    }
}

It begins with the "lang" instruction, contains a "Language" key indicating language of current file’s translations, and a "Token" key indexing all translations.

Warning

If the translation file contains any non-ASCII character, it must use "UTF-16 LE" encoding.

You’ll have to create one file per supported language, and all your files must be named in a similar fashion.

For example, Northstar translation files are named "northstar_client_localisation_english.txt", "northstar_client_localisation_french.txt", "northstar_client_localisation_german.txt" etc.

You can import them from your mod.json manifesto this way:

{
    "Localisation": [
        "resource/northstar_client_localisation_%language%.txt"
    ]
}

Note

The "%language%" syntax allows VM to load up translations matching game language (e.g. an English client will automatically use "northstar_client_localisation_english.txt" file)

Use translations in your code

To translate UI elements like menus, you have to insert strings containing your translation keys, preceded by a #.

For example, to translate the “Launch Northstar” button on main menu, instead of calling:

AddComboButton( comboStruct, headerIndex, buttonIndex++, "Launch Northstar" )

We’ll use:

AddComboButton( comboStruct, headerIndex, buttonIndex++, "#MENU_LAUNCH_NORTHSTAR" )

You can also use the Localize method client-side:

Localize( "#MENU_LAUNCH_NORTHSTAR" )

Northstar translations

Northstar adds new strings to the game which can be localised to match the language you are using on your Titanfall 2 installation.

They’re all located in "Northstar.Client" mod: Northstar localisation files on GitHub

Note

To test your modifications, change your game language: with Origin, go to Origin (My games library) -> Titanfall 2 (right click) -> Game Properties -> Advanced Launch Options; with Steam, go to Titanfall 2 page -> Manage (cog) -> Properties -> Language.