* Replaced bad example in entities documentation. * Updated Lua documentation for vehicles/weapons to allow for auto generation. * Added Vector3 support to the Lua globals/locals class. * Fixed a bug with get_float in globals/locals returning an int instead of a float. * Fixed globals get_uint/set_uint using signed types for the return/parameter. * Added unsigned int helpers to the locals Lua class.
6.9 KiB
Table: stats
Table for manipulating GTA stats.
For stats that get prefixed by either MP0
or MP1
, you can use MPX
instead and the menu will resolve to the correct number automatically.
Functions (25)
get_character_index()
- Returns:
integer
: The current multiplayer character index (0 or 1).
Example Usage:
integer = stats.get_character_index()
get_bool(stat_hash)
-
Parameters:
stat_hash
(integer): the stat hash.
-
Returns:
boolean
: The value of the given stat.
Example Usage:
boolean = stats.get_bool(stat_hash)
get_bool(stat_name)
-
Parameters:
stat_name
(string): the stat name.
-
Returns:
boolean
: The value of the given stat.
Example Usage:
boolean = stats.get_bool(stat_name)
get_bool_masked(stat_hash, bit_index)
-
Parameters:
stat_hash
(integer): the stat hash.bit_index
(integer): bit index.
-
Returns:
boolean
: The value of the given stat.
Example Usage:
boolean = stats.get_bool_masked(stat_hash, bit_index)
get_bool_masked(stat_name, bit_index)
-
Parameters:
stat_name
(string): the stat name.bit_index
(integer): bit index.
-
Returns:
boolean
: The value of the given stat.
Example Usage:
boolean = stats.get_bool_masked(stat_name, bit_index)
get_float(stat_hash)
-
Parameters:
stat_hash
(integer): the stat hash.
-
Returns:
float
: The value of the given stat.
Example Usage:
float = stats.get_float(stat_hash)
get_float(stat_name)
-
Parameters:
stat_name
(string): the stat name.
-
Returns:
float
: The value of the given stat.
Example Usage:
float = stats.get_float(stat_name)
get_int(stat_hash)
-
Parameters:
stat_hash
(integer): the stat hash.
-
Returns:
integer
: The value of the given stat.
Example Usage:
integer = stats.get_int(stat_hash)
get_int(stat_name)
-
Parameters:
stat_name
(string): the stat name.
-
Returns:
integer
: The value of the given stat.
Example Usage:
integer = stats.get_int(stat_name)
get_masked_int(stat_hash, bit_start, bit_size)
-
Parameters:
stat_hash
(integer): the stat hash.bit_start
(integer): bit start.bit_size
(integer): bit size.
-
Returns:
integer
: The value of the given stat.
Example Usage:
integer = stats.get_masked_int(stat_hash, bit_start, bit_size)
get_masked_int(stat_name, bit_index, bit_size)
-
Parameters:
stat_name
(string): the stat name.bit_index
(integer): bit index.bit_size
(integer): bit size.
-
Returns:
integer
: The value of the given stat.
Example Usage:
integer = stats.get_masked_int(stat_name, bit_index, bit_size)
set_bool(stat_hash, new_value)
-
Parameters:
stat_hash
(integer): the stat hash.new_value
(boolean): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_bool(stat_hash, new_value)
set_bool(stat_name, new_value)
-
Parameters:
stat_name
(string): the stat name.new_value
(boolean): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_bool(stat_name, new_value)
set_bool_masked(stat_hash, new_value, bit_index)
-
Parameters:
stat_hash
(integer): the stat hash.new_value
(boolean): the new value for the stat.bit_index
(integer): bit_index.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_bool_masked(stat_hash, new_value, bit_index)
set_bool_masked(stat_name, new_value, bit_index)
-
Parameters:
stat_name
(string): the stat name.new_value
(boolean): the new value for the stat.bit_index
(integer): bit_index.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_bool_masked(stat_name, new_value, bit_index)
set_float(stat_hash, new_value)
-
Parameters:
stat_hash
(integer): the stat hash.new_value
(float): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_float(stat_hash, new_value)
set_float(stat_name, new_value)
-
Parameters:
stat_name
(string): the stat name.new_value
(float): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_float(stat_name, new_value)
set_int(stat_hash, new_value)
-
Parameters:
stat_hash
(integer): the stat hash.new_value
(integer): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_int(stat_hash, new_value)
set_int(stat_name, new_value)
-
Parameters:
stat_name
(string): the stat name.new_value
(integer): the new value for the stat.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_int(stat_name, new_value)
set_masked_int(stat_hash, new_value, bit_start, bit_size)
-
Parameters:
stat_hash
(integer): the stat hash.new_value
(integer): the new value for the stat.bit_start
(integer): bit_start.bit_size
(integer): bit_size.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_masked_int(stat_hash, new_value, bit_start, bit_size)
set_masked_int(stat_name, new_value, bit_start, bit_size)
-
Parameters:
stat_name
(string): the stat name.new_value
(integer): the new value for the stat.bit_start
(integer): bit_start.bit_size
(integer): bit_size.
-
Returns:
boolean
: True if succeeded.
Example Usage:
boolean = stats.set_masked_int(stat_name, new_value, bit_start, bit_size)
get_packed_stat_bool(index)
-
Parameters:
index
(int): packed stat's index
-
Returns:
boolean
: Value of the stat.
Example Usage:
boolean = stats.get_packed_stat_bool(index)
set_packed_stat_bool(index, value)
- Parameters:
index
(int): packed stat's index.value
(bool): value to set the packed stat to.
Example Usage:
stats.set_packed_stat_bool(index, value)
get_packed_stat_int(index)
-
Parameters:
index
(int): packed stat's index.
-
Returns:
int
: Value of the stat.
Example Usage:
int = stats.get_packed_stat_int(index)
set_packed_stat_int(index, value)
- Parameters:
index
(int): packed stat's index.value
(int): value to set the packed stat to.
Example Usage:
stats.set_packed_stat_int(index, value)