N.utils — Core Utility Functions

N.utils provides a set of simple but powerful helper methods used across all NurJS systems — for positions, random values, money formatting, and more.

These utilities work both client and server side, depending on the context.

N.utils.distance(p1, p2)

Calculates the 3D distance between two positions or players.

const dist = N.utils.distance(player.position, { x: 440, y: -981, z: 30 });
if (dist < 3) mp.gui.chat.push("✅ You are close!");

Parameter	Type	Description
p1	mp.Player / Vector3 / {x,y,z}	First point or player
p2	mp.Player / Vector3 / {x,y,z}	Second point or player

✅ Automatically supports both player.position and plain {x, y, z} objects. If something goes wrong, returns 999999 safely (no crash).

🎲 N.utils.random(min, max)

Returns a random integer between min and max (inclusive).\

const value = N.utils.random(1, 10);
mp.gui.chat.push(`🎲 Random number: ${value}`);

Parameter	Type	Description
min	number	Minimum value
max	number	Maximum value

✅ Safe and integer-based — returns 0 if parameters are invalid.

N.utils.formatMoney(amount, suffix = "$")

Formats a number with spaces as thousand separators and appends a currency suffix.

const cash = 1234567;
mp.gui.chat.push(N.utils.formatMoney(cash, "$"));

Output:

1 234 567$

Parameter	Type	Default	Description
amount	number	—	Amount to format
suffix	string	"$"	Optional currency symbol

✅ Returns a clean readable string. If amount is invalid, returns "0$".

📍 N.utils.vector(x, y, z)

Quickly creates a mp.Vector3 instance from coordinates or object.

const pos1 = N.utils.vector(440, -981, 30);
const pos2 = N.utils.vector({ x: 450, y: -980, z: 30 });

✅ Automatically detects if you pass an object or individual coordinates.

Parameter	Type	Description
x	number / object	X coordinate or {x,y,z}
y	number	Y coordinate (ignored if x is object)
z	number	Z coordinate (ignored if x is object)

N.utils.isNear(player, pos, radius = 3)

Checks if a player is within a given radius from a point.Checks if a player is within a given radius from a point.

Parameter	Type	Default	Description
player	mp.Player	—	Player to check
pos	{x,y,z}	—	Target position
radius	number	3	Distance threshold

✅ Returns true if inside area, false otherwise.

🧠 Internal Implementation

N.utils.distance = function (p1, p2) {
  try {
    const a = p1?.position || p1;
    const b = p2?.position || p2;
    const dx = a.x - b.x;
    const dy = a.y - b.y;
    const dz = a.z - b.z;
    return Math.sqrt(dx * dx + dy * dy + dz * dz);
  } catch {
    return 999999;
  }
};

N.utils.random = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;

N.utils.formatMoney = (amount, suffix = "$") =>
  (typeof amount !== "number" ? "0" : amount.toString().replace(/\B(?=(\d{3})+(?!\d))/g, " ")) + suffix;

N.utils.vector = (x, y, z) =>
  typeof x === "object" && x.x !== undefined ? new mp.Vector3(x.x, x.y, x.z) : new mp.Vector3(x, y, z);

N.utils.isNear = (player, pos, radius = 3) => N.utils.distance(player, pos) <= radius;

💡 Example — Zone Trigger

if (N.utils.isNear(mp.players.local, { x: 440, y: -981, z: 30 }, 2)) {
  mp.gui.chat.push("🔵 Press E to interact");
}

✅ Commonly used in:

• Checkpoints

• Interaction zones

• Door systems

• Shop triggers

• Vehicle garages

N.utils provides core helper methods used everywhere in NurJS:

• 📏 Distance checks

• 🎲 Random numbers

• 💰 Money formatting

• 📍 Quick vector creation

• 👣 Proximity detection

It’s the foundation layer for all advanced systems like zones, checkpoints, and key binds.