f296e81f412cf8fec0a7496b1928e8e3a2005004
[xonotic/xonotic-data.pk3dir.git] / 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 const float AS_STRING = 1;
27 const float AS_INT = 2;
28 const float AS_FLOAT_TRUNCATED = 2;
29 const float AS_FLOAT = 8;
30
31 const float TE_CSQC_PICTURE = 100;
32 const float TE_CSQC_RACE = 101;
33 const float TE_CSQC_VORTEXBEAMPARTICLE = 103;
34 const float TE_CSQC_ARC = 104;
35 const float TE_CSQC_TEAMNAGGER = 105;
36 const float TE_CSQC_PINGPLREPORT = 106;
37 const float TE_CSQC_TARGET_MUSIC = 107;
38 const float TE_CSQC_WEAPONCOMPLAIN = 108;
39 const float TE_CSQC_VORTEX_SCOPE = 109;
40 const float TE_CSQC_MINELAYER_MAXMINES = 110;
41 const float TE_CSQC_HAGAR_MAXROCKETS = 111;
42 const float TE_CSQC_VEHICLESETUP = 112;
43 const float TE_CSQC_SVNOTICE = 113;
44 const float TE_CSQC_SHOCKWAVEPARTICLE = 114;
45
46 const float RACE_NET_CHECKPOINT_HIT_QUALIFYING = 0; // byte checkpoint, short time, short recordtime, string recordholder
47 const float RACE_NET_CHECKPOINT_CLEAR = 1;
48 const float RACE_NET_CHECKPOINT_NEXT_QUALIFYING = 2; // byte nextcheckpoint, short recordtime, string recordholder
49 const float RACE_NET_CHECKPOINT_HIT_RACE = 3; // byte checkpoint, short delta, byte lapsdelta, string opponent
50 const float RACE_NET_CHECKPOINT_HIT_RACE_BY_OPPONENT = 4; // byte checkpoint, short delta, byte lapsdelta, string opponent
51 const float RACE_NET_CHECKPOINT_NEXT_SPEC_QUALIFYING = 5; // byte nextcheckpoint, float laptime, short recordtime, string recordholder
52 const float RACE_NET_PENALTY_RACE = 6; // byte penaltytime, string reason
53 const float RACE_NET_PENALTY_QUALIFYING = 7; // byte penaltytime, string reason
54 const float RACE_NET_SERVER_RECORD = 8; // server record, sent to client
55 const float RACE_NET_SPEED_AWARD = 9; // speed award, sent to client
56 const float RACE_NET_SPEED_AWARD_BEST = 10; // all time best speed award, sent to client
57 const float RACE_NET_SERVER_RANKINGS = 11;
58 const float RACE_NET_SERVER_STATUS = 12;
59 const float RANKINGS_CNT = 15;
60
61 const float ENT_CLIENT = 0;
62 const float ENT_CLIENT_DEAD = 1;
63 const float ENT_CLIENT_ENTCS = 2;
64 const float ENT_CLIENT_SCORES_INFO = 3;
65 const float ENT_CLIENT_SCORES = 4;
66 const float ENT_CLIENT_TEAMSCORES = 5;
67 const float ENT_CLIENT_POINTPARTICLES = 6;
68 const float ENT_CLIENT_RAINSNOW = 7;
69 const float ENT_CLIENT_LASER = 8;
70 const float ENT_CLIENT_NAGGER = 9; // flags [votecalledvote]
71 const float ENT_CLIENT_WAYPOINT = 10; // flags origin [team displayrule] [spritename] [spritename2] [spritename3] [lifetime maxdistance hideable]
72 const float ENT_CLIENT_RADARLINK = 11; // flags [startorigin] [endorigin] [startcolor+16*endcolor]
73 const float ENT_CLIENT_PROJECTILE = 12;
74 const float ENT_CLIENT_GIBSPLASH = 13;
75 const float ENT_CLIENT_DAMAGEINFO = 14;
76 const float ENT_CLIENT_CASING = 15;
77 const float ENT_CLIENT_INIT = 16;
78 const float ENT_CLIENT_MAPVOTE = 17;
79 const float ENT_CLIENT_CLIENTDATA = 18;
80 const float ENT_CLIENT_RANDOMSEED = 19;
81 const float ENT_CLIENT_WALL = 20;
82 const float ENT_CLIENT_SPIDERBOT = 21;
83 const float ENT_CLIENT_MODELEFFECT = 22;
84 const float ENT_CLIENT_TUBANOTE = 23;
85 const float ENT_CLIENT_WARPZONE = 24;
86 const float ENT_CLIENT_WARPZONE_CAMERA = 25;
87 const float ENT_CLIENT_TRIGGER_MUSIC = 26;
88 const float ENT_CLIENT_HOOK = 27;
89 const float ENT_CLIENT_ARC_BEAM = 29; // WEAPONTODO: fix numbers
90 const float ENT_CLIENT_ACCURACY = 30;
91 const float ENT_CLIENT_SHOWNAMES = 31;
92 const float ENT_CLIENT_WARPZONE_TELEPORTED = 32;
93 const float ENT_CLIENT_MODEL = 33;
94 const float ENT_CLIENT_ITEM = 34;
95 const float ENT_CLIENT_BUMBLE_RAYGUN = 35;
96 const float ENT_CLIENT_SPAWNPOINT = 36;
97 const float ENT_CLIENT_SPAWNEVENT = 37;
98 const float ENT_CLIENT_NOTIFICATION = 38;
99 const float ENT_CLIENT_ELIMINATEDPLAYERS = 39;
100 const float ENT_CLIENT_TURRET = 40;
101 const float ENT_CLIENT_AUXILIARYXHAIR = 50;
102 const float ENT_CLIENT_VEHICLE = 60;
103 const float ENT_CLIENT_LADDER = 61;
104 const float ENT_CLIENT_TRIGGER_PUSH = 62;
105 const float ENT_CLIENT_TARGET_PUSH = 63;
106 const float ENT_CLIENT_CONVEYOR = 64;
107 const float ENT_CLIENT_DOOR = 65;
108 const float ENT_CLIENT_DOOR_TRIGGER = 66;
109 const float ENT_CLIENT_PLAT = 67;
110 const float ENT_CLIENT_PLAT_TRIGGER = 68;
111 const float ENT_CLIENT_SWAMP = 69;
112
113 const float ENT_CLIENT_HEALING_ORB = 80;
114
115 const float SPRITERULE_DEFAULT = 0;
116 const float SPRITERULE_TEAMPLAY = 1;
117
118 const float RADARICON_NONE = 0;
119 const float RADARICON_FLAG = 1;
120 const float RADARICON_FLAGCARRIER = 1;
121 const float RADARICON_HERE = 1; // TODO make these 3 and 4, and make images for them
122 const float RADARICON_DANGER = 1;
123 const float RADARICON_WAYPOINT = 1;
124 const float RADARICON_HELPME = 1;
125 const float RADARICON_CONTROLPOINT = 1;
126 const float RADARICON_GENERATOR = 1;
127 const float RADARICON_OBJECTIVE = 1;
128 const float RADARICON_DOMPOINT = 1;
129 const float RADARICON_POWERUP = 1;
130 const float RADARICON_TAGGED = 1;
131
132 ///////////////////////////
133 // keys pressed
134 const float KEY_FORWARD = 1;
135 const float KEY_BACKWARD = 2;
136 const float KEY_LEFT = 4;
137 const float KEY_RIGHT = 8;
138 const float KEY_JUMP = 16;
139 const float KEY_CROUCH = 32;
140 const float KEY_ATCK = 64;
141 const float KEY_ATCK2 = 128;
142
143 ///////////////////////////
144 // cvar constants
145
146 const float CVAR_SAVE = 1;
147 const float CVAR_NOTIFY = 2;
148 const float CVAR_READONLY = 4;
149
150 ///////////////////////////
151 // csqc communication stuff
152
153 const float CTF_STATE_ATTACK = 1;
154 const float CTF_STATE_DEFEND = 2;
155 const float CTF_STATE_COMMANDER = 3;
156
157 const float HUD_NORMAL = 0;
158 const float HUD_VEHICLE_FIRST = 10;
159 const float HUD_SPIDERBOT = 10;
160 const float HUD_WAKIZASHI = 11;
161 const float HUD_RAPTOR = 12;
162 const float HUD_BUMBLEBEE = 13;
163 const float HUD_BUMBLEBEE_GUN = 14;
164 const float HUD_VEHICLE_LAST = 14;
165
166 const vector eX = '1 0 0';
167 const vector eY = '0 1 0';
168 const vector eZ = '0 0 1';
169
170 // moved that here so the client knows the max.
171 // # of maps, I'll use arrays for them :P
172 #define MAPVOTE_COUNT 30
173
174 /**
175  * Lower scores are better (e.g. suicides)
176  */
177 #define SFL_LOWER_IS_BETTER 1
178
179 /**
180  * Don't show zero values as scores
181  */
182 #define SFL_HIDE_ZERO 2
183
184 /**
185  * Allow a column to be hidden (do not automatically add it even if it is a sorting key)
186  */
187 #define SFL_ALLOW_HIDE 16
188
189 /**
190  * Display as a rank (with st, nd, rd, th suffix)
191  */
192 #define SFL_RANK 32
193
194 /**
195  * Display as mm:ss.s, value is stored as 10ths of a second (AND 0 is the worst possible value!)
196  */
197 #define SFL_TIME 64
198
199 // not an extra constant yet
200 #define SFL_ZERO_IS_WORST SFL_TIME
201
202 /**
203  * Scoring priority (NOTE: PRIMARY is used for fraglimit)
204  */
205 #define SFL_SORT_PRIO_SECONDARY 4
206 #define SFL_SORT_PRIO_PRIMARY 8
207 #define SFL_SORT_PRIO_MASK 12
208
209 /**
210  * Score indices
211  */
212 #define MAX_SCORE 10
213 #define MAX_TEAMSCORE 2
214
215 #define ST_SCORE 0
216 #define SP_KILLS 0
217 #define SP_DEATHS 1
218 #define SP_SUICIDES 2
219 #define SP_SCORE 3
220 // game mode specific indices are not in common/, but in server/scores_rules.qc!
221
222 const float CH_INFO = 0;
223 const float CH_TRIGGER = -3;
224 const float CH_WEAPON_A = -1;
225 const float CH_WEAPON_SINGLE = 1;
226 const float CH_VOICE = -2;
227 const float CH_BGM_SINGLE = 8;
228 const float CH_AMBIENT = -9;
229 const float CH_TRIGGER_SINGLE = 3;
230 const float CH_SHOTS = -4;
231 const float CH_SHOTS_SINGLE = 4;
232 const float CH_WEAPON_B = -1;
233 const float CH_PAIN = -6;
234 const float CH_PAIN_SINGLE = 6;
235 const float CH_PLAYER = -7;
236 const float CH_PLAYER_SINGLE = 7;
237 const float CH_TUBA_SINGLE = 5;
238
239 const float ATTEN_NONE = 0;
240 const float ATTEN_MIN = 0.015625;
241 const float ATTEN_NORM = 0.5;
242 const float ATTEN_LARGE = 1;
243 const float ATTEN_IDLE = 2;
244 const float ATTEN_STATIC = 3;
245 const float ATTEN_MAX = 3.984375;
246
247 #define VOL_BASE 0.7
248 #define VOL_BASEVOICE 1.0
249
250 // WEAPONTODO: move this into separate/new projectile handling code // this sets sounds and other properties of the projectiles in csqc
251 const float PROJECTILE_ELECTRO = 1;
252 const float PROJECTILE_ROCKET = 2;
253 const float PROJECTILE_TAG = 3;
254 const float PROJECTILE_CRYLINK = 5;
255 const float PROJECTILE_ELECTRO_BEAM = 6;
256 const float PROJECTILE_GRENADE = 7;
257 const float PROJECTILE_GRENADE_BOUNCING = 8;
258 const float PROJECTILE_MINE = 9;
259 const float PROJECTILE_BLASTER = 10;
260 const float PROJECTILE_HLAC = 11;
261 const float PROJECTILE_SEEKER = 12;
262 const float PROJECTILE_FLAC = 13;
263 const float PROJECTILE_PORTO_RED = 14;
264 const float PROJECTILE_PORTO_BLUE = 15;
265 const float PROJECTILE_HOOKBOMB = 16;
266 const float PROJECTILE_HAGAR = 17;
267 const float PROJECTILE_HAGAR_BOUNCING = 18;
268 const float PROJECTILE_CRYLINK_BOUNCING = 20;
269 const float PROJECTILE_FIREBALL = 21;
270 const float PROJECTILE_FIREMINE = 22;
271
272 const float PROJECTILE_RAPTORCANNON = 24;
273 const float PROJECTILE_RAPTORBOMB = 25;
274 const float PROJECTILE_RAPTORBOMBLET = 26;
275 const float PROJECTILE_SPIDERROCKET = 27;
276 const float PROJECTILE_WAKIROCKET = 28;
277 const float PROJECTILE_WAKICANNON = 29;
278
279 const float PROJECTILE_BUMBLE_GUN = 30;
280 const float PROJECTILE_BUMBLE_BEAM = 31;
281
282 const float PROJECTILE_MAGE_SPIKE = 32;
283 const float PROJECTILE_SHAMBLER_LIGHTNING = 33;
284
285 const float PROJECTILE_RPC = 60;
286
287 const float SPECIES_HUMAN = 0;
288 const float SPECIES_ROBOT_SOLID = 1;
289 const float SPECIES_ALIEN = 2;
290 const float SPECIES_ANIMAL = 3;
291 const float SPECIES_ROBOT_RUSTY = 4;
292 const float SPECIES_ROBOT_SHINY = 5;
293 const float SPECIES_RESERVED = 15;
294
295 #define FRAGS_PLAYER 0
296 #define FRAGS_SPECTATOR -666
297 #define FRAGS_LMS_LOSER -616
298 #define FRAGS_PLAYER_NONSOLID -616
299 // we can use this frags value for both
300
301 // water levels
302 const float WATERLEVEL_NONE = 0;
303 const float WATERLEVEL_WETFEET = 1;
304 const float WATERLEVEL_SWIMMING = 2;
305 const float WATERLEVEL_SUBMERGED = 3;
306 #define SERVERFLAG_ALLOW_FULLBRIGHT 1
307 #define SERVERFLAG_TEAMPLAY 2
308 #define SERVERFLAG_PLAYERSTATS 4
309
310 // FIXME/EXPLAINME: why?
311 noref var vector autocvar_sv_player_maxs = '16 16 45';
312 noref var vector autocvar_sv_player_mins = '-16 -16 -24';
313 noref var vector autocvar_sv_player_viewoffset = '0 0 20';
314 noref var vector autocvar_sv_player_crouch_maxs = '16 16 25';
315 noref var vector autocvar_sv_player_crouch_mins = '-16 -16 -24';
316 noref var vector autocvar_sv_player_crouch_viewoffset = '0 0 20';
317 noref var vector autocvar_sv_player_headsize = '24 24 12';
318
319 #define PL_VIEW_OFS autocvar_sv_player_viewoffset
320 #define PL_MIN autocvar_sv_player_mins
321 #define PL_MAX autocvar_sv_player_maxs
322 #define PL_CROUCH_VIEW_OFS autocvar_sv_player_crouch_viewoffset
323 #define PL_CROUCH_MIN autocvar_sv_player_crouch_mins
324 #define PL_CROUCH_MAX autocvar_sv_player_crouch_maxs
325 #define PL_HEAD autocvar_sv_player_headsize
326
327 // helpers
328 #define PL_VIEW_OFS_z autocvar_sv_player_viewoffset_z
329 #define PL_MIN_z autocvar_sv_player_mins_z
330 #define PL_MAX_z autocvar_sv_player_maxs_z
331 #define PL_CROUCH_VIEW_OFS_z autocvar_sv_player_crouch_viewoffset_z
332 #define PL_CROUCH_MIN_z autocvar_sv_player_mins_z
333 #define PL_HEAD_x autocvar_sv_player_headsize_x
334 #define PL_HEAD_y autocvar_sv_player_headsize_y
335 #define PL_HEAD_z autocvar_sv_player_headsize_z
336
337 // spawnpoint prios
338 #define SPAWN_PRIO_NEAR_TEAMMATE_FOUND 200
339 #define SPAWN_PRIO_NEAR_TEAMMATE_SAMETEAM 100
340 #define SPAWN_PRIO_RACE_PREVIOUS_SPAWN 50
341 #define SPAWN_PRIO_GOOD_DISTANCE 10
342
343 // URI handles
344 #define URI_GET_DISCARD 0
345 #define URI_GET_IPBAN 1
346 #define URI_GET_IPBAN_END 16
347 #define URI_GET_CURL 17
348 #define URI_GET_CURL_END 32
349 #define URI_GET_UPDATENOTIFICATION 33
350 #define URI_GET_URLLIB 128
351 #define URI_GET_URLLIB_END 191
352
353 // gametype votes
354 #define GTV_AVAILABLE 0
355 // for later use in per-map gametype filtering
356 #define GTV_FORBIDDEN 2