Players::call: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
m (Replaced HTML with template)
Line 5: Line 5:


==Syntax==
==Syntax==
<syntaxhighlight lang="javascript">
<pre>
mp.players.call(String eventName[, Array Arguments]);
mp.players.call(String eventName[, Array Arguments]);
mp.players.call(Array players, String eventName[, Array Arguments]);
mp.players.call(Array players, String eventName[, Array Arguments]);
</syntaxhighlight>  
</pre>  
 
===Required Arguments===
===Required Arguments===
*'''eventName:''' Event name, what will be called.
*'''eventName:''' Event name, what will be called.
Line 15: Line 16:
==Example==  
==Example==  
1. Trigger "disablePlayerRegeneration" event for everyone near new mp.Vector3(150, 100, 50).
1. Trigger "disablePlayerRegeneration" event for everyone near new mp.Vector3(150, 100, 50).
<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
{{ServersideCode|
<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>
<pre>
<syntaxhighlight lang="javascript" highlight="4">
const playersArray = mp.players.toArray().filter((player) => (player.dist(new mp.Vector3(150, 100, 50)) < 20));
const playersArray = mp.players.toArray().filter((player) => (player.dist(new mp.Vector3(150, 100, 50)) < 20));
mp.players.call(playersArray, "disablePlayerRegeneration");
mp.players.call(playersArray, "disablePlayerRegeneration");
</syntaxhighlight>
</pre>
</div>
}}




2. Trigger "disablePlayerRegeneration" event for everyone.
2. Trigger "disablePlayerRegeneration" event for everyone.
<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
{{ServersideCode|
<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>
<pre>
<syntaxhighlight lang="javascript" highlight="4">
mp.players.call("disablePlayerRegeneration");
mp.players.call("disablePlayerRegeneration");
</syntaxhighlight>
</pre>
</div>
}}




==See Also==
==See Also==
{{Player_block}}
{{Player_block}}

Revision as of 12:26, 26 October 2018

This function triggers an event for:

  • the whole server
  • specified players array


Syntax

mp.players.call(String eventName[, Array Arguments]);
mp.players.call(Array players, String eventName[, Array Arguments]);

Required Arguments

  • eventName: Event name, what will be called.
  • args: Any arguments, what should be sended to client. Supports entities, strings, numbers and booleans. (Objects and Arrays should be packed to JSON format.)

Example

1. Trigger "disablePlayerRegeneration" event for everyone near new mp.Vector3(150, 100, 50).

Server-Side
const playersArray = mp.players.toArray().filter((player) => (player.dist(new mp.Vector3(150, 100, 50)) < 20));
mp.players.call(playersArray, "disablePlayerRegeneration");


2. Trigger "disablePlayerRegeneration" event for everyone.

Server-Side
mp.players.call("disablePlayerRegeneration");


See Also