diff --git a/content/docs/scripting-reference/runtimes/lua/functions/TriggerClientEvent.md b/content/docs/scripting-reference/runtimes/lua/functions/TriggerClientEvent.md index b2fd75090..3dedb3eb5 100644 --- a/content/docs/scripting-reference/runtimes/lua/functions/TriggerClientEvent.md +++ b/content/docs/scripting-reference/runtimes/lua/functions/TriggerClientEvent.md @@ -8,12 +8,12 @@ Syntax ------ ```lua -TriggerClientEvent(string eventName, int playerId[, ...]) +TriggerClientEvent(string eventName, int or array playerIds[, ...]) ``` ### Required arguments - **eventName**: A string representing the event name to call on the client. -- **playerId**: The ID of the player to call the event for. Specify -1 for all clients. +- **playerIds**: The ID of the player to call the event for. Specify -1 for all clients or an array for specific IDs. ### Optional arguments - **...**: Any additional data that should be passed along. @@ -21,6 +21,7 @@ TriggerClientEvent(string eventName, int playerId[, ...]) Examples -------- +### Specific Player ID -- CLIENT Don't forget to [RegisterNetEvent][]! @@ -31,6 +32,20 @@ end) ``` -- SERVER ```lua +local playerId = 1 TriggerClientEvent('eventName', playerId, 'Hello world!') ``` [RegisterNetEvent]: /docs/scripting-reference/runtimes/lua/functions/RegisterNetEvent/ + +### Multiple Players ID + +To call an event for multiple players, you need to include their IDs in an array. Here’s an example in Lua: + +```lua +-- Define the player IDs to target +local playerIds = {1, 3, 5} -- Replace with actual player IDs + +-- Trigger the event for the specified players +TriggerClientEvent('eventName', playerIds, { example = 0 }) +``` +This format ensures that the event is called for each player specified in the `playerIds` array.