@amxts/core 0.1.0

package/amxmodx/base/include/fun.inc

@@ -0,0 +1,333 @@
+// vim: set ts=4 sw=4 tw=99 noet:
+//
+// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
+// Copyright (C) The AMX Mod X Development Team.
+//
+// This software is licensed under the GNU General Public License, version 3 or higher.
+// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
+//     https://alliedmods.net/amxmodx-license
+
+//
+// Fun Functions
+//
+
+#if defined _fun_included
+	#endinput
+#endif
+#define _fun_included
+
+#pragma reqlib fun
+#if !defined AMXMODX_NOAUTOLOAD
+	#pragma loadlib fun
+#endif
+
+
+/**
+ * Parts of body for hits, for use with set_user_hitzones().
+ */
+const HITZONE_GENERIC  = (1 << HIT_GENERIC);   // 1
+const HITZONE_HEAD     = (1 << HIT_HEAD);      // 2
+const HITZONE_CHEST    = (1 << HIT_CHEST);     // 4
+const HITZONE_STOMACH  = (1 << HIT_STOMACH);   // 8
+const HITZONE_LEFTARM  = (1 << HIT_LEFTARM);   // 16
+const HITZONE_RIGHTARM = (1 << HIT_RIGHTARM);  // 32
+const HITZONE_LEFTLEG  = (1 << HIT_LEFTLEG);   // 64
+const HITZONE_RIGHTLEG = (1 << HIT_RIGHTLEG);  // 128
+const HITZONES_DEFAULT = HITZONE_GENERIC | HITZONE_HEAD     | HITZONE_CHEST   | HITZONE_STOMACH | 
+                         HITZONE_LEFTARM | HITZONE_RIGHTARM | HITZONE_LEFTLEG | HITZONE_RIGHTLEG; // 255
+
+/**
+ * Tells whether receiver hears sender via voice communication.
+ *
+ * @param receiver      Receiver
+ * @param sender        Sender 
+ *
+ * @return              1 if receiver hears the sender, 0 otherwise.
+ * @error               If receiver or sender are not connected or not
+ *                      within the range of 1 to MaxClients
+ */
+native get_client_listen(receiver, sender);
+
+/**
+ * Sets who can listen who.
+ *
+ * @param receiver      Receiver
+ * @param sender        Sender
+ * @param listen        1 if receiver should be able to hear sender, 0 if not
+ *
+ * @return              0 if the setting can't be done for some reason
+ * @error               If receiver or sender are not connected or not
+ *                      within the range of 1 to MaxClients.
+ */
+native set_client_listen(receiver, sender, listen);
+
+/**
+ * Sets player's godmode.
+ *
+ * @param index         Client index
+ * @param godmode       1 to enable godmode, 0 to disable
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_godmode(index, godmode = 0);
+
+/**
+ * Tells whether a player has godmode on.
+ *
+ * @param index         Client index
+ *
+ * @return              1 if player has godmode on, 0 if not
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native get_user_godmode(index);
+
+/**
+ * Sets player's armor amount.
+ *
+ * @param index         Client index
+ * @param armor         The armor amount to set
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_armor(index, armor);
+
+/**
+ * Sets player's health amount.
+ *
+ * @param index         Client index
+ * @param health        The health amount to set
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_health(index, health);
+
+/**
+ * Moves a player to the given origin.
+ *
+ * @param index         Client index
+ * @param origin        Origin to move a player to
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_origin(index, const origin[3]);
+
+/**
+ * Sets player's rendering mode.
+ *
+ * @note A really useful render modes reference:
+ *		 https://sites.google.com/site/svenmanor/rendermodes
+ *
+ * @param index         Client index
+ * @param fx            Rendering effects. One of kRenderFx* constants
+ * @param r             The amount of red color (0 to 255)
+ * @param g             The amount of green color (0 to 255)
+ * @param b             The amount of blue color (0 to 255)
+ * @param render        Render mode. One of kRender* constants
+ * @param amount        Render amount (0 to 255)
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_rendering(index, fx = kRenderFxNone, r = 0, g = 0, b = 0, render = kRenderNormal, amount = 0);
+
+/**
+ * Gets player's rendering mode.
+ *
+ * @note A really useful render modes reference:
+ *		 https://sites.google.com/site/svenmanor/rendermodes
+ *
+ * @param index         Client index
+ * @param fx            Variable to store the rendering effect
+ * @param r             Variable to store the amount of red color
+ * @param g             Variable to store the amount of green color
+ * @param b             Variable to store the amount of blue color
+ * @param render        Variable to store the render mode
+ * @param amount        Variable to store the render amount
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native get_user_rendering(index, &fx = kRenderFxNone, &r = 0, &g = 0, &b = 0, &render = kRenderNormal, &amount = 0);
+
+/**
+ * Gives an item to a player.
+ *
+ * @param index         Client index
+ * @param item          Classname of the item to give. Should start with either
+ *                      "weapon_", "ammo_", "item_" or "tf_weapon_"
+ *
+ * @return              Item entity index. If an invalid item name is
+ *                      given or the item failed to create, it will return 0.
+ *                      If the item was removed, it will return -1
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients or item creation fails.
+ */
+native give_item(index, const item[]);
+
+/**
+ * Sets (adds, removes) hit zones for a player.
+ *
+ * @note This actually sets rules of how any player can hit any other.
+ *       Example: set_user_hitzones(id, target, 2) - makes @id able to
+ *       hit @target only in the head.
+ *
+ * @param index         Client index
+ * @param target        The target player
+ * @param body          A bitsum of the body parts that can/can't be shot. See HITZONE* constants.
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_hitzones(index = 0, target = 0, body = HITZONES_DEFAULT);
+
+/**
+ * Gets the set of hit zone "rules" between @index and @target players.
+ *
+ * @note For the body part bitsum, see HITZONE* constants.
+ *
+ * @param index         Client index
+ * @param target        The target player
+ *
+ * @return              The bitsum of @target's body parts @index is able to hit
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native get_user_hitzones(index, target);
+
+/**
+ * Sets player's maximum movement speed.
+ *
+ * @param index         Client index
+ * @param speed         The maximum speed player will be able to run at
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_maxspeed(index, Float:speed = -1.0);
+
+/**
+ * Gets player's maximum movement speed.
+ *
+ * @param index         Client index
+ *
+ * @return              Player's maximum movement speed
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native Float:get_user_maxspeed(index);
+
+/**
+ * Sets player's gravity.
+ *
+ * @param index         Client index
+ * @param gravity       Gravity value to set, 1.0 being normal gravity (800)
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_gravity(index, Float:gravity = 1.0);
+
+/**
+ * Gets player's gravity.
+ *
+ * @param index         Client index
+ *
+ * @return              Player's gravity value, 1.0 being normal gravity (800)
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native Float:get_user_gravity(index);
+
+/**
+ * Spawns an entity.
+ *
+ * @param index         Entity index
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native spawn(index);
+
+/**
+ * Enables or disables player's noclip.
+ *
+ * @param index         Client index
+ * @param noclip        1 to enable noclip, 0 to disable
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_noclip(index, noclip = 0);
+
+/**
+ * Gets whether a player has noclip enabled or not.
+ *
+ * @param index         Client index
+ *
+ * @return              1 if noclip is enabled, 0 if disabled
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native get_user_noclip(index);
+
+/**
+ * Tells whether a player has silent footsteps enabled.
+ *
+ * @param index         Client index
+ *
+ * @return              1 if silent footsteps are enabled, 0 if not
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native get_user_footsteps(index);
+
+/**
+ * Enables or disables player's silent footsteps.
+ *
+ * @param index        Client index
+ * @param set          1 if player should have silent footsteps, 0 otherwise
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_footsteps(id, set = 1);
+
+/**
+ * Strips all weapons from a player, including their knife.
+ *
+ * @param index         Client index
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native strip_user_weapons(index);
+
+/**
+ * Sets player's frags amount.
+ *
+ * @param index         Client index
+ * @param frags         The amount of frags to set
+ *
+ * @noreturn
+ * @error               If player is not connected or not within the range
+ *                      of 1 to MaxClients.
+ */
+native set_user_frags(index, frags);

package/amxmodx/base/include/gameconfig.inc

@@ -0,0 +1,93 @@
+// vim: set ts=4 sw=4 tw=99 noet:
+//
+// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
+// Copyright (C) The AMX Mod X Development Team.
+//
+// This software is licensed under the GNU General Public License, version 3 or higher.
+// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
+//     https://alliedmods.net/amxmodx-license
+
+//
+// Game Config Functions
+//
+
+#if defined _gameconfigs_included
+	#endinput
+#endif
+#define _gameconfigs_included
+
+enum GameConfig
+{
+	Invalid_GameConfig = 0
+};
+
+/**
+ * Loads a game config file.
+ *
+ * @note The file path must be relative to the 'gamedata' folder under the data folder
+ *       and the extension should be omitted.
+ *
+ * @param file          File to load
+ *
+ * @return              A handle to the game config file
+ */
+native GameConfig:LoadGameConfigFile(const file[]);
+
+/**
+ * Returns an offset value.
+ *
+ * @param handle        Game config handle
+ * @param key           Key to retrieve from the offset section
+ *
+ * @return              An offset, or -1 on failure
+ * @error               Invalid game config handle
+ */
+native GameConfGetOffset(GameConfig:handle, const key[]);
+
+/**
+ * Returns an offset value given a classname.
+ *
+ * @param handle        Game config handle
+ * @param classname     Class name to match from the offset section
+ * @param key           Key to retrieve from the offset section
+ *
+ * @return              An offset, or -1 on failure
+ * @error               Invalid game config handle
+ */
+native GameConfGetClassOffset(GameConfig:handle, const classname[], const key[]);
+
+/**
+ * Gets the value of a key from the "Keys" section.
+ *
+ * @param handle        Game config handle
+ * @param key           Key to retrieve from the Keys section
+ * @param buffer        Destination string buffer
+ * @param maxlen        Maximum length of output string buffer
+ *
+ * @return              True if key existed, false otherwise
+ * @error               Invalid game config handle
+ */
+native bool:GameConfGetKeyValue(GameConfig:handle, const key[], buffer[], maxlen);
+
+/**
+ * Finds an address calculation in a GameConfig file.
+ *
+ * @param handle        Game config handle
+ * @param name          Name of the property to find
+ *
+ * @return              An address calculated on success, otherwise 0 on failure.
+ * @error               Invalid game config handle
+ */
+native GameConfGetAddress(GameConfig:handle, const name[]);
+
+/**
+ * Destroys a game config and frees its memory.
+ *
+ * @note The function automatically sets the variable passed to it to 0 to aid
+ *       in preventing accidental usage after destroy.
+ *
+ * @param handle        Game config handle
+ *
+ * @return              1 on success, 0 if an invalid handle was passed in
+ */
+native CloseGameConfigFile(&GameConfig:handle);

package/amxmodx/base/include/geoip.inc

@@ -0,0 +1,264 @@
+// vim: set ts=4 sw=4 tw=99 noet:
+//
+// AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO").
+// Copyright (C) The AMX Mod X Development Team.
+//
+// This software is licensed under the GNU General Public License, version 3 or higher.
+// Additional exceptions apply. For full license details, see LICENSE.txt or visit:
+//     https://alliedmods.net/amxmodx-license
+
+//
+// GeoIP Module Functions
+//
+
+#if defined geoip_included
+	#endinput
+#endif
+#define _geoip_included
+
+#pragma reqlib geoip
+#if !defined AMXMODX_NOAUTOLOAD
+	#pragma loadlib geoip
+#endif
+
+/**
+ * @global  IP addresses passed to these natives can contain ports, the ports will be ignored.
+ */
+
+/**
+ * Look up the two character country code for a given IP address.
+ * e.g: "US", "CA", etc.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result buffer.  If the lookup does not succeed, the buffer is not modified.
+ *
+ * @return          true on a successful lookup, false on a failed lookup.
+ */
+native bool:geoip_code2_ex(const ip[], result[3]);
+
+/**
+ * Look up the three character country code for a given IP address.
+ * e.g: "USA", "cAN", etc.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result buffer.  If the lookup does not succeed, the buffer is not modified.
+ *
+ * @return          true on a successful lookup, false on a failed lookup.
+ */
+native bool:geoip_code3_ex(const ip[], result[4]);
+
+/**
+ * Lookup the two character country code for a given IP address. Sets the buffer to "error" on
+ * an unsuccessful lookup.
+ *
+ * @deprecated  This native will overflow the buffer by one cell on an unknown ip lookup!
+ *              Use geoip_code2_ex instead.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result buffer.
+ *
+ * @return          The result length.
+ */
+#pragma deprecated Use geoip_code2_ex() instead.
+native geoip_code2(const ip[], ccode[3]);
+
+/**
+ * Lookup the three character country code for a given IP address. Sets the buffer to "error" on
+ * an unsuccessful lookup.
+ *
+ * @deprecated  This native will overflow the buffer by one cell on an unknown ip lookup!
+ *              Use geoip_code3_ex instead.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result buffer.
+ *
+ * @return          The result length.
+ */
+#pragma deprecated Use geoip_code3_ex() instead.
+native geoip_code3(const ip[], result[4]);
+
+/**
+ * Lookup the full country name for the given IP address.  Sets the buffer to "error" on
+ * an unsuccessful lookup.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result of the geoip lookup.
+ * @param len       The maximum length of the result buffer.
+ *
+ * @return          The result length.
+ */
+#pragma deprecated Use geoip_country_ex() instead.
+native geoip_country(const ip[], result[], len = 45);
+
+/**
+ * Lookup the full country name for the given IP address.
+ *
+ * @param ip        The IP address to lookup.
+ * @param result    The result of the geoip lookup.
+ * @param len       The maximum length of the result buffer.
+ * @param id        An optional player's index in order to return the result
+ *                  in the player's language, if supported.
+ *                  -1: the default language, which is english.
+ *                   0: the server language. You can use LANG_SERVER define.
+ *                 >=1: the player's language.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_country_ex(const ip[], result[], len, id = -1);
+
+/**
+ * Look up the full city name for the given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ * @param len       The maximum length of the result buffer.
+ * @param id        An optional player's index in order to return the result
+ *                  in the player's language, if supported.
+ *                  -1: the default language, which is english.
+ *                   0: the server language. You can use LANG_SERVER define.
+ *                 >=1: the player's language.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_city(const ip[], result[], len, id = -1);
+
+/**
+ * Look up the region/state code for the given IP address.
+ * e.g. "US-OH", "DE-HH", IT-82, "FR-U", etc.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ * @param len       The maximum length of the result buffer.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_region_code(const ip[], result[], len);
+
+/**
+ * Look up the full region/state name for the given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ * @param len       The maximum length of the result buffer.
+ * @param id        An optional player's index in order to return the result
+ *                  in the player's language, if supported.
+ *                  -1: the default language, which is english.
+ *                   0: the server language. You can use LANG_SERVER define.
+ *                 >=1: the player's language.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_region_name(const ip[], result[], len, id = -1);
+
+/**
+ * Look up the full time zone for the given IP address.
+ * e.g. America/Los_Angeles, Europe/Paris.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ * @param len       The maximum length of the result buffer.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_timezone(const ip[], result[], len);
+
+/**
+ * Look up the city's latitude for the given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ *
+ * @return          The result of the geoip look up, 0 if latitude is not found.
+ */
+native Float:geoip_latitude(const ip[]);
+
+/**
+ * Look up the city's longitude for the given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ *
+ * @return          The result of the geoip look up, 0 if longitude is not found.
+ */
+native Float:geoip_longitude(const ip[]);
+
+/**
+ * Calculate the distance between geographical coordinates, latitude and longitude.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param lat1      The first IP latitude.
+ * @param lon1      The first IP longitude.
+ * @param lat2      The second IP latitude.
+ * @param lon2      The second IP longitude.
+ * @param system    The system of measurement, 0 = Metric(kilometers) or 1 = English(miles).
+ *
+ * @return          The distance as result in specified system of measurement.
+ */
+#define SYSTEM_METRIC   0 // kilometers
+#define SYSTEM_IMPERIAL 1 // statute miles
+
+native Float:geoip_distance(Float:lat1, Float:lon1, Float:lat2, Float:lon2, system = SYSTEM_METRIC);
+
+/**
+ * Look up the continent code for a given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ * @note  The code can be retrieved as integer (See CONTINENT_* constants.) or string (2 characters).
+ * @note  Possible continent codes are AF, AN, AS, EU, NA, OC, SA for
+ *        Africa(1), Antarctica(2), Asia(3), Europe(4), North America(5), Oceania(6), South America(7).
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ *
+ * @return          The continent id on successful lookup, 0 otherwise.
+ */
+enum Continent
+{
+	CONTINENT_UNKNOWN = 0,
+	CONTINENT_AFRICA,
+	CONTINENT_ANTARCTICA,
+	CONTINENT_ASIA,
+	CONTINENT_EUROPE,
+	CONTINENT_NORTH_AMERICA,
+	CONTINENT_OCEANIA,
+	CONTINENT_SOUTH_AMERICA,
+};
+native Continent:geoip_continent_code(const ip[], result[3]);
+
+/**
+ * Look up the full continent name for the given IP address.
+ *
+ * @note  This native requires GeoIP City database, which can be retrieved from:
+ *        http://dev.maxmind.com/geoip/geoip2/geolite2/ (MaxMind DB binary)
+ *
+ * @param ip        The IP address to look up.
+ * @param result    The result of the geoip look up.
+ * @param len       The maximum length of the result buffer.
+ * @param id        An optional player's index in order to return the result
+ *                  in the player's language, if supported.
+ *                  -1: the default language, which is english.
+ *                   0: the server language. You can use LANG_SERVER define.
+ *                 >=1: the player's language.
+ *
+ * @return          The result length on successful lookup, 0 otherwise.
+ */
+native geoip_continent_name(const ip[], result[], len, id = -1);