// 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 #if defined _amxconst_included #endinput #endif #define _amxconst_included #include /** * Internal AMXX buffer size for string retrieval. * * @note This is the buffer size AMX Mod X uses internally to retrieve strings * from plugins. Most natives that take strings as arguments will * implicitly truncate them to this maximum length. This has been raised * to the current value with AMXX 1.8.3. Previously the limit was 3072. * @note This is here mainly for documentation purposes. By default plugins * don't have enough memory available to allocate an array of this size. * You probably should not use this to actually declare a buffer unless * you *absolutely* have to. Look at #pragma dynamic to increase a plugins * available memory. */ #define MAX_STRING_LENGTH 16384 /** * Defines and constants related to the maximum number of clients. * * @note MAX_PLAYERS is not the same as MaxClients. MAX_PLAYERS is a hardcoded * value as an upper limit, used mainly to declare arrays big enough for * all possible server situations. MaxClients changes based on the * server the plugin is deployed on.. */ #define MAX_PLAYERS 32 /* Maximum number of players AMX Mod X supports */ /** * Maximum number of players the server supports */ public stock const MaxClients; /** * Pass this into certain functions to act as a C++ NULL */ public stock const NULL_STRING[1]; /** * Pass this into certain functions to act as a C++ NULL */ public stock const Float:NULL_VECTOR[3]; /** * The maximum buffer size required to store a clients name. */ #define MAX_NAME_LENGTH 32 /** * π */ #define M_PI 3.1415926535 /** * @section Admin privilege and authentication constants */ /** * Admin level constants */ #define ADMIN_ALL 0 /* everyone */ #define ADMIN_IMMUNITY (1<<0) /* flag "a" */ #define ADMIN_RESERVATION (1<<1) /* flag "b" */ #define ADMIN_KICK (1<<2) /* flag "c" */ #define ADMIN_BAN (1<<3) /* flag "d" */ #define ADMIN_SLAY (1<<4) /* flag "e" */ #define ADMIN_MAP (1<<5) /* flag "f" */ #define ADMIN_CVAR (1<<6) /* flag "g" */ #define ADMIN_CFG (1<<7) /* flag "h" */ #define ADMIN_CHAT (1<<8) /* flag "i" */ #define ADMIN_VOTE (1<<9) /* flag "j" */ #define ADMIN_PASSWORD (1<<10) /* flag "k" */ #define ADMIN_RCON (1<<11) /* flag "l" */ #define ADMIN_LEVEL_A (1<<12) /* flag "m" */ #define ADMIN_LEVEL_B (1<<13) /* flag "n" */ #define ADMIN_LEVEL_C (1<<14) /* flag "o" */ #define ADMIN_LEVEL_D (1<<15) /* flag "p" */ #define ADMIN_LEVEL_E (1<<16) /* flag "q" */ #define ADMIN_LEVEL_F (1<<17) /* flag "r" */ #define ADMIN_LEVEL_G (1<<18) /* flag "s" */ #define ADMIN_LEVEL_H (1<<19) /* flag "t" */ #define ADMIN_MENU (1<<20) /* flag "u" */ #define ADMIN_BAN_TEMP (1<<21) /* flag "v" */ #define ADMIN_ADMIN (1<<24) /* flag "y" */ #define ADMIN_USER (1<<25) /* flag "z" */ /** * Admin authentication behavior flags */ #define FLAG_KICK (1<<0) /* flag "a" */ #define FLAG_TAG (1<<1) /* flag "b" */ #define FLAG_AUTHID (1<<2) /* flag "c" */ #define FLAG_IP (1<<3) /* flag "d" */ #define FLAG_NOPASS (1<<4) /* flag "e" */ #define FLAG_CASE_SENSITIVE (1<<10) /* flag "k" */ /** * @endsection */ /** * Return codes */ #define PLUGIN_CONTINUE 0 /* Results returned by public functions */ #define PLUGIN_HANDLED 1 /* stop other plugins */ #define PLUGIN_HANDLED_MAIN 2 /* to use in client_command(), continue all plugins but stop the command */ /** * HI weapon constants */ #define HIW_BERETTA 1 #define HIW_SPAS12 2 #define HIW_M4A1 3 #define HIW_MP5A4 4 #define HIW_MP5SD5 5 #define HIW_AK47 6 #define HIW_AKS74U 7 #define HIW_GLOCK 8 #define HIW_M11 9 #define HIW_M11SD 10 #define HIW_PSG1 11 #define HIW_ZASTAVA 12 #define HIW_M16A2 13 #define HIW_REMINGTON 14 #define HIW_NATOGREN 15 #define HIW_TANGOGREN 16 #define HIW_FLASHBANG 17 /** * Parts of body for hits */ #define HIT_GENERIC 0 /* none */ #define HIT_HEAD 1 #define HIT_CHEST 2 #define HIT_STOMACH 3 #define HIT_LEFTARM 4 #define HIT_RIGHTARM 5 #define HIT_LEFTLEG 6 #define HIT_RIGHTLEG 7 #define HIT_SHIELD 8 // CS only /** * @section emit_sound() constants */ /** * Channels */ #define CHAN_AUTO 0 #define CHAN_WEAPON 1 #define CHAN_VOICE 2 #define CHAN_ITEM 3 #define CHAN_BODY 4 #define CHAN_STREAM 5 /* allocate stream channel from the static or dynamic area */ #define CHAN_STATIC 6 /* allocate channel from the static area */ #define CHAN_NETWORKVOICE_BASE 7 /* voice data coming across the network */ #define CHAN_NETWORKVOICE_END 500 /* network voice data reserves slots (CHAN_NETWORKVOICE_BASE through CHAN_NETWORKVOICE_END). */ /** *Attenuation values */ #define ATTN_NONE 0.00 #define ATTN_NORM 0.80 #define ATTN_IDLE 2.00 #define ATTN_STATIC 1.25 /** * Pitch values */ #define PITCH_NORM 100 /* non-pitch shifted */ #define PITCH_LOW 95 /* other values are possible - 0-255, where 255 is very high */ #define PITCH_HIGH 120 /** * Volume values */ #define VOL_NORM 1.0 /** * Sound behavior constants */ #define SND_SPAWNING (1<<8) // we're spawing, used in some cases for ambients #define SND_STOP (1<<5) // stop sound #define SND_CHANGE_VOL (1<<6) // change sound vol #define SND_CHANGE_PITCH (1<<7) // change sound pitch /** * @endsection */ /** * Menu keys */ #define MENU_KEY_1 (1<<0) #define MENU_KEY_2 (1<<1) #define MENU_KEY_3 (1<<2) #define MENU_KEY_4 (1<<3) #define MENU_KEY_5 (1<<4) #define MENU_KEY_6 (1<<5) #define MENU_KEY_7 (1<<6) #define MENU_KEY_8 (1<<7) #define MENU_KEY_9 (1<<8) #define MENU_KEY_0 (1<<9) /** * Language constants */ #define LANG_SERVER 0 #define LANG_PLAYER -1 /** * Placeholder that replaces the admin name in show_activity_custom() */ #define ACTIVITY_STR_NAME "$an" /** * Placeholder that replaces the client prefix in show_activity_custom() */ #define ACTIVITY_STR_PREFIX "$px" /** * @section Client print native constants */ /** * Destination types for client_print() */ enum { print_notify = 1, print_console, print_chat, print_center, print_radio /* Counter-Strike only */ }; /** * Color types for client_print_color() */ enum { print_team_default = 0, print_team_grey = -1, print_team_red = -2, print_team_blue = -3, }; /** * Destination types for engclient_print() */ enum { engprint_console = 0, engprint_center, engprint_chat, }; /** * @endsection */ /** * @section Entity rendering constants */ /** * Rendering modes (i.e. for set_user_rendering()) */ enum { kRenderNormal = 0, /* src */ kRenderTransColor, /* c*a+dest*(1-a) */ kRenderTransTexture, /* src*a+dest*(1-a) */ kRenderGlow, /* src*a+dest -- No Z buffer checks */ kRenderTransAlpha, /* src*srca+dest*(1-srca) */ kRenderTransAdd, /* src*a+dest */ }; /** * Rendering fx (i.e. for set_user_rendering()) */ enum { kRenderFxNone = 0, kRenderFxPulseSlow, kRenderFxPulseFast, kRenderFxPulseSlowWide, kRenderFxPulseFastWide, kRenderFxFadeSlow, kRenderFxFadeFast, kRenderFxSolidSlow, kRenderFxSolidFast, kRenderFxStrobeSlow, kRenderFxStrobeFast, kRenderFxStrobeFaster, kRenderFxFlickerSlow, kRenderFxFlickerFast, kRenderFxNoDissipation, kRenderFxDistort, /* Distort/scale/translate flicker */ kRenderFxHologram, /* kRenderFxDistort + distance fade */ kRenderFxDeadPlayer, /* kRenderAmt is the player index */ kRenderFxExplode, /* Scale up really big! */ kRenderFxGlowShell, /* Glowing Shell */ kRenderFxClampMinScale, /* Keep this sprite from getting very small (SPRITES only!) */ }; /** * @endsection */ /** * Type for force_unmodified() */ enum { force_exactfile = 0, /* File on client must exactly match server's file */ force_model_samebounds, /* For model files only, the geometry must fit in the same bbox */ force_model_specifybounds, /* For model files only, the geometry must fit in the specified bbox */ }; /** * Status for get_module() */ enum { module_none = 0, module_query, module_badload, module_loaded, module_noinfo, module_noquery, module_noattach, module_old, }; /** * AMX flag constants */ #define AMX_FLAG_DEBUG 0x02 /* symbolic info. available */ #define AMX_FLAG_COMPACT 0x04 /* compact encoding */ #define AMX_FLAG_BYTEOPC 0x08 /* opcode is a byte (not a cell) */ #define AMX_FLAG_NOCHECKS 0x10 /* no array bounds checking; no STMT opcode */ #define AMX_FLAG_NTVREG 0x1000 /* all native functions are registered */ #define AMX_FLAG_JITC 0x2000 /* abstract machine is JIT compiled */ #define AMX_FLAG_BROWSE 0x4000 /* busy browsing */ #define AMX_FLAG_RELOC 0x8000 /* jump/call addresses relocated */ /** * Invalid plugin id */ #define INVALID_PLUGIN_ID -1 /** * Menu and menu item status codes */ #define MENU_TIMEOUT -4 #define MENU_EXIT -3 #define MENU_BACK -2 #define MENU_MORE -1 #define ITEM_IGNORE 0 #define ITEM_ENABLED 1 #define ITEM_DISABLED 2 /** * AMX error codes */ #define AMX_ERR_NATIVE 10 #define AMX_ERR_MEMACCESS 5 #define AMX_ERR_NONE 0 #define AMX_ERR_BOUNDS 4 #define AMX_ERR_STACKERR 3 #define AMX_ERR_STACKLOW 7 #define AMX_ERR_HEAPLOW 8 #define AMX_ERR_DIVIDE 11 #define AMX_ERR_NOTFOUND 19 #define AMX_ERR_PARAMS 25 #define AMX_ERR_GENERAL 27 /** * Generic invalid handle value */ #define INVALID_HANDLE -1 /** * @section Plugin forward related constants */ /** * Stop types for plugin forwards */ #define ET_IGNORE 0 //ignore return val #define ET_STOP 1 //stop on PLUGIN_HANDLED #define ET_STOP2 2 //same, except return biggest #define ET_CONTINUE 3 //no stop, return biggest /** * Parameter types for plugin forwards */ #define FP_CELL 0 #define FP_FLOAT 1 #define FP_STRING 2 #define FP_ARRAY 4 #define FP_VAL_BYREF 5 //cell & float are handled in the same way /** * @endsection */ /** * LibType constants */ enum LibType { LibType_Library, LibType_Class }; /** * AdminProp constants */ enum AdminProp { AdminProp_Auth = 0, AdminProp_Password, AdminProp_Access, AdminProp_Flags }; /** * HashType constants * To be used on hash_file() and hash_string() */ enum HashType { Hash_Crc32 = 0, // Provides CRC32 hashing Hash_Md5, // Provides MD5 hashing Hash_Sha1, // Provides SHA1 hashing Hash_Sha256, // Provides SHA256 hashing Hash_Sha3_224, // Provides SHA3 224 bit hashing Hash_Sha3_256, // Provides SHA3 256 bit hashing Hash_Sha3_384, // Provides SHA3 384 bit hashing Hash_Sha3_512, // Provides SHA3 512 bit hashing Hash_Keccak_224, // Provides Keccak 224 bit hashing Hash_Keccak_256, // Provides Keccak 256 bit hashing Hash_Keccak_384, // Provides Keccak 384 bit hashing Hash_Keccak_512 // Provides Keccak 512 bit hashing }; /** * SetTaskFlags constants for set_task_ex() */ enum SetTaskFlags (<<= 1) { SetTask_Once = 0, // None; execute callback after the specified amount of time (Default) SetTask_RepeatTimes = 1, // Repeat timer a set amount of times SetTask_Repeat, // Loop indefinitely until timer is stopped SetTask_AfterMapStart, // Time interval is treated as absolute time after map start SetTask_BeforeMapChange // Time interval is treated as absolute time before map change }; /** * RegisterEventFlags constants for register_event_ex() */ enum RegisterEventFlags (<<= 1) { RegisterEvent_None = 0, // None RegisterEvent_Global = 1, // Global event (sent to every client) RegisterEvent_Single, // Event sent to single client RegisterEvent_OnceForMultiple, // Call only once when repeated to multiple clients RegisterEvent_OnlyDead, // Call only if sent to dead client RegisterEvent_OnlyAlive, // Call only if sent to alive client RegisterEvent_OnlyHuman, // Call only if sent to human client (RegisterEvent_Single required) RegisterEvent_OnlyBots // Call only if sent to bot (RegisterEvent_Single required) }; /** * GetPlayerFlags constants for get_players_ex() */ enum GetPlayersFlags (<<= 1) { GetPlayers_None = 0, // No filter (Default) GetPlayers_ExcludeDead = 1, // Do not include dead clients GetPlayers_ExcludeAlive, // Do not include alive clients GetPlayers_ExcludeBots, // Do not include bots GetPlayers_ExcludeHuman, // Do not include human clients GetPlayers_MatchTeam, // Match with team GetPlayers_MatchNameSubstring, // Match with part of name GetPlayers_CaseInsensitive, // Match case insensitive GetPlayers_ExcludeHLTV, // Do not include HLTV proxies GetPlayers_IncludeConnecting // Include connecting clients }; /** * FindPlayerFlags constants for find_player_ex() */ enum FindPlayerFlags (<<= 1) { FindPlayer_None = 0, // None FindPlayer_MatchName = 1, // Match with name FindPlayer_MatchNameSubstring, // Match with name substring FindPlayer_MatchAuthId, // Match with authid FindPlayer_MatchIP, // Match with ip FindPlayer_MatchTeam, // Match with team name FindPlayer_ExcludeDead, // Do not include dead clients FindPlayer_ExcludeAlive, // Do not include alive clients FindPlayer_ExcludeBots, // Do not include bots FindPlayer_ExcludeHuman, // Do not include human clients FindPlayer_LastMatched, // Return last matched client instead of the first FindPlayer_MatchUserId, // Match with userid FindPlayer_CaseInsensitive, // Match case insensitively FindPlayer_IncludeConnecting // Include connecting clients } #include // To keep backward compatibility