Runner Launch Arguments - nommiin/Tortoise GitHub Wiki

As you may know, the GMS2 Runner has support for many launch arguments. Listed below are the launch arguments I had found through disassembling the macOS Runner (macOS used due to symbols remaining in binary). Explanations taken from this article will be quoted.


Documented Arguments

  • -game <file>: Takes in a GameMaker WAD file and loads it upon the initialization of the runner

  • -exit <file?>: Seems to take a GameMaker WAD file, seemingly for GameMaker player (related to yyg_player_run function?)

  • -debug: Enables debug mode for CPhysicsWorld (Box2D?) and sets GraphicsPerf::ms_DisplayFlags to 2

  • -trace: Sets g_fVMTrace to true, which seems to invoke some sort of logging function when VM::Exec/DoCallScript are called

  • -vmtrace: Sets g_fVMDebug to true, doesn't seem to do anything?

  • -ext: Disables any extension function calls

  • -noerrors: Sets option_displayerrors to false and hides error messages from being displayed

  • -oldexec Sets g_fVMUse to false, which is checked in VMFlipRequest but seems to be unused

  • -noaudio: Sets g_fNoAudio to true, which stops sound from being played

This switches off all audio in your game, no matter whether you are using the legacy sound functions or the new audio ones.

  • -inawindow: Sets g_fInAWindow to true, which overrides option_fullscreen when reading the GEN8 chunk

Forces the game to start in a window, even when set to run in fullscreen mode.

  • -yydebugpath: Seems to allow for the runner to take in a .yydebug file from the debugger?

  • -record <file>: Makes the runner record keyboard (and gamepad?) input and saves it to the given

  • -steam: Sets g_SteamWorkshop to true, not to be confused with Steamworks this argument actually seems to have been used by the GMS1.4 Workshop runner

  • -software: Sets g_SoftwareVertexProcessing to true

Will force the game to use Software Vertex Processing instead of hardware for rendering the game graphics. This is especially useful for those PCs that are using an on-board Intel GFX chipset or show display issues on older machines.

  • -intel: Sets g_bManualClear & g_IntelHWMode to true, see this article for more information

This will switch on a fix for bad Intel drivers, no matter what GPU is being used. This work around for those bad drivers will slow things down, giving a noticeable performance hit for your game, so if you do not need the fix do not use it.

  • -audiodebug: Enables audio debugging, identically to the audio_debug(true) function

  • -networkdebug: Sets g_DebugNetworkOutput to true, which seems to log a message when yySocket::SendDataToEvent (async networking function?), yySocket::SendWSPacket (websockets), or yySocket::SendPacket is called

  • -vanillaGFX: Sets g_bVanillaGFX to true, which seems to be unused on macOS (todo: see if this changes anything on Windows)

  • -playback <file>: Sets g_IO_Playback to true, is complimentary to the -record argument and plays back the recorded inputs

  • -output <file>:

sends console output to the filename

  • -debugoutput <file>:

sends debug messages and console output to the filename

  • -headless: Sets g_fHeadless, g_fExitAfterFirstRoomCreationCode, g_fNoErrorWindow, and g_fDisableWindow to true, seems to run the first room's creation code and then exit

  • -profiledump <file> <interval>: Seems to dump the profiler (or debugger) output to the given every ? (todo: test this further)

  • -sleepmargin <value>: Overrides the set sleepmargin value

  • -multivb: Sets g_OverrideVBmethod to true and sets g_UseSingleDynamicVB to false, untested but might be related to Vertex Buffers?

  • -novb: Sets g_OverrideVBmethod and g_UseDrawPrimitiveUP to true, again seems to be related to Vertex Buffers?

  • -compresstextures: Sets g_CompressTextures to true, forces textures to be compressed upon loading at runtime

  • -manualvsync: Sets g_ManualVSync to true (todo: find out what this does)

  • -nodirectinput: Sets g_NoDirectInput to true (todo: find out what this does)

  • -nosteamrestart: Sets g_fDoSteamRestart to false, seems to allow for the game to be launched without Steam open

Undocumented Arguments

-dir
gmplayer:
gmplayer://
⚠️ **GitHub.com Fallback** ⚠️