This guide covers server administration, console commands, add-on management, map rotation, and game mode configuration for your Sonic Robo Blast 2 (SRB2) server on Legion Hosting. For initial setup and player connection instructions, see SRB2 Server Setup Guide.
1. Server Console
The SRB2 server console is accessible via the Console tab in GPanel. Type commands directly into the console input field while the server is running.
2. Common Console Commands
| Command | Description |
|---|---|
help |
Lists available console commands. |
map [mapname] |
Changes to the specified map (e.g., map MAP01). |
exitlevel |
Forces the current level to end and advances to the next map. |
kick [player#] [reason] |
Kicks a player by their player number with an optional reason. |
ban [player#] [reason] |
Bans a player by their player number. |
unban [ban#] |
Removes a ban by ban list number. |
banlist |
Displays the current ban list. |
listplayers |
Shows all connected players and their player numbers. |
password [pass] |
Changes the server password. Use empty value to remove the password. |
maxplayers [num] |
Changes the maximum player count (up to 32). |
gametype [type] |
Changes the game mode (e.g., coop, match, ctf, race, tag). |
pointlimit [num] |
Sets the score limit for the current game mode. |
timelimit [minutes] |
Sets the time limit per map in minutes. 0 disables. |
forceskin [player#] [skin] |
Forces a player to use a specific character skin. |
say [message] |
Sends a server message to all players. |
quit |
Shuts down the server. |
3. Game Mode Configuration
Change the active game mode using the gametype command or by setting it in adedserv.cfg.
| Gametype | Command | Description |
|---|---|---|
| Co-op | gametype coop |
Cooperative campaign play. |
| Competition | gametype competition |
Score-based stage competition. |
| Race | gametype race |
Speed-run racing stages. |
| Match | gametype match |
Free-for-all ring combat. |
| Team Match | gametype teammatch |
Team-based ring combat. |
| CTF | gametype ctf |
Capture the Flag. |
| Tag | gametype tag |
Tag game mode. |
| Hide & Seek | gametype hns |
Hide and Seek mode. |
4. Add-ons and Custom Content
SRB2 supports add-ons in .pk3 and .wad formats. To add custom content:
- Stop the server.
- Upload add-on files to the server directory via SFTP.
- Add the following line to
adedserv.cfgto load the add-on on startup:addfile myaddon.pk3 - Restart the server.
5. Map Rotation
Configure the map rotation by adding map commands to adedserv.cfg. You can also use the following console variables:
map [mapname]-- Change the current map immediately.nextmap [mapname]-- Set the next map in the rotation.exitlevel-- End the current level and advance to the next.
6. Additional Configuration
Add any console variable or command to adedserv.cfg for it to execute on server start. Examples:
servername "My SRB2 Server"
wait 5
password MyPassword
wait 5
maxplayers 16
wait 5
gametype match
wait 5
timelimit 10
pointlimit 50wait between commands. The wait [tics] command adds a delay between commands in the config file. This prevents commands from being processed too quickly and being skipped.
7. Troubleshooting
| Issue | Solution |
|---|---|
| Server not in master list | Verify ROOM_NR is set correctly (33 or 28). Check that the server is running and not password-restricted from listing. |
| Players cannot join | Check IP and port in GPanel, ensure the password is correct, and verify the server version matches the client version. |
| Add-ons not loading | Ensure the addfile command in adedserv.cfg references the correct filename and the file is in the server root directory. |
| Server crashes on map change | Some custom maps may be incompatible. Try removing recently added add-ons and testing with default maps. |
Related Articles
Need Help?
If you run into issues with your SRB2 server, open a support ticket and include your server IP, a description of the problem, and any relevant error messages from the GPanel console.
