Differences

This shows you the differences between two versions of the page.

--- project:mt:ug:stratupprops [2023/04/06 14:22] – publisher
+++ project:mt:ug:stratupprops [2023/05/23 12:12] (current) – snarfbur
@@ Line 28: / Line 28: @@
       * A property is a key value text pair with a '=' or ':' between them
       * E.g. MAPTOOL_DATADIR="data dictionary"
+      * More details about the format of a properties file are on this [[https://en.wikipedia.org/wiki/.properties|WIki page]]
   * **JVM Command Line Parameters (-D, -X, …)**
-      * //Correct usage (prefix) unknown//
+      * MapTool uses launchers generated with jpackage, which does not allow users to use JVM command line parameters
-      * Normally you can set the properties from the configuration file (MapTool.cfg) also during the call of the JVM
+      * Use the section [JavaOptions] in MapTool.cfg to change JVM parameters.
-      * You can see the normal, not usable prefix in the MapTool.cfg file, e.g. -DMAPTOOL_DATADIR="data directory"
-      * MapTool use a launcher to start the JVM so there should be a prefix you have to set before the JVM option
-      * This location should only be used if the application has problems to experiment with different setups.
-      * //Note: with -D parameters you can declare and set system properties//
   * **MapTool.cfg (-D, -X, …)**
       * The configuration file of MapTool is in the app subdirectory of the application home directory, e.g. {application home]/app/MapTool.cfg
@@ Line 40: / Line 37: @@
       * Use the startup property file for user specific parameters
       * This location should only be used if the application has problems to change general setups of the application.
-      * //Note: with -D parameters you can declare and set system properties//
+      * It has 3 sections:
+        * [Application] \\ Only developers will change here sometimes something
+        * [JavaOptions] \\ With the startup properties, you should no longer have to change things here, unless you have runtime troubles with MapTool.
+        * [ArgOptions] \\ In this section you can set command line options with a lower priority as the direct command line but with a higher priority then the startup properties. \\ This is used by MapTool to set the correct version. \\ With the startup properties, a user should no longer change things here.
   * **Default System Properties**
       * Most default system properties are dependent values from the operating system (OS) and are set by the JVM
-      * e.g. user.home get at the value the path&name of the OS specific home directory of the current user in the OS who starts the application
+      * e.g. user.home get his value (path&name) of the OS specific home directory of the current user in the OS who starts the application
-      * The non standrd system properties will get there default value from the application
+      * The non standard system properties will get there default value from the application
   * **Default Value**s
       * This values are defined inside the MapTool application to define a fallback value, if needed.
@@ Line 50: / Line 50: @@
 ===== Property Overview =====
-This table should give you an overview about all properties during the startup process.
+This table should give you an overview about all properties during the startup process. <datatable searching="false" paging="false">
 ^  KEY  ^  Default Value  ^  System  ^  Startup  ^  Command Line  ^^  Set By  ^  Description  |
@@ Line 61: / Line 61: @@
 |TEMP_SUBDIR_NAME|tmp| | | | | |Subdirectory under datadir for temporary data|
 |CMD_OPTIONS_HELP| | | |h|help|user|Command options incl. description to log and information frame|
-|DEBUG_FLAG|false (not set)| | |d|debug|adv.|Set log level to debug and turn on system.out enhanced debug output|
+|DEBUG_FLAG|false (not set)|-| |d|debug|adv.|Set log level to debug and turn on system.out enhanced debug output|
-|VERSION_OVERWRITE|current version| | |v|version|dev.|Overwrites the MapTool version. **ONLY FOR DEVELOPMENT.** \\ Some MapTool functions will break if the version is not set correct! This can corrupt your data!|
+|VERSION_OVERWRITE|current version|-| |v|version|dev.|Overwrites the MapTool version. **ONLY FOR DEVELOPMENT.** \\ Some MapTool functions will break if the version is not set correct! This can corrupt your data!|
-|FULLSCREEN_FLAG|false (not set)| |+|f|fullscreen|user|Maximize the MapTool window on startup|
+|FULLSCREEN_FLAG|false (not set)|-|+|f|fullscreen|user|Maximize the MapTool window on startup|
-|MONITOR_TO USE|-1 (not overwrite)| | |g|monitor|adv.|Sets which monitor (graphical device) to use.|
+|MONITOR_TO USE|-1 (not overwrite)|-| |g|monitor|adv.|Sets which monitor (graphical device) to use.|
-|WINDOW_WIDTH|-1 (not overwrite)| | |w|width|adv.|Override MapTool window width. Only usable together with monitor and height|
+|WINDOW_WIDTH|-1 (not overwrite)|-| |w|width|adv.|Override MapTool window width. Only usable together with monitor and height|
-|WINDOW_HEIGHT|-1 (not overwrite)| | |h|height|adv.|Override MapTool window height. Only usable together with monitor and width|
+|WINDOW_HEIGHT|-1 (not overwrite)|-| |h|height|adv.|Override MapTool window height. Only usable together with monitor and width|
-|WINDOW_XPOS|-1 (not overwrite)| | |x|xpos|adv.|Override MapTool window starting x coordinate. Only usable together with monitor and ypos|
+|WINDOW_XPOS|-1 (not overwrite)|-| |x|xpos|adv.|Override MapTool window starting x coordinate. Only usable together with monitor and ypos|
-|WINDOW_YPOS|-1 (not overwrite)| | |y|ypos|adv.|Override MapTool window starting y coordinate. Only usable together with monitor and xpos|
+|WINDOW_YPOS|-1 (not overwrite)|-| |y|ypos|adv.|Override MapTool window starting y coordinate. Only usable together with monitor and xpos|
 |LIST_MACRO_FLAG|false (not set)| | |m|macros|adv.|Writes a list of the defined macro functions into the log|
 |RESET_FLAG|false (not set)| | |r|reset|adv.|Reset startup options to defaults|
-|DEPRECATED_LOAD_CAMPAIGN_NAME| | | |F|file| |Load campaign from file on startup. Deprecated: Please use C or campaign|
+|DEPRECATED_LOAD_CAMPAIGN_NAME| |-| |F|file| |Load campaign from file on startup. Deprecated: Please use LOAD_CAMPAIGN_NAME (C or campaign)|
-|LOAD_CAMPAIGN_NAME| | |+|C|campaign|user|Load campaign on startup. Arg.: Full file path and name of the campaign|
+|LOAD_CAMPAIGN_NAME| |-|+|C|campaign|user|Load campaign on startup. Arg.: Full file path and name of the campaign|
-|MAPTOOL_STARTUP_FILE|startup.properties \\ under config dir.| | |P|startup-file|user|Override name (& path) of the startup properties file|
+|LOAD_SERVER_FLAG|false (not set)|-|+|S|server|user|Start server on startup. Using server parameters from user preferences (last server start dialog)|
+|LOAD_SERVER_DELAY|0|-|+|s|server-delay|user|Delay the start of the server for x seconds, e.g. network needs more time to be ready|
+|LOAD_AUTOSAVE_FILE|ask|-|+|A|autosave|user|If there is a newer autosave file then the campaign to load, should the app load it (yes), not load it (no) or ask (ask) for the decision (default is ask)|
+|MAPTOOL_STARTUP_FILE|startup.properties \\ under config dir.|-| |P|props-file|user|Override name (& path) of the startup properties file|
 |SKIP_AUTO_UPDATE_FLAG|false (not set)| |+| | |user|Skips the auto update process. There is also a user preference to do this.|
-|LOCALE_LANGUAGE|default from OS|+|+| | |user|Sets the (default) language for the MapTool UI. Fallback will be en (English).|
+|user.language|default from OS|+|+| | |user|Sets the (default) language for the MapTool UI. Fallback will be en (English).|
-|LOCALE_COUNTRY|default from oOS|+|+| | |user|Sets the (default) country for the MapTool UI.|
+|user.region|default from OS|+|+| | |user|Sets the (default) region (country) for the MapTool UI. E.g. how date or numbers are shown.|
 |MAX_MEM| |+| | | |adv.| |
 |MIN_MEM| |+| | | |adv.| |
@@ Line 84: / Line 87: @@
 |JAVA2D_OPENGL_OPTION| |+| | | |adv.| |
 |MACOSX_EMBEDDED_OPTION| |+| | | |adv.| |
+</datatable>
 ==== Legend / Notes ====
@@ Line 90: / Line 95: @@
 |KEY|identification of the value|
 |Default Value|The value, which is used if the value of the key is not set explicitly|
-|System|Can be set in the MapTool.cfg or by the JVM command line parameters, if there is a + in the key row|
+|System|Can be set in the MapTool.cfg or by the JVM command line parameters, if there is a + in the key row \\ Can be set in the MapTool.cfg using the command line option key with a '-' as prefix in the[ArgOptions] section, if there is a - in the key row.|
 |Startup|Can be set in the startup properties file, if there is a + in the key row. (+) has side conditions, see description in the row of the key|
 |Command Line Short|A single letter to use with a '-' as prefix in the command line of the application call to select the key|
@@ Line 99: / Line 104: @@
 ^Note for^Note|
 |Keys ending with FLAG|This keys have a boolean value, true or false. There default value is false and if they are set somewhere, they will be true, no matter what value was used to set the key. \\ (E.g. If you set SKIP_AUTO_UPDATE_FLAG="false" the value will be true!!! It can never be set back to false) \\ Command line has no argument. (E.g. -f or -fullscreen and not -f="true")|
+==== user.language ====
+[[https://en.wikipedia.org/wiki/List_of_ISO_639-2_codes|ISO 639 alpha-2 (-1) or alpha-3 (-2) language code]], or registered language subtags up to 8 alpha letters (for future enhancements). When a language has both an alpha-2 code and an alpha-3 code, the alpha-2 code must be used.ISO 639 alpha-2 or alpha-3 language code, or registered language subtags up to 8 alpha letters (for future enhancements). When a language has both an alpha-2 code and an alpha-3 code, the alpha-2 code must be used.
+MapTool has currently translations for the following languages:
+^Code^Language (en)|
+|en|English (Default - Fallback)|
+|ach|Acoli|
+|cs|Czech|
+|da|Danish|
+|de|German|
+|es|Spanish; Castilian|
+|fr|French|
+|it|Italian|
+|ja|Japanese|
+|nl|Dutch; Flemish|
+|pl|Polish|
+|pt|Portuguese|
+|ru|Russian|
+|sv|Swedish|
+|uk|Ukrainian|
+|zh|Chinese|
+If the translation is not there (completely or just for a specific text), the fallback language is English.
+=== How to Support Translations ===
+Quote from MapTools Discord: \\ //MapTool UI translations are crowd sourced on [[https://crowdin.com/project/maptoo|Crowdin]]. If the language you'd like to help with is not listed, ask in [[https://discord.com/channels/296230822262865920/634664267190108171|Discord MapTool#internationalisation-and-localisation]] and the dev team will set it up. \\
+If it is, create an account and join the effort. Requests to join the translation team will be reviewed at the project manager(s) earliest opportunity.//
+==== user.region ====
+[[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2|ISO 3166 alpha-2 country code or UN M.49 numeric-3 area code]].
 ===== Recommendation =====
@@ Line 114: / Line 154: @@
 ==== Under Construction ====
-For MapTool Version 1.12.x (under development)
+For MapTool Version 1.13.x (under development)