Commands

From Q4MAX

Q4Max-specific Console Commands

The following commands have been added/changed in Q4Max.

Client commands

  • autorecord - Records a netdemo with a name in the same format as autoaction recorded demos.
  • weapon - Switches to the given weapon - an alias of _impulseX.
  • referee - Used to make yourself a referee, granting limited admin rights.
  • players - Lists all players, and a unique player id to use with other commands.
  • maplist - Lists all the maps available on the server.
  • callvote - Provides a way to vote for many votable options.
  • timeout - Calls a timeout - a limited version of pause for non-referees.
  • timein - Calls the end of a timeout.
  • follow - Allows a spectator to switch to a nominated player when spectating.
  • multipov - Allows a spectator to view all members of a team at once.
  • teamready - Marks everyone on your team as ready.
  • lockteam - Locks/unlocks your team from players.
  • speclock - Locks/unlocks your team from spectators.
  • specinvite - Invites a player to spectate your team.
  • specrevoke - Revokes an invited spectator of your team.
  • coachinvite - Invites a player to coach your team.
  • coach - Accepts a coaching invitation.
  • coachdecline - Declines a coaching invitation.
  • cancelcoach - Makes you quit your coaching position.
  • coachrevoke - Revokes a coach.
  • _button1 - Allows a coach to send voice chat to the currently spectated player.
  • demoSlowDown - Slow down netdemo playback.
  • demoSpeedReset - Reset netdemo playback to normal speed.
  • demoSpeedUp - Speedup netdemo playback.
  • aviNetDemo - Capture screenshots from a netdemo suitable for creating an avi.
  • viewSizeUp/viewSizeDown - Increase/decrease view size.
  • networkStats - Report network traffic stats.
  • reloadHud - Reloads the current hud.
  • fixUserInfo - Attempts to get your userInfo from the server.

Referee commands

  • abort - Abandons the current game and returns to warmup.
  • allready - Readies up all players and begins the game.
  • lockteams - Locks teams to prevent players joining mid-game.
  • unlockteams - Unlocks teams to allow players to join.
  • marine - Puts a given player on the marine team.
  • strogg - Puts a given player on the strogg team.
  • ingame - Puts a given player in a non-team game.
  • remove - Removes a given player from a game.
  • coachMarine - Assign a given player to coach duty for the marine team.
  • coachStrogg - Assign a given player to coach duty for the strogg team.
  • specMarine - Turn a given player into a marine spectator.
  • specStrogg - Turn a given player into a strogg spectator.
  • specBoth - Turn a given player into an all-seeing spectator.
  • pause - Pauses a game.
  • unpause - Unpauses a game.
  • speclockstrogg - Locks the Strogg team from spectators.
  • specunlockstrogg - Unlocks the Strogg team from spectators.
  • speclockmarine - Locks the Marine team from spectators.
  • specunlockmarine - Unlocks the Marine team from spectators.
  • speclockall - Locks both teams from spectators.
  • specunlockall - Unlocks both teams from spectators.
  • cancelref - Makes you quit your referee position.

Server commands

Client commands details

autorecord

Summary
Records a netdemo with a name in the same format as autoaction recorded demos.
Description
This behaves like "recordnetdemo", except it does not take any arguments : it will name the recorded demo in the same format as autoaction demos.

weapon

Summary
Switches to the given weapon - an alias of _impulseX.
Parameters
0-10
Description
This command acts just the same as _impulse0 - _impulse10, switching to the selected weapon. Unlike _impulseX it works within a bind along with others. For example: bind l "weapon 1; sensitivity 5"

referee

Summary
Used to make yourself a referee, granting limited admin rights.
Parameters
Password (string)
Description
This command can be used to become a referee, and is intended to allow "trusted" clients to become a limited admin on the server to run a match. The password supplied must be the same as the ref_password cvar set on the server. You must do this before you can execute any of the referee commands.

players

Summary
Lists all players, and a unique player id to use with other commands.
Description
This provides a list of the players, and a unique id for each player. This id is used as a parameter to other commands. Additionally it shows whether the player is a spectator, whether they are marked as ready, and in a team game shows their team.

maplist

Summary
Lists all the maps available on the server.
Description
This provides a list of all the maps that are on the server which support the current game-mode. This allows the player to know the maps they can vote for using the "callvote map" command.

callvote

Summary
Calls a vote on a given option.
Parameters
<votename> [setting]
Description
This allows a player to vote for a specific setting to be changed. The <votename> parameter indicates what is voteable, and the [setting] parameter indicates the value requested.

There are many voteable settings - these can be listed, complete with a description using "callvote ?". See the current list of settings.

Using this command with no [setting] parameter will display the current state of this setting. Note that server operators can disable specific votes if they do not wish any given setting to be voteable. Common votes include "callvote mode CA" or "callvote map mp/swq4dm1".

timeout

Summary
Calls a timeout - a limited version of pause for non-referees.
Description
This allows a player to call a timeout, pausing the game temporarily. The timeout is cancelled by using this command a second time, or timein. To prevent abuse of this command, timeouts are limited in length - by the cvar sv_timeoutMaxLength (default 60 seconds), and in number (per player or team) - sv_maxTimeouts (default 5).
In team games, the number of timeouts is shared across the whole team, and the timeout may be cancelled by any member of the team. If a referee pauses during a timeout, the timeout will be converted to a ref-pause, and cannot be cancelled by the original owner.

timein

Summary
Calls the end of a timeout.

follow

Summary
Allows a spectator to switch to a nominated player when spectating.
Parameters
<powerup> or <playerid>
Description
This allows a spectator to follow either a specific player, or to follow a player holding a specific powerup. The parameter can either be one of the powerup names ("quad", "regen", "haste", "invis", "marineflag" or "stroggflag"), or the player id reported by the "players" command for the player you wish to follow.
If there are multiple powerups of the same type in play at the same time, executing this command multiple times will cycle through all players with that powerup. Note that this is not "automatic" following of the powerups, and simply changes to the player holding that powerup at the time you execute this command.

multipov

Summary
Allows a spectator to view all members of a team at once.
Description
Allows spectators (including coaches) to view all members of a team at once.
Multipov is not restricted to teamgames : it may be used in a duel to watch both players at once.

teamready

Summary
Marks everyone on your team as ready.

speclock

Summary
Locks/unlocks your team from spectators.



lockteam

Summary
Locks/unlocks your team from spectators.
Description
When g_allowLockTeam is set to 1 (default value), anyone can lock/unlock their team with this command.
Otherwise, only referees can perform these actions with the lockteams command.

specinvite

Summary
Invites a player to spectate your team.
Parameters
<playerid>
Description 
This allows someone inside a team to invite spectators when the team is speclocked. Get the spectator's player id by using the players command.

specrevoke

Summary
Revokes an invited spectator of your team.
Parameters
<playerid>
Description 
Removes an invited spectator when your team is speclocked. Get the spectator's player id by using the players command.

coachinvite

Summary
Invites a player to coach your team.
Parameters
<playerid>
Description 
Invites a spectator to coach your team. Get the spectator's player id by using the players command.

coach

Summary
Accepts a coaching invitation.
Description 
Issuing this command turns you into a coach for the team which sent the invitation. As a coach, you can partake in the team's teamchat (both in type and using voicechat), see the team overlay and view any players on the coached team. You can also use the _button1 to send voice messages to the player you are currently viewing.

coachdecline

Summary
Declines a coaching invitation.

cancelcoach

Summary
Makes you quit your coaching position.
Description 
Use this if you want to quit coaching a team.

coachrevoke

Summary
Revokes a coach.
Description 
Use this if you want to remove a coach from your team.

_button1

Summary
Allows a coach to send voice chat to the currently spectated player.
Description 
This functions like press-to-talk voice chat, with the only exception that it only sends messages to the player you are currently viewing.

demoSlowDown

Summary
Slow down netdemo playback.
Description 
This command halves demo_scale down to 0.25.

demoSpeedReset

Summary
Reset netdemo playback to normal speed.
Description 
This command resets demo_scale to 1.

demoSpeedUp

Summary
Speedup netdemo playback.
Description 
This command doubles demo_scale up to 32.

aviNetDemo

Summary
Capture screenshots from a netdemo suitable for creating an avi.
Parameter
a netdemo filename
Description 
This command will turn an entire netdemo into a sequence of tga or jpg screenshots running at 62.5 fps.
When executed, this will set demo_aviDemoName to the filename passed as a parameter and save the screenshots in a subdirectory of q4max/screenshots/avidemo/ named after this filename.
It will keep going as long as demo_aviDemoScreenshots is set to 1, or until you disconnect/the demo ends.

See also the Videomaking page for more usage info.


viewSizeUp/viewSizeDown

Summary
Increase/decrease view size.
Description 
These commands will respectively increase/decrease the view size.

networkStats

Summary
Report network traffic stats.
Description 
On a client, reports in/out rate and incoming PL to the console.
On a server, reports in/out rate and incoming PL of each client to the server console.

reloadHud

Summary
Reloads the current hud.
Description 
Use this when editing a hud.cfg live.

fixUserInfo

Summary
Attempts to get your userInfo from the server.
Description
If using the command once doesn't help, don't bother spamming it - it will either work, or it wont.

Referee commands details

abort

Summary
Abandons the current game and returns to warmup.
Description
This command is intended to be used when a match needs to be abandoned. It sets all players to "not ready", and resets the game back to the warmup.

allready

Summary
Readies up all players and begins the game.
Description
This forces all players to be "ready", even if they have not readied up themselves, thus allowing the game to begin.

lockteams

Summary
Locks teams to prevent players joining mid-game.
Description
This locks all teams, ensuring that no new players may join the teams. To unlock the teams, use the unlockteams command. Generally this would be used in a tournament match to ensure that any joining players must remain as spectators. This command is only valid in a team game.

unlockteams

Summary
Unlocks teams to allow players to join.
Description
This is the reverse of lockteams, and unlocks the teams allowing players to join the team. This command is only valid in a team game.

marine

Summary
Puts a given player on the marine team.
Parameters
<player id>
Description
This forces the given player to join the marine team. The referee may do this even if the teams are locked, thus allowing known players to join a locked team. This command is only valid in a team game.

strogg

Summary
Puts a given player on the strogg team.
Parameters
<player id>
Description
This forces the given player to join the marine team. The referee may do this even if the teams are locked, thus allowing known players to join a locked team. This command is only valid in a team game.

ingame

Summary
Puts a given player in a non-team game.
Parameters
<player id>
Description
Invites the given player into a duel/tourney/ffa game.

remove

Summary
Removes a given player from a game.
Parameters
<player id>
Description
This removes the given player from the players, and makes them a spectator.

coachMarine

Summary
Assign a given player to coach duty for the marine team.
Parameters
<player id>
This moves the given player from whichever team they are currently on, and makes them a coach for the marine team. This command is only valid in a team game.

coachStrogg

Summary
Assign a given player to coach duty for the strogg team.
Parameters
<player id>
This moves the given player from whichever team they are currently on, and makes them a coach for the strogg team. This command is only valid in a team game.

specMarine

Summary
Turn a given player into a marine spectator.
Parameters
<player id>
Moves specified player id to spec, then force him into a marine spectator.

specStrogg

Summary
Turn a given player into a strogg spectator.
Parameters
<player id>
Moves specified player id to spec, then force him into a strogg spectator.

specBoth

Summary
Turn a given player into an all-seeing spectator.
Parameters
<player id>
Moves specified player id to spec, and allow him to spectate both teams.

pause

Summary
Pauses a game.
Description
This command pauses the current game, halting all player movement, events, and times. This is intended for use in cases such as a player suffering extreme lag / disconnecting during a match etc.
Issuing this command during a pause cancels the pause.
Note that this command cannot be used in the Tourney mode. We recommend tournaments are played in the Duel mode.

unpause

Summary
Unpauses a game.

speclockstrogg

Summary
Locks the Strogg team from spectators.

specunlockstrogg

Summary
Unocks the Strogg team from spectators.

speclockmarine

Summary
Locks the Marine team from spectators.

specunlockmarine

Summary
Unlocks the Marine team from spectators.

speclockall

Summary
Locks both teams from spectators.

specunlockall

Summary
Unlocks both teams from spectators.

cancelref

Summary
Makes you quit your referee position.

Server commands details

passvote

Summary
Pass a vote.
Description
This is used to pass votes straight from the server console.

networkStats (server)

See the networkStats details.

broadcastMsg

Summary
Broadcast a message to all clients.
Description
Sends a string to clients, which will show in the MOTD field. Useful for "shutting down server!" warnings or TV centerprints.


addBot

Summary
Add a bot.
Parameters
name team
Description
Add a "name" bot. If the name matches a defined bot personality, the defined bot will be added, otherwise it will be a default bot.
In team games, you can also specify the team (strogg or marine, marine if unspecified).


AddIPToBanList

Summary
Adds an IP into the banlist.
Parameters
IP
Description
Adds the IP into the banlist. If the ip is just the beginning of the IP (eg 123.123.123) then it will ban 123.123.123.* - do not use wildcards though, its automatic. Note that you must use the IP as displayed in the q4 console at connection - this is usually dotted quads, but it is sometimes resolved in the case of localhost, and maybe other computers on the sam LAN.


AddGuidToBanList

Summary
Adds a GUID into the banlist.
Parameters
GUID
Description
Adds the given GUID into the banlist. The guid is a q4 guid, as shown by the players command. Another useful source of of player to GUID mappings is from the stats XML logs. If the guid contains non-alpha chars, it is worth quoting the parameter to make sure it is entered correctly.


RemoveIPFromBanList

Summary
Removes an IP from the banlist.
Parameters
IP
Description
Removes an IP from the banlist. Only exact matches are removed, so be careful to type it exactly as entered in the ban list. This includes partial IPs used to ban entire ranges of IPs.

RemoveGuidFromBanList

Summary
Removes a GUID from the banlist.
Parameters
IP
Description
Removes the given GUID from the banlist. Only exact matches are removed, so be careful to type it exactly as entered in the ban list. As with adding, make sure that the guid is quoted if contains slashes etc.


ShowBanList

Summary
Displays the banlist.
Parameters
GUID
Description
This command can be used to look at the players that are currently entered into the banlist, listing name (if known), guid. IP bans are shown with a blank guid, and a name of the IP that is banned.