@amxts/core 0.1.0

package/amxmodx/base/include/cvars.inc

@@ -0,0 +1,547 @@
+// 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 _cvars_included
+	#endinput
+#endif
+#define _cvars_included
+
+/**
+ * CVAR flags for create_cvar() and register_cvar().
+ */
+#define FCVAR_NONE              0   // No special behavior
+#define FCVAR_ARCHIVE           1   // Cvar will be saved to vars.rc Set to cause it to be saved to vars.rc
+#define FCVAR_USERINFO          2   // Cvar changes the client's info string
+#define FCVAR_SERVER            4   // Clients get notified when cvar value is changed
+#define FCVAR_EXTDLL            8   // Defined by an external DLL
+#define FCVAR_CLIENTDLL         16  // Defined by the client DLL
+#define FCVAR_PROTECTED         32  // Cvar value is masked from outside access, should be used for sensitive cvars like passwords
+#define FCVAR_SPONLY            64  // Cvar can't be changed by clients connected to a multiplayer server
+#define FCVAR_PRINTABLEONLY     128 // The cvar string value can not contain unprintable characters
+#define FCVAR_UNLOGGED          256 // If the cvar is FCVAR_SERVER, don't log changes to a file/the console
+#define FCVAR_NOEXTRAWHITEPACE  512 // Automatically strips trailing/leading white space from the string value
+
+/**
+ * Cvar bound constants used with [get|set]_pcvar_bounds().
+ */
+enum CvarBounds
+{
+	CvarBound_Upper = 0,
+	CvarBound_Lower
+};
+
+/**
+ * Creates a new cvar for the engine.
+ *
+ * @note This has the same effect as register_cvar() but provides more options.
+ * @note For a list of possible cvar flags see FCVAR_* constants above.
+ * @note If an already existing cvar is registered it will not be duplicated.
+ *       The default value is only set when the cvar is registered for the very
+ *       first time since the server was started. Cvar bounds are overwritten
+ *       by the create_cvar() call just as if they were re-set using
+ *       set_pcvar_bounds().
+ * @note The returned cvar pointer should be used with the get_pcvar_* and
+ *       set_pcvar_* set of functions.
+ *
+ * @param name          Cvar name
+ * @param string        Default cvar value
+ * @param flags         Optional bitsum of flags specifying cvar behavior
+ * @param description   Optional description of the cvar
+ * @param has_min       Optional boolean that specifies if the cvar has a
+ *                      minimum value
+ * @param min_val       Minimum floating point value
+ * @param has_max       Optional boolean that specifies if the cvar has a
+ *                      maximum value
+ * @param max_val       Maximum floating point value
+ *
+ * @return              Unique cvar pointer
+ * @error               If invalid bounds are provided (min_val > max_val or
+ *                      vice versa), an error will be thrown.
+ */
+native create_cvar(const name[], const string[], flags = FCVAR_NONE, const description[] = "", bool:has_min = false, Float:min_val = 0.0, bool:has_max = false, Float:max_val = 0.0);
+
+/**
+ * Registers a new cvar for the engine.
+ *
+ * @note Deprecated. Consider to use create_cvar for more options.
+ * @note For a list of possible cvar flags see FCVAR_* constants in cvars.inc
+ * @note If an already existing cvar is registered it will not be duplicated.
+ *       The default value is only set when the cvar is registered for the very
+ *       first time since the server was started.
+ * @note The returned cvar pointer should be used with the get_pcvar_* and
+ *       set_pcvar_* set of functions.
+ *
+ * @param name      Cvar name
+ * @param string    Default cvar value
+ * @param flags     Optional bitsum of flags specifying cvar behavior
+ * @param fvalue    Unused
+ *
+ * @return          Unique cvar pointer
+ */
+native register_cvar(const name[], const string[], flags = FCVAR_NONE, Float:fvalue = 0.0);
+
+/**
+ * Returns if a cvar is registered on the server.
+ *
+ * @param cvar      Cvar name to check
+ *
+ * @return          1 if the cvar exists, 0 otherwise
+ */
+native cvar_exists(const cvar[]);
+
+/**
+ * Returns the cvar pointer of the specified cvar.
+ *
+ * @note A pointer is also returned by register_cvar() and create_cvar().
+ *       Plugins can (and should) retrieve and use pointers for already existing
+ *       mod cvars.
+ *
+ * @param cvar      Cvar name to find
+ *
+ * @return          Cvar pointer on success, 0 if cvar was not found
+ */
+native get_cvar_pointer(const cvar[]);
+
+/**
+ * Creates a hook for when a cvar's value is changed.
+ *
+ * @note Changing the cvar value from within this forward can lead to infinite
+ *       recursion and should be avoided.
+ * @note The callback will be called in the following manner:
+ *
+ * public cvar_change_callback(pcvar, const old_value[], const new_value[])
+ *
+ *   pcvar         - Pointer to cvar that was changed
+ *   old_value     - Buffer containing the previous value of the cvar
+ *   new_value     - Buffer containing the new value of the cvar
+ *
+ * The return value is ignored
+ *
+ * @param pcvar     Pointer to cvar
+ * @param callback  Name of callback function
+ *
+ * @return          Callback handle that can be used with
+ *                  [disable|enable]_cvar_hook
+ * @error           If an invalid cvar pointer or callback function is provided,
+ *                  an error will be thrown.
+ */
+native cvarhook:hook_cvar_change(pcvar, const callback[]);
+
+/**
+ * Disables a cvar hook, stopping it from being called.
+ *
+ * @note Use the handle returned by hook_cvar_change as the parameter here.
+ *
+ * @param handle    Forward to disable
+ * @error           If an invalid hook handle is provided, an error will be
+ *                  thrown.
+ */
+native disable_cvar_hook(cvarhook:handle);
+
+/**
+ * Enables a cvar hook, restoring it to being called.
+ *
+ * @note Use the handle returned by hook_cvar_change as the parameter here.
+ *
+ * @param handle    Forward to enable
+ * @error           If an invalid hook handle is provided, an error will be
+ *                  thrown.
+ */
+native enable_cvar_hook(cvarhook:handle);
+
+/**
+ * Returns flags of a cvar. The cvar is accessed by name.
+ *
+ * @note For a list of possible flags see the FCVAR_* constants in amxconst.inc
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent get_pcvar_flags() function should be used
+ *       instead.
+ *
+ * @param cvar  Cvar name to retrieve flags from
+ *
+ * @return      Flag value
+ */
+native get_cvar_flags(const cvar[]);
+
+/**
+ * Sets specified flags to a cvar. The cvar is accessed by name.
+ *
+ * @note Not permitted for the "amx_version", "amxmodx_version", "fun_version"
+ *       and "sv_cheats" cvars.
+ * @note For a list of possible flags see the FCVAR_* constants in amxconst.inc
+ * @note This function just adds the flags using a bitwise-or operation. After
+ *       it has run the flags may not exactly equal the specified bitflag sum.
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent set_pcvar_flags() function should be used
+ *       instead.
+ *
+ * @param cvar      Cvar name to remove flags from
+ * @param flags     Bitflag sum of flags to set
+ *
+ * @return          1 on success, 0 if cvar does not exist or is not permitted
+ */
+native set_cvar_flags(const cvar[], flags);
+
+/**
+ * Removes specified flags from a cvar. The cvar is accessed by name.
+ *
+ * @note Not permitted for the "amx_version", "amxmodx_version", "fun_version"
+ *       and "sv_cheats" cvars.
+ * @note For a list of possible flags see the FCVAR_* constants in amxconst.inc
+ * @note This function removes the flags using a bitwise-and operation.
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the set_pcvar_flags() function should be used instead.
+ *
+ * @param cvar      Cvar name to remove flags from
+ * @param flags     Bitflag sum of flags to remove
+ *
+ * @return          1 on success, 0 if cvar does not exist or is not permitted
+ */
+native remove_cvar_flags(const cvar[], flags=-1);
+
+/**
+ * Gets a string value from a cvar. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent get_pcvar_string() function should be used
+ *       instead.
+ *
+ * @param cvar      Cvar name to retrieve value from
+ * @param output    Buffer to copy cvar value to
+ * @param iLen      Maximum size of the buffer
+ *
+ * @return          Number of cells written to buffer.
+ */
+native get_cvar_string(const cvarname[], output[], iLen);
+
+/**
+ * Sets a cvar to a given string value. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent set_pcvar_string() function should be used
+ *       instead.
+ *
+ * @param cvar      Cvar name to set value of
+ * @param value     Value to set cvar to
+ *
+ * @noreturn
+ */
+native set_cvar_string(const cvar[], const value[]);
+
+/**
+ * Returns a floating value from a cvar. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent get_pcvar_float() function should be used
+ *       instead.
+ *
+ * @param cvarname  Cvar name to retrieve value from
+ *
+ * @return          Cvar value, converted to float
+ */
+native Float:get_cvar_float(const cvarname[]);
+
+/**
+ * Sets a cvar to a given float value. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent set_pcvar_float() function should be used
+ *       instead.
+ *
+ * @param cvar      Cvar name to set value of
+ * @param value     Value to set cvar to
+ *
+ * @noreturn
+ */
+native set_cvar_float(const cvar[], Float:value);
+
+/**
+ * Returns an integer value from a cvar. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent get_pcvar_num() function should be used
+ *       instead.
+ *
+ * @param cvarname  Cvar name to retrieve value from
+ *
+ * @return          Cvar value, converted to int
+ */
+native get_cvar_num(const cvarname[]);
+
+/**
+ * Sets a cvar to a given integer value. The cvar is accessed by name.
+ *
+ * @note Accessing a Cvar by name is slower than direct pointer access, which is
+ *       why the otherwise equivalent set_pcvar_num() function should be used
+ *       instead.
+ *
+ * @param cvar      Cvar name to set value of
+ * @param value     Value to set cvar to
+ *
+ * @noreturn
+ */
+native set_cvar_num(const cvarname[], value);
+
+/**
+ * Returns flags of a cvar via direct pointer access.
+ *
+ * @note For a list of possible flags see the FCVAR_* constants in amxconst.inc
+ *
+ * @param pcvar     Pointer to cvar to retrieve flags from
+ *
+ * @return          1 on success, 0 if cvar pointer is invalid
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native get_pcvar_flags(pcvar);
+
+/**
+ * Sets specified flags to a cvar via direct pointer access.
+ *
+ * @note For a list of possible flags see the FCVAR_* constants in amxconst.inc
+ * @note This function directly sets the provided bitflag, unlike set_cvar_flags
+ *       which adds them using a bitwise OR.
+ *
+ * @param pcvar     Pointer to cvar to set flags of
+ * @param flags     Bitflag sum of flags to set
+ *
+ * @return          1 on success, 0 if cvar does not exist or is not permitted
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native set_pcvar_flags(pcvar, flags);
+
+/**
+ * Returns an integer value from a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to retrieve value from
+ *
+ * @return          Cvar value, converted to int
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native get_pcvar_num(pcvar);
+
+/**
+ * Returns an boolean value from a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to retrieve value from
+ *
+ * @return          Cvar value, converted to bool
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native bool:get_pcvar_bool(pcvar);
+
+/**
+ * Sets an integer value to a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to set value of
+ * @param num       Value to set cvar to
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native set_pcvar_num(pcvar, num);
+
+/**
+ * Sets a boolean value to a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to set value of
+ * @param num       Value to set cvar to
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native set_pcvar_bool(pcvar, bool:num);
+
+/**
+ * Returns a float value from a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to retrieve value from
+ *
+ * @return          Cvar value, converted to float
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native Float:get_pcvar_float(pcvar);
+
+/**
+ * Sets a float value to a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to set value of
+ * @param num       Value to set cvar to
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native set_pcvar_float(pcvar, Float:num);
+
+/**
+ * Returns a string value from a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to retrieve value from
+ * @param string    Buffer to copy cvar value to
+ * @param maxlen    Maximum size of the buffer
+ *
+ * @return          Number of cells written to buffer.
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native get_pcvar_string(pcvar, string[], maxlen);
+
+/**
+ * Sets a string value to a cvar via direct pointer access.
+ *
+ * @param pcvar     Pointer to cvar to retrieve value from
+ * @param string    Value to set cvar to
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer is provided, an error will be
+ *                  thrown.
+ */
+native set_pcvar_string(pcvar, const string[]);
+
+/**
+ * Retrieves the specified value boundary of a cvar.
+ *
+ * @param pcvar     Pointer to cvar
+ * @param type      Type of boundary to retrieve
+ * @param value     Variable to store the specified boundary to
+ *
+ * @return          True if the cvar has a boundary set, false otherwise
+ * @error           If an invalid cvar pointer or boundary type is provided,
+ *                  an error will be thrown.
+ */
+native bool:get_pcvar_bounds(pcvar, CvarBounds:type, &Float:value);
+
+/**
+ * Sets the specified boundary of a cvar.
+ *
+ * @param pcvar     Pointer to cvar
+ * @param type      Type of boundary to set
+ * @param set       If true the cvar boundary will be set, otherwise it will be
+ *                  removed (value is ignored)
+ * @param value     Floating point value to use as the boundary
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer or boundary type is provided, an
+ *                  error will be thrown.
+ */
+native set_pcvar_bounds(pcvar, CvarBounds:type, bool:set, Float:value = 0.0);
+
+/**
+ * Binds a cvar's integer value to a global variable. The variable will then
+ * always contain the current cvar value as it is automatically kept up to date.
+ *
+ * @note The variable *has* to be a global or a static variable. Local variables
+ *       created within functions can not be used for technical reasons.
+ * @note Variables can not be bound to multiple cvars.
+ *
+ * @param pcvar     Pointer to cvar
+ * @param var       Global variable to keep updated
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer or variable is provided, an error
+ *                  will be thrown.
+ */
+native bind_pcvar_num(pcvar, &any:var);
+
+/**
+ * Binds a cvar's float value to a global variable. The variable will then
+ * always contain the current cvar value as it is automatically kept up to date.
+ *
+ * @note The variable *has* to be a global or a static variable. Local variables
+ *       created within functions can not be used for technical reasons.
+ * @note Variables can not be bound to multiple cvars.
+ *
+ * @param pcvar     Pointer to cvar
+ * @param var       Global variable to keep updated
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer or variable is provided, an error
+ *                  will be thrown.
+ */
+native bind_pcvar_float(pcvar, &Float:var);
+
+/**
+ * Binds a cvar's string value to a global array. The array will then
+ * always contain the current cvar value as it is automatically kept up to date.
+ *
+ * @note The array *has* to be a global or a static array. Local arrays
+ *       created within functions can not be used for technical reasons.
+ * @note Arrays can not be bound to multiple cvars.
+ *
+ * @param pcvar     Pointer to cvar
+ * @param var       Global array to keep updated
+ * @param varlen    Maximum length of string array
+ *
+ * @noreturn
+ * @error           If an invalid cvar pointer or variable is provided, an error
+ *                  will be thrown.
+ */
+native bind_pcvar_string(pcvar, any:var[], varlen);
+
+/**
+ * Returns the number of plugin-registered cvars.
+ *
+ * @return  Number of registered cvars
+ */
+native get_plugins_cvarsnum();
+
+/**
+ * Retrieves information about a plugin-registered cvar via iterative access.
+ *
+ * @note The returned cvar pointer should be used with the get_pcvar_* and
+ *       set_pcvar_* set of functions.
+ * @note The cvar index does not equal the cvar pointer. It is the internal
+ *       AMXX id of a cvar, incremented for each registered cvar.
+ *
+ * @param num           Index to retrieve
+ * @param name          Buffer to copy cvar name to
+ * @param namelen       Maximum buffer size
+ * @param flags         Variable to store cvar flags to
+ * @param plugin_id     Variable to store id of the registering plugin to
+ * @param pcvar_handle  Variable to store cvar pointer to
+ * @param description   Variable to store cvar description to
+ * @param desc_len      Maximum length of string buffer
+ *
+ * @return              1 on success, 0 if index is invalid
+ */
+native get_plugins_cvar(num, name[], namelen, &flags = 0, &plugin_id = 0, &pcvar_handle = 0, description[] = "", desc_len = 0);
+
+/**
+ * Dispatches a client cvar query, allowing the plugin to query for its value on
+ * the client.
+ *
+ * @note The callback will be called in the following manner:
+ *
+ * public cvar_query_callback(id, const cvar[], const value[], const param[])
+ *
+ *   id      - Client index
+ *   cvar    - Cvar queried
+ *   value   - Cvar value on the client
+ *   param   - Optional extra data
+ *
+ * @param id            Client index
+ * @param cvar          Cvar to query
+ * @param resultFunc    Callback function
+ * @param paramlen      Size of extra data
+ * @param params        Extra data to pass through to callback
+ *
+ * @noreturn
+ * @error               If the client index is not within the range of 1 to
+ *                      MaxClients, the client is not connected, the callback
+ *                      function is invalid or the querying process encounters
+ *                      a problem, an error will be thrown.
+ */
+native query_client_cvar(id, const cvar[], const resultFunc[], paramlen = 0, const params[] = "");

package/amxmodx/base/include/datapack.inc

@@ -0,0 +1,161 @@
+// 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 _datapack_included
+	#endinput
+#endif
+#define _datapack_included
+
+/**
+ * Datapack tag declaration
+ *
+ * @note Datapacks provide a way to store and move around arbitrary amounts (and
+ *       types) of data in AMX Mox X. Data is packed into a single cell value -
+ *       the DataPack handle. This handle can be passed around more easily, can
+ *       be returned by functions and can simulate advanced concepts like string
+ *       consummation.
+ * @note Plugins are responsible for freeing all datapack handles they acquire.
+ *       Failing to free handles will result in the plugin and AMXX leaking
+ *       memory.
+ */
+enum DataPack
+{
+	Invalid_DataPack = 0
+};
+
+/**
+ * Creates a new datapack.
+ *
+ * @return  New datapack handle, which must be freed via DestroyDataPack().
+ */
+native DataPack:CreateDataPack();
+
+/**
+ * Packs a cell value into a datapack.
+ *
+ * @param pack      Datapack handle
+ * @param cell      Cell value to pack
+ *
+ * @noreturn
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native WritePackCell(DataPack:pack, any:cell);
+
+/**
+ * Packs a float value into a datapack.
+ *
+ * @param pack      Datapack handle
+ * @param val       Float value to pack
+ *
+ * @noreturn
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native WritePackFloat(DataPack:pack, Float:val);
+
+/**
+ * Packs a string into a datapack.
+ *
+ * @param pack      Datapack handle
+ * @param str       String to pack
+ *
+ * @return          Length of copied string
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native WritePackString(DataPack:pack, const str[]);
+
+/**
+ * Reads a cell from a Datapack.
+ *
+ * @param pack      Datapack handle
+ *
+ * @return          Cell value
+ * @error           If an invalid handle is provided, or not enough data is left
+ *                  in the datapack, an error will be thrown.
+ */
+native any:ReadPackCell(DataPack:pack);
+
+/**
+ * Reads a float from a datapack.
+ *
+ * @param pack      Datapack handle
+ *
+ * @return          Float value
+ * @error           If an invalid handle is provided, or not enough data is left
+ *                  in the datapack, an error will be thrown.
+ */
+native Float:ReadPackFloat(DataPack:pack);
+
+/**
+ * Reads a string from a Datapack.
+ *
+ * @param pack      Datapack handle
+ * @param buffer    Buffer to copy string to
+ * @param maxlen    Maximum size of buffer
+ *
+ * @return          Number of cells written to buffer
+ * @error           If an invalid handle is provided, or not enough data is left
+ *                  in the datapack, an error will be thrown.
+ */
+native ReadPackString(DataPack:pack, buffer[], maxlen);
+
+/**
+ * Resets the datapack read/write position to the start.
+ *
+ * @param pack      Datapack handle
+ * @param clear     If true, clears the contained data
+ *
+ * @noreturn
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native ResetPack(DataPack:pack, bool:clear = false);
+
+/**
+ * Returns the datapack read/write position.
+ *
+ * @param pack      Datapack handle
+ *
+ * @return          Position in the datapack, only usable with calls to SetPackPosition
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native DataPackPos:GetPackPosition(DataPack:pack);
+
+/**
+ * Sets the datapack read/write position.
+ *
+ * @note This should only ever be used with (known to be valid) positions
+ *       returned by GetPackPosition(). It is not possible for plugins to safely
+ *       compute datapack positions.
+ *
+ * @param pack      Datapack handle
+ * @param position  New position to set
+ *
+ * @noreturn
+ * @error           If an invalid handle is provided, or the new position is
+ *                  out of datapack bounds, an error will be thrown.
+ */
+native SetPackPosition(DataPack:pack, DataPackPos:position);
+
+/**
+ * Returns if the datapack has reached its end and no more data can be read.
+ *
+ * @param pack      Datapack handle
+ *
+ * @return          True if datapack has reached the end, false otherwise
+ * @error           If an invalid handle is provided, an error will be thrown.
+ */
+native bool:IsPackEnded(DataPack:pack);
+
+/**
+ * Destroys the datapack and frees its memory.
+ *
+ * @param pack      Datapack handle
+ *
+ * @return          True if disposed, false otherwise
+ */
+native DestroyDataPack(&DataPack:pack);