Command Line Parameters

From SRB2 Wiki

(Redirected from Command Line)

This article or section is incomplete. It doesn't have all of the necessary core information on this topic. Please help the SRB2 Wiki by finishing this article.

SRB2 has many command line parameters that can be used for various purposes, such as switching graphics renderers, routing. The parameters can be executed by either using the SRB2 Launcher's command line, by use of the Windows Command Prompt, or by the execution of a batch file, e.g., opengl.bat, whose text is srb2win.exe -opengl.

In the table below, text to be entered exactly is in Roman type, text to be replaced with an appropriate value is in italic type, and optional parameters are enclosed in square brackets.

Parameter	Description
`-bindaddr external-ip-address`	Listens for incoming connections on the specified address only.
`-clientport portnum`	Specifies the local UDP port to use. Overrides -udpport. Useful for running multiple instances simultaneously.
`-config filename`	Use a custom configuration file.
`-connect external-ip-address`	Specify an IP address after this, and SRB2 will automatically connect to a netgame with that external IP. If there is no IP address, SRB2 does a broadcast check for a network game.
`-console`	Creates a console window to show the SRB2 console's output and to allow console commands to be entered.
`-coopsound`	Plays more nicely with other sound-playing applications running simultaneously.
`-d3d`	Use Direct3D renderer. Unfortunately, the file `r_d3d.dll`, which is required to run this, is not included.
`-debug`	Displays more in-depth technical information in console, e.g. sprites loaded, file-searching details, etc.
`-debugfile [num]`	Outputs extra debug info the file debugnum.txt. If num is omitted, it is calculated from the player number.
`-dedicated`	Starts a dedicated server, where the host is not actually in the game, but can still use the console.
`-ds3d`	Use 3D DirectSound driver. Not implemented.
`-easter`	Turns on Easter mode if it wouldn't have been otherwise. However, there isn't a -noeaster parameter, so if you don't want Easter mode during April, you'll have to change your computer's date.
`-extratic num`	Send up to num (default 1) extra previous tics to clients per server tic.
`-file filename1 filename2 ...`	Specifies extra WAD and SOC files, to add to the game.
`-fmod3d`	Changes the sound driver to FMOD 3D system. Unfortunately, the file `s_fmod.dll`, which is required to run this, is not included.
`-freq`	Sets the playback frequency of sound samples.
`-gametype gametype`	Sets the gametype when hosting a server. The gametype parameter is in the same format as that accepted by the MAP command.
`-gettickcount`	Uses an alternative timing mechanism.
`-glide`	Uses the Glide renderer. (`r_glide.dll` is archaic)
`-internetserver`	Advertises the server on the Master Server.
`-ipx`	Uses IPX networking instead of UDP/IP.
`-iwad filename`	Uses a different IWAD. Not normally useful as the IWAD is MD5-checked.
`-height`	Screen height in pixels. Only certain width/height combinations are supported.
`-home`	Shows where to store the `config.cfg`, `gamedata.dat`, and `DOWNLOAD` folder.
`-loadgame slot`	The number after -loadgame is the slot to load.
`-maxdemo`	The effect of using this parameter is unknown.
`-mb`	How many megabytes in memory are used for SRB2.
`-minigl`	Use MiniGL as your renderer. Unfortunately, the file `r_minigl.dll`, which is required to run this, is not included. It, however, can be found here. You must save this into your SRB2 folder, and you will subsequently be able to play in MiniGL.
`-noblit`	Do not use hardware blit code.
`-nocolormaps`	Will cause SRB2 to not use colormaps. This only works with the software renderer. It is recommended that this is not used except for novelty; colormaps are used in many places, and their absence detracts from the overall experience.
`-nodigmusic`	Turns off digital music.
`-nodinput`	Don't use DirectInput.
`-nodownload`	Don't download files from servers.
`-nodownloading`	Turns off downloading won't send files when hosting a server.
`-nodraw`	Instead of DirectDraw, use GDI system.
`-noendtxt`	Do not print out ENDOOM lump to the text console window.
`-nofiles`	Don't download files when joining a server; quit if it does.
`-nojoy`	Disables joystick.
`-nomidimusic`	Turns off midi music.
`-nomouse`	Disables the mouse.
`-nomusic`	Turns off music.
`-nosound`	Turns off sound effects.
`-noxmas`	Turns off Xmas mode if it would have been otherwise.
`-objcfg`	Its the same as -file but only works with .SOCs.
`-opengl`	Uses OpenGL as SRB2's renderer.
`-packetsize bytes_per_packet`	Changes the size of the UDP packets sent in netgames.
`-password password`	Sets the password for the server.
`-playdemo demoname`	Plays back a demo.
`-precachesound`	Preloads sound effects into memory.
`-record demoname`	Records a demo, that can be played with -playdemo/-timedemo in the command line, or playdemo/timedemo in the console. It is recommended that you also use -debug, -warp and if you don't want to use normal mode, -skill.
`-resetdata`	Doesn't load your gamedata file. SRB2 can still write to your gamedata, thus clearing your emblems, secrets, and time attack data.
`-server`	Automatically starts a server.
`-skill skill level`	Will automatically start a game of that skill level.
`-sounddriver`	Changes the sound driver to the text after -sounddriver.
`-splitscreen`	Automatically starts a splitscreen game. This won't have any effect unless you use another parameter that starts a game automatically.
`-timedemo demoname`	Plays back a demo as fast as possible, and afterwards, you can check the console for info like how long it took to play back the demo.
`-timetic`	The time will show up in tics instead of minutes and seconds.
`-udpport`	UDP port # to use
`-usecd`	Use the music from a music CD instead of `music.dta`.
`-voodoo`	Turns on gr_voodoocompatibility. (untest and removed codepath)
`-warp map number`	Specify a map number after this, and the game will automatically warp to that map. Use the integer representation. Also, this will not work if the game isn't modified or it's a netgame. So, use -file srb2.srb if you want to play in normal srb2 and warp to a level in single player.
`-width number`	Resolution width.
`-win`	Windowed mode.
`-winmidi device number`	Overrides the choice of device for MIDI output.
`-xmas`	Turns on Christmas mode if it wouldn't have been otherwise.