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 Magic Man

      Joined:
      Sep 4, 2013
      Messages:
      1,159
      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:
      380
      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,400
      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 Magic Man

      Joined:
      Sep 4, 2013
      Messages:
      1,159
      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 Magic Man

      Joined:
      Sep 4, 2013
      Messages:
      1,159
      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,920
      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 Magic Man

      Joined:
      Sep 4, 2013
      Messages:
      1,159
      Those are all fine, the game already supports all those characters.
       
    Loading...