Peds::new

2019-05-30T07:41:56Z

MCtheBoss: Updated the page to represent the change in syntax, as well as provide the function for legacy syntax support.

==Syntax==
<syntaxhighlight lang="javascript">mp.peds.new(model, position, heading, dimension);</syntaxhighlight>
=== Required Arguments ===
*'''modelHash:''' Model hash
*'''position:''' Vector3 position
*'''heading:''' float
*'''dimension:''' int
===Return value===
*'''Ped handle or object'''

This function relies on the 'entityStreamIn' event to handle the Ped's streamInEvent. If you do not have this event in your script, you can find it below.

==Example==
{{ClientSide}}
<syntaxhighlight lang="javascript">
let Ped = mp.peds.new(mp.game.joaat('MP_F_Freemode_01'), new mp.Vector3( 100.0, -100.0, 25.0), 270.0, mp.players.local.dimension);
</syntaxhighlight>
== ==

==Legacy Syntax Variation==

If you would like to use the legacy syntax for mp.peds.new(), refer to the following function:
{{ClientSide}}
<syntaxhighlight lang="javascript">
mp.peds.newLegacy = (hash, position, heading, streamIn, dimension) =>
{
let ped = mp.peds.new(hash, position, heading, dimension);
ped.streamInHandler = streamIn;
return ped;
};
</syntaxhighlight>

For the above function to work, you must add the following 'entityStreamIn' event to your script:
{{ClientSide}}
<syntaxhighlight lang="javascript">
mp.events.add("entityStreamIn", (entity) =>
{
if(entity.streamInHandler)
{
entity.streamInHandler(entity);
}
});
</syntaxhighlight>

===Example===
{{ClientSide}}
<syntaxhighlight lang="javascript">
let Ped = mp.peds.newLegacy(mp.game.joaat(model), location, 0, (streamPed) => {
// Ped Streamed
streamPed.setAlpha(255);
streamPed.freezePosition(false);
streamPed.setInvincible(false);
streamPed.setProofs(false, false, false, false, false, false, false, false);
}, 0);
</syntaxhighlight>

==See also==
{{Ped_functions_c}}
[[Category:Clientside API]]

RAGE Multiplayer Wiki - User contributions [en]

Peds::new