Join our Discord
# 🛠️ Andre-Devtools | All-in-One Admin Toolkit | QBCore
> A single ACE-permission-gated resource that gives your admin team everything they need: a live coordinate grabber, a job-based door lock system with keycard support, cross-access rules for LEO/EMS, and a full keycard issuance and management UI — all from one `/admintools` command.
---
## ✨ Features
### 📍 Coords Tab
- Live X / Y / Z / Heading updated every 100ms
- 5 one-click copy formats: raw vector4, lua table, JSON, coords only, heading only
- Teleport to any saved coord directly from the UI
- Saved coord history — persists across sessions
### 🚪 Doors Tab
- Raycast door detection — aim at any door and register it to a job instantly
- Toggle F7 raycast on/off without closing the UI
- Lock / unlock any registered door from the panel
- Doors export — generates ready-to-paste `doors.lua` Lua code, copy to clipboard or save to server
### 🃏 Keycards Tab
- View all currently issued keycards across the server
- Search and filter by job or player
- Revoke any card instantly from the UI
### 📤 Issue Tab
- Look up any player by CitizenID
- Issue a keycard for any job directly from the panel
- Minimum issuer grade configurable in config
### 🔀 Cross-Access System
- Configure which jobs can passively enter other job's doors without a keycard
- Example: LSPD can enter Ambulance and Parsons doors silently
- Passive entry plays the keycard swipe animation and opens the door without locking it for others
- Full raid mode available for police jobs — toggles lock for all
- Server-side job validation — cannot be spoofed
### 🔒 ACE Permission Gated
- Only players with the correct ACE permission can open `/admintools`
- Admin groups can bypass all doors regardless of job
- Fully configurable in `shared/config.lua`
---
## 📋 Requirements
| Dependency | Notes |
|---|---|
| `qb-core` | Core framework |
| `oxmysql` | Database |
| `ox_lib` | Notifications & UI |
| `ox_inventory` | Keycard item support |
---
## 📦 Installation
1. Drop `Andre-Devtools` into your `resources` folder
2. Add to `server.cfg`:
```
ensure Andre-Devtools
add_ace group.admin admintools allow
add_ace group.god admintools allow
```
3. Add `job_keycard` item to your `qb-core/shared/items.lua` (see README)
4. Import `sql/admintools.sql` or let it auto-create on first start
5. Configure `shared/config.lua` — set police jobs, cross-access rules, and admin groups
---
## 💬 Support
Join our Discord for installation help: **[https://discord.gg/m4E9KWfgY]**
---
*Escrowed resource — core logic is protected. `shared/config.lua` remains fully open for customisation.*