TmpMenu/docs/lua/tables/stats.md
gir489 d2a7ff8ba4 feat(lua): added weapon and vehicle cache bindings (#2477)
* 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.
2023-12-05 09:58:35 +01:00

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)