# Queue System

### ⭐ Intro

A professional, fully-configured queue system for FiveM servers. Built on FiveM's native Adaptive Card system, NLRP Queue gives your players a polished connection experience while giving you complete control over who gets in, and in what order, and when.

***

### 📦 Requirements

* FiveM (OneSync)
* Discord Bot
* [NLRPPerms (Permissions System)](https://thunders-scripts.tebex.io/package/permissions)

***

### 🧩 Features

* Adaptive Card queue UI
* Discord role whitelist & blacklist with custom kick messages
* In-queue permissions preview
* Priority rank system with configurable tier values
* Reserved slots for high-priority roles
* Queue hold with timed release and bypass roles
* Developer hold mode
* Auto-connect with optional player skip
* Live queue position and countdown display
* Player avatars, names, Discord info, and rank labels in queue list
* Demo mode for testing with dummy queue entries
* Spam limiter with configurable cooldown
* Startup wait period with countdown
* Grace period support for returning players
* Full debug logging system (4 levels)
* In-game and console commands with permission gating
* All text and UI elements configurable in `config.lua`

***

### 🔧 Installation

1. Create a folder in your resources folder named `[NLRPScripts]`
2. Drag & drop the `NLRPQueue` resource folder into the `[NLRPScripts]` folder
3. Add to `server.cfg`:

   ```cfg
   ensure [NLRPScripts]
   ```