Editing MG/Command line options

[[MegaGlest]] has a number of command line options; toggles which can be appended to the executable name when running MegaGlest from a command line or console. Some of these are unique to the console, allowing settings to be controlled before the game even finishes starting up (such as disabling VBOs), while others allow an alternative to changes to the [[MG/INI|INI settings]].

==Usage==
To use a command line option, append it behind the name of the binary or executable for MegaGlest in the command line. For example, to toggle on verbose reporting, you could use:
 megaglest --verbose

It's also possible to use multiple command line options. For example, if you wanted to set a different resolution and use fullscreen, you could use:
 megaglest --resolution=1920x1080 --fullscreen=true
Since you can assign command line options to links, this makes it possible to have a link to play MegaGlest in fullscreen and a link to play it at a smaller windowed resolution.

==Command line options==
{| class="wikitable"
! style="font-size: 8pt; width: 300px;" | Option
!Details
|-
| style="font-size: 8pt;" |<tt>--help</tt>
| style="font-size: 8pt;" |Displays a full list of available command line options.
|-
| style="font-size: 8pt;" |<tt>--autostart-lastgame</tt>
| style="font-size: 8pt;" |Automatically starts a game with the last game settings you played.
|-
| style="font-size: 8pt;" |<tt>--connecthost=x</tt>
| style="font-size: 8pt;" |Auto connect to host server at IP or hostname <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--starthost</tt>
| style="font-size: 8pt;" |Auto create a host server.
|-
| style="font-size: 8pt;" |<tt>--headless-server-mode=x,x</tt>
| style="font-size: 8pt;" |Run as a headless server where x is an optional comma delimited command list of one or more of <tt>exit</tt> (quits the application after a game has no more connected players) or <tt>vps</tt> (does NOT read commands from the local console  - for some VPSs).
|-
| style="font-size: 8pt;" |<tt>--use-ports=x,y,z</tt>
| style="font-size: 8pt;" |Force hosted games to listen internally on port x, externally on port y, where x is the internal port # on the local machine to listen for connects and y is the external port # on the router/proxy to forward connection from to the internal port number. If enabled the FTP server port numbers will be set to x+1 to x+9. z is the game status port # on the local machine to listen for status requests
|-
| style="font-size: 8pt;" |<tt>--load-scenario=x</tt>
| style="font-size: 8pt;" |Auto-load a scenario by scenario name.
|-
| style="font-size: 8pt;" |<tt>--load-mod=x</tt>
| style="font-size: 8pt;" |Auto-load a mod by mod pathname.
|-
| style="font-size: 8pt;" |<tt>--preview-map=x</tt>
| style="font-size: 8pt;" |Auto-preview a map by map name.
|-
| style="font-size: 8pt;" |<tt>--version</tt>
| style="font-size: 8pt;" |Displays the version string of MegaGlest.
|-
| style="font-size: 8pt;" |<tt>--opengl-info</tt>
| style="font-size: 8pt;" |Displays your video driver's OpenGL info.
|-
| style="font-size: 8pt;" |<tt>--sdl-info</tt>
| style="font-size: 8pt;" |Displays your SDL version information.
|-
| style="font-size: 8pt;" |<tt>--lua-info</tt>
| style="font-size: 8pt;" |Displays your Lua version information.
|-
| style="font-size: 8pt;" |<tt>--curl-info</tt>
| style="font-size: 8pt;" |Displays your CURL version information.
|-
| style="font-size: 8pt;" |<tt>--validate-techtrees=a=purgeunused=purgeduplicates<br />=svndelete=hideduplicates</tt>
| style="font-size: 8pt;" |Displays a report detailing any known problems related to your selected techtrees game data.
*<tt>a</tt> is a comma-delimited list of techtrees to validate.
*<tt>purgeunuse</tt> is an optional parameter which tells the validation to delete extra files in the techtree that are not used.
*<tt>purgeduplicates</tt> is an optional parameter which tells the validation to merge duplicate files in the techtree.
*<tt>svndelete</tt> is an optional parameter telling the validation to call SVN delete on duplicate/unused files in the techtree.
*<tt>hideduplicates</tt> is an optional parameter, which, if true, tells the validation to not show duplicate files in the techtree. This only applies when files are purged due to the above flags being set.
Example:
 megaglest --validate-techtrees=megapack
|-
| style="font-size: 8pt;" |<tt>--validate-actions=a=purgeunused=purgeduplicates<br />=hideduplicates</tt>
| style="font-size: 8pt;" |Displays a report detailing any known problems related to your selected factions game data.
*<tt>a</tt> is a comma-delimited list of factions to validate.
*<tt>purgeunuse</tt> is an optional parameter which tells the validation to delete extra files in the techtree that are not used.
*<tt>purgeduplicates</tt> is an optional parameter which tells the validation to merge duplicate files in the techtree.
*<tt>hideduplicates</tt> is an optional parameter, which, if true, tells the validation to not show duplicate files in the techtree. This only applies when files are purged due to the above flags being set.
Example:
 megaglest --validate-factions=magic,tech
|-
| style="font-size: 8pt;" |<tt>--validate-scenario=a=purgeunused</tt>
| style="font-size: 8pt;" |Displays a report detailing any known problems related to your selected scenario game data.
*<tt>a</tt> is a single scenario to validate.
*<tt>purgeunused</tt> is an optional parameter telling the validation to delete extra files in the scenario that are not used.
|-
| style="font-size: 8pt;" |<tt>--data-path=x</tt>
| style="font-size: 8pt;" |Sets the game data path to <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--ini-path=x</tt>
| style="font-size: 8pt;" |Sets the game [[MG/INI|INI]] path to <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--log-path=x</tt>
| style="font-size: 8pt;" |Sets the game logs path to <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--show-ini-settings=x</tt>
| style="font-size: 8pt;" |Display merged INI settings information. <tt>x</tt> is an optional property name to filter to a specific INI option (by default all are shown).

Example:
 megaglest --show-ini-settings=DebugMode
|-
| style="font-size: 8pt;" |<tt>--convert-models=a=b=keepsmallest</tt>
| style="font-size: 8pt;" |Convert a model file or folder to the current G3D version format.
*<tt>a</tt> is a filename or folder containing the G3D model(s).
*<tt>b</tt> is an optional supported texture format to convert the model's texture to (TGA, BMP, JPG, or PNG).
*<tt>keepsmallest</tt> is an optional flag indicating to keep original texture if its filesize is smaller than the converted format.

Example:
<pre style="font-size: 7pt;">megaglest --convert-models=/m.g3d=png=keepsmallest</pre>
|-
| style="font-size: 8pt;" |<tt>--use-language=x</tt>
| style="font-size: 8pt;" |Forces the language to be the language specified by <tt>x</tt>, where <tt>x</tt> is a language filename or ISO639-1 code.

Example:
 megaglest --use-language=en
|-
| style="font-size: 8pt;" |<tt>--show-map-crc=x</tt>
| style="font-size: 8pt;" |Show the calculated CRC for the map named <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--show-tileset-crc=x</tt>
| style="font-size: 8pt;" |Show the calculated CRC for the tileset named <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--show-techtree-crc=x</tt>
| style="font-size: 8pt;" |Show the calculated CRC for the techtree named <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--show-scenario-crc=x</tt>
| style="font-size: 8pt;" |Show the calculated CRC for the scenario named <tt>x</tt>.
|-
| style="font-size: 8pt;" |<tt>--show-path-crc=x=y</tt>
| style="font-size: 8pt;" |Show the calculated CRC for files in the path lo
cated in <tt>x</tt> using file filter <tt>y</tt>.

Example:
 megaglest --show-path-crc=techs/=megapack.7z
|-
| style="font-size: 8pt;" |<tt>--disable-backtrace</tt>
| style="font-size: 8pt;" |Disables stack backtrace on errors.
|-
| style="font-size: 8pt;" |<tt>--disable-sigsegv-handler</tt>
| style="font-size: 8pt;" |Disables the sigsegv error handler.
|-
| style="font-size: 8pt;" |<tt>--disable-vbo</tt>
| style="font-size: 8pt;" |Disables trying to use Vertex Buffer Objects. This can prevent crashes with some considerably older graphics cards.
|-
| style="font-size: 8pt;" |<tt>--disable-sound</tt>
| style="font-size: 8pt;" |Disables the sound system.
|-
| style="font-size: 8pt;" |<tt>--enable-legacyfontd</tt>
| style="font-size: 8pt;" |Enables using the legacy font system.
|-
| style="font-size: 8pt;" |<tt>--force-ftglfonts</tt>
| style="font-size: 8pt;" |Forces use of the FTGL font system.
|-
| style="font-size: 8pt;" |<tt>--resolution=x</tt>
| style="font-size: 8pt;" |Overrides the video resolution. <tt>x</tt> is a string in the format of [width]x[height].

Example:
 megaglest --resolution=1024x768
|-
| style="font-size: 8pt;" |<tt>--colorbits=x</tt>
| style="font-size: 8pt;" |Override the video color bits. <tt>x</tt> is a valid color bits value supported by your video driver.
|-
| style="font-size: 8pt;" |<tt>--depthbits=x</tt>
| style="font-size: 8pt;" |Override the video depth bits. <tt>x</tt> is a valid depth bits value supported by your video driver.
|-
| style="font-size: 8pt;" |<tt>--fullscreen=x</tt>
| style="font-size: 8pt;" |Override the video fullscreen mode. If <tt>x</tt> is true, the game is fullscreen, while false causes the game to be windowed.

Example:
 megaglest --fullscreen=true
|-
| style="font-size: 8pt;" |<tt>--use-font=x</tt>
| style="font-size: 8pt;" |Override the font to use. <tt>x</tt> is the path and name of a font file supported by freetype2.

Example:
  megaglest --use-font=c:\Fonts\Vera.ttf
|-
| style="font-size: 8pt;" |<tt>--font-basesize=x</tt>
| style="font-size: 8pt;" |Override the font base size. <tt>x</tt> is the numeric base font size to use.

Example:
 megaglest --font-basesize=5
|-
| style="font-size: 8pt;" |<tt>--verbose</tt>
| style="font-size: 8pt;" |Displays verbose information in the console.
|-
| style="font-size: 8pt;" |<tt>--list-maps</tt>
| style="font-size: 8pt;" |Displays a list of all [[maps]].
|-
| style="font-size: 8pt;" |<tt>--list-tilesets</tt>
| style="font-size: 8pt;" |Displays a list of all [[tilesets]].
|-
| style="font-size: 8pt;" |<tt>--list-scenarios</tt>
| style="font-size: 8pt;" |Displays a list of all [[scenarios]].
|-
| style="font-size: 8pt;" |<tt>--list-techtrees</tt>
| style="font-size: 8pt;" |Displays a list of all [[techtrees]].
|-
| style="font-size: 8pt;" |<tt>--list-tutorials</tt>
| style="font-size: 8pt;" |Displays a list of all [[tutorials]].
|}

==See also==
*[[MG/INI|MegaGlest's INI]]
*[[MG/Features|List of MegaGlest features]]