This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
YimMenu/docs/lua/tables/network.md

4.0 KiB

Table: network

Table containing helper functions for network related features.

Functions (13)

trigger_script_event(bitset, _args)

Call trigger_script_event (TSE)

  • Parameters:
    • bitset (integer)
    • _args (table)

Example Usage:

network.trigger_script_event(bitset, _args)

give_pickup_rewards(player, reward)

Give the given pickup reward to the given player.

  • Parameters:
    • player (integer): Index of the player.
    • reward (integer): Index of the reward pickup.

Example Usage:

network.give_pickup_rewards(player, reward)

set_player_coords(player_idx, x, y, z)

Teleport the given player to the given position.

  • Parameters:
    • player_idx (integer): Index of the player.
    • x (float): New x position.
    • y (float): New y position.
    • z (float): New z position.

Example Usage:

network.set_player_coords(player_idx, x, y, z)

set_all_player_coords(x, y, z)

Teleport all players to the given position.

  • Parameters:
    • x (float): New x position.
    • y (float): New y position.
    • z (float): New z position.

Example Usage:

network.set_all_player_coords(x, y, z)

get_selected_player()

  • Returns:
    • integer: Returns the index of the currently selected player in the GUI.

Example Usage:

integer = network.get_selected_player()

get_selected_database_player_rockstar_id()

  • Returns:
    • integer: Returns the rockstar id of the currently selected player in the GUI.

Example Usage:

integer = network.get_selected_database_player_rockstar_id()

flag_player_as_modder(player_idx, reason, custom_reason)

Flags the given player as a modder in our local database.

  • Parameters:
    • player_idx (integer): Index of the player.
    • reason (Infraction): Reason why the player is flagged as a modder, if the infraction is CUSTOM_REASON, then the custom_reason string is added in the local database. For a full list of the possible infraction reasons to use, please check the infraction page.
    • custom_reason (string): Optional, required only when the infraction is CUSTOM_REASON. The custom reason why the player is flagged as a modder.

Example Usage:

network.flag_player_as_modder(player_idx, reason, custom_reason)

is_player_flagged_as_modder(player_idx)

  • Parameters:

    • player_idx (integer): Index of the player.
  • Returns:

    • boolean: Returns true if the given player is flagged as a modder.

Example Usage:

boolean = network.is_player_flagged_as_modder(player_idx)

is_player_friend(player_idx)

  • Parameters:

    • player_idx (integer): Index of the player.
  • Returns:

    • boolean: Returns true if the given player is a friend.

Example Usage:

boolean = network.is_player_friend(player_idx)

get_flagged_modder_reason(player_idx)

  • Parameters:

    • player_idx (integer): Index of the player.
  • Returns:

    • string: Returns a string which contains the reason(s) why the player is flagged as a modder.

Example Usage:

string = network.get_flagged_modder_reason(player_idx)

force_script_host(script_name)

Try to force ourself to be host for the given GTA Script.

  • Parameters:
    • script_name (string): Name of the script

Example Usage:

network.force_script_host(script_name)

send_chat_message(msg, team_only)

Sends a message to the in game chat.

  • Parameters:
    • msg (string): Message to be sent.
    • team_only (boolean): Should be true if the msg should only be sent to our team.

Example Usage:

network.send_chat_message(msg, team_only)

send_chat_message_to_player(player_idx, msg)

Sends a chat message to the specified player. Other players would not be able to see the message

  • Parameters:
    • player_idx (integer): Index of the player.
    • msg (string): Message to be sent.

Example Usage:

network.send_chat_message_to_player(player_idx, msg)