Internationalization

Thank you for your interest in translating the game! Here is how you can make a plugin that adds your translation of choice.

Note

You'll need to compile the source code in order to follow this tutorial. Using the NetBeans IDE is the simplest way to do so.

  1. Find your language's tag from this list (it is listed as the subtag). Locales outside of this list are not supported.

  2. Download the Sheowder source code (downloads) and add the tag to processors/src/i18n/supported_locales.properties. Remove the = from the file.

  3. Build the game (in NetBeans, open the Projects tab on the left. Right- click Sheowder and select Clean and Build).

  4. Copy all of the files from build/classes/i18n/resource/ to processors/src/i18n/resource/. Then, open each file and fill in the blanks.

  5. Build the game again and copy all files from build/classes/i18n/resource/ into a new directory.

  6. At the root of the new directory, create a file named metadata.properties. In it, put LOCALE = [language tag] (so for Chinese, for example, the file would contain LOCALE = zh).

  7. Put both the metadata.properties and the i18n/resource/ into a zip (do not zip the parent directory). Ensure it has this internal structure:

    ├── i18n
│   └── resource
└── metadata.properties

  8. Rename the zip so it has the extension .jar.

Instruct your (Windows standard installation) users to put the jar in this directory to install it:

%USERPROFILE%\scoop\persist\sheowder\plugins

An example i18n plugin is included in the processors subproject (i18n.example).