mirror of
https://github.com/alliedmodders/amxmodx.git
synced 2024-12-31 01:05:35 +03:00
1170 lines
44 KiB
SourcePawn
Executable File
1170 lines
44 KiB
SourcePawn
Executable File
// 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
|
|
|
|
//
|
|
// Fakemeta Functions
|
|
//
|
|
|
|
#if defined _fakemeta_included
|
|
#endinput
|
|
#endif
|
|
#define _fakemeta_included
|
|
|
|
#include <fakemeta_const>
|
|
|
|
#pragma reqlib fakemeta
|
|
#if !defined AMXMODX_NOAUTOLOAD
|
|
#pragma loadlib fakemeta
|
|
#endif
|
|
|
|
/**
|
|
* Returns entvar data from an entity. Use the pev_* enum (in fakemeta_const.inc) to specify which data you want retrieved.
|
|
*
|
|
* @note This function uses "read_data" style data syntax. It returns integer values,
|
|
* by-references float data, and sets a buffer for string data.
|
|
*
|
|
* @note If retrieving strings, you may optionally get a pointer into the global string table. Depending on
|
|
* your situation, there are two ways to do this.
|
|
* 1: This simply gets the pointer.
|
|
* new ptr = pev(entid, pev_classname)
|
|
* 2: The pointer will be stored in ptr AND the actual string is retrieved.
|
|
* new ptr, classname[32]
|
|
* pev(entid, pev_classname, ptr, classname, 31)
|
|
*
|
|
* @param _index The entity index to lookup.
|
|
* @param _value The pev field to lookup (look in fakemeta_const.inc)
|
|
*/
|
|
native pev(_index,_value,any:...);
|
|
|
|
/**
|
|
* Sets entvar data for an entity. Use the pev_* enum from fakemeta_const.inc for reference.
|
|
*
|
|
* @note Setting string data will automatically allocate a new string (via AllocString)
|
|
* If you have a string already allocated with your own call to AllocString, use
|
|
* set_pev_string_ptr instead.
|
|
*
|
|
* @param _index The entity index to set the value on.
|
|
* @param _value The pev field to set, (look in fakemeta_const.inc)
|
|
*/
|
|
native set_pev(_index,_value,any:...);
|
|
|
|
/**
|
|
* Use this native to set a pev field to a string that is already allocated (via a function such
|
|
* as EngFunc_AllocString).
|
|
*
|
|
* @note If you specify _value as anything other than string fields, an error will be thrown.
|
|
* @note Pass 0 as the _string field to set it to an empty string.
|
|
*
|
|
* @param _index The entity index to set the value on.
|
|
* @param _value The pev field to set - MUST be a string field.
|
|
* @param _string The string handle, retrieved from places like AllocString.
|
|
*/
|
|
native set_pev_string(_index, _value, _string);
|
|
|
|
|
|
/**
|
|
* Checks the validity of an entity.
|
|
*
|
|
* @param entindex The entity id to check.
|
|
*
|
|
* @return 0 on invalid entity
|
|
* 1 on entity is valid
|
|
* 2 on entity is valid and it has private data (safe to use pdata natives on).
|
|
*/
|
|
native pev_valid(entindex);
|
|
|
|
/**
|
|
* Returns the serial number for each entity. The serial number is a unique identity
|
|
* generated when an entity is created.
|
|
*
|
|
* @param entindex The entity id.
|
|
*
|
|
* @return The serial number for the entity.
|
|
*/
|
|
native pev_serial(entindex);
|
|
|
|
/* Returns any global variable inside globalvars_t structure. Use the glb_* enum.
|
|
*
|
|
* When returning data from glb_pStringBase (the global string table), you may give a pointer into that table
|
|
* in order to get different strings.
|
|
* Example:
|
|
* new model[128]
|
|
* new ptr = pev(id, pev_viewmodel)
|
|
* global_get(glb_pStringBase, ptr, model, 127)
|
|
*/
|
|
native global_get(_value, any:...);
|
|
|
|
/**
|
|
* Returns a integer from an entity's private data.
|
|
*
|
|
* _linuxdiff value is what to add to the _Offset for linux servers.
|
|
* _macdiff value is what to add to the _Offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _Offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return An integer value is returned.
|
|
*/
|
|
native get_pdata_int(_index, _Offset, _linuxdiff = 5, _macdiff = 5);
|
|
|
|
/**
|
|
* Sets an integer to an entity's private data.
|
|
*
|
|
* _linuxdiff value is what to add to the _Offset for linux servers.
|
|
* _macdiff value is what to add to the _Offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _Offset Offset to search.
|
|
* @param _Value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_int(_index, _Offset, _Value, _linuxdiff = 5, _macdiff = 5);
|
|
|
|
/**
|
|
* Returns a float from an entity's private data.
|
|
*
|
|
* _linuxdiff value is what to add to the _Offset for linux servers.
|
|
* _macdiff value is what to add to the _Offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _Offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return An float value is returned.
|
|
*/
|
|
native Float:get_pdata_float(_index, _Offset, _linuxdiff = 5, _macdiff = 5);
|
|
|
|
/**
|
|
* Sets a float to an entity's private data.
|
|
*
|
|
* _linuxdiff value is what to add to the _Offset for linux servers.
|
|
* _macdiff value is what to add to the _Offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _Offset Offset to search.
|
|
* @param _Value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_float(_index, _Offset, Float:_Value, _linuxdiff = 5, _macdiff = 5);
|
|
|
|
/**
|
|
* Tries to retrieve an edict pointer from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_ent searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return -2 if an invalid entity was found.
|
|
* -1 if an empty entity was found.
|
|
* Otherwise, an entity index is returned.
|
|
*/
|
|
native get_pdata_ent(_index, _offset, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets an edict pointer to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_ent searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_ent(_index, _offset, _value, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Returns a boolean from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_bool searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return An boolean value is returned.
|
|
*/
|
|
native bool:get_pdata_bool(_index, _offset, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets a boolean to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_bool searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_bool(_index, _offset, bool:_value, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Returns a byte value from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_byte searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return A byte value is returned.
|
|
*/
|
|
native get_pdata_byte(_index, _offset, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets a byte value to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_byte searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_byte(_index, _offset, _value, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Returns a short value from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_short searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return A short value is returned.
|
|
*/
|
|
native get_pdata_short(_index, _offset, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets a short value to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_short searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_short(_index, _offset, _value, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Returns a vector from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_vector searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _output Vector returned by reference.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native get_pdata_vector(_index, _offset, Float:_output[3], _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets a vector to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_vector searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _origin Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_vector(_index, _offset, Float:_origin[3], _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Tries to retrieve an edict (entity encapsulation) pointer from an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike get_pdata_int() which searches in byte increments of 4,
|
|
* get_pdata_ehandle searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return -2 if an invalid entity was found.
|
|
* -1 if an empty entity was found.
|
|
* 0 if serialnumber is not matching.
|
|
* Otherwise, an entity index is returned.
|
|
*/
|
|
native get_pdata_ehandle(_index, _offset, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/**
|
|
* Sets an edict (entity encapsulation) pointer to an entity's private data.
|
|
*
|
|
* This function is byte-addressable. Unlike set_pdata_int() which searches in byte increments of 4,
|
|
* set_pdata_ehandle searches in increments of 1.
|
|
*
|
|
* _linuxdiff value is what to add to the _offset for linux servers.
|
|
* _macdiff value is what to add to the _offset for os x servers.
|
|
*
|
|
* A log error is thrown on invalid _index and _Offset.
|
|
*
|
|
* @param _index Entity index.
|
|
* @param _offset Offset to search.
|
|
* @param _value Value to set.
|
|
* @param _linuxdiff Linux difference.
|
|
* @param _macdiff Mac OS X difference.
|
|
* @return 1 on success.
|
|
*/
|
|
native set_pdata_ehandle(_index, _offset, _value, _linuxdiff = 20, _macdiff = 20);
|
|
|
|
/* Registers a forward.
|
|
* Returns an id you can pass to unregister_forward
|
|
*/
|
|
native register_forward(_forwardType,const _function[],_post=0);
|
|
|
|
/* Unregisters a forward.
|
|
* The registerId must be from register_forward, and
|
|
* post/forwardtype must match what you registered the forward as.
|
|
*/
|
|
native unregister_forward(_forwardType, registerId, post=0);
|
|
|
|
/* Returns data for metamod */
|
|
native forward_return(type,any:...);
|
|
|
|
/* Returns the original return value of an engine function.
|
|
* This is only valid in forwards that were registered as post.
|
|
*
|
|
* get_orig_retval() - no params, retrieves integer return value
|
|
* get_orig_retval(&Float:value) - retrieves float return value by reference
|
|
* get_orig_retval(value[], len) - retrives string return value
|
|
*/
|
|
native get_orig_retval(any:...);
|
|
|
|
native engfunc(type,any:...);
|
|
native dllfunc(type,any:...);
|
|
|
|
//only use this with functions that pass a Trace
|
|
// get: zero extra params - return int, one extra param = byref float or vector
|
|
// set: use anything
|
|
native get_tr(TraceResult:tr_member, any:...);
|
|
native set_tr(TraceResult:tr_member, any:...);
|
|
|
|
//Upgraded version takes in a TraceResult handle, optionally passed in as the last parameter to the
|
|
//TraceResult forward. Use 0 to specify the global traceresult handle set from calling
|
|
// some of the Engfucs.
|
|
native get_tr2(tr_handle, any:tr_member, any:...);
|
|
native set_tr2(tr_handle, any:tr_member, any:...);
|
|
|
|
/**
|
|
* Creates a traceresult handle. This value should never be altered.
|
|
* The handle can be used in get/set_tr2 and various traceresult engine functions.
|
|
*
|
|
* NOTE: You must call free_tr2() on every handle made with create_tr2().
|
|
*
|
|
* @return A new TraceResult handle.
|
|
*/
|
|
native create_tr2();
|
|
|
|
/**
|
|
* Frees a traceresult handle created with free_tr2(). Do not call
|
|
* this more than once per handle, or on handles not created through
|
|
* create_tr2().
|
|
*
|
|
* @param tr_handle TraceResult handle created via create_tr2().
|
|
* @noreturn
|
|
*/
|
|
native free_tr2(tr_handle);
|
|
|
|
//Same as above, use either a kvd_handle or 0 for global reserved kvd data
|
|
//kvd_handle is passed by the kvd hook, last param
|
|
native get_kvd(kvd_handle, KeyValueData:member, any:...);
|
|
|
|
//Using set_kvd with the handle from the hook for anything under KV_fHandled
|
|
// is considered an undefined operation (it could crash). You should fire a new
|
|
// keyvalues structure rather than changing the internal engine strings.
|
|
native set_kvd(kvd_handle, KeyValueData:member, any:...);
|
|
|
|
/**
|
|
* Creates a KeyValueData handle.
|
|
*
|
|
* @note Handles should be freed using free_kvd().
|
|
*
|
|
* @return New KeyValueData handle
|
|
*/
|
|
native create_kvd();
|
|
|
|
/**
|
|
* Frees a KeyValueData handle.
|
|
*
|
|
* @param kvd_handle KeyValueData handle
|
|
*
|
|
* @noreturn
|
|
*/
|
|
native free_kvd(kvd_handle);
|
|
|
|
// These functions are used with the clientdata data structure (FM_UpdateClientData)
|
|
// Get: 0 extra params - Return integer; 1 extra param - by ref float or vector; 2 extra params - string and length
|
|
// Set: Use anything
|
|
// Use 0 for cd_handle to specify the global clientdata handle
|
|
native get_cd(cd_handle, ClientData:member, any:...);
|
|
native set_cd(cd_handle, ClientData:member, any:...);
|
|
|
|
// These functions are used with the entity_state data structure (FM_AddToFullPack)
|
|
// Get: 0 extra params - Return integer; 1 extra param - by ref float or vector or array
|
|
// Set: Use anything
|
|
// Use 0 for es_handle to specify the global entity_state handle
|
|
native get_es(es_handle, EntityState:member, any:...);
|
|
native set_es(es_handle, EntityState:member, any:...);
|
|
|
|
// These functions are used with the usercmd data structure (FM_CmdStart)
|
|
// Get: 0 extra params - Return integer; 1 extra param - by ref float or vector
|
|
// Set: Use anything
|
|
// Use 0 for uc_handle to specify the global usercmd handle
|
|
native get_uc(uc_handle, UserCmd:member, any:...);
|
|
native set_uc(uc_handle, UserCmd:member, any:...);
|
|
|
|
//NOTE that for the string offsets below, on AMD64, a byref (char **) offset is NOT the same as an int offset
|
|
//In fact it's QWORD aligned rather than DWORD aligned, so the offset will be exactly half.
|
|
//Gets a string from a private offset. If byref is false, the string is treated as static rather than dynamic.
|
|
//linux value is what to add to the offset for linux servers.
|
|
//mac value is what to add to the offset for os x servers. Default (cellmin) means that linux value will be used.
|
|
//this cannot use a default value due to older version using an awkward default value.
|
|
native get_pdata_string(entity, offset, dest[], maxlength, byref=1, linux, mac=cellmin);
|
|
|
|
//Sets a string in a private offset.
|
|
//realloc = -1 - nonbyref copy (static
|
|
//realloc = 0 - copy byref, no realloc *(char **)
|
|
//realloc = 1 - reallocate new string with free+malloc
|
|
//realloc = 2 - reallocate new string with delete[]+new[]
|
|
//linux value is what to add to the offset for linux servers.
|
|
//mac value iswhat to add to the offset for os x servers.
|
|
//this cannot use a default value due to older version using an awkward default value.
|
|
native set_pdata_string(entity, offset, const source[], realloc=2, linux, mac=cellmin);
|
|
|
|
// Copies the given infoBuffer pointer into out[]
|
|
// An infoBuffer pointer is returned by EngFunc_GetInfoKeyBuffer
|
|
native copy_infokey_buffer(infoBuffer, out[], maxlen);
|
|
|
|
|
|
/**
|
|
* Looks up the sequence for the entity.
|
|
*
|
|
* @param entity The entity id to lookup.
|
|
* @param name The sequence name to lookup, case insensitive. ("JUMP" would match "jump")
|
|
* @param framerate The framerate of the sequence, if found.
|
|
* @param loops Whether or not the sequence loops.
|
|
* @param groundspeed The groundspeed setting of the sequence.
|
|
* @return -1 on failed lookup, the sequence number on successful lookup.
|
|
*/
|
|
native lookup_sequence(entity, const name[], &Float:framerate = 0.0, &bool:loops = false, &Float:groundspeed = 0.0);
|
|
|
|
/**
|
|
* Sets a bone controller with the specified value.
|
|
*
|
|
* @param entity The entity id to set the value on.
|
|
* @param controller Which controller to set (0 through 3).
|
|
* @param value The value to set it to.
|
|
* @return The percentage that the controller is extended (0.0 through 1.0)
|
|
*/
|
|
native Float:set_controller(entity, controller, Float:value);
|
|
|
|
/**
|
|
* Retrieves an integer value from an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* integer, boolean, short, character, pointer, structure, class,
|
|
* stringint and function. Unsigned variants (if applicable) are supported
|
|
* and will be converted automatically.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Integer value
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native any:get_ent_data(entity, const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets an integer value to an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* integer, boolean, short, character, pointer, stringint and function.
|
|
* Unsigned variants (if applicable) are supported and will be converted
|
|
* automatically.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Value to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native set_ent_data(entity, const class[], const member[], any:value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a float value from an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Float value
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native Float:get_ent_data_float(entity, const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets a float value to an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Value to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native set_ent_data_float(entity, const class[], const member[], Float:value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a vector from an entity's private data based off a class and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Vector buffer to store data in
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native get_ent_data_vector(entity, const class[], const member[], Float:value[3], element = 0);
|
|
|
|
/**
|
|
* Sets a vector to an entity's private data based off a class and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Vector to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native set_ent_data_vector(entity, const class[], const member[], Float:value[3], element = 0);
|
|
|
|
/**
|
|
* Retrieves an entity index from an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* classptr, entvars, edict and ehandle.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Entity index if found, -1 otherwise
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native get_ent_data_entity(entity, const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets an entity index to an entity's private data based off a class
|
|
* and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* classptr, entvars, edict and ehandle.
|
|
* @note Pass -1 as value to act as C++ NULL.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Entity index to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If an invalid entity or value is provided, either class or member
|
|
* is empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native set_ent_data_entity(entity, const class[], const member[], value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a string from an entity's private data based off a class and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* string, stringptr.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Buffer to store data in
|
|
* @param maxlen Maximum size of the buffer
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Number of cells written to buffer
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native get_ent_data_string(entity, const class[], const member[], value[], maxlen, element = 0);
|
|
|
|
/**
|
|
* Sets a string to an entity's private data based off a class and member name.
|
|
*
|
|
* @note Unlike the [get|set]_pdata_* natives that require compiling the class
|
|
* member offset into the plugin, this native instead retrieves the
|
|
* necessary offset from the AMXX gamedata files at runtime, based on the
|
|
* provided class and member name.
|
|
* @note This native is safer than [get|set]_pdata_* as it can perform stricter
|
|
* offset and typing checks.
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* string, stringptr.
|
|
*
|
|
* @param entity Entity index
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value String to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @return Number of cells written to buffer
|
|
* @error If an invalid entity is provided, either class or member is
|
|
* empty, no offset is found or an invalid offset is retrieved,
|
|
* or the data type does not match, an error will be thrown.
|
|
*/
|
|
native set_ent_data_string(entity, const class[], const member[], const value[], element = 0);
|
|
|
|
/**
|
|
* Retrieves the size of array of n entity class member.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
*
|
|
* @return Size of array (in elements), otherwise 1 if member is not an array
|
|
* @error If either class or member is empty, no offset is found or an invalid
|
|
* offset is retrieved, an error will be thrown.
|
|
*/
|
|
native get_ent_data_size(const class[], const member[]);
|
|
|
|
/**
|
|
* Finds a offset based off an entity class and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param type Optional variable to store member type in (FIELD_* constants)
|
|
* @param arraysize Optional variable to store array size in, if member is an array
|
|
* @param unsigned Optional variable to store whether member is unsigned (short and char types only)
|
|
*
|
|
* @return Class member offset
|
|
* @error If either class or member is empty, no offset is found or an invalid
|
|
* offset is retrieved, an error will be thrown.
|
|
*/
|
|
native find_ent_data_info(const class[], const member[], &FieldType:type = FIELD_NONE, &arraysize = 0, &bool:unsigned = false);
|
|
|
|
|
|
/**
|
|
* Retrieves an integer value from the gamerules object based off a class
|
|
* and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* integer, boolean, short, character, pointer, structure, class,
|
|
* stringint and function. Unsigned variants (if applicable) are supported
|
|
* and will be converted automatically.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Integer value
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native any:get_gamerules_int(const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets an integer value to the gamerules objecta based off a class
|
|
* and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* integer, boolean, short, character, pointer, stringint and function.
|
|
* Unsigned variants (if applicable) are supported and will be converted
|
|
* automatically.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Value to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native set_gamerules_int(const class[], const member[], any:value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a float value from the gamerules object based off a class
|
|
* and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Float value
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native Float:get_gamerules_float(const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets a float value to the gamerules object based off a class
|
|
* and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Value to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native set_gamerules_float(const class[], const member[], Float:value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a vector from the gamerules object based off a class and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Vector buffer to store data in
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native get_gamerules_vector(const class[], const member[], Float:value[3], element = 0);
|
|
|
|
/**
|
|
* Sets a vector to the gamerules object based off a class and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Vector to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native set_gamerules_vector(const class[], const member[], Float:value[3], element = 0);
|
|
|
|
/**
|
|
* Retrieves an entity index from the gamerules object based off a class
|
|
* and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* classptr, entvars, edict and ehandle.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Entity index if found, -1 otherwise
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native get_gamerules_entity(const class[], const member[], element = 0);
|
|
|
|
/**
|
|
* Sets an entity index to the gamerules object based off a class
|
|
* and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* classptr, entvars, edict and ehandle.
|
|
* @note Pass -1 as value to act as C++ NULL.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Entity index to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @noreturn
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native set_gamerules_entity(const class[], const member[], value, element = 0);
|
|
|
|
/**
|
|
* Retrieves a string from the gamerules object based off a class and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* string, stringptr.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value Buffer to store data in
|
|
* @param maxlen Maximum size of the buffer
|
|
* @param element Element to retrieve (starting from 0) if member is an array
|
|
*
|
|
* @return Number of cells written to buffer
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native get_gamerules_string(const class[], const member[], value[], maxlen, element = 0);
|
|
|
|
/**
|
|
* Sets a string to the gamerules object based off a class and member name.
|
|
*
|
|
* @note This native is used to access the following (C++/engine) data types:
|
|
* string, stringptr.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param value String to set
|
|
* @param element Element to set (starting from 0) if member is an array
|
|
*
|
|
* @return Number of cells written to buffer
|
|
* @error If member is empty, no offset is found or an invalid offset
|
|
* is retrieved, or the data type does not match, an error will
|
|
* be thrown.
|
|
*/
|
|
native set_gamerules_string(const class[], const member[], const value[], element = 0);
|
|
|
|
/**
|
|
* Retrieves the size of array of a gamerules class member.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
*
|
|
* @return Size of array (in elements), otherwise 1 if member is not an array
|
|
* @error If either class or member is empty, no offset is found or an invalid
|
|
* offset is retrieved, an error will be thrown.
|
|
*/
|
|
native get_gamerules_size(const class[], const member[]);
|
|
|
|
/**
|
|
* Finds a gamerules offset based off a class and member name.
|
|
*
|
|
* @param class Class name
|
|
* @param member Member name
|
|
* @param type Optional variable to store member type in (FIELD_* constants)
|
|
* @param arraysize Optional variable to store array size in, if member is an array
|
|
* @param unsigned Optional variable to store whether member is unsigned (short and char types only)
|
|
*
|
|
* @return Class member offset
|
|
* @error If either class or member is empty, no offset is found or an invalid
|
|
* offset is retrieved, an error will be thrown.
|
|
*/
|
|
native find_gamerules_info(const class[], const member[], &FieldType:type = FIELD_NONE, &arraysize = 0, &bool:unsigned = false);
|
|
|
|
/**
|
|
* Returns the data field base type based off a specific field type.
|
|
*
|
|
* @note From an AMXX plugin perspective, the (C++/engine) data types can be grouped
|
|
* in five base types: integer, float, vector, entity and string. This stock is
|
|
* essentially for convenience and debug purpose.
|
|
*
|
|
* @param type Class member type (FIELD_* constants)
|
|
* @param type_name Optional buffer to store base type name in
|
|
* @param maxlen Maximum size of the buffer
|
|
*
|
|
* @return Base field type (BASEFIELD_* constants)
|
|
*/
|
|
stock BaseFieldType:get_field_basetype(FieldType:type, type_name[] = "", maxlen = 0)
|
|
{
|
|
static const baseFieldTypeNames[BaseFieldType][] =
|
|
{
|
|
"none",
|
|
"integer",
|
|
"float",
|
|
"vector",
|
|
"entity",
|
|
"string",
|
|
};
|
|
|
|
new BaseFieldType:baseType = BASEFIELD_NONE;
|
|
|
|
switch (type)
|
|
{
|
|
case FIELD_INTEGER, FIELD_STRINGINT, FIELD_SHORT , FIELD_CHARACTER,
|
|
FIELD_CLASS , FIELD_STRUCTURE, FIELD_POINTER, FIELD_FUNCTION,
|
|
FIELD_BOOLEAN:
|
|
{
|
|
baseType = BASEFIELD_INTEGER;
|
|
}
|
|
case FIELD_FLOAT:
|
|
{
|
|
baseType = BASEFIELD_FLOAT;
|
|
}
|
|
case FIELD_VECTOR:
|
|
{
|
|
baseType = BASEFIELD_VECTOR;
|
|
}
|
|
case FIELD_CLASSPTR, FIELD_ENTVARS, FIELD_EDICT, FIELD_EHANDLE:
|
|
{
|
|
baseType = BASEFIELD_ENTITY;
|
|
}
|
|
case FIELD_STRINGPTR, FIELD_STRING:
|
|
{
|
|
baseType = BASEFIELD_STRING;
|
|
}
|
|
}
|
|
|
|
if (maxlen > 0)
|
|
{
|
|
copy(type_name, maxlen, baseFieldTypeNames[baseType]);
|
|
}
|
|
|
|
return baseType;
|
|
}
|
|
|
|
|
|
enum
|
|
{
|
|
Model_DefaultSize = -2,
|
|
Model_CurrentSequence = -1,
|
|
};
|
|
|
|
/**
|
|
* Gets size of the entity models collision box.
|
|
*
|
|
* @param entity The entity index to use.
|
|
* @param mins The local negative collision box distance.
|
|
* @param maxs The local positive collision box distance.
|
|
*
|
|
* @return 1 on success, 0 on faillure.
|
|
*
|
|
* @error Invalid entity.
|
|
* Invalid model pointer.
|
|
*/
|
|
native GetModelCollisionBox(entity, Float:mins[3], Float:maxs[3]);
|
|
|
|
/**
|
|
* Sets entity size to the models collision box.
|
|
*
|
|
* @param entity The entity index to set the value on.
|
|
*
|
|
* @return 1 on success, 0 on faillure.
|
|
*
|
|
* @error Invalid entity.
|
|
* Invalid model pointer.
|
|
*/
|
|
native SetModelCollisionBox(entity);
|
|
|
|
/**
|
|
* Gets size of a model bounding box.
|
|
*
|
|
* @param entity The entity index to use.
|
|
* @param mins The local negative bounding box distance.
|
|
* @param maxs The local positive bounding box distance.
|
|
* @param sequence The animation sequence to retrieve.
|
|
* Model_DefaultSize retrieves ideal moevement hull size.
|
|
* Model_CurrentSequence retrieves hull size of the current sequence.
|
|
* Values >= 0 will specify which sequence to retrieve size from.
|
|
*
|
|
* @return 1 on success, 0 on faillure.
|
|
*
|
|
* @error Invalid entity.
|
|
* Invalid model pointer.
|
|
*/
|
|
native GetModelBoundingBox(entity, Float:mins[3], Float:maxs[3], sequence = Model_DefaultSize);
|
|
|
|
/**
|
|
* Sets size to a model bounding box.
|
|
*
|
|
* @param entity The entity index to set the value on.
|
|
* @param sequence The sequence to apply.
|
|
* Model_DefaultSize sets size of ideal movement hull.
|
|
* Model_CurrentSequence sets size of the current sequence.
|
|
* Values >= 0 will specify which sequence to use.
|
|
*
|
|
* @return 1 on success, 0 on faillure.
|
|
*
|
|
* @error Invalid entity.
|
|
* Invalid model pointer.
|
|
*/
|
|
native SetModelBoundingBox(index, sequence = Model_DefaultSize);
|