Join our Discord
# 🔐 Andre-PersonelLockers | Job-Specific Personnel Lockers | QBCore
> A fully configurable, job-locked personnel locker system for QBCore. Admins place lockers in-world via a placement tool, and players access their own personal storage — with supervisor override for eligible jobs.
---
## ✨ Features
-
🏢 **Job-Locked Lockers** — Each locker is tied to a specific job. Only players with the correct job can interact.
-
👔 **Grade-Based Access** — Configurable minimum grade required to access lockers (e.g. Lieutenant+).
-
🔍 **Supervisor Override** — Jobs marked `canViewOthers = true` allow senior staff to look up any officer's locker by citizen ID.
-
📍 **In-World Placement Tool** — Admins use `/createlocker` to open a panel, configure the locker, and place it live via a crosshair raycast marker. No restarts needed.
-
🗄️ **ox_inventory Stash Storage** — Each locker uses a persistent ox_inventory stash. Items stay between sessions.
-
🎯 **ox_target Interaction** — Clean third-eye interaction. No messy proximity prompts.
-
🛠️ **Admin Commands** — `pl_createlocker` `pl_deletelocker` `pl_reloadlockers`
-
⚙️ **Fully Configurable** — All jobs, grades, interaction distances, marker colours, and notification style set in a single `config.lua`.
-
🔔 **Notification Support** — Compatible with `ox_lib`, `qb-notify`, and `esx_notify`.
---
## 🏢 Supported Jobs (Out of the Box)
Law enforcement, emergency services, corrections, DOJ, real estate, vehicle dealers, restaurants, nightclubs, dispensaries, and more — all pre-configured and easy to add to.
---
## 📋 Requirements
| Dependency | Notes |
|---|---|
| `qb-core` | Core framework |
| `oxmysql` | Database |
| `ox_lib` | UI, zones, notifications |
| `ox_target` | Third-eye interaction |
| `ox_inventory` | Locker stash storage |
---
## 📦 Installation
1. Drop `Andre-PersonelLockers` into your `resources` folder
2. Run `andre_personel_lockers.sql` in your database
3. Add to `server.cfg`:
```
add_ace qbcore.admin Andre-PersonelLockers.admin allow
ensure Andre-PersonelLockers
```
4. Configure `config.lua` — add your server's jobs and set minimum grade
5. In-game, use `pl_createlocker` to place lockers
---
## 💬 Support
Join our Discord for installation help: Click here > Discord
---
*Escrowed resource — core logic is protected. `config.lua` remains fully open for customisation.*