VoidExpanse/localization: Difference between revisions

From AtomicTorchWiki
No edit summary
No edit summary
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{draft}}
{{draft}}
== Localization ==
== Localization and Translation ==


Adding new languages to VoidExpanse, either to the core game or mods is really easy thanks to a special localization utility.
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 [http://atomictorch.com/Files/LocalizationUtility.zip here].
You can download the localization utility [http://atomictorch.com/Files/LocalizationUtility.zip here].
Line 11: Line 11:
First you will need to unpack the core file. Please read the relevant modding articles on how to do it.
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 fun the localization utility and point to the location of the core files you have unpacked.
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 ===
=== 2. Adding new language ===
In the localization utility and 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.
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.
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.
Line 26: Line 26:
And the file has to have the following contents:
And the file has to have the following contents:


[code]
<pre>
<root>
<root>
<header>
<header>
Line 39: Line 39:
</data>
</data>
</root>
</root>
[/code]
</pre>


=== 3. Editing the language ===
=== 3. Editing the language ===
Now, after a new language has been added restart the localization utility and it will now recognize that there is a new language present in the game.
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''.
You will see a new column for that language. In case of our example it will be ''it_it''.
Line 52: Line 52:
=== 4. Creating a localization mod ===
=== 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.
And you are done! Now you can just click on "Export localization mod" and select the language. Then you can use our Steam Mods Uploader tool (you can download it with Steam at Utilities section) to pack it into the proper mod (or you can create header.xml manually and compress it as described at [[VoidExpanse/modding|Modding]]). 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.
 
NOTE: for mod type select "Localization" (value is 4) so your mod will work properly in singleplayer and multiplayer.
 
== 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.
 
{| class="wikitable"
|-
! Language
! Language code
|-
| 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
|}
 


{{Modding}}
{{Modding}}

Latest revision as of 10:20, 17 June 2015


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

Localization and Translation

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 click on "Export localization mod" and select the language. Then you can use our Steam Mods Uploader tool (you can download it with Steam at Utilities section) to pack it into the proper mod (or you can create header.xml manually and compress it as described at Modding). 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.

NOTE: for mod type select "Localization" (value is 4) so your mod will work properly in singleplayer and multiplayer.

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.

Language Language code
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