# Weapon Whitelist System

Upgrade your RP server's integrity and balance with our **Weapon Whitelist System** – a fully configurable solution that restricts blacklisted weapons to only **authorized players and jobs**, using **admin** seamless control.

{% embed url="<https://www.youtube.com/watch?v=ttUx3NJrxyY>" %}

<figure><img src="/files/7fsz1N6CFpAE9piCHlkP" alt=""><figcaption></figcaption></figure>

<div><figure><img src="/files/MSQm4YckHODxnPZrVsiX" alt=""><figcaption></figcaption></figure> <figure><img src="/files/db0s53JWpRWUXoOTaUnM" alt=""><figcaption></figcaption></figure> <figure><img src="/files/lboE3B0xfzOMR5fMigYD" alt=""><figcaption></figcaption></figure> <figure><img src="/files/izgNAbqJQ7oDBUuheXhk" alt=""><figcaption></figcaption></figure></div>

#### Key Features:

* **Player & Job-Based Whitelisting**\
  Allow specific players (by ID or license/citizen ID) or jobs (e.g. *police, swat*) to access restricted weapons.
* &#x20;**Admin-Friendly Commands & UI**\
  Use `/wlist` and `/wlremove` commands to **whitelist or revoke** weapons — powered by ox\_lib input dialogs and dropdowns!
* **Support for Multiple Frameworks**\
  Works with both **QBCore, Qbox** and **ESX**. Automatically detects and adjusts using citizen ID (QBCore & **Qbox** ) or license (ESX).
* **Inventory System Compatibility**\
  Integrated with **QBCore Inventory** and **OX Inventory** — auto-removes weapons if players aren't authorized.
* **Blacklisted Weapon Monitoring**\
  Detects usage of restricted weapons and triggers client-side warning UI or even kicks the player (optional).
* **Clean Notifications & Feedback**\
  Admin commands return clear success/error messages using ox\_lib notifications.
* **Configurable & Lightweight**\
  Easily edit blacklist, permission groups, framework choice, and more from a simple config file.
* **Discord Logging Ready**\
  Optional feature to log blacklist violations to your Discord server for staff review.
* Multi-Language Support

#### Perfect For:

* Law-enforced RP servers
* Hardcore roleplay setups
* Servers wanting weapon control without fully locked inventories

#### Secured by FiveM Escrow System

This resource is protected using the official **FiveM Escrow System** to prevent unauthorized redistribution and ensure server-side integrity.

#### Need Custom Features?

We offer **custom solutions and extensions** — feel free to contact us through [Tebex](https://projectfinals.tebex.io/) or [Discord](https://discord.com/invite/VCAqrrBddC) for additional integrations or tweaks.

Keep your RP world fair, secure, and professional — empower your staff with full control over who uses what!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://project-finals.gitbook.io/project-finals/weapon-whitelist-system.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.