N.config.client — Client Environment Controller

N.config.client() allows you to control almost every gameplay, visual, and UI aspect of the client. From disabling unwanted controls to enabling snow, traffic, or first-person-only mode — all in one place.

This system runs every frame (in render event) and applies global rules automatically.

🔹 Basic Usage

N.config.client({
  defRadar: false,
  defAutoRagdoll: false,
  defVehRadio: false,
  snow: true,
  defFirstPersonOnly: true
});

✅ This instantly:

• Hides the radar

• Disables ragdoll

• Turns off vehicle radio

• Enables snow mode

• Forces first-person camera

⚙️ Parameters

Option	Type	Default	Description
Player Controls
defAutoRagdoll	boolean	true	Disable ragdoll (player never falls)
defAutoCover	boolean	true	Disable cover system (block Q key)
defAutoJump	boolean	true	Disable jumping (block SPACE)
defAutoMelee	boolean	true	Disable melee attacks (block LMB)
defAutoCrouch	boolean	true	Disable crouching (block CTRL)
defStamina	boolean	true	Infinite stamina if false
defAutoAim	boolean	true	Disable auto-aim and lock-on

| HUD / UI | | | | | defRadar | boolean | true | Hide minimap/radar | | defVehNameShower | boolean | true | Hide vehicle name | | defStreetName | boolean | true | Hide street name | | defAmmoIndicator | boolean | true | Hide ammo HUD | | defDisplayCash | boolean | true | Hide money counter | | defHealthArmorHud | boolean | true | Hide health/armor bars | | defHelpText | boolean | true | Clear help hints | | defMinimapZoom | boolean | true | Disable radar zoom |

| Weapons / Input | | | | | defWeaponWheel | boolean | true | Disable weapon wheel (TAB/R keys) | | defInvWepActions | boolean | true | Disable inventory weapon hotkeys |

| Vehicles | | | | | defVehOn | boolean | true | Auto-turn off engine when enabled | | defVehRadio | boolean | true | Disable vehicle radio | | defAutoTraffic | boolean | false | Enable traffic spawning | | defAutoAmbient | boolean | false | Enable NPC spawning |

| Visuals / Effects | | | | | defIdleCamera | boolean | true | Disable idle camera while AFK | | defShakeCamera | boolean | true | Disable gameplay camera shake | | defAutoZoom | boolean | true | Disable camera auto-zoom | | defBlurEffects | boolean | true | Disable time-cycle blur | | defWeatherSync | boolean | true | Prevent forced weather sync (clear persist) |

| Death / Respawn | | | | | defDieMode | boolean | true | Fade out HUD and blur screen on death |

| Camera | | | | | defFirstPersonOnly | boolean | false | Force first-person camera in all states |

| Special Modes | | | | | snow | boolean | false | Enable or disable full snow environment (visuals, audio, and weather) |

❄️ Snow Mode Example

N.config.client({
  snow: true
});

✅ Automatically:

• Enables snow textures and footstep effects

• Forces XMAS weather

• Adds snow trails and footstep tracks

• Loads audio banks for snow walking

• Applies snow particles and shaders

N.config.client({ snow: false });

🎥 First-Person-Only Mode Example

N.config.client({
  defFirstPersonOnly: true
});

✅ Locks player permanently in first-person view:

• Forces view mode 4 (ped & vehicle) every frame

• Disables camera change (V and mouse wheel)

• Works for both on-foot and vehicle cameras

🚗 Vehicle / Ambient Controls Example

N.config.client({
  defVehRadio: false,
  defAutoTraffic: true,
  defAutoAmbient: true
});

✅ Enables:

• Civilian traffic (cars, parked vehicles)

• Pedestrian/NPC population

• Disables personal radio stations

🧱 Internal Logic Overview

N.config.client = function (options = {}) {
  N.config._client = options;

  mp.events.add("render", () => {
    const cfg = N.config._client;
    if (!cfg) return;

    const player = mp.players.local;
    const veh = player.vehicle;

    // PLAYER CONTROL EXAMPLES
    if (cfg.defAutoRagdoll === false) player.setCanRagdoll(false);
    if (cfg.defAutoCover === false) mp.game.controls.disableControlAction(0, 44, true);
    if (cfg.defAutoJump === false) mp.game.controls.disableControlAction(0, 22, true);

    // HUD/UI EXAMPLES
    if (cfg.defRadar === false) mp.game.ui.displayRadar(false);
    if (cfg.defAmmoIndicator === false) mp.game.ui.hideHudComponentThisFrame(2);

    // VEHICLE EXAMPLES
    if (cfg.defVehOn === false && veh && veh.getIsEngineRunning())
      veh.setEngineOn(false, true, true);

    // SNOW MODE
    if (cfg.snow === true) mp.game.gameplay.setOverrideWeather("XMAS");
  });
};

💡 Recommended Usage

Define once on client startup (e.g., inside client_packages/index.js):

N.config.client({
  defRadar: false,
  defAmmoIndicator: false,
  defAutoRagdoll: false,
  defVehRadio: false,
  snow: false
});

✅ Applies instantly and automatically maintains settings throughout gameplay.

N.config.client() is the global gameplay configuration for the client environment. It controls:

• Player behavior (jumping, ragdoll, stamina)

• HUD and UI visibility

• Vehicle and ambient world systems

• Weather and camera

• Snow, blur, and other visual effects

This system ensures your server’s client settings remain consistent, polished, and optimized — making NurJS feel like a true game framework.