Differences

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

--- project:mt:ug:stratupprops [2023/04/11 20:54] – snarfbur
+++ 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 [JavaOptions] section of 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 74: / Line 71: @@
 |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|
-|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.|
 |user.language|default from OS|+|+| | |user|Sets the (default) language for the MapTool UI. Fallback will be en (English).|
@@ Line 105: / Line 105: @@
 |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  ====
+==== 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. Since most developer do not speak all this languages, it can always be, that the newest text is not yet translated. Then the fallback (English) will be shown.:
+MapTool has currently translations for the following languages:
 ^Code^Language (en)|
@@ Line 129: / Line 129: @@
 |zh|Chinese|
-==== user.region  ====
+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]].
@@ Line 147: / Line 154: @@
 ==== Under Construction ====
-For MapTool Version 1.12.x (under development)
+For MapTool Version 1.13.x (under development)