AMXX-BG.INFO › aes_v.inc › Raw include

aes_v.inc

Original include source with line numbers.

Back Download .inc
1 #define AES_MAX_LEVEL_LENGTH 64
2
3 enum _:
4 {
5 AES_RT_NO,
6 AES_RT_YES,
7 AES_RT_LEVEL_DOWN,
8 AES_RT_LEVEL_UP
9 };
10
11 /**
12 * Array structure for get stats with aes_find_stats_thread native
13 */
14 enum _:aes_stats_struct
15 {
16 AES_S_NAME[32],
17 AES_S_STEAMID[30],
18 AES_S_IP[16],
19
20 Float:AES_S_EXP,
21 AES_S_LEVEL,
22 AES_S_BONUS,
23
24 AES_S_ID
25 };
26
27 /**
28 * Returns player experience
29 *
30 * @param player player id
31 *
32 * @return player experience or -1.0 if player not tracked yet
33 */
34 native Float:aes_get_player_exp(player);
35
36 /**
37 * Sets player experience
38 *
39 * @param player player id
40 * @param exp experience value
41 * @param no_forward dont trigger forward functions on level up or level down
42 * @param force force even if track paused
43 *
44 * @return AES_RT_NO on track pause or player not tracked yet
45 * AES_RT_YES on success
46 * AES_RT_LEVLE_DOWN on level down
47 * AES_RT_LEVEL_UP on level up
48 */
49 native aes_set_player_exp(player,Float:exp,bool:no_forward = false,bool:force = false);
50
51 /**
52 * Returns player required experience to next level
53 * @param player player id
54 *
55 * @return - required experience value
56 */
57 native Float:aes_get_player_reqexp(player);
58
59 /**
60 * Returns player bonus points
61 *
62 * @param player player id
63 *
64 * @return player bonus points or -1 if player
65 */
66 native aes_get_player_bonus(player);
67
68 /**
69 * Sets player bonus points
70 *
71 * @param player player id
72 * @param bonus bonus value
73 * @param force force even if track paused
74 *
75 * @return AES_RT_NO on track pause or player not tracked yet
76 * AES_RT_YES on success
77 */
78 native aes_set_player_bonus(player,bonus,bool:force = false);
79
80 /**
81 * Returns current player level
82 *
83 * @param player player id
84 *
85 * @return current player level or -1 if player not tracked yet
86 */
87 native aes_get_player_level(player);
88
89 /**
90 * Sets player level
91 *
92 * @param player player id
93 * @param level level
94 * @param force force even if track paused
95 *
96 * @return AES_RT_NO on track pause or player not tracked yet
97 * AES_RT_YES on success
98 */
99 native aes_set_player_level(player,level,bool:force = false);
100
101 /**
102 * Returns maximum level
103 *
104 * @return level
105 */
106 native aes_get_max_level();
107
108 /**
109 * Returns level name for level num.
110 *
111 * @param level level number
112 * @param level[] Buffer to copy level name output to
113 * @param len Maximum size of buffer
114 * @param idLang language id
115 *
116 * @return len
117 */
118 native aes_get_level_name(level,level_name[],len,idLang = LANG_SERVER);
119
120 /**
121 * Returns level for experience
122 *
123 * @param exp experience value
124 *
125 * @return level num or -1 of fail
126 */
127 native aes_get_exp_level(Float:exp);
128
129 /**
130 * Returns required experience to pass level
131 *
132 * @param lvl level
133 *
134 * @return required experience value or -1.0 on fail
135 */
136 native Float:aes_get_level_reqexp(level);
137
138 /**
139 * Thread search for aes stats witch given array track_ids
140 *
141 * @param id player id
142 * @param track_ids dynamic array with track ids for search
143 * @param callback your callback function
144 * public my_callback(id,Array:aes_stats,stats_data[])
145 * @param data[] custom data
146 * @param data_size custom data size
147 *
148 * @return true or false
149 */
150 native aes_find_stats_thread(id = 0,Array:track_ids,callback[],data[] = "",datasize = 0);
151
152 /**
153 * Called when player open bonus menu.
154 *
155 * @param id player id
156 *
157 * @return PLUGIN_CONTINUE to let the player open menu
158 * PLUGIN_HANDLED or higher to stop
159 */
160 forward aes_on_anew_command(id)
161
162 /**
163 * Called when player data is loaded.
164 *
165 * @param id player id
166 *
167 * @noreturn
168 */
169 forward aes_player_connect(id)
170
171 /**
172 * Called on player level up.
173 *
174 * @param id player id
175 * @param new_level new level
176 * @param old_level old level
177 *
178 * @noreturn
179 */
180 forward aes_player_levelup(id,new_level,old_level);
181
182 /**
183 * Called on player level down.
184 *
185 * @param id player id
186 * @param new_level new level
187 * @param old_level old level
188 *
189 * @noreturn
190 */
191 forward aes_player_leveldown(id,new_level,old_level);
192
193 #define aes_add_player_exp_f(%0,%1) aes_set_player_exp(%0,aes_get_player_exp(%0) + %1)
194 #define aes_add_player_bonus_f(%0,%1) aes_set_player_bonus(%0,aes_get_player_bonus(%0) + %1)
195