This article or section is outdated and has not been updated to reflect the release of SRB2 v2.2. Please help the Wiki by correcting or removing any misinformation, as well as adding any new information to the page. |
setcontrol
, a special command used to configure the player's controls, which are saved in config.cfg
.alias <name> <command>
. Optional parameters are enclosed in square brackets, e.g., bind [<key>] [<command>]
.setcontrol/setcontrol2
, where setcontrol
is for player 1 and setcontrol2
is for player 2.alias sonic 'skin sonic; color blue'
would create a new console command sonic
that turns the player into a blue Sonic. This command is especially useful in scripts to create a shorthand for a sequence of commands that is used multiple times.autoexec.cfg
file.bind screenshot
would cause a screenshot to be taken every time the key is pressed. If no command is given, any existing bind for the key is removed, e.g., if bind screenshot
was executed previously, bind
would remove the screenshot bind for the key. If no key or command is given, bind
will instead display all existing binds set in the current SRB2 session.autoexec.cfg
file.Flag name | Meaning |
---|---|
AUTOSAVE | Saves to config.cfg when changed |
FLOAT | Takes floating-point values (i.e. non-whole numbers) |
NETVAR | Synchronized for everyone in netgames |
ACTION | Calls a function when changed |
CHEAT | Variable is a cheat, and can be reset to its default value by using cheats off |
addfile 'test space.wad'
).addfile test.wad
instead of addfile test
. After adding a file, the game will immediately be marked as modified, unless it is a WAD that contains only music and sound effects..cfg
– if the file extension is not specified or is not the correct one, the game will automatically modify the file name given to end with .cfg
anyway.-noerror
suppresses the error message if the script cannot be executed, while -silent
suppresses the return message if the script is successfully executed. Both parameters cannot be used at the same time..cfg
– if the file extension is not specified or is not the correct one, the game will automatically modify the file name given to end with .cfg
anyway..soc
, which must be specified) or a lump in one of the currently loaded WAD or PK3 files.-silent
suppresses the return message if the configuration is successfully saved. The file name is required to end with .cfg
– if the file extension is not specified or is not the correct one, the game will automatically modify the file name to end with .cfg
anyway.Number | Game type |
---|---|
0 | Single Player/Co-op |
1 | Competition |
2 | Race |
3 | Match |
4 | Team Match |
5 | Tag |
6 | Hide and Seek |
7 | Capture the Flag |
map map01
. For the map numbers of official SRB2 maps, consult the list of levels. If you want to know the map number of a custom map, open the file containing the map in a lump editor and look for the SOC lump containing the level header (which is often the MAINCFG
lump). In that lump, search for the map name and look at its corresponding map number. If it consists of two digits xx, type map mapxx
to switch to the map. If it consists of more than two digits, it is an extended map number; consult the list of extended map numbers to convert it to a two-digit number. map
command takes two (or three, if devmode
is enabled) optional parameters:map map01 -gametype Tag
. Alternatively, you can specify the gametype's number instead of its name, e.g., map map01 -gametype 3
. See below for the numbers and names associated with each gametype:Number | Gametype |
---|---|
0 | 'Co-op' |
1 | 'Competition' |
2 | 'Race' |
3 | 'Match' |
4 | 'Team Match' |
5 | 'Tag' |
6 | 'Hide and Seek' |
7 | 'CTF' |
map map01 -force
when not in Single Player, Co-op, Competition or Race mode. To always force the map warp without having to explicitly enter -force
every time, use skipmapcheck
.devmode
enabledpausepermission all
is setconfig.cfg
for examples of how this command is used, and Controls > Configurable controls for the full list of control names.devmode
should be set before using them.devmode
enabledcharability 1
changes the player's primary ability, and charability 2
changes the player's secondary ability. See the tables below for the ability options for both:
|
|
devmode
enablednormalspeed
, runspeed
, thrustfactor
, accelstart
, acceleration
and actionspd
. Note that this command accepts values that would not normally be possible to set in a character's S_SKIN
, including negative values.devmode
enabled, or server or admin in multiplayerdevmode
enabled or Pandora's Box unlockeddevmode
enableddevmode
enableddevmode
enabled-silent
suppresses the on-screen text explaining the controls.devmode
enabled or Pandora's Box unlockeddevmode
enableddevmode
enableddevmode
enableddevmode
enabled or Pandora's Box unlockeddevmode
enabled or Pandora's Box unlockeddevmode
enabled or Pandora's Box unlockeddevmode
enableddevmode
enableddevmode
enabledobjectplace
enabledNEWTHINGS.lmp
. Replace the THINGS
lump for the current map with this file to permanently save the additions you made in Object placement mode. Note that zones.dta
may not be modified, so to add Things to an official map, you have to make a copy of the map in question.devmode
enabledclearbans
is used. Banned players are listed in the file ban.txt
. The maximum amount of bans is 100. If the command is used when ban list is full, the player will only be kicked without the ban being registered.clearbans
is used. Banned IP addresses are listed in the file ban.txt
. The maximum amount of bans is 100.;
) are not allowed in the message, and will be removed if found. Due to a glitch, sometimes trying to change the message after it was already set will instead cause the new message to be appended to the end of the previous one.ban.txt
and bans all of the included IP addresses.hidetime
has run out.Team (integer) | Team (string) |
---|---|
Tag/Hide & Seek | |
0 | 'spectator' |
1 | 'it' |
2 | 'notit' |
3 | 'playing' |
CTF/Team Match | |
0 | 'spectator' |
1 | 'red' |
2 | 'blue' |
Other gametypes with spectators | |
0 | 'spectator' |
1 | 'playing' |
ban.txt
along with the ban reasons.Team (integer) | Team (string) |
---|---|
CTF/Team Match | |
0 | 'spectator' |
1 | 'red' |
2 | 'blue' |
Other gametypes with spectators | |
0 | 'spectator' |
1 | 'playing' |
Usage | Effect |
---|---|
connect <ip>[:<port>] | Connects to the specified IP address. Optionally, the port to use can be specified as well, in the format connect <ip>:<port> . If no port is specified, the standard port is used, which is 5029. |
connect <ip> <port> | Same as using connect <ip>:<port> as above, for connecting to a specific port. |
connect self | Connects to the local user's own server. Note: Due to a bug, this causes the game to freeze. |
connect any | Searches for a server via LAN and connects to the first server found. |
connect node <servernum> | Used internally by the 'Join Game (Search)' menu, to pick the specified server from a list of servers displayed for a room. |
cheats off
, server or admins onlycheats off
will revert all cheat-marked variables to their default values.vid_modelist
.srb2.srb
). All other resource files are listed with an asterisk (*
) preceding the file number.Value | Thinker name | Description |
---|---|---|
1 | P_MobjThinker | Thinker for regular Objects |
2 | P_NullPrecipThinker | Thinker for precipitation |
3 | T_Friction | Thinker for friction |
4 | T_Pusher | Thinker for pusher specials (i.e. wind/current) |
5 | P_RemoveThinkerDelayed | Thinker for thinkers in the process of being removed |
cecho
message stays on screen, in seconds.cecho
. Hexadecimal numbers are also accepted as values, provided the input is prefixed with 0x
. See Video flags for the full list of flags and their values.moviemode_mode
.startmovie
.-csv
is specified, it will write a row to 'timedemo.csv', beginning with <trialid>
to identify the row. Specifying -quit
will immediately quit the program after timedemo, which is useful for tool automation.mapb0m
) or a slot number (e.g. b0
). Both integers and extended map numbers are accepted as slot numbers. If the music format supports multiple tracks, you can supply the track number as well. For music tracks in a format supported by the Game Music Emu library, you can optionally supply the playback speed as a positive decimal number (i.e.: 0.5, 0.22, 1.3); 1.0 is the default speed. Note that changing the playback speed also affects the pitch of the music.-show
will display the currently playing tune and track on the console. -default
will reset the music to the default music for the map. -none
will stop the music playback.