N.cache (Client) — Local + Synced Data Storage

N.cache on the client side allows you to store, access, and sync small pieces of data between the client and server — such as player state, UI variables, or custom values.

It’s the lightweight “memory” of NurJS that automatically synchronizes with the server when needed.

🔹 Basic Example

N.cache.set("currentMission", "bank_heist");
const mission = N.cache.get("currentMission");
mp.gui.chat.push(`🧩 Current mission: ${mission}`);

✅ Output:

[N.cache] set "currentMission" = "bank_heist"
🧩 Current mission: bank_heistд

⚙️ Functions

🧩 N.cache.set(key, value, sync = true)

Stores a value in local cache. If sync = true, it also sends it to the server (NurRage:cache:clientSet).

N.cache.set("weather", "RAIN", true);

Parameter	Type	Default	Description
key	string	—	Unique cache key name
value	any	—	Value to store (string, number, object, etc.)
sync	boolean	true	Whether to sync with the server

✅ Automatically logs to chat:

[N.cache] set "weather" = "RAIN"

🧩 N.cache.get(key, def = null)

Retrieves a value from cache, or returns a default if missing.

const money = N.cache.get("playerMoney", 0);
mp.gui.chat.push(`💰 You have $${money}`);

Parameter	Type	Default	Description
key	string	—	Key to retrieve
def	any	null	Default value if not found

🧩 Server → Client Sync

Whenever the server updates cache values, the client automatically receives updates via:

mp.events.add("NurRage:cache:update", (key, value) => {
  N.cache._data.set(key, value);
});

✅ You can add listeners or handle it in your UI:

mp.events.add("NurRage:cache:update", (key, value) => {
  if (key === "playerHealth") updateHUD(value);
});

🧠 Internal Example

/**
 * Set and sync
 */
N.cache.set = function (key, value, sync = true) {
  if (!key) return;
  N.cache._data.set(key, value);
  if (sync) mp.events.callRemote("NurRage:cache:clientSet", key, value);
  mp.gui.chat.push(`~c~[N.cache] set "${key}" = ${JSON.stringify(value)}`);
};

/**
 * Get local
 */
N.cache.get = function (key, def = null) {
  return N.cache._data.has(key) ? N.cache._data.get(key) : def;
};

/**
 * Receive updates from server
 */
mp.events.add("NurRage:cache:update", (key, value) => {
  N.cache._data.set(key, value);
});

🧩 Example — Syncing Player State

🔹 Client

N.cache.set("seatbelt", true);

🔹 Server

mp.events.add("NurRage:cache:clientSet", (player, key, value) => {
  console.log(`[CACHE] ${player.name} set ${key} = ${value}`);
});

✅ Client instantly updates local cache.

💡 Use Cases

Scenario	Example
UI State	N.cache.set("hudVisible", true)
Mission Progress	N.cache.set("missionStep", 3)
Player Variables	N.cache.set("seatbelt", true)
Server Sync	Auto-updates values like time, weather, health

⚙️ Internal Notes

• Local data is stored in N.cache._data (Map object).

• Supports any JSON-serializable value (string, number, object, array).

• Server communication handled through NurRage:cache:clientSet and NurRage:cache:update.

• Logging is automatic (for debug builds).

N.cache (client) is a lightweight and synchronized key-value store. It helps you quickly store and sync small pieces of state between client and server — ideal for UIs, missions, HUDs, and player data.