Console

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's console allows the user to control many of the game's options and to perform certain actions. Sometimes the same effects can be achieved using the menus, but the console is the only way of utilizing many features.

The console is accessed by pressing the key defined in the controls, which by default is ~ (tilde) on US keyboards and ` (backquote) on UK keyboards. This displays a prompt at which the user is expected to enter a command. To close the console, press the same key that was used to open it.

Some console commands and variables have options for the second player in splitscreen mode. Those will be shown with a forward slash. For instance, with "CHASECAM/CHASECAM2 <booleans>", CHASECAM toggles the first player's camera, and CHASECAM2 toggles the second player's camera.

Pressing the tab key when a command or var name is partly entered will auto-complete the command, pressing the tab key again will go to the next one.

Contents 1 Syntax 1.1 Special Characters 1.1.1 Semicolon (;) 1.1.2 Quote (") 1.2 Script files 1.2.1 autoexec.cfg 1.2.2 adedserv.cfg 2 Commands 2.1 ADDFILE <filename> 2.2 ALIAS <commands> 2.3 BAN <playername/node> <reason> 2.4 BIND <key> <command> 2.5 CECHO <message> 2.6 CECHODURATION <seconds> 2.7 CECHOFLAGS <integer> 2.8 CHANGECONFIG <filename> 2.9 CHANGETEAM/CHANGETEAM2 <red/blue/spectator/playing> 2.10 CHARABILITY <1/2> <value> 2.11 CHARSPEED <parameter> <value> 2.12 CLEARBANS 2.13 CLEARSCORES 2.14 CLS 2.15 CONNECT <ip> 2.16 COUNTMOBJS 2.17 CSAY <message> 2.18 DEVMODE <integer> 2.19 DISPLAYPLAYER 2.20 ECHO <message> 2.21 ENGLISH 2.22 EXEC <filename> 2.23 EXITGAME 2.24 EXITLEVEL 2.25 GAMETYPE 2.26 GETALLEMERALDS 2.27 GETPLAYERNUM 2.28 GOD 2.29 GRAVFLIP 2.30 HELP <command> 2.31 HURTME <value> 2.32 ISGAMEMODIFIED 2.33 JUMPTOAXIS <axis number> 2.34 KICK <playername/node> <reason> 2.35 LISTSERV 2.36 LISTWAD 2.37 LOADCONFIG <filename> 2.38 LOGIN <password> 2.39 MAP MAP<value> 2.39.1 -GAMETYPE <game mode name or number> 2.39.2 -FORCE 2.39.3 -NORESETPLAYERS 2.40 MOD_DETAILS 2.41 MEMFREE 2.42 MOTD <message> 2.43 NOCLIP 2.44 NODES 2.45 NUMTHINKERS <number> 2.46 ORDERPIZZA 2.47 PASSWORD <value> 2.48 PAUSE 2.49 PING <player/node> 2.50 PLAYDEMO <filename> 2.51 PLAYINTRO 2.52 QUIT 2.53 RELOADBANS 2.54 RESETCAMERA 2.55 RESETEMERALDS 2.56 RTELEPORT -x <X distance> -y <Y distance> -z <Z distance> 2.57 RUNSOC <socfile.soc or lumpname> 2.58 SAVECHECKPOINT 2.59 SAVECONFIG <filename> 2.60 SAY <message> 2.61 SAYTEAM <message> 2.62 SAYTO <playername/node> <message> 2.63 SCALE <percent> 2.64 SERVERCHANGETEAM <playername> <red/blue/spectator/playing/it/notit> 2.65 SCREENSHOT 2.66 SETCONTROL/SETCONTROL2 2.67 SHOWBANLIST 2.68 SHOWMAP 2.69 SHOWSCORES 2.70 SHOWTIME 2.71 SKYNUM <number> 2.72 SOUNDTEST <number> 2.73 STARTMOVIE 2.74 STOPDEMO 2.75 STOPMOVIE 2.76 TELEPORT -x <X location> -y <Y location> -z <Z location> 2.77 TIMEDEMO 2.78 TOGGLE <variable> 2.79 TUNES <slot> <speed> 2.80 VERIFY <playername/node> 2.81 VERSION 2.82 VID_MODE <mode number> 2.83 VID_MODEINFO <mode number> 2.84 VID_MODELIST 2.85 VID_NUMMODES 2.86 WAIT <tics> 2.87 WRITETHINGS 3 Variables 3.1 1UP <integer> 3.2 ADVANCEMAP <integer> 3.3 ALLCAPS <boolean> 3.4 ALLOWAUTOAIM <boolean> 3.5 ALLOWEXITLEVEL <boolean> 3.6 ALLOWJOIN <boolean> 3.7 ALLOWMLOOK <boolean> 3.8 ALLOWSEENAMES <boolean> 3.9 ALLOWTEAMCHANGE <boolean> 3.10 ALWAYSMLOOK/ALWAYSMLOOK2 <boolean> 3.11 ANALOG/ANALOG2 <boolean> 3.12 APNG_DISABLE <boolean> 3.13 APNG_Z_COMPRESSION_LEVEL <integer> 3.14 APNG_Z_MEMORY_LEVEL 3.15 APNG_Z_STRATEGY 3.16 APNG_Z_WINDOW_BITS 3.17 AUTOAIM/AUTOAIM2 <boolean> 3.18 AUTOBALANCE <integer> 3.19 BLAMECFAIL <boolean> 3.20 BOMBSHIELD <integer> 3.21 CAM_DIST/CAM2_DIST <integer> 3.22 CAM_HEIGHT/CAM2_HEIGHT <integer> 3.23 CAM_ROTATE/CAM2_ROTATE <integer> 3.24 CAM_ROTSPEED/CAM2_ROTSPEED <integer> 3.25 CAM_SPEED/CAM2_SPEED <decimal> 3.26 CAM_STILL/CAM2_STILL <boolean> 3.27 CD_UPDATE 3.28 CD_VOLUME 3.29 CHASECAM/CHASECAM2 <boolean> 3.30 CHEATS <boolean> 3.31 COLOR/COLOR2 <color> 3.32 CON_BACKCOLOR <color> 3.33 CON_BACKPIC <translucent/picture> 3.34 CON_HEIGHT <integer> 3.35 CON_HUDLINES <integer> 3.36 CON_HUDTIME <integer> 3.37 CON_SPEED <integer> 3.38 CONSFAILPROTECT <limit> 3.39 CONTROLPERKEY <integer> 3.40 COUNTDOWNTIME <integer> 3.41 CPUAFFINITY 3.42 CPUSLEEP 3.43 CROSSHAIR/CROSSHAIR2 <integer> 3.44 DIGMUSICVOLUME 3.45 DOWNLOADING <boolean> 3.46 EGGMANTV <integer> 3.47 FLAGTIME <integer> 3.48 FORCESHIELD <integer> 3.49 FORCESKIN <boolean> 3.50 FRIENDLYFIRE <boolean> 3.51 FULLSCREEN 3.52 GAMMA <integer> 3.53 GR_FOG 3.54 GR_FOGCOLOR 3.55 GR_FOVCHANGE 3.56 GR_GAMMABLUE 3.57 GR_GAMMAGREEN 3.58 GR_GAMMARED 3.59 GR_TRANSLUCENTHUD 3.60 GRAVITY <decimal> 3.61 GRID 3.62 HIDETIME <integer> 3.63 HOMREMOVAL <boolean> 3.64 INTERNETSERVER <boolean> 3.65 INTTIME <integer> 3.66 INVERTMOUSE/INVERTMOUSE2 3.67 INVINCIBILITY <integer> 3.68 JOINNEXTROUND <boolean> 3.69 JOYAXIS_FIRE/JOYAXIS2_FIRE 3.70 JOYAXIS_FIRENORMAL/JOYAXIS2_FIRENORMAL 3.71 JOYAXIS_LOOK/JOYAXIS2_LOOK 3.72 JOYAXIS_MOVE/JOYAXIS2_MOVE 3.73 JOYAXIS_SIDE/JOYAXIS2_SIDE 3.74 JOYAXIS_TURN/JOYAXIS2_TURN 3.75 JUMPSHIELD <integer> 3.76 KILLINGDEAD <boolean> 3.77 LIMITDRAW 3.78 MAPTHINGNUM 3.79 MASTERSERVER <address:port> 3.80 MATCH_SCORING 3.81 MATCHBOXES <integer or type> 3.82 MATCHTYPE <integer> 3.83 MAXPING <integer> 3.84 MAXPLAYERS <integer> 3.85 MAXSEND <integer> 3.86 MIDIMUSICVOLUME 3.87 MLOOKSENS/MLOOKSENS2 <integer> 3.88 MOUSE2PORT 3.89 MOUSEMOVE/MOUSEMOVE2 <boolean> 3.90 MOUSESENS/MOUSESENS2 <integer> 3.91 MUTE <boolean> 3.92 NAME/NAME2 <name> 3.93 NETSTAT <boolean> 3.94 NETTIMEOUT 3.95 NUMLAPS <integer> 3.96 OBJECTPLACE <boolean> 3.97 OBJFLAGS 3.98 OFFSETSHADOWS 3.99 ONTOP 3.100 OVERTIME <boolean> 3.101 PAUSEPERMISSION <boolean> 3.102 PLAYDEMOSPEED <integer> 3.103 PLAYERSFOREXIT <boolean> 3.104 PNG_Z_COMPRESSION_LEVEL <integer> 3.105 PNG_Z_MEMORY_LEVEL 3.106 PNG_Z_STRATEGY 3.107 PNG_Z_WINDOW_BITS 3.108 POINTLIMIT <integer> 3.109 POWERSTONES <boolean> 3.110 PRECACHESOUND <boolean> 3.111 PRECIPDENSITY 3.112 PRECIPDIST <integer> 3.113 RACE_ITEMBOXES <integer or type> 3.114 RACETYPE <type> 3.115 REALNAMES <boolean> 3.116 RECYCLER <integer> 3.117 RENDERVIEW 3.118 RESETMUSIC <boolean> 3.119 RESPAWNITEM <boolean> 3.120 RESPAWNITEMTIME <integer> 3.121 RINGSHIELD <integer> 3.122 RINGSLINGER <boolean> 3.123 RUNSCRIPTS 3.124 SAMPLERATE 3.125 SCR_DEPTH 3.126 SCR_HEIGHT 3.127 SCR_WIDTH 3.128 SCRAMBLEONCHANGE <integer or type> 3.129 SCREENSHOT_FOLDER <foldername> 3.130 SCREENSHOT_OPTION 3.131 SEENAMES <integer> 3.132 SERVERNAME <name> 3.133 SETCONTINUES <integer> 3.134 SETLIVES <integer> 3.135 SETRINGS <integer> 3.136 SHADOW 3.137 SHOWHUD <boolean> 3.138 SHOWJOINADDRESS <boolean> 3.139 SKIN/SKIN2 <name> 3.140 SKIPMAPCHECK <boolean> 3.141 SNAPTO 3.142 SND_CHANNELS <integer> 3.143 SONICCD <boolean> 3.144 SOUNDTEST 3.145 SOUNDVOLUME <integer> 3.146 SPECIALRINGS 3.147 SPEED 3.148 SPLATS 3.149 STEREOREVERSE <boolean> 3.150 SUDDENDEATH <boolean> 3.151 SUPERRING <integer> 3.152 SUPERSNEAKERS <integer> 3.153 SURROUND <boolean> 3.154 TAGTYPE <integer> 3.155 TAILSPICKUP <boolean> 3.156 TEAMSCRAMBLE 3.157 TELEPORTERS <integer> 3.158 TIMELIMIT <integer> 3.159 TIMETIC <off/on/full> 3.160 TRANSLUCENCY <boolean> 3.161 TOUCHTAG <boolean> 3.162 USE_JOYSTICK/USE_JOYSTICK2 3.163 USE_MOUSE/USE_MOUSE2 3.164 USERANALOG/USERANALOG2 <boolean> 3.165 VID_WAIT <boolean> 3.166 VID_TICRATE <integer> 3.167 VIEWHEIGHT <integer> 3.168 WATERSHIELD <integer>

Syntax

SRB2's console can be hard to figure out for new users, so here is a small guide on how to use it.

Special Characters

Semicolon (;)

This character will separate commands. For example, COLOR PURPLE; SKIN KNUCKLES will set your color to purple, then change your skin to Knuckles.

Quote (")

When a single string parameter contains a space, it must be enclosed in double quotes; hence BIND 1 "SAY HI" will work, but BIND 1 SAY HI will not.

Single string parameters containing certain characters must also be enclosed in double quotes if other characters are to be typed after them.

Here is a list of those characters (characters separated by spaces): { } ( ) ' :

An example of a case where this would be necessary is if one wanted to in the console connect to a server using a specific (non-default) port. Using CONNECT "192.168.1.5:5028" would work, but CONNECT 192.168.1.5:5028 would not work.

Script files

Main article: Script

A script file is a file that can be used to input things into the console without having to type them every time. You can make one by creating a new text file and inputting commands in it. Commands always be written in lowercase (except for button names like KEY93), and they can be separated either by lines or by semicolons.

Example of tunebinds.txt:

bind 1 "tunes 45"
bind 2 "tunes 29"
bind 3 "tunes 93"
bind 4 "tunes 102"

To use a script file, just type EXEC <script filename> in the console. For the above example, typing EXEC TUNEBINDS.TXT would work.

autoexec.cfg

Main article: Script > autoexec.cfg

autoexec.cfg is a special type of script file that will allow you to run a series of commands on startup. It goes in the same directory as where config.cfg exists, but it is not there by default: you have to create it (use Notepad). This can allow for a default name, color, and skin for netgames, as well as other things such as BINDs and ALIASes.

adedserv.cfg

adedserv.cfg is a script file ran when starting a dedicated server. Like autoexec.cfg, it runs commands such as BIND and ALIAS.

Commands

ADDFILE <filename>

Adds a WAD, SOC or other file to the game. The file's name must be given with its extension. For instance: ADDFILE TEST.WAD; ADDFILE JUMP.SOC. After this command is used, the game immediately gets modified. Note that a file with a space in its name can either be added with quotes, like ADDFILE "TEST SPACE.WAD", or be entered using the DOS naming format. Also, if the file is a WAD that only contains music and/or sound effect lumps, adding it will not activate the cheat protection - in fact, these types of WADs can be added in the middle of netgames, even if you aren't the host. (The other players will not be required to download a file that doesn't activate the cheat protection.)

ALIAS <commands>

Creates an alias to execute multiple console commands. For instance, ALIAS SONIC "SKIN SONIC; COLOR BLUE" would make the console command SONIC turn you into a blue Sonic. Useful for scripting, as well as making autoexec.cfg files.

BAN <playername/node> <reason>

Kicks and bans a player from a netgame with the reason displayed as supplied. Once a player is banned, they can no longer join the server unless CLEARBANS is used. (Server or Game Admin only)

BIND <key> <command>

Makes a keystroke perform a console command. For instance, BIND \ SCREENSHOT would take a screenshot every time you press the \ key on the keyboard.

CECHO <message>

Displays <message> in the center of the screen. Backslashes indicate line breaks.

CECHODURATION <seconds>

Changes the duration a CECHO stays on screen, in seconds.

CECHOFLAGS <integer>

Sets optional values for CECHO. Add the values together to combine.

Option	Value	Description
V_NOSCALESTART	65536	Do not scale the text's starting position, i.e., the top-left corner of the text. This will cause it to be placed as if the resolution was the default of 320x200, while still retaining text size for the resolution currently being used, assuming V_NOSCALEPATCH is not being used. This causes the text to be in the top-left in higher resolutions. Generally not reccomended for use because it'll look different for different people.
V_ALLOWLOWERCASE	262144	Allow lowercase letters.
V_NOSCALEPATCH	524288	Do not scale the text's size. This will cause it to be sized as if the resolution was the default of 320x200, while still retaining the text's starting position for the resolution currently being used, assuming V_NOSCALESTART is not being used. This causes the text to be smaller in higher resolutions. Generally not reccomended for use because it'll look different for different people.
V_YELLOWMAP	1048576	Text is colored yellow.
V_SNAPTOTOP	2097152	Text begins at the top of the screen.
V_TRANSLUCENT	4194304	Text is slightly translucent.
V_SNAPTOBOTTOM	8388608	Text ends at the bottom of the screen.
V_WORDWRAP	33554432	Text is word wrapped.
V_8020TRANS	67108864	Text is very translucent.
V_GREENMAP	134217728	Text is colored green.
V_TOPLEFT	268435456	Text begins at the top-left corner.
V_RETURN8	536870912	Makes line breaks have no distance between them vertically.
V_SNAPTOLEFT	1073741824	Each line of text starts at the left edge of the screen.
V_SNAPTORIGHT	2147483648	Each line of text ends at the right edge of the screen.

CHANGECONFIG <filename>

Saves the current config and loads another.

CHANGETEAM/CHANGETEAM2 <red/blue/spectator/playing>

Changes the team you are currently playing for. You can also use this command to become a spectator, clearing your score and turning you into an invisible bystander. Doesn't work in Co-op and Race.

CHARABILITY <1/2> <value>

Changes the character ability of your player. CHARABILITY 1 sets the ability as shown in the table below. CHARABILITY 2 lets you choose between spindash (0) and multi-ability without jumpspin (1). You must have DEVMODE enabled to use this command.

Value	Ability
0	Sonic Speed Thok
1	Tails Fly
2	Knuckles Glide/Climb
3	Double Jump
4	Super Sonic Float
5	Float with Slow Descent (similar to E-102 Gamma's booster powerup in Sonic Adventure)
6	Swim (basically the flying action only allowed underwater)
7	Homing Attack
8 and above	No ability

CHARSPEED <parameter> <value>

Changes one of the character speeds of your player. Possible parameters are normalspeed, runspeed, thrustfactor, accelstart, acceleration and actionspd. Note that this command accepts values that would not normally be possible to set in a Character WAD, even negative values. You must have DEVMODE enabled to use this command.

CLEARBANS

Clears all bans. Users that were banned will be able to join again.

CLEARSCORES

Resets each player's score to 0. This also works in Single Player games.

CLS

Clears the console buffer.

CONNECT <ip>

Connects to the specified IP address. If no IP is specified, it will search on the LAN for a game. Note that to connect on a specific port, one must use this format: CONNECT "<ip>:<port>".

COUNTMOBJS

Counts all of the Objects in a level and lists them in the console.

CSAY <message>

Sends a message to everyone within a netgame in CECHO format. Only the host or server administrators can use this command.

DEVMODE <integer>

Activates development mode. See DEVMODE for deeper info.

DISPLAYPLAYER

Shows the number of the current player being displayed.

ECHO <message>

Echoes whatever you type in the console. Useful for scripting.

ENGLISH

English Keymap.

EXEC <filename>

Executes a script file.

EXITGAME

Exits the current game.

EXITLEVEL

Exits the current level (Server or Game Admin only, unless ALLOWEXITLEVEL is enabled). This cannot be used in Single Player.

GAMETYPE

Shows the current gametype as one of the following numbers:

Number	Game type
0	Single Player / Co-op
1	Match / Team Match
2	Race / Classic Race
3	Tag / Hide & Seek
4	Capture the Flag

GETALLEMERALDS

Awards you with all 7 Chaos Emeralds. You must have DEVMODE enabled to use this command.

GETPLAYERNUM

Lists all of the players in the game, their number in the array, and their node numbers.

GOD

Enables/disables Sissy Mode, which makes the player totally invincible to everything, even bottomless pits and crushers. Activates the cheat protection. Enemies that try to hurt the player will instead go right through the player. Disabled in Multiplayer.

GRAVFLIP

Flips the direction which gravity pulls the player towards. You must have DEVMODE enabled to use this command.

HELP <command>

If used without an argument, will list all commands. If provided with the name of a command, more detailed help for that command will be provided, if available.

HURTME <value>

Hurts the player by a given amount. 10000 is instant kill, while all other values will simply hurt the player. You must have DEVMODE enabled to use this command.

ISGAMEMODIFIED

Checks if the game is modified and if secrets can be unlocked, and returns the result to the console.

JUMPTOAXIS <axis number>

Teleports NiGHTS Super Sonic to the specified Axis. You must have DEVMODE enabled to use this command. Note that improperly using this command can cause SIGSEGVs.

KICK <playername/node> <reason>

Kicks a player out of a netgame. A reason can be typed in after the command. (Server or Game Admin only)

LISTSERV

Retrieves and displays a list of hosted games from the Master Server.

LISTWAD

Displays a list of WADs attached to the game. WADs listed with an * are the game's default WADs.

LOADCONFIG <filename>

Loads a new config without saving.

LOGIN <password>

Attempts to login as a netgame administrator. The password is set by the host.

MAP MAP<value>

Changes the level. For instance, to warp to Greenflower Zone Act 1, type MAP MAP01. To know which map number a level is, get a WAD editor, look in MAINCFG, find the map name, and look at its corresponding level number. If the level number (xx) is 99 or less, the map is MAPxx. If the level is greater than 100, consult the List of Extended Map Numbers.

Alternatively, for official SRB2 maps, consult the list of levels.

The MAP command takes two (or three, if DEVMODE is enabled) optional parameters:

-GAMETYPE <game mode name or number>

Specifies the game mode to use with the new map, e.g., MAP MAP01 -GAMETYPE TAG. Also you can type game mode number instead of game mode name, e.g., MAP MAP01 -GAMETYPE 3.

-FORCE

Forces the game to warp to the map, even if it does not support the current gametype, e.g. MAP MAP01 -FORCE when not in Single Player or Co-op mode. To keep from having to enter -FORCE all the time, use SKIPMAPCHECK.

-NORESETPLAYERS

Makes the game warp to the map without resetting player data like lives, score, etc.; as if the player had advanced to the map normally. You must have DEVMODE enabled to use this parameter.

MOD_DETAILS

Lists the ID, version and codebase of the executable currently used.

MEMFREE

Displays memory usage statistics.

MOTD <message>

Sets a 'Message of the day' that is displayed in a player's chat text when they join your server. Backslashes (\) indicate line breaks. Note that due to a current glitch, sometimes trying to change the message after setting one will instead cause the new messages to pile up at the end of the previous ones. (Server or Game Admin only)

NOCLIP

Increases gravity and turns off clipping. This allows the player to go through the thok barrier as well as immediately move on top of raised ground no matter how high the sector is. Also, Things cannot be touched. Activates the cheat protection. This is disabled in Multiplayer.

NODES

Lists all of the players in the game and their player numbers.

NUMTHINKERS <number>

Counts the number of thinkers, based off of the value inputted. Useful for development and code testing.

ORDERPIZZA

A command that simply prints a line of text to the console saying "<name> has ordered a delicious pizza." However, it will not work unless you give it an address, a topping, and a size. Usage:
ORDERPIZZA -SIZE <anything you want> -ADDRESS <anything you want> -TOPPING <anything you want>

Note: Keying ORDERPIZZA 1 2 3 4 5 or ORDERPIZZA 1 2 3 4 5 6 in the console will have the same effect because none of the parameters mean anything. Only the number of parameters is checked.

PASSWORD <value>

Changes the server password to the given value. Host or Server only.

PAUSE

Pauses the game. Reuse it to unpause. (It also works if you press the Pause/Break button on your keyboard)

PING <player/node>

Sends a command that tells you the ping of a player in milliseconds, which tells you how long the connection needs to respond. If used without a player name, it lists the ping for all players.

PLAYDEMO <filename>

Plays back a recorded demo.

PLAYINTRO

Plays the opening intro. Due to a bug with this command, the music that was playing when you use this command will momentarily keep playing.

QUIT

Exits the game immediately, skipping all menus and displays.

RELOADBANS

Reloads an existing ban.txt and bans all of the included IP addresses.

RESETCAMERA

Resets the camera, just as if you had pressed the "reset camera" key.

RESETEMERALDS

Sets your emerald count to 0. You must have DEVMODE enabled to use this command.

RTELEPORT -x <X distance> -y <Y distance> -z <Z distance>

Teleports you relative to your current location. You must have DEVMODE enabled to use this command.

RUNSOC <socfile.soc or lumpname>

Runs a SOC file.

SAVECHECKPOINT

Creates a temporary and invisible starpost on your current location. You must have DEVMODE enabled to use this command.

SAVECONFIG <filename>

Saves the current configuration.

SAY <message>

Sends a message to everyone.

SAYTEAM <message>

Sends a message to your team. Only works if the gametype is Team Match, Tag, Hide & Seek, or CTF.

SAYTO <playername/node> <message>

Sends a message to a specific player. If the player has parentheses in his/her name, the player name must be enclosed in quotes.

SCALE <percent>

Scales the player to a percentage of their original size. You must have DEVMODE enabled to use this command.

SERVERCHANGETEAM <playername> <red/blue/spectator/playing/it/notit>

Changes the current team any player is on. Can also be used to force a player to spectate, or to bring them into the game from spectating. In Tag/Hide & Seek, you can use this to make players IT or not IT (at least one person must be IT), but you can no longer do so once the HIDETIME has run out. (Server or Game Admin Only)

SCREENSHOT

Takes a screenshot of the display. Note that if you don't bind this to a key, it will show the console in the screenshot. Alternatively, press the F8 key.

SETCONTROL/SETCONTROL2

Manually changes the controls of 1P and 2P. See config.cfg for an example.

SHOWBANLIST

Lists all bans made in-game and in the ban.txt inside the SRB2 folder along with the ban reasons.

SHOWMAP

Shows what map you're currently on.

SHOWSCORES

Shows the game scores of everyone.

SHOWTIME

Shows the time (and, if applicable, the timelimit) of a game.

SKYNUM <number>

Changes the sky. You must have DEVMODE enabled to use this command. Also displays the current sky if no slot value is given. Refer to the List of Skies for a complete list of skies with samples.

SOUNDTEST <number>

Plays a sound based on what number you entered. Refer to the List of Sounds for a complete list of sounds and their numbers.

STARTMOVIE

Creates a movie file, which will output as an animated PNG.

STOPDEMO

Stops the currently running demo.

STOPMOVIE

Tells the game to stop the function of STARTMOVIE.

TELEPORT -x <X location> -y <Y location> -z <Z location>

Teleports you directly to the coordinates you specified. You must have DEVMODE enabled to use this command.

TIMEDEMO

Plays back a demo at the highest possible speed. Useful for benchmarking.

TOGGLE <variable>

Allows you to toggle certain console variables on and off. In most cases, this works only for on/off and yes/no variables. TOGGLE COLOR allows you to cycle through colors. TOGGLE SKIN currently doesn't work.

TUNES <slot> <speed>

Changes the song that's playing and its speed (optional). Speed is given by positive and real number (i.e.: 0.5, 0.22, 1.3). Also displays the current tune if no slot value is given. Refer to MusicSlots for a list of available tunes.

VERIFY <playername/node>

Gives a player administrative privileges in a netgame. Only one person may be verified at a time.

VERSION

Tells you the version of SRB2 you are using.

VID_MODE <mode number>

Sets your resolution. To see what number equals what resolution, use VID_MODELIST.

VID_MODEINFO <mode number>

Gives out information about the specified mode. If used without a mode number, gives out information about the current resolution.

VID_MODELIST

Lists all available resolutions and their corresponding mode numbers.

VID_NUMMODES

Shows the number of available resolutions.

WAIT <tics>

Waits a certain number of game tics before executing the next command. Useful for scripting.

WRITETHINGS

Use this after activating OBJECTPLACE mode to place new Things. This will save the Things to NEWTHINGS.lmp in your SRB2 folder. Then, using XWE or a similar lump editor, you may rename NEWTHINGS.lmp to THINGS.lmp, and replace the existing THINGS lump for the level whose Things you have modified. Remember, you can't modify zones.dta, so to create new things for an official level, you'll have to copy the map and its nodes to a new WAD, then replace the THINGS lump.

Variables

Variables are unlike commands in that instead of directly performing an action, you change a variable, which in turn would make a difference in the game. The command starts the line, then a value follows to set it. A value can either be boolean, an integer, a decimal number, or something completely different, depending on what the command calls for. Note that some of these commands have equivalents in the game's "Options" menu.

A boolean variable is one which can either be on or off. For instance, CHASECAM ON turns on the camera, and CHASECAM OFF turns it off. You can also use 1 instead of ON, and 0 instead of OFF. Some boolean variables still use YES and NO, so try that if it doesn't work.

An integer is a number with nothing after the decimal point.

A decimal number is a number that may or may not have something after the decimal point.

Console variables marked like this CONSVAR/CONSVAR2 are used for split-screen, e.g., CAM_DIST/CAM2_DIST. CAM_DIST is for the camera distance of player 1. CAM2_DIST is for the camera distance of player 2.

1UP <integer>

Sets the availability of Extra Life Monitors in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

ADVANCEMAP <integer>

Sets whether or not to advance to the next map in the cycle when a round finishes in any mode except Co-op or Single Player. 0 = Off (repeats the same map), 1 = Next Map in Cycle, 2 = Random Map. Can also be set under Network Options. (Server or Game Admin only)

ALLCAPS <boolean>

Makes all letters in the console uppercase.

ALLOWAUTOAIM <boolean>

Allows players to enable AUTOAIM. (Server or Game Admin only)

ALLOWEXITLEVEL <boolean>

Allows players to exit the level via Exit Sectors in gametypes other than Co-op. (Server or Game Admin only)

ALLOWJOIN <boolean>

Allows other players to join a netgame. Can only be used by the host or server (not game admins).

ALLOWMLOOK <boolean>

Allow players to mouselook in a netgame. (Server or Game Admin only)

ALLOWSEENAMES <boolean>

Allows players to enable SEENAMES. (Server or Game Admin only)

ALLOWTEAMCHANGE <boolean>

Allows players to change teams in Team Match and Capture the Flag. If off, spectators (in any mode) will also not be able to enter the game, nor can any active players spectate. (Server or Game Admin only)

ALWAYSMLOOK/ALWAYSMLOOK2 <boolean>

If enabled, forces mouselook to be enabled without pressing the associated key.

ANALOG/ANALOG2 <boolean>

Allows you to turn Analog Control on or off. Disabled in netgames. USERANALOG/USERANALOG2 should be used instead, as this variable is modified by the game on certain occasions.

APNG_DISABLE <boolean>

If enabled, doesn't allow the game to record animated PNG files with the STARTMOVIE command.

APNG_Z_COMPRESSION_LEVEL <integer>

Sets the compression level for animated PNGs, ranging from 0 to 9. 0 is off, 1 is best speed, 9 is best compression, and 6 is default.

APNG_Z_MEMORY_LEVEL

APNG_Z_STRATEGY

APNG_Z_WINDOW_BITS

AUTOAIM/AUTOAIM2 <boolean>

Enables automatic aiming, which is useful for Match in third-person camera. Note that this can cause issues when used with first-person camera.

AUTOBALANCE <integer>

Automatically balances teams in CTF mode. The value (between 1 and 4) defines how great the difference in team members may be before the teams are autobalanced. Setting it to 0 turns it off. (Server only, no Game Admins)

BLAMECFAIL <boolean>

Enabling this allows the host to see who is causing consistency failures in a netgame. Can only be used by the host or server (not game admins).

BOMBSHIELD <integer>

Sets the availability of Armageddon Shields in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

CAM_DIST/CAM2_DIST <integer>

Changes the distance of the camera. You cannot use a negative value to zoom in. Default is 128 for normal mode, 192 for analog control, and 320 when playing as NiGHTS Super Sonic.

CAM_HEIGHT/CAM2_HEIGHT <integer>

Changes the height of the camera. Default is 20.

CAM_ROTATE/CAM2_ROTATE <integer>

Changes the angle of the camera's rotation.

CAM_ROTSPEED/CAM2_ROTSPEED <integer>

Changes the rotation speed of the camera (Analog Control only). Default is 10.

CAM_SPEED/CAM2_SPEED <decimal>

Changes the speed of the camera. Default is 0.25.

CAM_STILL/CAM2_STILL <boolean>

Forces the camera angle to freeze in place instead of following the player.

CD_UPDATE

CD_VOLUME

CHASECAM/CHASECAM2 <boolean>

Turns the camera on and off. If off, the first-person view is used.

CHEATS <boolean>

Enables/Disables cheats in a multiplayer game.

COLOR/COLOR2 <color>

Changes your player's color. Only works in multiplayer, while standing still. The possible values are as follows:

Number	Color
1	Cyan
2	Peach
3	Lavender
4	Silver
5	Orange
6	Red
7	Blue
8	Steel Blue
9	Pink
10	Beige
11	Purple
12	Green
13	White
14	Gold
15	Yellow

CON_BACKCOLOR <color>

Changes the color of the console. Colors include red, orange, blue, gray, green, and white.

CON_BACKPIC <translucent/picture>

Sets whether to use console background picture (CONSBACK), or translucent mode.

CON_HEIGHT <integer>

Changes the height of the console. The value used is a percentage of the screen.

CON_HUDLINES <integer>

Sets the number of lines the console displays.

CON_HUDTIME <integer>

Sets the display time in the console.

CON_SPEED <integer>

Changes the rate that the console moves at when being opened or closed.

CONSFAILPROTECT <limit>

Restores players' positions on the consfailer's end instead of kicking them. 0 (zero) disables consistency failure protection and the game will immediately kick any player who is inconsistent. Any other value enables consfail protection; however, due to a coding oversight, the value has no effect whatsoever. Can only be used by the host or server (not game admins).

Warning: If CONSFAILPROTECT is not turned back up from 0 after using it, there's a high possibility that anyone who attempts to join your server will be kicked immediately from inconsistency. Remember to use BLAMECFAIL to find who is causing consistency failure.

CONTROLPERKEY <integer>

Sets how many controls may be assigned to a key. 1 is one, 2 is several.

COUNTDOWNTIME <integer>

Sets the countdown time (in seconds) in a Race game after the leader finishes the race. When the countdown is up, anyone yet to finish is destroyed instantly. Minimum is 15, max is 9999. Can also be set under Gametype Options. (Server or Game Admin only)

CPUAFFINITY

CPUSLEEP

CROSSHAIR/CROSSHAIR2 <integer>

Sets the type of crosshair used in first-person view. 0 is off, 1 is cross, 2 is angle, and 3 is point.

DIGMUSICVOLUME

DOWNLOADING <boolean>

Allows/disallows WAD downloading in a netgame.

EGGMANTV <integer>

Sets the availability of Eggman Monitors in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

FLAGTIME <integer>

Sets how long a CTF flag will stay in place once thrown or dropped. Can also be set under Gametype Options. (Server or Game Admin only)

FORCESHIELD <integer>

Sets the availability of Force Shields in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

FORCESKIN <boolean>

Forces all players in the game to use the character that the server is using. Can also be set under Network Options. (Server or Game Admin only)

FRIENDLYFIRE <boolean>

Enables or disables friendly fire among teammates. (Server or Game Admin only)

FULLSCREEN

GAMMA <integer>

Changes the gamma level.

GR_FOG

GR_FOGCOLOR

GR_FOVCHANGE

GR_GAMMABLUE

GR_GAMMAGREEN

GR_GAMMARED

GR_TRANSLUCENTHUD

GRAVITY <decimal>

Changes the gravity. (Single Player/Server or Game Admin only)

GRID

HIDETIME <integer>

Sets the number of seconds the non-IT players in Tag and Hide & Seek have to flee before the IT player can move. The value cannot exceed the time limit of the game, and if the time limit is disabled then HIDETIME can't be adjusted. Can also be set under Gametype Options. (Server or Game Admin only)

HOMREMOVAL <boolean>

When activated, all missing flats and textures are replaced with a black wall. This prevents the Hall of Mirrors glitch from happening, but causes the framerate to drop considerably. As of 2.0.6, it defaults to off due to framerate problems in 2.0.5.

INTERNETSERVER <boolean>

Enables or disables advertising of the game on the Master Server. Can also be set under Server Options.

INTTIME <integer>

Changes the intermission time (in seconds) between multiplayer levels. (Server or Game Admin only)

INVERTMOUSE/INVERTMOUSE2

INVINCIBILITY <integer>

Sets the availability of Invincibility in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

JOINNEXTROUND <boolean>

Enabling this will force players to wait until the next round is started to join a netgame.

JOYAXIS_FIRE/JOYAXIS2_FIRE

JOYAXIS_FIRENORMAL/JOYAXIS2_FIRENORMAL

JOYAXIS_LOOK/JOYAXIS2_LOOK

JOYAXIS_MOVE/JOYAXIS2_MOVE

JOYAXIS_SIDE/JOYAXIS2_SIDE

JOYAXIS_TURN/JOYAXIS2_TURN

JUMPSHIELD <integer>

Sets the availability of Whirlwind Shields in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

KILLINGDEAD <boolean>

If enabled, hitting an enemy or popping a monitor causes damage to yourself 75% of the time. This simulates a glitch from the original Sonic Robo Blast. (Single Player/Server or Game Admin only)

LIMITDRAW

MAPTHINGNUM

MASTERSERVER <address:port>

Defines which Master Server SRB2 will connect to. Can also be set under Server Options.

MATCH_SCORING

MATCHBOXES <integer or type>

Sets the type of item boxes used in Match, Tag, Hide & Seek, or CTF games. 0 = Normal, 1 = Random, 2 = Non-Random, 3 = None. If you change this setting, it won't take effect until the next round/map change. Can also be set under Network Options. (Server or Game Admin only)

MATCHTYPE <integer>

Enables (1) or disables (0) teams in Match mode. Switching from normal to team match (but not vice-versa) with this command will instantly force everyone into spectating and wipe the scores, so use this in mid-match at your peril. (Server or Game Admin only)

MAXPING <integer>

Automatically kicks players with a ping higher than the given value. (Server or Game Admin only)

MAXPLAYERS <integer>

Sets the maximum number of players allowed to join a netgame. Can only be set by the host or server (not game admins).

MAXSEND <integer>

Sets the maximum filesize (in KB) a loaded WAD or file can be for a player to download it. Players downloading large WADs from the server will cause visible and sometimes disrupting lag in the netgame. Default is 1024 KB (1 MB).

MIDIMUSICVOLUME

MLOOKSENS/MLOOKSENS2 <integer>

Alters the sensitivity of mouse movement to look up and down.

MOUSE2PORT

MOUSEMOVE/MOUSEMOVE2 <boolean>

Allows the movement of mouse to move the character.

MOUSESENS/MOUSESENS2 <integer>

Alters the sensitivity of mouse movement to turn left and right.

MUTE <boolean>

Allows/disallows chat in a netgame. The host/server and game admin can still talk. Server or Game Admin only.

NAME/NAME2 <name>

Changes your nickname for multiplayer. It may not start with a numeral. For names with spaces, put the name between quotes.

NETSTAT <boolean>

Shows network statistics. Can be used in Single-Player. GAMEMISS estimates the amount of lag a map has. With one person, it only estimates framerate lag for that specific computer.

NETTIMEOUT

NUMLAPS <integer>

Sets the number of laps on a Circuit mode track. Maximum is 50. Can also be set under Gametype Options. (Server or Game Admin only)

OBJECTPLACE <boolean>

Turns object placement mode on or off. It is recommended that it is not enabled and disabled often in one session of SRB2. Adding too many objects in a map will cause SRB2 to crash. Disabled in multiplayer.

OBJFLAGS

OFFSETSHADOWS

ONTOP

OVERTIME <boolean>

If enabled, a time-limited round of Match or CTF doesn't end as long as two or more players/teams lead with the same score. Defaults to on. (Server or Game Admin only)

PAUSEPERMISSION <boolean>

If set to 1, all clients can pause a netgame; otherwise, only the server can pause the game. (Server or Game Admin only)

PLAYDEMOSPEED <integer>

Changes the speed at which a demo is played back.

PLAYERSFOREXIT <boolean>

Defines if a level, to be finished, will need at least one player or all players have reached the End Level Sign (0= one player; 1= all players). Can also be set under Gametype Options. (Server or Game Admin only)

PNG_Z_COMPRESSION_LEVEL <integer>

Sets the compression level for screenshots, ranging from 0 to 9. 0 is off, 1 is best speed, 9 is best compression, and 6 is default.

PNG_Z_MEMORY_LEVEL

PNG_Z_STRATEGY

PNG_Z_WINDOW_BITS

POINTLIMIT <integer>

Sets a score limit for multiplayer levels. The command POINTLIMIT -1 disables the score limit if enabled. (Server or Game Admin only)

POWERSTONES <boolean>

In multiplayer, turns the distribution of Chaos Emeralds on or off. If you change this setting, it won't take effect until the next round/map change. Can also be set under Network Options. (Server or Game Admin only)

PRECACHESOUND <boolean>

Tells the game to precache sound or not before playing.

PRECIPDENSITY

PRECIPDIST <integer>

Sets from how far away precipitation is visible. Try decreasing it if you're getting lots of lag in levels with precipitation. Can also be set under Video Options (albeit very slowly).

RACE_ITEMBOXES <integer or type>

Sets the type of item boxes used in a Race game. 0 = Normal, 1 = Random, 2 = Teleports (for a truly insane game), 3 = None. If you change this setting, it won't take effect until the next round/map change. Can also be set under Gametype Options. (Server or Game Admin only)

RACETYPE <type>

Sets the type of Race mode in a netgame. FULL designates a full (Classic) Race, whereas TIME_ONLY designates a time-only Race. (Server or Game Admin only)

REALNAMES <boolean>

Shows the real names of Sonic Team Junior's staff in the credits, instead of their online aliases.

RECYCLER <integer>

Sets the availability of Recyclers in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

RENDERVIEW

RESETMUSIC <boolean>

Resets the in-game music. When enabled, in Single Player the music will start over after you die, like in most Sonic games. The game remembers what you set this to.

RESPAWNITEM <boolean>

Enables or disables items to respawn. (Server or Game Admin only)

RESPAWNITEMTIME <integer>

Sets how long, in seconds, it takes for an item to respawn. Default is 30. If set to 0, the item will respawn on the next tic. (Server or Game Admin only)

RINGSHIELD <integer>

Sets the availability of Attraction Shields in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

RINGSLINGER <boolean>

Allows the player to throw rings at a enemy. (DEVMODE/Server or Game Admin only)

RUNSCRIPTS

SAMPLERATE

SCR_DEPTH

SCR_HEIGHT

SCR_WIDTH

SCRAMBLEONCHANGE <integer or type>

If enabled, teams in a CTF game will be scrambled automatically each time the game advances to another map (not if you switch maps manually). There are three scramble settings: 0 = Off, 1 = Random, 2 = Points. Can also be set under Gametype Options. (Server or Game Admin only)

SCREENSHOT_FOLDER <foldername>

Defines in which subfolder screenshots are saved, for example ".\screenshot".

SCREENSHOT_OPTION

SEENAMES <integer>

Controls how the names of other players are displayed when targeting them. If set to 0, names are not displayed. If set to 1, all names are displayed in white. If set to 2, the names are displayed in the color of the team the player is in (or as white in non-team gametypes). If set to 3 (which is default), allies are displayed in green and enemies in red.

SERVERNAME <name>

Changes the default name of a server to be hosted.

SETCONTINUES <integer>

Sets how many continues you want. Cheats must be enabled in order to use it. (DEVMODE/Server or Game Admin only)

SETLIVES <integer>

Sets how many lives you want. Cheats must be enabled in order to use it. (DEVMODE/Server or Game Admin only)

SETRINGS <integer>

Sets how many rings you want. Cheats must be enabled in order to use it. (DEVMODE/Server or Game Admin only)

SHADOW

SHOWHUD <boolean>

Using showhud 1 will make the whole hud appear, while using showhud 0 will make the whole hud disappear.

SHOWJOINADDRESS <boolean>

Enabling this will display the IP of joining players to the host. (Server or Game Admin only)

SKIN/SKIN2 <name>

Changes your player's character. Only works in multiplayer, while standing still.

SKIPMAPCHECK <boolean>

If enabled, the game will not check to see if a map supports the current gametype before warping to it.

SNAPTO

SND_CHANNELS <integer>

Sets the number of sound channels.

SONICCD <boolean>

Creates GFZ flowers where enemies have been destroyed, Sonic CD style. (Single Player/Server or Game Admin only)

SOUNDTEST

SOUNDVOLUME <integer>

Changes the sound volume.

SPECIALRINGS

SPEED

SPLATS

STEREOREVERSE <boolean>

Toggles reverse stereo mode.

SUDDENDEATH <boolean>

Toggles Sudden Death on or off. When activated, players will die instantly when shot by a ring weapon. Can also be set under Network Options. (Server or Game Admin only)

SUPERRING <integer>

Sets the availability of Super Rings in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

SUPERSNEAKERS <integer>

Sets the availability of Super Sneakers in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

SURROUND <boolean>

Toggles DirectSound3D acceleration.

TAGTYPE <integer>

Sets the type of Tag mode. 0 is Tag, 1 is Hide and Seek. Beware: If this is used in mid-game to switch from H&S to Tag, the hiders will still not be able to move. (Server or Game Admin only)

TAILSPICKUP <boolean>

Allows flying characters to pick up another character. If it is off, players become solid and can stand on top of one another to form a ladder. (Server or Game Admin only)

TEAMSCRAMBLE

TELEPORTERS <integer>

Sets the availability of Teleporters in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)

TIMELIMIT <integer>

Sets a time limit, in minutes, for multiplayer levels. The command TIMELIMIT 0 will disable the time limit. (Server or Game Admin only)

TIMETIC <off/on/full>

Makes the in-game timer count the number of tics (frames) instead of the number of seconds. Alternatively, if set to Full (2), it shows the centiseconds along with the regular timer.

TRANSLUCENCY <boolean>

Turns sprite translucency on or off.

TOUCHTAG <boolean>

If enabled, the IT player(s) in Tag and Hide & Seek can tag the fleeing players simply by touching them. (Server or Game Admin only)

USE_JOYSTICK/USE_JOYSTICK2

USE_MOUSE/USE_MOUSE2

USERANALOG/USERANALOG2 <boolean>

Turns analog control on/off. Disabled in netgames. This variable should be used instead of ANALOG/ANALOG2.

VID_WAIT <boolean>

Enables/Disables V-Sync.

VID_TICRATE <integer>

Shows game speed (frame rate) stats. 1 is in counter form, 2 is in graph form, and 3 is both.

VIEWHEIGHT <integer>

Changes the vertical offset of viewing. Ranges from 15 to 56.

WATERSHIELD <integer>

Sets the availability of Elemental Shields in a game. 0 is off, 1 is low, 2 is medium (default) and 3 is high. Cheats must be enabled in order to change this. (Server or Game Admin only)