1 // COMMIT-TODO: Update if necessary before committing
2 // Revision 1: additional statistics sent (flag caps, returns, deaths)
3 // Revision 2: Mapvote preview pictures
4 // Revision 3: optimized map vote protocol
5 // Revision 4: CSQC config var system
6 // Revision 5: mapvote time fix
7 // Revision 6: more robust against packet loss/delays, also show not yet connected clients
8 // Revision 7: packet loss column
10 // Revision 9: race delta
11 // Revision 10: scoreboard force
12 // Revision 11: scoreboard unforce; spectator support beginning
13 // Revision 12: smaller scores updates (SERVER: requires new engine)
14 // Revision 13: pointparticles
17 // Revision 16: multi-weapons
18 // Revision 17: multi-weaponimpulses
19 // Revision 18: warmup
21 // Revision 20: naggers
22 // Revision 21: entcs for players optimized (position data down from 12 to 7 bytes); waypointsprites in csqc for team radar
23 // Revision 22: hook shot origin
24 #define CSQC_REVISION 22
26 const float AS_STRING = 1;
27 const float AS_INT = 2;
28 const float AS_FLOAT_TRUNCATED = 2;
29 const float AS_FLOAT = 8;
31 const float TE_CSQC_PICTURE = 100;
32 const float TE_CSQC_RACE = 101;
33 const float TE_CSQC_SPAWN = 102;
34 const float TE_CSQC_ZCURVEPARTICLES = 103;
35 const float TE_CSQC_NEXGUNBEAMPARTICLE = 104;
36 const float TE_CSQC_LIGHTNINGARC = 105;
37 const float TE_CSQC_TEAMNAGGER = 106;
38 const float TE_CSQC_PINGPLREPORT = 107;
39 const float TE_CSQC_ANNOUNCE = 110;
40 const float TE_CSQC_TARGET_MUSIC = 111;
41 const float TE_CSQC_KILLNOTIFY = 112;
42 const float TE_CSQC_KILLCENTERPRINT = 113;
43 const float TE_CSQC_CENTERPRINT_GENERIC = 114;
44 const float TE_CSQC_WEAPONCOMPLAIN = 115;
45 const float TE_CSQC_NEX_SCOPE = 116;
46 const float TE_CSQC_MINELAYER_MAXMINES = 117;
47 const float TE_CSQC_HAGAR_MAXROCKETS = 118;
48 const float TE_CSQC_VEHICLESETUP = 119;
49 const float TE_CSQC_SVNOTICE = 120;
50 const float TE_CSQC_NOTIFICATION = 121;
52 const float RACE_NET_CHECKPOINT_HIT_QUALIFYING = 0; // byte checkpoint, short time, short recordtime, string recordholder
53 const float RACE_NET_CHECKPOINT_CLEAR = 1;
54 const float RACE_NET_CHECKPOINT_NEXT_QUALIFYING = 2; // byte nextcheckpoint, short recordtime, string recordholder
55 const float RACE_NET_CHECKPOINT_HIT_RACE = 3; // byte checkpoint, short delta, byte lapsdelta, string opponent
56 const float RACE_NET_CHECKPOINT_HIT_RACE_BY_OPPONENT = 4; // byte checkpoint, short delta, byte lapsdelta, string opponent
57 const float RACE_NET_CHECKPOINT_NEXT_SPEC_QUALIFYING = 5; // byte nextcheckpoint, float laptime, short recordtime, string recordholder
58 const float RACE_NET_PENALTY_RACE = 6; // byte penaltytime, string reason
59 const float RACE_NET_PENALTY_QUALIFYING = 7; // byte penaltytime, string reason
60 const float RACE_NET_SERVER_RECORD = 8; // server record, sent to client
61 const float RACE_NET_SPEED_AWARD = 9; // speed award, sent to client
62 const float RACE_NET_SPEED_AWARD_BEST = 10; // all time best speed award, sent to client
63 const float RACE_NET_SERVER_RANKINGS = 11;
64 const float RACE_NET_SERVER_STATUS = 12;
65 const float RANKINGS_CNT = 15;
67 const float ENT_CLIENT = 0;
68 const float ENT_CLIENT_DEAD = 1;
69 const float ENT_CLIENT_ENTCS = 2;
70 const float ENT_CLIENT_SCORES_INFO = 3;
71 const float ENT_CLIENT_SCORES = 4;
72 const float ENT_CLIENT_TEAMSCORES = 5;
73 const float ENT_CLIENT_POINTPARTICLES = 6;
74 const float ENT_CLIENT_RAINSNOW = 7;
75 const float ENT_CLIENT_LASER = 8;
76 const float ENT_CLIENT_NAGGER = 9; // flags [votecalledvote]
77 const float ENT_CLIENT_WAYPOINT = 10; // flags origin [team displayrule] [spritename] [spritename2] [spritename3] [lifetime maxdistance hideable]
78 const float ENT_CLIENT_RADARLINK = 11; // flags [startorigin] [endorigin] [startcolor+16*endcolor]
79 const float ENT_CLIENT_PROJECTILE = 12;
80 const float ENT_CLIENT_GIBSPLASH = 13;
81 const float ENT_CLIENT_DAMAGEINFO = 14;
82 const float ENT_CLIENT_CASING = 15;
83 const float ENT_CLIENT_INIT = 16;
84 const float ENT_CLIENT_MAPVOTE = 17;
85 const float ENT_CLIENT_CLIENTDATA = 18;
86 const float ENT_CLIENT_RANDOMSEED = 19;
87 const float ENT_CLIENT_WALL = 20;
88 const float ENT_CLIENT_SPIDERBOT = 21;
89 const float ENT_CLIENT_MODELEFFECT = 22;
90 const float ENT_CLIENT_TUBANOTE = 23;
91 const float ENT_CLIENT_WARPZONE = 24;
92 const float ENT_CLIENT_WARPZONE_CAMERA = 25;
93 const float ENT_CLIENT_TRIGGER_MUSIC = 26;
94 const float ENT_CLIENT_HOOK = 27;
95 const float ENT_CLIENT_LGBEAM = 28;
96 const float ENT_CLIENT_GAUNTLET = 29;
97 const float ENT_CLIENT_ACCURACY = 30;
98 const float ENT_CLIENT_SHOWNAMES = 31;
99 const float ENT_CLIENT_WARPZONE_TELEPORTED = 32;
100 const float ENT_CLIENT_MODEL = 33;
101 const float ENT_CLIENT_ITEM = 34;
102 const float ENT_CLIENT_BUMBLE_RAYGUN = 35;
104 const float ENT_CLIENT_TURRET = 40;
105 const float ENT_CLIENT_AUXILIARYXHAIR = 50;
106 const float ENT_CLIENT_VEHICLE = 60;
108 const float SPRITERULE_DEFAULT = 0;
109 const float SPRITERULE_TEAMPLAY = 1;
111 const float RADARICON_NONE = 0;
112 const float RADARICON_FLAG = 1;
113 const float RADARICON_FLAGCARRIER = 1;
114 const float RADARICON_HERE = 1; // TODO make these 3 and 4, and make images for them
115 const float RADARICON_DANGER = 1;
116 const float RADARICON_WAYPOINT = 1;
117 const float RADARICON_HELPME = 1;
118 const float RADARICON_CONTROLPOINT = 1;
119 const float RADARICON_GENERATOR = 1;
120 const float RADARICON_OBJECTIVE = 1;
121 const float RADARICON_DOMPOINT = 1;
122 const float RADARICON_POWERUP = 1;
123 const float RADARICON_TAGGED = 1;
125 ///////////////////////////
127 const float KEY_FORWARD = 1;
128 const float KEY_BACKWARD = 2;
129 const float KEY_LEFT = 4;
130 const float KEY_RIGHT = 8;
131 const float KEY_JUMP = 16;
132 const float KEY_CROUCH = 32;
133 const float KEY_ATCK = 64;
134 const float KEY_ATCK2 = 128;
136 ///////////////////////////
140 float CVAR_NOTIFY = 2;
141 float CVAR_READONLY = 4;
143 ///////////////////////////
144 // csqc communication stuff
146 const float STAT_KH_KEYS = 32;
147 const float STAT_CTF_STATE = 33;
148 const float STAT_WEAPONS = 35;
149 const float STAT_SWITCHWEAPON = 36;
150 const float STAT_GAMESTARTTIME = 37;
151 const float STAT_STRENGTH_FINISHED = 38;
152 const float STAT_INVINCIBLE_FINISHED = 39;
153 const float STAT_PRESSED_KEYS = 42;
154 const float STAT_ALLOW_OLDNEXBEAM = 43; // this stat could later contain some other bits of info, like, more server-side particle config
155 const float STAT_FUEL = 44;
156 const float STAT_NB_METERSTART = 45;
157 const float STAT_SHOTORG = 46; // compressShotOrigin
158 const float STAT_LEADLIMIT = 47;
159 const float STAT_WEAPON_CLIPLOAD = 48;
160 const float STAT_WEAPON_CLIPSIZE = 49;
161 const float STAT_NEX_CHARGE = 50;
162 const float STAT_LAST_PICKUP = 51;
163 const float STAT_HUD = 52;
164 const float STAT_NEX_CHARGEPOOL = 53;
165 const float STAT_HIT_TIME = 54;
166 const float STAT_TYPEHIT_TIME = 55;
167 const float STAT_LAYED_MINES = 56;
168 const float STAT_HAGAR_LOAD = 57;
169 const float STAT_SWITCHINGWEAPON = 58;
170 const float STAT_SUPERWEAPONS_FINISHED = 59;
172 const float STAT_VEHICLESTAT_HEALTH = 60;
173 const float STAT_VEHICLESTAT_SHIELD = 61;
174 const float STAT_VEHICLESTAT_ENERGY = 62;
175 const float STAT_VEHICLESTAT_AMMO1 = 63;
176 const float STAT_VEHICLESTAT_RELOAD1 = 64;
177 const float STAT_VEHICLESTAT_AMMO2 = 65;
178 const float STAT_VEHICLESTAT_RELOAD2 = 66;
180 const float STAT_SECRETS_TOTAL = 70;
181 const float STAT_SECRETS_FOUND = 71;
183 const float STAT_RESPAWN_TIME = 72;
186 const float STAT_REDALIVE = 100;
187 const float STAT_BLUEALIVE = 101;
188 const float STAT_YELLOWALIVE = 102;
189 const float STAT_PINKALIVE = 103;
192 const float STAT_FROZEN = 104;
193 const float STAT_REVIVE_PROGRESS = 105;
196 const float STAT_DOM_TOTAL_PPS = 100;
197 const float STAT_DOM_PPS_RED = 101;
198 const float STAT_DOM_PPS_BLUE = 102;
199 const float STAT_DOM_PPS_PINK = 103;
200 const float STAT_DOM_PPS_YELLOW = 104;
202 //const float STAT_SPIDERBOT_AIM 53 // compressShotOrigin
203 //const float STAT_SPIDERBOT_TARGET 54 // compressShotOrigin
205 // see DP source, quakedef.h
206 const float STAT_MOVEVARS_AIRSPEEDLIMIT_NONQW = 222;
207 const float STAT_MOVEVARS_AIRSTRAFEACCEL_QW = 223;
208 const float STAT_MOVEVARS_MAXSPEED = 244;
209 const float STAT_MOVEVARS_AIRACCEL_QW = 254;
211 const float CTF_STATE_ATTACK = 1;
212 const float CTF_STATE_DEFEND = 2;
213 const float CTF_STATE_COMMANDER = 3;
215 const float HUD_NORMAL = 0;
216 const float HUD_VEHICLE_FIRST = 10;
217 const float HUD_SPIDERBOT = 10;
218 const float HUD_WAKIZASHI = 11;
219 const float HUD_RAPTOR = 12;
220 const float HUD_BUMBLEBEE = 13;
221 const float HUD_BUMBLEBEE_GUN = 14;
222 const float HUD_VEHICLE_LAST = 14;
224 const vector eX = '1 0 0';
225 const vector eY = '0 1 0';
226 const vector eZ = '0 0 1';
228 // moved that here so the client knows the max.
229 // # of maps, I'll use arrays for them :P
230 #define MAPVOTE_COUNT 10
233 * Lower scores are better (e.g. suicides)
235 #define SFL_LOWER_IS_BETTER 1
238 * Don't show zero values as scores
240 #define SFL_HIDE_ZERO 2
243 * Allow a column to be hidden (do not automatically add it even if it is a sorting key)
245 #define SFL_ALLOW_HIDE 16
248 * Display as a rank (with st, nd, rd, th suffix)
253 * Display as mm:ss.s, value is stored as 10ths of a second (AND 0 is the worst possible value!)
257 // not an extra constant yet
258 #define SFL_ZERO_IS_WORST SFL_TIME
261 * Scoring priority (NOTE: PRIMARY is used for fraglimit)
263 #define SFL_SORT_PRIO_SECONDARY 4
264 #define SFL_SORT_PRIO_PRIMARY 8
265 #define SFL_SORT_PRIO_MASK 12
271 #define MAX_TEAMSCORE 2
276 #define SP_SUICIDES 2
278 // game mode specific indices are not in common/, but in server/scores_rules.qc!
280 #ifdef COMPAT_XON010_CHANNELS
281 float CH_INFO = 0; // only on world and csqc
282 float CH_TRIGGER = 0; // only on players; compat: FALSELY CONTROLLED BY "Info"
283 float CH_WEAPON_A = 1; // only on players and entities
284 float CH_WEAPON_SINGLE = 5; // only on players and entities
285 float CH_VOICE = 2; // only on players
286 float CH_BGM_SINGLE = 2; // only on csqc; compat: FALSELY CONTROLLED BY "Voice"
287 float CH_AMBIENT = 2; // only on csqc; compat: FALSELY CONTROLLED BY "Voice"
288 float CH_TRIGGER_SINGLE = 3; // only on players, entities, csqc
289 float CH_SHOTS = 4; // only on players, entities, csqc
290 float CH_SHOTS_SINGLE = 4; // only on players, entities, csqc
291 float CH_WEAPON_B = 5; // only on players and entities
292 float CH_PAIN = 6; // only on players and csqc
293 float CH_PAIN_SINGLE = 6; // only on players and csqc
294 float CH_PLAYER = 7; // only on players and entities
295 float CH_TUBA = 5; // only on csqc
298 float CH_TRIGGER = -3;
299 float CH_WEAPON_A = -1;
300 float CH_WEAPON_SINGLE = 1;
302 float CH_BGM_SINGLE = 8;
303 float CH_AMBIENT = -9;
304 float CH_TRIGGER_SINGLE = 3;
306 float CH_SHOTS_SINGLE = 4;
307 float CH_WEAPON_B = -1;
309 float CH_PAIN_SINGLE = 6;
310 float CH_PLAYER = -7;
315 float ATTN_MIN = 0.015625;
316 float ATTN_NORM = 0.5;
317 float ATTN_LARGE = 1;
319 float ATTN_STATIC = 3;
320 float ATTN_MAX = 3.984375;
323 #define VOL_BASEVOICE 1.0
325 // this sets sounds and other properties of the projectiles in csqc
326 float PROJECTILE_ELECTRO = 1;
327 float PROJECTILE_ROCKET = 2;
328 float PROJECTILE_TAG = 3;
329 float PROJECTILE_BULLET = 4;
330 float PROJECTILE_CRYLINK = 5;
331 float PROJECTILE_ELECTRO_BEAM = 6;
332 float PROJECTILE_GRENADE = 7;
333 float PROJECTILE_GRENADE_BOUNCING = 8;
334 float PROJECTILE_MINE = 9;
335 float PROJECTILE_LASER = 10;
336 float PROJECTILE_HLAC = 11;
337 float PROJECTILE_SEEKER = 12;
338 float PROJECTILE_FLAC = 13;
339 float PROJECTILE_PORTO_RED = 14;
340 float PROJECTILE_PORTO_BLUE = 15;
341 float PROJECTILE_HOOKBOMB = 16;
342 float PROJECTILE_HAGAR = 17;
343 float PROJECTILE_HAGAR_BOUNCING = 18;
344 float PROJECTILE_BULLET_GLOWING = 19;
345 float PROJECTILE_CRYLINK_BOUNCING = 20;
346 float PROJECTILE_FIREBALL = 21;
347 float PROJECTILE_FIREMINE = 22;
348 float PROJECTILE_BULLET_GLOWING_TRACER = 23;
350 float PROJECTILE_RAPTORCANNON = 24;
351 float PROJECTILE_RAPTORBOMB = 25;
352 float PROJECTILE_RAPTORBOMBLET = 26;
353 float PROJECTILE_SPIDERROCKET = 27;
354 float PROJECTILE_WAKIROCKET = 28;
355 float PROJECTILE_WAKICANNON = 29;
357 float PROJECTILE_BUMBLE_GUN = 30;
358 float PROJECTILE_BUMBLE_BEAM = 31;
360 float SPECIES_HUMAN = 0;
361 float SPECIES_ROBOT_SOLID = 1;
362 float SPECIES_ALIEN = 2;
363 float SPECIES_ANIMAL = 3;
364 float SPECIES_ROBOT_RUSTY = 4;
365 float SPECIES_ROBOT_SHINY = 5;
366 float SPECIES_RESERVED = 15;
368 #define FRAGS_PLAYER 0
369 #define FRAGS_SPECTATOR -666
370 #define FRAGS_LMS_LOSER -616
371 #define FRAGS_PLAYER_NONSOLID -616
372 // we can use this frags value for both
375 float WATERLEVEL_NONE = 0;
376 float WATERLEVEL_WETFEET = 1;
377 float WATERLEVEL_SWIMMING = 2;
378 float WATERLEVEL_SUBMERGED = 3;
380 float MAX_SHOT_DISTANCE = 32768;
382 //centerprint ID list
383 float CPID_TEAMCHANGE = 1;
384 float CPID_CTF_CAPTURESHIELD = 2;
385 float CPID_MINSTA_FINDAMMO = 3;
386 float CPID_NIX_WPNCHANGE = 4;
387 float CPID_DISCONNECT_IDLING = 5;
388 float CPID_ROUND_STARTING = 6;
389 float CPID_GAME_STARTING = 7;
390 float CPID_TIMEOUT_COUNTDOWN = 8;
392 float CPID_KH_MSG = 10;
393 float CPID_PREVENT_JOIN = 11;
396 float WR_SETUP = 1; // (SVQC) setup weapon data
397 float WR_THINK = 2; // (SVQC) logic to run every frame
398 float WR_CHECKAMMO1 = 3; // (SVQC) checks ammo for weapon
399 float WR_CHECKAMMO2 = 4; // (SVQC) checks ammo for weapon
400 float WR_AIM = 5; // (SVQC) runs bot aiming code for this weapon
401 float WR_PRECACHE = 6; // (CSQC and SVQC) precaches models/sounds used by this weapon
402 float WR_SUICIDEMESSAGE = 7; // (CSQC) sets w_deathtypestring or leaves it alone (and may inspect w_deathtype for details)
403 float WR_KILLMESSAGE = 8; // (CSQC) sets w_deathtypestring or leaves it alone
404 float WR_RELOAD = 9; // (SVQC) does not need to do anything
405 float WR_RESETPLAYER = 10; // (SVQC) does not need to do anything
406 float WR_IMPACTEFFECT = 11; // (CSQC) impact effect
407 float WR_SWITCHABLE = 12; // (CSQC) impact effect
408 float WR_PLAYERDEATH = 13; // (SVQC) does not need to do anything
409 float WR_GONETHINK = 14; // (SVQC) logic to run every frame, also if no longer having the weapon as long as the switch away has not been performed
411 float HUD_PANEL_WEAPONS = 0;
412 float HUD_PANEL_AMMO = 1;
413 float HUD_PANEL_POWERUPS = 2;
414 float HUD_PANEL_HEALTHARMOR = 3;
415 float HUD_PANEL_NOTIFY = 4;
416 float HUD_PANEL_TIMER = 5;
417 float HUD_PANEL_RADAR = 6;
418 float HUD_PANEL_SCORE = 7;
419 float HUD_PANEL_RACETIMER = 8;
420 float HUD_PANEL_VOTE = 9;
421 float HUD_PANEL_MODICONS = 10;
422 float HUD_PANEL_PRESSEDKEYS = 11;
423 float HUD_PANEL_CHAT = 12;
424 float HUD_PANEL_ENGINEINFO = 13;
425 float HUD_PANEL_INFOMESSAGES = 14;
426 float HUD_PANEL_PHYSICS = 15;
427 float HUD_PANEL_CENTERPRINT = 16;
428 float HUD_PANEL_NUM = 17; // always last panel id + 1, please increment when adding a new panel
430 string HUD_PANELNAME_WEAPONS = "weapons";
431 string HUD_PANELNAME_AMMO = "ammo";
432 string HUD_PANELNAME_POWERUPS = "powerups";
433 string HUD_PANELNAME_HEALTHARMOR = "healtharmor";
434 string HUD_PANELNAME_NOTIFY = "notify";
435 string HUD_PANELNAME_TIMER = "timer";
436 string HUD_PANELNAME_RADAR = "radar";
437 string HUD_PANELNAME_SCORE = "score";
438 string HUD_PANELNAME_RACETIMER = "racetimer";
439 string HUD_PANELNAME_VOTE = "vote";
440 string HUD_PANELNAME_MODICONS = "modicons";
441 string HUD_PANELNAME_PRESSEDKEYS = "pressedkeys";
442 string HUD_PANELNAME_CHAT = "chat";
443 string HUD_PANELNAME_ENGINEINFO = "engineinfo";
444 string HUD_PANELNAME_INFOMESSAGES = "infomessages";
445 string HUD_PANELNAME_PHYSICS = "physics";
446 string HUD_PANELNAME_CENTERPRINT = "centerprint";
448 #define SERVERFLAG_ALLOW_FULLBRIGHT 1
449 #define SERVERFLAG_TEAMPLAY 2
450 #define SERVERFLAG_PLAYERSTATS 4
452 // FIXME/EXPLAINME: why?
453 noref var vector autocvar_sv_player_maxs = '16 16 45';
454 noref var vector autocvar_sv_player_mins = '-16 -16 -24';
455 noref var vector autocvar_sv_player_viewoffset = '0 0 20';
456 noref var vector autocvar_sv_player_crouch_maxs = '16 16 25';
457 noref var vector autocvar_sv_player_crouch_mins = '-16 -16 -24';
458 noref var vector autocvar_sv_player_crouch_viewoffset = '0 0 20';
459 noref var vector autocvar_sv_player_headsize = '24 24 12';
461 #define PL_VIEW_OFS autocvar_sv_player_viewoffset
462 #define PL_MIN autocvar_sv_player_mins
463 #define PL_MAX autocvar_sv_player_maxs
464 #define PL_CROUCH_VIEW_OFS autocvar_sv_player_crouch_viewoffset
465 #define PL_CROUCH_MIN autocvar_sv_player_crouch_mins
466 #define PL_CROUCH_MAX autocvar_sv_player_crouch_maxs
467 #define PL_HEAD autocvar_sv_player_headsize
470 #define PL_VIEW_OFS_z autocvar_sv_player_viewoffset_z
471 #define PL_MIN_z autocvar_sv_player_mins_z
472 #define PL_MAX_z autocvar_sv_player_maxs_z
473 #define PL_CROUCH_VIEW_OFS_z autocvar_sv_player_crouch_viewoffset_z
474 #define PL_CROUCH_MIN_z autocvar_sv_player_mins_z
475 #define PL_HEAD_x autocvar_sv_player_headsize_x
476 #define PL_HEAD_y autocvar_sv_player_headsize_y
477 #define PL_HEAD_z autocvar_sv_player_headsize_z
480 #define SPAWN_PRIO_NEAR_TEAMMATE_FOUND 200
481 #define SPAWN_PRIO_NEAR_TEAMMATE_SAMETEAM 100
482 #define SPAWN_PRIO_RACE_PREVIOUS_SPAWN 50
483 #define SPAWN_PRIO_GOOD_DISTANCE 10
486 #define URI_GET_DISCARD 0
487 #define URI_GET_IPBAN 1
488 #define URI_GET_IPBAN_END 16
489 #define URI_GET_CURL 17
490 #define URI_GET_CURL_END 32
491 #define URI_GET_UPDATENOTIFICATION 33
492 #define URI_GET_URLLIB 128
493 #define URI_GET_URLLIB_END 191