14cbd8e3f4816fda3a608f921f07fdd2d9d3c9e1
[xonotic/xonotic-data.pk3dir.git] / qcsrc / common / t_items.qh
1 #pragma once
2
3 #ifdef SVQC
4 #include <server/defs.qh>
5 #endif
6
7 /// \brief Unconditional maximum amount of items the player can have.
8 const int ITEM_COUNT_HARD_LIMIT = 999;
9
10 const int AMMO_COUNT = 4; // amount of ammo types to show in the inventory panel
11
12 // item networking
13 const int ISF_LOCATION                  = BIT(1);
14 const int ISF_MODEL                             = BIT(2);
15 const int ISF_STATUS                    = BIT(3);
16     const int ITS_STAYWEP                   = BIT(0);
17     const int ITS_ANIMATE1                  = BIT(1);
18     const int ITS_ANIMATE2                  = BIT(2);
19     const int ITS_AVAILABLE         = BIT(3);
20     const int ITS_ALLOWFB                   = BIT(4);
21     const int ITS_ALLOWSI                   = BIT(5);
22     const int ITS_GLOW                      = BIT(6);
23 const int ISF_COLORMAP                  = BIT(4);
24 const int ISF_DROP                              = BIT(5);
25 const int ISF_ANGLES                    = BIT(6);
26 const int ISF_SIZE                              = BIT(7);
27
28 .int ItemStatus;
29
30 .float onground_time;
31 .float fade_start;
32 .float fade_end;
33
34 #ifdef SVQC
35 void StartItem(entity this, entity a);
36 #endif
37
38 #ifdef CSQC
39
40 bool   autocvar_cl_items_nofade;
41 float  autocvar_cl_animate_items = 1;
42 float  autocvar_cl_ghost_items = 0.45;
43 vector autocvar_cl_ghost_items_color = '-1 -1 -1';
44 float  autocvar_cl_fullbright_items = 0;
45 vector autocvar_cl_weapon_stay_color = '2 0.5 0.5';
46 float  autocvar_cl_weapon_stay_alpha = 0.75;
47 float  autocvar_cl_simple_items = 0;
48 string autocvar_cl_simpleitems_postfix = "_simple";
49 .float  spawntime;
50 .float  gravity;
51 .vector colormod;
52
53 void ItemDraw(entity this);
54 void ItemDrawSimple(entity this);
55
56 #endif
57 #ifdef SVQC
58 spawnfunc(item_strength);
59 spawnfunc(item_invincible);
60 spawnfunc(item_armor_small);
61 spawnfunc(item_shells);
62 spawnfunc(item_bullets);
63 spawnfunc(item_rockets);
64
65 float autocvar_sv_simple_items;
66 bool ItemSend(entity this, entity to, int sf);
67
68
69 bool have_pickup_item(entity this);
70
71 const float ITEM_RESPAWN_TICKS = 10;
72
73 #define ITEM_RESPAWNTIME(i)         ((i).respawntime + crandom() * (i).respawntimejitter)
74         // range: respawntime - respawntimejitter .. respawntime + respawntimejitter
75 #define ITEM_RESPAWNTIME_INITIAL(i) (ITEM_RESPAWN_TICKS + random() * ((i).respawntime + (i).respawntimejitter - ITEM_RESPAWN_TICKS))
76         // range: 10 .. respawntime + respawntimejitter
77
78 .float max_armorvalue;
79 .float pickup_anyway;
80
81 void Item_Show (entity e, float mode);
82
83 void Item_Respawn (entity this);
84
85 void Item_RespawnCountdown(entity this);
86 void Item_ScheduleRespawnIn(entity e, float t);
87
88 void Item_ScheduleRespawn(entity e);
89
90 void Item_ScheduleInitialRespawn(entity e);
91
92 /// \brief Gives player a resource such as health, armor or ammo.
93 /// \param[in,out] player Player to give resource to.
94 /// \param[in] resource_type Type of the resource.
95 /// \param[in] amount Amount of resource to give.
96 /// \return No return.
97 void GivePlayerResource(entity player, .float resource_type, float amount);
98
99 /// \brief Gives health to the player.
100 /// \param[in,out] player Player to give health to.
101 /// \param[in] amount Amount of health to give.
102 /// \return No return.
103 void GivePlayerHealth(entity player, float amount);
104
105 /// \brief Gives armor to the player.
106 /// \param[in,out] player Player to give armor to.
107 /// \param[in] amount Amount of armor to give.
108 /// \return No return.
109 void GivePlayerArmor(entity player, float amount);
110
111 /// \brief Gives ammo of the specified type to the player.
112 /// \param[in,out] player Player to give ammo to.
113 /// \param[in] type Ammo type property.
114 /// \param[in] amount Amount of ammo to give.
115 /// \return No return.
116 void GivePlayerAmmo(entity player, .float ammotype, float amount);
117
118 /// \brief Gives fuel to the player.
119 /// \param[in,out] player Player to give fuel to.
120 /// \param[in] amount Amount of fuel to give.
121 /// \return No return.
122 void GivePlayerFuel(entity player, float amount);
123
124 float Item_GiveAmmoTo(entity item, entity player, .float ammotype, float ammomax);
125
126 float Item_GiveTo(entity item, entity player);
127
128 void Item_Touch(entity this, entity toucher);
129
130 void Item_Reset(entity this);
131
132 void Item_FindTeam(entity this);
133 // Savage: used for item garbage-collection
134
135 bool ItemSend(entity this, entity to, int sf);
136 void ItemUpdate(entity this);
137
138 void UpdateItemAfterTeleport(entity this);
139
140 // pickup evaluation functions
141 // these functions decide how desirable an item is to the bots
142
143 float generic_pickupevalfunc(entity player, entity item);// {return item.bot_pickupbasevalue;} // WEAPONTODO
144
145 float weapon_pickupevalfunc(entity player, entity item);
146 float ammo_pickupevalfunc(entity player, entity item);
147 float healtharmor_pickupevalfunc(entity player, entity item);
148
149 .float is_item;
150 .entity itemdef;
151 void _StartItem(entity this, entity def, float defaultrespawntime, float defaultrespawntimejitter);
152
153 void setItemGroup(entity this);
154 void setItemGroupCount();
155
156 float GiveWeapon(entity e, float wpn, float op, float val);
157
158 float GiveBit(entity e, .float fld, float bit, float op, float val);
159
160 float GiveValue(entity e, .float fld, float op, float val);
161
162 void GiveSound(entity e, float v0, float v1, float t, Sound snd_incr, Sound snd_decr);
163
164 void GiveRot(entity e, float v0, float v1, .float rotfield, float rottime, .float regenfield, float regentime);
165
166 #define PREGIVE_WEAPONS(e) WepSet save_weapons; save_weapons = e.weapons
167 #define PREGIVE(e,f) float save_##f; save_##f = (e).f
168 #define POSTGIVE_WEAPON(e,b,snd_incr,snd_decr) GiveSound((e), !!(save_weapons & WepSet_FromWeapon(b)), !!(e.weapons & WepSet_FromWeapon(b)), 0, snd_incr, snd_decr)
169 #define POSTGIVE_BIT(e,f,b,snd_incr,snd_decr) GiveSound((e), save_##f & (b), (e).f & (b), 0, snd_incr, snd_decr)
170 #define POSTGIVE_VALUE(e,f,t,snd_incr,snd_decr) GiveSound((e), save_##f, (e).f, t, snd_incr, snd_decr)
171 #define POSTGIVE_VALUE_ROT(e,f,t,rotfield,rottime,regenfield,regentime,snd_incr,snd_decr) GiveRot((e), save_##f, (e).f, rotfield, rottime, regenfield, regentime); GiveSound((e), save_##f, (e).f, t, snd_incr, snd_decr)
172
173 float GiveItems(entity e, float beginarg, float endarg);
174 #endif