1 // ================================================
2 // Unified notification system, written by Samual
3 // Last updated: February, 2013
4 // ================================================
6 entity Get_Notif_Ent(float net_type, float net_name)
10 case MSG_INFO: return msg_info_notifs[net_name - 1];
11 case MSG_CENTER: return msg_center_notifs[net_name - 1];
12 case MSG_WEAPON: return msg_weapon_notifs[net_name - 1];
13 case MSG_DEATH: return msg_death_notifs[net_name - 1];
15 backtrace(sprintf("Get_Notif_Ent(%d, %d): Improper net type!\n", net_type, net_name));
20 // ===============================
21 // Frontend Notification Pushing
22 // ===============================
24 void Dump_Notifications(float fh, float alsoprint)
26 #define NOTIF_WRITE(a,b) { \
30 if(b != "") { print(b); } \
33 #define NOTIF_WRITE_SETA(name,text) { \
34 notif_msg = sprintf("seta notification_%s 1 \"notif string: %s\"\n", name, strreplace("\n", "\\n", text)); \
35 NOTIF_WRITE(notif_msg, strreplace("^", "^^", notif_msg)) }
41 // Note: This warning only applies to the notifications.cfg file that is output...
43 // You ARE supposed to manually edit this function to add i.e. hard coded
44 // notification variables for mutators or game modes or such and then
45 // regenerate the notifications.cfg file from the new code.
47 NOTIF_WRITE("// ********************************************** //\n", "");
48 NOTIF_WRITE("// ** WARNING - DO NOT MANUALLY EDIT THIS FILE ** //\n", "");
49 NOTIF_WRITE("// ** ** //\n", "");
50 NOTIF_WRITE("// ** This file is automatically generated ** //\n", "");
51 NOTIF_WRITE("// ** by code with the command 'dumpnotifs'. ** //\n", "");
52 NOTIF_WRITE("// ** ** //\n", "");
53 NOTIF_WRITE("// ** If you add a new notification, please ** //\n", "");
54 NOTIF_WRITE("// ** regenerate this file with that command ** //\n", "");
55 NOTIF_WRITE("// ** making sure that the output matches ** //\n", "");
56 NOTIF_WRITE("// ** with the lists and defaults in code. ** //\n", "");
57 NOTIF_WRITE("// ** ** //\n", "");
58 NOTIF_WRITE("// ********************************************** //\n", "");
60 NOTIF_WRITE("\n// Version number to identify mismatches between code and config file...\n", "");
61 NOTIF_WRITE("// Increment NOTIF_VERSION in common/notifications.qh with any\n", "");
62 NOTIF_WRITE("// new notifications or other changes to notif cvars/this config.\n", "");
64 NOTIF_WRITE(sprintf("set notification_version %d\n", NOTIF_VERSION), "");
66 // These notifications will also append their string as a comment...
67 // This is not necessary, and does not matter if they vary between config versions,
68 // it is just a semi-helpful tool for those who want to manually change their user settings.
70 NOTIF_WRITE(sprintf("\n// MSG_INFO notifications (count = %d):\n", NOTIF_INFO_COUNT), "");
71 for(i = 0; i < NOTIF_INFO_COUNT; ++i) {
72 e = Get_Notif_Ent(MSG_INFO, i);
73 NOTIF_WRITE_SETA(e.nent_name, e.nent_string); }
75 NOTIF_WRITE(sprintf("\n// MSG_CENTER notifications (count = %d):\n", NOTIF_CENTER_COUNT), "");
76 for(i = 0; i < NOTIF_CENTER_COUNT; ++i) {
77 e = Get_Notif_Ent(MSG_CENTER, i);
78 NOTIF_WRITE_SETA(e.nent_name, e.nent_string); }
80 NOTIF_WRITE(sprintf("\n// MSG_WEAPON notifications (count = %d):\n", NOTIF_WEAPON_COUNT), "");
81 for(i = 0; i < NOTIF_WEAPON_COUNT; ++i) {
82 e = Get_Notif_Ent(MSG_WEAPON, i);
83 NOTIF_WRITE_SETA(e.nent_name, sprintf("infoname: %s, centername: %s",
84 e.nent_msginfo.nent_name, e.nent_msgcenter.nent_name)); }
86 NOTIF_WRITE(sprintf("\n// MSG_DEATH notifications (count = %d):\n", NOTIF_DEATH_COUNT), "");
87 for(i = 0; i < NOTIF_DEATH_COUNT; ++i) {
88 e = Get_Notif_Ent(MSG_DEATH, i);
89 NOTIF_WRITE_SETA(e.nent_name, sprintf("infoname: %s, centername: %s",
90 e.nent_msginfo.nent_name, e.nent_msgcenter.nent_name)); }
92 // edit these to match whichever cvars are used for specific notification options
93 NOTIF_WRITE("\n// HARD CODED notification variables:\n", "");
94 NOTIF_WRITE("seta notification_errors_are_fatal 1 \"If a notification fails upon initialization, cause a Host_Error to stop the program\"\n", "");
95 NOTIF_WRITE("seta notification_ctf_pickup_team_verbose 1 \"Show extra information if a team mate picks up a flag\"\n", "");
96 NOTIF_WRITE("seta notification_ctf_pickup_enemy_verbose 1 \"Show extra information if an enemy picks up a flag\"\n", "");
97 NOTIF_WRITE("seta notification_ctf_capture_verbose 1 \"Show extra information when someone captures a flag\"\n", "");
98 NOTIF_WRITE("seta notification_frag_verbose 1 \"Show extra information when you frag someone (or when you are fragged\"\n", "");
100 NOTIF_WRITE(sprintf("\n// Notification counts (total = %d): MSG_INFO = %d, MSG_CENTER = %d, MSG_WEAPON = %d, MSG_DEATH = %d\n",
101 (NOTIF_INFO_COUNT + NOTIF_CENTER_COUNT + NOTIF_WEAPON_COUNT + NOTIF_DEATH_COUNT),
102 NOTIF_INFO_COUNT, NOTIF_CENTER_COUNT, NOTIF_WEAPON_COUNT, NOTIF_DEATH_COUNT), "");
105 #undef NOTIF_WRITE_SETA
109 string Local_Notification_sprintf(string input, string args,
110 string s1, string s2, string s3, string s4,
111 float f1, float f2, float f3, float f4)
113 #ifdef NOTIFICATIONS_DEBUG
115 sprintf("Local_Notification_sprintf('%s^7', '%s', %s, %s);\n",
116 strreplace("\n", "\\n", input),
118 sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4),
119 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
126 for(sel_num = 0; sel_num < NOTIF_MAX_ARGS; ++sel_num) { arg_slot[sel_num] = ""; }
132 for(sel_num = 0;(args != "");)
134 selected = car(args); args = cdr(args);
135 NOTIF_HIT_MAX(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
136 switch(strtolower(selected))
138 #define ARG_CASE(prog,selected,result) \
140 #if (prog == ARG_BOTH) || (prog == ARG_TRIPLE) || (prog == ARG_CSQC) \
141 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
144 #if (prog == ARG_BOTH) || (prog == ARG_TRIPLE) || (prog == ARG_SVQC) \
145 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
150 NOTIF_HIT_UNKNOWN(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
153 return sprintf(input, arg_slot[0], arg_slot[1], arg_slot[2], arg_slot[3], arg_slot[4], arg_slot[5], arg_slot[6]);
157 void Local_Notification_HUD_Notify_Push(string icon, string hudargs, string s1, string s2, string s3, string s4)
161 arg_slot[0] = ""; arg_slot[1] = "";
163 for(sel_num = 0;(hudargs != "");)
165 selected = car(hudargs); hudargs = cdr(hudargs);
166 NOTIF_HIT_MAX(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
167 switch(strtolower(selected))
169 #define ARG_CASE(prog,selected,result) \
170 #if (prog == ARG_TRIPLE) \
171 case selected: { arg_slot[sel_num] = result; ++sel_num; break; } \
175 NOTIF_HIT_UNKNOWN(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
178 HUD_Notify_Push(icon, arg_slot[0], arg_slot[1]);
182 void Local_Notification(float net_type, float net_name, ...count)
184 // check supplied type and name for errors
185 string checkargs = "";
186 #define CHECKARG_TYPENAME(type) case MSG_##type##: \
187 { if(!net_name || (net_name > NOTIF_##type##_COUNT)) \
188 { checkargs = sprintf("Improper name: %d!", net_name); } break; }
191 CHECKARG_TYPENAME(INFO)
192 CHECKARG_TYPENAME(CENTER)
193 CHECKARG_TYPENAME(WEAPON)
194 CHECKARG_TYPENAME(DEATH)
195 default: { checkargs = sprintf("Improper type: %d!", checkargs, net_type); break; }
197 #undef CHECKARG_TYPENAME
198 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Local_Notification: %s\n", checkargs)); return; }
200 entity notif = Get_Notif_Ent(net_type, net_name);
201 if not(notif) { backtrace("Local_Notification: Could not find notification entity!\n"); return; }
202 if not(notif.nent_enabled) { print("Local_Notification: Entity was disabled...\n"); return; }
204 if((notif.nent_stringcount + notif.nent_floatcount) > count)
208 "Not enough arguments for Local_Notification! ",
209 "stringcount(%d) + floatcount(%d) > count(%d)\n",
210 "Check the definition and function call for accuracy...?\n"
212 notif.nent_stringcount, notif.nent_floatcount, count));
215 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
219 "Too many arguments for Local_Notification! ",
220 "stringcount(%d) + floatcount(%d) < count(%d)\n",
221 "Check the definition and function call for accuracy...?\n"
223 notif.nent_stringcount, notif.nent_floatcount, count));
227 string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
228 string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
229 string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
230 string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
231 float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
232 float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
233 float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
234 float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
236 #ifdef NOTIFICATIONS_DEBUG
238 sprintf("Local_Notification(%d, %s, %s, %s);\n",
241 sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4),
242 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
252 Local_Notification_sprintf(
259 if(notif.nent_icon != "")
261 Local_Notification_HUD_Notify_Push(
275 Local_Notification_sprintf(
288 if(notif.nent_msginfo)
289 if(notif.nent_msginfo.nent_enabled)
291 Local_Notification_Without_VarArgs(
293 notif.nent_msginfo.nent_id,
294 notif.nent_msginfo.nent_stringcount,
295 notif.nent_msginfo.nent_floatcount,
300 if(notif.nent_msgcenter)
301 if(notif.nent_msgcenter.nent_enabled)
303 Local_Notification_Without_VarArgs(
305 notif.nent_msgcenter.nent_id,
306 notif.nent_msgcenter.nent_stringcount,
307 notif.nent_msgcenter.nent_floatcount,
317 void Local_Notification_Without_VarArgs(float net_type, float net_name,
318 float stringcount, float floatcount,
319 string s1, string s2, string s3, string s4,
320 float f1, float f2, float f3, float f4)
322 #define VARITEM(stringc,floatc,args) \
323 if((stringcount == stringc) && (floatcount == floatc)) \
324 { Local_Notification(net_type, net_name, args); return; }
325 EIGHT_VARS_TO_VARARGS_VARLIST
327 Local_Notification(net_type, net_name); // some notifications don't have any arguments at all
331 // =========================
332 // Notification Networking
333 // =========================
336 void Read_Notification(float is_new)
338 float net_type = ReadByte();
339 float net_name = ReadShort();
341 entity notif = Get_Notif_Ent(net_type, net_name);
342 if not(notif) { print("Read_Notification: Could not find notification entity!\n"); return; }
344 string s1 = ((0 < notif.nent_stringcount) ? ReadString() : "");
345 string s2 = ((1 < notif.nent_stringcount) ? ReadString() : "");
346 string s3 = ((2 < notif.nent_stringcount) ? ReadString() : "");
347 string s4 = ((3 < notif.nent_stringcount) ? ReadString() : "");
348 float f1 = ((0 < notif.nent_floatcount) ? ReadLong() : 0);
349 float f2 = ((1 < notif.nent_floatcount) ? ReadLong() : 0);
350 float f3 = ((2 < notif.nent_floatcount) ? ReadLong() : 0);
351 float f4 = ((3 < notif.nent_floatcount) ? ReadLong() : 0);
353 #ifdef NOTIFICATIONS_DEBUG
354 dprint(sprintf("Read_Notification(%d) at %f: net_name = %s.\n", is_new, time, notif.nent_name));
359 Local_Notification_Without_VarArgs(
361 notif.nent_stringcount,
362 notif.nent_floatcount,
370 void Notification_Remove()
373 for(i = 0; i < 4; ++i) { if(self.nent_strings[i]) { strunzone(self.nent_strings[i]); } }
377 float Write_Notification(entity client, float sf)
379 float i, send = FALSE;
381 switch(self.nent_broadcast)
383 case NOTIF_ONE: { if((client == self.nent_client) || (client.classname == STR_SPECTATOR && client.enemy == self.nent_client)) { send = TRUE; } break; }
384 case NOTIF_ONE_ONLY: { if(client == self.nent_client) { send = TRUE; } break; }
385 case NOTIF_TEAM: { if((client.team == self.nent_client.team) || (client.classname == STR_SPECTATOR && client.enemy.team == self.nent_client.team)) { send = TRUE; } break; }
386 case NOTIF_TEAM_EXCEPT: { if(((client != self.nent_client) && (client.team == self.nent_client.team) && !(client.classname == STR_SPECTATOR && client.enemy == self.nent_client))) { send = TRUE; } break; }
387 case NOTIF_ANY: { send = TRUE; break; }
388 case NOTIF_ANY_EXCEPT: { if((client != self.nent_client) && !(client.classname == STR_SPECTATOR && client.enemy == self.nent_client)) { send = TRUE; } break; }
389 default: { send = FALSE; break; }
394 WriteByte(MSG_ENTITY, ENT_CLIENT_NOTIFICATION);
395 WriteByte(MSG_ENTITY, self.nent_net_type);
396 WriteShort(MSG_ENTITY, self.nent_net_name);
397 for(i = 0; i < self.nent_stringcount; ++i) { WriteString(MSG_ENTITY, self.nent_strings[i]); }
398 for(i = 0; i < self.nent_floatcount; ++i) { WriteLong(MSG_ENTITY, self.nent_floats[i]); }
404 void Send_Notification(float broadcast, entity client,
405 float net_type, float net_name, ...count)
407 // check supplied broadcast, target, type, and name for errors
408 string checkargs = "";
409 #define CHECKARG_TYPENAME(type) case MSG_##type##: \
410 { if(!net_name || (net_name > NOTIF_##type##_COUNT)) \
411 { checkargs = sprintf("Improper name: %d!", net_name); } break; }
414 CHECKARG_TYPENAME(INFO)
415 CHECKARG_TYPENAME(CENTER)
416 CHECKARG_TYPENAME(WEAPON)
417 CHECKARG_TYPENAME(DEATH)
418 default: { checkargs = sprintf("Improper type: %d!", checkargs, net_type); break; }
420 #undef CHECKARG_TYPENAME
421 if(checkargs != "") { checkargs = strcat(checkargs, " "); }
425 case NOTIF_ONE_ONLY: { if(clienttype(client) == CLIENTTYPE_NOTACLIENT) { checkargs = sprintf("%sNo client provided!", checkargs); } break; }
426 case NOTIF_ANY_EXCEPT: { if(clienttype(client) == CLIENTTYPE_NOTACLIENT) { checkargs = sprintf("%sException can't be a non-client!", checkargs); } break; }
427 case NOTIF_ANY: { if(client) { checkargs = sprintf("%sEntity provided when world was required!", checkargs); } break; }
429 case NOTIF_TEAM_EXCEPT:
431 if not(teamplay) { checkargs = sprintf("%sTeamplay not active!", checkargs); }
432 else if(clienttype(client) == CLIENTTYPE_NOTACLIENT)
434 if(broadcast == NOTIF_TEAM) { checkargs = sprintf("%sNo client provided!", checkargs); }
435 else { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
439 default: { checkargs = sprintf("%sImproper broadcast: %d!", checkargs, broadcast); break; }
441 if(checkargs != "") { backtrace(sprintf("Incorrect usage of Send_Notification: %s\n", checkargs)); return; }
443 // retreive counts for the arguments of this notification
444 entity notif = Get_Notif_Ent(net_type, net_name);
445 if not(notif) { backtrace("Send_Notification: Could not find notification entity!\n"); return; }
447 if((notif.nent_stringcount + notif.nent_floatcount) > count)
451 "Not enough arguments for Send_Notification! ",
452 "stringcount(%d) + floatcount(%d) > count(%d)\n",
453 "Check the definition and function call for accuracy...?\n"
455 notif.nent_stringcount, notif.nent_floatcount, count));
458 else if((notif.nent_stringcount + notif.nent_floatcount) < count)
462 "Too many arguments for Send_Notification! ",
463 "stringcount(%d) + floatcount(%d) < count(%d)\n",
464 "Check the definition and function call for accuracy...?\n"
466 notif.nent_stringcount, notif.nent_floatcount, count));
470 #ifdef NOTIFICATIONS_DEBUG
472 sprintf("Send_Notification(%d, %d, %s, stringcount: %d, floatcount: %d, varargs: %d);\n",
476 notif.nent_stringcount,
477 notif.nent_floatcount,
483 entity net_notif = spawn();
484 net_notif.nent_broadcast = broadcast;
485 net_notif.nent_client = client;
486 net_notif.nent_net_type = net_type;
487 net_notif.nent_net_name = net_name;
488 net_notif.nent_stringcount = notif.nent_stringcount;
489 net_notif.nent_floatcount = notif.nent_floatcount;
492 for(i = 0; i < net_notif.nent_stringcount; ++i) { net_notif.nent_strings[i] = strzone(...(i, string)); }
493 for(i = 0; i < net_notif.nent_floatcount; ++i) { net_notif.nent_floats[i] = ...((net_notif.nent_stringcount + i), float); }
495 net_notif.think = Notification_Remove;
496 net_notif.nextthink = (time + 0.5);
498 Net_LinkEntity(net_notif, FALSE, 0, Write_Notification);
500 if((!server_is_local) && (broadcast == NOTIF_ANY || broadcast == NOTIF_ANY_EXCEPT) && (net_type != MSG_CENTER))
502 Local_Notification_Without_VarArgs(
504 notif.nent_stringcount,
505 notif.nent_floatcount,
506 IFSTR(0), IFSTR(1), IFSTR(2), IFSTR(3),
507 IFFL(0), IFFL(1), IFFL(2), IFFL(3));
511 void Send_Notification_Without_VarArgs(float broadcast, entity client,
512 float net_type, float net_name,
513 float stringcount, float floatcount,
514 string s1, string s2, string s3, string s4,
515 float f1, float f2, float f3, float f4)
517 #define VARITEM(stringc,floatc,args) \
518 if((stringcount == stringc) && (floatcount == floatc)) \
519 { Send_Notification(broadcast, client, net_type, net_name, args); return; }
520 EIGHT_VARS_TO_VARARGS_VARLIST
522 Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
525 void Send_Notification_Legacy_Wrapper(float broadcast, entity client,
526 float net_type, float net_name,
527 string s1, string s2,
528 float f1, float f2, float f3)
530 entity notif = Get_Notif_Ent(net_type, net_name);
531 Send_Notification_Without_VarArgs(
534 notif.nent_stringcount,
535 notif.nent_floatcount,
541 // =============================
542 // LEGACY NOTIFICATION SYSTEMS
543 // =============================
545 void Send_CSQC_Centerprint_Generic(entity e, float id, string s, float duration, float countdown_num)
547 if ((clienttype(e) == CLIENTTYPE_REAL) && (e.flags & FL_CLIENT))
550 WRITESPECTATABLE_MSG_ONE({
551 WriteByte(MSG_ONE, SVC_TEMPENTITY);
552 WriteByte(MSG_ONE, TE_CSQC_CENTERPRINT_GENERIC);
553 WriteByte(MSG_ONE, id);
554 WriteString(MSG_ONE, s);
555 if (id != 0 && s != "")
557 WriteByte(MSG_ONE, duration);
558 WriteByte(MSG_ONE, countdown_num);
563 void Send_CSQC_Centerprint_Generic_Expire(entity e, float id)
565 Send_CSQC_Centerprint_Generic(e, id, "", 1, 0);