Player::call: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
No edit summary
Line 12: Line 12:
That's example will call event added on client side for player with ID 1337, disable regeneration health and send number current player health.
That's example will call event added on client side for player with ID 1337, disable regeneration health and send number current player health.


<div class="header" style="background-color: #D89191; color: #D65757; border: 1px solid #D65757;">
<div class="header" style="background-color: #AE4040; color: #FFFFFF; border: 2px solid #AE4040;">
<div style="margin: 10px 10px 10px 10px;"><b>Client-Side</b></div>
<div style="margin: 10px 10px 10px 10px;"><b>Client-Side</b></div>
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
Line 30: Line 30:




<div class="header" style="background-color: #A5B5C5; color: #5892D8; border: 1px solid #5892D8;">
<div class="header" style="background-color: #408DAE; color: #FFFFFF; border: 2px solid #408DAE;">
<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>
<div style="margin: 10px 10px 10px 10px;"><b>Server-Side</b></div>
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">

Revision as of 15:18, 4 May 2017

This function call added client-side event for selected player.

Syntax

void player.call(string eventName [, ...args]);

Required Arguments

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

Example

That's example will call event added on client side for player with ID 1337, disable regeneration health and send number current player health.

Client-Side
let disableRegeneration = (currentHealth) => { //currentHealth - value, what we send from server.
	mp.game.player.setHealthRechargeMultiplier(0); //Disable regeneration
	let text = `Regeneration disabled. Current health: ${currentHealth}`;
	mp.gui.execute(`insertMessageToChat(\`${text}\`)`); //Output text to default chatbox
};

mp.events.add(
	{
		`disablePlayerRegeneration`: disableRegeneration
	}
);


Server-Side
let player = mp.player.at(1337); //Get player by ID
if (!!player) {
	let playerHealth = player.health;
	player.call(`disablePlayerRegeneration`, playerHealth);
};

See Also