A lightweight standalone script for FiveM that allows players to lock and unlock their firearms using a single key. Created with ox_lib integration and designed for easy expansion.

> 📖 **Full Documentation:**

> 👉 [https://0grav1ty.gitbook.io/zerogravity/0gravity-weapon-lock-or-free](https://0grav1ty.gitbook.io/zerogravity/0gravity-weapon-lock-or-free)

---

## 🚀 Features

- 🔐 Toggle firearm lock/unlock with key (default `L`)

- 🛡️ Prevents players from firing while weapon is locked

- 💬 Clean ox_lib notifications and progress bar

- ⚙️ Configurable lock time and cooldown

- 🧩 Easy-to-edit weapon whitelist

- ⚡ Fast, lightweight, no framework required

---

## 🧠 How It Works

1. Player presses `L` to toggle lock state.

2. If the player is holding a configured weapon:

- It becomes locked.

- Firing (`LMB`, `RMB`) is disabled.

3. Pressing `L` again triggers a progress bar and unlocks the weapon.

4. If the player tries to shoot while locked, they receive a notification.

---

## 🛠️ Installation

1. Place the resource in your `resources` folder.

2. Add the following lines to your `server.cfg`:

```

ensure ox_lib

ensure 0gravity_weaponlock

```

---

## ⚙️ Configuration

Edit `config.lua`:

```lua

Config.ToggleKey = 182 -- L key

Config.UnlockTime = 3000 -- in milliseconds

Config.NotifyCooldown = 2000 -- time between "locked" notifications

Config.FireWeapons = {

"WEAPON_PISTOL",

"WEAPON_COMBATPISTOL",

"WEAPON_APPISTOL",

"WEAPON_SMG",

"WEAPON_ASSAULTRIFLE",

"WEAPON_CARBINERIFLE",

"WEAPON_SNIPERRIFLE"

}

```

You can modify the keybind, unlock duration, notification delay, and the allowed weapon list.