Limit maximum length of vote commands to 160 by default
[xonotic/xonotic-data.pk3dir.git] / commands.cfg
1 // =================================================================
2 //  Master config for managing various command aliases and settings
3 // =================================================================
4
5 // Execute commands based on whether it is dedicated a server or a client.
6 alias "_detect_dedicated_$qport" "${* asis}"
7 alias "_detect_dedicated_0" ""
8 alias _if_dedicated "_detect_dedicated_$qport ${* asis}"
9 alias if_client "${* asis}"
10 alias if_dedicated "${* asis}"
11 _if_dedicated alias if_client ""
12 if_client alias if_dedicated ""
13
14 // for easy access by QC
15 if_dedicated set is_dedicated 1
16 if_client    set is_dedicated 0
17
18 if_dedicated "alias" qc_cmd_sv     "sv_cmd $$*"
19 if_client    "alias" qc_cmd_sv     "sv_cmd $$*"
20 // if_client    "alias" qc_cmd_sv     "echo This command only works on servers: sv_cmd $${* !}"
21 if_dedicated "alias" qc_cmd_cl     "echo This command only works on clients: cl_cmd $${* !}"
22 if_client    "alias" qc_cmd_cl     "cl_cmd $$*"
23 if_dedicated "alias" qc_cmd_cmd    "echo This command only works on clients: cmd $${* !}"
24 if_client    "alias" qc_cmd_cmd    "cmd $$*"
25
26 if_dedicated "alias" qc_cmd_svmenu "sv_cmd $$*"
27 if_client    "alias" qc_cmd_svmenu "menu_cmd $$*"
28 if_dedicated "alias" qc_cmd_svcl   "sv_cmd $$*"
29 if_client    "alias" qc_cmd_svcl   "cl_cmd $$*"
30 if_dedicated "alias" qc_cmd_svcmd  "sv_cmd $$*"
31 if_client    "alias" qc_cmd_svcmd  "cmd $$*"
32
33 if_dedicated "alias" help "sv_cmd help"
34 if_client    "alias" help "cl_cmd help; cmd help"
35
36
37 // ========
38 //  common
39 // ========
40 // networked/server common commands
41 alias cvar_changes         "qc_cmd_svcmd  cvar_changes         ${* ?}" // Prints a list of all changed server cvars
42 alias cvar_purechanges     "qc_cmd_svcmd  cvar_purechanges     ${* ?}" // Prints a list of all changed gameplay cvars
43 alias info                 "qc_cmd_svcmd  info                 ${* ?}" // Request for unique server information set up by admin
44 alias ladder               "qc_cmd_svcmd  ladder               ${* ?}" // Get information about top players if supported
45 alias lsmaps               "qc_cmd_svcmd  lsmaps               ${* ?}" // List maps which can be used with the current game mode
46 alias lsnewmaps            "qc_cmd_svcmd  lsnewmaps            ${* ?}" // List maps which have no records or are seemingly unplayed yet
47 alias printmaplist         "qc_cmd_svcmd  printmaplist         ${* ?}" // Display full server maplist reply
48 alias rankings             "qc_cmd_svcmd  rankings             ${* ?}" // Print information about rankings
49 alias records              "qc_cmd_svcmd  records              ${* ?}" // List top 10 records for the current map
50 alias teamstatus           "qc_cmd_svcmd  teamstatus           ${* ?}" // Show information about player and team scores
51 alias time                 "qc_cmd_svcmd  time                 ${* ?}" // Print different formats/readouts of time
52 alias timein               "qc_cmd_svcmd  timein               ${* ?}" // Resume the game from being paused with a timeout
53 alias timeout              "qc_cmd_svcmd  timeout              ${* ?}" // Call a timeout which pauses the game for certain amount of time unless unpaused
54 alias vote                 "qc_cmd_svcmd  vote                 ${* ?}" // Request an action to be voted upon by players
55 alias who                  "qc_cmd_svcmd  who                  ${* ?}" // Display detailed client information about all players
56
57 // generic commands (across all programs)
58 alias addtolist            "qc_cmd_svmenu addtolist            ${* ?}" // Add a string to a cvar
59 alias dumpcommands         "qc_cmd_svmenu dumpcommands         ${* ?}" // Dump all commands on the program to *_cmd_dump.txt
60 alias dumpnotifs           "qc_cmd_svcl   dumpnotifs           ${* ?}" // Dump all notifications into notifications_dump.txt
61 alias maplist              "qc_cmd_svmenu maplist              ${* ?}" // Automatic control of maplist
62 alias nextframe            "qc_cmd_svmenu nextframe            ${* ?}" // Execute the given command next frame of this VM
63 alias qc_curl              "qc_cmd_svmenu qc_curl              ${* ?}" // Queries a URL
64 alias removefromlist       "qc_cmd_svmenu removefromlist       ${* ?}" // Remove a string from a cvar
65 alias restartnotifs        "qc_cmd_svcl   restartnotifs        ${* ?}" // Re-initialize all notifications
66 alias rpn                  "qc_cmd_svmenu rpn                  ${* ?}" // RPN calculator
67 //alias settemp            "qc_cmd_svmenu settemp              ${* ?}" // Temporarily set a value to a cvar which is restored later
68 //alias settemp_restore    "qc_cmd_svmenu settemp_restore      ${* ?}" // Restore all cvars set by settemp command
69
70 // other aliases for common commands
71 alias g_hitplots_add "qc_cmd_svmenu rpn /g_hitplots_individuals g_hitplots_individuals ${1 !} union def"
72 alias g_hitplots_remove "qc_cmd_svmenu rpn /g_hitplots_individuals g_hitplots_individuals ${1 !} difference def"
73
74 alias g_maplist_add     "qc_cmd_svmenu maplist add ${* ?}"
75 alias g_maplist_remove  "qc_cmd_svmenu maplist remove ${* ?}"
76 alias g_maplist_putfirst        "qc_cmd_svmenu maplist remove ${* ?} ; qc_cmd maplist add ${* ?}"
77 alias g_maplist_shufflenow      "qc_cmd_svmenu maplist shuffle"
78 alias g_maplist_cleanup "qc_cmd_svmenu maplist cleanup" // removes maps that don't exist from the map list
79
80 alias addfav "qc_cmd_svmenu addtolist net_slist_favorites ${* ?}"
81 alias addvote "qc_cmd_svmenu addtolist sv_vote_commands ${* ?}"
82
83
84 // ========================
85 //  engine command aliases
86 // ========================
87 alias bsp "ls maps/*.bsp"
88 alias chmap "changelevel ${* ?}"
89 alias clearmap "disconnect"
90 alias devmap "set _developer_save $developer; set developer 1; changelevel ${* ?}; set developer $_developer_save"
91 alias ply "playdemo $1"
92 alias rec "record demos/${1 !}"
93 alias search "apropos ${* ?}"
94 alias sv_loadconfig "exec $serverconfig"
95 alias sv_restart "say \"Server will restart at the end of the match, you will all be reconnected automatically. ${* ?} \"; quit_and_redirect self"
96 alias tdem "timedemo $1"
97
98
99 // ===============================================
100 //  menu_cmd (menu command) - menu/command/menu_cmd.qc
101 // ===============================================
102 alias menu_showteamselect "menu_cmd directmenu TeamSelect"
103 alias menu_showhudexit "menu_cmd directmenu HUDExit"
104 alias menu_showhudoptions "menu_cmd directpanelhudmenu ${* ?}"
105 alias menu_showsandboxtools "menu_cmd directmenu SandboxTools"
106 alias menu_showquitdialog "menu_cmd directmenu Quit"
107
108 // command executed before loading a map by the menu
109 // makes sure maxplayers is at least minplayers or bot_number + 1
110 alias _menu_loadmap_prepare_maxpl "maxplayers $_menu_loadmap_maxplayers"
111 alias menu_loadmap_prepare "disconnect; wait; g_campaign 0; menu_cmd rpn /_menu_loadmap_maxplayers menu_maxplayers minplayers bot_number 1 add max max def; _menu_loadmap_prepare_maxpl; g_maplist_shufflenow"
112
113
114 // ==========================================================
115 //  cl_cmd (client local command) - client/command/cl_cmd.qc
116 // ==========================================================
117 // commented out commands are really only intended for internal use
118 alias blurtest             "qc_cmd_cl     blurtest             ${* ?}" // Feature for testing blur postprocessing
119 alias create_scrshot_ent   "qc_cmd_cl     create_scrshot_ent   ${* ?}" // Create an entity at this location for automatic screenshots
120 alias debugmodel           "qc_cmd_cl     debugmodel           ${* ?}" // Spawn a debug model manually
121 //alias handlevote         "qc_cmd_cl     handlevote           ${* ?}" // System to handle selecting a vote or option
122 alias hud                  "qc_cmd_cl     hud                  ${* ?}" // Commands regarding/controlling the HUD system
123 alias localprint           "qc_cmd_cl     localprint           ${* ?}" // Create your own centerprint sent to yourself
124 //alias mv_download        "qc_cmd_cl     mv_download          ${* ?}" // Retrieve mapshot picture from the server
125 alias sendcvar             "qc_cmd_cl     sendcvar             ${* ?}" // Send a cvar to the server (like weaponpriority)
126
127 // other aliases for local commands
128 alias hud_configure "qc_cmd_cl hud configure"
129 alias hud_save "qc_cmd_cl hud save ${* ?}"
130 alias radar "qc_cmd_cl hud radar ${* ?}"
131 alias scoreboard_columns_help "qc_cmd_cl hud scoreboard_columns_help"
132 alias scoreboard_columns_set "qc_cmd_cl hud scoreboard_columns_set ${* ?}"
133
134 // changes a cvar and reports it to the server (for the client to notify the server about changes)
135 alias setreport "set \"$1\" \"$2\" ; sendcvar \"$1\""
136
137
138 // ========================================================
139 //  cmd (client-to-server command) - server/command/cmd.qc
140 // ========================================================
141 set sv_clientcommand_antispam_time 1 "Amount of seconds after a command before another command can be called again without being considered spam. (Use -1 for no antispam limit)"
142 set sv_clientcommand_antispam_count 8 "Amount of commands considered spam before commands are rejected."
143 seta sv_status_privacy 1 "hide IP addresses from \"status\" and \"who\" replies shown to clients"
144 seta cl_autoswitch 1 "automatically switch to newly picked up weapons if they are better than what you are carrying"
145
146 // commented out commands are really only intended for internal use, or already have declaration in the engine
147 alias autoswitch           "qc_cmd_cmd    autoswitch           ${* ?}" // Whether or not to switch automatically when getting a better weapon
148 alias checkfail            "qc_cmd_cmd    checkfail            ${* ?}" // Report if a client-side check failed
149 alias clientversion        "qc_cmd_cmd    clientversion        ${* ?}" // Release version of the game
150 //alias mv_getpicture      "qc_cmd_cmd    mv_getpicture        ${* ?}" // Retrieve mapshot picture from the server
151 alias join                 "qc_cmd_cmd    join                 ${* ?}" // Become a player in the game
152 alias ready                "qc_cmd_cmd    ready                ${* ?}" // Qualify as ready to end warmup stage (or restart server if allowed)
153 alias reportcvar           "qc_cmd_cmd    reportcvar           ${* ?}" // Old system for sending a client cvar to the server
154 //alias say                "qc_cmd_cmd    say                  ${* ?}" // Print a message to chat to all players
155 //alias say_team           "qc_cmd_cmd    say_team             ${* ?}" // Print a message to chat to all team mates
156 alias selectteam           "qc_cmd_cmd    selectteam           ${* ?}" // Attempt to choose a team to join into
157 alias selfstuff            "qc_cmd_cmd    selfstuff            ${* ?}" // Stuffcmd a command to your own client
158 alias sentcvar             "qc_cmd_cmd    sentcvar             ${* ?}" // New system for sending a client cvar to the server
159 alias spectate             "qc_cmd_cmd    spectate             ${* ?}" // Become an observer
160 alias suggestmap           "qc_cmd_cmd    suggestmap           ${* ?}" // Suggest a map to the mapvote at match end
161 //alias tell               "qc_cmd_cmd    tell                 ${* ?}" // Send a message directly to a player
162 alias voice                "qc_cmd_cmd    voice                ${* ?}" // Send voice message via sound
163
164 // other aliases for client-to-server commands
165 alias autoswitch "set cl_autoswitch ${1 ?} ; cmd autoswitch ${1 ?}" // todo
166
167 alias team_red "cmd selectteam red; cmd join"
168 alias team_blue "cmd selectteam blue; cmd join"
169 alias team_pink "cmd selectteam pink; cmd join"
170 alias team_yellow "cmd selectteam yellow; cmd join"
171 alias team_auto "cmd selectteam auto; cmd join"
172
173 alias spec "spectate"
174
175 // mutator aliases
176 alias sandbox "cmd g_sandbox ${* ?}"
177
178
179 // ============================================================
180 //  sv_cmd (server console command) - server/command/sv_cmd.qc
181 // ============================================================
182 alias adminmsg             "qc_cmd_sv     adminmsg             ${* ?}" // Send an admin message to a client directly
183 alias allready             "qc_cmd_sv     allready             ${* ?}" // Restart the server and reset the players
184 alias allspec              "qc_cmd_sv     allspec              ${* ?}" // Force all players to spectate
185 alias anticheat            "qc_cmd_sv     anticheat            ${* ?}" // Create an anticheat report for a client
186 alias bbox                 "qc_cmd_sv     bbox                 ${* ?}" // Print detailed information about world size
187 alias bot_cmd              "qc_cmd_sv     bot_cmd              ${* ?}" // Control and send commands to bots
188 alias cointoss             "qc_cmd_sv     cointoss             ${* ?}" // Flip a virtual coin and give random result
189 alias database             "qc_cmd_sv     database             ${* ?}" // Extra controls of the serverprogs database
190 alias defer_clear          "qc_cmd_sv     defer_clear          ${* ?}" // Clear all queued defer commands for a specific client
191 alias defer_clear_all      "qc_cmd_sv     defer_clear_all      ${* ?}" // Clear all queued defer commands for all clients
192 alias delrec               "qc_cmd_sv     delrec               ${* ?}" // Delete race time record for a map
193 alias effectindexdump      "qc_cmd_sv     effectindexdump      ${* ?}" // Dump list of effects from code and effectinfo.txt
194 alias extendmatchtime      "qc_cmd_sv     extendmatchtime      ${* ?}" // Increase the timelimit value incrementally
195 alias find                 "qc_cmd_sv     find                 ${* ?}" // Search through entities for matching classname
196 alias gametype             "qc_cmd_sv     gametype             ${* ?}" // Simple command to change the active gametype
197 alias gettaginfo           "qc_cmd_sv     gettaginfo           ${* ?}" // Get specific information about a weapon model
198 alias gotomap              "qc_cmd_sv     gotomap              ${* ?}" // Simple command to switch to another map
199 alias lockteams            "qc_cmd_sv     lockteams            ${* ?}" // Disable the ability for players to switch or enter teams
200 alias make_mapinfo         "qc_cmd_sv     make_mapinfo         ${* ?}" // Automatically rebuild mapinfo files
201 alias moveplayer           "qc_cmd_sv     moveplayer           ${* ?}" // Change the team/status of a player
202 alias nospectators         "qc_cmd_sv     nospectators         ${* ?}" // Automatically remove spectators from a match
203 alias playerdemo           "qc_cmd_sv     playerdemo           ${* ?}" // Control the ability to save demos of players
204 alias printstats           "qc_cmd_sv     printstats           ${* ?}" // Dump eventlog player stats and other score information
205 alias radarmap             "qc_cmd_sv     radarmap             ${* ?}" // Generate a radar image of the map
206 alias reducematchtime      "qc_cmd_sv     reducematchtime      ${* ?}" // Decrease the timelimit value incrementally
207 alias setbots              "qc_cmd_sv     setbots              ${* ?}" // Adjust how many bots are in the match
208 alias shuffleteams         "qc_cmd_sv     shuffleteams         ${* ?}" // Randomly move players to different teams
209 alias stuffto              "qc_cmd_sv     stuffto              ${* ?}" // Send a command to be executed on a client
210 alias trace                "qc_cmd_sv     trace                ${* ?}" // Various debugging tools with tracing
211 alias unlockteams          "qc_cmd_sv     unlockteams          ${* ?}" // Enable the ability for players to switch or enter teams
212 alias warp                 "qc_cmd_sv     warp                 ${* ?}" // Choose different level in campaign
213
214 // other aliases for server commands
215 alias endmatch "timelimit -1"
216
217 alias savedb "sv_cmd database save \"${1 ?}\""
218 alias dumpdb "sv_cmd database dump \"${1 ?}\""
219 alias loaddb "sv_cmd database load \"${1 ?}\""
220
221 alias movetored "moveplayer ${1 ?} red"
222 alias movetoblue "moveplayer ${1 ?} blue"
223 alias movetopink "moveplayer ${1 ?} pink"
224 alias movetoyellow "moveplayer ${1 ?} yellow"
225 alias movetoauto "moveplayer ${1 ?} auto"
226
227
228 // =======================================================
229 //  Aliases for settemp subsystem. Warning: Do not touch. 
230 //  Usage: settemp variable value, next map resets it.
231 // =======================================================
232 alias settemp "qc_cmd_svcl settemp $*"
233 alias settemp_restore "qc_cmd_svcl settemp_restore"
234
235
236 // ===================================
237 //  banning - server/command/ipban.qc
238 // ===================================
239 alias ban                  "qc_cmd_sv     ban                  ${* ?}" // Ban an IP address or a range of addresses (like 1.2.3)
240 alias banlist              "qc_cmd_sv     banlist              ${* ?}" // List all existing bans
241 alias kickban              "qc_cmd_sv     kickban              ${* ?}" // Disconnect a client and ban it at the same time
242 alias mute                 "qc_cmd_sv     mute                 ${* ?}" // Disallow a client from talking by muting them
243 alias unban                "qc_cmd_sv     unban                ${* ?}" // Remove an existing ban
244 alias unmute               "qc_cmd_sv     unmute               ${* ?}" // Unmute a client
245
246 // other aliases for ban commands
247 alias bans "banlist"
248
249 // character classes (intersected with 32..126 minus ", $, ;, ^, \ - if you
250 // want these, include them explicitly)
251 // note that QC code always forbids $ and ; in VoteCommand_checknasty
252 set _iscntrl ""
253 set _isblank " "
254 set _ispunct "!#%&'()*+,-./:<=>?@[]_`{|}~"
255 set _isdigit "0123456789"
256 set _isupper "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
257 set _islower "abcdefghijklmnopqrstuvwxyz"
258 set _isxdigit "0123456789abcdefABCDEF"
259
260 // derived character classes
261 set _isalpha "$_isupper$_islower"
262 set _isalnum "$_isalpha$_isdigit"
263 set _isgraph "$_ispunct$_isalnum"
264 set _isascii "$_isgraph$_isblank"
265 set _isprint "$_isgraph$_isblank"
266 set _isspace "$_isblank"
267
268 // restriction is specified as <minargs> followed by <maxargs> instances of ';'
269 // and the optional character class to verify the argument by (no checking if
270 // empty)
271 // set cvar to empty string to not check the command at all
272 // if cvar is not set there will be a warning
273 set sv_vote_command_restriction_restart "0"
274 set sv_vote_command_restriction_fraglimit "1;$_isdigit"
275 set sv_vote_command_restriction_chmap "1;$_isgraph"
276 set sv_vote_command_restriction_gotomap "1;$_isgraph"
277 set sv_vote_command_restriction_nextmap "1;$_isgraph"
278 set sv_vote_command_restriction_endmatch "0"
279 set sv_vote_command_restriction_reducematchtime "0"
280 set sv_vote_command_restriction_extendmatchtime "0"
281 set sv_vote_command_restriction_allready "0"
282 set sv_vote_command_restriction_kick "1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;" // enough space for ban reason
283 set sv_vote_command_restriction_kickban "1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;" // enough space for ban reason
284 set sv_vote_command_restriction_cointoss "0"
285 set sv_vote_command_restriction_movetoauto "1;"
286 set sv_vote_command_restriction_movetored "1;"
287 set sv_vote_command_restriction_movetoblue "1;"
288 set sv_vote_command_restriction_movetoyellow "1;"
289 set sv_vote_command_restriction_movetopink "1;"
290
291 // =================================
292 //  voting - server/command/vote.qc
293 // =================================
294 set sv_vote_call 1 "Allow users to call a vote for the commands in sv_vote_commands"
295 set sv_vote_change 1 "Allow voters to change their mind after already voting"
296 set sv_vote_commands "restart fraglimit chmap gotomap nextmap endmatch reducematchtime extendmatchtime allready kick cointoss movetoauto shuffleteams" "these commands can be voted"
297 set sv_vote_only_commands ""
298 set sv_vote_limit 160 "Maximum allowed length of a vote command"
299 set sv_vote_master_commands "movetored movetoblue movetoyellow movetopink" "Extra commands which vote masters can execute by themselves, along with the normal sv_vote_commands." // maybe add kickban here (but then sv_vote_master 0)
300 set sv_vote_master 1    "Allows the use of the vote master system"
301 set sv_vote_master_callable 1 "When set, users can use \"vmaster\" to call a vote to become master of voting commands"
302 set sv_vote_master_password "" "when set, users can use \"vlogin PASSWORD\" to log in as master"
303 set sv_vote_master_playerlimit 2 "Minimum number of players needed for a player to be allowed to vote for master"
304 set sv_vote_no_stops_vote 1 "Allow the vote caller to stop his own vote simply by voting no"
305 set sv_vote_singlecount 0       "set to 1 to count votes once after timeout or to 0 to count with every vote"
306 set sv_vote_timeout 30  "a vote will timeout after this many seconds"
307 set sv_vote_wait 120    "a player can not call a vote again for this many seconds when his vote was not accepted"
308 set sv_vote_stop 15     "a player can not call a vote again for this many seconds when he stopped this vote (e.g. to correct it)"
309 set sv_vote_majority_factor 0.5 "What percentage of the PLAYERS constitute a majority? (Must be at least 0.5, recommended: 0.5)"
310 set sv_vote_majority_factor_of_voted 0.5 "What percentage of the VOTERS constitute a majority too? (Must be at least 0.5, recommended: 0.5)"
311 set sv_vote_gamestart 0 "Allow voting during map change"
312 // when disabled, don't allow game type changes "note: set these two equal to JUST support simple majorities"
313 set sv_vote_override_mostrecent 0
314
315 // aliases for client only
316 alias vmaster   "qc_cmd_cmd vote master"
317 alias vlogin    "qc_cmd_cmd vote master login ${* ?}"
318 alias vdo       "qc_cmd_cmd vote master do ${* ?}"
319 alias vyes      "qc_cmd_cl handlevote yes"
320 alias vno       "qc_cmd_cl handlevote no"
321 alias vdontcare "qc_cmd_cmd vote abstain"
322 alias vabstain  "qc_cmd_cmd vote abstain"
323
324 // aliases for both client and server
325 alias vcall     "qc_cmd_svcmd vote call ${* ?}"
326 alias vhelp     "qc_cmd_svcmd vote help"
327 alias vstatus   "qc_cmd_svcmd vote status"
328 alias vstop     "qc_cmd_svcmd vote stop"
329
330 // general
331 alias vmap "vcall gotomap ${1 ?}"
332 alias vnextmap "vcall nextmap ${1 ?}"
333 alias vkick "vcall kick ${1 ?}"
334 alias vkickban "vcall kickban ${1 ?}"
335 alias vend "vcall endmatch"
336 alias vdomap "vdo gotomap ${1 ?}"
337 alias vdokick "vdo kick ${* ?}"
338 alias vdokickban "vdo kickban ${* ?}"
339 alias vdoend "vdo endmatch"
340
341 // ======================
342 //  rcon server commands
343 // ======================
344 rcon_secure 1
345 set rcon_restricted_commands "restart fraglimit chmap gotomap endmatch reducematchtime extendmatchtime allready kick kickban \"sv_cmd bans\" \"sv_cmd unban *\" status \"sv_cmd teamstatus\" movetoauto movetored movetoblue movetoyellow movetopink"