Youtube - Whitelist Items | Fivem Script 

## Discord Role-Based Item Restriction & Logging System

Take full control of your server’s economy, permissions, and restricted content with a powerful Discord-integrated whitelist system. This script allows you to lock items and weapons behind Discord roles, automatically enforce access, and log all player actions in real-time. Built for serious servers that need security, automation, and clean moderation tools.

---

## What This Script Does

- Restrict items and weapons based on Discord roles  
- Automatically remove unauthorized items from players
- Prevent unauthorized weapon usage
- Sync roles in real-time with Discord
- Log all key inventory actions directly to Discord  

---

## Discord Integration

- Uses your Discord bot to fetch player roles live  
- No database syncing or stored permissions
- Always accurate and up-to-date role checks
- Works instantly on join and refresh  

---

## Item & Weapon Control

- Restrict:
- Inventory items
- Weapons
- Automatically:
- Removes items if a player loses the required role
- Prevents unauthorized usage  

Perfect for:
- VIP items
- Staff equipment
- Police / EMS gear
- Tebex-exclusive content  

---

## Logging System

Keep full visibility on what players are doing.

### Logs:

- Weapon equips  
- Item removals (auto enforcement)
- Item moves (inventory transfers)
- Item drops
- Player-to-player transfers  

---

### Log Details:

- Player name  
- Server ID
- Discord ID
- Item name
- Amount
- Action performed
- Timestamp
All logs are sent as clean, readable Discord embeds.

---

## Real-Time Role Sync

- /refreshroles command (player refresh)    
- Optional automatic role refresh system
- Optional removal of unauthorized items on join  

---

## Performance

- No constant loops  
- No unnecessary database usage
- Optimized Discord API calls
- Runs only when needed  

---

## Configuration

Everything is controlled through config.lua:
- Discord bot token
- Guild ID
- Role to item mapping
- Logging webhook
- Refresh settings
- Debug mode  

---

## Requirements
- ox_inventory
- Discord bot with:
- Guild Members Intent enabled
- Permission to read member roles  

---

## Why Use This Script?

Most servers rely on trust or manual checks. This system automates everything.
- No more players keeping items they shouldn’t have
- No more guessing who used what
- Full control over restricted content
- Clean logs for staff and admins  

---

## Perfect For
- Tebex monetization systems
- VIP rewards
- Role-based progression servers
- Staff / faction equipment control
- Secure weapon whitelisting  

---

## Summary
This is a complete permission and enforcement system for your server.
If you want secure item control, automated enforcement, professional logging, and Discord-based permissions, this script provides everything in one clean solution.