Objects and peds

Server objects and peds participate in visibility streaming, dimensions, and stream-synced metadata. Client-created peds are local presentation entities and are not automatically known to the server or other players.

Server object

const barrier = vimp.objects.create(
  vimp.hash('prop_barrier_work05'),
  100,
  -1900,
  21,
  0,
  0,
  90,
  { dimension: 0, alpha: 255, placeOnGround: true },
)

Server ped

const guard = vimp.peds.create(
  vimp.hash('s_m_y_cop_01'),
  98,
  -1944,
  20.7,
  180,
  {
    health: 250,
    armour: 100,
    frozen: true,
    weapon: { hash: vimp.hash('WEAPON_CARBINERIFLE'), ammo: 90 },
  },
)

The server synchronizes declared ped state but does not turn arbitrary client AI tasks into authoritative gameplay. Use server validation for damage, rewards, and mission progression.

When using a client-local ped for previews or ambient presentation, call destroy() when the screen or feature closes.