Selecting User Language
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.
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
.
- MT 1.7: jvmuserargs.cfg file. On windows, this file is located at
- Once open in your editor, add on a new line:
-Duser.language\==en
- MT 1.8.*: 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.
- MT 1.9.*, 1.10.*: In the MapTool install directory under App, locate MapTool.cfg and open in a text editor
- Under
[JavaOptions]
add on a new line:java-options=-Duser.language=en
or the two-letter code for the desired language.