DISCORD

0Gravity - Weapon Lock | Free

📘 Overview

Name: 0Gravity Weapon Lock Version: 1.0 Framework: Standalone Library dependency: ox_lib Author: 0Gravity BVVS Description: A lightweight system that allows players to lock and unlock their firearm with a single key (default L). Locked weapons are disabled from firing until manually unlocked.

🚀 Features

✅ Toggle weapon lock with a key ✅ Blocks only specific firearms ✅ ox_lib notifications and progressbar ✅ Spam protection for alerts ✅ Configurable lock/unlock time ✅ Lightweight & standalone

🧠 How It Works

  • Press L to lock or unlock your weapon.

  • When locked, firing controls (LMB, RMB) are disabled.

  • Unlocking triggers a progress bar before re-enabling weapon use.

  • If the player tries to shoot while locked, they receive a notification (with cooldown).

⚙️ Configuration

Located in config.lua:

Config.ToggleKey = 182 -- Default: L
Config.UnlockTime = 3000 -- in milliseconds
Config.NotifyCooldown = 2000 -- time between notifications (ms)

Config.FireWeapons = {
    "WEAPON_PISTOL",
    "WEAPON_COMBATPISTOL",
    "WEAPON_APPISTOL",
    "WEAPON_SMG",
    "WEAPON_ASSAULTRIFLE",
    "WEAPON_CARBINERIFLE",
    "WEAPON_SNIPERRIFLE"
}

You can customize which weapons are considered "firearms" and adjust timings easily.

🛠️ Installation

  1. Make sure you have ox_lib installed and started before this script.

  2. Copy the folder 0gravity_gunblock into your resources/ directory.

  3. Add the following to your server.cfg:

    ensure ox_lib
ensure 0gravity_gunblock

🎮 Controls

Key
Action

L

Toggle weapon lock/unlock

📂 File Structure

0gravity_gunblock/
├── config.lua         # Configurable settings
├── client.lua         # Main script logic (locking/unlocking)
├── fxmanifest.lua     # Resource metadata
└── README.md          # Local readme in Polish

❗ Limitations (FREE VERSION)

  • ❌ No support for ESX or QBCore out of the box

  • ❌ No Discord webhook integration

  • ❌ No language localization (hardcoded Polish text)

  • ❌ No admin bypass or commands

📦 Dependencies

Make sure it's properly installed and initialized with @ox_lib/init.lua.

🧪 Example Flow

  1. Player equips a weapon like a pistol.

  2. Player presses L → Weapon is locked.

  3. Player tries to shoot → Notification appears: "Broń zablokowana"

  4. Player presses L again → Progress bar appears for 3 seconds.

  5. Weapon is now unlocked and usable again.

📩 Support

Join the support Discord: https://discord.gg/YbuNXpwkWY

Let me know if you'd like this exported to a .md file, or if you want a PRO version roadmap page added as well.

PreviousTeleport Menu

Last updated