VoidExpanse/localization

	This article is a draft and may contain incomplete or even incorrect information. You can help by expanding it.

Localization

Adding a new languages to VoidExpanse, either to the core game or mods is really easy thanks to a special localization utility.

You can download the localization utility here.

Basically the process is as follows:

1. Unpacking the core game

First you will need to unpack the core file. Please read the relevant modding articles on how to do it.

After you have the unpacked core data simply run the localization utility and point to the location of the core files you have unpacked.

2. Adding new language

In the localization utility press "add new language". The program will tell you about adding a new language definitions first and offer to take you to the required folder. Press yes.

There you will see the default languages such as language.en_us.xml - that's what you need to create to add a new one.

You can simply take language.en_us.xml as a base and edit it to the language you need.

Let's say we want to add Italian support to the game. Here is what you will need to do:

Create a file named language.it_it.xml (according to international language codes).

And the file has to have the following contents:

<root>
	<header>
		<id>language.it_it</id>
		<title>Italiano (Italian)</title>
		<enabled>1</enabled>
	</header>

	<data>
		<!-- This is a fallback language in case some translation elements are missing -->
		<base_language>en_us</base_language>
	</data>
</root>

3. Editing the language

Now, after the new language has been added restart the localization utility and it will now recognize that there is a new language present in the game.

You will see a new column for that language. In case of our example it will be it_it.

Now simply enter your localization strings in that column and that will be it!

Finally save your work. Actually, save often, after editing every 20-30 lines. Just in case :)

4. Creating a localization mod

And you are done! Now you can just take all localization files that the program created (make sure to keep the correct paths) and put them into a new mod that you can then distribute. Then people will be able to use that mod in the game and a new language will be available for them to select in the options.

List of language codes

The game can support any language, even the ones you came up yourself, but just to be consistent below are the list of correct language codes that the game natively recognizes.

Afrikaans - af_za

Arabic - ar_ae

Basque - eu_es

Belarusian - be_by

Bulgarian - bg_bg

Catalan - ca_es

Simplified chinese - zh_ch

Traditional chinese - zh_tw

Czech - cs_cz

Danish - da_dk

Dutch - nl_be

English - en_us / en_uk (and others)

Estonian - et_ee

Faroese - fo_fo

Finnish - fi_fi

French - fr_fr

German - de_de

Greek - el_gr

Hebrew - he_il

Hugarian - hu_hu

Icelandic - is_is

Indonesian - id_id

Italian - it_it

Japanese - jp_jp

Korean - ko_kr

Latvian - lv_lv

Lithuanian - lt_lt

Norwegian - nb_no

Polish - pl_pl

Portuguese - pt_pt

Portuguese-brazil - pt_br

Romanian - ro_ro

Russian - ru_ru

Serbocroatian - sr_sp

Slovak - sk_sk

Slovenian - sl_sl

Spanish - es_es

Swedish - sv_se

Thai - th_th

Turkish - tr_tr

Ukrainian - uk_ua

Vietnamese - vi_vn

VoidExpanse Modding (Edit template)

Using mods: Installing and using mods Overview articles: Modding (main article), Package files structure Topic specific articles: Assets modding, Content Modding, Scripting overview, Scripting API, Scripting Events system, Localization Detailed scripting articles: Internal scripts, Global scripts, object scripts, Device scripts, Consumable scripting Tools: VE Physics Adjuster, VE Mod Uploader (Steam), AT Localization Utility