N.checkpoint (Client) — Local Checkpoint Manager

N.checkpoint on the client side allows you to visually create, remove, and manage checkpoints locally. It’s ideal for missions, tasks, and interactive areas that only the player should see.

🔹 Basic Example

const cp = N.checkpoint.create({
  id: "mission_start",
  pos: { x: 215.5, y: -810.2, z: 30.7 },
  color: [0, 255, 0, 120],
  radius: 1.8,
  dimension: 0,
  once: false
});

✅ This automatically:

• Creates a visible checkpoint at the given position

• Stores it inside N.checkpoint.list for easy access or removal

• Supports transparency, radius, and custom IDs

⚙️ Parameters

Option	Type	Default	Description
id	string	auto-generated	Unique checkpoint ID (cp_...).
pos	object	—	Coordinates { x, y, z } where the checkpoint appears.
radius	number	1.5	The radius of the checkpoint area.
color	array	[255,255,255,120]	RGBA color of the checkpoint.
dimension	number	0	Dimension the checkpoint belongs to.
type	number	1	Checkpoint type (RAGE default is cylinder).
visible	boolean	true	Whether the checkpoint is visible.
once	boolean	false	Whether the checkpoint is one-time only.

🧠 Returned Object

const cp = N.checkpoint.create({...});

Returns the created mp.Checkpoint instance so you can modify or destroy it later.

🧩 Example — Local Task Checkpoint

const collectPoint = N.checkpoint.create({
  id: "collect_item_1",
  pos: { x: -432.12, y: 289.44, z: 83.12 },
  color: [0, 150, 255, 150],
  radius: 2.5,
  once: true
});

Later you can remove it:

N.checkpoint.remove(collectPoint);

🔧 Remove a Single Checkpoint

🧩 N.checkpoint.remove(cp)

N.checkpoint.remove(cp);

✅ Automatically:

• Destroys the checkpoint object

• Removes it from N.checkpoint.list

• Prevents leaks and leftover visuals

🔄 Clear All Checkpoints

🧩 N.checkpoint.clearAll()

Removes every checkpoint currently active on the client.

N.checkpoint.clearAll();

✅ Useful when:

• Restarting missions or zones

• Cleaning up map areas

• Resetting UI or player state

🧩 Example: Mission Cleanup

// Start mission
const deliveryCP = N.checkpoint.create({
  id: "delivery",
  pos: { x: -1025.2, y: -2735.5, z: 20.2 },
  color: [255, 200, 0, 150],
  radius: 2.0
});

// After completing
N.checkpoint.remove(deliveryCP);

// Or clear all at once
N.checkpoint.clearAll();

📘 Internal Structure

Each checkpoint saved inside N.checkpoint.list looks like this:

{
  id: "cp_1697650843923_8212",
  cp: <mp.Checkpoint>,
  data: { pos, color, radius, dimension, once },
  playersInside: Set<Player>
}

⚠️ Notes

• Client checkpoints are local only — they exist for one player.

• Server checkpoints are handled separately with N.checkpoint on the server side.

• You can sync data using N.cache if you want shared state between players.

• Use transparent colors (alpha < 255) for better visual blending.

N.checkpoint on the client side is a lightweight and dynamic system for managing personal checkpoints. It’s perfect for missions, delivery points, or interactive events visible only to the player.