[NOT FOR 2.5.2] better gibs for robots (yes, by you-know-who)
[divverent/nexuiz.git] / data / qcsrc / common / constants.qh
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
9 // Revision 8: race
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
15 // Revision 14: laser
16 // Revision 15: zoom
17 // Revision 16: multi-weapons
18 // Revision 17: multi-weaponimpulses
19 // Revision 18: warmup
20 // Revision 19: fog
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
25
26 // probably put these in common/
27 // so server/ and client/ can be synced better
28 const float GAME_DEATHMATCH             = 1;
29 const float GAME_TEAM_DEATHMATCH        = 2;
30 const float GAME_DOMINATION             = 3;
31 const float GAME_CTF                    = 4;
32 const float GAME_RUNEMATCH              = 5;
33 const float GAME_LMS                    = 6;
34 const float GAME_ARENA          = 7;
35 const float GAME_KEYHUNT                = 8;
36 const float GAME_ASSAULT                = 9;
37 const float GAME_ONSLAUGHT      = 10;
38 const float GAME_RACE   = 11;
39 const float GAME_NEXBALL = 12;
40 const float GAME_CTS = 13;
41
42 const float AS_STRING           = 1;
43 const float AS_INT              = 2;
44 const float AS_FLOAT_TRUNCATED  = 2;
45 const float AS_FLOAT            = 8;
46
47 const float TE_CSQC_PICTURE = 100;
48 const float TE_CSQC_RACE = 101;
49 const float TE_CSQC_SPAWN = 102;
50 const float TE_CSQC_ZCURVEPARTICLES = 103;
51 const float TE_CSQC_NEXGUNBEAMPARTICLE = 104;
52 const float TE_CSQC_LIGHTNINGARC = 105;
53
54 const float RACE_NET_CHECKPOINT_HIT_QUALIFYING = 0; // byte checkpoint, short time, short recordtime, string recordholder
55 const float RACE_NET_CHECKPOINT_CLEAR = 1;
56 const float RACE_NET_CHECKPOINT_NEXT_QUALIFYING = 2; // byte nextcheckpoint, short recordtime, string recordholder
57 const float RACE_NET_CHECKPOINT_HIT_RACE = 3; // byte checkpoint, short delta, byte lapsdelta, string opponent
58 const float RACE_NET_CHECKPOINT_HIT_RACE_BY_OPPONENT = 4; // byte checkpoint, short delta, byte lapsdelta, string opponent
59 const float RACE_NET_CHECKPOINT_NEXT_SPEC_QUALIFYING = 5; // byte nextcheckpoint, float laptime, short recordtime, string recordholder
60 const float RACE_NET_PENALTY_RACE = 6; // byte penaltytime, string reason
61 const float RACE_NET_PENALTY_QUALIFYING = 7; // byte penaltytime, string reason
62
63 const float ENT_CLIENT = 0;
64 const float ENT_CLIENT_DEAD = 1;
65 const float ENT_CLIENT_ENTCS = 2;
66 const float ENT_CLIENT_SCORES_INFO = 3;
67 const float ENT_CLIENT_SCORES = 4;
68 const float ENT_CLIENT_TEAMSCORES = 5;
69 const float ENT_CLIENT_POINTPARTICLES = 6;
70 const float ENT_CLIENT_RAINSNOW = 7;
71 const float ENT_CLIENT_LASER = 8;
72 const float ENT_CLIENT_NAGGER = 9; // flags [votecalledvote]
73 const float ENT_CLIENT_WAYPOINT = 10; // flags origin [team displayrule] [spritename] [spritename2] [spritename3] [lifetime maxdistance hideable]
74 const float ENT_CLIENT_RADARLINK = 11; // flags [startorigin] [endorigin] [startcolor+16*endcolor]
75 const float ENT_CLIENT_PROJECTILE = 12;
76 const float ENT_CLIENT_GIBSPLASH = 13;
77 const float ENT_CLIENT_DAMAGEINFO = 14;
78 const float ENT_CLIENT_CASING = 15;
79 const float ENT_CLIENT_INIT = 16;
80 const float ENT_CLIENT_MAPVOTE = 17;
81 const float ENT_CLIENT_CLIENTDATA = 18;
82 const float ENT_CLIENT_RANDOMSEED = 19;
83 const float ENT_CLIENT_WALL = 20;
84 const float ENT_CLIENT_SPIDERBOT = 21;
85 const float ENT_CLIENT_MODELEFFECT = 22;
86
87 const float ENT_CLIENT_TURRET = 40;
88
89 const float SPRITERULE_DEFAULT = 0;
90 const float SPRITERULE_TEAMPLAY = 1;
91
92 const float RADARICON_FLAG = 1;
93 const float RADARICON_FLAGCARRIER = 1;
94 const float RADARICON_HERE = 1; // TODO make these 3 and 4, and make images for them
95 const float RADARICON_DANGER = 1;
96 const float RADARICON_WAYPOINT = 1;
97 const float RADARICON_HELPME = 1;
98 const float RADARICON_CONTROLPOINT = 1;
99 const float RADARICON_GENERATOR = 1;
100 const float RADARICON_OBJECTIVE = 1;
101 const float RADARICON_DOMPOINT = 1;
102 const float RADARICON_POWERUP = 1;
103
104 ///////////////////////////
105 // key constants
106
107 //
108 // these are the key numbers that should be passed to Key_Event
109 //
110 const float K_TAB                       =       9;
111 const float K_ENTER             =       13;
112 const float K_ESCAPE            =       27;
113 const float K_SPACE             =       32;
114
115 // normal keys should be passed as lowercased ascii
116
117 const float K_BACKSPACE =       127;
118 const float K_UPARROW           =       128;
119 const float K_DOWNARROW =       129;
120 const float K_LEFTARROW =       130;
121 const float K_RIGHTARROW        =       131;
122
123 const float K_ALT               =       132;
124 const float K_CTRL      =       133;
125 const float K_SHIFT     =       134;
126 const float K_F1                =       135;
127 const float K_F2                =       136;
128 const float K_F3                =       137;
129 const float K_F4                =       138;
130 const float K_F5                =       139;
131 const float K_F6                =       140;
132 const float K_F7                =       141;
133 const float K_F8                =       142;
134 const float K_F9                =       143;
135 const float K_F10               =       144;
136 const float K_F11               =       145;
137 const float K_F12               =       146;
138 const float K_INS               =       147;
139 const float K_DEL               =       148;
140 const float K_PGDN      =       149;
141 const float K_PGUP      =       150;
142 const float K_HOME      =       151;
143 const float K_END               =       152;
144
145 const float K_KP_HOME                   =       160;
146 const float K_KP_UPARROW                =       161;
147 const float K_KP_PGUP                   =       162;
148 const float K_KP_LEFTARROW      =       163;
149 const float K_KP_5                      =       164;
150 const float K_KP_RIGHTARROW     =       165;
151 const float K_KP_END                    =       166;
152 const float K_KP_DOWNARROW      =       167;
153 const float K_KP_PGDN                   =       168;
154 const float K_KP_ENTER          =       169;
155 const float K_KP_INS            =       170;
156 const float K_KP_DEL                    =       171;
157 const float K_KP_SLASH          =       172;
158 const float K_KP_MINUS          =       173;
159 const float K_KP_PLUS                   =       174;
160
161 const float K_PAUSE             =       255;
162
163 //
164 // joystick buttons
165 //
166 const float K_JOY1              =       768;
167 const float K_JOY2              =       769;
168 const float K_JOY3              =       770;
169 const float K_JOY4              =       771;
170
171 //
172 // aux keys are for multi-buttoned joysticks to generate so they can use
173 // the normal binding process
174 //
175 const float K_AUX1              =       772;
176 const float K_AUX2              =       773;
177 const float K_AUX3              =       774;
178 const float K_AUX4              =       775;
179 const float K_AUX5              =       776;
180 const float K_AUX6              =       777;
181 const float K_AUX7              =       778;
182 const float K_AUX8              =       779;
183 const float K_AUX9              =       780;
184 const float K_AUX10             =       781;
185 const float K_AUX11             =       782;
186 const float K_AUX12             =       783;
187 const float K_AUX13             =       784;
188 const float K_AUX14             =       785;
189 const float K_AUX15             =       786;
190 const float K_AUX16             =       787;
191 const float K_AUX17             =       788;
192 const float K_AUX18             =       789;
193 const float K_AUX19             =       790;
194 const float K_AUX20             =       791;
195 const float K_AUX21             =       792;
196 const float K_AUX22             =       793;
197 const float K_AUX23             =       794;
198 const float K_AUX24             =       795;
199 const float K_AUX25             =       796;
200 const float K_AUX26             =       797;
201 const float K_AUX27             =       798;
202 const float K_AUX28             =       799;
203 const float K_AUX29             =       800;
204 const float K_AUX30             =       801;
205 const float K_AUX31             =       802;
206 const float K_AUX32             =       803;
207
208 //
209 // mouse buttons generate virtual keys
210 //
211 const float K_MOUSE1            =       512;
212 const float K_MOUSE2            =       513;
213 const float K_MOUSE3            =       514;
214 const float K_MWHEELUP  =       515;
215 const float K_MWHEELDOWN        =       516;
216 const float K_MOUSE4            =       517;
217 const float K_MOUSE5            =       518;
218 const float K_MOUSE6            =       519;
219 const float K_MOUSE7            =       520;
220 const float K_MOUSE8            =       521;
221 const float K_MOUSE9            =       522;
222 const float K_MOUSE10           =       523;
223 const float K_MOUSE11           =       524;
224 const float K_MOUSE12           =       525;
225 const float K_MOUSE13           =       526;
226 const float K_MOUSE14           =       527;
227 const float K_MOUSE15           =       528;
228 const float K_MOUSE16           =       529;
229
230 ///////////////////////////
231 // keys pressed
232 const float KEY_FORWARD         =       1;
233 const float KEY_BACKWARD        =       2;
234 const float KEY_LEFT            =       4;
235 const float KEY_RIGHT           =       8;
236 const float KEY_JUMP            =       16;
237 const float KEY_CROUCH          =       32;
238
239 ///////////////////////////
240 // cvar constants
241
242 float CVAR_SAVE         = 1;
243 float CVAR_NOTIFY       = 2;
244 float CVAR_READONLY     = 4;
245
246 ///////////////////////////
247 // csqc communication stuff
248
249 const float STAT_KH_KEYS = 32;
250 const float STAT_CTF_STATE = 33;
251 const float STAT_WEAPONS = 35;
252 const float STAT_SWITCHWEAPON = 36;
253 const float STAT_GAMESTARTTIME = 37;
254 const float STAT_STRENGTH_FINISHED = 38;
255 const float STAT_INVINCIBLE_FINISHED = 39;
256 const float STAT_DAMAGE_HITS = 40; // Used by the weapon stats code, represents the total amount of damage done to other players
257 const float STAT_DAMAGE_FIRED = 41;// Used by the weapon stats code, represents the total amount of potential damage fired
258 const float STAT_PRESSED_KEYS = 42;
259 const float STAT_ALLOW_OLDNEXBEAM = 43; // this stat could later contain some other bits of info, like, more server-side particle config
260 const float STAT_FUEL = 44;
261 const float STAT_NB_METERSTART = 45;
262 const float STAT_SHOTORG = 46; // compressShotOrigin
263 const float STAT_LEADLIMIT = 47;
264 const float STAT_BULLETS_LOADED = 48;
265 const float CTF_STATE_ATTACK = 1;
266 const float CTF_STATE_DEFEND = 2;
267 const float CTF_STATE_COMMANDER = 3;
268
269 const float STAT_HUD = 50;
270 const float HUD_NORMAL = 0;
271 const float HUD_SPIDERBOT = 10;
272
273 const float STAT_SPIDERBOT_HEALTH  = 60;
274 const float STAT_SPIDERBOT_ROCKETS = 61;
275 const float STAT_SPIDERBOT_HEAT    = 62;
276 const float STAT_SPIDERBOT_RELOAD  = 63;
277 const float STAT_SPIDERBOT_ENERGY  = 64;
278 const float STAT_SPIDERBOT_SHIELD  = 65;
279
280 //const float STAT_SPIDERBOT_AIM     53 // compressShotOrigin
281
282 //const float STAT_SPIDERBOT_TARGET  54 // compressShotOrigin
283
284
285
286
287 // moved that here so the client knows the max.
288 // # of maps, I'll use arrays for them :P
289 #define MAPVOTE_COUNT 10
290
291 /**
292  * Lower scores are better (e.g. suicides)
293  */
294 #define SFL_LOWER_IS_BETTER     1
295
296 /**
297  * Don't show zero values as scores
298  */
299 #define SFL_HIDE_ZERO           2
300
301 /**
302  * Allow a column to be hidden (do not automatically add it even if it is a sorting key)
303  */
304 #define SFL_ALLOW_HIDE         16
305
306 /**
307  * Display as a rank (with st, nd, rd, th suffix)
308  */
309 #define SFL_RANK               32
310
311 /**
312  * Display as mm:ss.s, value is stored as 10ths of a second (AND 0 is the worst possible value!)
313  */
314 #define SFL_TIME               64
315
316 // not an extra constant yet
317 #define SFL_ZERO_IS_WORST SFL_TIME
318
319 /**
320  * Scoring priority (NOTE: PRIMARY is used for fraglimit)
321  */
322 #define SFL_SORT_PRIO_SECONDARY 4
323 #define SFL_SORT_PRIO_PRIMARY   8
324 #define SFL_SORT_PRIO_MASK     12
325
326 /**
327  * Score indices
328  */
329 #define MAX_SCORE 10
330 #define MAX_TEAMSCORE 2
331
332 #define ST_SCORE 0
333 #define SP_KILLS 0
334 #define SP_DEATHS 1
335 #define SP_SUICIDES 2
336 #define SP_SCORE 3
337 // game mode specific indices are not in common/, but in server/scores_rules.qc!
338
339 // this assignment must match menu/nexuiz/dialog_settings_misc.c!
340 float   CHAN_AUTO                               = 0;
341         // on world: announcers, ...                     INFO
342         // on players: item pickup                       ITEMS
343         // on entities: UNUSED
344         // on csqc: UNUSED
345 float   CHAN_WEAPON                             = 1; // Weapon fire
346         // on world: UNUSED
347         // on players: weapon firing                     WEAPONS
348         // on entities: turret firing                    WEAPONS
349         // on csqc: UNUSED
350 float   CHAN_VOICE                              = 2; // Voice/Radio
351         // on world: UNUSED
352         // on players: voice                             VOICE
353         // on entities: ambient                          AMBIENT
354         // on csqc: UNUSED
355 float   CHAN_TRIGGER                    = 3; // Triggers/Items
356         // on world: UNUSED
357         // on players: item pickup                       ITEMS
358         // on entities: platforms moving etc.            ITEMS
359         // on csqc: UNUSED
360 float   CHAN_PROJECTILE                 = 4; // Projectiles
361         // on world: UNUSED
362         // on players: projectiles hitting player        SHOTS
363         // on entities: projectiles                      SHOTS
364         // on csqc: projectile sounds                    SHOTS
365 float   CHAN_WEAPON2                    = 5; // Nex fire (separated as it is a very long sound)
366         // on world: UNUSED
367         // on players: weapon firing                     WEAPONS
368         // on entities: turret firing                    WEAPONS
369         // on csqc: UNUSED
370 float   CHAN_PAIN                               = 6; // Pain
371         // on world: UNUSED
372         // on players: pain                              PAIN
373         // on entities: projectiles flying               SHOTS
374         // on csqc: player pain                          PAIN
375 float   CHAN_PLAYER                             = 7; // Player body
376         // on world: UNUSED
377         // on players: player sounds                     PLAYER
378         // on entities: player sounds                    PLAYER
379         // on csqc: UNUSED
380
381 float   ATTN_NONE                               = 0;
382 float   ATTN_MIN                                = 0.015625;
383 float   ATTN_NORM                               = 0.5;
384 float   ATTN_IDLE                               = 2;
385 float   ATTN_STATIC                             = 3;
386 float   ATTN_MAX                                = 3.984375;
387
388 #define VOL_BASE 0.7
389 #define VOL_BASEVOICE 1.0
390
391 // this sets sounds and other properties of the projectiles in csqc
392 float PROJECTILE_ELECTRO = 1;
393 float PROJECTILE_ROCKET = 2;
394 float PROJECTILE_BULLET = 4;
395 float PROJECTILE_CRYLINK = 5;
396 float PROJECTILE_ELECTRO_BEAM = 6;
397 float PROJECTILE_GRENADE = 7;
398 float PROJECTILE_GRENADE_BOUNCING = 8;
399 float PROJECTILE_LASER = 9;
400 float PROJECTILE_HLAC = 10;
401 float PROJECTILE_PORTO_RED = 13;
402 float PROJECTILE_PORTO_BLUE = 14;
403 float PROJECTILE_HOOKBOMB = 15;
404 float PROJECTILE_HAGAR = 16;
405 float PROJECTILE_HAGAR_BOUNCING = 17;
406 float PROJECTILE_BULLET_GLOWING = 18;
407 float PROJECTILE_CRYLINK_BOUNCING = 19;
408 float PROJECTILE_FIREBALL = 20;
409 float PROJECTILE_FIREMINE = 21;
410
411 float SPECIES_HUMAN        =  0;
412 float SPECIES_ANIMAL       =  1;
413 float SPECIES_ALIEN        =  2;
414 float SPECIES_ROBOT_RUSTY  =  3;
415 float SPECIES_ROBOT_SHINY  =  4;
416 float SPECIES_RESERVED     = 15;
417
418 // Deathtypes (weapon deathtypes are the IT_* constants below)
419 // NOTE: when adding death types, please add an explanation to Docs/spamlog.txt too.
420 float DEATH_SPECIAL_START = 10000;
421 float DEATH_FALL = 10000;
422 float DEATH_TELEFRAG = 10001;
423 float DEATH_DROWN = 10002;
424 float DEATH_HURTTRIGGER = 10003;
425 float DEATH_LAVA = 10004;
426 float DEATH_SLIME = 10005;
427 float DEATH_KILL = 10006;
428 float DEATH_NOAMMO = 10007;
429 float DEATH_SWAMP = 10008;
430 float DEATH_TEAMCHANGE = 10009;
431 float DEATH_AUTOTEAMCHANGE = 10010;
432 float DEATH_CAMP = 10011;
433 float DEATH_SHOOTING_STAR = 10012;
434 float DEATH_ROT = 10013;
435 float DEATH_MIRRORDAMAGE = 10014;
436 float DEATH_TOUCHEXPLODE = 10015;
437 float DEATH_CHEAT = 10016;
438 float DEATH_FIRE = 10017;
439 float DEATH_TURRET = 10100;
440
441 float DEATH_WEAPONMASK = 0xFF;
442 float DEATH_HITTYPEMASK = 0x1F00; // which is WAY below 10000 used for normal deaths
443 float HITTYPE_SECONDARY = 0x100;
444 float HITTYPE_SPLASH = 0x200;
445 float HITTYPE_BOUNCE = 0x400;
446 float HITTYPE_HEADSHOT = 0x800;
447 float HITTYPE_RESERVED = 0x1000; // unused yet
448
449 // macros to access these
450 #define DEATH_ISSPECIAL(t)            ((t) >= DEATH_SPECIAL_START)
451 #define DEATH_WEAPONOFWEAPONDEATH(t)  ((t) & DEATH_WEAPONMASK)
452 #define DEATH_ISWEAPON(t,w)           (!DEATH_ISSPECIAL(t) && DEATH_WEAPONOFWEAPONDEATH(t) == (w))
453 #define DEATH_WEAPONOF(t)             (DEATH_ISSPECIAL(t) ? 0 : DEATH_WEAPONOFWEAPONDEATH(t))
454 #define WEP_VALID(w)                  ((w) >= WEP_FIRST && (w) <= WEP_LAST)
455
456 #define FRAGS_PLAYER 0
457 #define FRAGS_SPECTATOR -666
458 #define FRAGS_LMS_LOSER -616
459 #define FRAGS_PLAYER_NONSOLID -616
460 // we can use this frags value for both
461
462 //misc. stuff
463 #define NEWLINES "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n"
464
465 // water levels
466 float WATERLEVEL_NONE = 0;
467 float WATERLEVEL_WETFEET = 1;
468 float WATERLEVEL_SWIMMING = 2;
469 float WATERLEVEL_SUBMERGED = 3;
470
471 float MAX_SHOT_DISTANCE = 32768;