N.spawn — Server Entity Spawner

`N.spawn()` is the universal creator in NurJS. It lets you spawn any entity — vehicles, objects, NPCs (peds), or map blips — using one simple, unified function. Each entity type has its own suppor

🔹 Basic Syntax

const entity = N.spawn(type, data);

Parameter	Type	Description
type	string	Entity type — "vehicle", "object", "npc", or "blip".
data	object	Configuration parameters for the chosen entity type.

⚙️ Supported Types

🚗 Vehicle

Creates a new vehicle and sets its parameters automatically.

N.spawn("vehicle", {
  model: "kuruma",
  pos: new mp.Vector3(215.5, -810.2, 30.7),
  heading: 90,
  color: [111, 111, 255],
  plate: "NURJS",
  engine: true,
  lock: false,
  owner: player,          // optional: player reference or name
  fuel: 100,
  setmodes: { 11: 3, 22: 2 } // vehicle mods
});

✅ Features:

• Auto-assigns veh.NurID (unique UUID).

• Supports variables and setmodes.

• Saves spawn data (pos, heading, dimension).

• Logs creation in console if debug is enabled.

• Sends notify to owner if available.

Property	Type	Description
model	string	Vehicle model name.
pos	Vector3	Spawn position.
heading	number	Rotation heading in degrees.
color	array	[primary, secondary] colors.
dimension	number	Dimension ID (default 0).
owner	object / string	Owner info (player, name, or dbid).
plate	string	Custom number plate text.
lock	boolean	Locked state.
engine	boolean	Engine on/off.
fuel	number	Starting fuel level.
vehid	number	Internal random ID.
variables	object	Custom synced variables.
setmodes	object	Vehicle modification dictionary.

📦 Object

Creates a synced world object.

N.spawn("object", {
  model: "prop_crate_11e",
  pos: new mp.Vector3(216, -809, 30),
  rot: new mp.Vector3(0, 0, 90),
  dimension: 0,
  dynamic: true,
  variables: { crateType: "weapon" }
});

✅ Features:

• Fully synchronized object with rotation and variables.

• Automatically assigned NurID and spawn data.

Property	Type	Description
model	string	Object model name.
pos	Vector3	Position vector.
rot	Vector3	Rotation angles.
dimension	number	Dimension ID.
dynamic	boolean	Whether object is dynamic (true by default).
variables	object	Custom synced variables for players.

🧍 NPC / Ped

Spawns a non-player character.

N.spawn("npc", {
  model: "s_m_y_cop_01",
  pos: new mp.Vector3(430.2, -981.1, 30.7),
  heading: 180,
  freeze: true,
  scenario: "WORLD_HUMAN_GUARD_STAND",
  variables: { job: "police" }
});

✅ Features:

• NPC automatically freezes if freeze: true.

• Can play scenarios like sitting, smoking, guarding, etc.

• Automatically synced variables and NurID.

Property	Type	Description
model	string	Ped model name.
pos	Vector3	Position vector.
heading	number	Heading rotation.
dimension	number	Dimension ID.
freeze	boolean	Freeze NPC movement.
scenario	string	GTA scenario string.
variables	object	Synced variables.

🗺️ Blip

Creates a map blip visible to all players.

N.spawn("blip", {
  name: "Job Center",
  pos: new mp.Vector3(-265.0, -963.6, 31.2),
  sprite: 280,
  color: 46,
  shortRange: true,
  scale: 1.0
});

✅ Features:

• Adds an icon to the player map.

• Automatically generates NurID for internal tracking.

Property	Type	Description
name	string	Blip label text.
pos	Vector3	Map position.
sprite	number	Blip icon ID.
color	number	Color index.
shortRange	boolean	Whether visible only nearby.
scale	number	Blip size (default 1.0).

🧠 Debug Mode

If N.config.debug = true, every spawn action prints a detailed message:

[NurSpawn] Vehicle kuruma created (12345)
[NurSpawn] Object prop_crate_11e created.
[NurSpawn] NPC s_m_y_cop_01 created.
[NurSpawn] Blip "Job Center" created.

N.spawn() unifies all entity creation in one function — vehicles, NPCs, objects, and blips — all with consistent syntax and automatic synchronization. It simplifies spawning logic and keeps your code clean, readable, and universal.