imported>Shr0x в 11:09, 10 ноября 2024

2024-11-10T11:09:15Z

Новая страница

{{ServersideJsFunction}}
{{JSContainer|

==Summary==
The `mp.players.call` function triggers a specified event on the client-side for either all players or a defined array of players. It is useful for synchronizing client events across multiple players on the server.

===Required Params===
*'''eventName:''' {{RageType|string}} — The name of the client event to trigger.
*'''args:''' {{RageType|Array}} — Arguments to send with the event. Supports strings, numbers, booleans, entities; objects and arrays should be in JSON format.

===Syntax===
<syntaxhighlight lang="javascript">
mp.players.call(eventName[, args]);
mp.players.call(playersArray, eventName[, args]);
</syntaxhighlight>

==Examples==
1. **Trigger an event for nearby players**: This example triggers the `"disablePlayerRegeneration"` event for all players within 20 units of a position `(150, 100, 50)`.

<syntaxhighlight lang="javascript">
const playersArray = mp.players.toArray().filter((player) =>
player.dist(new mp.Vector3(150, 100, 50)) < 20
);
mp.players.call(playersArray, "disablePlayerRegeneration");
</syntaxhighlight>

2. **Trigger an event for all players**: This example triggers the `"disablePlayerRegeneration"` event for everyone on the server.

<syntaxhighlight lang="javascript">
mp.players.call("disablePlayerRegeneration");
</syntaxhighlight>

}}
==See also==
{{Player_block}}
[[Category:Serverside API]]

Players::call - История изменений

imported>Shr0x в 11:09, 10 ноября 2024