Selecting User Language

From RPTools Wiki
Jump to navigationJump to search

MapTool attempts to detect the local OS's locale and select the appropriate language upon installation. To change the default language on your installation, there is a Language Override setting in the MapTool Preferences. Because of limitations in the Java 14 & 16 packager this can't be done via the UI in MapTool 1.8.* and 1.9.* but must be done by editing the config file.

The MapTool community has translated the user interface into the following languages:

  • Chinese
  • Danish
  • Dutch
  • English
  • French
  • German
  • Italian
  • Japanese
  • Polish
  • Portuguese (Brazil)
  • Russian
  • Spanish
  • Swedish
  • Ukranian

Adding Languages

MapTool is open source and depends on its community of users to make it available in more languages. If you are interested in translation for MapTool (or TokenTool) or the RPTools Wiki, reach out on the RPTools Forum and the #internationalization-and-localization channel on the MapTool Discord.

Known Language-related MapTool Errors

If your computer's locale/language settings don't correspond to a supported language, you may experience an error when running MapTool. To bypass this issue, you can try one of these workarounds:

  • Set your OS's locale and language to one of the supported languages before running MapTool.
  • Run MapTool via java on the command line to set the locale/language to English or another supported language:
java -Duser.country=US -Duser.language=en -jar MapTool-1.5.6.jar
  • An alternate way to force the language at startup is to add a line to the MapTool startup config file:
    • MT 1.7: jvmuserargs.cfg file. On windows, this file is located at C:\Users\username\AppData\Roaming\net.rptools.maptool.client\packager\jvmuserargs.cfg.
Once open in your editor, add on a new line: -Duser.language\==en
    • MT 1.8.*, 1.9.*: In the MapTool install directory under App, locate MapTool.cfg and open in a text editor
Under [JavaOptions] add on a new line: -Duser.language=en or the two-letter code for the desired language.

See Also