5d538cf53c
* fix(anticheat): rewrite AC bypass again (the old one isn't detected but this is cleaner) * fix(chat): some chat tweaks * fix(anticheat): fix memory leak * feat(lua): add is_player_friend * fix(protections): fix possible false positives with the vehicle task mismatch protection * feat(protections): add debug logs to trace false positive * fix(spam): add some more stuff
161 lines
3.7 KiB
Markdown
161 lines
3.7 KiB
Markdown
# Table: network
|
|
|
|
Table containing helper functions for network related features.
|
|
|
|
## Functions (12)
|
|
|
|
### `trigger_script_event(bitset, _args)`
|
|
|
|
Call trigger_script_event (TSE)
|
|
|
|
- **Parameters:**
|
|
- `bitset` (integer)
|
|
- `_args` (table)
|
|
|
|
**Example Usage:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
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:**
|
|
```lua
|
|
network.send_chat_message(msg, team_only)
|
|
```
|
|
|
|
|