Command Line Arguments
These arguments are useful for simplifying or automating the launch of a game client or modpacks. They can also be used to create a portable client.
The names of the command line parameters are constant and will not change throughout the development cycle of the launcher, so using the arguments listed below prevents the necessary settings from being reset
Prebootstrap arguments
Prebootstrap is considered deprecated. This paragraph is provided for historical purposes.
If for some reason you are still using prebootstrap - please upgrade to up-to-date portable client.
The prebootstrap arguments can be passed directly when running from the command line, in shortcut properties, or written to the tl.pbargs file. The file with arguments must be located in the same folder as the prebootstrap executable.
| Argument | Description |
|---|---|
--debug | Enable debug mode (to find out the stage causing the error) |
--skipUpdate | Skip prebootstrap update |
--bootstrap <path> | Path to launcher bootstrap.jar file |
--jreDir <path> | JRE storage path |
--jre <value> | JRE name to use for launching the bootstrap (allowed values: win64, win86, win64_jre8u45, win86_jre8u45) |
--skipBootstrapUpdate | Skip bootstrap.jar update and ingegrity checks |
Bootstrap arguments
Bootstrap prepares the environment for the launcher, essentially being a launcher for the launcher. Its arguments file can be used to set the basic settings of the launcher. This is the main jar file of the launcher used to start it.
Arguments for Bootstrap can be passed either through the tl.args file or through tl.bootargs. In the first case they are passed as application arguments, in the second case they are passed as Java arguments
Application arguments (tl.args) | Java arguments (tl.bootargs) | Description |
|---|---|---|
--targetJar <path-to-file.jar> | -Dtlauncher.bootstrap.targetJar=<path-to-file.jar> | Sets a path for launcher main executable |
--targetLibFolder <path> | -Dtlauncher.bootstrap.targetLibFolder=<path> | Sets a path for launcher libraries folder. |
--brand <name> | -Dtlauncher.bootstrap.brand=<name> | Overrides launcher "brand" (e.g. legacy, legacy_beta, mcl, …) |
--ignoreUpdate | -Dtlauncher.bootstrap.ignoreUpdate=true | Disables launcher file downloads, ignores launcher updates. Does not disable the update check itself! |
--ignoreSelfUpdate | -Dtlauncher.bootstrap.ignoreSelfUpdate=true | Disables bootstrap integrity checks and updates download. Does not disable the update check itself! |
--headlessMode | -Dtlauncher.bootstrap.headlessMode=true | Hides the bootstrap GUI. Does not affect launcher GUI. |
--packageMode <mode> | -Dtlauncher.bootstrap.packageMode=<mode> | Enables compatibility mode with various types of portable clients (windows, aur, dmg, …) |
--updateMetaFile <path> | -Dtlauncher.bootstrap.updateMetaFile=<path> | Specifies the path to the pre-downloaded update file (bootstrap.json.mgz.signed). File must be signed with the private key of the launcher developer. |
--restartExec <file> | -Dtlauncher.bootstrap.restartExec=<file> | Enables the "restart after an update" feature: specify the path to the executable file (e.g. restart.sh). |
-- | not applicable | Separates Bootstrap arguments and Launcher arguments. All arguments passed after -- considered to be a launcher arguments. |
Launcher Arguments
| Argument | Description |
|---|---|
--directory <path> | Path to the game folder. Blocks path selection in the launcher settings |
--help | Outputs all available arguments and closes the launcher |
--java-executable <path> | Sets custom JRE file path. You should provide bin/java or javaw.exe path |
--jre-dir <path> | Sets folder path for built-in JRE downloads, which can be customized |
--javaargs <arguments> | Sets the Java arguments. Blocks Java arguments editing in the launcher settings |
--margs <arguments> | Sets the Minecraft arguments. Blocks Minecraft arguments editing in the launcher settings |
--settings <path-to-file> | Sets the launcher configuration file path. The file will be created if it is missing |
--username <username> | Sets default username. This account will be created if not exists (only for --usertype plain) |
--usertype <account-type> | Specifies account type in case there are multiple account types with same name (plain,minecraft (Microsoft), ely) |
--version <version-name> | Sets the default game version |
--window <width>;<height> | Sets the launcher window size |
--background <path-to-file> | Sets the background image path. Supports http(s), ftp, jar (as zip archive) и file protocols. Blocks background setting in the launcher settings |
--fullscreen <value> | true (to force launching the game in fullscreen mode) or false (will not force fullscreen, fullscreen may still be enabled in the game settings) |
--launch | Enables the "Delayed Launch" feature - the game will launch automatically a few seconds after opening the launcher window |