Properly support team field on trigger_multiple
[xonotic/xonotic-data.pk3dir.git] / qcsrc / server / utils.qh
1 #pragma once
2
3 int maxclients;
4
5 const string STR_PLAYER = "player";
6 const string STR_SPECTATOR = "spectator";
7 const string STR_OBSERVER = "observer";
8
9 #define IS_PLAYER(v) ((v).classname == STR_PLAYER)
10 #define IS_SPEC(v) ((v).classname == STR_SPECTATOR)
11 #define IS_OBSERVER(v) ((v).classname == STR_OBSERVER)
12
13 #define IS_CLIENT(v) (v.flags & FL_CLIENT)
14 /** want: (IS_CLIENT(v) && !IS_REAL_CLIENT(v)) */
15 #define IS_BOT_CLIENT(v) (clienttype(v) == CLIENTTYPE_BOT)
16 #define IS_FAKE_CLIENT(v) (clienttype(v) == CLIENTTYPE_NOTACLIENT)
17 #define IS_REAL_CLIENT(v) (clienttype(v) == CLIENTTYPE_REAL)
18 /** was: (clienttype(v) == CLIENTTYPE_NOTACLIENT) */
19 #define IS_NOT_A_CLIENT(v) (!IS_CLIENT(v))
20
21 #define IS_MONSTER(v) (v.flags & FL_MONSTER)
22 #define IS_VEHICLE(v) (v.vehicle_flags & VHF_ISVEHICLE)
23 #define IS_TURRET(v) (v.turret_flags & TUR_FLAG_ISTURRET)
24
25 // NOTE: FOR_EACH_CLIENTSLOT deprecated! Use the following instead: FOREACH_CLIENTSLOT(true, { code; });
26 // NOTE: FOR_EACH_CLIENT deprecated! Use the following instead: FOREACH_CLIENT(true, { code; });
27 // NOTE: FOR_EACH_REALCLIENT deprecated! Use the following instead: FOREACH_CLIENT(IS_REAL_CLIENT(it), { code; });
28
29 // NOTE: FOR_EACH_PLAYER deprecated! Use the following instead: FOREACH_CLIENT(IS_PLAYER(it), { code; });
30 // NOTE: FOR_EACH_SPEC deprecated! Use the following instead: FOREACH_CLIENT(IS_SPEC(it), { code; });
31 // NOTE: FOR_EACH_OBSERVER deprecated! Use the following instead: FOREACH_CLIENT(IS_OBSERVER(it), { code; });
32 // NOTE: FOR_EACH_REALPLAYER deprecated! Use the following instead: FOREACH_CLIENT(IS_PLAYER(it) && IS_REAL_CLIENT(it), { code; });
33
34 #define FOREACH_CLIENTSLOT(cond, body) \
35         MACRO_BEGIN { \
36                 for(int _i = 1; _i <= maxclients; ++_i) \
37                 { \
38                         const noref int i = _i; \
39                         ITER_CONST noref entity it = ftoe(i); \
40                         if(cond) { LAMBDA(body) } \
41                 } \
42         } MACRO_END
43
44 #define FOREACH_CLIENT(cond, body) FOREACH_CLIENTSLOT(IS_CLIENT(it) && (cond), LAMBDA(body))
45
46 // using the "inside out" version of knuth-fisher-yates shuffle
47 // https://en.wikipedia.org/wiki/Fisher–Yates_shuffle
48 entity _FCR_clients[255];
49 bool _FCR_entered = false;
50 #define FOREACH_CLIENT_RANDOM(cond, body) \
51         MACRO_BEGIN { \
52                 if (_FCR_entered) LOG_FATAL("FOREACH_CLIENT_RANDOM must not be nested"); \
53                 _FCR_entered = true; \
54                 int _cnt = 0; \
55                 FOREACH_CLIENT(cond, { \
56             int _j = floor(random() * (_cnt + 1)); \
57             if (_j == _cnt) \
58             { \
59                 _FCR_clients[_cnt] = it; \
60             } \
61             else \
62             { \
63                 _FCR_clients[_cnt] = _FCR_clients[_j]; \
64                 _FCR_clients[_j] = it; \
65             } \
66             _cnt++; \
67         }); \
68                 for (int _i = 0; _i < _cnt; ++_i) \
69                 { \
70                         const noref int i = _i; \
71                         ITER_CONST noref entity it = _FCR_clients[i]; \
72                         if (cond) { LAMBDA(body) } \
73                 } \
74                 _FCR_entered = false; \
75         } MACRO_END
76
77 // NOTE: FOR_EACH_MONSTER deprecated! Use the following instead: IL_EACH(g_monsters, true, { code; });