# 🔒 dv_prison — Vollständiges Gefängnissystem mit Sozialstunden & NUI Panel | ESX | FiveM
Inhaftiere Spieler, verhänge Sozialstunden und verwalte alles über ein modernes Admin-Panel – mit Ausbruchssystem, Gefängnisarbeit, Inventarschutz, Reconnect-Persistenz und Discord-fähigem Logging.
---
## 💡 Was ist dv_prison?
dv_prison ist ein vollständiges, datenbankgestütztes Gefängnissystem für ESX-Server. Autorisierte Beamte können Spieler direkt über ein ingame NUI-Panel inhaftieren oder zu Sozialstunden verurteilen. Gefangene erhalten Gefängniskleidung, ihr Inventar wird sicher verwahrt und bei Entlassung vollständig wiederhergestellt. Das System läuft nach Server-Restarts weiter – Gefangene und Sozialstunden-Spieler werden beim Reconnect automatisch fortgesetzt.
---
## ⚙️ Features auf einen Blick
-
🖥️ **Modernes NUI Admin-Panel** – vollständige Verwaltung mit Tabs für Gefangene, Sozialstunden, Inhaftierung und Statistiken
-
🦺 **Sozialstunden-System** – alternative Sanktion mit konfigurierbaren Aufgaben und eigenem Standort
-
🏋️ **Gefängnisarbeit** – Spieler können durch Arbeiten ihre Haftzeit aktiv reduzieren
-
🏃 **Ausbruchssystem** – konfigurierbare Ausbruchszonen mit Erfolgswahrscheinlichkeit und Strafzuschlag
-
👔 **Gefängniskleidung** – automatischer Outfit-Wechsel bei Inhaftierung und Entlassung
-
🎽 **Sozialstunden-Kleidung** – eigene Warnwesten-Kleidung für den Sozialstunden-Bereich
-
💾 **Inventar-Sicherung** – vollständiges Inventar, Waffen und Bargeld werden bei Inhaftierung gesichert und bei Entlassung wiederhergestellt
-
🔄 **Reconnect-Persistenz** – Gefangenenstatus bleibt nach Disconnect/Reconnect und Server-Restart erhalten
-
📊 **Statistiken-Tab** – Top-Beamte, häufige Delikte, Gesamtübersicht und Durchschnittszeiten
-
📍 **Proximity-Spielerauswahl** – Spieler in der Nähe werden direkt im Panel angezeigt
-
⏱️ **Zeit-Management** – Zeit hinzufügen, vorzeitig entlassen oder per Command freigeben
-
🚔 **Polizei-Benachrichtigungen** – alle Beamten werden bei Inhaftierung, Ausbruch und Entlassung informiert
-
🏷️ **Prison HUD** – permanente Zeitanzeige für Gefangene mit Status, Cooldown-Anzeige und Fortschrittsbalken
-
🗂️ **Datenbankgestützt** – alle Zustände werden in `prison_data` und `community_service_data` gespeichert
-
🐛 **Debug-Modus** – detailliertes Logging aller Aktionen per Config-Option
---
## 🖥️ NUI Admin-Panel
Das Panel öffnet sich per `/prison` Command und bietet vier Tabs:
**🔒 Aktiver Vollzug** – Übersicht aller inhaftierten Spieler mit verbleibender Zeit, Grund, zuständigem Beamten und Optionen zum Entlassen oder Zeithinzufügen.
**🦺 Sozialstunden** – Übersicht aller Spieler in Sozialstunden mit Aufgabenfortschritt und vorzeitiger Entlassoption.
**🏛 Haft / Sozialstunden** – Spieler inhaftieren oder zu Sozialstunden verurteilen. Spieler aus der Proximity-Liste wählen oder per ID suchen, Maßnahme und Zeitdauer/Aufgabenzahl festlegen, Grund eintragen und bestätigen.
**📈 Statistiken** – Top-Beamte nach Anzahl Inhaftierungen, häufigste Delikte, Gesamtanzahl Gefangener, Sozialstunden-Spieler sowie durchschnittliche und gesamte Restzeit.
---
## 🦺 Sozialstunden-System
Als Alternative zur klassischen Haftstrafe können Beamte Spieler zu Sozialstunden verurteilen. Spieler werden an einen konfigurierbaren Standort teleportiert, erhalten Arbeitskleidung und müssen eine festgelegte Anzahl an Aufgaben erledigen. Der Fortschritt wird im HUD angezeigt und in der Datenbank gespeichert. Nach Abschluss aller Aufgaben erfolgt die automatische Entlassung.
---
## 🏋️ Gefängnisarbeit
Gefangene können an konfigurierten Arbeitsstandorten Aufgaben ausführen und ihre Haftzeit dadurch aktiv reduzieren. Jede Arbeit bringt eine konfigurierbare Zeitreduktion. Eine maximale Gesamtreduktion pro Inhaftierung ist einstellbar um Missbrauch zu verhindern.
---
## 🏃 Ausbruchssystem
An konfigurierten Ausbruchszonen können Gefangene einen Ausbruchsversuch starten. Die Erfolgswahrscheinlichkeit ist frei einstellbar. Bei Erfolg wird der Spieler entlassen und alle Polizeibeamten werden benachrichtigt. Bei Scheitern wird eine konfigurierbare Strafzeit addiert.
---
## 🔒 Serverseitige Sicherheit
Alle kritischen Aktionen – Inhaftieren, Entlassen, Zeitänderungen – werden serverseitig geprüft. Nur Spieler mit autorisiertem Job oder Gruppe können das System nutzen. Inventar und Waffen werden serverseitig gesichert, eine clientseitige Manipulation ist nicht möglich. Gefangene die den Gefängnisbereich verlassen werden automatisch zurückteleportiert.
---
## 💻 Commands
| Command | Berechtigung | Beschreibung |
|---|---|---|
| `/prison` | Polizei / Admin | Hauptmenü öffnen |
| `/unjail [ID]` | Polizei / Admin | Gefangenen entlassen |
| `/releasecs [ID]` | Polizei / Admin | Von Sozialstunden entlassen |
| `/prisonstats` | Admin | Schnelle Statistik-Übersicht |
| `/releaseall` | Superadmin | Notfall-Entlassung aller Personen |
| `/prisonhelp` | Polizei / Admin | Alle verfügbaren Commands anzeigen |
| `/testjailme [Min]` | Admin | Test-Inhaftierung |
| `/testcsme [Aufgaben]` | Admin | Test-Sozialstunden |
| `/stoptest` | Admin | Aktiven Test beenden |
---
## 📦 Abhängigkeiten
| Pflicht | Optional |
|---|---|
| es_extended (ESX Legacy) | – |
| oxmysql | – |
---
## 🚀 Installation in 4 Schritten
1. Ordner in `resources/` legen
2. `ensure dv_prison` in die `server.cfg` eintragen
- SQL-Dateien importieren – Tabellen werden beim Start auch **automatisch** angelegt
4. `config.lua` anpassen – Koordinaten, Jobs, Ausbruchszonen & fertig!
---
## ⚙️ Konfiguration auf einen Blick
| Option | Beschreibung |
|---|---|
| `Config.PrisonLocation` | Teleport-Koordinaten bei Inhaftierung |
| `Config.ReleaseLocation` | Koordinaten bei Entlassung |
| `Config.PrisonRadius` | Gefängnisbereich-Radius für Grenzenkontrolle |
| `Config.EscapeZones` | Ausbruchszonen mit Name und Radius |
| `Config.EscapeChance` | Erfolgswahrscheinlichkeit in % |
| `Config.EscapeFailurePenalty` | Strafzeit bei gescheitertem Ausbruch in Sekunden |
| `Config.Jobs` | Arbeitsstandorte mit Szenario, Belohnung und Beschreibung |
| `Config.WorkReward` | Zeitreduktion pro Arbeitseinheit in Sekunden |
| `Config.MaxWorkReward` | Maximale Gesamtreduktion pro Inhaftierung |
| `Config.EnableCommunityService` | Sozialstunden-System aktivieren |
| `Config.CommunityServiceTasks` | Aufgabenstandorte mit Szenario und Beschreibung |
| `Config.CommunityServiceRadius` | Erlaubter Bewegungsradius für Sozialstunden |
| `Config.PrisonOutfits` | Gefängniskleidung für männliche und weibliche Chars |
| `Config.CommunityServiceOutfits` | Sozialstunden-Kleidung für männliche und weibliche Chars |
| `Config.AuthorizedGroups` | Admin-Gruppen mit Zugriffsrecht |
| `Config.AuthorizedJobs` | Jobs mit Zugriffsrecht |
| `Config.KeepItems` | Items die bei Inhaftierung behalten werden |
| `Config.NotifyPolice` | Beamte bei Inhaftierungen benachrichtigen |
| `Config.EnableDebug` | Debug-Logging aktivieren |
Alle Einstellungen befinden sich in einer einzigen zentralen `config.lua`.
---
## 💬 Support
Bei Fragen, Problemen oder Feature-Wünschen erreichst du uns jederzeit über unseren Discord:
👉 https://discord.gg/hqBQt8SnwA