CrowdIn Translation Guide

    DukeofRealms

    Count Duku
    Joined
    Sep 4, 2013
    Messages
    1,476
    Reaction score
    1,616
    • Schine
    Table of Contents

    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.

    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.

    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
     
    Last edited:
    • Like
    Reactions: nightrune
    Joined
    Oct 11, 2013
    Messages
    797
    Reaction score
    441
    • Competition Winner - Stations
    • Master Builder Bronze
    • Thinking Positive
    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?
     
    Joined
    Apr 24, 2013
    Messages
    436
    Reaction score
    73
    • Legacy Citizen 3
    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.
     
    Joined
    Aug 5, 2013
    Messages
    405
    Reaction score
    140
    • Community Content - Bronze 1
    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

    The Cake Network Staff Senior button unpusher
    Joined
    Jun 21, 2013
    Messages
    3,603
    Reaction score
    1,053
    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

    Count Duku
    Joined
    Sep 4, 2013
    Messages
    1,476
    Reaction score
    1,616
    • Schine
    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

    Count Duku
    Joined
    Sep 4, 2013
    Messages
    1,476
    Reaction score
    1,616
    • Schine
    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.
     
    Joined
    Jul 21, 2013
    Messages
    2,932
    Reaction score
    460
    • Hardware Store
    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

    Count Duku
    Joined
    Sep 4, 2013
    Messages
    1,476
    Reaction score
    1,616
    • Schine
    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.
     
    Joined
    Mar 9, 2015
    Messages
    3
    Reaction score
    2
    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 ;-)