Interactive blocks

N.bind() allows you to easily bind actions to keys, with full support for:

• ✅ Custom key actions

• ✅ Engine/lock toggles

• ✅ Door control systems

• ✅ Zone-based key logic

• ✅ Cooldowns

• ✅ Animations and scenarios

• ✅ Teleportation to map marker

• ✅ Safe (error-protected) execution

This system makes your key interactions extremely simple and powerful.

🔹 Basic Syntax

N.bind({
  key: "E",
  description: "Interact with nearest object",
  notify: "🕹 Interact key pressed",
  cooldown: 2000, // 2s cooldown
  action: (player) => {
    mp.gui.chat.push("✅ You pressed E!");
  }
});

✅ Automatically:

• Binds the key "E"

• Handles cooldown between presses

• Shows notification if provided

• Executes your callback safely

⚙️ Parameters

Option	Type	Default	Description
key	string	—	Main key to bind (e.g. "E", "F7", "L", "G").
engineKey	string	—	Binds a key to toggle vehicle engine (automatic logic).
lockKey	string	—	Binds a key to lock/unlock the current vehicle.
description	string	—	Description shown when key is registered.
notify	string	—	Chat notification when the key is pressed.
log	string	—	Console log message when triggered.
playAnim	object	null	{ dict, name } animation played on press.
playerScenario	string	null	GTA scenario name (e.g. "WORLD_HUMAN_SMOKING").
tpToMarker	boolean	false	Teleports player to map marker (calls remote event).
safe	boolean	false	Wraps the action in try/catch to prevent crashes.
doorControl	object / array	null	Opens/closes nearby doors based on config.
zone	object	null	{ pos, radius } — only triggers inside area.
cooldown	number	0	Time (ms) before key can be pressed again.
action	function	—	Function executed when the key is pressed.

🧩 Example — Vehicle Engine Key

N.bind({
  engineKey: "J",
  notify: "🚗 Engine toggled",
  log: "Engine key pressed"
});

✅ Automatically toggles the player’s vehicle engine:

• Turns the engine on/off properly using vehicle.setEngineOn()

• Prevents auto-starting when player enters

🧩 Example — Vehicle Lock Key

N.bind({
  lockKey: "L",
  notify: "🔒 Vehicle locked/unlocked"
});

✅ Toggles the vehicle’s lock state:

• Uses vehicle variable "locked"

• Safe for both driver and passengers

🧩 Example — Door Control System

N.bind({
  doorControl: {
    key: "E",
    doorHash: "v_ilev_ph_cellgate",
    doorPos: { x: 461.8065, y: -994.4086, z: 25.0644 },
    checker: { faction: "police" },
    notify: "🚪 Door toggled"
  }
});

✅ Automatically:

• Detects nearby door by distance

• Sends access check to server if checker exists

• Toggles door open/close via mp.game.object.doorControl()

• Plays optional notification or callback action

Server will respond using event:

mp.events.add("NurJs:doorAccessResult", (doorJSON, allowed) => { ... });

🧩 Example — Zone-Based Key

N.bind({
  key: "E",
  zone: {
    pos: { x: 440.0, y: -981.0, z: 30.0 },
    radius: 3.0
  },
  action: (player) => {
    mp.gui.chat.push("🟢 You’re in the police zone!");
  }
});

✅ Runs only when the player is inside the given radius.

🧩 Example — Teleport to Marker

N.bind({
  key: "F7",
  tpToMarker: true,
  notify: "📍 Teleporting to map marker..."
});

Automatically teleports the player to the map waypoint (via remote event).

🧩 Example — Animation or Scenario Bind

N.bind({
  key: "G",
  playAnim: { dict: "anim@mp_player_intcelebrationmale@wave", name: "wave" },
  notify: "👋 You waved!",
  cooldown: 3000
});

Or use a scenario:

N.bind({
  key: "H",
  playerScenario: "WORLD_HUMAN_SMOKING"
});

🧠 Safe Mode & Cooldowns

All binds support safe mode and cooldowns:

N.bind({
  key: "K",
  safe: true,
  cooldown: 5000,
  action: () => {
    throw new Error("Test error");
  }
});

✅ Prevents crashing the client and limits spam to once every 5 seconds.

📘 Internal Behavior

Internally, N.bind():

• Converts key names to key codes via mp.keys.getCodeFromName()

• Uses mp.keys.bind(code, false, handler)

• Tracks per-key cooldowns

• Supports multiple logic layers (door control, engine toggle, zone check, etc.)

• Uses a unified executeSafe() wrapper to handle:

  • Logging

  • Animations/scenarios

  • Teleportation

  • Notifications

  • Exception safety

🧱 Example: Combined Door + Zone + Animation

N.bind({
  key: "E",
  zone: { pos: { x: 441, y: -980, z: 30 }, radius: 3 },
  playAnim: { dict: "anim@mp_player_intcelebrationmale@salute", name: "salute" },
  doorControl: {
    doorHash: "v_ilev_ph_cellgate",
    doorPos: { x: 461.8065, y: -994.4086, z: 25.0644 },
    notify: "🚪 Cell door toggled"
  },
  cooldown: 3000,
  safe: true
});

One key → animation + door control + safe checks + cooldowns. That’s the full power of NurJS bindings 💪

N.bind() gives developers a unified and safe system for key interactions. From teleportation and vehicle logic to door systems and animations — everything can be attached to a single key with a few lines of code.

It’s the foundation for client gameplay interactivity in NurJS.