CrowdIn Translation Guide

[DukeofRealms]

Table of Contents

• Exporting CrowdIn translations into StarMade
• Specifying a custom font in the translation file (THIS IS REQUIRED FOR LANGUAGES THAT DON'T USE A LATIN ALPHABET!)

Note: This is for people who wish to contribute to the official translation project at translate.star-made.org . This is NOT for end users.

Exporting CrowdIn translations into StarMade

This section is on how to export a CrowdIn XML and import it into StarMade for translation testing and/or actual use.

To download the latest StarMade community translation from CrowdIn, you'll need to go to StarMade — Translation Project on Crowdin and download the XML.

Spoiler: Downloading CrowdIn XML

Select the language you wish to export, in this case, French.

Click the "..." symbol and then click "Download"

You should now have a pack-crowdin.xml file, which you will need to convert to the StarMade language pack XML format using the StarMade Language Editor.

Spoiler: Converting CrowdIn XML to StarMade XML

In the "StarMade Main Menu" Go Tools & Mods>Language Editor

In the "StarMade Language Editor" go File>Import from Crowdin-XML

Type the name of the language you wish to import and then press "OK"

Import the "pack-crowdin.xml" file you downloaded from translate.star-made.org earlier.

Go File>Save as...

Finally, set the file type to ".xml", name the file "pack.xml" and "Save As..."

Go into the StarMade language directory ...\language and upload the pack.xml file you just saved. If you wanted to upload a French translation, you'd create a "frenchnew" directory in the language folder (do not name a language the same name as an existing one, this can cause issues). Upload the .xml file to ...\language\french\pack.xml . The .xml file must be named "pack.xml" so you'll need to rename it (if it isn't already called that).

Finally, edit the settings.cfg file and change the LANGUAGE_PACK = english line to the language pack you just saved. In this case, we'd change "english" to "french" . Launch the game and the language pack should be loaded into the game.

Specifying a custom font in the translation file

For languages that don't use the Latin alphabet e.g. Chinese, Korean and Japanese... a custom font must be used. If one is not specified, the characters will not show up (StarMade's default font does not support non latin characters). In the near future, we will be bundling fonts that support all these characters. For now, one must be uploaded to the language folder.

Note: Currently, only .ttf fonts are supported.

One can specify a path to a TTF file (font file) in the Language header at the very top of the pack.xml. To do this, use fontnameorpath=location\to\font . The path starts from the root of the StarMade directory (where StarMade.jar is located). We suggest placing the font in StarMade\language\fonts\fontname.ttf (you will need to create the "fonts" directory)

For example, specifying a custom font for a Chinese Simplified language pack, it would be <Language Language="ChineseSimplified" Version="0" fontnameorpath="language/chinese/NotoSansCJKtc-Regular.ttf"> . With "NotoSansCJKtc-Regular.ttf" being the font file.

We recommend using Google's Noto Font (this font is free to use).

For Chinese, Japanese and Korean characters, we've converted Googles' Noto CJK font to ttf for use in StarMade. You can download it here: NotoSansCJKtc-Regular.ttf

 

[Zeno9141]

I'm a bit confused, is this a guide on how to install a new language in starmade or a guide to contributing to the work in progress translation?

 

[Aynslei]

I'm a bit confused, is this a guide on how to install a new language in starmade or a guide to contributing to the work in progress translation?

Both, this is just making what was already possible (contributing to the translation effort) much easier to make, test, and install.

 

[Gamel]

Don't use Chinese/Japanese/Korean Pack at the moment
Using those will break the following function:
1.) adv. build mode cannot use replace function
2.) cargo pull function will stop
basicly all pull down menu is bugged with Full-width character language

 

[therimmer96]

Why not just have a dropdown box and all these languages included in the next patch, and simply put the updated ones in every patch? we already do it with texture packs.

 

[DukeofRealms]

Why not just have a dropdown box and all these languages included in the next patch, and simply put the updated ones in every patch? we already do it with texture packs.

Because this is for translators, not the end user. The files on CrowdIn are different from the StarMade XML language packs, this is to support all features CrowdIn provides. Language packs have not been fully translated yet, once they are translated, they must be approved by a professional translator to make it in the game.

If you're not one of the 217 translators who have already contributed to the project, or not someone who is starting to translate StarMade, this tutorial is not for you.

 

[DukeofRealms]

I've updated this page for the Main Menu update and added a section for specifying custom fonts in a language pack. A custom font is required for languages that don't use a latin alphabet, for example Chinese, Japanese and Korean.

 

[Megacrafter127]

A custom font is required for languages that don't use a latin alphabet, for example Chinese, Japanese and Korean.

Will modifications of latin letters (e.g. Ää Öö Üü ) also require custom fonts?
If not, what about special characters in languages that primarily use the latin alphabet (e.g. the ß in german)?

 

[DukeofRealms]

Will modifications of latin letters (e.g. Ää Öö Üü ) also require custom fonts?
If not, what about special characters in languages that primarily use the latin alphabet (e.g. the ß in german)?

Those are all fine, the game already supports all those characters.

 

[pr4xiss]

Hey,

I'm a new french contributor for translation (i also began translating some stuffs of starmadepedia.net/wiki > fr.starmadepedia.net/wiki, for instance, my first substantial translation). I'm a fan of Starmade in more than 1 year and i really like my (native and first) language but current translation is not good enough for me, so i want to help improve SMD's attractiveness for french players, if I can.

Is Crowdin project still in service?

We can see some " \ " to escape the singles quotes " ' ", Crowdin add this when we downloading the pack-crowdin.xml. Usefull or useless feature ? I've tried to delete all the 3400+ " \ " in my final pack.xml and I had no trouble in SMD, so... OK ? If ok, I could write a little batch file for the community to delete this ugly thing, until developpers solve that (or you can use this Regular Expression in Notepad++ or other editor: found " \\' " replace " ' ").

French language use a lot of longer sentences than english language then it would be important to build a new international text box with min-width and vertical scroll (like css's overflow:auto) or larger form fields, maybe smaller font sizes or game windows overhaul, but please, do not cut the words (but i like the resizable windows). Some issues images:





I found 150+ " \r&#13; " and some " \r " in pack.xml to try to jump to next line (we see " \r " in game). I delete all " \r&#13; " & " \r " there is always no trouble nor changes. My conclusion: I think the local server and/or client uses some Unix interface on Windows (or perhaps is it Java?) and we only need this carried return character: \n

Last thing, how to easily know where we need to place the carriage return" \n " in a sentence? And I'd very much like to have a list of contexts.

See you soon, bro ;-)