Server Cvars & Commands
Excessive Plus has several new server cvars and commands, as well as some modifications to existing ones, which accounts for its many server side features. In this document you will find them all.
Variable list
g_redTeam, g_blueTeam
g_redTeam "^1RED"
, g_blueTeam "^4BLUE"
: Now they accept fancy font encoding, which will be drawn on the client scoreboard.
g_teamAutoJoin
g_teamAutoJoin "0"
: Bitmask to control automatic team joining when a player first joins to a server or on gametype changes. Available flags:- 1 - Join automatically to the team with less players or less score.
- 2 - Don't automatically join a team, but preserve the current teams across gametype changes.
refereePassword
refereePassword ""
: Sets the referee password. A referee is like an admin but with the advantage that the admin can restrict the commands a referee can use. You can for example allow referees to kick players but not to ban someone.Use
xp_referee
to define the commands and /ref
to login and execute referee commands.Use an empty password to disable referees.
roundlimit
roundlimit "0"
: Enables a roundbased gameplay. The match will end after X rounds were played no matter if there is a winner or not. However, if fraglimit is enabled, the game can also end if either of the teams reaches the fraglimit.This is only available if
xp_matchmode
is set.
xp_activeClients
xp_activeClients
: Informative cvar that holds the number of non-spectators players that are currently in the server. Very useful for writing conditional rotations, see the Rotation System documentation for further information.
xp_bans
xp_bans "bans.txt"
: File name of the bans script of this server. If it exists, it enables the /rcon ban
server commands, and its used as the input and output file for the Bans System.Use an empty string to disable bans.
xp_chatProtection
xp_chatProtection "0"
: Enables the chat protection after someone chatted for X or more seconds. Setting this to 1 means that it can be abused! One can start chatting to avoid being killed.
xp_config
xp_config "conf/default.cfg"
: Holds the name of the current config file. It can also be used to change the config at the end of the map. For more information, refer to the Configuration System documentation.
xp_crazyCTF
xp_crazyCTF "0"
: Modifies the behavior of flag gametypes. When enabled, when a player touches the enemy flag, he takes it but it respawns right away, but when he is killed while holding the enemy flag, this disappears. This means that the flags will be on each base all of the time, which makes the flag gametypes to center more on capturing the flag, probably better with few players.
xp_crontab
xp_crontab "crontab.txt"
: File name of the crontab script of the server. For a detailed information on the format of this file, refer to the Crontab documentation.Use an empty string to disable crontab.
xp_date
xp_date
: Server info cvar that holds the server binary build date, used to know if a server is fully updated.
xp_floodProtect
xp_floodProtect "1"
: Enables flood protection on the server, which limits the number of commands a client can send to a server (most noticeably chats) in a second to the value of X. If this cvar is enabled, sv_floodProtect
should be disabled.
xp_holyshit
xp_holyshit "0"
: If enabled you will hear the "holyshit" sound when you kill an enemy with a direct BFG hit.
xp_improvePrediction
xp_improvePrediction "1"
: Tries to send information of enemies earlier to the client, reducing the problem with enemies suddenly appearing out of nowhere, easily noticeable when you are playing with high pings.
xp_inactivitySpectator
xp_inactivitySpectator "180"
: This one sets you automatically /away
after X seconds of idle. If you join the game you will get your old score back.
xp_legacy
xp_legacy "3"
: Bitmask to control support for older Excessive Plus versions in the server. Available flags:- 0 - Disable legacy support
- 1 - Enable legacy version support
- 2 - Spam legacy clients with console upgrade messages every 5 min
- 4 - Spam legacy clients with centerprint upgrade messages every 5 min
xp_matchmode
xp_matchmode "0"
: This enables the "match mode". It will enable the following client commands: /lock
, /unlock
, /joinword
, /invite
, /timeout
, /ready
, /notready
, /teamready
. Values:- 1 - Simple Matchmode. Will just enable the matchmode commands.
- 2 - Will enable the roundlimit, with the possibility to have warmup between each rounds if enabled by config.
- 3 - Will enable roundbased gameplay. After each round you will see the scoreboard.
xp_maxMVD
xp_maxMVD "0"
: Number of public simultaneous multiview demo recorders in the server. A value of 0 means disabled, so only referees can record multiview demos.
xp_motd
xp_motd "motd.txt"
: File name which holds the message of the day that will be printed to clients when they connect to the server, or when the client explicitly requests it with the /motd
client command.
xp_muteSpectators
xp_muteSpectators "0"
: Allows you to mute all spectators. They still can talk with other spectators but the in-game players won't see it. Referees are not affected by this setting.
xp_noCustomEnts
xp_noCustomEnts "0"
: Disables map modification scripts located inside the /maps directory, both .add
and .ents
files. For more information, refer to the Map Modification documentation.
xp_physics
xp_physics "0"
: Enable the excessive physics and movement control. Refer to the Configuration System documentation for a detailed description for the possible values of this bitmask.
xp_referee
xp_referee "k,kick,mute,unmute,s,status,w,whois"
: Additional commands the referees can use. Note, however, that the following are commands that the referee can always execute and can't be disabled:capturelimit forcejoin forceteam fraglimit g_doWarmup g_friendlyFire g_gametype g_warmup lock map map_restart nextmap ready roundlimit timein timelimit timeout unlock xp_matchmode xp_suddenDeath
xp_rotateStep
xp_rotateStep "1"
: Default value of the /rcon rotate
command, which accounts for number of maps to "jump" to when rotating the map. Requires a working rotation, and it can be used as the base for random rotations. Refer to the Rotation System documentation for further information.
xp_rotation
xp_rotation ""
: Server rotation script, an empty value disables rotation and falls back to the default quake rotation. For detailed information on the rotation file syntax, refer to the Rotation System documentation.
xp_solids
xp_solids "0"
: Modifies the player interaction with other entities on the server. For a detailed description of this cvar, refer to the Configuration System documentation.
xp_spawnSystem
xp_spawnSystem "3"
: Bitmask that controls player spawning system. Available flags are:- 1 - Try to avoid spawn points close to enemy players.
- 2 - Try to avoid spawn points close to place of death.
xp_suddenDeath
xp_suddenDeath "0"
: Disables or enables sudden death. Sudden death is enforced if the time is over and there is no clear winner.
xp_teamBalance
xp_teamBalance "1"
: This will try to even out the teams after a match is over so the next game can be fair again if good players left a team, etc.
xp_unlagged
xp_unlagged "1"
: Enables the unlagged technology. It can be set separately for each weapon, see the Configuration System documentation for further information.
xp_userdb
xp_userdb "1"
: Enables the user aliases database and enables the following server commands: /rcon whois
and /rcon w
.
xp_validTLD
xp_validTLD "0"
: Don't allow the users to modify the value of their xp_country
cvar, effectively disallowing faked country locations.
xp_version
xp_version
: Holds the version of the Excessive Plus mod. Additionally, since it is a server info cvar, it has the filename of the current config, its name and the MD5 of it.
xp_vote
xp_vote "conf,map_restart,nextmap,map,.."
: This is the /callvote
list. Add or remove commands you want and separate them with a "," or a ";". An empty string disables voting, but the recommended method for disabling callvoting is to disable the g_allowVote
server cvar.
xp_voteconf
xp_voteconf "voteconf.txt"
: File name of the config voting script, which holds the names and descriptions of the allowed configs for voting when xp_vote
has the conf
string on it, see the Configuration System documentation for further information.
xp_voteTime
xp_voteTime "30"
: Adjustable vote time.
xp_warmupRespawn
xp_warmupRespawn "3"
: Bitmask to controls what is respawned at the end of warmup time. For the possible flags, see the Configuration System documentation.
Command list
ban
/rcon ban <id|expresion> [<reason>]
, alias /rcon b
: This command will add a ban to the bans.txt. You can use wildcard matches to ban whole list of players and additionally give a reason for the ban.By default, this command bans a player by name, IP and GUID with a single call. However, if you just want to ban an user for a single one of them, you can use
/rcon banname
, /rcon banip
or /rcon banguid
respectively, all of which share the same syntax as /rcon ban
.Examples:
/rcon ban 2 /rcon ban "A*" "guys with a starting 'A' are out!"
centerprint, cp
/rcon centerprint <message>
, alias /rcon cp
: This lets you display a big message to the screen of all players. Clients can disable printing of this messages by disabling cg_centerTime
.
cmd2
/rcon cmd2 <cvarname> [<arg1> ...
: Executes the string contained in the cvar specified with all the occurrences of $(X)
(where X
is a number) replaced with the passed parameters, which effectively allows you to simulate custom "commands". Additionally, any server command of the form /rcon =cvarname [...]
will be expanded to /rcon cmd2 cvarname [...]
on execution. Example:
// first put the command in the cvar, the following will // modify sv_pure to the first parameter and restart the map right after /rcon set set_pure "sv_pure $(1); map_restart" // now execute the custom "command" /rcon cmd2 set_pure 1 // which is the same as /rcon =set_pure 1 // add the "command" to the referee commands /rcon xp_referee "=set_pure" // now execute it with /ref /ref =set_pure 1 // now add it to vote commands /rcon xp_vote "=set_pure" // now you can /callvote it /callvote =set_pure 1
execstr
/rcon execstr <command>
: Executes the given command with every occurrence of $(cvarname)
replaced with the value of the given cvar, for example:// displays a message with number of playing clients /rcon execstr say ^5There are currently $(xp_activeClients) active clients on the server! // displays the name of the host to clients /rcon execstr say ^5You are playing on $(sv_hostname)! // adds kick to list of referee commands /rcon execstr set xp_referee kick,$(xp_referee)
forcejoin
/rcon forcejoin <id|name> <"red"|"blue"|"none">
: When teams are locked, use this command to invite a player to spectate the given team, and also to be able to join later. If, however, "none" is passed as the team name, it will remove him from any team he was already invited.This is only available if
xp_matchmode
is set.
forceteam
/rcon forceteam <id|expression|"all"|"allbots"> <"free"|"red"|"blue"|"spec"|"away">
: Forces a client to join an specific team. You can use wildcards to match group of clients, or also the keywords "allbots" and "all". If the team you want to set for a client is locked, the client must be already invited to it. If he's not, use /rcon forcejoin
on the client first.
ipdb
/rcon ipdb <ip_address>
: This is just a raw access to the IP-to-Country database. Can be used to check the origin of IP addresses.
kick2, k
/rcon kick2 <id|expresion|"all"|"allbots"> [<reason>]
, alias /rcon k
: This is an advanced /rcon kick
and /rcon clientkick
in one command. You can use wildcard matches to kick a whole list of players and additionally give a reason for the kick. Examples:/rcon k 2 /rcon k "A*" "guys with a starting 'A' are out!" /rcon k all "I want to empty my server!" /rcon k allbots
load
/rcon load <config>
: Loads a specific configuration. Read the Configuration System documentation for further information. Example: /rcon load excessive5
.
lock
/rcon lock <"red"|"blue"|"all">
: Locks the specified team with a random generated password (or both if "all" is used), so clients can't join the team nor spectate its members, and also to lock it's free-fly view, unless the players explicitly /invite
him.This is only available if
xp_matchmode
is set.
motd
/rcon motd <id|"all"> [<motd_file>]
: Displays the contents of the specified file (or the one in the xp_motd
cvar if omitted) as a motd command for the specified client (or to everyone is "all" is used).
mute
/rcon mute <id|name>
: Mutes the given player. A muted player will not be able to chat with other players, except by using private messages (/tell
).
rotate
/rcon rotate <step|"restart">
: Manual rotating command, if no argument is supplied it will use xp_rotateStep
as its value. If instead "restart" is passed, it will rotate to the first map of the rotation. Read the Rotation System documentation for further details.Server admins should be used to
/rcon vstr nextmap
to rotate maps. However this does not work for the new rotation system!You have to use
/rcon rotate
instead, this also works for old rotation. In general just use /rcon rotate
instead of /rcon vstr nextmap
in Excessive Plus.
says
/rcon says <message>
: Broadcast a message to all players. The message will be prepended with "server:", instead of "console:" for /rcon say
, which is handled by the engine. Now since miss-typed commands are only echoed back to the rcon user, he must explicitely use /rcon say
or /rcon says
to communicate with players.
status2, s
/rcon status2
, alias /rcon s
: This is an advanced /rcon status
and will show you the ID, IP address and GUID of the players on the server.
timein, ready
/rcon timein
, alias /rcon ready
: Ends the current taken timeout by setting all clients to ready status.
timeout
/rcon timeout
: Timeouts the game for either 120 seconds (team gametypes) or 60 seconds (tournament). To end the timeout, the clients can use /ready
or /teamready
.
unlock
/rcon unlock <"red"|"blue"|"all">
: Unlocks a previously locked team, or both if "all" is used.
unmute
/rcon unmute <id|name>
: Allows a muted player to chat again.
vote
/rcon vote <"yes"|"no">
: Forces a vote to either pass through ("yes") or to fail ("no").
w
/rcon w
: Queries the user aliases database (userdb) and lists the top 3 aliases for all the current players of the server. Please note that the userdb uses client GUIDs as the identifier for the client, so if the client changes his CD key then the aliases won't be found.This is only available if
xp_userdb
is set.
whois, who
/rcon whois <id>
, alias /rcon who
: Queries the user aliases database (userdb) and lists the top 10 aliases used by the client being queried.This is only available if
xp_userdb
is set.