Ped::Ped

Client-Side

Function

JavaScript

Creates a new clientside ped. Use Player API to control peds actions.

JavaScript Syntax

mp.peds.new(model, position, heading, dimension);

Parameters

• model: Hash (Ped Models)
• position: Vector3
• heading: Float
• dimension: Integer

Example

Client-Side

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
);

Legacy Syntax Variation

The previous syntax for this function allowed you to specify a "streamedIn" callback. This has been removed in favor of the EntityStreamIn event, but you can add this polyfill to your client script to enable the previous syntax:

Client-Side

mp.peds.newLegacy = (hash, position, heading, streamIn, dimension) => {
    let ped = mp.peds.new(hash, position, heading, dimension);
    ped.streamInHandler = streamIn;
    return ped;
};

mp.events.add("entityStreamIn", entity => {
   if (entity.streamInHandler) {
       entity.streamInHandler(entity);
   }
});

Server-Side

Function

JavaScript

Creates a new serverside static or dynamic ped.
Dynamic peds are synchronised/controlled by the player that your gamemode manually assigns and can be reassigned at any moment.
To control dynamic ped actions, use clientside Player API to control peds actions.

JavaScript Syntax

mp.peds.new(model, position,
{    
      dynamic: dynamic, 
      frozen: frozen,
      invincible: invincible
});

Parameters

• model: Hash (Ped Models)
• position: Vector3
• dynamic: Boolean: true - synced by controller, false - static
• frozen: Boolean
• invincible: Boolean

Example

Server-Side

let dynamicPed = mp.peds.new(mp.joaat('mp_m_freemode_01'), mp.players.at(0).position, {dynamic:true});
dynamicPed.controller = mp.players.at(0);

let staticPed = mp.peds.new(mp.joaat('player_zero'), mp.players.at(0).position,
{    
      dynamic: false, // still server-side but not sync'ed anymore
      frozen: true,
      invincible: true
});

See Also

• Functions
  • Ped::Ped
• Properties
  • Ped::controller
  • Entity::id
  • Entity::type
  • Entity::position