Character | Picture | Extreme Gear type | Special ability | Spindash | Speed | Acceleration | Thrustfactor | Accelstart |
---|---|---|---|---|---|---|---|---|
Sonic | Speed | Double thok jump | Yes | 36 (Fast) | 40 (Low) | 5 (High) | 96 (Low) | |
Tails | Flight | Fly/Swim | Yes | 32 (Slow) | 50 (High) | 3 (Low) | 192 (High) | |
Knuckles | Power | Glide/Climb | Yes | 34 (Medium) | 45 (Medium) | 4 (Medium) | 128 (Medium) | |
Amy | Speed | Double jump | Yes | 36 (Fast) | 40 (Low) | 5 (High) | 64 (Very low) | |
Cream | Flight | Fly/Swim | Yes | 32 (Slow) | 50 (High) | 3 (Low) | 192 (High) | |
Jet | Speed | Double jump | No | 36 (Fast) | 40 (Low) | 5 (High) | 64 (Very low) | |
Wave | Flight | Double jump | No | 32 (Slow) | 50 (High) | 3 (Low) | 192 (High) | |
Shadow | Speed | Double thok jump | Yes | 36 (Fast) | 40 (Low) | 5 (High) | 64 (Very low) | |
Rouge | Flight | Fly/Swim | Yes | 36 (Fast) | 40 (Low) | 5 (High) | 64 (Very low) | |
Eggman | Power | Fly | Air spindash | 34 (Medium) | 45 (Medium) | 4 (Medium) | 128 (Medium) | |
Blaze | Speed | Slow fall | Yes | 36 (Fast) | 40 (Low) | 5 (High) | 64 (Very low) | |
Silver | Flight | Float | No | 32 (Slow) | 50 (High) | 3 (Low) | 192 (High) |
SkyMount
). The Thing can be placed anywhere in the map, since only the Angle value is relevant. The Angle sets how long each sky picture is displayed in tics before it changes to the next sky. 35 tics equal one second. Animated skies usually have a duration of around 3 tics to appear natural. Setting it to 0 or anything past 359 currently crashes the game.MAPxxR
, xx being the two-digit form of the map number; for slots above 99, extended map numbers must be used. This was added so custom maps that override the Sonic Riders levels won't show the wrong map guide.SkyNum
sets the first sky as usual, while all following skies should come directly afterwards. For example, SkyMount = 12
used with SkyNum = 91
means that the last sky in the animation will be SKY102
, whose sky number is 11 greater than that of the first sky.TypeOfLevel
value. Both Riders and Mario Kart can be combined with other values.Value | Mode |
---|---|
16384 | Riders |
32768 | Mario Kart |
A_CustomPower
in SOC or linedef type 434 in a map. The majority of these are intended only for specific uses internally, but some are useful for custom maps.Value | Name | Description |
---|---|---|
30 | pw_boost | Gives the player a speed boost in Riders mode. Value must be above 70. |
31 | pw_brake | When set to 1, the player is forced to stop in Riders mode. |
32 | pw_exrun | Controls whether the player uses their Extreme Gear board. When set to 0, the player will always walk and not use their Extreme Gear board until the finish line is touched. When set to 1, they will always use their Extreme Gear board. When set to 2, the player will walk until they gain enough air to ride the Extreme Gear board. |
33 | pw_exspeed | Sets the speed of the Extreme Gear board. Cannot be higher than the normalspeed of the player's character. |
34 | pw_airtank | Sets the amount of air in the air tank. The air tank's capacity is 23 on level 1, 46 on level 2 and 71 on level 3. |
35 | pw_airstartpoint | Sets how quickly the air tank uses air. In a normal game, this starts out with 1 at the beginning of the race and continually rises until it reaches the maximum value of 11. -1 has the same effect as 11. |
36 | pw_bustable | This is used to tell the game that the player is breaking a bustable block. Automatically goes back to 0 once the block is busted. |
37 | pw_ramp | This is used to tell the player if a ramp is mandatory or optional. Should not be modified. |
38 | pw_rampspeed | This sets a ramp's speed for players who charged their jump long enough and pressed Up to use a shortcut. |
39 | pw_rampheight | This sets a ramp's height for players who charged their jump long enough and pressed Up to use a shortcut. |
40 | pw_rampspeed2 | This sets a ramp's speed for those that did not reach the shortcut. |
41 | pw_rampheight2 | This sets a ramp's height for those that did not reach the shortcut. |
42 | pw_rampangle | This sets a ramp's angle. It is only used when the player lets go of a charged jump on a ramp or was at the edge of the ramp. |
43 | pw_rampscore | This sets the rank the player receives from a ramp:
Any number in between will round down to the lower rank, and any number above 250 will have no effect. |
44 | pw_jmpcharge | This sets the jump charge for a ramp. If it is at 10 or above, the player will use the shortcut. If it is at 40 or above, the player will receive an X rank. |
45 | pw_drift | Should not be modified. |
46 | pw_driftcharge | This sets the drift charge for Riders mode and Mario Kart mode. In Riders mode, if the player stops drifting when the drift charge is at 4 or above, they will get a short boost of speed. In Mario Kart, the requirement is 40 for a short boost and 80 for a long boost. |
47 | pw_jmp | This indicates whether the player is holding the Jump button. Should not be modified. |
48 | pw_positiondelay | This sets the taunt delay timer. After a taunt, the player is prohibited from taunting again for the next 5 seconds. |
49 | pw_oldposition | This is used to save the player's position temporarily, to test if a player that has just been passed can be taunted. Should not be modified. |
50 | pw_kartitem | This is a timer for the item slot machine when a player breaks an item box in Mario Kart mode. It starts at 0 and counts up every tic until it reaches 104 (or 22 if the player presses the attack button). To simulate the effect of breaking an item box, set this value to 1. |
51 | pw_itemslot | This is used if the player gets an item from an item box that they are already holding. The item is saved in this value until the player has used the item they are holding and the corresponding power for the item can be used again. The following values are used for the different items:
|
52 | pw_starshroom | When set to 1, the player is given the Star item. When set to 2, the player is given the Mushroom item. |
53 | pw_mushroom | If set to any value above 0, the player is given the Mushroom item. |
54 | pw_shell | When set to 2, gives the player the Green Shell item. Glitchy when set to 1. |
55 | pw_redshell | When set to 2, gives the player the Red Shell item. Glitchy when set to 1. |
56 | pw_banana | When set to 2, gives the player the Banana item. Glitchy when set to 1. |
57 | pw_bananacam | In Mario Kart mode, you can use this to make the player spin out of control. You also need to set pw_introcam to use this properly. To spin clockwise, set pw_bananacam to -5 and pw_introcam to 2. To spin counterclockwise, set pw_bananacam to 275 and pw_introcam to 3. |
58 | pw_fakeitem | When set to 2, gives the player the Fake Item Box item. Glitchy when set to 1. |
59 | pw_bomb | When set to 2, gives the player the Bob-omb item. Glitchy when set to 1. |
60 | pw_thunder | When set to 1, gives the player the Thunderbolt item. |
61 | pw_megamushroom | When set to 1, gives the player the Mega Mushroom item. |
62 | pw_shrink | After a player is shrunk, this sets the timer for how long the player remains shrunk, in tics. Note that setting this value alone will not shrink the player. Players who have a better position in the race will be shrunk longer. 245 tics (7 seconds) are used for 1st place, and 35 tics (1 second) are used for anyone in 7th place or below. -280 tics (8 seconds) are used for the Mega Mushroom. Both positive and negative numbers will be decremented/incremented each tic until the value reaches 0, respectively. |
63 | pw_squished | After a player is squished, this sets the timer for how long the player remains in their 'squished' animation, in tics. Note that setting this value alone will not squish the player. The default value is 210. The player will not be able to move until the value reaches 100. |
64 | pw_boostcharge | At the start of a Mario Kart level, after 2 seconds, players get the chance to hold the gas pedal to charge their engine. The charging amount is saved in this value. After 4 seconds, if pw_boostcharge is between 7 and 10, players will get an instant boost. If it is less than 7, nothing will happen, and anything above 10 will delay players from the race for 50 tics. |
65 | pw_fishing | Deprecated: This was replaced internally by player->airtime . |
66 | pw_psychic | This sets the timer for the floating special ability, in tics. By default, it starts at 97. |
67 | pw_waypoint | Similar to zoom tubes, this sets the next waypoint that a Riders racer will go to. While these waypoints are functional, they were deleted from all map rotations in favor of a better waypoint mechanism. Speed types will follow waypoints that have an angle between 0 and 359. Fly types will follow waypoints with an angle between 360 and 719. Power types will follow waypoints with an angle between 720 and 1079. |
68 | pw_introcam | In Riders mode, if this is set to 1, the camera will rotate in front of the player. Note: This only works at the beginning of the level, so it should not be modified. In Mario Kart mode, you can use this to make the player spin out of control. You also need to set pw_bananacam to properly use this. To spin clockwise, set pw_bananacam to -5 and pw_introcam to 2. To spin counterclockwise, set pw_bananacam to 275 and pw_introcam to 3. |
69 | pw_sounds | This is used in all Race gametypes to make sure that a sound will play only once. Should not be modified. |
togglecheese
, togglechip
, togglebirdie
) that will spawn either Cheese the Chao, Chip from Sonic Unleashed, or 'Birdie' from Sonic Adventure. They will appear behind the player and follow them around.Modifications | [view] | |
v2.2 | Mystic Realm | |
v2.1 | Acid Missile • Dumbventure • SRB2Kart • SUGOI • SUBARASHII • KIMOKAWAIII • Tortured Planet | |
v2.0 | Botanic Serenity • SRB2CB • SRB2 Riders • XSRB2 | |
v1.09.4 | SA-SRB2 • Blue Heaven • ShufflarB2 • SRB2JTE | |
Pre-1.09.4 | SPMoves |
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.