Object::Object: Difference between revisions

From RAGE Multiplayer Wiki
No edit summary
(alpha updated)
 
(19 intermediate revisions by 10 users not shown)
Line 1: Line 1:
Creates new object in to the world.
{{SharedFunctionJS}}


=Syntax=
Creates a new Object.
<syntaxhighlight lang="javascript">
mp.objects.new(model, Vector3 position, Vector3 rotation);
*'''[https://cdn.rage.mp/public/odb/index.html Objects gallery]'''
</syntaxhighlight>


== '''Required Arguments:''' ==


*'''model hash''': <code>mp.joaat('<model_name>')</code>
{{JSContainer|
*'''position''': <b><font color='green'>Vector3</font></b>
==Syntax==
*'''rotation''': <b><font color='green'>Vector3</font></b>
{{SharedCode|
<pre>
mp.objects.new(model, position,
{
    rotation: rotation,
    alpha: alpha,
    dimension: dimension
});
</pre>
}}


=Example=
==Required Arguments==
*'''model''': {{RageType|Hash}}
*'''position''': {{RageType|Vector3}}
*'''rotation''': {{RageType|Vector3}}
*'''alpha''': {{RageType|Number}}: The object's transparency.
*'''dimension''': {{RageType|Number}}


<syntaxhighlight lang="javascript">
==Example==
let pos = player.position; // Returns Vector3 object
 
    pos.y += 1
<pre>
     pos.z -= 1
mp.events.addCommand('flag', (player) => {
    let object = mp.objects.new(mp.joaat('p_stinger_03'), pos , [0, 0, 0]); //Creates a stinger beside the player
     mp.objects.new('apa_prop_flag_portugal', player.position,
</syntaxhighlight>
        {
            rotation: player.rotation,
            alpha: 255,
            dimension: player.dimension
        });
});
 
//Following this code, you'll create a portuguese flag (apa_prop_flag_portugal) at the players position, facing the same way the player is facing, with no transparency (255 on alpha) and at the same dimension the player is.
</pre>
}}
[[Category:Object API]]
[[Category:Shared Function]]
[[Category:TODO: Example]]

Latest revision as of 12:52, 1 February 2023

Shared
Function

 JavaScript


Creates a new Object.


JavaScript Syntax

Syntax

Shared
mp.objects.new(model, position,
{
    rotation: rotation,
    alpha: alpha,
    dimension: dimension
});

Required Arguments

  • model: Hash
  • position: Vector3
  • rotation: Vector3
  • alpha: Number: The object's transparency.
  • dimension: Number

Example

mp.events.addCommand('flag', (player) => {
    mp.objects.new('apa_prop_flag_portugal', player.position,
        {
            rotation: player.rotation,
            alpha: 255,
            dimension: player.dimension
        });
});

//Following this code, you'll create a portuguese flag (apa_prop_flag_portugal) at the players position, facing the same way the player is facing, with no transparency (255 on alpha) and at the same dimension the player is.