Kael PoliceBadge

Description

# 🛡️ Kael-PoliceBadge — Ultra Realistic 3D Police Credentials & Terminal

Elevate your police and law enforcement roleplay with the ultimate 3D badge and credential system for FiveM. Designed from the ground up for maximum immersion, performance, and multi-framework flexibility.

---

### 🌟 Key Highlights

* **Hyper-Realistic 3D Bi-Fold Animation:**

An authentic leather bi-fold wallet that smoothly unfolds on your screen with dynamic lighting and high-definition metallic emblems (LSPD, BCSO, SASP, FIB, Ranger).

* **Physical Prop & Animations:**

Officers pull out a real badge wallet prop from their uniform, holding it up firmly for suspects to see, followed by a natural holstering animation.

* **Proximity Badge Flashing:**

Show credentials cleanly to nearby players within customizable range. Displays official photo, callsign, rank, department, and custom badge motto without interrupting their controls.

* **Modern High Command Terminal:**

A secure police desk interface where authorized supervisors select online officers, view live avatar previews, input custom callsigns, and mint official badges.

* **Jurisdiction / Department Locks:**

Prevent cross-department exploitation. LSPD officers can only issue LSPD credentials; BCSO can only issue BCSO credentials (fully toggleable to global mode in config).

* **Persistent Records System:**

Every badge issued is stored permanently on disk (`records.json`), ensuring badge records survive server restarts and allowing High Command audits at any time.

* **Zero Resource Drag (Optimized):**

Runs at **0.00ms idle** with clean NUI message passing and zero unnecessary tick loops.

---

### ⚙️ Requirements & Compatibility

* **Framework:** Qbox (`qbx_core`) OR QB-Core (`qb-core`)

* **Inventory:** `ox_inventory` OR `qb-inventory`

* **Dependencies:** `ox_lib`, `ox_target` (optional for desk interaction)

---

### 📁 Config Preview

All aspects of the script are readily configurable in `config.lua`:

* Toggle Department Issuance Restrictions on/off

* Custom authorized jobs, minimum grades (e.g., Lieutenant+), and boss overrides

* Callsign display format (`prefix`, `raw`, or `brackets`)

* Proximity display distance and duration

* Screen UI scale, position offset, and sound effect volume

---

### 📦 What's Included

* Full resource files with clean, production-ready code

* High-definition badge emblems and wallet textures

* Lifetime support via Discord