1. Hey Guest! We're currently translating StarMade. Anyone can translate, if you can, feel free to!
      Dismiss Notice
    2. Hey Guest! We're currently looking for new forum administrators. If this interests you, head over to this thread.
      Dismiss Notice

    CrowdIn Translation Guide

    Discussion in 'Game Support' started by DukeofRealms, Apr 29, 2016.

    1. DukeofRealms

      DukeofRealms Count Duku

      Joined:
      Sep 4, 2013
      Messages:
      1,245
      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.
      [​IMG]

      Click the "..." symbol and then click "Download"
      [​IMG]

      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
      [​IMG]

      In the "StarMade Language Editor" go File>Import from Crowdin-XML
      [​IMG]

      Type the name of the language you wish to import and then press "OK"
      [​IMG]

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

      Go File>Save as...
      [​IMG]

      Finally, set the file type to ".xml", name the file "pack.xml" and "Save As..."
      [​IMG]

      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 "french" directory in the language folder. 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
       
      #1 DukeofRealms, Apr 29, 2016
      Last edited: May 28, 2016
      • Like Like x 1
    2. Zeno9141

      Joined:
      Oct 11, 2013
      Messages:
      798
      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?
       
    3. Aynslei

      Joined:
      Apr 24, 2013
      Messages:
      436
      Both, this is just making what was already possible (contributing to the translation effort) much easier to make, test, and install.
       
      • Informative Informative x 1
    4. Gamel

      Joined:
      Aug 5, 2013
      Messages:
      391
      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
       
    5. therimmer96

      therimmer96 Cake Build Server Staff Elwyn Returnity Staff

      Joined:
      Jun 21, 2013
      Messages:
      3,468
      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.
       
    6. DukeofRealms

      DukeofRealms Count Duku

      Joined:
      Sep 4, 2013
      Messages:
      1,245
      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.
       
      • Informative Informative x 2
    7. DukeofRealms

      DukeofRealms Count Duku

      Joined:
      Sep 4, 2013
      Messages:
      1,245
      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.
       
    8. Megacrafter127

      Joined:
      Jul 21, 2013
      Messages:
      2,931
      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)?
       
    9. DukeofRealms

      DukeofRealms Count Duku

      Joined:
      Sep 4, 2013
      Messages:
      1,245
      Those are all fine, the game already supports all those characters.
       
    10. pr4xiss

      Joined:
      Mar 9, 2015
      Messages:
      1
      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:

      [​IMG]

      [​IMG]

      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 ;-)
       
    Loading...