3 #include <common/command/_mod.qh>
4 #include <common/constants.qh>
5 #include <common/gamemodes/_mod.qh>
6 #include <common/items/inventory.qh>
7 #include <common/mapinfo.qh>
8 #include <common/net_linked.qh>
9 #include <common/notifications/all.qh>
10 #include <common/playerstats.qh>
11 #include <common/stats.qh>
12 #include <common/util.qh>
13 #include <common/weapons/_all.qh>
14 #include <server/campaign.qh>
15 #include <server/client.qh>
16 #include <server/command/banning.qh>
17 #include <server/command/common.qh>
18 #include <server/command/vote.qh>
19 #include <server/damage.qh>
20 #include <server/gamelog.qh>
21 #include <server/intermission.qh>
22 #include <server/mutators/_mod.qh>
23 #include <server/race.qh>
24 #include <server/round_handler.qh>
25 #include <server/scores.qh>
26 #include <server/teamplay.qh>
27 #include <server/weapons/accuracy.qh>
28 #include <server/weapons/selection.qh>
29 #include <server/world.qh>
31 // =============================================
32 // Server side voting code, reworked by Samual
33 // Last updated: December 27th, 2011
34 // =============================================
36 // Nagger for players to know status of voting
37 bool Nagger_SendEntity(entity this, entity to, float sendflags)
40 WriteHeader(MSG_ENTITY, ENT_CLIENT_NAGGER);
44 // 2 = player needs to ready up
46 // 8 = player needs to vote
57 if (!to.ready) nags |= BIT(1);
65 if (to.vote_selection == 0) nags |= BIT(3);
66 nags |= sendflags & BIT(6);
67 nags |= sendflags & BIT(7);
70 WriteByte(MSG_ENTITY, nags);
74 WriteByte(MSG_ENTITY, vote_accept_count);
75 WriteByte(MSG_ENTITY, vote_reject_count);
76 WriteByte(MSG_ENTITY, vote_needed_overall);
77 WriteChar(MSG_ENTITY, to.vote_selection);
80 if (nags & BIT(7)) WriteString(MSG_ENTITY, vote_called_display);
84 for (int i = 1; i <= maxclients;)
87 for (int b = 0; b < 8 && i <= maxclients; ++b, ++i)
88 if (edict_num(i).ready)
90 WriteByte(MSG_ENTITY, f);
99 Net_LinkEntity(nagger = new_pure(nagger), false, 0, Nagger_SendEntity);
102 void Nagger_VoteChanged()
104 if (nagger) nagger.SendFlags |= BIT(7);
107 void Nagger_VoteCountChanged()
109 if (nagger) nagger.SendFlags |= BIT(6);
112 void Nagger_ReadyCounted()
114 if (nagger) nagger.SendFlags |= BIT(0);
117 // If the vote_caller is still here, return their name, otherwise vote_caller_name
118 string OriginalCallerName()
120 if (IS_REAL_CLIENT(vote_caller)) return playername(vote_caller.netname, vote_caller.team, false);
121 return vote_caller_name;
124 // =======================
125 // Game logic for voting
126 // =======================
128 void VoteStop(entity stopper, bool show_name);
129 void VoteReset(bool verbose)
131 if (verbose && vote_called)
133 VoteStop(NULL, true);
137 FOREACH_CLIENT(true, { it.vote_selection = 0; });
141 strfree(vote_called_command);
142 strfree(vote_called_display);
143 strfree(vote_caller_name);
146 vote_called = VOTE_NULL;
150 vote_parsed_command = string_null;
151 vote_parsed_display = string_null;
153 Nagger_VoteChanged();
156 void VoteStop(entity stopper, bool canceled)
159 bprint("\{1}^2* ^3", OriginalCallerName(), "^2's vote was canceled\n");
161 bprint("\{1}^2* ^3", GetCallerName(stopper), "^2 stopped ^3", OriginalCallerName(), "^2's vote\n");
162 if (autocvar_sv_eventlog) GameLogEcho(strcat(":vote:vstop:", ftos(stopper.playerid)));
163 // Don't force them to wait for next vote, this way they can e.g. correct their vote.
164 if ((vote_caller) && (stopper == vote_caller)) vote_caller.vote_waittime = time + autocvar_sv_vote_stop;
170 bprint("\{1}^2* ^3", OriginalCallerName(), "^2's vote for ^1", vote_called_display, "^2 was accepted\n");
172 if ((vote_called == VOTE_MASTER) && vote_caller) vote_caller.vote_master = true;
173 else localcmd(strcat(vote_called_command, "\n"));
175 if (vote_caller) vote_caller.vote_waittime = 0; // people like your votes, you don't need to wait to vote again
178 Send_Notification(NOTIF_ALL, NULL, MSG_ANNCE, ANNCE_VOTE_ACCEPT);
183 bprint("\{1}^2* ^3", OriginalCallerName(), "^2's vote for ", vote_called_display, "^2 was rejected\n");
185 Send_Notification(NOTIF_ALL, NULL, MSG_ANNCE, ANNCE_VOTE_FAIL);
190 bprint("\{1}^2* ^3", OriginalCallerName(), "^2's vote for ", vote_called_display, "^2 timed out\n");
192 Send_Notification(NOTIF_ALL, NULL, MSG_ANNCE, ANNCE_VOTE_FAIL);
195 void VoteSpam(float notvoters, float mincount, string result)
198 strcat("\{1}^2* vote results: ^1", ftos(vote_accept_count)),
199 strcat("^2:^1", ftos(vote_reject_count)),
200 ((mincount >= 0) ? strcat("^2 (^1", ftos(mincount), "^2 needed)") : "^2"),
201 strcat(", ^1", ftos(vote_abstain_count), "^2 didn't care"),
202 strcat(", ^1", ftos(notvoters), strcat("^2 didn't ", ((mincount >= 0) ? "" : "have to "), "vote\n"))));
204 if (autocvar_sv_eventlog)
207 strcat(":vote:v", result, ":", ftos(vote_accept_count)),
208 strcat(":", ftos(vote_reject_count)),
209 strcat(":", ftos(vote_abstain_count)),
210 strcat(":", ftos(notvoters)),
211 strcat(":", ftos(mincount))));
215 #define spectators_allowed (!autocvar_sv_vote_nospectators || (autocvar_sv_vote_nospectators == 1 && (warmup_stage || intermission_running)))
217 void VoteCount(float first_count)
219 vote_accept_count = vote_reject_count = vote_abstain_count = 0;
221 float vote_player_count = 0, notvoters = 0;
222 float vote_real_player_count = 0, vote_real_accept_count = 0;
223 float vote_real_reject_count = 0, vote_real_abstain_count = 0;
224 float vote_needed_of_voted, final_needed_votes;
225 float vote_factor_overall, vote_factor_of_voted;
227 Nagger_VoteCountChanged();
229 // add up all the votes from each connected client
230 FOREACH_CLIENT(IS_REAL_CLIENT(it) || autocvar_sv_vote_debug, {
232 if (IS_PLAYER(it) || INGAME(it)) ++vote_real_player_count;
233 switch (it.vote_selection)
235 case VOTE_SELECT_REJECT:
237 if (IS_PLAYER(it) || INGAME(it)) ++vote_real_reject_count;
239 case VOTE_SELECT_ACCEPT:
241 if (IS_PLAYER(it) || INGAME(it)) ++vote_real_accept_count;
243 case VOTE_SELECT_ABSTAIN:
244 ++vote_abstain_count;
245 if (IS_PLAYER(it) || INGAME(it)) ++vote_real_abstain_count;
251 // Check to see if there are enough players on the server to allow master voting... otherwise, vote master could be used for evil.
252 if ((vote_called == VOTE_MASTER) && autocvar_sv_vote_master_playerlimit > vote_player_count)
254 if (vote_caller) vote_caller.vote_waittime = 0;
255 print_to(vote_caller, "^1There are not enough players on this server to allow you to become vote master.");
260 // if spectators aren't allowed to vote and there are players in a match, then only count the players in the vote and ignore spectators.
261 if (!spectators_allowed && (vote_real_player_count > 0))
263 vote_accept_count = vote_real_accept_count;
264 vote_reject_count = vote_real_reject_count;
265 vote_abstain_count = vote_real_abstain_count;
266 vote_player_count = vote_real_player_count;
269 // people who have no opinion in any way :D
270 notvoters = (vote_player_count - vote_accept_count - vote_reject_count - vote_abstain_count);
272 // determine the goal for the vote to be passed or rejected normally
273 vote_factor_overall = bound(0.5, autocvar_sv_vote_majority_factor, 0.999);
274 vote_needed_overall = floor((vote_player_count - vote_abstain_count) * vote_factor_overall) + 1;
276 // if the vote times out, determine the amount of votes needed of the people who actually already voted
277 vote_factor_of_voted = bound(0.5, autocvar_sv_vote_majority_factor_of_voted, 0.999);
278 vote_needed_of_voted = floor((vote_accept_count + vote_reject_count) * vote_factor_of_voted) + 1;
280 // are there any players at all on the server? it could be an admin vote
281 if (vote_player_count == 0 && first_count)
283 VoteSpam(0, -1, "yes"); // no players at all, just accept it
288 // since there ARE players, finally calculate the result of the vote
289 if (vote_accept_count >= vote_needed_overall)
291 VoteSpam(notvoters, -1, "yes"); // there is enough acceptions to pass the vote
296 if (vote_reject_count > vote_player_count - vote_abstain_count - vote_needed_overall)
298 VoteSpam(notvoters, -1, "no"); // there is enough rejections to deny the vote
303 // there is not enough votes in either direction, now lets just calculate what the voters have said
304 if (time > vote_endtime)
306 final_needed_votes = vote_needed_overall;
308 if (autocvar_sv_vote_majority_factor_of_voted)
310 if (vote_accept_count >= vote_needed_of_voted)
312 VoteSpam(notvoters, min(vote_needed_overall, vote_needed_of_voted), "yes");
317 if (vote_accept_count + vote_reject_count > 0)
319 VoteSpam(notvoters, min(vote_needed_overall, vote_needed_of_voted), "no");
324 final_needed_votes = min(vote_needed_overall, vote_needed_of_voted);
327 // it didn't pass or fail, so not enough votes to even make a decision.
328 VoteSpam(notvoters, final_needed_votes, "timeout");
335 if (vote_endtime > 0) // a vote was called
337 if (time > vote_endtime) // time is up
343 // =======================
344 // Game logic for warmup
345 // =======================
347 // Resets the state of all clients, items, weapons, waypoints, ... of the map.
348 void reset_map(bool is_fake_round_start)
350 if (time <= game_starttime)
355 if (!is_fake_round_start)
358 PlayerStats_GameReport_Reset_All();
361 if (round_handler_IsActive())
362 round_handler_Reset(game_starttime);
365 if (shuffleteams_on_reset_map)
368 shuffleteams_on_reset_map = false;
371 FOREACH_CLIENT(true, {
372 if (time <= game_starttime)
373 accuracy_reset(it); // for spectators too because weapon accuracy is persistent
376 if (STAT(FROZEN, it))
378 player_powerups_remove_all(it);
379 entity store = PS(it);
382 Inventory_clear(store.inventory);
383 Inventory_update(store);
387 MUTATOR_CALLHOOK(reset_map_global);
389 FOREACH_ENTITY_FLOAT_ORDERED(pure_data, false,
398 if (it.team_saved) it.team = it.team_saved;
399 if (it.flags & FL_PROJECTILE) delete(it); // remove any projectiles left
402 // Waypoints and assault start come LAST
403 FOREACH_ENTITY_ORDERED(IS_NOT_A_CLIENT(it), {
404 if (it.reset2) it.reset2(it);
407 // Moving the player reset code here since the player-reset depends
408 // on spawnpoint entities which have to be reset first --blub
409 if (!MUTATOR_CALLHOOK(reset_map_players))
411 FOREACH_CLIENT(IS_PLAYER(it),
413 // PlayerScore_Clear(it);
414 CS(it).killcount = 0;
415 // stop the player from moving so that they stand still once they get respawned
416 it.velocity = '0 0 0';
417 it.avelocity = '0 0 0';
418 CS(it).movement = '0 0 0';
419 PutClientInServer(it);
421 if(IS_BOT_CLIENT(it))
423 .entity weaponentity = weaponentities[0];
424 if(it.(weaponentity).m_weapon == WEP_Null)
425 W_NextWeapon(it, 0, weaponentity);
431 // Restarts the map after the countdown is over (and cvar sv_ready_restart_after_countdown is set)
432 void ReadyRestart_think(entity this)
434 if (!warmup_stage) // if the countdown was not aborted
439 // Forces a restart of the game without actually reloading the map // this is a mess...
440 void ReadyRestart_force(bool is_fake_round_start)
442 if (time <= game_starttime && game_stopped)
444 if (!is_fake_round_start && !autocvar_g_campaign)
445 Send_Notification(NOTIF_ALL, NULL, MSG_INFO, INFO_COUNTDOWN_RESTART);
449 // clear overtime, we have to decrease timelimit to its original value again.
450 if (checkrules_overtimesadded > 0 && g_race_qualifying != 2)
451 cvar_set("timelimit", ftos(autocvar_timelimit - (checkrules_overtimesadded * autocvar_timelimit_overtime)));
452 checkrules_suddendeathend = checkrules_overtimesadded = checkrules_suddendeathwarning = overtimes = 0;
455 game_starttime = time; // Warmup: No countdown in warmup
456 else if (autocvar_g_campaign)
457 game_starttime = time + 3;
459 game_starttime = time + RESTART_COUNTDOWN; // Go into match mode
461 // clear player attributes
462 FOREACH_CLIENT(IS_PLAYER(it), {
464 CS(it).killcount = 0;
467 // if we're ending the warmup stage call the corresponding hook
468 if(!is_fake_round_start && !warmup_stage)
469 localcmd("\nsv_hook_warmupend\n");
471 // reset the .ready status of all clients (including spectators and bots)
472 FOREACH_CLIENT(true, { it.ready = false; });
474 Nagger_ReadyCounted(); // NOTE: this causes a resend of that entity, and will also turn off warmup state on the client
476 // lock teams with lockonrestart
477 if (autocvar_teamplay_lockonrestart && teamplay)
478 lockteams = !warmup_stage;
480 // initiate the restart-countdown-announcer entity
481 if (!is_fake_round_start && sv_ready_restart_after_countdown && !warmup_stage)
483 entity restart_timer = new_pure(restart_timer);
484 setthink(restart_timer, ReadyRestart_think);
485 restart_timer.nextthink = game_starttime;
488 // after a restart every players number of allowed timeouts gets reset, too
489 if (autocvar_sv_timeout)
491 FOREACH_CLIENT(IS_PLAYER(it) && IS_REAL_CLIENT(it), { CS(it).allowed_timeouts = autocvar_sv_timeout_number; });
494 if (!sv_ready_restart_after_countdown || warmup_stage)
495 reset_map(is_fake_round_start);
497 if (autocvar_sv_eventlog) GameLogEcho(":restart");
500 void ReadyRestart(bool forceWarmupEnd)
502 if (MUTATOR_CALLHOOK(ReadyRestart_Deny) || intermission_running || race_completing)
504 // NOTE: ReadyRestart support is mandatory in campaign
505 if (autocvar_g_campaign)
506 error("ReadyRestart must be supported in campaign mode!");
507 localcmd("restart\n"); // if ReadyRestart is denied, restart the server
509 else localcmd("\nsv_hook_readyrestart\n");
511 if(forceWarmupEnd || autocvar_g_campaign)
512 warmup_stage = 0; // forcefully end warmup and go to match stage
514 warmup_stage = autocvar_g_warmup; // go into warmup if it's enabled, otherwise restart into match stage
516 ReadyRestart_force(false);
519 /* Count the players who are ready and determine whether or not to restart the match when:
520 * a player presses F4 server/command/cmd.qc ClientCommand_ready()
521 * a player switches from players to specs server/client.qc PutObserverInServer()
522 * a player joins (from specs or directly) server/client.qc PutPlayerInServer()
523 * a player disconnects server/client.qc ClientDisconnect() */
526 // cannot reset the game while a timeout is active or pending
527 if (timeout_status) return;
529 int total_players = 0, human_players = 0, humans_ready = 0;
532 FOREACH_CLIENT(IS_PLAYER(it) || INGAME_JOINED(it), {
534 if (it.ready) ++readycount;
535 if (IS_REAL_CLIENT(it))
538 if (it.ready) ++humans_ready;
542 Nagger_ReadyCounted();
544 // can't read warmup_stage here as it could have been set to 0 by ReadyRestart()
545 // and we need to use this when checking if we should abort the countdown
546 // map_minplayers can only be > 0 if g_warmup was -1 at worldspawn
547 int minplayers = autocvar_g_warmup > 1 ? autocvar_g_warmup : map_minplayers;
549 if (total_players < minplayers)
551 if (game_starttime > time) // someone bailed during countdown, back to warmup
553 warmup_stage = autocvar_g_warmup; // CAN change it AFTER calling Nagger_ReadyCounted() this frame
554 game_starttime = time;
555 Send_Notification(NOTIF_ALL, NULL, MSG_MULTI, COUNTDOWN_STOP, minplayers);
556 if (!sv_ready_restart_after_countdown) // if we ran reset_map() at start of countdown
557 FOREACH_CLIENT(IS_PLAYER(it), { GiveWarmupResources(it); });
559 if (warmup_limit > 0)
561 return; // don't ReadyRestart if players are ready but too few
563 else if (minplayers && warmup_limit <= 0)
565 // there's enough players now but we're still in infinite warmup
566 warmup_limit = cvar("g_warmup_limit");
567 if (warmup_limit == 0)
568 warmup_limit = autocvar_timelimit * 60;
569 if (warmup_limit > 0)
570 game_starttime = time;
571 // implicit else: g_warmup -1 && g_warmup_limit -1 means
572 // warmup continues until enough players AND enough RUPs (no time limit)
575 if (humans_ready && humans_ready >= rint(human_players * bound(0.5, cvar("g_warmup_majority_factor"), 1)))
580 // ======================================
581 // Supporting functions for VoteCommand
582 // ======================================
584 bool Votecommand_check_assignment(entity caller, float assignment)
586 bool from_server = (!caller);
588 if ((assignment == VC_ASGNMNT_BOTH)
589 || ((!from_server && assignment == VC_ASGNMNT_CLIENTONLY)
590 || (from_server && assignment == VC_ASGNMNT_SERVERONLY))) return true;
595 string VoteCommand_extractcommand(string input, float startpos, int argc)
599 if ((argc - 1) < startpos) output = "";
600 else output = substring(input, argv_start_index(startpos), argv_end_index(-1) - argv_start_index(startpos));
605 bool VoteCommand_checknasty(string vote_command)
607 return !((strstrofs(vote_command, ";", 0) >= 0)
608 || (strstrofs(vote_command, "\n", 0) >= 0)
609 || (strstrofs(vote_command, "\r", 0) >= 0)
610 || (strstrofs(vote_command, "$", 0) >= 0));
613 // NOTE: requires input to be surrounded by spaces
614 string VoteCommand_checkreplacements(string input)
616 // add a space around the input so the start and end of the list is captured
617 string output = strcat(" ", input, " ");
618 // allow gotomap replacements
619 output = strreplace(" map ", " gotomap ", output);
620 output = strreplace(" chmap ", " gotomap ", output);
624 bool VoteCommand_checkinlist(string vote_command, string list)
626 if (vote_command == "" || list == "")
629 string l = VoteCommand_checkreplacements(list);
630 return (strstrofs(l, VoteCommand_checkreplacements(vote_command), 0) >= 0);
633 string ValidateMap(string validated_map, entity caller)
635 validated_map = MapInfo_FixName(validated_map);
639 print_to(caller, "This map is not available on this server.");
643 if (!autocvar_sv_vote_override_mostrecent && caller)
645 if (Map_IsRecent(validated_map))
647 print_to(caller, "This server does not allow for recent maps to be played again. Please be patient for some rounds.");
652 if (!MapInfo_CheckMap(validated_map))
654 print_to(caller, strcat("^1Invalid mapname, \"^3", validated_map, "^1\" does not support the current game mode."));
658 return validated_map;
661 float VoteCommand_checkargs(float startpos, int argc)
663 float p, q, check, minargs;
664 string cvarname = strcat("sv_vote_command_restriction_", argv(startpos));
665 string cmdrestriction = ""; // No we don't.
666 string charlist, arg;
669 if(cvar_type(cvarname) & CVAR_TYPEFLAG_EXISTS)
670 cmdrestriction = cvar_string(cvarname);
672 LOG_INFO("NOTE: ", cvarname, " does not exist, no restrictions will be applied.");
674 if (cmdrestriction == "") return true;
676 ++startpos; // skip command name
678 // check minimum arg count
680 // 0 args: argc == startpos
681 // 1 args: argc == startpos + 1
684 minargs = stof(cmdrestriction);
685 if (argc - startpos < minargs) return false;
687 p = strstrofs(cmdrestriction, ";", 0); // find first semicolon
691 // we know that at any time, startpos <= argc - minargs
692 // so this means: argc-minargs >= startpos >= argc, thus
693 // argc-minargs >= argc, thus minargs <= 0, thus all minargs
694 // have been seen already
696 if (startpos >= argc) // all args checked? GOOD
699 if (p < 0) // no more args? FAIL
701 // exception: exactly minargs left, this one included
702 if (argc - startpos == minargs) break;
708 // cut to next semicolon
709 q = strstrofs(cmdrestriction, ";", p + 1); // find next semicolon
710 if (q < 0) charlist = substring(cmdrestriction, p + 1, -1);
711 else charlist = substring(cmdrestriction, p + 1, q - (p + 1));
713 // in case we ever want to allow semicolons in VoteCommand_checknasty
714 // charlist = strreplace("^^", ";", charlist);
718 // verify the arg only contains allowed chars
719 arg = argv(startpos);
720 checkmate = strlen(arg);
721 for (check = 0; check < checkmate; ++check)
722 if (strstrofs(charlist, substring(arg, check, 1), 0) < 0) return false;
723 // not allowed character
724 // all characters are allowed. FINE.
735 int VoteCommand_parse(entity caller, string vote_command, string vote_list, float startpos, int argc)
737 string first_command = argv(startpos);
738 int missing_chars = argv_start_index(startpos);
740 if (autocvar_sv_vote_limit > 0 && strlen(vote_command) > autocvar_sv_vote_limit)
743 if (!VoteCommand_checkinlist(first_command, vote_list)) return 0;
745 if (!VoteCommand_checkargs(startpos, argc)) return 0;
747 switch (MUTATOR_CALLHOOK(VoteCommand_Parse, caller, first_command, vote_command, startpos, argc))
749 case MUT_VOTEPARSE_CONTINUE: { break; }
750 case MUT_VOTEPARSE_SUCCESS: { return 1; }
751 case MUT_VOTEPARSE_INVALID: { return -1; }
752 case MUT_VOTEPARSE_UNACCEPTABLE: { return 0; }
755 switch (first_command) // now go through and parse the proper commands to adjust as needed.
758 case "kickban": // catch all kick/kickban commands
760 entity victim = GetIndexedEntity(argc, (startpos + 1));
761 float accepted = VerifyClientEntity(victim, true, false);
765 string reason = "No reason provided";
766 if(argc > next_token)
767 reason = substring(vote_command, argv_start_index(next_token) - missing_chars, -1);
769 string command_arguments = reason;
770 if (first_command == "kickban")
771 command_arguments = strcat(ftos(autocvar_g_ban_default_bantime), " ", ftos(autocvar_g_ban_default_masksize), " ~");
773 vote_parsed_command = strcat(first_command, " # ", ftos(etof(victim)), " ", command_arguments);
774 vote_parsed_display = sprintf("^1%s #%d ^7%s^1 %s", first_command, etof(victim), victim.netname, reason);
778 print_to(caller, strcat("vcall: ", GetClientErrorString(accepted, argv(startpos + 1)), ".\n"));
787 case "gotomap": // re-direct all map selection commands to gotomap
789 vote_command = ValidateMap(argv(startpos + 1), caller);
790 if (!vote_command) return -1;
791 vote_parsed_command = strcat("gotomap ", vote_command);
792 vote_parsed_display = strzone(strcat("^1", vote_parsed_command));
797 // TODO: replicate the old behaviour of being able to vote for maps from different modes on multimode servers (possibly support it in gotomap too)
798 // maybe fallback instead of aborting if map name is invalid?
801 vote_command = ValidateMap(argv(startpos + 1), caller);
802 if (!vote_command) return -1;
803 vote_parsed_command = strcat("nextmap ", vote_command);
804 vote_parsed_display = strzone(strcat("^1", vote_parsed_command));
809 case "timelimit": // include restrictions on the maximum votable time limit
811 float timelimit_vote = stof(argv(startpos + 1));
812 if(timelimit_vote > autocvar_timelimit_max || timelimit_vote < autocvar_timelimit_min)
814 print_to(caller, strcat("Invalid timelimit vote, accepted values are between ", ftos(autocvar_timelimit_min), " and ", ftos(autocvar_timelimit_max), "."));
817 timelimit_vote = bound(autocvar_timelimit_min, timelimit_vote, autocvar_timelimit_max);
818 vote_parsed_command = strcat("timelimit ", ftos(timelimit_vote));
819 vote_parsed_display = strzone(strcat("^1", vote_parsed_command));
826 // add a delay so that vote result can be seen and announcer can be heard
827 // if the vote is accepted
828 vote_parsed_command = strcat("defer 1 ", vote_command);
829 vote_parsed_display = strzone(strcat("^1", vote_command));
837 print_to(caller, "Game already started. Use the resetmatch command to restart the match.");
841 vote_parsed_command = vote_command;
842 vote_parsed_display = strzone(strcat("^1", vote_command));
848 vote_parsed_command = vote_command;
849 vote_parsed_display = strzone(strcat("^1", vote_command));
859 // =======================
860 // Command Sub-Functions
861 // =======================
863 void VoteCommand_abstain(int request, entity caller) // CLIENT ONLY
867 case CMD_REQUEST_COMMAND:
869 if (PlayerInList(caller, autocvar_g_voteban_list)) // voteban
871 print_to(caller, "^1You are banned from voting.");
872 Send_Notification(NOTIF_ONE, caller, MSG_CENTER, CENTER_VOTEBANYN);
876 if (!vote_called) { print_to(caller, "^1No vote called."); }
877 else if (caller.vote_selection != VOTE_SELECT_NULL && !autocvar_sv_vote_change)
879 print_to(caller, "^1You have already voted.");
882 else // everything went okay, continue changing vote
884 print_to(caller, "^1You abstained from your vote.");
885 caller.vote_selection = VOTE_SELECT_ABSTAIN;
887 if (!autocvar_sv_vote_singlecount)
895 case CMD_REQUEST_USAGE:
897 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote abstain"));
898 print_to(caller, " No arguments required.");
904 void print_available_commands_to(entity caller)
906 print_to(caller, strcat("You can call a vote for or execute these commands: ^3", autocvar_sv_vote_commands, "^7 and maybe further ^3arguments^7"));
909 void VoteCommand_call(int request, entity caller, int argc, string vote_command) // BOTH
913 case CMD_REQUEST_COMMAND:
915 float tmp_playercount = 0;
918 if (PlayerInList(caller, autocvar_g_voteban_list)) // voteban
920 print_to(caller, "^1You are banned from calling a vote.");
921 Send_Notification(NOTIF_ONE, caller, MSG_CENTER, CENTER_VOTEBAN);
925 vote_command = VoteCommand_extractcommand(vote_command, 2, argc);
927 if (!autocvar_sv_vote_call && caller)
929 print_to(caller, "^1Vote calling is not allowed.");
931 else if (!autocvar_sv_vote_gamestart && time < game_starttime)
933 print_to(caller, "^1Vote calling is not allowed before the match has started.");
935 else if (vote_called)
937 print_to(caller, "^1There is already a vote called.");
939 else if (!spectators_allowed && (caller && !IS_PLAYER(caller)))
941 print_to(caller, "^1Only players can call a vote.");
943 else if (caller && !IS_CLIENT(caller))
945 print_to(caller, "^1Only connected clients can vote.");
947 else if (timeout_status && vote_command != "timein")
949 print_to(caller, "^1You can not call a vote while a timeout is active.");
951 else if (caller && (time < caller.vote_waittime))
953 print_to(caller, strcat("^1You have to wait ^2", ftos(ceil(caller.vote_waittime - time)), "^1 seconds before you can again call a vote."));
955 else if (!VoteCommand_checknasty(vote_command))
957 print_to(caller, "^1Syntax error in command.");
959 else if ((parse_error = VoteCommand_parse(caller, vote_command, autocvar_sv_vote_commands, 2, argc)) <= 0)
963 if (vote_called_command == "")
964 VoteCommand_call(CMD_REQUEST_USAGE, caller, argc, vote_command);
966 print_to(caller, "^1This command is not acceptable or not available.");
969 else // everything went okay, continue with calling the vote
971 vote_caller = caller; // remember who called the vote
972 vote_caller_name = strzone(GetCallerName(vote_caller));
973 vote_called = VOTE_NORMAL;
974 vote_called_command = strzone(vote_parsed_command);
975 vote_called_display = strzone(vote_parsed_display);
976 vote_endtime = time + autocvar_sv_vote_timeout;
980 caller.vote_selection = VOTE_SELECT_ACCEPT;
981 caller.vote_waittime = time + autocvar_sv_vote_wait;
985 FOREACH_CLIENT(IS_REAL_CLIENT(it), { ++tmp_playercount; });
987 bprint("\{1}^2* ^3", OriginalCallerName(), "^2 calls a vote for ", vote_called_display, "\n");
988 if (autocvar_sv_vote_debug)
989 bprint("\{1}^2* ^3", "^6DEBUG MODE ACTIVE: bots can vote too\n"); // so servers don't forget it on
990 if (autocvar_sv_eventlog)
991 GameLogEcho(strcat(":vote:vcall:", ftos(vote_caller.playerid), ":", vote_called_display));
992 Nagger_VoteChanged();
993 VoteCount(true); // needed if you are the only one
995 if (tmp_playercount > 1 && vote_called != VOTE_NULL)
996 Send_Notification(NOTIF_ALL, NULL, MSG_ANNCE, ANNCE_VOTE_CALL);
1003 case CMD_REQUEST_USAGE:
1005 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote call <command>"));
1006 print_to(caller, " Where <command> is the command to request a vote upon.");
1007 print_to(caller, strcat("Examples: ", GetCommandPrefix(caller), " vote call gotomap dance"));
1008 print_to(caller, strcat(" ", GetCommandPrefix(caller), " vote call endmatch"));
1009 print_available_commands_to(caller);
1010 print_to(caller, "Shortcuts: ^2vcall <command>, vend, vmap, vkick, ...");
1016 void VoteCommand_master(int request, entity caller, int argc, string vote_command) // CLIENT ONLY
1020 case CMD_REQUEST_COMMAND:
1022 if (autocvar_sv_vote_master)
1024 switch (strtolower(argv(2)))
1029 vote_command = VoteCommand_extractcommand(vote_command, 3, argc);
1031 if (!caller.vote_master)
1032 print_to(caller, "^1You do not have vote master privileges.");
1033 else if (!VoteCommand_checknasty(vote_command))
1035 print_to(caller, "^1Syntax error in command.");
1037 else if ((parse_error = VoteCommand_parse(caller, vote_command, strcat(autocvar_sv_vote_commands, " ", autocvar_sv_vote_master_commands), 3, argc)) <= 0)
1039 if(parse_error == 0)
1041 if (vote_called_command == "")
1042 VoteCommand_master(CMD_REQUEST_USAGE, caller, argc, vote_command);
1044 print_to(caller, "^1This command is not acceptable or not available.");
1047 else // everything went okay, proceed with command
1049 localcmd(strcat(vote_parsed_command, "\n"));
1050 print_to(caller, strcat("Executing command '", vote_parsed_display, "' on server."));
1051 bprint("\{1}^2* ^3", GetCallerName(caller), "^2 used their ^3master^2 status to do \"^2", vote_parsed_display, "^2\".\n");
1052 if (autocvar_sv_eventlog)
1053 GameLogEcho(strcat(":vote:vdo:", ftos(caller.playerid), ":", vote_parsed_display));
1061 if (autocvar_sv_vote_master_password == "") { print_to(caller, "^1Login to vote master is not allowed."); }
1062 else if (caller.vote_master)
1064 print_to(caller, "^1You are already logged in as vote master.");
1066 else if (autocvar_sv_vote_master_password != argv(3))
1068 print_to(caller, strcat("Rejected vote master login from ", GetCallerName(caller)));
1070 else // everything went okay, proceed with giving this player master privilages
1072 caller.vote_master = true;
1073 print_to(caller, strcat("Accepted vote master login from ", GetCallerName(caller)));
1074 bprint("\{1}^2* ^3", GetCallerName(caller), "^2 logged in as ^3master^2\n");
1075 if (autocvar_sv_eventlog)
1076 GameLogEcho(strcat(":vote:vlogin:", ftos(caller.playerid)));
1082 default: // calling a vote for master
1084 if (!autocvar_sv_vote_master_callable) { print_to(caller, "^1Vote to become vote master is not allowed."); }
1085 else if (vote_called)
1087 print_to(caller, "^1There is already a vote called.");
1089 else if (!spectators_allowed && (caller && !IS_PLAYER(caller)))
1091 print_to(caller, "^1Only players can call a vote.");
1093 else if (timeout_status)
1095 print_to(caller, "^1You can not call a vote while a timeout is active.");
1097 else // everything went okay, continue with creating vote
1099 vote_caller = caller;
1100 vote_caller_name = strzone(GetCallerName(vote_caller));
1101 vote_called = VOTE_MASTER;
1102 vote_called_command = strzone("XXX");
1103 vote_called_display = strzone("^3master");
1104 vote_endtime = time + autocvar_sv_vote_timeout;
1106 caller.vote_selection = VOTE_SELECT_ACCEPT;
1107 caller.vote_waittime = time + autocvar_sv_vote_wait;
1109 bprint("\{1}^2* ^3", OriginalCallerName(), "^2 calls a vote to become ^3master^2.\n");
1110 if (autocvar_sv_eventlog)
1111 GameLogEcho(strcat(":vote:vcall:", ftos(vote_caller.playerid), ":", vote_called_display));
1112 Nagger_VoteChanged();
1113 VoteCount(true); // needed if you are the only one
1120 else { print_to(caller, "^1Master control of voting is not allowed."); }
1126 case CMD_REQUEST_USAGE:
1128 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote master [<action> [<command> | <password>]]"));
1129 print_to(caller, " If <action> is left blank, it calls a vote for you to become master.");
1130 print_to(caller, " Otherwise it can be either 'do' (to run <command>) or 'login' as master.");
1136 void VoteCommand_no(int request, entity caller) // CLIENT ONLY
1140 case CMD_REQUEST_COMMAND:
1142 if (PlayerInList(caller, autocvar_g_voteban_list)) // voteban
1144 print_to(caller, "^1You are banned from voting.");
1145 Send_Notification(NOTIF_ONE, caller, MSG_CENTER, CENTER_VOTEBANYN);
1149 if (!vote_called) { print_to(caller, "^1No vote called."); }
1150 else if (caller.vote_selection != VOTE_SELECT_NULL && !autocvar_sv_vote_change)
1152 print_to(caller, "^1You have already voted.");
1154 else if (((caller == vote_caller) || caller.vote_master) && autocvar_sv_vote_no_stops_vote)
1156 VoteStop(caller, true);
1159 else // everything went okay, continue changing vote
1161 print_to(caller, "^1You rejected the vote.");
1162 caller.vote_selection = VOTE_SELECT_REJECT;
1163 msg_entity = caller;
1164 if (!autocvar_sv_vote_singlecount)
1172 case CMD_REQUEST_USAGE:
1174 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote no"));
1175 print_to(caller, " No arguments required.");
1181 void VoteCommand_status(int request, entity caller) // BOTH
1185 case CMD_REQUEST_COMMAND:
1187 if (vote_called) print_to(caller, strcat("^7Vote for ", vote_called_display, "^7 called by ^7", OriginalCallerName(), "^7."));
1188 else print_to(caller, "^1No vote called.");
1194 case CMD_REQUEST_USAGE:
1196 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote status"));
1197 print_to(caller, " No arguments required.");
1203 void VoteCommand_stop(int request, entity caller) // BOTH
1207 case CMD_REQUEST_COMMAND:
1209 if (!vote_called) print_to(caller, "^1No vote called.");
1210 else if ((caller == vote_caller) || !caller || caller.vote_master) VoteStop(caller, false);
1211 else print_to(caller, "^1You are not allowed to stop that vote.");
1216 case CMD_REQUEST_USAGE:
1218 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote stop"));
1219 print_to(caller, " No arguments required.");
1225 void VoteCommand_yes(int request, entity caller) // CLIENT ONLY
1229 case CMD_REQUEST_COMMAND:
1231 if (PlayerInList(caller, autocvar_g_voteban_list)) // voteban
1233 print_to(caller, "^1You are banned from voting.");
1234 Send_Notification(NOTIF_ONE, caller, MSG_CENTER, CENTER_VOTEBANYN);
1238 if (!vote_called) { print_to(caller, "^1No vote called."); }
1239 else if (caller.vote_selection != VOTE_SELECT_NULL && !autocvar_sv_vote_change)
1241 print_to(caller, "^1You have already voted.");
1243 else // everything went okay, continue changing vote
1245 print_to(caller, "^1You accepted the vote.");
1246 caller.vote_selection = VOTE_SELECT_ACCEPT;
1247 msg_entity = caller;
1248 if (!autocvar_sv_vote_singlecount)
1256 case CMD_REQUEST_USAGE:
1258 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote yes"));
1259 print_to(caller, " No arguments required.");
1265 /* use this when creating a new command, making sure to place it in alphabetical order... also,
1266 ** ADD ALL NEW COMMANDS TO commands.cfg WITH PROPER ALIASES IN THE SAME FASHION!
1267 void VoteCommand_(int request)
1271 case CMD_REQUEST_COMMAND:
1278 case CMD_REQUEST_USAGE:
1280 print_to(caller, strcat("\nUsage:^3 ", GetCommandPrefix(caller), " vote ");
1281 print_to(caller, " No arguments required.");
1289 // ================================
1290 // Macro system for vote commands
1291 // ================================
1293 // Do not hard code aliases for these, instead create them in commands.cfg... also: keep in alphabetical order, please ;)
1294 #define VOTE_COMMANDS(request, caller, arguments, command) \
1295 VOTE_COMMAND("abstain", VoteCommand_abstain(request, caller), "Abstain your vote in current vote", VC_ASGNMNT_CLIENTONLY) \
1296 VOTE_COMMAND("call", VoteCommand_call(request, caller, arguments, command), "Create a new vote for players to decide on", VC_ASGNMNT_BOTH) \
1297 VOTE_COMMAND("help", VoteCommand_macro_help(caller, arguments), "Shows this information", VC_ASGNMNT_BOTH) \
1298 VOTE_COMMAND("master", VoteCommand_master(request, caller, arguments, command), "Full control over all voting and vote commands", VC_ASGNMNT_CLIENTONLY) \
1299 VOTE_COMMAND("no", VoteCommand_no(request, caller), "Select no in current vote", VC_ASGNMNT_CLIENTONLY) \
1300 VOTE_COMMAND("status", VoteCommand_status(request, caller), "Prints information about current vote", VC_ASGNMNT_BOTH) \
1301 VOTE_COMMAND("stop", VoteCommand_stop(request, caller), "Immediately end a vote", VC_ASGNMNT_BOTH) \
1302 VOTE_COMMAND("yes", VoteCommand_yes(request, caller), "Select yes in current vote", VC_ASGNMNT_CLIENTONLY) \
1305 void VoteCommand_macro_help(entity caller, int argc)
1307 string command_origin = GetCommandPrefix(caller);
1309 if (argc == 2 || argv(2) == "help") // help display listing all commands
1311 print_to(caller, "\nVoting commands:\n");
1312 #define VOTE_COMMAND(name, function, description, assignment) \
1313 { if (Votecommand_check_assignment(caller, assignment)) { print_to(caller, strcat(" ^2", name, "^7: ", description)); } }
1315 VOTE_COMMANDS(0, caller, 0, "");
1318 print_to(caller, strcat("\nUsage:^3 ", command_origin, " vote <command>^7, where possible commands are listed above.\n"));
1319 print_to(caller, strcat("For help about a specific command, type ", command_origin, " vote help <command>"));
1320 print_available_commands_to(caller);
1322 else // usage for individual command
1324 #define VOTE_COMMAND(name, function, description, assignment) \
1325 { if (Votecommand_check_assignment(caller, assignment)) { if (name == strtolower(argv(2))) { function; return; } } }
1327 VOTE_COMMANDS(CMD_REQUEST_USAGE, caller, argc, "");
1330 string cvarname = strcat("sv_vote_command_help_", argv(2));
1331 if(cvar_type(cvarname) & CVAR_TYPEFLAG_EXISTS)
1332 wordwrap_sprint(caller, cvar_string(cvarname), 1000);
1333 else if (argv(2) != "")
1334 print_to(caller, "No documentation exists for this vote");
1338 float VoteCommand_macro_command(entity caller, int argc, string vote_command)
1340 #define VOTE_COMMAND(name, function, description, assignment) \
1341 { if (Votecommand_check_assignment(caller, assignment)) { if (name == strtolower(argv(1))) { function; return true; } } }
1343 VOTE_COMMANDS(CMD_REQUEST_COMMAND, caller, argc, vote_command);
1350 // ======================================
1351 // Main function handling vote commands
1352 // ======================================
1354 void VoteCommand(int request, entity caller, int argc, string vote_command)
1356 // Guide for working with argc arguments by example:
1357 // argc: 1 - 2 - 3 - 4
1358 // argv: 0 - 1 - 2 - 3
1359 // cmd vote - master - login - password
1363 case CMD_REQUEST_COMMAND:
1365 if (VoteCommand_macro_command(caller, argc, vote_command)) return;
1369 print_to(caller, strcat(((argv(1) != "") ? strcat("Unknown vote command \"", argv(1), "\"") : "No command provided"), ". For a list of supported commands, try ", GetCommandPrefix(caller), " vote help.\n"));
1370 case CMD_REQUEST_USAGE:
1372 VoteCommand_macro_help(caller, argc);