Selecting User Language: Difference between revisions
Jump to navigation
Jump to search
(Add alternative workaround) |
m (Taustin moved page selecting User Language to Selecting User Language) |
||
| (13 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
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#Language_Override|MapTool Preferences]]. | 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#Language_Override|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: | The MapTool community has translated the user interface into the following languages: | ||
* Chinese | |||
* Danish | |||
* Dutch | |||
* English | * English | ||
* French | |||
* German | |||
* Italian | * Italian | ||
* Japanese | |||
* Polish | * Polish | ||
* | * Portuguese (Brazil) | ||
* Russian | * Russian | ||
* Spanish | * Spanish | ||
* | * Swedish | ||
* Ukranian | |||
==Adding Languages== | ==Adding Languages== | ||
| Line 19: | Line 24: | ||
* Set your OS's locale and language to one of the supported languages before running MapTool. | * 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: | * Run MapTool via java on the command line to set the locale/language to English or another supported language: | ||
: <code>java -Duser.country=US -Duser.language=en -jar MapTool-1.5.6.jar</code> | : <code>java -Duser.country=US -Duser.language=en -jar MapTool-1.5.6.jar </code> | ||
* An alternate way to force the language at startup is to add a line to the jvmuserargs.cfg file. | * 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 <code>C:\Users\username\AppData\Roaming\net.rptools.maptool.client\packager\jvmuserargs.cfg</code>. | |||
<code>C:\Users\username\AppData\Roaming\net.rptools.maptool.client\packager\jvmuserargs.cfg | : Once open in your editor, add on a new line: <code>-Duser.language\==en</code> | ||
-Duser.language\==en</code> | ** MT 1.8.*: In the MapTool install directory under ''App'', locate MapTool.cfg and open in a text editor | ||
: Under <code>[JavaOptions]</code> add on a new line: <code>-Duser.language=en</code> or the two-letter code for the desired language. | |||
** MT 1.9.*, 1.10.*, 1.11.*: In the MapTool install directory under ''App'', locate MapTool.cfg and open in a text editor | |||
: Under <code>[JavaOptions]</code> add on a new line: <code>java-options=-Duser.language=en</code> or the two-letter code for the desired language. | |||
==See Also== | ==See Also== | ||
* [[Editor:Translation| | * [[Editor:Translation|Editor Notes for wiki translators]]. | ||
* [https://github.com/RPTools/maptool/issues/843 Locale/language Github issue]. | * [https://github.com/RPTools/maptool/issues/843 Locale/language Github issue]. | ||
[[Category:MapTool]] | [[Category:MapTool]] | ||
Latest revision as of 23:59, 8 March 2023
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=enor the two-letter code for the desired language.
- MT 1.9.*, 1.10.*, 1.11.*: 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=enor the two-letter code for the desired language.