3 #include <common/constants.qh>
4 #include <common/effects/all.qh>
5 #include <common/gamemodes/_mod.qh>
6 #include <common/mapinfo.qh>
7 #include <common/monsters/sv_monsters.qh>
8 #include <common/net_linked.qh>
9 #include <common/notifications/all.qh>
10 #include <common/teams.qh>
11 #include <common/util.qh>
12 #include <server/anticheat.qh>
13 #include <server/bot/api.qh>
14 #include <server/campaign.qh>
15 #include <server/client.qh>
16 #include <server/command/_mod.qh>
17 #include <server/command/banning.qh>
18 #include <server/command/cmd.qh>
19 #include <server/command/common.qh>
20 #include <server/command/getreplies.qh>
21 #include <server/command/radarmap.qh>
22 #include <server/intermission.qh>
23 #include <server/ipban.qh>
24 #include <server/mutators/_mod.qh>
25 #include <server/player.qh>
26 #include <server/teamplay.qh>
27 #include <server/world.qh>
29 // used by GameCommand_make_mapinfo()
30 void make_mapinfo_Think(entity this)
32 if (_MapInfo_FilterGametype(MAPINFO_TYPE_ALL, 0, 0, 0, 1))
34 LOG_INFO("Done rebuiling mapinfos.");
35 MapInfo_FilterGametype(MapInfo_CurrentGametype(), MapInfo_CurrentFeatures(), MapInfo_RequiredFlags(), MapInfo_ForbiddenFlags(), 0);
40 setthink(this, make_mapinfo_Think);
41 this.nextthink = time;
45 // used by GameCommand_extendmatchtime() and GameCommand_reducematchtime()
46 void changematchtime(float delta, float mi, float ma)
52 if (delta == 0) return;
53 if (autocvar_timelimit < 0) return;
55 if (mi <= 10) mi = 10; // at least ten sec in the future
56 cur = time - game_starttime;
57 if (cur > 0) mi += cur; // from current time!
59 lim = autocvar_timelimit * 60;
63 if (lim == 0) return; // cannot increase any further
64 else if (lim < ma) update = min(ma, lim + delta);
65 else // already above maximum: FAIL
70 if (lim == 0) // infinite: try reducing to max, if we are allowed to
72 else if (lim > mi) // above minimum: decrease
73 update = max(mi, lim + delta);
74 else // already below minimum: FAIL
78 cvar_set("timelimit", ftos(update / 60));
82 // =======================
83 // Command Sub-Functions
84 // =======================
86 void GameCommand_adminmsg(int request, int argc)
90 case CMD_REQUEST_COMMAND:
95 string targets = strreplace(",", " ", argv(1));
96 string original_targets = strreplace(" ", ", ", targets);
97 string admin_message = argv(2);
98 float infobartime = stof(argv(3));
100 string successful, t;
101 successful = string_null;
103 if ((targets) && (admin_message))
108 targets = cdr(targets);
110 // Check to see if the player is a valid target
111 client = GetFilteredEntity(t);
112 accepted = VerifyClientEntity(client, true, false);
116 LOG_INFO("adminmsg: ", GetClientErrorString(accepted, t), (targets ? ", skipping to next player.\n" : "."));
120 // send the centerprint/console print or infomessage
123 stuffcmd(client, sprintf("\ninfobar %f \"%s\"\n", infobartime, MakeConsoleSafe(admin_message)));
127 centerprint(client, strcat("^3", GetCallerName(NULL), ":\n^7", admin_message));
128 sprint(client, strcat("\{1}\{13}^3", GetCallerName(NULL), "^7: ", admin_message, "\n"));
131 successful = strcat(successful, (successful ? ", " : ""), playername(client.netname, client.team, false));
132 LOG_TRACE("Message sent to ", playername(client.netname, client.team, false));
136 if (successful) bprint("Successfully sent message '", admin_message, "' to ", successful, ".\n");
137 else LOG_INFO("No players given (", original_targets, ") could receive the message.");
144 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
145 case CMD_REQUEST_USAGE:
147 LOG_HELP("Usage:^3 sv_cmd adminmsg clients \"message\" [infobartime]");
148 LOG_HELP(" 'clients' is a list (separated by commas) of player entity ID's or nicknames");
149 LOG_HELP(" If infobartime is provided, the message will be sent to infobar.");
150 LOG_HELP(" Otherwise, it will just be sent as a centerprint message.");
151 LOG_HELP("Examples: adminmsg 2,4 \"this infomessage will last for ten seconds\" 10");
152 LOG_HELP(" adminmsg 2,5 \"this message will be a centerprint\"");
158 void GameCommand_allready(int request)
162 case CMD_REQUEST_COMMAND:
169 case CMD_REQUEST_USAGE:
171 LOG_HELP("Usage:^3 sv_cmd allready");
172 LOG_HELP(" No arguments required.");
178 void GameCommand_allspec(int request, int argc)
182 case CMD_REQUEST_COMMAND:
184 string reason = argv(1);
186 FOREACH_CLIENT(IS_PLAYER(it) && IS_REAL_CLIENT(it), {
187 if (it.caplayer) it.caplayer = 0;
188 PutObserverInServer(it);
191 if (n) bprint(strcat("Successfully forced all (", ftos(n), ") players to spectate", (reason ? strcat(" for reason: '", reason, "'") : ""), ".\n"));
192 else LOG_INFO("No players found to spectate.");
197 case CMD_REQUEST_USAGE:
199 LOG_HELP("Usage:^3 sv_cmd allspec [reason]");
200 LOG_HELP(" Where 'reason' is an optional argument for explanation of allspec command.");
201 LOG_HELP("See also: ^2moveplayer, shuffleteams^7");
207 void GameCommand_anticheat(int request, int argc)
211 case CMD_REQUEST_COMMAND:
213 entity client = GetIndexedEntity(argc, 1);
214 float accepted = VerifyClientEntity(client, false, false);
218 anticheat_report_to_eventlog(client);
223 LOG_INFO("anticheat: ", GetClientErrorString(accepted, argv(1)), ".");
228 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
229 case CMD_REQUEST_USAGE:
231 LOG_HELP("Usage:^3 sv_cmd anticheat client");
232 LOG_HELP(" 'client' is the entity number or name of the player.");
238 void GameCommand_bbox(int request)
242 case CMD_REQUEST_COMMAND:
244 vector size_min = '0 0 0';
245 vector size_max = '0 0 0';
246 tracebox('1 0 0' * world.absmin.x,
247 '0 1 0' * world.absmin.y + '0 0 1' * world.absmin.z,
248 '0 1 0' * world.absmax.y + '0 0 1' * world.absmax.z,
249 '1 0 0' * world.absmax.x,
252 size_min.x = (trace_startsolid) ? world.absmin.x : trace_endpos.x;
254 tracebox('0 1 0' * world.absmin.y,
255 '1 0 0' * world.absmin.x + '0 0 1' * world.absmin.z,
256 '1 0 0' * world.absmax.x + '0 0 1' * world.absmax.z,
257 '0 1 0' * world.absmax.y,
260 size_min.y = (trace_startsolid) ? world.absmin.y : trace_endpos.y;
262 tracebox('0 0 1' * world.absmin.z,
263 '1 0 0' * world.absmin.x + '0 1 0' * world.absmin.y,
264 '1 0 0' * world.absmax.x + '0 1 0' * world.absmax.y,
265 '0 0 1' * world.absmax.z,
268 size_min.z = (trace_startsolid) ? world.absmin.z : trace_endpos.z;
270 tracebox('1 0 0' * world.absmax.x,
271 '0 1 0' * world.absmin.y + '0 0 1' * world.absmin.z,
272 '0 1 0' * world.absmax.y + '0 0 1' * world.absmax.z,
273 '1 0 0' * world.absmin.x,
276 size_max.x = (trace_startsolid) ? world.absmax.x : trace_endpos.x;
278 tracebox('0 1 0' * world.absmax.y,
279 '1 0 0' * world.absmin.x + '0 0 1' * world.absmin.z,
280 '1 0 0' * world.absmax.x + '0 0 1' * world.absmax.z,
281 '0 1 0' * world.absmin.y,
284 size_max.y = (trace_startsolid) ? world.absmax.y : trace_endpos.y;
286 tracebox('0 0 1' * world.absmax.z,
287 '1 0 0' * world.absmin.x + '0 1 0' * world.absmin.y,
288 '1 0 0' * world.absmax.x + '0 1 0' * world.absmax.y,
289 '0 0 1' * world.absmin.z,
292 size_max.z = (trace_startsolid) ? world.absmax.z : trace_endpos.z;
294 LOG_INFOF("Original size: %v %v", world.absmin, world.absmax);
295 LOG_INFOF("Currently set size: %v %v", world.mins, world.maxs);
296 LOG_INFOF("Solid bounding box size: %v %v", size_min, size_max);
301 case CMD_REQUEST_USAGE:
303 LOG_HELP("Usage:^3 sv_cmd bbox");
304 LOG_HELP(" No arguments required.");
305 LOG_HELP("See also: ^2gettaginfo, trace^7");
311 void GameCommand_bot_cmd(int request, int argc, string command)
315 case CMD_REQUEST_COMMAND:
319 if (argv(1) == "reset")
324 else if (argv(1) == "setbots")
326 cvar_settemp("bot_vs_human", "0");
327 cvar_settemp("minplayers", "0");
328 cvar_settemp("minplayers_per_team", "0");
329 cvar_settemp("bot_number", "0");
331 cvar_settemp("bot_number", argv(2));
332 if (!bot_fixcount()) LOG_INFO("Sorry, could not set requested bot count");
335 else if (argv(1) == "load" && argc == 3)
339 fh = fopen(argv(2), FILE_READ);
342 LOG_INFO("cannot open the file");
347 while ((s = fgets(fh)))
349 argc = tokenize_console(s);
351 if (argc >= 3 && argv(0) == "sv_cmd" && argv(1) == "bot_cmd")
353 if (argv(2) == "reset")
357 else if (argv(2) == "setbots")
359 cvar_settemp("bot_vs_human", "0");
360 cvar_settemp("minplayers", "0");
361 cvar_settemp("minplayers_per_team", "0");
362 cvar_settemp("bot_number", "0");
364 cvar_settemp("bot_number", argv(3));
365 if (!bot_fixcount()) LOG_INFO("Sorry, could not set requested bot count");
369 if(argv(2) == "*" || argv(2) == "all")
370 FOREACH_CLIENT(IS_BOT_CLIENT(it), {
371 bot_queuecommand(it, substring(s, argv_start_index(3), -1));
375 bot = find_bot_by_number(stof(argv(2)));
376 if (bot == NULL) bot = find_bot_by_name(argv(2));
377 if (bot) bot_queuecommand(bot, substring(s, argv_start_index(3), -1));
383 localcmd(strcat(s, "\n"));
388 LOG_INFO(ftos(i), " commands read");
392 else if (argv(1) == "help")
394 if (argv(2)) bot_cmdhelp(argv(2));
395 else bot_list_commands();
398 else if (argc >= 3) // this comes last
400 if(argv(1) == "*" || argv(1) == "all")
403 FOREACH_CLIENT(IS_BOT_CLIENT(it), {
404 bot_queuecommand(it, substring(command, argv_start_index(2), -1));
408 LOG_INFO("Command '", substring(command, argv_start_index(2), -1), "' sent to all bots (", ftos(bot_num), ")");
413 bot = find_bot_by_number(stof(argv(1)));
414 if (bot == NULL) bot = find_bot_by_name(argv(1));
417 LOG_INFO("Command '", substring(command, argv_start_index(2), -1), "' sent to bot ", bot.netname);
418 bot_queuecommand(bot, substring(command, argv_start_index(2), -1));
423 LOG_INFO("Error: Can't find bot with the name or id '", argv(1), "' - Did you mistype the command?"); // don't return so that usage is shown
430 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
431 case CMD_REQUEST_USAGE:
433 LOG_HELP("Usage:^3 sv_cmd bot_cmd client command [argument]");
434 LOG_HELP(" 'client' can be either the name of the bot or a progressive number (not the entity number!)");
435 LOG_HELP(" can also be '*' or 'all' to allow sending the command to all the bots");
436 LOG_HELP(" For full list of commands, see bot_cmd help [command].");
437 LOG_HELP("Examples: sv_cmd bot_cmd 1 cc \"say something\"");
438 LOG_HELP(" sv_cmd bot_cmd 1 presskey jump");
439 LOG_HELP(" sv_cmd bot_cmd * pause");
445 void GameCommand_cointoss(int request, int argc)
449 case CMD_REQUEST_COMMAND:
451 string result1 = (argv(2) ? strcat("^7", argv(1)) : "^1HEADS");
452 string result2 = (argv(2) ? strcat("^7", argv(2)) : "^4TAILS");
453 string choice = ((random() > 0.5) ? result1 : result2);
455 Send_Notification(NOTIF_ALL, NULL, MSG_MULTI, MULTI_COINTOSS, choice);
460 case CMD_REQUEST_USAGE:
462 LOG_HELP("Usage:^3 sv_cmd cointoss [result1 result2]");
463 LOG_HELP(" Where 'result1' and 'result2' are user created options.");
469 void GameCommand_database(int request, int argc)
473 case CMD_REQUEST_COMMAND:
477 if (argv(1) == "save")
479 db_save(ServerProgsDB, argv(2));
480 LOG_INFO("Copied serverprogs database to '", argv(2), "' in the data directory.");
483 else if (argv(1) == "dump")
485 db_dump(ServerProgsDB, argv(2));
486 LOG_INFO("DB dumped."); // wtf does this do?
489 else if (argv(1) == "load")
491 db_close(ServerProgsDB);
492 ServerProgsDB = db_load(argv(2));
493 LOG_INFO("Loaded '", argv(2), "' as new serverprogs database.");
500 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
501 case CMD_REQUEST_USAGE:
503 LOG_HELP("Usage:^3 sv_cmd database action filename");
504 LOG_HELP(" Where 'action' is the command to complete,");
505 LOG_HELP(" and 'filename' is what it acts upon.");
506 LOG_HELP(" Full list of commands here: \"save, dump, load.\"");
512 void GameCommand_defer_clear(int request, int argc)
516 case CMD_REQUEST_COMMAND:
523 client = GetIndexedEntity(argc, 1);
524 accepted = VerifyClientEntity(client, true, false);
528 stuffcmd(client, "defer clear\n");
529 LOG_INFO("defer clear stuffed to ", playername(client.netname, client.team, false));
531 else { LOG_INFO("defer_clear: ", GetClientErrorString(accepted, argv(1)), "."); }
538 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
539 case CMD_REQUEST_USAGE:
541 LOG_HELP("Usage:^3 sv_cmd defer_clear client");
542 LOG_HELP(" 'client' is the entity number or name of the player.");
543 LOG_HELP("See also: ^2defer_clear_all^7");
549 void GameCommand_defer_clear_all(int request)
553 case CMD_REQUEST_COMMAND:
558 FOREACH_CLIENT(true, {
559 argc = tokenize_console(strcat("defer_clear ", ftos(etof(it))));
560 GameCommand_defer_clear(CMD_REQUEST_COMMAND, argc);
563 if (n) LOG_INFO("Successfully stuffed defer clear to all clients (", ftos(n), ")"); // should a message be added if no players were found?
568 case CMD_REQUEST_USAGE:
570 LOG_HELP("Usage:^3 sv_cmd defer_clear_all");
571 LOG_HELP(" No arguments required.");
572 LOG_HELP("See also: ^2defer_clear^7");
578 void GameCommand_delrec(int request, int argc) // perhaps merge later with records and printstats and such?
582 case CMD_REQUEST_COMMAND:
586 if (argv(2)) race_deleteTime(argv(2), stof(argv(1)));
587 else race_deleteTime(GetMapname(), stof(argv(1)));
593 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
594 case CMD_REQUEST_USAGE:
596 LOG_HELP("Usage:^3 sv_cmd delrec ranking [map]");
597 LOG_HELP(" 'ranking' is which ranking level to clear up to, ");
598 LOG_HELP(" it will clear all records up to nth place.");
599 LOG_HELP(" if 'map' is not provided it will use current map.");
605 void print_Effect_Index(int d, string effect_name)
607 // this is inside a function to avoid expanding it on compilation everytime
608 LOG_INFO("effect ", effect_name, " is ", ftos(_particleeffectnum(effect_name)), "\n");
609 db_put(d, effect_name, "1");
612 void GameCommand_effectindexdump(int request)
616 case CMD_REQUEST_COMMAND:
622 LOG_INFO("begin of effects list");
624 print_Effect_Index(d, "TE_GUNSHOT");
625 print_Effect_Index(d, "TE_GUNSHOTQUAD");
626 print_Effect_Index(d, "TE_SPIKE");
627 print_Effect_Index(d, "TE_SPIKEQUAD");
628 print_Effect_Index(d, "TE_SUPERSPIKE");
629 print_Effect_Index(d, "TE_SUPERSPIKEQUAD");
630 print_Effect_Index(d, "TE_WIZSPIKE");
631 print_Effect_Index(d, "TE_KNIGHTSPIKE");
632 print_Effect_Index(d, "TE_EXPLOSION");
633 print_Effect_Index(d, "TE_EXPLOSIONQUAD");
634 print_Effect_Index(d, "TE_TAREXPLOSION");
635 print_Effect_Index(d, "TE_TELEPORT");
636 print_Effect_Index(d, "TE_LAVASPLASH");
637 print_Effect_Index(d, "TE_SMALLFLASH");
638 print_Effect_Index(d, "TE_FLAMEJET");
639 print_Effect_Index(d, "EF_FLAME");
640 print_Effect_Index(d, "TE_BLOOD");
641 print_Effect_Index(d, "TE_SPARK");
642 print_Effect_Index(d, "TE_PLASMABURN");
643 print_Effect_Index(d, "TE_TEI_G3");
644 print_Effect_Index(d, "TE_TEI_SMOKE");
645 print_Effect_Index(d, "TE_TEI_BIGEXPLOSION");
646 print_Effect_Index(d, "TE_TEI_PLASMAHIT");
647 print_Effect_Index(d, "EF_STARDUST");
648 print_Effect_Index(d, "TR_ROCKET");
649 print_Effect_Index(d, "TR_GRENADE");
650 print_Effect_Index(d, "TR_BLOOD");
651 print_Effect_Index(d, "TR_WIZSPIKE");
652 print_Effect_Index(d, "TR_SLIGHTBLOOD");
653 print_Effect_Index(d, "TR_KNIGHTSPIKE");
654 print_Effect_Index(d, "TR_VORESPIKE");
655 print_Effect_Index(d, "TR_NEHAHRASMOKE");
656 print_Effect_Index(d, "TR_NEXUIZPLASMA");
657 print_Effect_Index(d, "TR_GLOWTRAIL");
658 print_Effect_Index(d, "TR_SEEKER");
659 print_Effect_Index(d, "SVC_PARTICLE");
661 fh = fopen("effectinfo.txt", FILE_READ);
662 while ((s = fgets(fh)))
665 if (argv(0) == "effect")
667 if (db_get(d, argv(1)) != "1")
669 int i = _particleeffectnum(argv(1));
670 if (i >= 0) LOG_INFO("effect ", argv(1), " is ", ftos(i));
671 db_put(d, argv(1), "1");
675 LOG_INFO("end of effects list");
682 case CMD_REQUEST_USAGE:
684 LOG_HELP("Usage:^3 sv_cmd effectindexdump");
685 LOG_HELP(" No arguments required.");
691 void GameCommand_extendmatchtime(int request)
695 case CMD_REQUEST_COMMAND:
697 changematchtime(autocvar_timelimit_increment * 60, autocvar_timelimit_min * 60, autocvar_timelimit_max * 60);
702 case CMD_REQUEST_USAGE:
704 LOG_HELP("Usage:^3 sv_cmd extendmatchtime");
705 LOG_HELP(" No arguments required.");
706 LOG_HELP("See also: ^2reducematchtime^7");
712 void GameCommand_gametype(int request, int argc)
716 case CMD_REQUEST_COMMAND:
721 Gametype t = MapInfo_Type_FromString(s, false), tsave = MapInfo_CurrentGametype();
725 MapInfo_SwitchGameType(t);
726 MapInfo_FilterGametype(MapInfo_CurrentGametype(), MapInfo_CurrentFeatures(), MapInfo_RequiredFlags(), MapInfo_ForbiddenFlags(), 0);
727 if (MapInfo_count > 0)
729 // update lsmaps in case the gametype changed, this way people can easily list maps for it
730 if (lsmaps_reply != "") strunzone(lsmaps_reply);
731 lsmaps_reply = strzone(getlsmaps());
732 bprint("Game type successfully switched to ", s, "\n");
736 bprint("Cannot use this game type: no map for it found\n");
737 MapInfo_SwitchGameType(tsave);
738 MapInfo_FilterGametype(MapInfo_CurrentGametype(), MapInfo_CurrentFeatures(), MapInfo_RequiredFlags(), MapInfo_ForbiddenFlags(), 0);
743 bprint("Game type switch to ", s, " failed: this type does not exist!\n");
751 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
752 case CMD_REQUEST_USAGE:
754 LOG_HELP("Usage:^3 sv_cmd gametype mode");
755 LOG_HELP(" Where 'mode' is the gametype mode to switch to.");
756 LOG_HELP("See also: ^2gotomap^7");
762 void GameCommand_gettaginfo(int request, int argc)
766 case CMD_REQUEST_COMMAND:
774 tmp_entity = spawn();
777 .entity weaponentity = weaponentities[0];
778 _setmodel(tmp_entity, (nextent(NULL)).(weaponentity).model);
782 precache_model(argv(1));
783 _setmodel(tmp_entity, argv(1));
785 tmp_entity.frame = stof(argv(2));
786 if (substring(argv(3), 0, 1) == "#") i = stof(substring(argv(3), 1, -1));
787 else i = gettagindex(tmp_entity, argv(3));
790 v = gettaginfo(tmp_entity, i);
792 "model %s frame %s tag %s index %s parent %s",
793 tmp_entity.model, ftos(tmp_entity.frame), gettaginfo_name, ftos(i), ftos(gettaginfo_parent)
795 LOG_INFOF(" vector = %s %s %s", ftos(v.x), ftos(v.y), ftos(v.z));
796 LOG_INFOF(" offset = %s %s %s", ftos(gettaginfo_offset.x), ftos(gettaginfo_offset.y), ftos(gettaginfo_offset.z));
797 LOG_INFOF(" forward = %s %s %s", ftos(gettaginfo_forward.x), ftos(gettaginfo_forward.y), ftos(gettaginfo_forward.z));
798 LOG_INFOF(" right = %s %s %s", ftos(gettaginfo_right.x), ftos(gettaginfo_right.y), ftos(gettaginfo_right.z));
799 LOG_INFOF(" up = %s %s %s", ftos(gettaginfo_up.x), ftos(gettaginfo_up.y), ftos(gettaginfo_up.z));
803 localcmd(strcat(argv(4), vtos(v), argv(5), "\n"));
808 LOG_INFO("bone not found");
817 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
818 case CMD_REQUEST_USAGE:
820 LOG_HELP("Usage:^3 sv_cmd gettaginfo model frame index [command one] [command two]");
821 LOG_HELP("See also: ^2bbox, trace^7");
827 void GameCommand_animbench(int request, int argc)
831 case CMD_REQUEST_COMMAND:
837 tmp_entity = spawn();
840 .entity weaponentity = weaponentities[0];
841 _setmodel(tmp_entity, (nextent(NULL)).(weaponentity).model);
845 precache_model(argv(1));
846 _setmodel(tmp_entity, argv(1));
848 float f1 = stof(argv(2));
849 float f2 = stof(argv(3));
857 tmp_entity.frame = f1;
858 t0 = gettime(GETTIME_HIRES);
859 getsurfacepoint(tmp_entity, 0, 0);
860 t1 += gettime(GETTIME_HIRES) - t0;
861 tmp_entity.frame = f2;
862 t0 = gettime(GETTIME_HIRES);
863 getsurfacepoint(tmp_entity, 0, 0);
864 t2 += gettime(GETTIME_HIRES) - t0;
867 LOG_INFO("model ", tmp_entity.model, " frame ", ftos(f1), " animtime ", ftos(n / t1), "/s");
868 LOG_INFO("model ", tmp_entity.model, " frame ", ftos(f2), " animtime ", ftos(n / t2), "/s");
876 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
877 case CMD_REQUEST_USAGE:
879 LOG_HELP("Usage:^3 sv_cmd animbench <model> <frame1> <frame2>");
880 LOG_HELP("See also: ^2bbox, trace^7");
886 void GameCommand_gotomap(int request, int argc)
890 case CMD_REQUEST_COMMAND:
894 LOG_INFO(GotoMap(argv(1)));
900 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
901 case CMD_REQUEST_USAGE:
903 LOG_HELP("Usage:^3 sv_cmd gotomap map");
904 LOG_HELP(" Where 'map' is the *.bsp file to change to.");
905 LOG_HELP("See also: ^2gametype^7");
911 void GameCommand_lockteams(int request)
915 case CMD_REQUEST_COMMAND:
920 bprint("^1The teams are now locked.\n");
924 bprint("lockteams command can only be used in a team-based gamemode.\n");
930 case CMD_REQUEST_USAGE:
932 LOG_HELP("Usage:^3 sv_cmd lockteams");
933 LOG_HELP(" No arguments required.");
934 LOG_HELP("See also: ^2unlockteams^7");
940 void GameCommand_make_mapinfo(int request)
944 case CMD_REQUEST_COMMAND:
948 tmp_entity = new(make_mapinfo);
949 setthink(tmp_entity, make_mapinfo_Think);
950 tmp_entity.nextthink = time;
956 case CMD_REQUEST_USAGE:
958 LOG_HELP("Usage:^3 sv_cmd make_mapinfo");
959 LOG_HELP(" No arguments required.");
960 LOG_HELP("See also: ^2radarmap^7");
966 void GameCommand_moveplayer(int request, int argc)
970 case CMD_REQUEST_COMMAND:
975 string targets = strreplace(",", " ", argv(1));
976 string original_targets = strreplace(" ", ", ", targets);
977 string destination = argv(2);
979 string successful, t;
980 successful = string_null;
982 // lets see if the target(s) even actually exist.
983 if ((targets) && (destination))
988 targets = cdr(targets);
990 // Check to see if the player is a valid target
991 client = GetFilteredEntity(t);
992 accepted = VerifyClientEntity(client, false, false);
996 LOG_INFO("moveplayer: ", GetClientErrorString(accepted, t), (targets ? ", skipping to next player.\n" : "."));
1000 // Where are we putting this player?
1001 if (destination == "spec" || destination == "spectator")
1003 if (!IS_SPEC(client) && !IS_OBSERVER(client))
1005 if (client.caplayer) client.caplayer = 0;
1006 PutObserverInServer(client);
1008 successful = strcat(successful, (successful ? ", " : ""), playername(client.netname, client.team, false));
1012 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", playername(client.netname, client.team, false), ") is already spectating.");
1018 if (!IS_SPEC(client) && !IS_OBSERVER(client))
1023 int save = Player_GetForcedTeamIndex(client);
1024 Player_SetForcedTeamIndex(client, TEAM_FORCE_DEFAULT);
1026 // find the team to move the player to
1027 int team_num = Team_ColorToTeam(destination);
1029 if (team_num == client.team) // already on the destination team
1031 // keep the forcing undone
1032 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", playername(client.netname, client.team, false), ") is already on the ", Team_ColoredFullName(client.team), (targets ? "^7, skipping to next player.\n" : "^7."));
1035 else if (team_num == 0) // auto team
1037 balance = TeamBalance_CheckAllowedTeams(client);
1038 team_num = Team_IndexToTeam(TeamBalance_FindBestTeam(balance, client, false));
1042 balance = TeamBalance_CheckAllowedTeams(client);
1044 Player_SetForcedTeamIndex(client, save);
1046 // Check to see if the destination team is even available
1047 int team_id = Team_TeamToIndex(team_num);
1050 LOG_INFO("Sorry, can't move player here if team ", destination, " doesn't exist.");
1051 TeamBalance_Destroy(balance);
1054 if (!TeamBalance_IsTeamAllowed(balance, team_id))
1056 LOG_INFOF("Sorry, can't move player to %s team if it doesn't exist.", destination);
1057 TeamBalance_Destroy(balance);
1060 TeamBalance_Destroy(balance);
1062 // If so, lets continue and finally move the player
1063 Player_SetForcedTeamIndex(client, TEAM_FORCE_DEFAULT);
1064 if (MoveToTeam(client, team_id, 6))
1066 successful = strcat(successful, (successful ? ", " : ""), playername(client.netname, client.team, false));
1067 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", playername(client.netname, client.team, false), ") has been moved to the ", Team_ColoredFullName(team_id), "^7.");
1071 LOG_INFO("Unable to move player ", ftos(GetFilteredNumber(t)), " (", playername(client.netname, client.team, false), ")");
1077 LOG_INFO("Can't change teams when currently not playing a team game.");
1083 LOG_INFO("Can't change teams if the player isn't in the game."); // well technically we could, but should we allow that? :P
1089 if (successful) bprint("Successfully moved players ", successful, " to destination ", destination, ".\n");
1090 else LOG_INFO("No players given (", original_targets, ") are able to move.");
1092 return; // still correct parameters so return to avoid usage print
1097 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1098 case CMD_REQUEST_USAGE:
1100 LOG_HELP("Usage:^3 sv_cmd moveplayer clients destination");
1101 LOG_HELP(" 'clients' is a list (separated by commas) of player entity ID's or nicknames");
1102 LOG_HELP(" 'destination' is what to send the player to, be it team or spectating");
1103 LOG_HELP(" Full list of destinations here: \"spec, spectator, red, blue, yellow, pink, auto.\"");
1104 LOG_HELP("Examples: sv_cmd moveplayer 1,3,5 red");
1105 LOG_HELP(" sv_cmd moveplayer 2 spec");
1106 LOG_HELP("See also: ^2allspec, shuffleteams^7");
1112 void GameCommand_nospectators(int request)
1116 case CMD_REQUEST_COMMAND:
1118 blockSpectators = 1;
1119 // give every spectator <g_maxplayers_spectator_blocktime> seconds time to become a player
1120 FOREACH_CLIENT(IS_REAL_CLIENT(it) && (IS_SPEC(it) || IS_OBSERVER(it)) && !it.caplayer, {
1123 CS(it).spectatortime = time;
1124 Send_Notification(NOTIF_ONE_ONLY, it, MSG_INFO, INFO_SPECTATE_WARNING, autocvar_g_maxplayers_spectator_blocktime);
1127 bprint(strcat("^7All spectators will be automatically kicked when not joining the game after ", ftos(autocvar_g_maxplayers_spectator_blocktime), " seconds!\n"));
1132 case CMD_REQUEST_USAGE:
1134 LOG_HELP("Usage:^3 sv_cmd nospectators");
1135 LOG_HELP(" No arguments required.");
1141 void GameCommand_printstats(int request)
1145 case CMD_REQUEST_COMMAND:
1148 LOG_INFO("stats dumped.");
1153 case CMD_REQUEST_USAGE:
1155 LOG_HELP("Usage:^3 sv_cmd printstats");
1156 LOG_HELP(" No arguments required.");
1162 void GameCommand_radarmap(int request, int argc)
1166 case CMD_REQUEST_COMMAND:
1168 if (RadarMap_Make(argc)) return;
1172 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1173 case CMD_REQUEST_USAGE:
1175 LOG_HELP("Usage:^3 sv_cmd radarmap [--force] [--loop] [--quit] [--block | --trace | --sample | --lineblock] [--sharpen N] [--res W H] [--qual Q]");
1176 LOG_HELP(" The quality factor Q is roughly proportional to the time taken.");
1177 LOG_HELP(" trace supports no quality factor; its result should look like --block with infinite quality factor.");
1178 LOG_HELP("See also: ^2make_mapinfo^7");
1184 void GameCommand_reducematchtime(int request)
1188 case CMD_REQUEST_COMMAND:
1190 changematchtime(autocvar_timelimit_decrement * -60, autocvar_timelimit_min * 60, autocvar_timelimit_max * 60);
1195 case CMD_REQUEST_USAGE:
1197 LOG_HELP("Usage:^3 sv_cmd reducematchtime");
1198 LOG_HELP(" No arguments required.");
1199 LOG_HELP("See also: ^2extendmatchtime^7");
1205 void GameCommand_setbots(int request, int argc)
1209 case CMD_REQUEST_COMMAND:
1213 cvar_settemp("minplayers", "0");
1214 cvar_settemp("minplayers_per_team", "0");
1215 cvar_settemp("bot_number", argv(1));
1222 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1223 case CMD_REQUEST_USAGE:
1225 LOG_HELP("Usage:^3 sv_cmd setbots botnumber");
1226 LOG_HELP(" Where 'botnumber' is the amount of bots to set bot_number cvar to.");
1227 LOG_HELP("See also: ^2bot_cmd^7");
1237 LOG_INFO("Can't shuffle teams when currently not playing a team game.");
1241 FOREACH_CLIENT(IS_PLAYER(it) || it.caplayer, {
1242 if (Player_HasRealForcedTeam(it)) {
1243 // we could theoretically assign forced players to their teams
1244 // and shuffle the rest to fill the empty spots but in practise
1245 // either all players or none are gonna have forced teams
1246 LOG_INFO("Can't shuffle teams because at least one player has a forced team.");
1251 int number_of_teams = 0;
1252 entity balance = TeamBalance_CheckAllowedTeams(NULL);
1253 for (int i = 1; i <= NUM_TEAMS; ++i)
1255 if (TeamBalance_IsTeamAllowed(balance, i))
1257 number_of_teams = max(i, number_of_teams);
1260 TeamBalance_Destroy(balance);
1263 FOREACH_CLIENT_RANDOM(IS_PLAYER(it) || it.caplayer, {
1264 int target_team_index = team_index + 1;
1265 if (Entity_GetTeamIndex(it) != target_team_index)
1267 MoveToTeam(it, target_team_index, 6);
1269 team_index = (team_index + 1) % number_of_teams;
1272 bprint("Successfully shuffled the players around randomly.\n");
1275 void GameCommand_shuffleteams(int request)
1279 case CMD_REQUEST_COMMAND:
1281 if (shuffleteams_on_reset_map)
1283 bprint("Players will be shuffled when this round is over.\n");
1284 shuffleteams_on_reset_map = true;
1292 case CMD_REQUEST_USAGE:
1294 LOG_HELP("Usage:^3 sv_cmd shuffleteams");
1295 LOG_HELP(" No arguments required.");
1296 LOG_HELP("See also: ^2moveplayer, allspec^7");
1302 void GameCommand_stuffto(int request, int argc)
1304 // This... is a fairly dangerous and powerful command... - It allows any arguments to be sent to a client via rcon.
1305 // Because of this, it is disabled by default and must be enabled by the server owner when doing compilation. That way,
1306 // we can be certain they understand the risks of it... So to enable, compile server with -DSTUFFTO_ENABLED argument.
1308 #ifdef STUFFTO_ENABLED
1311 case CMD_REQUEST_COMMAND:
1315 entity client = GetIndexedEntity(argc, 1);
1316 float accepted = VerifyClientEntity(client, true, false);
1320 stuffcmd(client, strcat("\n", argv(next_token), "\n"));
1321 LOG_INFO("Command: \"", argv(next_token), "\" sent to ", GetCallerName(client), " (", argv(1), ").");
1325 LOG_INFO("stuffto: ", GetClientErrorString(accepted, argv(1)), ".");
1333 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1334 case CMD_REQUEST_USAGE:
1336 LOG_HELP("Usage:^3 sv_cmd stuffto client \"command\"");
1337 LOG_HELP(" 'client' is the entity number or name of the player,");
1338 LOG_HELP(" and 'command' is the command to be sent to that player.");
1345 LOG_HELP("stuffto command is not enabled on this server.");
1351 void GameCommand_trace(int request, int argc)
1355 case CMD_REQUEST_COMMAND:
1358 vector org, delta, start, end, p, q, q0, pos, vv, dv;
1359 float i, f, safe, unsafe, dq, dqf;
1366 LOG_INFO("TEST CASE. If this returns the runaway loop counter error, possibly everything is oaky.");
1367 float worst_endpos_bug = 0;
1371 delta = world.maxs - world.mins;
1373 start.x = org.x + random() * delta.x;
1374 start.y = org.y + random() * delta.y;
1375 start.z = org.z + random() * delta.z;
1377 end.x = org.x + random() * delta.x;
1378 end.y = org.y + random() * delta.y;
1379 end.z = org.z + random() * delta.z;
1381 start = stov(vtos(start));
1382 end = stov(vtos(end));
1384 tracebox(start, PL_MIN_CONST, PL_MAX_CONST, end, MOVE_NOMONSTERS, NULL);
1385 if (!trace_startsolid && trace_fraction < 1)
1388 tracebox(p, PL_MIN_CONST, PL_MAX_CONST, p, MOVE_NOMONSTERS, NULL);
1389 if (trace_startsolid)
1391 rint(42); // do an engine breakpoint on VM_rint so you can get the trace that errnoeously returns startsolid
1392 tracebox(start, PL_MIN_CONST, PL_MAX_CONST, end, MOVE_NOMONSTERS, NULL);
1394 // how much do we need to back off?
1399 pos = p * (1 - (safe + unsafe) * 0.5) + start * ((safe + unsafe) * 0.5);
1400 tracebox(pos, PL_MIN_CONST, PL_MAX_CONST, pos, MOVE_NOMONSTERS, NULL);
1401 if (trace_startsolid)
1403 if ((safe + unsafe) * 0.5 == unsafe) break;
1404 unsafe = (safe + unsafe) * 0.5;
1408 if ((safe + unsafe) * 0.5 == safe) break;
1409 safe = (safe + unsafe) * 0.5;
1413 LOG_INFO("safe distance to back off: ", ftos(safe * vlen(p - start)), "qu");
1414 LOG_INFO("unsafe distance to back off: ", ftos(unsafe * vlen(p - start)), "qu");
1416 tracebox(p, PL_MIN_CONST + '0.1 0.1 0.1', PL_MAX_CONST - '0.1 0.1 0.1', p, MOVE_NOMONSTERS, NULL);
1417 if (trace_startsolid) LOG_INFO("trace_endpos much in solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1418 else LOG_INFO("trace_endpos just in solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1419 if (++hitcount >= 10) break;
1428 q = p + normalize(end - p) * (dq + dqf);
1430 tracebox(p, PL_MIN_CONST, PL_MAX_CONST, q, MOVE_NOMONSTERS, NULL);
1431 if (trace_startsolid) error("THIS ONE cannot happen");
1432 if (trace_fraction > 0) dq += dqf * trace_fraction;
1436 if (dq > worst_endpos_bug)
1438 worst_endpos_bug = dq;
1439 LOG_INFO("trace_endpos still before solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1440 LOG_INFO("could go ", ftos(dq), " units further to ", vtos(q));
1441 if (++hitcount >= 10) break;
1452 tracebox(e.origin + '0 0 32', e.mins, e.maxs, e.origin + '0 0 -1024', MOVE_NORMAL, e);
1454 if (trace_fraction == 1)
1456 LOG_INFO("not above ground, aborting");
1460 for (i = 0; i < 100000; ++i)
1463 if (dv.z > 0) dv = -1 * dv;
1464 tracebox(vv, e.mins, e.maxs, vv + dv, MOVE_NORMAL, e);
1465 if (trace_startsolid) LOG_INFO("bug 1");
1466 if (trace_fraction == 1)
1470 LOG_INFO("bug 2: ", ftos(dv.x), " ", ftos(dv.y), " ", ftos(dv.z));
1471 LOG_INFO(" (", ftos(asin(dv.z / vlen(dv)) * 180 / M_PI), " degrees)");
1476 LOG_INFO("highest possible dist: ", ftos(f));
1482 if (argc == 4 || argc == 5)
1485 int dphitcontentsmask_save = e.dphitcontentsmask;
1486 e.dphitcontentsmask = DPCONTENTS_SOLID | DPCONTENTS_BODY | DPCONTENTS_PLAYERCLIP | DPCONTENTS_BOTCLIP;
1487 if (tracewalk(e, stov(argv(2)), e.mins, e.maxs, stov(argv(3)), stof(argv(4)), MOVE_NORMAL))
1488 LOG_INFO("can walk");
1490 LOG_INFO("cannot walk");
1491 e.dphitcontentsmask = dphitcontentsmask_save;
1502 traceline(vv, dv, MOVE_NORMAL, NULL);
1503 __trailparticles(NULL, particleeffectnum(EFFECT_TR_NEXUIZPLASMA), vv, trace_endpos);
1504 __trailparticles(NULL, particleeffectnum(EFFECT_TR_CRYLINKPLASMA), trace_endpos, dv);
1509 // no default case, just go straight to invalid
1514 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1515 case CMD_REQUEST_USAGE:
1517 LOG_HELP("Usage:^3 sv_cmd trace command [startpos endpos] [endpos_height]");
1518 LOG_HELP(" Where startpos and endpos are parameters for 'walk' and 'showline' commands,");
1519 LOG_HELP(" 'endpos_height' is an optional parameter for 'walk' command,");
1520 LOG_HELP(" Full list of commands here: \"debug, debug2, walk, showline.\"");
1521 LOG_HELP("See also: ^2bbox, gettaginfo^7");
1527 void GameCommand_unlockteams(int request)
1531 case CMD_REQUEST_COMMAND:
1536 bprint("^1The teams are now unlocked.\n");
1540 bprint("unlockteams command can only be used in a team-based gamemode.\n");
1546 case CMD_REQUEST_USAGE:
1548 LOG_HELP("Usage:^3 sv_cmd unlockteams");
1549 LOG_HELP(" No arguments required.");
1550 LOG_HELP("See also: ^2lockteams^7");
1556 void GameCommand_warp(int request, int argc)
1560 case CMD_REQUEST_COMMAND:
1562 if (autocvar_g_campaign)
1566 CampaignLevelWarp(stof(argv(1)));
1567 LOG_INFO("Successfully warped to campaign level ", argv(1), ".");
1571 CampaignLevelWarp(-1);
1572 LOG_INFO("Successfully warped to next campaign level.");
1577 LOG_INFO("Not in campaign, can't level warp");
1583 case CMD_REQUEST_USAGE:
1585 LOG_HELP("Usage:^3 sv_cmd warp [level]");
1586 LOG_HELP(" 'level' is the level to change campaign mode to.");
1587 LOG_HELP(" if 'level' is not provided it will change to the next level.");
1593 /* use this when creating a new command, making sure to place it in alphabetical order... also,
1594 ** ADD ALL NEW COMMANDS TO commands.cfg WITH PROPER ALIASES IN THE SAME FASHION!
1595 void GameCommand_(int request)
1599 case CMD_REQUEST_COMMAND:
1606 case CMD_REQUEST_USAGE:
1608 LOG_HELP("Usage:^3 sv_cmd ");
1609 LOG_HELP(" No arguments required.");
1617 // ==================================
1618 // Macro system for server commands
1619 // ==================================
1621 // Do not hard code aliases for these, instead create them in commands.cfg... also: keep in alphabetical order, please ;)
1622 SERVER_COMMAND(adminmsg, "Send an admin message to a client directly") { GameCommand_adminmsg(request, arguments); }
1623 SERVER_COMMAND(allready, "Restart the server and reset the players") { GameCommand_allready(request); }
1624 SERVER_COMMAND(allspec, "Force all players to spectate") { GameCommand_allspec(request, arguments); }
1625 SERVER_COMMAND(anticheat, "Create an anticheat report for a client") { GameCommand_anticheat(request, arguments); }
1626 SERVER_COMMAND(animbench, "Benchmark model animation (LAGS)") { GameCommand_animbench(request, arguments); }
1627 SERVER_COMMAND(bbox, "Print detailed information about world size") { GameCommand_bbox(request); }
1628 SERVER_COMMAND(bot_cmd, "Control and send commands to bots") { GameCommand_bot_cmd(request, arguments, command); }
1629 SERVER_COMMAND(cointoss, "Flip a virtual coin and give random result") { GameCommand_cointoss(request, arguments); }
1630 SERVER_COMMAND(database, "Extra controls of the serverprogs database") { GameCommand_database(request, arguments); }
1631 SERVER_COMMAND(defer_clear, "Clear all queued defer commands for a specific client") { GameCommand_defer_clear(request, arguments); }
1632 SERVER_COMMAND(defer_clear_all, "Clear all queued defer commands for all clients") { GameCommand_defer_clear_all(request); }
1633 SERVER_COMMAND(delrec, "Delete race time record for a map") { GameCommand_delrec(request, arguments); }
1634 SERVER_COMMAND(effectindexdump, "Dump list of effects from code and effectinfo.txt") { GameCommand_effectindexdump(request); }
1635 SERVER_COMMAND(extendmatchtime, "Increase the timelimit value incrementally") { GameCommand_extendmatchtime(request); }
1636 SERVER_COMMAND(gametype, "Simple command to change the active gametype") { GameCommand_gametype(request, arguments); }
1637 SERVER_COMMAND(gettaginfo, "Get specific information about a weapon model") { GameCommand_gettaginfo(request, arguments); }
1638 SERVER_COMMAND(gotomap, "Simple command to switch to another map") { GameCommand_gotomap(request, arguments); }
1639 SERVER_COMMAND(lockteams, "Disable the ability for players to switch or enter teams") { GameCommand_lockteams(request); }
1640 SERVER_COMMAND(make_mapinfo, "Automatically rebuild mapinfo files") { GameCommand_make_mapinfo(request); }
1641 SERVER_COMMAND(moveplayer, "Change the team/status of a player") { GameCommand_moveplayer(request, arguments); }
1642 SERVER_COMMAND(nospectators, "Automatically remove spectators from a match") { GameCommand_nospectators(request); }
1643 SERVER_COMMAND(printstats, "Dump eventlog player stats and other score information") { GameCommand_printstats(request); }
1644 SERVER_COMMAND(radarmap, "Generate a radar image of the map") { GameCommand_radarmap(request, arguments); }
1645 SERVER_COMMAND(reducematchtime, "Decrease the timelimit value incrementally") { GameCommand_reducematchtime(request); }
1646 SERVER_COMMAND(setbots, "Adjust how many bots are in the match") { GameCommand_setbots(request, arguments); }
1647 SERVER_COMMAND(shuffleteams, "Randomly move players to different teams") { GameCommand_shuffleteams(request); }
1648 SERVER_COMMAND(stuffto, "Send a command to be executed on a client") { GameCommand_stuffto(request, arguments); }
1649 SERVER_COMMAND(trace, "Various debugging tools with tracing") { GameCommand_trace(request, arguments); }
1650 SERVER_COMMAND(unlockteams, "Enable the ability for players to switch or enter teams") { GameCommand_unlockteams(request); }
1651 SERVER_COMMAND(warp, "Choose different level in campaign") { GameCommand_warp(request, arguments); }
1653 void GameCommand_macro_help()
1655 FOREACH(SERVER_COMMANDS, true, { LOG_HELPF(" ^2%s^7: %s", it.m_name, it.m_description); });
1658 float GameCommand_macro_command(int argc, string command)
1660 string c = strtolower(argv(0));
1661 FOREACH(SERVER_COMMANDS, it.m_name == c, {
1662 it.m_invokecmd(it, CMD_REQUEST_COMMAND, NULL, argc, command);
1668 float GameCommand_macro_usage(int argc)
1670 string c = strtolower(argv(1));
1671 FOREACH(SERVER_COMMANDS, it.m_name == c, {
1672 it.m_invokecmd(it, CMD_REQUEST_USAGE, NULL, argc, "");
1678 void GameCommand_macro_write_aliases(float fh)
1680 FOREACH(SERVER_COMMANDS, true, { CMD_Write_Alias("qc_cmd_sv", it.m_name, it.m_description); });
1684 // =========================================
1685 // Main Function Called By Engine (sv_cmd)
1686 // =========================================
1687 // If this function exists, game code handles gamecommand instead of the engine code.
1689 void GameCommand(string command)
1691 int argc = tokenize_console(command);
1693 // Guide for working with argc arguments by example:
1694 // argc: 1 - 2 - 3 - 4
1695 // argv: 0 - 1 - 2 - 3
1696 // cmd vote - master - login - password
1698 if (strtolower(argv(0)) == "help")
1702 LOG_HELP("Server console commands:");
1703 GameCommand_macro_help();
1705 LOG_HELP("\nBanning commands:");
1706 BanCommand_macro_help();
1708 LOG_HELP("\nCommon networked commands:");
1709 CommonCommand_macro_help(NULL);
1711 LOG_HELP("\nGeneric commands shared by all programs:");
1712 GenericCommand_macro_help();
1714 LOG_HELP("\nUsage:^3 sv_cmd COMMAND...^7, where possible commands are listed above.\n"
1715 "For help about a specific command, type sv_cmd help COMMAND");
1719 else if (BanCommand_macro_usage(argc)) // Instead of trying to call a command, we're going to see detailed information about it
1723 else if (CommonCommand_macro_usage(argc, NULL)) // same here, but for common commands instead
1727 else if (GenericCommand_macro_usage(argc)) // same here, but for generic commands instead
1731 else if (GameCommand_macro_usage(argc)) // finally try for normal commands too
1736 else if (MUTATOR_CALLHOOK(SV_ParseServerCommand, strtolower(argv(0)), argc, command))
1738 return; // handled by a mutator
1740 else if (BanCommand(command))
1742 return; // handled by server/command/ipban.qc
1744 else if (CommonCommand_macro_command(argc, NULL, command))
1746 return; // handled by server/command/common.qc
1748 else if (GenericCommand(command))
1750 return; // handled by common/command/generic.qc
1752 else if (GameCommand_macro_command(argc, command)) // continue as usual and scan for normal commands
1754 return; // handled by one of the above GameCommand_* functions
1757 // nothing above caught the command, must be invalid
1758 LOG_INFO(((command != "") ? strcat("Unknown server command \"", command, "\"") : "No command provided"), ". For a list of supported commands, try sv_cmd help.");