# 🚓 5Code Loadouts — Police Armory System
# Showcase: https://youtu.be/3zCF-GtknLU
# Docs: https://5code.gitbook.io/5code-docs

A clean, fully-featured **QBCore police loadout system**. Officers walk up to an

armory NPC, pull a pre-built kit for their unit, and a deposit is taken from their

bank — return the gear later to get the deposit back. Lose items? An automatic

penalty is deducted. Bosses and admins manage everything from a polished in-game UI.

## ✨ Features

- **NPC armory** with `qb-target`, `ox_target`, or E-key interaction

- **Unit-based loadouts** — Patrol, K9, SWAT, Detective, Air Unit, Sheriff, Command (fully editable)

- **Deposit & refund system** with configurable per-item pricing and missing-item penalties

- **In-game management UI** — create/edit/reorder loadouts, customize units, map grades, tweak settings live

- **VIP loadouts & equipment** (ACE-gated)

- **Grade-to-unit mapping** so officers only see what their rank can pull

- **Full Discord audit logs** — deploys, returns, missing items, disconnects, setting changes

- **Activity log viewer** with search, filters & pagination

- **Anti-abuse by design** — all authorization is server-side; one active loadout per character, enforced at the database layer

- **Disconnect tracking** — if a cop logs off with gear, the obligation stays open and command is notified

- **Admin commands** — `/loadouts:status` and `/loadouts:forceclose` (refund / penalty / none)

## 🔌 Compatibility

- **Framework:** QB-Core

- **Inventory:** qb-inventory · ox_inventory · codem-inventory

- **Notifications:** qb · ox_lib · codem-notification

## ⚙️ Easy Setup

- **Automatic database install** — tables create themselves on first start

- Clean, well-commented `config.lua`

- Includes a full installation guide (human **and** AI-assisted install)

## 📦 Requirements

`qb-core` · `oxmysql` · a supported target & inventory resource