View source for Events::addDataHandler

This Function is used to alert client-side with entity's data change for a specified variable

<br>{{ClientsideCsJsFunction}}

{{CSharpContainer|
<pre>
RAGE.Events.AddDataHandler(string name, OnEntityDataChangeDelegate handler);
</pre>
}}

{{JSContainer|
<pre>
mp.events.addDataHandler(key, handlerFunction);
</pre>
{{Parameters}}
* '''key''': {{RageType|String}} - Shared data key's name.
* '''handlerFunction''': Handler function with parameters:
** '''entity''': {{RageType|Entity}} - The [[:Category:Entity API|entity]] that had the data change.
** '''value''': {{RageType|Any}} - The new value of the data key.
** '''oldValue''': {{RageType|Any}} - The old value of the data key.

{{Example}}
<pre>
/*
    Handles testVar change.
    Do "player.data.testVar = 1234;" on server-side to trigger this.
*/

mp.events.addDataHandler("testVar", (entity, value, oldValue) => {
    mp.gui.chat.push(`testVar changed to ${value} on entity ${entity.handle}.`);
});
</pre>

{{Example}}
This example sets nickname for player and triggers players' clientside data handler

{{ServersideCode|
<pre>
mp.events.addCommand('setNick', (player, nickname) => {
  player.setVariable('oldNick', player.name);
  player.name = nickname;
  player.setVariable('newNick', nickname);
});
</pre>
}}


{{ClientsideCode|
<pre>
mp.events.addDataHandler('newNick', function (entity, value, oldValue) {
  if (entity.type === 'player') mp.gui.chat.push(`${player.getVariable('oldNick')} has changed nickname to ${value}`)
})
</pre>
}}
}}

==See Also==
* [[EntityDataChangeByKey]]

{{Event_functions}}

[[Category:Entity API]]
[[Category:Shared Property]]
[[Category:Client-side Function]]