qcsrc/common/notifications.qc

   1 // ================================================
   2 //  Unified notification system, written by Samual
   3 //  Last updated: August, 2013
   4 // ================================================
   5
   6 string Get_Notif_TypeName(float net_type)
   7 {
   8         switch(net_type)
   9         {
  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";
  16         }
  17         backtrace(sprintf("Get_Notif_TypeName(%d): Improper net type!\n", net_type));
  18         return "";
  19 }
  20
  21 entity Get_Notif_Ent(float net_type, float net_name)
  22 {
  23         switch(net_type)
  24         {
  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];
  30         }
  31         backtrace(sprintf("Get_Notif_Ent(%d, %d): Improper net type!\n", net_type, net_name));
  32         return world;
  33 }
  34
  35 #ifdef SVQC
  36 #ifdef NOTIFICATIONS_DEBUG
  37 string Get_Notif_BroadcastName(float broadcast)
  38 {
  39         switch(broadcast)
  40         {
  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";
  47         }
  48         backtrace(sprintf("Get_Notif_BroadcastName(%d): Improper broadcast!\n", broadcast));
  49         return "";
  50 }
  51 #endif
  52 #endif
  53
  54 string Notification_CheckArgs_TypeName(float net_type, float net_name)
  55 {
  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; }
  61         switch(net_type)
  62         {
  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; }
  69         }
  70         #undef CHECKARG_TYPENAME
  71         return checkargs;
  72 }
  73
  74 #ifdef SVQC
  75 string Notification_CheckArgs(
  76         float broadcast, entity client,
  77         float net_type, float net_name)
  78 {
  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, " "); }
  82         switch(broadcast)
  83         {
  84                 case NOTIF_ONE:
  85                 case NOTIF_ONE_ONLY:
  86                 {
  87                         if(IS_NOT_A_CLIENT(client))
  88                                 { checkargs = sprintf("%sNo client provided!", checkargs); }
  89                         break;
  90                 }
  91
  92                 case NOTIF_ALL_EXCEPT:
  93                 {
  94                         if(IS_NOT_A_CLIENT(client))
  95                                 { checkargs = sprintf("%sException can't be a non-client!", checkargs); }
  96                         break;
  97                 }
  98
  99                 case NOTIF_ALL:
 100                 {
 101                         if(client)
 102                                 { checkargs = sprintf("%sEntity provided when world was required!", checkargs); }
 103                         break;
 104                 }
 105
 106                 case NOTIF_TEAM:
 107                 {
 108                         if (!teamplay)
 109                                 { checkargs = sprintf("%sTeamplay not active!", checkargs); }
 110                         //else if (!client.team) { checkargs = sprintf("%sNo team provided!", checkargs); }
 111                         break;
 112                 }
 113
 114                 case NOTIF_TEAM_EXCEPT:
 115                 {
 116                         if (!teamplay)
 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); }
 120                         break;
 121                 }
 122
 123                 default: { checkargs = sprintf("%sImproper broadcast: %d!", checkargs, broadcast); break; }
 124         }
 125         return checkargs;
 126 }
 127
 128 float Notification_ShouldSend(float broadcast, entity to_client, entity other_client)
 129 {
 130         switch(broadcast)
 131         {
 132                 case NOTIF_ONE: // send to one client and their spectator
 133                 {
 134                         if(
 135                                 (to_client == other_client)
 136                                 ||
 137                                 (
 138                                         IS_SPEC(to_client)
 139                                         &&
 140                                         (to_client.enemy == other_client)
 141                                 )
 142                         ) { return TRUE; }
 143                         break;
 144                 }
 145                 case NOTIF_ONE_ONLY: // send ONLY to one client
 146                 {
 147                         if(to_client == other_client) { return TRUE; }
 148                         break;
 149                 }
 150                 case NOTIF_TEAM: // send only to X team and their spectators
 151                 {
 152                         if(
 153                                 (to_client.team == other_client.team)
 154                                 ||
 155                                 (
 156                                         IS_SPEC(to_client)
 157                                         &&
 158                                         (to_client.enemy.team == other_client.team)
 159                                 )
 160                         ) { return TRUE; }
 161                         break;
 162                 }
 163                 case NOTIF_TEAM_EXCEPT: // send only to X team and their spectators, except for Y person and their spectators
 164                 {
 165                         if(
 166                                 (to_client != other_client)
 167                                 &&
 168                                 (
 169                                         (to_client.team == other_client.team)
 170                                         ||
 171                                         (
 172                                                 IS_SPEC(to_client)
 173                                                 &&
 174                                                 (
 175                                                         (to_client.enemy != other_client)
 176                                                         &&
 177                                                         (to_client.enemy.team == other_client.team)
 178                                                 )
 179                                         )
 180                                 )
 181                         ) { return TRUE; }
 182                         break;
 183                 }
 184                 case NOTIF_ALL: // send to everyone
 185                 {
 186                         return TRUE;
 187                 }
 188                 case NOTIF_ALL_EXCEPT: // send to everyone except X person and their spectators
 189                 {
 190                         if(
 191                                 (to_client != other_client)
 192                                 &&
 193                                 !(
 194                                         IS_SPEC(to_client)
 195                                         &&
 196                                         (to_client.enemy == other_client)
 197                                 )
 198                         ) { return TRUE; }
 199                         break;
 200                 }
 201         }
 202         return FALSE;
 203 }
 204
 205 #endif
 206
 207 // ===============================
 208 //  Initialization Core Functions
 209 // ===============================
 210
 211 // used by restartnotifs command to initialize notifications
 212 void Destroy_Notification_Entity(entity notif)
 213 {
 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); }
 221         remove(notif);
 222 }
 223
 224 void Destroy_All_Notifications(void)
 225 {
 226         entity notif;
 227         float i;
 228
 229         #define DESTROY_LOOP(type,count) \
 230                 for(i = 1; i <= count; ++i) \
 231                 { \
 232                         notif = Get_Notif_Ent(type, i); \
 233                         if (!notif) { backtrace("Destroy_All_Notifications(): Missing notification entity!\n"); return; } \
 234                         Destroy_Notification_Entity(notif); \
 235                 }
 236
 237         // kill all networked notifications and centerprints
 238         #ifdef SVQC
 239         Kill_Notification(NOTIF_ALL, world, 0, 0);
 240         #else
 241         reset_centerprint_messages();
 242         #endif
 243
 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)
 250         #undef DESTROY_LOOP
 251 }
 252
 253 string Process_Notif_Line(
 254         float typeid,
 255         float chat,
 256         string input,
 257         string notiftype,
 258         string notifname,
 259         string stringtype)
 260 {
 261         #ifdef CSQC
 262         if(typeid == MSG_INFO)
 263         {
 264                 if((chat && autocvar_notification_allow_chatboxprint)
 265                         || (autocvar_notification_allow_chatboxprint == 2))
 266                 {
 267                         // pass 1: add ETX char at beginning of line
 268                         input = strcat("\{3}", input);
 269
 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);
 273
 274                         // pass 3: strip trailing ETX char
 275                         if(substring(input, (strlen(input) - 1), 1) == "\{3}")
 276                                 { input = substring(input, 0, (strlen(input) - 1)); }
 277                 }
 278         }
 279         #endif
 280
 281         // done to both MSG_INFO and MSG_CENTER
 282         if(substring(input, (strlen(input) - 1), 1) == "\n")
 283         {
 284                 printf(
 285                         strcat(
 286                                 "^1TRAILING NEW LINE AT END OF NOTIFICATION: ",
 287                                 "^7net_type = %s, net_name = %s, string = %s.\n"
 288                         ),
 289                         notiftype,
 290                         notifname,
 291                         stringtype
 292                 );
 293                 notif_error = TRUE;
 294                 input = substring(input, 1, (strlen(input) - 1));
 295         }
 296
 297         return input;
 298 }
 299
 300 string Process_Notif_Args(
 301         float arg_type,
 302         string args,
 303         string notiftype,
 304         string notifname)
 305 {
 306         string selected, remaining = args;
 307         float sel_num = 0;
 308
 309         for(;(remaining != "");)
 310         {
 311                 selected = car(remaining); remaining = cdr(remaining);
 312
 313                 switch(arg_type)
 314                 {
 315                         case 1: // normal args
 316                         {
 317                                 if(sel_num == NOTIF_MAX_ARGS)
 318                                 {
 319                                         printf(
 320                                                 strcat(
 321                                                         "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
 322                                                         "^7net_type = %s, net_name = %s, max args = %d.\n"
 323                                                 ),
 324                                                 notiftype,
 325                                                 notifname,
 326                                                 NOTIF_MAX_ARGS
 327                                         );
 328                                         notif_error = TRUE;
 329                                         break;
 330                                 }
 331
 332                                 switch(strtolower(selected))
 333                                 {
 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)
 341                                         NOTIF_ARGUMENT_LIST
 342                                         #undef ARG_CASE
 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
 349                                         default:
 350                                         {
 351                                                 printf(
 352                                                         strcat(
 353                                                                 "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
 354                                                                 "^7net_type = %s, net_name = %s, args arg = '%s'.\n"
 355                                                         ),
 356                                                         notiftype,
 357                                                         notifname,
 358                                                         selected
 359                                                 );
 360                                                 notif_error = TRUE;
 361                                                 break;
 362                                         }
 363                                 }
 364                                 break;
 365                         }
 366                         case 2: // hudargs
 367                         {
 368                                 if(sel_num == NOTIF_MAX_HUDARGS)
 369                                 {
 370                                         printf(
 371                                                 strcat(
 372                                                         "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
 373                                                         "^7net_type = %s, net_name = %s, max hudargs = %d.\n"
 374                                                 ),
 375                                                 notiftype,
 376                                                 notifname,
 377                                                 NOTIF_MAX_HUDARGS
 378                                         );
 379                                         notif_error = TRUE;
 380                                         break;
 381                                 }
 382
 383                                 switch(strtolower(selected))
 384                                 {
 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)
 392                                         NOTIF_ARGUMENT_LIST
 393                                         #undef ARG_CASE
 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
 400                                         default:
 401                                         {
 402                                                 printf(
 403                                                         strcat(
 404                                                                 "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
 405                                                                 "^7net_type = %s, net_name = %s, hudargs arg = '%s'.\n"
 406                                                         ),
 407                                                         notiftype,
 408                                                         notifname,
 409                                                         selected
 410                                                 );
 411                                                 notif_error = TRUE;
 412                                                 break;
 413                                         }
 414                                 }
 415                                 break;
 416                         }
 417                         case 3: // durcnt
 418                         {
 419                                 if(sel_num == NOTIF_MAX_DURCNT)
 420                                 {
 421                                         printf(
 422                                                 strcat(
 423                                                         "^1NOTIFICATION HAS TOO MANY ARGUMENTS: ",
 424                                                         "^7net_type = %s, net_name = %s, max durcnt = %d.\n"
 425                                                 ),
 426                                                 notiftype,
 427                                                 notifname,
 428                                                 NOTIF_MAX_DURCNT
 429                                         );
 430                                         notif_error = TRUE;
 431                                         break;
 432                                 }
 433
 434                                 switch(strtolower(selected))
 435                                 {
 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)
 443                                         NOTIF_ARGUMENT_LIST
 444                                         #undef ARG_CASE
 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
 451                                         default:
 452                                         {
 453                                                 if(ftos(stof(selected)) != "") { ++sel_num; }
 454                                                 else
 455                                                 {
 456                                                         printf(
 457                                                                 strcat(
 458                                                                         "^1NOTIFICATION WITH UNKNOWN TOKEN IN ARGUMENT STRING: ",
 459                                                                         "^7net_type = %s, net_name = %s, durcnt arg = '%s'.\n"
 460                                                                 ),
 461                                                                 notiftype,
 462                                                                 notifname,
 463                                                                 selected
 464                                                         );
 465                                                         notif_error = TRUE;
 466                                                 }
 467                                                 break;
 468                                         }
 469                                 }
 470                                 break;
 471                         }
 472                 }
 473         }
 474         return args;
 475 }
 476
 477 void Create_Notification_Entity(
 478         float var_default,
 479         float var_cvar,
 480         float typeid,
 481         float nameid,
 482         string namestring,
 483         float strnum,
 484         float flnum,
 485         /* MSG_ANNCE */
 486         float channel,
 487         string snd,
 488         float vol,
 489         float position,
 490         /* MSG_INFO & MSG_CENTER */
 491         string args,
 492         string hudargs,
 493         string icon,
 494         float cpid,
 495         string durcnt,
 496         string normal,
 497         string gentle,
 498         /* MSG_MULTI */
 499         float anncename,
 500         float infoname,
 501         float centername,
 502         /* MSG_CHOICE */
 503         float challow_def,
 504         float challow_var,
 505         float chtype,
 506         float optiona,
 507         float optionb)
 508 {
 509         // =====================
 510         //  Global Entity Setup
 511         // =====================
 512         entity notif = spawn();
 513         switch(typeid)
 514         {
 515                 case MSG_ANNCE:
 516                 {
 517                         msg_annce_notifs[nameid - 1] = notif;
 518                         notif.classname = "msg_annce_notification";
 519                         break;
 520                 }
 521                 case MSG_INFO:
 522                 {
 523                         msg_info_notifs[nameid - 1] = notif;
 524                         notif.classname = "msg_info_notification";
 525                         break;
 526                 }
 527                 case MSG_CENTER:
 528                 {
 529                         msg_center_notifs[nameid - 1] = notif;
 530                         notif.classname = "msg_center_notification";
 531                         break;
 532                 }
 533                 case MSG_MULTI:
 534                 {
 535                         msg_multi_notifs[nameid - 1] = notif;
 536                         notif.classname = "msg_multi_notification";
 537                         break;
 538                 }
 539                 case MSG_CHOICE:
 540                 {
 541                         msg_choice_notifs[nameid - 1] = notif;
 542                         notif.classname = "msg_choice_notification";
 543                         break;
 544                 }
 545
 546                 default:
 547                 {
 548                         error(sprintf(
 549                                 strcat(
 550                                         "^1NOTIFICATION WITH IMPROPER TYPE: ",
 551                                         "^7net_type = %d, net_name = %s.\n"
 552                                 ),
 553                                 typeid,
 554                                 namestring
 555                         ));
 556                         return; // It's not possible to recover from this one
 557                 }
 558         }
 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);
 564
 565         string typestring = Get_Notif_TypeName(typeid);
 566
 567         // Other pre-notif-setup requisites
 568         notif_error = FALSE;
 569
 570         // ====================
 571         //  Notification Setup
 572         // ====================
 573         switch(typeid)
 574         {
 575                 case MSG_ANNCE:
 576                 {
 577                         // Set MSG_ANNCE information and handle precaching
 578                         #ifdef CSQC
 579                         if (!(GENTLE && (var_cvar == 1)))
 580                         {
 581                                 if(snd != "")
 582                                 {
 583                                         if(notif.nent_enabled)
 584                                         {
 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;
 590                                         }
 591                                 }
 592                                 else
 593                                 {
 594                                         printf(
 595                                                 strcat(
 596                                                         "^1NOTIFICATION WITH NO SOUND: ",
 597                                                         "^7net_type = %s, net_name = %s.\n"
 598                                                 ),
 599                                                 typestring,
 600                                                 namestring
 601                                         );
 602                                         notif_error = TRUE;
 603                                 }
 604                         }
 605                         else { notif.nent_enabled = FALSE; }
 606                         #else
 607                         notif.nent_enabled = FALSE;
 608                         #endif
 609
 610                         break;
 611                 }
 612
 613                 case MSG_INFO:
 614                 case MSG_CENTER:
 615                 {
 616                         // Set MSG_INFO and MSG_CENTER string/float counts
 617                         notif.nent_stringcount = strnum;
 618                         notif.nent_floatcount = flnum;
 619
 620                         // Only initialize arguments if we're either a client or on a dedicated server
 621                         #ifdef SVQC
 622                         float should_process_args = server_is_dedicated;
 623                         #else
 624                         float should_process_args = TRUE;
 625                         #endif
 626
 627                         if(should_process_args)
 628                         {
 629                                 // ========================
 630                                 //  Process Main Arguments
 631                                 // ========================
 632                                 if(strnum + flnum)
 633                                 {
 634                                         if(args != "")
 635                                         {
 636                                                 notif.nent_args = strzone(
 637                                                         Process_Notif_Args(1, args, typestring, namestring));
 638                                         }
 639                                         else if((hudargs == "") && (durcnt ==""))
 640                                         {
 641                                                 printf(
 642                                                         strcat(
 643                                                                 "^1NOTIFICATION HAS ARG COUNTS BUT NO ARGS OR HUDARGS OR DURCNT: ",
 644                                                                 "^7net_type = %s, net_name = %s, strnum = %d, flnum = %d\n"
 645                                                         ),
 646                                                         typestring,
 647                                                         namestring,
 648                                                         strnum,
 649                                                         flnum
 650                                                 );
 651                                                 notif_error = TRUE;
 652                                         }
 653                                 }
 654                                 else if(args != "")
 655                                 {
 656                                         notif.nent_args = strzone(
 657                                                 Process_Notif_Args(1, args, typestring, namestring));
 658                                 }
 659
 660
 661                                 // =======================================
 662                                 //  Process HUD and Centerprint Arguments
 663                                 //    Only processed on CSQC, as these
 664                                 //    args are only for HUD features.
 665                                 // =======================================
 666                                 #ifdef CSQC
 667                                 if(hudargs != "")
 668                                 {
 669                                         notif.nent_hudargs = strzone(
 670                                                 Process_Notif_Args(2, hudargs, typestring, namestring));
 671
 672                                         if(icon != "") { notif.nent_icon = strzone(icon); }
 673                                         else
 674                                         {
 675                                                 printf(
 676                                                         strcat(
 677                                                                 "^1NOTIFICATION HAS HUDARGS BUT NO ICON: ",
 678                                                                 "^7net_type = %s, net_name = %s.\n"
 679                                                         ),
 680                                                         typestring,
 681                                                         namestring
 682                                                 );
 683                                                 notif_error = TRUE;
 684                                         }
 685                                 }
 686                                 else if(icon != "")
 687                                 {
 688                                         printf(
 689                                                 strcat(
 690                                                         "^1NOTIFICATION HAS ICON BUT NO HUDARGS: ",
 691                                                         "^7net_type = %s, net_name = %s.\n"
 692                                                 ),
 693                                                 typestring,
 694                                                 namestring
 695                                         );
 696                                         notif_error = TRUE;
 697                                 }
 698
 699                                 if(durcnt != "")
 700                                 {
 701                                         notif.nent_durcnt = strzone(
 702                                                 Process_Notif_Args(3, durcnt, typestring, namestring));
 703
 704                                         if(cpid != NO_MSG) { notif.nent_cpid = cpid; }
 705                                         else
 706                                         {
 707                                                 printf(
 708                                                         strcat(
 709                                                                 "^1NOTIFICATION HAS DURCNT BUT NO CPID: ",
 710                                                                 "^7net_type = %s, net_name = %s.\n"
 711                                                         ),
 712                                                         typestring,
 713                                                         namestring
 714                                                 );
 715                                                 notif_error = TRUE;
 716                                         }
 717                                 }
 718                                 else if(cpid != NO_MSG) { notif.nent_cpid = cpid; }
 719                                 #endif
 720
 721
 722                                 // ======================
 723                                 //  Process Notif String
 724                                 // ======================
 725                                 #define SET_NOTIF_STRING(string,stringname) \
 726                                         notif.nent_string = strzone(CCR( \
 727                                                 Process_Notif_Line( \
 728                                                         typeid, \
 729                                                         (var_cvar > 1), \
 730                                                         string, \
 731                                                         typestring, \
 732                                                         namestring, \
 733                                                         stringname \
 734                                                 )) \
 735                                         );
 736
 737                                 if(GENTLE)
 738                                 {
 739                                         if(gentle != "") { SET_NOTIF_STRING(gentle, "GENTLE") }
 740                                         else if(normal != "") { SET_NOTIF_STRING(normal, "NORMAL") }
 741                                 }
 742                                 else if(normal != "") { SET_NOTIF_STRING(normal, "NORMAL") }
 743
 744                                 #undef SET_NOTIF_STRING
 745
 746                                 // Check to make sure a string was chosen
 747                                 if(notif.nent_string == "")
 748                                 {
 749                                         printf(
 750                                                 strcat(
 751                                                         "^1EMPTY NOTIFICATION: ",
 752                                                         "^7net_type = %s, net_name = %s.\n"
 753                                                 ),
 754                                                 typestring,
 755                                                 namestring
 756                                         );
 757                                         notif_error = TRUE;
 758                                 }
 759                         }
 760
 761                         break;
 762                 }
 763
 764                 case MSG_MULTI:
 765                 {
 766                         // Set MSG_MULTI string/float counts
 767                         if((anncename == NO_MSG) && (infoname == NO_MSG) && (centername == NO_MSG))
 768                         {
 769                                 printf(
 770                                         strcat(
 771                                                 "^1NOTIFICATION WITH NO SUBCALLS: ",
 772                                                 "^7net_type = %s, net_name = %s.\n"
 773                                         ),
 774                                         typestring,
 775                                         namestring
 776                                 );
 777                                 notif_error = TRUE;
 778                         }
 779                         else
 780                         {
 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]; }
 783
 784                                 float infoname_stringcount = 0, infoname_floatcount = 0;
 785                                 float centername_stringcount = 0, centername_floatcount = 0;
 786
 787                                 if(infoname != NO_MSG)
 788                                 {
 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;
 792                                 }
 793
 794                                 if(centername != NO_MSG)
 795                                 {
 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;
 799                                 }
 800
 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);
 804                         }
 805
 806                         break;
 807                 }
 808
 809                 case MSG_CHOICE:
 810                 {
 811                         if((chtype == NO_MSG) || (optiona == NO_MSG) || (optionb == NO_MSG))
 812                         {
 813                                 printf(
 814                                         strcat(
 815                                                 "^1NOTIFICATION IS MISSING CHOICE PARAMS: ",
 816                                                 "^7net_type = %s, net_name = %s.\n"
 817                                         ),
 818                                         typestring,
 819                                         namestring
 820                                 );
 821                                 notif_error = TRUE;
 822                         }
 823                         else
 824                         {
 825                                 switch(chtype)
 826                                 {
 827                                         case MSG_ANNCE:
 828                                         {
 829                                                 notif.nent_optiona = msg_annce_notifs[optiona - 1];
 830                                                 notif.nent_optionb = msg_annce_notifs[optionb - 1];
 831                                                 break;
 832                                         }
 833                                         case MSG_INFO:
 834                                         {
 835                                                 notif.nent_optiona = msg_info_notifs[optiona - 1];
 836                                                 notif.nent_optionb = msg_info_notifs[optionb - 1];
 837                                                 break;
 838                                         }
 839                                         case MSG_CENTER:
 840                                         {
 841                                                 notif.nent_optiona = msg_center_notifs[optiona - 1];
 842                                                 notif.nent_optionb = msg_center_notifs[optionb - 1];
 843                                                 break;
 844                                         }
 845                                         case MSG_MULTI:
 846                                         {
 847                                                 notif.nent_optiona = msg_multi_notifs[optiona - 1];
 848                                                 notif.nent_optionb = msg_multi_notifs[optionb - 1];
 849                                                 break;
 850                                         }
 851                                         case MSG_CHOICE: // should we REALLY allow nested options?...
 852                                         {
 853                                                 notif.nent_optiona = msg_choice_notifs[optiona - 1];
 854                                                 notif.nent_optionb = msg_choice_notifs[optionb - 1];
 855                                                 break;
 856                                         }
 857
 858                                         default:
 859                                         {
 860                                                 printf(
 861                                                         strcat(
 862                                                                 "^1NOTIFICATION WITH IMPROPER TYPE: ",
 863                                                                 "^7net_type = %d, net_name = %s.\n"
 864                                                         ),
 865                                                         typeid,
 866                                                         namestring
 867                                                 );
 868                                                 notif_error = TRUE;
 869                                                 break;
 870                                         }
 871                                 }
 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);
 876
 877                                 /*#ifdef NOTIFICATIONS_DEBUG
 878                                 Debug_Notification(sprintf(
 879                                         "Create_Notification_Entity(...): MSG_CHOICE: %s\n%s\n%s\n",
 880                                         notif.nent_name,
 881                                         sprintf(
 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
 887                                         ),
 888                                         sprintf(
 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
 894                                         )
 895                                 ));
 896                                 #endif*/
 897                         }
 898                         break;
 899                 }
 900
 901                 default:
 902                 {
 903                         printf(
 904                                 strcat(
 905                                         "^1NOTIFICATION WITH IMPROPER TYPE: ",
 906                                         "^7net_type = %d, net_name = %s.\n"
 907                                 ),
 908                                 typeid,
 909                                 namestring
 910                         );
 911                         notif_error = TRUE;
 912                         break;
 913                 }
 914         }
 915
 916         // now check to see if any errors happened
 917         if(notif_error)
 918         {
 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
 921         }
 922 }
 923
 924
 925 // ===============
 926 //  Cvar Handling
 927 // ===============
 928
 929 // used by MSG_CHOICE to build list of choices
 930 #ifdef SVQC
 931 void Notification_GetCvars(void)
 932 {
 933         float i;
 934         for(i = 0; i <= NOTIF_CHOICE_COUNT; ++i)
 935         {
 936                 GetCvars_handleFloat(
 937                         get_cvars_s,
 938                         get_cvars_f,
 939                         msg_choice_choices[i],
 940                         sprintf("notification_%s", msg_choice_notifs[i].nent_name)
 941                 );
 942         }
 943 }
 944 #endif
 945
 946 // used to output notifications.cfg file
 947 void Dump_Notifications(float fh, float alsoprint)
 948 {
 949         #define NOTIF_WRITE(a) { \
 950                 fputs(fh, a); \
 951                 if(alsoprint) { print(a); } }
 952         #define NOTIF_WRITE_ENTITY(description) { \
 953                 notif_msg = \
 954                         sprintf( \
 955                                 "seta notification_%s \"%d\" \"%s\"\n", \
 956                                 e.nent_name, e.nent_default, description \
 957                         ); \
 958                 NOTIF_WRITE(notif_msg) }
 959         #define NOTIF_WRITE_ENTITY_CHOICE(descriptiona,descriptionb) { \
 960                 notif_msg = \
 961                         sprintf( \
 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 \
 966                         ); \
 967                 NOTIF_WRITE(notif_msg) }
 968         #define NOTIF_WRITE_HARDCODED(cvar,default,description) { \
 969                 notif_msg = \
 970                         sprintf( \
 971                                 "seta notification_%s \"%s\" \"%s\"\n", \
 972                                 cvar, default, description \
 973                         ); \
 974                 NOTIF_WRITE(notif_msg) }
 975
 976         string notif_msg;
 977         float i;
 978         entity e;
 979
 980         // Note: This warning only applies to the notifications.cfg file that is output...
 981
 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.
 985
 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");
 998
 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.
1002
1003         NOTIF_WRITE(sprintf("\n// MSG_ANNCE notifications (count = %d):\n", NOTIF_ANNCE_COUNT));
1004         for(i = 1; i <= NOTIF_ANNCE_COUNT; ++i)
1005         {
1006                 e = Get_Notif_Ent(MSG_ANNCE, i);
1007                 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1008
1009                 NOTIF_WRITE_ENTITY(
1010                         "0 = disabled, 1 = enabled if gentle mode is off, 2 = always enabled"
1011                 );
1012         }
1013
1014         NOTIF_WRITE(sprintf("\n// MSG_INFO notifications (count = %d):\n", NOTIF_INFO_COUNT));
1015         for(i = 1; i <= NOTIF_INFO_COUNT; ++i)
1016         {
1017                 e = Get_Notif_Ent(MSG_INFO, i);
1018                 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1019
1020                 NOTIF_WRITE_ENTITY(
1021                         "0 = off, 1 = print to console, "
1022                         "2 = print to console and chatbox (if notification_allow_chatboxprint is enabled)"
1023                 );
1024         }
1025
1026         NOTIF_WRITE(sprintf("\n// MSG_CENTER notifications (count = %d):\n", NOTIF_CENTER_COUNT));
1027         for(i = 1; i <= NOTIF_CENTER_COUNT; ++i)
1028         {
1029                 e = Get_Notif_Ent(MSG_CENTER, i);
1030                 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1031
1032                 NOTIF_WRITE_ENTITY(
1033                         "0 = off, 1 = centerprint"
1034                 );
1035         }
1036
1037         NOTIF_WRITE(sprintf("\n// MSG_MULTI notifications (count = %d):\n", NOTIF_MULTI_COUNT));
1038         for(i = 1; i <= NOTIF_MULTI_COUNT; ++i)
1039         {
1040                 e = Get_Notif_Ent(MSG_MULTI, i);
1041                 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1042
1043                 NOTIF_WRITE_ENTITY(
1044                         "Enable this multiple notification"
1045                 );
1046         }
1047
1048         NOTIF_WRITE(sprintf("\n// MSG_CHOICE notifications (count = %d):\n", NOTIF_CHOICE_COUNT));
1049         for(i = 1; i <= NOTIF_CHOICE_COUNT; ++i)
1050         {
1051                 e = Get_Notif_Ent(MSG_CHOICE, i);
1052                 if (!e) { backtrace("Dump_Notifications(): Missing notification entity!\n"); return; }
1053
1054                 NOTIF_WRITE_ENTITY_CHOICE(
1055                         "Choice for this notification 0 = off, 1 = default message, 2 = verbose message",
1056                         "Allow choice for this notification 0 = off, 1 = only in warmup mode, 2 = always"
1057                 );
1058         }
1059
1060         // edit these to match whichever cvars are used for specific notification options
1061         NOTIF_WRITE("\n// HARD CODED notification variables:\n");
1062
1063         NOTIF_WRITE_HARDCODED(
1064                 "allow_chatboxprint", "1",
1065                 "Allow INFO notifications to be printed to chat box"
1066                 "0 = do not allow, "
1067                 "1 = allow only if allowed by individual notification_INFO* cvars, "
1068                 "2 = force all INFO notifications to be printed to the chatbox"
1069         );
1070
1071         NOTIF_WRITE_HARDCODED(
1072                 "debug", "0",
1073                 "Print extra debug information on all notification function calls "
1074                 "(Requires -DNOTIFICATIONS_DEBUG flag to be enabled on QCSRC compilation)... "
1075                 "0 = disabled, 1 = dprint, 2 = print"
1076         );
1077
1078         NOTIF_WRITE_HARDCODED(
1079                 "errors_are_fatal", "1",
1080                 "If a notification fails upon initialization, cause a Host_Error to stop the program"
1081         );
1082
1083         NOTIF_WRITE_HARDCODED(
1084                 "item_centerprinttime", "1.5",
1085                 "How long to show item information centerprint messages (like 'You got the Electro' or such)"
1086         );
1087
1088         NOTIF_WRITE_HARDCODED(
1089                 "lifetime_mapload", "10",
1090                 "Amount of time that notification entities last immediately at mapload (in seconds) "
1091                 "to help prevent notifications from being lost on early init (like gamestart countdown)"
1092         );
1093
1094         NOTIF_WRITE_HARDCODED(
1095                 "lifetime_runtime", "0.5",
1096                 "Amount of time that notification entities last on the server during runtime (In seconds)"
1097         );
1098
1099         NOTIF_WRITE_HARDCODED(
1100                 "server_allows_location", "1",
1101                 "Server side cvar for allowing death messages to show location information too"
1102         );
1103
1104         NOTIF_WRITE_HARDCODED(
1105                 "show_location", "0",
1106                 "Append location information to MSG_INFO death/kill messages"
1107         );
1108
1109         NOTIF_WRITE_HARDCODED(
1110                 "show_location_string", "",
1111                 "Replacement string piped into sprintf, "
1112                 "so you can do different messages like this: ' at the %s' or ' (near %s)'"
1113         );
1114
1115         NOTIF_WRITE_HARDCODED(
1116                 "show_sprees", "1",
1117                 "Print information about sprees in death/kill messages"
1118         );
1119
1120         NOTIF_WRITE_HARDCODED(
1121                 "show_sprees_center", "1",
1122                 "Show spree information in MSG_CENTER messages... "
1123                 "0 = off, 1 = target (but only for first victim) and attacker"
1124         );
1125
1126         NOTIF_WRITE_HARDCODED(
1127                 "show_sprees_center_specialonly", "1",
1128                 "Don't show spree information in MSG_CENTER messages if it isn't an achievement"
1129         );
1130
1131         NOTIF_WRITE_HARDCODED(
1132                 "show_sprees_info", "3",
1133                 "Show spree information in MSG_INFO messages... "
1134                 "0 = off, 1 = target only, 2 = attacker only, 3 = target and attacker"
1135         );
1136
1137         NOTIF_WRITE_HARDCODED(
1138                 "show_sprees_info_newline", "1",
1139                 "Show attacker spree information for MSG_INFO messages on a separate line than the death notification itself"
1140         );
1141
1142         NOTIF_WRITE_HARDCODED(
1143                 "show_sprees_info_specialonly", "1",
1144                 "Don't show attacker spree information in MSG_INFO messages if it isn't an achievement"
1145         );
1146
1147         NOTIF_WRITE(sprintf(
1148                 strcat(
1149                         "\n// Notification counts (total = %d): ",
1150                         "MSG_ANNCE = %d, MSG_INFO = %d, MSG_CENTER = %d, MSG_MULTI = %d, MSG_CHOICE = %d\n"
1151                 ),
1152                 (
1153                         NOTIF_ANNCE_COUNT +
1154                         NOTIF_INFO_COUNT +
1155                         NOTIF_CENTER_COUNT +
1156                         NOTIF_MULTI_COUNT +
1157                         NOTIF_CHOICE_COUNT
1158                 ),
1159                 NOTIF_ANNCE_COUNT,
1160                 NOTIF_INFO_COUNT,
1161                 NOTIF_CENTER_COUNT,
1162                 NOTIF_MULTI_COUNT,
1163                 NOTIF_CHOICE_COUNT
1164         ));
1165
1166         return;
1167         #undef NOTIF_WRITE_HARDCODED
1168         #undef NOTIF_WRITE_ENTITY
1169         #undef NOTIF_WRITE
1170 }
1171
1172
1173 // ===============================
1174 //  Frontend Notification Pushing
1175 // ===============================
1176
1177 #ifdef NOTIFICATIONS_DEBUG
1178 void Debug_Notification(string input)
1179 {
1180         switch(autocvar_notification_debug)
1181         {
1182                 case 1: { dprint(input); break; }
1183                 case 2: { print(input); break; }
1184         }
1185 }
1186 #endif
1187
1188 string Local_Notification_sprintf(
1189         string input, string args,
1190         string s1, string s2, string s3, string s4,
1191         float f1, float f2, float f3, float f4)
1192 {
1193         #ifdef NOTIFICATIONS_DEBUG
1194         Debug_Notification(sprintf(
1195                 "Local_Notification_sprintf('%s^7', '%s', %s, %s);\n",
1196                 MakeConsoleSafe(input),
1197                 args,
1198                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1199                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1200         ));
1201         #endif
1202
1203         string selected;
1204         float sel_num;
1205         for(sel_num = 0; sel_num < NOTIF_MAX_ARGS; ++sel_num) { arg_slot[sel_num] = ""; }
1206
1207         string tmp_s;
1208
1209         for(sel_num = 0;(args != "");)
1210         {
1211                 selected = car(args); args = cdr(args);
1212                 NOTIF_HIT_MAX(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
1213                 switch(strtolower(selected))
1214                 {
1215                         #ifdef CSQC
1216                         #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1217                         #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1218                         #define ARG_CASE_ARG_CS_SV(selected,result)    case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1219                         #define ARG_CASE_ARG_CS(selected,result)       case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1220                         #define ARG_CASE_ARG_SV(selected,result)
1221                         #define ARG_CASE_ARG_DC(selected,result)
1222                         #else
1223                         #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1224                         #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1225                         #define ARG_CASE_ARG_CS_SV(selected,result)    case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1226                         #define ARG_CASE_ARG_CS(selected,result)
1227                         #define ARG_CASE_ARG_SV(selected,result)       case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1228                         #define ARG_CASE_ARG_DC(selected,result)
1229                         #endif
1230                         #define ARG_CASE(prog,selected,result)         ARG_CASE_##prog(selected,result)
1231                         NOTIF_ARGUMENT_LIST
1232                         #undef ARG_CASE
1233                         #undef ARG_CASE_ARG_DC
1234                         #undef ARG_CASE_ARG_SV
1235                         #undef ARG_CASE_ARG_CS
1236                         #undef ARG_CASE_ARG_CS_SV
1237                         #undef ARG_CASE_ARG_CS_SV_DC
1238                         #undef ARG_CASE_ARG_CS_SV_HA
1239                         default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_ARGS, "Local_Notification_sprintf")
1240                 }
1241         }
1242         return sprintf(
1243                 strcat(input, "\n"),
1244                 arg_slot[0],
1245                 arg_slot[1],
1246                 arg_slot[2],
1247                 arg_slot[3],
1248                 arg_slot[4],
1249                 arg_slot[5],
1250                 arg_slot[6]
1251         );
1252 }
1253
1254 #ifdef CSQC
1255 void Local_Notification_sound(
1256         float soundchannel, string soundfile,
1257         float soundvolume, float soundposition)
1258 {
1259         if((soundfile != prev_soundfile) || (time >= (prev_soundtime + autocvar_cl_announcer_antispam)))
1260         {
1261                 #ifdef NOTIFICATIONS_DEBUG
1262                 Debug_Notification(sprintf(
1263                         "Local_Notification_sound(world, %f, '%s', %f, %f);\n",
1264                         soundchannel,
1265                         sprintf(
1266                                 "announcer/%s/%s.wav",
1267                                 autocvar_cl_announcer,
1268                                 soundfile
1269                         ),
1270                         soundvolume,
1271                         soundposition
1272                 ));
1273                 #endif
1274
1275                 sound(
1276                         world,
1277                         soundchannel,
1278                         sprintf(
1279                                 "announcer/%s/%s.wav",
1280                                 autocvar_cl_announcer,
1281                                 soundfile
1282                         ),
1283                         soundvolume,
1284                         soundposition
1285                 );
1286
1287                 if(prev_soundfile) { strunzone(prev_soundfile); }
1288                 prev_soundfile = strzone(soundfile);
1289                 prev_soundtime = time;
1290         }
1291         else
1292         {
1293                 #ifdef NOTIFICATIONS_DEBUG
1294                 Debug_Notification(sprintf(
1295                         strcat(
1296                                 "Local_Notification_sound(world, %f, '%s', %f, %f) ",
1297                                 "^1BLOCKED BY ANTISPAM:^7 prevsnd: '%s', timediff: %f, limit: %f\n"
1298                          ),
1299                         soundchannel,
1300                         sprintf(
1301                                 "announcer/%s/%s.wav",
1302                                 autocvar_cl_announcer,
1303                                 soundfile
1304                         ),
1305                         soundvolume,
1306                         soundposition,
1307                         prev_soundfile,
1308                         (time - prev_soundtime),
1309                         autocvar_cl_announcer_antispam
1310                 ));
1311                 #endif
1312         }
1313 }
1314
1315 void Local_Notification_HUD_Notify_Push(
1316         string icon, string hudargs,
1317         string s1, string s2, string s3, string s4,
1318         float f1, float f2, float f3, float f4)
1319 {
1320         string selected;
1321         float sel_num;
1322         arg_slot[0] = ""; arg_slot[1] = "";
1323
1324         for(sel_num = 0;(hudargs != "");)
1325         {
1326                 selected = car(hudargs); hudargs = cdr(hudargs);
1327                 NOTIF_HIT_MAX(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
1328                 switch(strtolower(selected))
1329                 {
1330                         #define ARG_CASE_ARG_CS_SV_HA(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1331                         #define ARG_CASE_ARG_CS_SV_DC(selected,result)
1332                         #define ARG_CASE_ARG_CS_SV(selected,result)
1333                         #define ARG_CASE_ARG_CS(selected,result)
1334                         #define ARG_CASE_ARG_SV(selected,result)
1335                         #define ARG_CASE_ARG_DC(selected,result)
1336                         #define ARG_CASE(prog,selected,result)         ARG_CASE_##prog(selected,result)
1337                         NOTIF_ARGUMENT_LIST
1338                         #undef ARG_CASE
1339                         #undef ARG_CASE_ARG_DC
1340                         #undef ARG_CASE_ARG_SV
1341                         #undef ARG_CASE_ARG_CS
1342                         #undef ARG_CASE_ARG_CS_SV
1343                         #undef ARG_CASE_ARG_CS_SV_DC
1344                         #undef ARG_CASE_ARG_CS_SV_HA
1345                         default: NOTIF_HIT_UNKNOWN(NOTIF_MAX_HUDARGS, "Local_Notification_HUD_Notify_Push")
1346                 }
1347         }
1348         #ifdef NOTIFICATIONS_DEBUG
1349         Debug_Notification(sprintf(
1350                 "Local_Notification_HUD_Notify_Push('%s^7', '%s', %s, %s, %s);\n",
1351                 icon,
1352                 hudargs,
1353                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1354                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4),
1355                 MakeConsoleSafe(sprintf("'%s^7', '%s^7'", stof(arg_slot[0]), stof(arg_slot[1])))
1356         ));
1357         #endif
1358         HUD_Notify_Push(icon, arg_slot[0], arg_slot[1]);
1359 }
1360
1361 void Local_Notification_centerprint_generic(
1362         string input, string durcnt,
1363         float cpid, float f1, float f2)
1364 {
1365         string selected;
1366         float sel_num;
1367         arg_slot[0] = ""; arg_slot[1] = "";
1368
1369         for(sel_num = 0;(durcnt != "");)
1370         {
1371                 selected = car(durcnt); durcnt = cdr(durcnt);
1372                 NOTIF_HIT_MAX(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic")
1373                 switch(strtolower(selected))
1374                 {
1375                         #define ARG_CASE_ARG_CS_SV_HA(selected,result)
1376                         #define ARG_CASE_ARG_CS_SV_DC(selected,result) case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1377                         #define ARG_CASE_ARG_CS_SV(selected,result)
1378                         #define ARG_CASE_ARG_CS(selected,result)
1379                         #define ARG_CASE_ARG_SV(selected,result)
1380                         #define ARG_CASE_ARG_DC(selected,result)       case selected: { arg_slot[sel_num] = result; ++sel_num; break; }
1381                         #define ARG_CASE(prog,selected,result)         ARG_CASE_##prog(selected,result)
1382                         NOTIF_ARGUMENT_LIST
1383                         #undef ARG_CASE
1384                         #undef ARG_CASE_ARG_DC
1385                         #undef ARG_CASE_ARG_SV
1386                         #undef ARG_CASE_ARG_CS
1387                         #undef ARG_CASE_ARG_CS_SV
1388                         #undef ARG_CASE_ARG_CS_SV_DC
1389                         #undef ARG_CASE_ARG_CS_SV_HA
1390                         default:
1391                         {
1392                                 if(ftos(stof(selected)) != "") { arg_slot[sel_num] = selected; ++sel_num; }
1393                                 else { NOTIF_HIT_UNKNOWN(NOTIF_MAX_DURCNT, "Local_Notification_centerprint_generic") }
1394                                 break;
1395                         }
1396                 }
1397         }
1398         #ifdef NOTIFICATIONS_DEBUG
1399         Debug_Notification(sprintf(
1400                 "Local_Notification_centerprint_generic('%s^7', '%s', %d, %d, %d, %d);\n",
1401                 MakeConsoleSafe(input),
1402                 durcnt,
1403                 f1, f2,
1404                 stof(arg_slot[0]),
1405                 stof(arg_slot[1])
1406         ));
1407         #endif
1408         centerprint_generic(cpid, input, stof(arg_slot[0]), stof(arg_slot[1]));
1409 }
1410 #endif
1411
1412 void Local_Notification(float net_type, float net_name, ...count)
1413 {
1414         // check if this should be aborted
1415         if(net_name == NOTIF_ABORT)
1416         {
1417                 #ifdef NOTIFICATIONS_DEBUG
1418                 Debug_Notification(sprintf(
1419                         "Local_Notification(%s, %s, ...);\n",
1420                         Get_Notif_TypeName(net_type),
1421                         "NOTIF_ABORT"
1422                 ));
1423                 #endif
1424                 return;
1425         }
1426
1427         // check supplied type and name for errors
1428         string checkargs = Notification_CheckArgs_TypeName(net_type, net_name);
1429         if(checkargs != "")
1430         {
1431                 #ifdef NOTIFICATIONS_DEBUG
1432                 Debug_Notification(sprintf(
1433                         "Local_Notification(%s, %d, ...);\n",
1434                         Get_Notif_TypeName(net_type),
1435                         Get_Notif_Ent(net_type, net_name).nent_name
1436                 ));
1437                 #endif
1438                 backtrace(sprintf("Incorrect usage of Local_Notification: %s\n", checkargs));
1439                 return;
1440         }
1441
1442         // retreive entity of this notification
1443         entity notif = Get_Notif_Ent(net_type, net_name);
1444         if (!notif)
1445         {
1446                 #ifdef NOTIFICATIONS_DEBUG
1447                 Debug_Notification(sprintf(
1448                         "Local_Notification(%s, %d, ...);\n",
1449                         Get_Notif_TypeName(net_type),
1450                         net_name
1451                 ));
1452                 #endif
1453                 backtrace("Local_Notification: Could not find notification entity!\n");
1454                 return;
1455         }
1456
1457         // check if the notification is enabled
1458         if (!notif.nent_enabled)
1459         {
1460                 #ifdef NOTIFICATIONS_DEBUG
1461                 Debug_Notification(sprintf(
1462                         "Local_Notification(%s, %s, ...): Entity was disabled...\n",
1463                         Get_Notif_TypeName(net_type),
1464                         notif.nent_name
1465                 ));
1466                 #endif
1467                 return;
1468         }
1469
1470         string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
1471         string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
1472         string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
1473         string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
1474         float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
1475         float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
1476         float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
1477         float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
1478
1479         #ifdef NOTIFICATIONS_DEBUG
1480         Debug_Notification(sprintf(
1481                 "Local_Notification(%s, %s, %s, %s);\n",
1482                 Get_Notif_TypeName(net_type),
1483                 notif.nent_name,
1484                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1485                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1486         ));
1487         #endif
1488
1489         if((notif.nent_stringcount + notif.nent_floatcount) > count)
1490         {
1491                 backtrace(sprintf(
1492                         strcat(
1493                                 "Not enough arguments for Local_Notification(%s, %s, ...)! ",
1494                                 "stringcount(%d) + floatcount(%d) > count(%d)\n",
1495                                 "Check the definition and function call for accuracy...?\n"
1496                         ),
1497                         Get_Notif_TypeName(net_type),
1498                         notif.nent_name,
1499                         notif.nent_stringcount,
1500                         notif.nent_floatcount,
1501                         count
1502                 ));
1503                 return;
1504         }
1505         else if((notif.nent_stringcount + notif.nent_floatcount) < count)
1506         {
1507                 backtrace(sprintf(
1508                         strcat(
1509                                 "Too many arguments for Local_Notification(%s, %s, ...)! ",
1510                                 "stringcount(%d) + floatcount(%d) < count(%d)\n",
1511                                 "Check the definition and function call for accuracy...?\n"
1512                         ),
1513                         Get_Notif_TypeName(net_type),
1514                         notif.nent_name,
1515                         notif.nent_stringcount,
1516                         notif.nent_floatcount,
1517                         count
1518                 ));
1519                 return;
1520         }
1521
1522         switch(net_type)
1523         {
1524                 case MSG_ANNCE:
1525                 {
1526                         #ifdef CSQC
1527                         Local_Notification_sound(
1528                                 notif.nent_channel,
1529                                 notif.nent_snd,
1530                                 notif.nent_vol,
1531                                 notif.nent_position
1532                         );
1533                         #else
1534                         backtrace("MSG_ANNCE on server?... Please notify Samual immediately!\n");
1535                         #endif
1536                         break;
1537                 }
1538
1539                 case MSG_INFO:
1540                 {
1541                         print(
1542                                 Local_Notification_sprintf(
1543                                         notif.nent_string,
1544                                         notif.nent_args,
1545                                         s1, s2, s3, s4,
1546                                         f1, f2, f3, f4)
1547                         );
1548                         #ifdef CSQC
1549                         if(notif.nent_icon != "")
1550                         {
1551                                 Local_Notification_HUD_Notify_Push(
1552                                         notif.nent_icon,
1553                                         notif.nent_hudargs,
1554                                         s1, s2, s3, s4,
1555                                         f1, f2, f3, f4);
1556                         }
1557                         #endif
1558                         break;
1559                 }
1560
1561                 #ifdef CSQC
1562                 case MSG_CENTER:
1563                 {
1564                         Local_Notification_centerprint_generic(
1565                                 Local_Notification_sprintf(
1566                                         notif.nent_string,
1567                                         notif.nent_args,
1568                                         s1, s2, s3, s4,
1569                                         f1, f2, f3, f4),
1570                                 notif.nent_durcnt,
1571                                 notif.nent_cpid,
1572                                 f1, f2);
1573                         break;
1574                 }
1575                 #endif
1576
1577                 case MSG_MULTI:
1578                 {
1579                         if(notif.nent_msginfo)
1580                         if(notif.nent_msginfo.nent_enabled)
1581                         {
1582                                 Local_Notification_WOVA(
1583                                         MSG_INFO,
1584                                         notif.nent_msginfo.nent_id,
1585                                         notif.nent_msginfo.nent_stringcount,
1586                                         notif.nent_msginfo.nent_floatcount,
1587                                         s1, s2, s3, s4,
1588                                         f1, f2, f3, f4);
1589                         }
1590                         #ifdef CSQC
1591                         if(notif.nent_msgannce)
1592                         if(notif.nent_msgannce.nent_enabled)
1593                         {
1594                                 Local_Notification_WOVA(
1595                                         MSG_ANNCE,
1596                                         notif.nent_msgannce.nent_id,
1597                                         0, 0,
1598                                         "", "", "", "",
1599                                         0, 0, 0, 0);
1600                         }
1601                         if(notif.nent_msgcenter)
1602                         if(notif.nent_msgcenter.nent_enabled)
1603                         {
1604                                 Local_Notification_WOVA(
1605                                         MSG_CENTER,
1606                                         notif.nent_msgcenter.nent_id,
1607                                         notif.nent_msgcenter.nent_stringcount,
1608                                         notif.nent_msgcenter.nent_floatcount,
1609                                         s1, s2, s3, s4,
1610                                         f1, f2, f3, f4);
1611                         }
1612                         #endif
1613                         break;
1614                 }
1615
1616                 case MSG_CHOICE:
1617                 {
1618                         entity found_choice;
1619
1620                         if(notif.nent_challow_var && (warmup_stage || (notif.nent_challow_var == 2)))
1621                         {
1622                                 switch(cvar_string(sprintf("notification_%s", notif.nent_name)))
1623                                 {
1624                                         case 1: found_choice = notif.nent_optiona; break;
1625                                         case 2: found_choice = notif.nent_optionb; break;
1626                                         default: return; // not enabled anyway
1627                                 }
1628                         }
1629                         else { found_choice = notif.nent_optiona; }
1630
1631                         Local_Notification_WOVA(
1632                                 found_choice.nent_type,
1633                                 found_choice.nent_id,
1634                                 found_choice.nent_stringcount,
1635                                 found_choice.nent_floatcount,
1636                                 s1, s2, s3, s4,
1637                                 f1, f2, f3, f4);
1638                 }
1639         }
1640 }
1641
1642 // WOVA = Without Variable Arguments
1643 void Local_Notification_WOVA(
1644         float net_type, float net_name,
1645         float stringcount, float floatcount,
1646         string s1, string s2, string s3, string s4,
1647         float f1, float f2, float f3, float f4)
1648 {
1649         #define VARITEM(stringc,floatc,args) \
1650                 if((stringcount == stringc) && (floatcount == floatc)) \
1651                         { Local_Notification(net_type, net_name, args); return; }
1652         EIGHT_VARS_TO_VARARGS_VARLIST
1653         #undef VARITEM
1654         Local_Notification(net_type, net_name); // some notifications don't have any arguments at all
1655 }
1656
1657
1658 // =========================
1659 //  Notification Networking
1660 // =========================
1661
1662 #ifdef CSQC
1663 void Read_Notification(float is_new)
1664 {
1665         float net_type = ReadByte();
1666         float net_name = ReadShort();
1667
1668         entity notif;
1669
1670         if(net_type == MSG_CENTER_CPID)
1671         {
1672                 #ifdef NOTIFICATIONS_DEBUG
1673                 Debug_Notification(sprintf(
1674                         "Read_Notification(%d) at %f: net_type = %s, net_name = %d\n",
1675                         is_new,
1676                         time,
1677                         Get_Notif_TypeName(net_type),
1678                         net_name
1679                 ));
1680                 #endif
1681
1682                 if(is_new)
1683                 {
1684                         if(net_name == 0) { reset_centerprint_messages(); }
1685                         else if(net_name != NO_CPID)
1686                         {
1687                                 // in this case, net_name IS the cpid we want to kill
1688                                 centerprint_generic(net_name, "", 0, 0);
1689                         }
1690                         else
1691                         {
1692                                 backtrace(sprintf(
1693                                         "Read_Notification(%d) at %f: ^1TRIED TO KILL NO_CPID CENTERPRINT!\n",
1694                                         is_new,
1695                                         time
1696                                 ));
1697                         }
1698                 }
1699         }
1700         else
1701         {
1702                 notif = Get_Notif_Ent(net_type, net_name);
1703                 if (!notif) { backtrace("Read_Notification: Could not find notification entity!\n"); return; }
1704
1705                 #ifdef NOTIFICATIONS_DEBUG
1706                 Debug_Notification(sprintf(
1707                         "Read_Notification(%d) at %f: net_type = %s, net_name = %s\n",
1708                         is_new,
1709                         time,
1710                         Get_Notif_TypeName(net_type),
1711                         notif.nent_name
1712                 ));
1713                 #endif
1714
1715                 string s1 = ((0 < notif.nent_stringcount) ? ReadString() : "");
1716                 string s2 = ((1 < notif.nent_stringcount) ? ReadString() : "");
1717                 string s3 = ((2 < notif.nent_stringcount) ? ReadString() : "");
1718                 string s4 = ((3 < notif.nent_stringcount) ? ReadString() : "");
1719                 float f1 = ((0 < notif.nent_floatcount) ? ReadLong() : 0);
1720                 float f2 = ((1 < notif.nent_floatcount) ? ReadLong() : 0);
1721                 float f3 = ((2 < notif.nent_floatcount) ? ReadLong() : 0);
1722                 float f4 = ((3 < notif.nent_floatcount) ? ReadLong() : 0);
1723
1724                 if(is_new)
1725                 {
1726                         Local_Notification_WOVA(
1727                                 net_type, net_name,
1728                                 notif.nent_stringcount,
1729                                 notif.nent_floatcount,
1730                                 s1, s2, s3, s4,
1731                                 f1, f2, f3, f4);
1732                 }
1733         }
1734 }
1735 #endif
1736
1737 #ifdef SVQC
1738 void Net_Notification_Remove()
1739 {
1740         if (!self) { backtrace(sprintf("Net_Notification_Remove() at %f: Missing self!?\n", time)); return; }
1741
1742         #ifdef NOTIFICATIONS_DEBUG
1743         Debug_Notification(sprintf(
1744                 "Net_Notification_Remove() at %f: %s '%s - %s' notification\n",
1745                 time,
1746                 ((self.nent_net_name == -1) ? "Killed" : "Removed"),
1747                 Get_Notif_TypeName(self.nent_net_type),
1748                 self.owner.nent_name
1749         ));
1750         #endif
1751
1752         float i;
1753         for(i = 0; i < 4; ++i) { if(self.nent_strings[i]) { strunzone(self.nent_strings[i]); } }
1754         remove(self);
1755 }
1756
1757 float Net_Write_Notification(entity client, float sf)
1758 {
1759         if(Notification_ShouldSend(self.nent_broadcast, client, self.nent_client))
1760         {
1761                 float i;
1762                 WriteByte(MSG_ENTITY, ENT_CLIENT_NOTIFICATION);
1763                 WriteByte(MSG_ENTITY, self.nent_net_type);
1764                 WriteShort(MSG_ENTITY, self.nent_net_name);
1765                 for(i = 0; i < self.nent_stringcount; ++i) { WriteString(MSG_ENTITY, self.nent_strings[i]); }
1766                 for(i = 0; i < self.nent_floatcount; ++i) { WriteLong(MSG_ENTITY, self.nent_floats[i]); }
1767                 return TRUE;
1768         }
1769         else { return FALSE; }
1770 }
1771
1772 void Kill_Notification(
1773         float broadcast, entity client,
1774         float net_type, float net_name)
1775 {
1776         #ifdef NOTIFICATIONS_DEBUG
1777         Debug_Notification(sprintf(
1778                 "Kill_Notification(%s, '%s', %s, %d);\n",
1779                 Get_Notif_BroadcastName(broadcast),
1780                 client.netname,
1781                 (net_type ? Get_Notif_TypeName(net_type) : "0"),
1782                 net_name
1783         ));
1784         #endif
1785
1786         string checkargs = Notification_CheckArgs(broadcast, client, 1, 1);
1787         if(checkargs != "") { backtrace(sprintf("Incorrect usage of Kill_Notification: %s\n", checkargs)); return; }
1788
1789         entity notif, net_notif;
1790         float killed_cpid = NO_CPID;
1791
1792         switch(net_type)
1793         {
1794                 case 0:
1795                 {
1796                         killed_cpid = 0; // kill ALL centerprints
1797                         break;
1798                 }
1799
1800                 case MSG_CENTER:
1801                 {
1802                         if(net_name)
1803                         {
1804                                 entity notif = Get_Notif_Ent(net_type, net_name);
1805                                 if (!notif) { backtrace("Kill_Notification: Could not find notification entity!\n"); return; }
1806
1807                                 if(notif.nent_cpid)
1808                                         killed_cpid = notif.nent_cpid;
1809                                 else
1810                                         killed_cpid = NO_CPID;
1811                         }
1812                         else
1813                         {
1814                                 killed_cpid = 0; // kill ALL centerprints
1815                         }
1816                         break;
1817                 }
1818
1819                 case MSG_CENTER_CPID:
1820                 {
1821                         killed_cpid = net_name;
1822                         break;
1823                 }
1824         }
1825
1826         if(killed_cpid != NO_CPID)
1827         {
1828                 net_notif = spawn();
1829                 net_notif.classname = "net_kill_notification";
1830                 net_notif.nent_broadcast = broadcast;
1831                 net_notif.nent_client = client;
1832                 net_notif.nent_net_type = MSG_CENTER_CPID;
1833                 net_notif.nent_net_name = killed_cpid;
1834                 Net_LinkEntity(net_notif, FALSE, autocvar_notification_lifetime_runtime, Net_Write_Notification);
1835         }
1836
1837         for(notif = world; (notif = find(notif, classname, "net_notification"));)
1838         {
1839                 if(net_type)
1840                 {
1841                         if((killed_cpid != NO_CPID) && (notif.nent_net_type == MSG_CENTER))
1842                         {
1843                                 if(notif.owner.nent_cpid == killed_cpid)
1844                                 {
1845                                         notif.nent_net_name = -1;
1846                                         notif.nextthink = time;
1847                                 }
1848                                 else { continue; } // we ARE looking for a specific CPID, don't kill everything else too
1849                         }
1850                         else if(notif.nent_net_type == net_type)
1851                         {
1852                                 if(net_name)
1853                                 {
1854                                         if(notif.nent_net_name == net_name) { notif.nent_net_name = -1; notif.nextthink = time; }
1855                                         else { continue; } // we ARE looking for a certain net_name, don't kill everything else too
1856                                 }
1857                                 else { notif.nent_net_name = -1; notif.nextthink = time; }
1858                         }
1859                         else { continue; } // we ARE looking for a certain net_type, don't kill everything else too
1860                 }
1861                 else { notif.nent_net_name = -1; notif.nextthink = time; }
1862         }
1863 }
1864
1865 void Send_Notification(
1866         float broadcast, entity client,
1867         float net_type, float net_name,
1868         ...count)
1869 {
1870         // check if this should be aborted
1871         if(net_name == NOTIF_ABORT)
1872         {
1873                 #ifdef NOTIFICATIONS_DEBUG
1874                 Debug_Notification(sprintf(
1875                         "Send_Notification(%s, '%s', %s, %s, ...);\n",
1876                         Get_Notif_BroadcastName(broadcast),
1877                         client.classname,
1878                         Get_Notif_TypeName(net_type),
1879                         "NOTIF_ABORT"
1880                 ));
1881                 #endif
1882                 return;
1883         }
1884
1885         // check supplied broadcast, target, type, and name for errors
1886         string checkargs = Notification_CheckArgs(broadcast, client, net_type, net_name);
1887         if(checkargs != "")
1888         {
1889                 #ifdef NOTIFICATIONS_DEBUG
1890                 Debug_Notification(sprintf(
1891                         "Send_Notification(%s, '%s', %s, %s, ...);\n",
1892                         Get_Notif_BroadcastName(broadcast),
1893                         client.classname,
1894                         Get_Notif_TypeName(net_type),
1895                         Get_Notif_Ent(net_type, net_name).nent_name
1896                 ));
1897                 #endif
1898                 backtrace(sprintf("Incorrect usage of Send_Notification: %s\n", checkargs));
1899                 return;
1900         }
1901
1902         // retreive entity of this notification
1903         entity notif = Get_Notif_Ent(net_type, net_name);
1904         if (!notif)
1905         {
1906                 #ifdef NOTIFICATIONS_DEBUG
1907                 Debug_Notification(sprintf(
1908                         "Send_Notification(%s, '%s', %s, %d, ...);\n",
1909                         Get_Notif_BroadcastName(broadcast),
1910                         client.classname,
1911                         Get_Notif_TypeName(net_type),
1912                         net_name
1913                 ));
1914                 #endif
1915                 backtrace("Send_Notification: Could not find notification entity!\n");
1916                 return;
1917         }
1918
1919         string s1 = ((0 < notif.nent_stringcount) ? ...(0, string) : "");
1920         string s2 = ((1 < notif.nent_stringcount) ? ...(1, string) : "");
1921         string s3 = ((2 < notif.nent_stringcount) ? ...(2, string) : "");
1922         string s4 = ((3 < notif.nent_stringcount) ? ...(3, string) : "");
1923         float f1 = ((0 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 0), float) : 0);
1924         float f2 = ((1 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 1), float) : 0);
1925         float f3 = ((2 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 2), float) : 0);
1926         float f4 = ((3 < notif.nent_floatcount) ? ...((notif.nent_stringcount + 3), float) : 0);
1927
1928         #ifdef NOTIFICATIONS_DEBUG
1929         Debug_Notification(sprintf(
1930                 "Send_Notification(%s, %s, %s);\n",
1931                 sprintf(
1932                         "%s, '%s', %s, %s",
1933                         Get_Notif_BroadcastName(broadcast),
1934                         client.classname,
1935                         Get_Notif_TypeName(net_type),
1936                         notif.nent_name
1937                 ),
1938                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
1939                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
1940         ));
1941         #endif
1942
1943         if((notif.nent_stringcount + notif.nent_floatcount) > count)
1944         {
1945                 backtrace(sprintf(
1946                         strcat(
1947                                 "Not enough arguments for Send_Notification(%s, ...)! ",
1948                                 "stringcount(%d) + floatcount(%d) > count(%d)\n",
1949                                 "Check the definition and function call for accuracy...?\n"
1950                         ),
1951                         sprintf(
1952                                 #ifdef NOTIFICATIONS_DEBUG
1953                                 "%s, '%s', %s, %s",
1954                                 Get_Notif_BroadcastName(broadcast),
1955                                 #else
1956                                 "%d, '%s', %s, %s",
1957                                 broadcast,
1958                                 #endif
1959                                 client.classname,
1960                                 Get_Notif_TypeName(net_type),
1961                                 notif.nent_name
1962                         ),
1963                         notif.nent_stringcount,
1964                         notif.nent_floatcount,
1965                         count
1966                 ));
1967                 return;
1968         }
1969         else if((notif.nent_stringcount + notif.nent_floatcount) < count)
1970         {
1971                 backtrace(sprintf(
1972                         strcat(
1973                                 "Too many arguments for Send_Notification(%s, ...)! ",
1974                                 "stringcount(%d) + floatcount(%d) < count(%d)\n",
1975                                 "Check the definition and function call for accuracy...?\n"
1976                         ),
1977                         sprintf(
1978                                 #ifdef NOTIFICATIONS_DEBUG
1979                                 "%s, '%s', %s, %s",
1980                                 Get_Notif_BroadcastName(broadcast),
1981                                 #else
1982                                 "%d, '%s', %s, %s",
1983                                 broadcast,
1984                                 #endif
1985                                 client.classname,
1986                                 Get_Notif_TypeName(net_type),
1987                                 notif.nent_name
1988                         ),
1989                         notif.nent_stringcount,
1990                         notif.nent_floatcount,
1991                         count
1992                 ));
1993                 return;
1994         }
1995
1996         if(
1997                 server_is_dedicated
1998                 &&
1999                 (
2000                         broadcast == NOTIF_ALL
2001                         ||
2002                         broadcast == NOTIF_ALL_EXCEPT
2003                 )
2004                 &&
2005                 !(
2006                         net_type == MSG_ANNCE
2007                         ||
2008                         net_type == MSG_CENTER
2009                 )
2010         )
2011         {
2012                 Local_Notification_WOVA(
2013                         net_type, net_name,
2014                         notif.nent_stringcount,
2015                         notif.nent_floatcount,
2016                         s1, s2, s3, s4,
2017                         f1, f2, f3, f4);
2018         }
2019
2020         if(net_type == MSG_CHOICE)
2021         {
2022                 // THIS GETS TRICKY... now we have to cycle through each possible player (checking broadcast)
2023                 // and then do an individual NOTIF_ONE_ONLY recursive call for each one depending on their option...
2024                 // It's slow, but it's better than the alternatives:
2025                 //   1. Constantly networking all info and letting client decide
2026                 //   2. Manually handling each separate call on per-usage basis (See old CTF usage of verbose)
2027                 entity found_choice;
2028
2029                 #define RECURSE_FROM_CHOICE(ent,action) \
2030                         if(notif.nent_challow_var && (warmup_stage || (notif.nent_challow_var == 2))) \
2031                         { \
2032                                 switch(ent.msg_choice_choices[net_name]) \
2033                                 { \
2034                                         case 1: found_choice = notif.nent_optiona; break; \
2035                                         case 2: found_choice = notif.nent_optionb; break; \
2036                                         default: action; \
2037                                 } \
2038                         } \
2039                         else { found_choice = notif.nent_optiona; } \
2040                         Send_Notification_WOVA( \
2041                                 NOTIF_ONE_ONLY, \
2042                                 ent, \
2043                                 found_choice.nent_type, \
2044                                 found_choice.nent_id, \
2045                                 found_choice.nent_stringcount, \
2046                                 found_choice.nent_floatcount, \
2047                                 s1, s2, s3, s4, \
2048                                 f1, f2, f3, f4);
2049
2050                 switch(broadcast)
2051                 {
2052                         case NOTIF_ONE_ONLY: // we can potentially save processing power with this broadcast method
2053                         {
2054                                 if(IS_REAL_CLIENT(client))
2055                                         { RECURSE_FROM_CHOICE(client, return) }
2056                                 break;
2057                         }
2058                         default:
2059                         {
2060                                 entity to;
2061                                 FOR_EACH_REALCLIENT(to)
2062                                         { if(Notification_ShouldSend(broadcast, to, client))
2063                                                 { RECURSE_FROM_CHOICE(to, continue) } }
2064                                 break;
2065                         }
2066                 }
2067         }
2068         else
2069         {
2070                 entity net_notif = spawn();
2071                 net_notif.owner = notif;
2072                 net_notif.classname = "net_notification";
2073                 net_notif.nent_broadcast = broadcast;
2074                 net_notif.nent_client = client;
2075                 net_notif.nent_net_type = net_type;
2076                 net_notif.nent_net_name = net_name;
2077                 net_notif.nent_stringcount = notif.nent_stringcount;
2078                 net_notif.nent_floatcount = notif.nent_floatcount;
2079
2080                 float i;
2081                 for(i = 0; i < net_notif.nent_stringcount; ++i)
2082                         { net_notif.nent_strings[i] = strzone(...(i, string)); }
2083                 for(i = 0; i < net_notif.nent_floatcount; ++i)
2084                         { net_notif.nent_floats[i] = ...((net_notif.nent_stringcount + i), float); }
2085
2086                 net_notif.think = Net_Notification_Remove;
2087                 net_notif.nextthink =
2088                         ((time > autocvar_notification_lifetime_mapload)
2089                         ?
2090                                 (time + autocvar_notification_lifetime_runtime)
2091                                 :
2092                                 autocvar_notification_lifetime_mapload
2093                         );
2094
2095                 Net_LinkEntity(net_notif, FALSE, 0, Net_Write_Notification);
2096         }
2097 }
2098
2099 // WOVA = Without Variable Arguments
2100 void Send_Notification_WOVA(
2101         float broadcast, entity client,
2102         float net_type, float net_name,
2103         float stringcount, float floatcount,
2104         string s1, string s2, string s3, string s4,
2105         float f1, float f2, float f3, float f4)
2106 {
2107         #ifdef NOTIFICATIONS_DEBUG
2108         entity notif = Get_Notif_Ent(net_type, net_name);
2109         Debug_Notification(sprintf(
2110                 "Send_Notification_WOVA(%s, %d, %d, %s, %s);\n",
2111                 sprintf(
2112                         "%s, '%s', %s, %s",
2113                         Get_Notif_BroadcastName(broadcast),
2114                         client.classname,
2115                         Get_Notif_TypeName(net_type),
2116                         notif.nent_name
2117                 ),
2118                 stringcount,
2119                 floatcount,
2120                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
2121                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
2122         ));
2123         #endif
2124
2125         #define VARITEM(stringc,floatc,args) \
2126                 if((stringcount == stringc) && (floatcount == floatc)) \
2127                         { Send_Notification(broadcast, client, net_type, net_name, args); return; }
2128         EIGHT_VARS_TO_VARARGS_VARLIST
2129         #undef VARITEM
2130         Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
2131 }
2132
2133 // WOCOVA = Without Counts Or Variable Arguments
2134 void Send_Notification_WOCOVA(
2135         float broadcast, entity client,
2136         float net_type, float net_name,
2137         string s1, string s2, string s3, string s4,
2138         float f1, float f2, float f3, float f4)
2139 {
2140         entity notif = Get_Notif_Ent(net_type, net_name);
2141
2142         #ifdef NOTIFICATIONS_DEBUG
2143         Debug_Notification(sprintf(
2144                 "Send_Notification_WOCOVA(%s, %s, %s);\n",
2145                 sprintf(
2146                         "%s, '%s', %s, %s",
2147                         Get_Notif_BroadcastName(broadcast),
2148                         client.classname,
2149                         Get_Notif_TypeName(net_type),
2150                         notif.nent_name
2151                 ),
2152                 MakeConsoleSafe(sprintf("'%s^7', '%s^7', '%s^7', '%s^7'", s1, s2, s3, s4)),
2153                 sprintf("%d, %d, %d, %d", f1, f2, f3, f4)
2154         ));
2155         #endif
2156
2157         #define VARITEM(stringc,floatc,args) \
2158                 if((notif.nent_stringcount == stringc) && (notif.nent_floatcount == floatc)) \
2159                         { Send_Notification(broadcast, client, net_type, net_name, args); return; }
2160         EIGHT_VARS_TO_VARARGS_VARLIST
2161         #undef VARITEM
2162         Send_Notification(broadcast, client, net_type, net_name); // some notifications don't have any arguments at all
2163 }
2164 #endif // ifdef SVQC