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> [<arguments>]");
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:
718 if (!world_initialized)
720 LOG_INFOF("This command works only when the server is running.");
726 Gametype t = MapInfo_Type_FromString(s, false, false), tsave = MapInfo_CurrentGametype();
730 MapInfo_SwitchGameType(t);
731 MapInfo_FilterGametype(MapInfo_CurrentGametype(), MapInfo_CurrentFeatures(), MapInfo_RequiredFlags(), MapInfo_ForbiddenFlags(), 0);
732 if (MapInfo_count > 0)
734 // update lsmaps in case the gametype changed, this way people can easily list maps for it
735 if (lsmaps_reply != "") strunzone(lsmaps_reply);
736 lsmaps_reply = strzone(getlsmaps());
737 bprint("Game type successfully switched to ", s, "\n");
741 bprint("Cannot use this game type: no map for it found\n");
742 MapInfo_SwitchGameType(tsave);
743 MapInfo_FilterGametype(MapInfo_CurrentGametype(), MapInfo_CurrentFeatures(), MapInfo_RequiredFlags(), MapInfo_ForbiddenFlags(), 0);
748 bprint("Failed to switch to ", s, ": this game type does not exist!\n");
756 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
757 case CMD_REQUEST_USAGE:
759 LOG_HELP("Usage:^3 sv_cmd gametype <mode>");
760 LOG_HELP(" Where <mode> is the gametype mode to switch to.");
761 LOG_HELP("See also: ^2gotomap^7");
767 void GameCommand_gettaginfo(int request, int argc)
771 case CMD_REQUEST_COMMAND:
779 tmp_entity = spawn();
782 .entity weaponentity = weaponentities[0];
783 _setmodel(tmp_entity, (nextent(NULL)).(weaponentity).model);
787 precache_model(argv(1));
788 _setmodel(tmp_entity, argv(1));
790 tmp_entity.frame = stof(argv(2));
791 if (substring(argv(3), 0, 1) == "#") i = stof(substring(argv(3), 1, -1));
792 else i = gettagindex(tmp_entity, argv(3));
795 v = gettaginfo(tmp_entity, i);
796 LOG_HELPF("model %s frame %s tag %s index %s parent %s",
797 tmp_entity.model, ftos(tmp_entity.frame), gettaginfo_name, ftos(i), ftos(gettaginfo_parent)
799 LOG_HELPF(" vector = %s %s %s", ftos(v.x), ftos(v.y), ftos(v.z));
800 LOG_HELPF(" offset = %s %s %s", ftos(gettaginfo_offset.x), ftos(gettaginfo_offset.y), ftos(gettaginfo_offset.z));
801 LOG_HELPF(" forward = %s %s %s", ftos(gettaginfo_forward.x), ftos(gettaginfo_forward.y), ftos(gettaginfo_forward.z));
802 LOG_HELPF(" right = %s %s %s", ftos(gettaginfo_right.x), ftos(gettaginfo_right.y), ftos(gettaginfo_right.z));
803 LOG_HELPF(" up = %s %s %s", ftos(gettaginfo_up.x), ftos(gettaginfo_up.y), ftos(gettaginfo_up.z));
807 localcmd(strcat(argv(4), vtos(v), argv(5), "\n"));
812 LOG_INFO("bone not found");
821 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
822 case CMD_REQUEST_USAGE:
824 LOG_HELP("Usage:^3 sv_cmd gettaginfo <model> <frame> <index> [<command1>] [<command2>]");
825 LOG_HELP("See also: ^2bbox, trace^7");
831 void GameCommand_animbench(int request, int argc)
835 case CMD_REQUEST_COMMAND:
841 tmp_entity = spawn();
844 .entity weaponentity = weaponentities[0];
845 _setmodel(tmp_entity, (nextent(NULL)).(weaponentity).model);
849 precache_model(argv(1));
850 _setmodel(tmp_entity, argv(1));
852 float f1 = stof(argv(2));
853 float f2 = stof(argv(3));
861 tmp_entity.frame = f1;
862 t0 = gettime(GETTIME_HIRES);
863 getsurfacepoint(tmp_entity, 0, 0);
864 t1 += gettime(GETTIME_HIRES) - t0;
865 tmp_entity.frame = f2;
866 t0 = gettime(GETTIME_HIRES);
867 getsurfacepoint(tmp_entity, 0, 0);
868 t2 += gettime(GETTIME_HIRES) - t0;
871 LOG_INFO("model ", tmp_entity.model, " frame ", ftos(f1), " animtime ", ftos(n / t1), "/s");
872 LOG_INFO("model ", tmp_entity.model, " frame ", ftos(f2), " animtime ", ftos(n / t2), "/s");
880 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
881 case CMD_REQUEST_USAGE:
883 LOG_HELP("Usage:^3 sv_cmd animbench <model> <frame1> <frame2>");
884 LOG_HELP("See also: ^2bbox, trace^7");
890 void GameCommand_gotomap(int request, int argc)
894 case CMD_REQUEST_COMMAND:
896 if (!world_initialized)
898 LOG_INFOF("This command works only when the server is running.");
903 LOG_INFO(GotoMap(argv(1)));
909 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
910 case CMD_REQUEST_USAGE:
912 LOG_HELP("Usage:^3 sv_cmd gotomap <map>");
913 LOG_HELP(" Where <map> is the *.bsp file to change to.");
914 LOG_HELP("See also: ^2gametype^7");
920 void GameCommand_lockteams(int request)
924 case CMD_REQUEST_COMMAND:
929 bprint("^1The teams are now locked.\n");
933 bprint("lockteams command can only be used in a team-based gamemode.\n");
939 case CMD_REQUEST_USAGE:
941 LOG_HELP("Usage:^3 sv_cmd lockteams");
942 LOG_HELP(" No arguments required.");
943 LOG_HELP("See also: ^2unlockteams^7");
949 void GameCommand_make_mapinfo(int request)
953 case CMD_REQUEST_COMMAND:
957 tmp_entity = new(make_mapinfo);
958 setthink(tmp_entity, make_mapinfo_Think);
959 tmp_entity.nextthink = time;
965 case CMD_REQUEST_USAGE:
967 LOG_HELP("Usage:^3 sv_cmd make_mapinfo");
968 LOG_HELP(" No arguments required.");
969 LOG_HELP("See also: ^2radarmap^7");
975 void GameCommand_moveplayer(int request, int argc)
979 case CMD_REQUEST_COMMAND:
984 string targets = strreplace(",", " ", argv(1));
985 string original_targets = strreplace(" ", ", ", targets);
986 string destination = argv(2);
987 if (destination == "spec")
988 destination = "spectator";
990 if ((targets) && (destination))
992 string successful = string_null;
997 targets = cdr(targets);
999 // Check to see if the player is a valid target
1000 client = GetFilteredEntity(t);
1001 accepted = VerifyClientEntity(client, false, false);
1005 LOG_INFO("moveplayer: ", GetClientErrorString(accepted, t), ".");
1007 else if (destination == "spectator")
1009 string pl_name = playername(client.netname, client.team, false);
1010 if (!IS_SPEC(client) && !IS_OBSERVER(client))
1012 if (client.caplayer) client.caplayer = 0;
1013 PutObserverInServer(client);
1015 successful = strcat(successful, (successful ? ", " : ""), pl_name);
1019 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", pl_name, ") is already spectating.");
1026 LOG_INFO("Can't change teams when currently not playing a team game.");
1030 string pl_name = playername(client.netname, client.team, false);
1031 if (IS_SPEC(client) || IS_OBSERVER(client))
1033 // well technically we could, but should we allow that? :P
1034 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", pl_name, ") is not in the game.");
1039 int save = Player_GetForcedTeamIndex(client);
1040 Player_SetForcedTeamIndex(client, TEAM_FORCE_DEFAULT);
1042 // find the team to move the player to
1043 int team_num = Team_ColorToTeam(destination);
1045 if (team_num == client.team) // already on the destination team
1047 // keep the forcing undone
1048 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", pl_name, ") is already on the ", Team_ColoredFullName(team_num), ".");
1051 else if (team_num == 0) // auto team
1053 balance = TeamBalance_CheckAllowedTeams(client);
1054 team_num = Team_IndexToTeam(TeamBalance_FindBestTeam(balance, client, false));
1058 balance = TeamBalance_CheckAllowedTeams(client);
1060 Player_SetForcedTeamIndex(client, save);
1062 // Check to see if the destination team is even available
1063 int team_id = Team_TeamToIndex(team_num);
1066 LOG_INFO("Sorry, can't move player here if team ", destination, " doesn't exist.");
1067 TeamBalance_Destroy(balance);
1070 if (!TeamBalance_IsTeamAllowed(balance, team_id))
1072 LOG_INFOF("Sorry, can't move player to %s team if it doesn't exist.", destination);
1073 TeamBalance_Destroy(balance);
1076 TeamBalance_Destroy(balance);
1078 // If so, lets continue and finally move the player
1079 Player_SetForcedTeamIndex(client, TEAM_FORCE_DEFAULT);
1080 if (MoveToTeam(client, team_id, 6))
1082 successful = strcat(successful, (successful ? ", " : ""), pl_name);
1083 LOG_INFO("Player ", ftos(GetFilteredNumber(t)), " (", pl_name, ") has been moved to the ", Team_ColoredFullName(team_num), "^7.");
1087 LOG_INFO("Unable to move player ", ftos(GetFilteredNumber(t)), " (", pl_name, ")");
1092 if (successful) bprint("Successfully moved players ", successful, " to destination ", destination, ".\n");
1093 else LOG_INFO("No players given (", original_targets, ") are able to move.");
1095 return; // still correct parameters so return to avoid usage print
1100 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1101 case CMD_REQUEST_USAGE:
1103 LOG_HELP("Usage:^3 sv_cmd moveplayer <clients> <destination>");
1104 LOG_HELP(" <clients> is a list (separated by commas) of player entity ID's or nicknames");
1105 LOG_HELP(" <destination> is what to send the player to, be it team or spectating");
1106 LOG_HELP(" Full list of destinations here: spec, spectator, red, blue, yellow, pink, auto.");
1107 LOG_HELP("Examples: sv_cmd moveplayer 1,3,5 red");
1108 LOG_HELP(" sv_cmd moveplayer 2 spec");
1109 LOG_HELP("See also: ^2allspec, shuffleteams^7");
1115 void GameCommand_nospectators(int request)
1119 case CMD_REQUEST_COMMAND:
1121 blockSpectators = 1;
1122 // give every spectator <g_maxplayers_spectator_blocktime> seconds time to become a player
1123 FOREACH_CLIENT(IS_REAL_CLIENT(it) && (IS_SPEC(it) || IS_OBSERVER(it)) && !it.caplayer, {
1126 CS(it).spectatortime = time;
1127 Send_Notification(NOTIF_ONE_ONLY, it, MSG_INFO, INFO_SPECTATE_WARNING, autocvar_g_maxplayers_spectator_blocktime);
1130 bprint(strcat("^7All spectators will be automatically kicked when not joining the game after ", ftos(autocvar_g_maxplayers_spectator_blocktime), " seconds!\n"));
1135 case CMD_REQUEST_USAGE:
1137 LOG_HELP("Usage:^3 sv_cmd nospectators");
1138 LOG_HELP(" No arguments required.");
1144 void GameCommand_printstats(int request)
1148 case CMD_REQUEST_COMMAND:
1151 LOG_INFO("stats dumped.");
1156 case CMD_REQUEST_USAGE:
1158 LOG_HELP("Usage:^3 sv_cmd printstats");
1159 LOG_HELP(" No arguments required.");
1165 void GameCommand_radarmap(int request, int argc)
1169 case CMD_REQUEST_COMMAND:
1171 if (RadarMap_Make(argc)) return;
1175 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1176 case CMD_REQUEST_USAGE:
1178 LOG_HELP("Usage:^3 sv_cmd radarmap [--force] [--loop] [--quit] [--block | --trace | --sample | --lineblock] [--sharpen N] [--res W H] [--qual Q]");
1179 LOG_HELP(" The quality factor Q is roughly proportional to the time taken.");
1180 LOG_HELP(" trace supports no quality factor; its result should look like --block with infinite quality factor.");
1181 LOG_HELP("See also: ^2make_mapinfo^7");
1187 void GameCommand_reducematchtime(int request)
1191 case CMD_REQUEST_COMMAND:
1193 changematchtime(autocvar_timelimit_decrement * -60, autocvar_timelimit_min * 60, autocvar_timelimit_max * 60);
1198 case CMD_REQUEST_USAGE:
1200 LOG_HELP("Usage:^3 sv_cmd reducematchtime");
1201 LOG_HELP(" No arguments required.");
1202 LOG_HELP("See also: ^2extendmatchtime^7");
1208 void GameCommand_setbots(int request, int argc)
1212 case CMD_REQUEST_COMMAND:
1216 cvar_settemp("minplayers", "0");
1217 cvar_settemp("minplayers_per_team", "0");
1218 cvar_settemp("bot_number", argv(1));
1225 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1226 case CMD_REQUEST_USAGE:
1228 LOG_HELP("Usage:^3 sv_cmd setbots <botnumber>");
1229 LOG_HELP(" Where <botnumber> is the amount of bots to set bot_number cvar to.");
1230 LOG_HELP("See also: ^2bot_cmd^7");
1240 LOG_INFO("Can't shuffle teams when currently not playing a team game.");
1244 FOREACH_CLIENT(IS_PLAYER(it) || it.caplayer, {
1245 if (Player_HasRealForcedTeam(it)) {
1246 // we could theoretically assign forced players to their teams
1247 // and shuffle the rest to fill the empty spots but in practise
1248 // either all players or none are gonna have forced teams
1249 LOG_INFO("Can't shuffle teams because at least one player has a forced team.");
1254 int number_of_teams = 0;
1255 entity balance = TeamBalance_CheckAllowedTeams(NULL);
1256 for (int i = 1; i <= NUM_TEAMS; ++i)
1258 if (TeamBalance_IsTeamAllowed(balance, i))
1260 number_of_teams = max(i, number_of_teams);
1263 TeamBalance_Destroy(balance);
1266 FOREACH_CLIENT_RANDOM(IS_PLAYER(it) || it.caplayer, {
1267 int target_team_index = team_index + 1;
1268 if (Entity_GetTeamIndex(it) != target_team_index)
1270 MoveToTeam(it, target_team_index, 6);
1272 team_index = (team_index + 1) % number_of_teams;
1275 bprint("Successfully shuffled the players around randomly.\n");
1278 void GameCommand_shuffleteams(int request)
1282 case CMD_REQUEST_COMMAND:
1284 if (shuffleteams_on_reset_map)
1286 bprint("Players will be shuffled when this round is over.\n");
1287 shuffleteams_on_reset_map = true;
1295 case CMD_REQUEST_USAGE:
1297 LOG_HELP("Usage:^3 sv_cmd shuffleteams");
1298 LOG_HELP(" No arguments required.");
1299 LOG_HELP("See also: ^2moveplayer, allspec^7");
1305 void GameCommand_stuffto(int request, int argc)
1307 // This... is a fairly dangerous and powerful command... - It allows any arguments to be sent to a client via rcon.
1308 // Because of this, it is disabled by default and must be enabled by the server owner when doing compilation. That way,
1309 // we can be certain they understand the risks of it... So to enable, compile server with -DSTUFFTO_ENABLED argument.
1311 #ifdef STUFFTO_ENABLED
1314 case CMD_REQUEST_COMMAND:
1318 entity client = GetIndexedEntity(argc, 1);
1319 float accepted = VerifyClientEntity(client, true, false);
1323 stuffcmd(client, strcat("\n", argv(next_token), "\n"));
1324 LOG_INFO("Command: \"", argv(next_token), "\" sent to ", GetCallerName(client), " (", argv(1), ").");
1328 LOG_INFO("stuffto: ", GetClientErrorString(accepted, argv(1)), ".");
1336 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1337 case CMD_REQUEST_USAGE:
1339 LOG_HELP("Usage:^3 sv_cmd stuffto <client> \"<command>\"");
1340 LOG_HELP(" <client> is the entity number or name of the player,");
1341 LOG_HELP(" and <command> is the command to be sent to that player.");
1348 LOG_HELP("stuffto command is not enabled on this server.");
1354 void GameCommand_trace(int request, int argc)
1358 case CMD_REQUEST_COMMAND:
1361 vector org, delta, start, end, p, q, q0, pos, vv, dv;
1362 float i, f, safe, unsafe, dq, dqf;
1369 LOG_INFO("TEST CASE. If this returns the runaway loop counter error, possibly everything is oaky.");
1370 float worst_endpos_bug = 0;
1374 delta = world.maxs - world.mins;
1376 start.x = org.x + random() * delta.x;
1377 start.y = org.y + random() * delta.y;
1378 start.z = org.z + random() * delta.z;
1380 end.x = org.x + random() * delta.x;
1381 end.y = org.y + random() * delta.y;
1382 end.z = org.z + random() * delta.z;
1384 start = stov(vtos(start));
1385 end = stov(vtos(end));
1387 tracebox(start, PL_MIN_CONST, PL_MAX_CONST, end, MOVE_NOMONSTERS, NULL);
1388 if (!trace_startsolid && trace_fraction < 1)
1391 tracebox(p, PL_MIN_CONST, PL_MAX_CONST, p, MOVE_NOMONSTERS, NULL);
1392 if (trace_startsolid)
1394 rint(42); // do an engine breakpoint on VM_rint so you can get the trace that errnoeously returns startsolid
1395 tracebox(start, PL_MIN_CONST, PL_MAX_CONST, end, MOVE_NOMONSTERS, NULL);
1397 // how much do we need to back off?
1402 pos = p * (1 - (safe + unsafe) * 0.5) + start * ((safe + unsafe) * 0.5);
1403 tracebox(pos, PL_MIN_CONST, PL_MAX_CONST, pos, MOVE_NOMONSTERS, NULL);
1404 if (trace_startsolid)
1406 if ((safe + unsafe) * 0.5 == unsafe) break;
1407 unsafe = (safe + unsafe) * 0.5;
1411 if ((safe + unsafe) * 0.5 == safe) break;
1412 safe = (safe + unsafe) * 0.5;
1416 LOG_INFO("safe distance to back off: ", ftos(safe * vlen(p - start)), "qu");
1417 LOG_INFO("unsafe distance to back off: ", ftos(unsafe * vlen(p - start)), "qu");
1419 tracebox(p, PL_MIN_CONST + '0.1 0.1 0.1', PL_MAX_CONST - '0.1 0.1 0.1', p, MOVE_NOMONSTERS, NULL);
1420 if (trace_startsolid) LOG_INFO("trace_endpos much in solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1421 else LOG_INFO("trace_endpos just in solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1422 if (++hitcount >= 10) break;
1431 q = p + normalize(end - p) * (dq + dqf);
1433 tracebox(p, PL_MIN_CONST, PL_MAX_CONST, q, MOVE_NOMONSTERS, NULL);
1434 if (trace_startsolid) error("THIS ONE cannot happen");
1435 if (trace_fraction > 0) dq += dqf * trace_fraction;
1439 if (dq > worst_endpos_bug)
1441 worst_endpos_bug = dq;
1442 LOG_INFO("trace_endpos still before solid when tracing from ", vtos(start), " to ", vtos(end), " endpos ", vtos(p));
1443 LOG_INFO("could go ", ftos(dq), " units further to ", vtos(q));
1444 if (++hitcount >= 10) break;
1455 tracebox(e.origin + '0 0 32', e.mins, e.maxs, e.origin + '0 0 -1024', MOVE_NORMAL, e);
1457 if (trace_fraction == 1)
1459 LOG_INFO("not above ground, aborting");
1463 for (i = 0; i < 100000; ++i)
1466 if (dv.z > 0) dv = -1 * dv;
1467 tracebox(vv, e.mins, e.maxs, vv + dv, MOVE_NORMAL, e);
1468 if (trace_startsolid) LOG_INFO("bug 1");
1469 if (trace_fraction == 1)
1473 LOG_INFO("bug 2: ", ftos(dv.x), " ", ftos(dv.y), " ", ftos(dv.z));
1474 LOG_INFO(" (", ftos(asin(dv.z / vlen(dv)) * 180 / M_PI), " degrees)");
1479 LOG_INFO("highest possible dist: ", ftos(f));
1485 if (argc == 4 || argc == 5)
1488 int dphitcontentsmask_save = e.dphitcontentsmask;
1489 e.dphitcontentsmask = DPCONTENTS_SOLID | DPCONTENTS_BODY | DPCONTENTS_PLAYERCLIP | DPCONTENTS_BOTCLIP;
1490 if (tracewalk(e, stov(argv(2)), e.mins, e.maxs, stov(argv(3)), stof(argv(4)), MOVE_NORMAL))
1491 LOG_INFO("can walk");
1493 LOG_INFO("cannot walk");
1494 e.dphitcontentsmask = dphitcontentsmask_save;
1505 traceline(vv, dv, MOVE_NORMAL, NULL);
1506 __trailparticles(NULL, particleeffectnum(EFFECT_TR_NEXUIZPLASMA), vv, trace_endpos);
1507 __trailparticles(NULL, particleeffectnum(EFFECT_TR_CRYLINKPLASMA), trace_endpos, dv);
1512 // no default case, just go straight to invalid
1517 LOG_INFOF("Incorrect parameters for ^2%s^7", argv(0));
1518 case CMD_REQUEST_USAGE:
1520 LOG_HELP("Usage:^3 sv_cmd trace <command> [<startpos> <endpos>] [<endpos_height>]");
1521 LOG_HELP(" Where <startpos> and <endpos> are parameters for the 'walk' and 'showline' commands,");
1522 LOG_HELP(" <endpos_height> is an optional parameter for the 'walk' command,");
1523 LOG_HELP(" Full list of commands here: debug, debug2, walk, showline.");
1524 LOG_HELP("See also: ^2bbox, gettaginfo^7");
1530 void GameCommand_unlockteams(int request)
1534 case CMD_REQUEST_COMMAND:
1539 bprint("^1The teams are now unlocked.\n");
1543 bprint("unlockteams command can only be used in a team-based gamemode.\n");
1549 case CMD_REQUEST_USAGE:
1551 LOG_HELP("Usage:^3 sv_cmd unlockteams");
1552 LOG_HELP(" No arguments required.");
1553 LOG_HELP("See also: ^2lockteams^7");
1559 void GameCommand_warp(int request, int argc)
1563 case CMD_REQUEST_COMMAND:
1565 if (autocvar_g_campaign)
1569 CampaignLevelWarp(stof(argv(1)));
1570 LOG_INFO("Successfully warped to campaign level ", argv(1), ".");
1574 CampaignLevelWarp(-1);
1575 LOG_INFO("Successfully warped to next campaign level.");
1580 LOG_INFO("Not in campaign, can't level warp");
1586 case CMD_REQUEST_USAGE:
1588 LOG_HELP("Usage:^3 sv_cmd warp [<level>]");
1589 LOG_HELP(" <level> is the level to change campaign mode to.");
1590 LOG_HELP(" if <level> is not provided it will change to the next level.");
1596 /* use this when creating a new command, making sure to place it in alphabetical order... also,
1597 ** ADD ALL NEW COMMANDS TO commands.cfg WITH PROPER ALIASES IN THE SAME FASHION!
1598 void GameCommand_(int request)
1602 case CMD_REQUEST_COMMAND:
1609 case CMD_REQUEST_USAGE:
1611 LOG_HELP("Usage:^3 sv_cmd ");
1612 LOG_HELP(" No arguments required.");
1620 // ==================================
1621 // Macro system for server commands
1622 // ==================================
1624 // Do not hard code aliases for these, instead create them in commands.cfg... also: keep in alphabetical order, please ;)
1625 SERVER_COMMAND(adminmsg, "Send an admin message to a client directly") { GameCommand_adminmsg(request, arguments); }
1626 SERVER_COMMAND(allready, "Restart the server and reset the players") { GameCommand_allready(request); }
1627 SERVER_COMMAND(allspec, "Force all players to spectate") { GameCommand_allspec(request, arguments); }
1628 SERVER_COMMAND(anticheat, "Create an anticheat report for a client") { GameCommand_anticheat(request, arguments); }
1629 SERVER_COMMAND(animbench, "Benchmark model animation (LAGS)") { GameCommand_animbench(request, arguments); }
1630 SERVER_COMMAND(bbox, "Print detailed information about world size") { GameCommand_bbox(request); }
1631 SERVER_COMMAND(bot_cmd, "Control and send commands to bots") { GameCommand_bot_cmd(request, arguments, command); }
1632 SERVER_COMMAND(cointoss, "Flip a virtual coin and give random result") { GameCommand_cointoss(request, arguments); }
1633 SERVER_COMMAND(database, "Extra controls of the serverprogs database") { GameCommand_database(request, arguments); }
1634 SERVER_COMMAND(defer_clear, "Clear all queued defer commands for a specific client") { GameCommand_defer_clear(request, arguments); }
1635 SERVER_COMMAND(defer_clear_all, "Clear all queued defer commands for all clients") { GameCommand_defer_clear_all(request); }
1636 SERVER_COMMAND(delrec, "Delete race time record for a map") { GameCommand_delrec(request, arguments); }
1637 SERVER_COMMAND(effectindexdump, "Dump list of effects from code and effectinfo.txt") { GameCommand_effectindexdump(request); }
1638 SERVER_COMMAND(extendmatchtime, "Increase the timelimit value incrementally") { GameCommand_extendmatchtime(request); }
1639 SERVER_COMMAND(gametype, "Simple command to change the active gametype") { GameCommand_gametype(request, arguments); }
1640 SERVER_COMMAND(gettaginfo, "Get specific information about a weapon model") { GameCommand_gettaginfo(request, arguments); }
1641 SERVER_COMMAND(gotomap, "Simple command to switch to another map") { GameCommand_gotomap(request, arguments); }
1642 SERVER_COMMAND(lockteams, "Disable the ability for players to switch or enter teams") { GameCommand_lockteams(request); }
1643 SERVER_COMMAND(make_mapinfo, "Automatically rebuild mapinfo files") { GameCommand_make_mapinfo(request); }
1644 SERVER_COMMAND(moveplayer, "Change the team/status of a player") { GameCommand_moveplayer(request, arguments); }
1645 SERVER_COMMAND(nospectators, "Automatically remove spectators from a match") { GameCommand_nospectators(request); }
1646 SERVER_COMMAND(printstats, "Dump eventlog player stats and other score information") { GameCommand_printstats(request); }
1647 SERVER_COMMAND(radarmap, "Generate a radar image of the map") { GameCommand_radarmap(request, arguments); }
1648 SERVER_COMMAND(reducematchtime, "Decrease the timelimit value incrementally") { GameCommand_reducematchtime(request); }
1649 SERVER_COMMAND(setbots, "Adjust how many bots are in the match") { GameCommand_setbots(request, arguments); }
1650 SERVER_COMMAND(shuffleteams, "Randomly move players to different teams") { GameCommand_shuffleteams(request); }
1651 SERVER_COMMAND(stuffto, "Send a command to be executed on a client") { GameCommand_stuffto(request, arguments); }
1652 SERVER_COMMAND(trace, "Various debugging tools with tracing") { GameCommand_trace(request, arguments); }
1653 SERVER_COMMAND(unlockteams, "Enable the ability for players to switch or enter teams") { GameCommand_unlockteams(request); }
1654 SERVER_COMMAND(warp, "Choose different level in campaign") { GameCommand_warp(request, arguments); }
1656 void GameCommand_macro_help()
1658 FOREACH(SERVER_COMMANDS, true, { LOG_HELPF(" ^2%s^7: %s", it.m_name, it.m_description); });
1661 float GameCommand_macro_command(int argc, string command)
1663 string c = strtolower(argv(0));
1664 FOREACH(SERVER_COMMANDS, it.m_name == c, {
1665 it.m_invokecmd(it, CMD_REQUEST_COMMAND, NULL, argc, command);
1671 float GameCommand_macro_usage(int argc)
1673 string c = strtolower(argv(1));
1674 FOREACH(SERVER_COMMANDS, it.m_name == c, {
1675 it.m_invokecmd(it, CMD_REQUEST_USAGE, NULL, argc, "");
1681 void GameCommand_macro_write_aliases(float fh)
1683 FOREACH(SERVER_COMMANDS, true, { CMD_Write_Alias("qc_cmd_sv", it.m_name, it.m_description); });
1687 // =========================================
1688 // Main Function Called By Engine (sv_cmd)
1689 // =========================================
1690 // If this function exists, game code handles gamecommand instead of the engine code.
1692 void GameCommand(string command)
1694 int argc = tokenize_console(command);
1696 // Guide for working with argc arguments by example:
1697 // argc: 1 - 2 - 3 - 4
1698 // argv: 0 - 1 - 2 - 3
1699 // cmd vote - master - login - password
1701 if (strtolower(argv(0)) == "help")
1705 LOG_HELP("Server console commands:");
1706 GameCommand_macro_help();
1708 LOG_HELP("\nBanning commands:");
1709 BanCommand_macro_help();
1711 LOG_HELP("\nCommon networked commands:");
1712 CommonCommand_macro_help(NULL);
1714 LOG_HELP("\nGeneric commands shared by all programs:");
1715 GenericCommand_macro_help();
1717 LOG_HELP("\nUsage:^3 sv_cmd <command>^7, where possible commands are listed above.\n"
1718 "For help about a specific command, type sv_cmd help <command>");
1722 else if (BanCommand_macro_usage(argc)) // Instead of trying to call a command, we're going to see detailed information about it
1726 else if (CommonCommand_macro_usage(argc, NULL)) // same here, but for common commands instead
1730 else if (GenericCommand_macro_usage(argc)) // same here, but for generic commands instead
1734 else if (GameCommand_macro_usage(argc)) // finally try for normal commands too
1739 else if (MUTATOR_CALLHOOK(SV_ParseServerCommand, strtolower(argv(0)), argc, command))
1741 return; // handled by a mutator
1743 else if (BanCommand(command))
1745 return; // handled by server/command/ipban.qc
1747 else if (CommonCommand_macro_command(argc, NULL, command))
1749 return; // handled by server/command/common.qc
1751 else if (GenericCommand(command))
1753 return; // handled by common/command/generic.qc
1755 else if (GameCommand_macro_command(argc, command)) // continue as usual and scan for normal commands
1757 return; // handled by one of the above GameCommand_* functions
1760 // nothing above caught the command, must be invalid
1761 LOG_INFO(((command != "") ? strcat("Unknown server command \"", command, "\"") : "No command provided"), ". For a list of supported commands, try sv_cmd help.");