1 // ================================================
2 // Unified notification system, written by Samual
3 // Last updated: February, 2013
4 // ================================================
6 string Get_Notif_TypeName(float net_type)
10 case MSG_INFO: return "MSG_INFO";
11 case MSG_CENTER: return "MSG_CENTER";
12 case MSG_WEAPON: return "MSG_WEAPON";
13 case MSG_DEATH: return "MSG_DEATH";
15 backtrace(sprintf("Get_Notif_TypeName(%d): Improper net type!\n", net_type));
19 entity Get_Notif_Ent(float net_type, float net_name)
23 case MSG_INFO: return msg_info_notifs[net_name - 1];
24 case MSG_CENTER: return msg_center_notifs[net_name - 1];
25 case MSG_WEAPON: return msg_weapon_notifs[net_name - 1];
26 case MSG_DEATH: return msg_death_notifs[net_name - 1];
28 backtrace(sprintf("Get_Notif_Ent(%d, %d): Improper net type!\n", net_type, net_name));
32 string Notification_CheckArgs_TypeName(float net_type, float net_name)
34 // check supplied type and name for errors
35 string checkargs = "";
36 #define CHECKARG_TYPENAME(type) case MSG_##type##: \
37 { if(!net_name || (net_name > NOTIF_##type##_COUNT)) \
38 { checkargs = sprintf("Improper name: %d!", net_name); } break; }
41 CHECKARG_TYPENAME(INFO)
42 CHECKARG_TYPENAME(CENTER)
43 CHECKARG_TYPENAME(WEAPON)
44 CHECKARG_TYPENAME(DEATH)
45 default: { checkargs = sprintf("Improper type: %d!", checkargs, net_type); break; }
47 #undef CHECKARG_TYPENAME
52 string Notification_CheckArgs(float broadcast, entity client, float net_type, float net_name)
54 // check supplied broadcast, target, type, and name for errors
55 string checkargs = Notification_CheckArgs_TypeName(net_type, net_name);
56 if(checkargs != "") { checkargs = strcat(checkargs, " "); }
62 if(IS_NOT_A_CLIENT(client))
63 { checkargs = sprintf("%sNo client provided!", checkargs); }
67 case NOTIF_ANY_EXCEPT:
69 if(IS_NOT_A_CLIENT(client))
70 { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
77 { checkargs = sprintf("%sEntity provided when world was required!", checkargs); }
82 case NOTIF_TEAM_EXCEPT:
84 if not(teamplay) { checkargs = sprintf("%sTeamplay not active!", checkargs); }
85 else if(IS_NOT_A_CLIENT(client))
87 if(broadcast == NOTIF_TEAM) { checkargs = sprintf("%sNo client provided!", checkargs); }
88 else { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
93 default: { checkargs = sprintf("%sImproper broadcast: %d!", checkargs, broadcast); break; }
99 // ===============================
100 // Frontend Notification Pushing
101 // ===============================
103 void Dump_Notifications(float fh, float alsoprint)
105 #define NOTIF_WRITE(a) { \
107 if(alsoprint) { print(a); } }
108 #define NOTIF_WRITE_ENTITY(name,default,description) { \
111 "seta notification_%s \"%d\" \"%s\"\n", \
112 name, default, description \
114 NOTIF_WRITE(notif_msg) }
115 #define NOTIF_WRITE_HARDCODED(cvar,default,description) { \
118 "seta notification_%s \"%s\" \"%s\"\n", \
119 cvar, default, description \
121 NOTIF_WRITE(notif_msg) }
127 // Note: This warning only applies to the notifications.cfg file that is output...
129 // You ARE supposed to manually edit this function to add i.e. hard coded
130 // notification variables for mutators or game modes or such and then
131 // regenerate the notifications.cfg file from the new code.
133 NOTIF_WRITE("// ********************************************** //\n");
134 NOTIF_WRITE("// ** WARNING - DO NOT MANUALLY EDIT THIS FILE ** //\n");
135 NOTIF_WRITE("// ** ** //\n");
136 NOTIF_WRITE("// ** This file is automatically generated ** //\n");
137 NOTIF_WRITE("// ** by code with the command 'dumpnotifs'. ** //\n");
138 NOTIF_WRITE("// ** ** //\n");
139 NOTIF_WRITE("// ** If you add a new notification, please ** //\n");
140 NOTIF_WRITE("// ** regenerate this file with that command ** //\n");
141 NOTIF_WRITE("// ** making sure that the output matches ** //\n");
142 NOTIF_WRITE("// ** with the lists and defaults in code. ** //\n");
143 NOTIF_WRITE("// ** ** //\n");
144 NOTIF_WRITE("// ********************************************** //\n");
146 // These notifications will also append their string as a comment...
147 // This is not necessary, and does not matter if they vary between config versions,
148 // it is just a semi-helpful tool for those who want to manually change their user settings.
150 NOTIF_WRITE(sprintf("\n// MSG_INFO notifications (count = %d):\n", NOTIF_INFO_COUNT));
151 for(i = 1; i <= NOTIF_INFO_COUNT; ++i)
153 e = Get_Notif_Ent(MSG_INFO, i);
154 if not(e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
155 NOTIF_WRITE_ENTITY(e.nent_name, e.nent_default, "Notification control cvar: 0 = off, 1 = print to console, 2 = print to console and chatbox (if notification_allow_chatboxprint is enabled)");
158 NOTIF_WRITE(sprintf("\n// MSG_CENTER notifications (count = %d):\n", NOTIF_CENTER_COUNT));
159 for(i = 1; i <= NOTIF_CENTER_COUNT; ++i)
161 e = Get_Notif_Ent(MSG_CENTER, i);
162 if not(e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
163 NOTIF_WRITE_ENTITY(e.nent_name, e.nent_default, "Notification control cvar: 0 = off, 1 = centerprint");
166 NOTIF_WRITE(sprintf("\n// MSG_WEAPON notifications (count = %d):\n", NOTIF_WEAPON_COUNT));
167 for(i = 1; i <= NOTIF_WEAPON_COUNT; ++i)
169 e = Get_Notif_Ent(MSG_WEAPON, i);
170 if not(e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
171 NOTIF_WRITE_ENTITY(e.nent_name, e.nent_default, "Notification control cvar: 0 = off, 1 = trigger subcalls");
174 NOTIF_WRITE(sprintf("\n// MSG_DEATH notifications (count = %d):\n", NOTIF_DEATH_COUNT));
175 for(i = 1; i <= NOTIF_DEATH_COUNT; ++i)
177 e = Get_Notif_Ent(MSG_DEATH, i);
178 if not(e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
179 NOTIF_WRITE_ENTITY(e.nent_name, e.nent_default, "Notification control cvar: 0 = off, 1 = trigger subcalls");
182 // edit these to match whichever cvars are used for specific notification options
183 NOTIF_WRITE("\n// HARD CODED notification variables:\n");
184 NOTIF_WRITE_HARDCODED("allow_chatboxprint", "1", "Allow notifications to be printed to chat box by setting notification cvar to 2 (You can also set this cvar to 2 to force ALL notifications to be printed to the chatbox)");
185 NOTIF_WRITE_HARDCODED("show_location", "0", "Append location information to MSG_INFO death/kill messages");
186 NOTIF_WRITE_HARDCODED("show_location_string", "", "Replacement string piped into sprintf, so you can do different messages like this: ' at the %s' or ' (near %s)'");
187 NOTIF_WRITE_HARDCODED("show_sprees", "1", "Print information about sprees in death/kill messages");
188 NOTIF_WRITE_HARDCODED("show_sprees_center", "1", "Show spree information in MSG_CENTER messages... 0 = off, 1 = target (but only for first victim) and attacker");
189 NOTIF_WRITE_HARDCODED("show_sprees_center_specialonly", "1", "Don't show spree information in MSG_CENTER messages if it isn't an achievement");
190 NOTIF_WRITE_HARDCODED("show_sprees_info", "3", "Show spree information in MSG_INFO messages... 0 = off, 1 = target only, 2 = attacker only, 3 = target and attacker");
191 NOTIF_WRITE_HARDCODED("show_sprees_info_newline", "0", "Show attacker spree information for MSG_INFO messages on a separate line than the death notification itself");
192 NOTIF_WRITE_HARDCODED("show_sprees_info_specialonly", "1", "Don't show attacker spree information in MSG_INFO messages if it isn't an achievement");
193 NOTIF_WRITE_HARDCODED("item_centerprinttime", "1.5", "How long to show item information centerprint messages (like 'You got the Electro' or such)");
194 NOTIF_WRITE_HARDCODED("errors_are_fatal", "1", "If a notification fails upon initialization, cause a Host_Error to stop the program");
195 NOTIF_WRITE_HARDCODED("ctf_pickup_team_verbose", "0", "Show extra information if a team mate picks up a flag");
196 NOTIF_WRITE_HARDCODED("ctf_pickup_enemy_verbose", "0", "Show extra information if an enemy picks up a flag");
197 NOTIF_WRITE_HARDCODED("ctf_capture_verbose", "0", "Show extra information when someone captures a flag");
198 NOTIF_WRITE_HARDCODED("frag_verbose", "1", "Show extra information when you frag someone (or when you are fragged");
199 NOTIF_WRITE_HARDCODED("lifetime_runtime", "0.5", "Amount of time that notification entities last on the server during runtime (In seconds)");
200 NOTIF_WRITE_HARDCODED("lifetime_mapload", "10", "Amount of time that notification entities last immediately at mapload (in seconds) to help prevent notifications from being lost on early init (like gamestart countdown)");
202 NOTIF_WRITE(sprintf("\n// Notification counts (total = %d): MSG_INFO = %d, MSG_CENTER = %d, MSG_WEAPON = %d, MSG_DEATH = %d\n",
203 (NOTIF_INFO_COUNT + NOTIF_CENTER_COUNT + NOTIF_WEAPON_COUNT + NOTIF_DEATH_COUNT),
204 NOTIF_INFO_COUNT, NOTIF_CENTER_COUNT, NOTIF_WEAPON_COUNT, NOTIF_DEATH_COUNT));
207 #undef NOTIF_WRITE_HARDCODED
208 #undef NOTIF_WRITE_ENTITY
213 void Notification_GetCvars()
215 GetCvars_handleFloat(get_cvars_s, get_cvars_f, FRAG_VERBOSE, "notification_frag_verbose");
219 string Local_Notification_sprintf(string input, string args,
220 string s1, string s2, string s3, string s4,
221 float f1, float f2, float f3, float f4)
223 #ifdef NOTIFICATIONS_DEBUG
225 sprintf("Local_Notification_sprintf('%s^7', '%s', %s, %s);\n",
226 strreplace("\n", "\\n", input),
228 strreplace("\n", "\\n", sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
229 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
236 for(sel_num = 0; sel_num < NOTIF_MAX_ARGS; ++sel_num) { arg_slot[sel_num] = ""; }
240 for(sel_num = 0;(args != "");)
242 selected = car(args); args = cdr(args);
243 NOTIF_HIT_MAX(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
244 switch(strtolower(selected))
246 #define ARG_CASE(prog,selected,result) \
248 #if (prog != ARG_SV) && (prog != ARG_DC) \
249 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
252 #if (prog != ARG_CS) && (prog != ARG_DC) \
253 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
258 default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
261 return sprintf(input, arg_slot[0], arg_slot[1], arg_slot[2], arg_slot[3], arg_slot[4], arg_slot[5], arg_slot[6]);
265 void Local_Notification_HUD_Notify_Push(string icon, string hudargs, string s1, string s2, string s3, string s4)
269 arg_slot[0] = ""; arg_slot[1] = "";
271 for(sel_num = 0;(hudargs != "");)
273 selected = car(hudargs); hudargs = cdr(hudargs);
274 NOTIF_HIT_MAX(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
275 switch(strtolower(selected))
277 #define ARG_CASE(prog,selected,result) \
278 #if (prog == ARG_CS_SV_HA) \
279 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
283 default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
286 #ifdef NOTIFICATIONS_DEBUG
288 sprintf("Local_Notification_HUD_Notify_Push('%s^7', '%s', %s, %s);\n",
291 strreplace("\n", "\\n", sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
292 strreplace("\n", "\\n", sprintf("'%s^7', '%s^7'", stof(arg_slot[0]), stof(arg_slot[1])))
296 HUD_Notify_Push(icon, arg_slot[0], arg_slot[1]);
299 void Local_Notification_centerprint_generic(string input, string durcnt, float cpid, float f1, float f2)
303 arg_slot[0] = ""; arg_slot[1] = "";
305 for(sel_num = 0;(durcnt != "");)
307 selected = car(durcnt); durcnt = cdr(durcnt);
308 NOTIF_HIT_MAX(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic")
309 switch(strtolower(selected))
311 #define ARG_CASE(prog,selected,result) \
312 #if (prog == ARG_CS_SV_DC) || (prog == ARG_DC) \
313 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
319 if(ftos(stof(selected)) != "") { arg_slot[sel_num] = selected; ++sel_num; }
320 else { NOTIF_HIT_UNKNOWN(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic") }
325 #ifdef NOTIFICATIONS_DEBUG
327 sprintf("Local_Notification_centerprint_generic('%s^7', '%s', %d, %d, %d, %d);\n",
328 strreplace("\n", "\\n", input),
331 stof(arg_slot[0]), stof(arg_slot[1])
335 centerprint_generic(cpid, input, stof(arg_slot[0]), stof(arg_slot[1]));
339 void Local_Notification(float net_type, float net_name, ...count)
341 // check supplied type and name for errors
342 string checkargs = Notification_CheckArgs_TypeName(net_type, net_name);
343 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Local_Notification: %s\n", checkargs)); return; }
345 entity notif = Get_Notif_Ent(net_type, net_name);
346 if not(notif) { backtrace("Local_Notification: Could not find notification entity!\n"); return; }
348 #ifdef NOTIFICATIONS_DEBUG
349 if not(notif.nent_enabled) { dprint(sprintf("Local_Notification(%s, %s): Entity was disabled...\n", Get_Notif_TypeName(net_type), notif.nent_name)); return; }
352 if((notif.nent_stringcount + notif.nent_floatcount) > count)
356 "Not enough arguments for Local_Notification(%s, %s, ...)! ",
357 "stringcount(%d) + floatcount(%d) > count(%d)\n",
358 "Check the definition and function call for accuracy...?\n"
360 Get_Notif_TypeName(net_type), notif.nent_name, notif.nent_stringcount, notif.nent_floatcount, count));
363 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
367 "Too many arguments for Local_Notification(%s, %s, ...)! ",
368 "stringcount(%d) + floatcount(%d) < count(%d)\n",
369 "Check the definition and function call for accuracy...?\n"
371 Get_Notif_TypeName(net_type), notif.nent_name, notif.nent_stringcount, notif.nent_floatcount, count));
375 string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
376 string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
377 string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
378 string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
379 float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
380 float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
381 float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
382 float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
384 #ifdef NOTIFICATIONS_DEBUG
386 sprintf("Local_Notification(%s, %s, %s, %s);\n",
387 Get_Notif_TypeName(net_type),
389 strreplace("\n", "\\n", sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
390 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
400 Local_Notification_sprintf(
407 if(notif.nent_icon != "")
409 Local_Notification_HUD_Notify_Push(
421 Local_Notification_centerprint_generic(
422 Local_Notification_sprintf(
437 if(notif.nent_msginfo)
438 if(notif.nent_msginfo.nent_enabled)
440 Local_Notification_WOVA(
442 notif.nent_msginfo.nent_id,
443 notif.nent_msginfo.nent_stringcount,
444 notif.nent_msginfo.nent_floatcount,
449 if(notif.nent_msgcenter)
450 if(notif.nent_msgcenter.nent_enabled)
452 Local_Notification_WOVA(
454 notif.nent_msgcenter.nent_id,
455 notif.nent_msgcenter.nent_stringcount,
456 notif.nent_msgcenter.nent_floatcount,
466 // WOVA = Without Variable Arguments
467 void Local_Notification_WOVA(float net_type, float net_name,
468 float stringcount, float floatcount,
469 string s1, string s2, string s3, string s4,
470 float f1, float f2, float f3, float f4)
472 #define VARITEM(stringc,floatc,args) \
473 if((stringcount == stringc) && (floatcount == floatc)) \
474 { Local_Notification(net_type, net_name, args); return; }
475 EIGHT_VARS_TO_VARARGS_VARLIST
477 Local_Notification(net_type, net_name); // some notifications don't have any arguments at all
481 // =========================
482 // Notification Networking
483 // =========================
486 void Read_Notification(float is_new)
488 float net_type = ReadByte();
489 float net_name = ReadShort();
491 if(net_type == MSG_CENTER_KILL)
495 if(net_name == 0) { reset_centerprint_messages(); }
498 entity notif = Get_Notif_Ent(MSG_CENTER, net_name);
499 if not(notif) { backtrace("Read_Notification: Could not find notification entity!\n"); return; }
500 centerprint_generic(notif.nent_cpid, "", 0, 0);
506 entity notif = Get_Notif_Ent(net_type, net_name);
507 if not(notif) { backtrace("Read_Notification: Could not find notification entity!\n"); return; }
509 #ifdef NOTIFICATIONS_DEBUG
510 dprint(sprintf("Read_Notification(%d) at %f: net_type = %s, net_name = %s\n", is_new, time, Get_Notif_TypeName(net_type), notif.nent_name));
513 string s1 = ((0 < notif.nent_stringcount) ? ReadString() : "");
514 string s2 = ((1 < notif.nent_stringcount) ? ReadString() : "");
515 string s3 = ((2 < notif.nent_stringcount) ? ReadString() : "");
516 string s4 = ((3 < notif.nent_stringcount) ? ReadString() : "");
517 float f1 = ((0 < notif.nent_floatcount) ? ReadLong() : 0);
518 float f2 = ((1 < notif.nent_floatcount) ? ReadLong() : 0);
519 float f3 = ((2 < notif.nent_floatcount) ? ReadLong() : 0);
520 float f4 = ((3 < notif.nent_floatcount) ? ReadLong() : 0);
524 Local_Notification_WOVA(
526 notif.nent_stringcount,
527 notif.nent_floatcount,
536 void Net_Notification_Remove()
538 #ifdef NOTIFICATIONS_DEBUG
539 if not(self) { dprint(sprintf("Net_Notification_Remove() at %f: Missing self!?\n", time)); return; }
540 if(self.nent_net_name == -1)
544 "Net_Notification_Remove() at %f: Killed '%s' notification\n",
546 Get_Notif_TypeName(self.nent_net_type)
553 string checkargs = Notification_CheckArgs_TypeName(self.nent_net_type, self.nent_net_name);
554 if(checkargs != "") { dprint(sprintf("Incorrect usage of Net_Notification_Remove() at %f: %s\n", time, checkargs)); return; }
556 #ifdef NOTIFICATIONS_DEBUG
557 entity realent = Get_Notif_Ent(self.nent_net_type, self.nent_net_name);
560 "Net_Notification_Remove() at %f: Removed '%s - %s' notification\n",
562 Get_Notif_TypeName(self.nent_net_type),
570 for(i = 0; i < 4; ++i) { if(self.nent_strings[i]) { strunzone(self.nent_strings[i]); } }
574 float Net_Write_Notification(entity client, float sf)
576 float i, send = FALSE;
578 switch(self.nent_broadcast)
580 case NOTIF_ONE: // send to one client and their spectator
583 (client == self.nent_client)
586 (client.classname == STR_SPECTATOR)
588 (client.enemy == self.nent_client)
593 case NOTIF_ONE_ONLY: // send ONLY to one client
595 if(client == self.nent_client) { send = TRUE; }
598 case NOTIF_TEAM: // send only to X team and their spectators
601 (client.team == self.nent_client.team)
604 (client.classname == STR_SPECTATOR)
606 (client.enemy.team == self.nent_client.team)
611 case NOTIF_TEAM_EXCEPT: // send only to X team and their spectators, except for Y person and their spectators
614 (client != self.nent_client)
617 (client.team == self.nent_client.team)
620 (client.classname == STR_SPECTATOR)
623 (client.enemy != self.nent_client)
625 (client.enemy.team == self.nent_client.team)
632 case NOTIF_ANY: // send to everyone
637 case NOTIF_ANY_EXCEPT: // send to everyone except X person and their spectators
640 (client != self.nent_client)
643 (client.classname == STR_SPECTATOR)
645 (client.enemy == self.nent_client)
650 default: { send = FALSE; break; }
655 WriteByte(MSG_ENTITY, ENT_CLIENT_NOTIFICATION);
656 WriteByte(MSG_ENTITY, self.nent_net_type);
657 WriteShort(MSG_ENTITY, self.nent_net_name);
658 for(i = 0; i < self.nent_stringcount; ++i) { WriteString(MSG_ENTITY, self.nent_strings[i]); }
659 for(i = 0; i < self.nent_floatcount; ++i) { WriteLong(MSG_ENTITY, self.nent_floats[i]); }
665 void Kill_Notification(float broadcast, entity client, float net_type, float net_name)
667 string checkargs = Notification_CheckArgs(broadcast, client, 1, 1);
668 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Kill_Notification: %s\n", checkargs)); return; }
670 #ifdef NOTIFICATIONS_DEBUG
672 sprintf("Kill_Notification(%d, '%s', %d, %d);\n",
681 entity notif, net_notif;
683 // if no name is provided, just kill ALL the centerprint notifications
684 if(net_type == MSG_CENTER)
687 net_notif.classname = "net_kill_notification";
688 net_notif.nent_broadcast = broadcast;
689 net_notif.nent_client = client;
690 net_notif.nent_net_type = MSG_CENTER_KILL;
691 net_notif.nent_net_name = net_name;
692 Net_LinkEntity(net_notif, FALSE, autocvar_notification_lifetime_runtime, Net_Write_Notification);
695 for(notif = world; (notif = find(notif, classname, "net_notification"));)
697 // now kill the old send notification entity
700 if(notif.nent_net_type == net_type)
704 if(notif.nent_net_name == net_name) { notif.nent_net_name = -1; notif.think(); }
705 else { continue; } // we ARE looking for a certain net_name, don't kill everything else too
707 else { notif.nent_net_name = -1; notif.think(); }
709 else { continue; } // we ARE looking for a certain net_type, don't kill everything else too
711 else { notif.nent_net_name = -1; notif.think(); }
715 void Send_Notification(float broadcast, entity client,
716 float net_type, float net_name, ...count)
718 // check supplied broadcast, target, type, and name for errors
719 string checkargs = Notification_CheckArgs(broadcast, client, net_type, net_name);
720 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Send_Notification: %s\n", checkargs)); return; }
722 // retreive counts for the arguments of this notification
723 entity notif = Get_Notif_Ent(net_type, net_name);
724 if not(notif) { backtrace("Send_Notification: Could not find notification entity!\n"); return; }
726 if((notif.nent_stringcount + notif.nent_floatcount) > count)
730 "Not enough arguments for Send_Notification(%d, %s, %s, ...)! ",
731 "stringcount(%d) + floatcount(%d) > count(%d)\n",
732 "Check the definition and function call for accuracy...?\n"
734 broadcast, Get_Notif_TypeName(net_type), notif.nent_name, notif.nent_stringcount, notif.nent_floatcount, count));
737 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
741 "Too many arguments for Send_Notification(%d, %s, %s, ...)! ",
742 "stringcount(%d) + floatcount(%d) < count(%d)\n",
743 "Check the definition and function call for accuracy...?\n"
745 broadcast, Get_Notif_TypeName(net_type), notif.nent_name, notif.nent_stringcount, notif.nent_floatcount, count));
749 #ifdef NOTIFICATIONS_DEBUG
750 string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
751 string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
752 string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
753 string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
754 float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
755 float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
756 float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
757 float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
759 sprintf("Send_Notification(%d, %s, %s, %s, %s);\n",
761 Get_Notif_TypeName(net_type),
763 strreplace("\n", "\\n", sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
764 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
769 entity net_notif = spawn();
770 net_notif.classname = "net_notification";
771 net_notif.nent_broadcast = broadcast;
772 net_notif.nent_client = client;
773 net_notif.nent_net_type = net_type;
774 net_notif.nent_net_name = net_name;
775 net_notif.nent_stringcount = notif.nent_stringcount;
776 net_notif.nent_floatcount = notif.nent_floatcount;
779 for(i = 0; i < net_notif.nent_stringcount; ++i) { net_notif.nent_strings[i] = strzone(...(i, string)); }
780 for(i = 0; i < net_notif.nent_floatcount; ++i) { net_notif.nent_floats[i] = ...((net_notif.nent_stringcount + i), float); }
782 net_notif.think = Net_Notification_Remove;
783 net_notif.nextthink =
784 ((time > autocvar_notification_lifetime_mapload)
786 (time + autocvar_notification_lifetime_runtime)
788 autocvar_notification_lifetime_mapload
791 Net_LinkEntity(net_notif, FALSE, 0, Net_Write_Notification);
793 if(server_is_dedicated && (broadcast == NOTIF_ANY || broadcast == NOTIF_ANY_EXCEPT) && (net_type != MSG_CENTER))
795 Local_Notification_WOVA(
797 notif.nent_stringcount,
798 notif.nent_floatcount,
799 IFSTR(0), IFSTR(1), IFSTR(2), IFSTR(3),
800 IFFL(0), IFFL(1), IFFL(2), IFFL(3));
804 // WOVA = Without Variable Arguments
805 void Send_Notification_WOVA(float broadcast, entity client,
806 float net_type, float net_name,
807 string s1, string s2, string s3, string s4,
808 float f1, float f2, float f3, float f4)
810 entity notif = Get_Notif_Ent(net_type, net_name);
812 #ifdef NOTIFICATIONS_DEBUG
814 sprintf("Send_Notification_WOVA(%d, %s, %s, %s, %s - %d %d);\n",
816 Get_Notif_TypeName(net_type),
818 sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4),
819 sprintf("%d, %d, %d, %d", f1, f2, f3, f4),
820 notif.nent_stringcount, notif.nent_floatcount
825 #define VARITEM(stringc,floatc,args) \
826 if((notif.nent_stringcount == stringc) && (notif.nent_floatcount == floatc)) \
827 { Send_Notification(broadcast, client, net_type, net_name, args); return; }
828 EIGHT_VARS_TO_VARARGS_VARLIST
830 Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
834 // =============================
835 // LEGACY NOTIFICATION SYSTEMS
836 // =============================
838 void Send_CSQC_Centerprint_Generic(entity e, float id, string s, float duration, float countdown_num)
840 if ((clienttype(e) == CLIENTTYPE_REAL) && (e.flags & FL_CLIENT))
843 WRITESPECTATABLE_MSG_ONE({
844 WriteByte(MSG_ONE, SVC_TEMPENTITY);
845 WriteByte(MSG_ONE, TE_CSQC_CENTERPRINT_GENERIC);
846 WriteByte(MSG_ONE, id);
847 WriteString(MSG_ONE, s);
848 if (id != 0 && s != "")
850 WriteByte(MSG_ONE, duration);
851 WriteByte(MSG_ONE, countdown_num);