1 // ================================================
2 // Unified notification system, written by Samual
3 // Last updated: August, 2013
4 // ================================================
6 string Get_Notif_TypeName(float net_type)
10 case MSG_ANNCE: return "MSG_ANNCE";
11 case MSG_INFO: return "MSG_INFO";
12 case MSG_CENTER: return "MSG_CENTER";
13 case MSG_CENTER_CPID: return "MSG_CENTER_CPID";
14 case MSG_MULTI: return "MSG_MULTI";
15 case MSG_CHOICE: return "MSG_CHOICE";
17 backtrace(sprintf("Get_Notif_TypeName(%d): Improper net type!\n", net_type));
21 entity Get_Notif_Ent(float net_type, float net_name)
25 case MSG_ANNCE: return msg_annce_notifs[net_name - 1];
26 case MSG_INFO: return msg_info_notifs[net_name - 1];
27 case MSG_CENTER: return msg_center_notifs[net_name - 1];
28 case MSG_MULTI: return msg_multi_notifs[net_name - 1];
29 case MSG_CHOICE: return msg_choice_notifs[net_name - 1];
31 backtrace(sprintf("Get_Notif_Ent(%d, %d): Improper net type!\n", net_type, net_name));
36 #ifdef NOTIFICATIONS_DEBUG
37 string Get_Notif_BroadcastName(float broadcast)
41 case NOTIF_ONE: return "NOTIF_ONE";
42 case NOTIF_ONE_ONLY: return "NOTIF_ONE_ONLY";
43 case NOTIF_ALL_EXCEPT: return "NOTIF_ALL_EXCEPT";
44 case NOTIF_ALL: return "NOTIF_ALL";
45 case NOTIF_TEAM: return "NOTIF_TEAM";
46 case NOTIF_TEAM_EXCEPT: return "NOTIF_TEAM_EXCEPT";
48 backtrace(sprintf("Get_Notif_BroadcastName(%d): Improper broadcast!\n", broadcast));
54 string Notification_CheckArgs_TypeName(float net_type, float net_name)
56 // check supplied type and name for errors
57 string checkargs = "";
58 #define CHECKARG_TYPENAME(type) case MSG_##type##: \
59 { if(!net_name || (net_name > NOTIF_##type##_COUNT)) \
60 { checkargs = sprintf("Improper name: %d!", net_name); } break; }
63 CHECKARG_TYPENAME(ANNCE)
64 CHECKARG_TYPENAME(INFO)
65 CHECKARG_TYPENAME(CENTER)
66 CHECKARG_TYPENAME(MULTI)
67 CHECKARG_TYPENAME(CHOICE)
68 default: { checkargs = sprintf("Improper type: %d!", checkargs, net_type); break; }
70 #undef CHECKARG_TYPENAME
75 string Notification_CheckArgs(
76 float broadcast, entity client,
77 float net_type, float net_name)
79 // check supplied broadcast, target, type, and name for errors
80 string checkargs = Notification_CheckArgs_TypeName(net_type, net_name);
81 if(checkargs != "") { checkargs = strcat(checkargs, " "); }
87 if(IS_NOT_A_CLIENT(client))
88 { checkargs = sprintf("%sNo client provided!", checkargs); }
92 case NOTIF_ALL_EXCEPT:
94 if(IS_NOT_A_CLIENT(client))
95 { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
102 { checkargs = sprintf("%sEntity provided when world was required!", checkargs); }
109 { checkargs = sprintf("%sTeamplay not active!", checkargs); }
110 //else if (!client.team) { checkargs = sprintf("%sNo team provided!", checkargs); }
114 case NOTIF_TEAM_EXCEPT:
117 { checkargs = sprintf("%sTeamplay not active!", checkargs); }
118 else if(IS_NOT_A_CLIENT(client))
119 { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
123 default: { checkargs = sprintf("%sImproper broadcast: %d!", checkargs, broadcast); break; }
128 float Notification_ShouldSend(float broadcast, entity to_client, entity other_client)
132 case NOTIF_ONE: // send to one client and their spectator
135 (to_client == other_client)
140 (to_client.enemy == other_client)
145 case NOTIF_ONE_ONLY: // send ONLY to one client
147 if(to_client == other_client) { return TRUE; }
150 case NOTIF_TEAM: // send only to X team and their spectators
153 (to_client.team == other_client.team)
158 (to_client.enemy.team == other_client.team)
163 case NOTIF_TEAM_EXCEPT: // send only to X team and their spectators, except for Y person and their spectators
166 (to_client != other_client)
169 (to_client.team == other_client.team)
175 (to_client.enemy != other_client)
177 (to_client.enemy.team == other_client.team)
184 case NOTIF_ALL: // send to everyone
188 case NOTIF_ALL_EXCEPT: // send to everyone except X person and their spectators
191 (to_client != other_client)
196 (to_client.enemy == other_client)
207 // ===============================
208 // Initialization Core Functions
209 // ===============================
211 // used by restartnotifs command to initialize notifications
212 void Destroy_Notification_Entity(entity notif)
214 if(notif.nent_name != "") { strunzone(notif.nent_name); }
215 if(notif.nent_snd != "") { strunzone(notif.nent_snd); }
216 if(notif.nent_args != "") { strunzone(notif.nent_args); }
217 if(notif.nent_hudargs != "") { strunzone(notif.nent_hudargs); }
218 if(notif.nent_icon != "") { strunzone(notif.nent_icon); }
219 if(notif.nent_durcnt != "") { strunzone(notif.nent_durcnt); }
220 if(notif.nent_string != "") { strunzone(notif.nent_string); }
224 void Destroy_All_Notifications(void)
229 #define DESTROY_LOOP(type,count) \
230 for(i = 1; i <= count; ++i) \
232 notif = Get_Notif_Ent(type, i); \
233 if (!notif) { backtrace("Destroy_All_Notifications(): Missing notification entity!\n"); return; } \
234 Destroy_Notification_Entity(notif); \
237 // kill all networked notifications and centerprints
239 Kill_Notification(NOTIF_ALL, world, 0, 0);
241 reset_centerprint_messages();
244 // kill all real notification entities
245 DESTROY_LOOP(MSG_ANNCE, NOTIF_ANNCE_COUNT)
246 DESTROY_LOOP(MSG_INFO, NOTIF_INFO_COUNT)
247 DESTROY_LOOP(MSG_CENTER, NOTIF_CENTER_COUNT)
248 DESTROY_LOOP(MSG_MULTI, NOTIF_MULTI_COUNT)
249 DESTROY_LOOP(MSG_CHOICE, NOTIF_CHOICE_COUNT)
253 string Process_Notif_Line(
262 if(typeid == MSG_INFO)
264 if((chat && autocvar_notification_allow_chatboxprint)
265 || (autocvar_notification_allow_chatboxprint == 2))
267 // pass 1: add ETX char at beginning of line
268 input = strcat("\{3}", input);
270 // pass 2: add ETX char at end of each new line (so that
271 // messages with multiple lines are put through chatbox too)
272 input = strreplace("\n", "\n\{3}", input);
274 // pass 3: strip trailing ETX char
275 if(substring(input, (strlen(input) - 1), 1) == "\{3}")
276 { input = substring(input, 0, (strlen(input) - 1)); }
281 // done to both MSG_INFO and MSG_CENTER
282 if(substring(input, (strlen(input) - 1), 1) == "\n")
286 "^1TRAILING NEW LINE AT END OF NOTIFICATION: ",
287 "^7net_type = %s, net_name = %s, string = %s.\n"
294 input = substring(input, 1, (strlen(input) - 1));
300 string Process_Notif_Args(
306 string selected, remaining = args;
309 for(;(remaining != "");)
311 selected = car(remaining); remaining = cdr(remaining);
315 case 1: // normal args
317 if(sel_num == NOTIF_MAX_ARGS)
321 "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
322 "^7net_type = %s, net_name = %s, max args = %d.\n"
332 switch(strtolower(selected))
334 #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { ++sel_num; break; }
335 #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { ++sel_num; break; }
336 #define ARG_CASE_ARG_CS_SV(selected,result) case selected: { ++sel_num; break; }
337 #define ARG_CASE_ARG_CS(selected,result) case selected: { ++sel_num; break; }
338 #define ARG_CASE_ARG_SV(selected,result) case selected: { ++sel_num; break; }
339 #define ARG_CASE_ARG_DC(selected,result)
340 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
343 #undef ARG_CASE_ARG_DC
344 #undef ARG_CASE_ARG_SV
345 #undef ARG_CASE_ARG_CS
346 #undef ARG_CASE_ARG_CS_SV
347 #undef ARG_CASE_ARG_CS_SV_DC
348 #undef ARG_CASE_ARG_CS_SV_HA
353 "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
354 "^7net_type = %s, net_name = %s, args arg = '%s'.\n"
368 if(sel_num == NOTIF_MAX_HUDARGS)
372 "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
373 "^7net_type = %s, net_name = %s, max hudargs = %d.\n"
383 switch(strtolower(selected))
385 #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { ++sel_num; break; }
386 #define ARG_CASE_ARG_CS_SV_DC(selected,result)
387 #define ARG_CASE_ARG_CS_SV(selected,result)
388 #define ARG_CASE_ARG_CS(selected,result)
389 #define ARG_CASE_ARG_SV(selected,result)
390 #define ARG_CASE_ARG_DC(selected,result)
391 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
394 #undef ARG_CASE_ARG_DC
395 #undef ARG_CASE_ARG_SV
396 #undef ARG_CASE_ARG_CS
397 #undef ARG_CASE_ARG_CS_SV
398 #undef ARG_CASE_ARG_CS_SV_DC
399 #undef ARG_CASE_ARG_CS_SV_HA
404 "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
405 "^7net_type = %s, net_name = %s, hudargs arg = '%s'.\n"
419 if(sel_num == NOTIF_MAX_DURCNT)
423 "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
424 "^7net_type = %s, net_name = %s, max durcnt = %d.\n"
434 switch(strtolower(selected))
436 #define ARG_CASE_ARG_CS_SV_HA(selected,result)
437 #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { ++sel_num; break; }
438 #define ARG_CASE_ARG_CS_SV(selected,result)
439 #define ARG_CASE_ARG_CS(selected,result)
440 #define ARG_CASE_ARG_SV(selected,result)
441 #define ARG_CASE_ARG_DC(selected,result) case selected: { ++sel_num; break; }
442 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
445 #undef ARG_CASE_ARG_DC
446 #undef ARG_CASE_ARG_SV
447 #undef ARG_CASE_ARG_CS
448 #undef ARG_CASE_ARG_CS_SV
449 #undef ARG_CASE_ARG_CS_SV_DC
450 #undef ARG_CASE_ARG_CS_SV_HA
453 if(ftos(stof(selected)) != "") { ++sel_num; }
458 "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
459 "^7net_type = %s, net_name = %s, durcnt arg = '%s'.\n"
477 void Create_Notification_Entity(
490 /* MSG_INFO & MSG_CENTER */
509 // =====================
510 // Global Entity Setup
511 // =====================
512 entity notif = spawn();
517 msg_annce_notifs[nameid - 1] = notif;
518 notif.classname = "msg_annce_notification";
523 msg_info_notifs[nameid - 1] = notif;
524 notif.classname = "msg_info_notification";
529 msg_center_notifs[nameid - 1] = notif;
530 notif.classname = "msg_center_notification";
535 msg_multi_notifs[nameid - 1] = notif;
536 notif.classname = "msg_multi_notification";
541 msg_choice_notifs[nameid - 1] = notif;
542 notif.classname = "msg_choice_notification";
550 "^1NOTIFICATION WITH IMPROPER TYPE: ",
551 "^7net_type = %d, net_name = %s.\n"
556 return; // It's not possible to recover from this one
559 notif.nent_default = var_default;
560 notif.nent_enabled = (1 <= var_cvar);
561 notif.nent_type = typeid;
562 notif.nent_id = nameid;
563 notif.nent_name = strzone(namestring);
565 string typestring = Get_Notif_TypeName(typeid);
567 // Other pre-notif-setup requisites
570 // ====================
571 // Notification Setup
572 // ====================
577 // Set MSG_ANNCE information and handle precaching
579 if (!(GENTLE && (var_cvar == 1)))
583 if(notif.nent_enabled)
585 precache_sound(sprintf("announcer/%s/%s.wav", autocvar_cl_announcer, snd));
586 notif.nent_channel = channel;
587 notif.nent_snd = strzone(snd);
588 notif.nent_vol = vol;
589 notif.nent_position = position;
596 "^1NOTIFICATION WITH NO SOUND: ",
597 "^7net_type = %s, net_name = %s.\n"
605 else { notif.nent_enabled = FALSE; }
607 notif.nent_enabled = FALSE;
616 // Set MSG_INFO and MSG_CENTER string/float counts
617 notif.nent_stringcount = strnum;
618 notif.nent_floatcount = flnum;
620 // Only initialize arguments if we're either a client or on a dedicated server
622 float should_process_args = server_is_dedicated;
624 float should_process_args = TRUE;
627 if(should_process_args)
629 // ========================
630 // Process Main Arguments
631 // ========================
636 notif.nent_args = strzone(
637 Process_Notif_Args(1, args, typestring, namestring));
639 else if((hudargs == "") && (durcnt ==""))
643 "^1NOTIFICATION HAS ARG COUNTS BUT NO ARGS OR HUDARGS OR DURCNT: ",
644 "^7net_type = %s, net_name = %s, strnum = %d, flnum = %d\n"
656 notif.nent_args = strzone(
657 Process_Notif_Args(1, args, typestring, namestring));
661 // =======================================
662 // Process HUD and Centerprint Arguments
663 // Only processed on CSQC, as these
664 // args are only for HUD features.
665 // =======================================
669 notif.nent_hudargs = strzone(
670 Process_Notif_Args(2, hudargs, typestring, namestring));
672 if(icon != "") { notif.nent_icon = strzone(icon); }
677 "^1NOTIFICATION HAS HUDARGS BUT NO ICON: ",
678 "^7net_type = %s, net_name = %s.\n"
690 "^1NOTIFICATION HAS ICON BUT NO HUDARGS: ",
691 "^7net_type = %s, net_name = %s.\n"
701 notif.nent_durcnt = strzone(
702 Process_Notif_Args(3, durcnt, typestring, namestring));
704 if(cpid != NO_MSG) { notif.nent_cpid = cpid; }
709 "^1NOTIFICATION HAS DURCNT BUT NO CPID: ",
710 "^7net_type = %s, net_name = %s.\n"
718 else if(cpid != NO_MSG) { notif.nent_cpid = cpid; }
722 // ======================
723 // Process Notif String
724 // ======================
725 #define SET_NOTIF_STRING(string,stringname) \
726 notif.nent_string = strzone(CCR( \
727 Process_Notif_Line( \
739 if(gentle != "") { SET_NOTIF_STRING(gentle, "GENTLE") }
740 else if(normal != "") { SET_NOTIF_STRING(normal, "NORMAL") }
742 else if(normal != "") { SET_NOTIF_STRING(normal, "NORMAL") }
744 #undef SET_NOTIF_STRING
746 // Check to make sure a string was chosen
747 if(notif.nent_string == "")
751 "^1EMPTY NOTIFICATION: ",
752 "^7net_type = %s, net_name = %s.\n"
766 // Set MSG_MULTI string/float counts
767 if((anncename == NO_MSG) && (infoname == NO_MSG) && (centername == NO_MSG))
771 "^1NOTIFICATION WITH NO SUBCALLS: ",
772 "^7net_type = %s, net_name = %s.\n"
781 // announcements don't actually need any arguments, so lets not even count them.
782 if(anncename != NO_MSG) { notif.nent_msgannce = msg_annce_notifs[anncename - 1]; }
784 float infoname_stringcount = 0, infoname_floatcount = 0;
785 float centername_stringcount = 0, centername_floatcount = 0;
787 if(infoname != NO_MSG)
789 notif.nent_msginfo = msg_info_notifs[infoname - 1];
790 infoname_stringcount = notif.nent_msginfo.nent_stringcount;
791 infoname_floatcount = notif.nent_msginfo.nent_floatcount;
794 if(centername != NO_MSG)
796 notif.nent_msgcenter = msg_center_notifs[centername - 1];
797 centername_stringcount = notif.nent_msgcenter.nent_stringcount;
798 centername_floatcount = notif.nent_msgcenter.nent_floatcount;
801 // set the requirements of THIS notification to the totals of its subcalls
802 notif.nent_stringcount = max(infoname_stringcount, centername_stringcount);
803 notif.nent_floatcount = max(infoname_floatcount, centername_floatcount);
811 if((chtype == NO_MSG) || (optiona == NO_MSG) || (optionb == NO_MSG))
815 "^1NOTIFICATION IS MISSING CHOICE PARAMS: ",
816 "^7net_type = %s, net_name = %s.\n"
829 notif.nent_optiona = msg_annce_notifs[optiona - 1];
830 notif.nent_optionb = msg_annce_notifs[optionb - 1];
835 notif.nent_optiona = msg_info_notifs[optiona - 1];
836 notif.nent_optionb = msg_info_notifs[optionb - 1];
841 notif.nent_optiona = msg_center_notifs[optiona - 1];
842 notif.nent_optionb = msg_center_notifs[optionb - 1];
847 notif.nent_optiona = msg_multi_notifs[optiona - 1];
848 notif.nent_optionb = msg_multi_notifs[optionb - 1];
851 case MSG_CHOICE: // should we REALLY allow nested options?...
853 notif.nent_optiona = msg_choice_notifs[optiona - 1];
854 notif.nent_optionb = msg_choice_notifs[optionb - 1];
862 "^1NOTIFICATION WITH IMPROPER TYPE: ",
863 "^7net_type = %d, net_name = %s.\n"
872 notif.nent_challow_def = challow_def; // 0: never allowed, 1: allowed in warmup, 2: always allowed
873 notif.nent_challow_var = challow_var; // 0: never allowed, 1: allowed in warmup, 2: always allowed
874 notif.nent_stringcount = max(notif.nent_optiona.nent_stringcount, notif.nent_optionb.nent_stringcount);
875 notif.nent_floatcount = max(notif.nent_optiona.nent_floatcount, notif.nent_optionb.nent_floatcount);
877 /*#ifdef NOTIFICATIONS_DEBUG
878 Debug_Notification(sprintf(
879 "Create_Notification_Entity(...): MSG_CHOICE: %s\n%s\n%s\n",
882 "^ optiona: %s %s : %d %d",
883 Get_Notif_TypeName(notif.nent_optiona.nent_type),
884 notif.nent_optiona.nent_name,
885 notif.nent_optiona.nent_stringcount,
886 notif.nent_optiona.nent_floatcount
889 "^ optionb: %s %s : %d %d",
890 Get_Notif_TypeName(notif.nent_optionb.nent_type),
891 notif.nent_optionb.nent_name,
892 notif.nent_optionb.nent_stringcount,
893 notif.nent_optionb.nent_floatcount
905 "^1NOTIFICATION WITH IMPROPER TYPE: ",
906 "^7net_type = %d, net_name = %s.\n"
916 // now check to see if any errors happened
919 notif.nent_enabled = FALSE; // disable the notification so it can't cause trouble
920 notif_global_error = TRUE; // throw the red flag that an error happened on init
929 // used by MSG_CHOICE to build list of choices
931 void Notification_GetCvars(void)
934 for(i = 0; i <= NOTIF_CHOICE_COUNT; ++i)
936 GetCvars_handleFloat(
939 msg_choice_choices[i],
940 sprintf("notification_%s", msg_choice_notifs[i].nent_name)
946 // used to output notifications.cfg file
947 void Dump_Notifications(float fh, float alsoprint)
949 #define NOTIF_WRITE(a) { \
951 if(alsoprint) { print(a); } }
952 #define NOTIF_WRITE_ENTITY(description) { \
955 "seta notification_%s \"%d\" \"%s\"\n", \
956 e.nent_name, e.nent_default, description \
958 NOTIF_WRITE(notif_msg) }
959 #define NOTIF_WRITE_ENTITY_CHOICE(descriptiona,descriptionb) { \
962 "seta notification_%s \"%d\" \"%s\"\n" \
963 "seta notification_%s_ALLOWED \"%d\" \"%s\"\n", \
964 e.nent_name, e.nent_default, descriptiona, \
965 e.nent_name, e.nent_challow_def, descriptionb \
967 NOTIF_WRITE(notif_msg) }
968 #define NOTIF_WRITE_HARDCODED(cvar,default,description) { \
971 "seta notification_%s \"%s\" \"%s\"\n", \
972 cvar, default, description \
974 NOTIF_WRITE(notif_msg) }
980 // Note: This warning only applies to the notifications.cfg file that is output...
982 // You ARE supposed to manually edit this function to add i.e. hard coded
983 // notification variables for mutators or game modes or such and then
984 // regenerate the notifications.cfg file from the new code.
986 NOTIF_WRITE("// ********************************************** //\n");
987 NOTIF_WRITE("// ** WARNING - DO NOT MANUALLY EDIT THIS FILE ** //\n");
988 NOTIF_WRITE("// ** ** //\n");
989 NOTIF_WRITE("// ** This file is automatically generated ** //\n");
990 NOTIF_WRITE("// ** by code with the command 'dumpnotifs'. ** //\n");
991 NOTIF_WRITE("// ** ** //\n");
992 NOTIF_WRITE("// ** If you add a new notification, please ** //\n");
993 NOTIF_WRITE("// ** regenerate this file with that command ** //\n");
994 NOTIF_WRITE("// ** making sure that the output matches ** //\n");
995 NOTIF_WRITE("// ** with the lists and defaults in code. ** //\n");
996 NOTIF_WRITE("// ** ** //\n");
997 NOTIF_WRITE("// ********************************************** //\n");
999 // These notifications will also append their string as a comment...
1000 // This is not necessary, and does not matter if they vary between config versions,
1001 // it is just a semi-helpful tool for those who want to manually change their user settings.
1003 NOTIF_WRITE(sprintf("\n// MSG_ANNCE notifications (count = %d):\n", NOTIF_ANNCE_COUNT));
1004 for(i = 1; i <= NOTIF_ANNCE_COUNT; ++i)
1006 e = Get_Notif_Ent(MSG_ANNCE, i);
1007 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1010 "Notification control cvar: 0 = disabled, 1 = enabled if gentle mode is off, 2 = always enabled)"
1014 NOTIF_WRITE(sprintf("\n// MSG_INFO notifications (count = %d):\n", NOTIF_INFO_COUNT));
1015 for(i = 1; i <= NOTIF_INFO_COUNT; ++i)
1017 e = Get_Notif_Ent(MSG_INFO, i);
1018 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1021 "Notification control cvar: 0 = off, 1 = print to console, "
1022 "2 = print to console and chatbox (if notification_allow_chatboxprint is enabled)"
1026 NOTIF_WRITE(sprintf("\n// MSG_CENTER notifications (count = %d):\n", NOTIF_CENTER_COUNT));
1027 for(i = 1; i <= NOTIF_CENTER_COUNT; ++i)
1029 e = Get_Notif_Ent(MSG_CENTER, i);
1030 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1033 "Notification control cvar: 0 = off, 1 = centerprint"
1037 NOTIF_WRITE(sprintf("\n// MSG_MULTI notifications (count = %d):\n", NOTIF_MULTI_COUNT));
1038 for(i = 1; i <= NOTIF_MULTI_COUNT; ++i)
1040 e = Get_Notif_Ent(MSG_MULTI, i);
1041 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1044 "Notification control cvar: 0 = off, 1 = trigger subcalls"
1048 NOTIF_WRITE(sprintf("\n// MSG_CHOICE notifications (count = %d):\n", NOTIF_CHOICE_COUNT));
1049 for(i = 1; i <= NOTIF_CHOICE_COUNT; ++i)
1051 e = Get_Notif_Ent(MSG_CHOICE, i);
1052 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1054 NOTIF_WRITE_ENTITY_CHOICE(
1055 "Notification control cvar: 0 = off, 1 = trigger option A subcall, 2 = trigger option B subcall",
1056 "Notification control cvar: 0 = off, 1 = allowed in warmup mode, 2 = always allowed"
1060 // edit these to match whichever cvars are used for specific notification options
1061 NOTIF_WRITE("\n// HARD CODED notification variables:\n");
1063 NOTIF_WRITE_HARDCODED(
1064 "allow_chatboxprint", "1",
1065 "Allow notifications to be printed to chat box by setting notification cvar to 2 "
1066 "(You can also set this cvar to 2 to force ALL notifications to be printed to the chatbox)"
1069 NOTIF_WRITE_HARDCODED(
1071 "Print extra debug information on all notification function calls "
1072 "(Requires -DNOTIFICATIONS_DEBUG flag to be enabled on QCSRC compilation)... "
1073 "0 = disabled, 1 = dprint, 2 = print"
1076 NOTIF_WRITE_HARDCODED(
1077 "errors_are_fatal", "1",
1078 "If a notification fails upon initialization, cause a Host_Error to stop the program"
1081 NOTIF_WRITE_HARDCODED(
1082 "item_centerprinttime", "1.5",
1083 "How long to show item information centerprint messages (like 'You got the Electro' or such)"
1086 NOTIF_WRITE_HARDCODED(
1087 "lifetime_mapload", "10",
1088 "Amount of time that notification entities last immediately at mapload (in seconds) "
1089 "to help prevent notifications from being lost on early init (like gamestart countdown)"
1092 NOTIF_WRITE_HARDCODED(
1093 "lifetime_runtime", "0.5",
1094 "Amount of time that notification entities last on the server during runtime (In seconds)"
1097 NOTIF_WRITE_HARDCODED(
1098 "server_allows_location", "1",
1099 "Server side cvar for allowing death messages to show location information too"
1102 NOTIF_WRITE_HARDCODED(
1103 "show_location", "0",
1104 "Append location information to MSG_INFO death/kill messages"
1107 NOTIF_WRITE_HARDCODED(
1108 "show_location_string", "",
1109 "Replacement string piped into sprintf, "
1110 "so you can do different messages like this: ' at the %s' or ' (near %s)'"
1113 NOTIF_WRITE_HARDCODED(
1115 "Print information about sprees in death/kill messages"
1118 NOTIF_WRITE_HARDCODED(
1119 "show_sprees_center", "1",
1120 "Show spree information in MSG_CENTER messages... "
1121 "0 = off, 1 = target (but only for first victim) and attacker"
1124 NOTIF_WRITE_HARDCODED(
1125 "show_sprees_center_specialonly", "1",
1126 "Don't show spree information in MSG_CENTER messages if it isn't an achievement"
1129 NOTIF_WRITE_HARDCODED(
1130 "show_sprees_info", "3",
1131 "Show spree information in MSG_INFO messages... "
1132 "0 = off, 1 = target only, 2 = attacker only, 3 = target and attacker"
1135 NOTIF_WRITE_HARDCODED(
1136 "show_sprees_info_newline", "1",
1137 "Show attacker spree information for MSG_INFO messages on a separate line than the death notification itself"
1140 NOTIF_WRITE_HARDCODED(
1141 "show_sprees_info_specialonly", "1",
1142 "Don't show attacker spree information in MSG_INFO messages if it isn't an achievement"
1145 NOTIF_WRITE(sprintf(
1147 "\n// Notification counts (total = %d): ",
1148 "MSG_ANNCE = %d, MSG_INFO = %d, MSG_CENTER = %d, MSG_MULTI = %d, MSG_CHOICE = %d\n"
1153 NOTIF_CENTER_COUNT +
1165 #undef NOTIF_WRITE_HARDCODED
1166 #undef NOTIF_WRITE_ENTITY
1171 // ===============================
1172 // Frontend Notification Pushing
1173 // ===============================
1175 #ifdef NOTIFICATIONS_DEBUG
1176 void Debug_Notification(string input)
1178 switch(autocvar_notification_debug)
1180 case 1: { dprint(input); break; }
1181 case 2: { print(input); break; }
1186 string Local_Notification_sprintf(
1187 string input, string args,
1188 string s1, string s2, string s3, string s4,
1189 float f1, float f2, float f3, float f4)
1191 #ifdef NOTIFICATIONS_DEBUG
1192 Debug_Notification(sprintf(
1193 "Local_Notification_sprintf('%s^7', '%s', %s, %s);\n",
1194 MakeConsoleSafe(input),
1196 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1197 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1203 for(sel_num = 0; sel_num < NOTIF_MAX_ARGS; ++sel_num) { arg_slot[sel_num] = ""; }
1207 for(sel_num = 0;(args != "");)
1209 selected = car(args); args = cdr(args);
1210 NOTIF_HIT_MAX(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
1211 switch(strtolower(selected))
1214 #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1215 #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1216 #define ARG_CASE_ARG_CS_SV(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1217 #define ARG_CASE_ARG_CS(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1218 #define ARG_CASE_ARG_SV(selected,result)
1219 #define ARG_CASE_ARG_DC(selected,result)
1221 #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1222 #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1223 #define ARG_CASE_ARG_CS_SV(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1224 #define ARG_CASE_ARG_CS(selected,result)
1225 #define ARG_CASE_ARG_SV(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1226 #define ARG_CASE_ARG_DC(selected,result)
1228 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
1231 #undef ARG_CASE_ARG_DC
1232 #undef ARG_CASE_ARG_SV
1233 #undef ARG_CASE_ARG_CS
1234 #undef ARG_CASE_ARG_CS_SV
1235 #undef ARG_CASE_ARG_CS_SV_DC
1236 #undef ARG_CASE_ARG_CS_SV_HA
1237 default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
1241 strcat(input, "\n"),
1253 void Local_Notification_sound(
1254 float soundchannel, string soundfile,
1255 float soundvolume, float soundposition)
1257 if((soundfile != prev_soundfile) || (time >= (prev_soundtime + autocvar_cl_announcer_antispam)))
1259 #ifdef NOTIFICATIONS_DEBUG
1260 Debug_Notification(sprintf(
1261 "Local_Notification_sound(world, %f, '%s', %f, %f);\n",
1264 "announcer/%s/%s.wav",
1265 autocvar_cl_announcer,
1277 "announcer/%s/%s.wav",
1278 autocvar_cl_announcer,
1285 if(prev_soundfile) { strunzone(prev_soundfile); }
1286 prev_soundfile = strzone(soundfile);
1287 prev_soundtime = time;
1291 #ifdef NOTIFICATIONS_DEBUG
1292 Debug_Notification(sprintf(
1294 "Local_Notification_sound(world, %f, '%s', %f, %f) ",
1295 "^1BLOCKED BY ANTISPAM:^7 prevsnd: '%s', timediff: %f, limit: %f\n"
1299 "announcer/%s/%s.wav",
1300 autocvar_cl_announcer,
1306 (time - prev_soundtime),
1307 autocvar_cl_announcer_antispam
1313 void Local_Notification_HUD_Notify_Push(
1314 string icon, string hudargs,
1315 string s1, string s2, string s3, string s4,
1316 float f1, float f2, float f3, float f4)
1320 arg_slot[0] = ""; arg_slot[1] = "";
1322 for(sel_num = 0;(hudargs != "");)
1324 selected = car(hudargs); hudargs = cdr(hudargs);
1325 NOTIF_HIT_MAX(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
1326 switch(strtolower(selected))
1328 #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1329 #define ARG_CASE_ARG_CS_SV_DC(selected,result)
1330 #define ARG_CASE_ARG_CS_SV(selected,result)
1331 #define ARG_CASE_ARG_CS(selected,result)
1332 #define ARG_CASE_ARG_SV(selected,result)
1333 #define ARG_CASE_ARG_DC(selected,result)
1334 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
1337 #undef ARG_CASE_ARG_DC
1338 #undef ARG_CASE_ARG_SV
1339 #undef ARG_CASE_ARG_CS
1340 #undef ARG_CASE_ARG_CS_SV
1341 #undef ARG_CASE_ARG_CS_SV_DC
1342 #undef ARG_CASE_ARG_CS_SV_HA
1343 default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
1346 #ifdef NOTIFICATIONS_DEBUG
1347 Debug_Notification(sprintf(
1348 "Local_Notification_HUD_Notify_Push('%s^7', '%s', %s, %s, %s);\n",
1351 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1352 sprintf("%d, %d, %d, %d", f1, f2, f3, f4),
1353 MakeConsoleSafe(sprintf("'%s^7', '%s^7'", stof(arg_slot[0]), stof(arg_slot[1])))
1356 HUD_Notify_Push(icon, arg_slot[0], arg_slot[1]);
1359 void Local_Notification_centerprint_generic(
1360 string input, string durcnt,
1361 float cpid, float f1, float f2)
1365 arg_slot[0] = ""; arg_slot[1] = "";
1367 for(sel_num = 0;(durcnt != "");)
1369 selected = car(durcnt); durcnt = cdr(durcnt);
1370 NOTIF_HIT_MAX(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic")
1371 switch(strtolower(selected))
1373 #define ARG_CASE_ARG_CS_SV_HA(selected,result)
1374 #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1375 #define ARG_CASE_ARG_CS_SV(selected,result)
1376 #define ARG_CASE_ARG_CS(selected,result)
1377 #define ARG_CASE_ARG_SV(selected,result)
1378 #define ARG_CASE_ARG_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1379 #define ARG_CASE(prog,selected,result) ARG_CASE_##prog(selected,result)
1382 #undef ARG_CASE_ARG_DC
1383 #undef ARG_CASE_ARG_SV
1384 #undef ARG_CASE_ARG_CS
1385 #undef ARG_CASE_ARG_CS_SV
1386 #undef ARG_CASE_ARG_CS_SV_DC
1387 #undef ARG_CASE_ARG_CS_SV_HA
1390 if(ftos(stof(selected)) != "") { arg_slot[sel_num] = selected; ++sel_num; }
1391 else { NOTIF_HIT_UNKNOWN(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic") }
1396 #ifdef NOTIFICATIONS_DEBUG
1397 Debug_Notification(sprintf(
1398 "Local_Notification_centerprint_generic('%s^7', '%s', %d, %d, %d, %d);\n",
1399 MakeConsoleSafe(input),
1406 centerprint_generic(cpid, input, stof(arg_slot[0]), stof(arg_slot[1]));
1410 void Local_Notification(float net_type, float net_name, ...count)
1412 // check if this should be aborted
1413 if(net_name == NOTIF_ABORT)
1415 #ifdef NOTIFICATIONS_DEBUG
1416 Debug_Notification(sprintf(
1417 "Local_Notification(%s, %s, ...);\n",
1418 Get_Notif_TypeName(net_type),
1425 // check supplied type and name for errors
1426 string checkargs = Notification_CheckArgs_TypeName(net_type, net_name);
1429 #ifdef NOTIFICATIONS_DEBUG
1430 Debug_Notification(sprintf(
1431 "Local_Notification(%s, %d, ...);\n",
1432 Get_Notif_TypeName(net_type),
1433 Get_Notif_Ent(net_type, net_name).nent_name
1436 backtrace(sprintf("Incorrect usage of Local_Notification: %s\n", checkargs));
1440 // retreive entity of this notification
1441 entity notif = Get_Notif_Ent(net_type, net_name);
1444 #ifdef NOTIFICATIONS_DEBUG
1445 Debug_Notification(sprintf(
1446 "Local_Notification(%s, %d, ...);\n",
1447 Get_Notif_TypeName(net_type),
1451 backtrace("Local_Notification: Could not find notification entity!\n");
1455 // check if the notification is enabled
1456 if (!notif.nent_enabled)
1458 #ifdef NOTIFICATIONS_DEBUG
1459 Debug_Notification(sprintf(
1460 "Local_Notification(%s, %s, ...): Entity was disabled...\n",
1461 Get_Notif_TypeName(net_type),
1468 string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
1469 string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
1470 string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
1471 string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
1472 float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
1473 float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
1474 float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
1475 float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
1477 #ifdef NOTIFICATIONS_DEBUG
1478 Debug_Notification(sprintf(
1479 "Local_Notification(%s, %s, %s, %s);\n",
1480 Get_Notif_TypeName(net_type),
1482 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1483 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1487 if((notif.nent_stringcount + notif.nent_floatcount) > count)
1491 "Not enough arguments for Local_Notification(%s, %s, ...)! ",
1492 "stringcount(%d) + floatcount(%d) > count(%d)\n",
1493 "Check the definition and function call for accuracy...?\n"
1495 Get_Notif_TypeName(net_type),
1497 notif.nent_stringcount,
1498 notif.nent_floatcount,
1503 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
1507 "Too many arguments for Local_Notification(%s, %s, ...)! ",
1508 "stringcount(%d) + floatcount(%d) < count(%d)\n",
1509 "Check the definition and function call for accuracy...?\n"
1511 Get_Notif_TypeName(net_type),
1513 notif.nent_stringcount,
1514 notif.nent_floatcount,
1525 Local_Notification_sound(
1532 backtrace("MSG_ANNCE on server?... Please notify Samual immediately!\n");
1540 Local_Notification_sprintf(
1547 if(notif.nent_icon != "")
1549 Local_Notification_HUD_Notify_Push(
1562 Local_Notification_centerprint_generic(
1563 Local_Notification_sprintf(
1577 if(notif.nent_msginfo)
1578 if(notif.nent_msginfo.nent_enabled)
1580 Local_Notification_WOVA(
1582 notif.nent_msginfo.nent_id,
1583 notif.nent_msginfo.nent_stringcount,
1584 notif.nent_msginfo.nent_floatcount,
1589 if(notif.nent_msgannce)
1590 if(notif.nent_msgannce.nent_enabled)
1592 Local_Notification_WOVA(
1594 notif.nent_msgannce.nent_id,
1599 if(notif.nent_msgcenter)
1600 if(notif.nent_msgcenter.nent_enabled)
1602 Local_Notification_WOVA(
1604 notif.nent_msgcenter.nent_id,
1605 notif.nent_msgcenter.nent_stringcount,
1606 notif.nent_msgcenter.nent_floatcount,
1616 entity found_choice;
1618 if(notif.nent_challow_var && (warmup_stage || (notif.nent_challow_var == 2)))
1620 switch(cvar_string(sprintf("notification_%s", notif.nent_name)))
1622 case 1: found_choice = notif.nent_optiona; break;
1623 case 2: found_choice = notif.nent_optionb; break;
1624 default: return; // not enabled anyway
1627 else { found_choice = notif.nent_optiona; }
1629 Local_Notification_WOVA(
1630 found_choice.nent_type,
1631 found_choice.nent_id,
1632 found_choice.nent_stringcount,
1633 found_choice.nent_floatcount,
1640 // WOVA = Without Variable Arguments
1641 void Local_Notification_WOVA(
1642 float net_type, float net_name,
1643 float stringcount, float floatcount,
1644 string s1, string s2, string s3, string s4,
1645 float f1, float f2, float f3, float f4)
1647 #define VARITEM(stringc,floatc,args) \
1648 if((stringcount == stringc) && (floatcount == floatc)) \
1649 { Local_Notification(net_type, net_name, args); return; }
1650 EIGHT_VARS_TO_VARARGS_VARLIST
1652 Local_Notification(net_type, net_name); // some notifications don't have any arguments at all
1656 // =========================
1657 // Notification Networking
1658 // =========================
1661 void Read_Notification(float is_new)
1663 float net_type = ReadByte();
1664 float net_name = ReadShort();
1668 if(net_type == MSG_CENTER_CPID)
1670 #ifdef NOTIFICATIONS_DEBUG
1671 Debug_Notification(sprintf(
1672 "Read_Notification(%d) at %f: net_type = %s, net_name = %d\n",
1675 Get_Notif_TypeName(net_type),
1682 if(net_name == 0) { reset_centerprint_messages(); }
1683 else if(net_name != NO_CPID)
1685 // in this case, net_name IS the cpid we want to kill
1686 centerprint_generic(net_name, "", 0, 0);
1691 "Read_Notification(%d) at %f: ^1TRIED TO KILL NO_CPID CENTERPRINT!\n",
1700 notif = Get_Notif_Ent(net_type, net_name);
1701 if (!notif) { backtrace("Read_Notification: Could not find notification entity!\n"); return; }
1703 #ifdef NOTIFICATIONS_DEBUG
1704 Debug_Notification(sprintf(
1705 "Read_Notification(%d) at %f: net_type = %s, net_name = %s\n",
1708 Get_Notif_TypeName(net_type),
1713 string s1 = ((0 < notif.nent_stringcount) ? ReadString() : "");
1714 string s2 = ((1 < notif.nent_stringcount) ? ReadString() : "");
1715 string s3 = ((2 < notif.nent_stringcount) ? ReadString() : "");
1716 string s4 = ((3 < notif.nent_stringcount) ? ReadString() : "");
1717 float f1 = ((0 < notif.nent_floatcount) ? ReadLong() : 0);
1718 float f2 = ((1 < notif.nent_floatcount) ? ReadLong() : 0);
1719 float f3 = ((2 < notif.nent_floatcount) ? ReadLong() : 0);
1720 float f4 = ((3 < notif.nent_floatcount) ? ReadLong() : 0);
1724 Local_Notification_WOVA(
1726 notif.nent_stringcount,
1727 notif.nent_floatcount,
1736 void Net_Notification_Remove()
1738 if (!self) { backtrace(sprintf("Net_Notification_Remove() at %f: Missing self!?\n", time)); return; }
1740 #ifdef NOTIFICATIONS_DEBUG
1741 Debug_Notification(sprintf(
1742 "Net_Notification_Remove() at %f: %s '%s - %s' notification\n",
1744 ((self.nent_net_name == -1) ? "Killed" : "Removed"),
1745 Get_Notif_TypeName(self.nent_net_type),
1746 self.owner.nent_name
1751 for(i = 0; i < 4; ++i) { if(self.nent_strings[i]) { strunzone(self.nent_strings[i]); } }
1755 float Net_Write_Notification(entity client, float sf)
1757 if(Notification_ShouldSend(self.nent_broadcast, client, self.nent_client))
1760 WriteByte(MSG_ENTITY, ENT_CLIENT_NOTIFICATION);
1761 WriteByte(MSG_ENTITY, self.nent_net_type);
1762 WriteShort(MSG_ENTITY, self.nent_net_name);
1763 for(i = 0; i < self.nent_stringcount; ++i) { WriteString(MSG_ENTITY, self.nent_strings[i]); }
1764 for(i = 0; i < self.nent_floatcount; ++i) { WriteLong(MSG_ENTITY, self.nent_floats[i]); }
1767 else { return FALSE; }
1770 void Kill_Notification(
1771 float broadcast, entity client,
1772 float net_type, float net_name)
1774 #ifdef NOTIFICATIONS_DEBUG
1775 Debug_Notification(sprintf(
1776 "Kill_Notification(%s, '%s', %s, %d);\n",
1777 Get_Notif_BroadcastName(broadcast),
1779 (net_type ? Get_Notif_TypeName(net_type) : "0"),
1784 string checkargs = Notification_CheckArgs(broadcast, client, 1, 1);
1785 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Kill_Notification: %s\n", checkargs)); return; }
1787 entity notif, net_notif;
1788 float killed_cpid = NO_CPID;
1794 killed_cpid = 0; // kill ALL centerprints
1802 entity notif = Get_Notif_Ent(net_type, net_name);
1803 if (!notif) { backtrace("Kill_Notification: Could not find notification entity!\n"); return; }
1806 killed_cpid = notif.nent_cpid;
1808 killed_cpid = NO_CPID;
1812 killed_cpid = 0; // kill ALL centerprints
1817 case MSG_CENTER_CPID:
1819 killed_cpid = net_name;
1824 if(killed_cpid != NO_CPID)
1826 net_notif = spawn();
1827 net_notif.classname = "net_kill_notification";
1828 net_notif.nent_broadcast = broadcast;
1829 net_notif.nent_client = client;
1830 net_notif.nent_net_type = MSG_CENTER_CPID;
1831 net_notif.nent_net_name = killed_cpid;
1832 Net_LinkEntity(net_notif, FALSE, autocvar_notification_lifetime_runtime, Net_Write_Notification);
1835 for(notif = world; (notif = find(notif, classname, "net_notification"));)
1839 if((killed_cpid != NO_CPID) && (notif.nent_net_type == MSG_CENTER))
1841 if(notif.owner.nent_cpid == killed_cpid)
1843 notif.nent_net_name = -1;
1844 notif.nextthink = time;
1846 else { continue; } // we ARE looking for a specific CPID, don't kill everything else too
1848 else if(notif.nent_net_type == net_type)
1852 if(notif.nent_net_name == net_name) { notif.nent_net_name = -1; notif.nextthink = time; }
1853 else { continue; } // we ARE looking for a certain net_name, don't kill everything else too
1855 else { notif.nent_net_name = -1; notif.nextthink = time; }
1857 else { continue; } // we ARE looking for a certain net_type, don't kill everything else too
1859 else { notif.nent_net_name = -1; notif.nextthink = time; }
1863 void Send_Notification(
1864 float broadcast, entity client,
1865 float net_type, float net_name,
1868 // check if this should be aborted
1869 if(net_name == NOTIF_ABORT)
1871 #ifdef NOTIFICATIONS_DEBUG
1872 Debug_Notification(sprintf(
1873 "Send_Notification(%s, '%s', %s, %s, ...);\n",
1874 Get_Notif_BroadcastName(broadcast),
1876 Get_Notif_TypeName(net_type),
1883 // check supplied broadcast, target, type, and name for errors
1884 string checkargs = Notification_CheckArgs(broadcast, client, net_type, net_name);
1887 #ifdef NOTIFICATIONS_DEBUG
1888 Debug_Notification(sprintf(
1889 "Send_Notification(%s, '%s', %s, %s, ...);\n",
1890 Get_Notif_BroadcastName(broadcast),
1892 Get_Notif_TypeName(net_type),
1893 Get_Notif_Ent(net_type, net_name).nent_name
1896 backtrace(sprintf("Incorrect usage of Send_Notification: %s\n", checkargs));
1900 // retreive entity of this notification
1901 entity notif = Get_Notif_Ent(net_type, net_name);
1904 #ifdef NOTIFICATIONS_DEBUG
1905 Debug_Notification(sprintf(
1906 "Send_Notification(%s, '%s', %s, %d, ...);\n",
1907 Get_Notif_BroadcastName(broadcast),
1909 Get_Notif_TypeName(net_type),
1913 backtrace("Send_Notification: Could not find notification entity!\n");
1917 string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
1918 string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
1919 string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
1920 string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
1921 float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
1922 float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
1923 float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
1924 float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
1926 #ifdef NOTIFICATIONS_DEBUG
1927 Debug_Notification(sprintf(
1928 "Send_Notification(%s, %s, %s);\n",
1931 Get_Notif_BroadcastName(broadcast),
1933 Get_Notif_TypeName(net_type),
1936 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1937 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1941 if((notif.nent_stringcount + notif.nent_floatcount) > count)
1945 "Not enough arguments for Send_Notification(%s, ...)! ",
1946 "stringcount(%d) + floatcount(%d) > count(%d)\n",
1947 "Check the definition and function call for accuracy...?\n"
1950 #ifdef NOTIFICATIONS_DEBUG
1952 Get_Notif_BroadcastName(broadcast),
1958 Get_Notif_TypeName(net_type),
1961 notif.nent_stringcount,
1962 notif.nent_floatcount,
1967 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
1971 "Too many arguments for Send_Notification(%s, ...)! ",
1972 "stringcount(%d) + floatcount(%d) < count(%d)\n",
1973 "Check the definition and function call for accuracy...?\n"
1976 #ifdef NOTIFICATIONS_DEBUG
1978 Get_Notif_BroadcastName(broadcast),
1984 Get_Notif_TypeName(net_type),
1987 notif.nent_stringcount,
1988 notif.nent_floatcount,
1998 broadcast == NOTIF_ALL
2000 broadcast == NOTIF_ALL_EXCEPT
2004 net_type == MSG_ANNCE
2006 net_type == MSG_CENTER
2010 Local_Notification_WOVA(
2012 notif.nent_stringcount,
2013 notif.nent_floatcount,
2018 if(net_type == MSG_CHOICE)
2020 // THIS GETS TRICKY... now we have to cycle through each possible player (checking broadcast)
2021 // and then do an individual NOTIF_ONE_ONLY recursive call for each one depending on their option...
2022 // It's slow, but it's better than the alternatives:
2023 // 1. Constantly networking all info and letting client decide
2024 // 2. Manually handling each separate call on per-usage basis (See old CTF usage of verbose)
2025 entity found_choice;
2027 #define RECURSE_FROM_CHOICE(ent,action) \
2028 if(notif.nent_challow_var && (warmup_stage || (notif.nent_challow_var == 2))) \
2030 switch(ent.msg_choice_choices[net_name]) \
2032 case 1: found_choice = notif.nent_optiona; break; \
2033 case 2: found_choice = notif.nent_optionb; break; \
2037 else { found_choice = notif.nent_optiona; } \
2038 Send_Notification_WOVA( \
2041 found_choice.nent_type, \
2042 found_choice.nent_id, \
2043 found_choice.nent_stringcount, \
2044 found_choice.nent_floatcount, \
2050 case NOTIF_ONE_ONLY: // we can potentially save processing power with this broadcast method
2052 if(IS_REAL_CLIENT(client))
2053 { RECURSE_FROM_CHOICE(client, return) }
2059 FOR_EACH_REALCLIENT(to)
2060 { if(Notification_ShouldSend(broadcast, to, client))
2061 { RECURSE_FROM_CHOICE(to, continue) } }
2068 entity net_notif = spawn();
2069 net_notif.owner = notif;
2070 net_notif.classname = "net_notification";
2071 net_notif.nent_broadcast = broadcast;
2072 net_notif.nent_client = client;
2073 net_notif.nent_net_type = net_type;
2074 net_notif.nent_net_name = net_name;
2075 net_notif.nent_stringcount = notif.nent_stringcount;
2076 net_notif.nent_floatcount = notif.nent_floatcount;
2079 for(i = 0; i < net_notif.nent_stringcount; ++i)
2080 { net_notif.nent_strings[i] = strzone(...(i, string)); }
2081 for(i = 0; i < net_notif.nent_floatcount; ++i)
2082 { net_notif.nent_floats[i] = ...((net_notif.nent_stringcount + i), float); }
2084 net_notif.think = Net_Notification_Remove;
2085 net_notif.nextthink =
2086 ((time > autocvar_notification_lifetime_mapload)
2088 (time + autocvar_notification_lifetime_runtime)
2090 autocvar_notification_lifetime_mapload
2093 Net_LinkEntity(net_notif, FALSE, 0, Net_Write_Notification);
2097 // WOVA = Without Variable Arguments
2098 void Send_Notification_WOVA(
2099 float broadcast, entity client,
2100 float net_type, float net_name,
2101 float stringcount, float floatcount,
2102 string s1, string s2, string s3, string s4,
2103 float f1, float f2, float f3, float f4)
2105 #ifdef NOTIFICATIONS_DEBUG
2106 entity notif = Get_Notif_Ent(net_type, net_name);
2107 Debug_Notification(sprintf(
2108 "Send_Notification_WOVA(%s, %d, %d, %s, %s);\n",
2111 Get_Notif_BroadcastName(broadcast),
2113 Get_Notif_TypeName(net_type),
2118 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
2119 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
2123 #define VARITEM(stringc,floatc,args) \
2124 if((stringcount == stringc) && (floatcount == floatc)) \
2125 { Send_Notification(broadcast, client, net_type, net_name, args); return; }
2126 EIGHT_VARS_TO_VARARGS_VARLIST
2128 Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
2131 // WOCOVA = Without Counts Or Variable Arguments
2132 void Send_Notification_WOCOVA(
2133 float broadcast, entity client,
2134 float net_type, float net_name,
2135 string s1, string s2, string s3, string s4,
2136 float f1, float f2, float f3, float f4)
2138 entity notif = Get_Notif_Ent(net_type, net_name);
2140 #ifdef NOTIFICATIONS_DEBUG
2141 Debug_Notification(sprintf(
2142 "Send_Notification_WOCOVA(%s, %s, %s);\n",
2145 Get_Notif_BroadcastName(broadcast),
2147 Get_Notif_TypeName(net_type),
2150 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
2151 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
2155 #define VARITEM(stringc,floatc,args) \
2156 if((notif.nent_stringcount == stringc) && (notif.nent_floatcount == floatc)) \
2157 { Send_Notification(broadcast, client, net_type, net_name, args); return; }
2158 EIGHT_VARS_TO_VARARGS_VARLIST
2160 Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
2162 #endif // ifdef SVQC