Entity::setVariable: Difference between revisions

From RAGE Multiplayer Wiki
(Cleaned up)
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__
__TOC__
Set custom data to an entity.


Set custom data to an entity. These variables are visible only server side.<br>
See [[Entity::setVariables]] to set multiple variables in bulk.
<br><br>
{{ServersideJsFunction}}
{{JSContainer|
==Syntax==
==Syntax==
<pre>
<pre>
Line 10: Line 16:
entity.setVariable({name1: value1, name2: value2});
entity.setVariable({name1: value1, name2: value2});
</pre>
</pre>
=== Required Arguments ===
*{{Required}}'''entity''': {{RageType|Object}}
*{{Required}}'''name''': {{RageType|String}}
*{{Required}}'''value''': {{RageType|Any}}


==Example==
==Example==
This binds the vehicle to the player
This binds the vehicle to the player
<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>
<pre>
let veh = mp.vehicles.new(vehName, player.position);
let veh = mp.vehicles.new(vehName, player.position);
player.setVariable('veh', veh);
player.setVariable('veh', veh);
</pre>
</pre>
</div>
}}


<br>
}}
This is an example of setting multiple variables to a player.
<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>
<pre>
player.setVariable({
  name: 'Player',
  age: 20
});
</pre>
</div>


== See More ==
== See More ==
{{Entity_functions}}
{{Entity_functions}}
[[Category:Entity API]]
[[Category:Server-side Function]]

Latest revision as of 17:15, 12 September 2024

Set custom data to an entity. These variables are visible only server side.
See Entity::setVariables to set multiple variables in bulk.

Server-Side
Function

 JavaScript



JavaScript Syntax

Syntax

// To set one variable at a time
entity.setVariable(name, value);

// To set multiple variables at a time.
entity.setVariable({name1: value1, name2: value2});

Required Arguments

  • *entity: Object
  • *name: String
  • *value: Any

Example

This binds the vehicle to the player

Server-Side
let veh = mp.vehicles.new(vehName, player.position);
player.setVariable('veh', veh);



See More