# 🎫 TicketSystem
### Das flexible, moderne Support- und Feedback-System für Minecraft-Server
[](https://www.spigotmc.org/)
[](https://adoptium.net/)
[](https://github.com/)
[](LICENSE)
**⭐ Zero-Lag · Production Ready · Fully Customizable ⭐**
[Features](#-features) · [Installation](#-installation) · [Konfiguration](#-konfiguration) · [Befehle](#-befehle--permissions) · [FAQ](#-faq) · [Support](#-support)
---
## 📋 Über TicketSystem
**TicketSystem** ist die Komplettlösung für Support, Bug-Reports und Feedback auf deinem Minecraft-Server. Spieler erstellen Tickets direkt im Spiel – Admins verwalten alles komfortabel per GUI oder Befehl. Optimiert für kleine und große Server, vollständig konfigurierbar und vollgepackt mit Profi-Features.
---
## ✨ Features
| Feature | Beschreibung |
|---|---|
| 🗄️ **MySQL & Datei-Speicherung** | YAML/JSON oder MySQL/MariaDB – jederzeit umschaltbar, Migration & Backup inklusive |
| 🔄 **Automatische Migration** | Sicheres Wechseln zwischen Speicherarten, Datenverlust ausgeschlossen |
| 📤 **Export / Import** | Tickets einfach zwischen Servern oder Instanzen übertragen |
| 📊 **Statistiken & Archivierung** | Übersichtliche Auswertung, automatische & manuelle Archivierung nach Zeitplan |
| ✅ **Vollständige Validierung** | Fehlerhafte Tickets werden erkannt, gemeldet und übersprungen |
| 🐛 **Debug-Modus** | Ausführliche Logs für Entwickler und Admins, erkennt veraltete `config.yml` |
| 🖥️ **Dynamische GUI** | Passt sich automatisch der Ticketanzahl an – bis zu 54 Tickets pro Seite mit Blättern |
| ⚡ **Performance** | Alle Operationen laufen asynchron – optimiert für große Server |
| 🔧 **Komplett anpassbar** | Nachrichten, Farben, Limits, Cooldowns, Rechte – alles in der `config.yml` |
| 🧪 **Unit-Tests** | Getestete Speicher-Logik für maximale Zuverlässigkeit |
---
## 📦 Installation
> **Voraussetzungen:** Paper / Spigot / Purpur `1.18.x – 1.21.x` · Java `17+` · optional MySQL/MariaDB
**Schritt 1 – Plugin installieren**
```
1. Lade die neueste TicketSystem.jar von den Releases herunter
2. Verschiebe die .jar in den /plugins Ordner deines Servers
3. Starte den Server neu (kein /reload verwenden!)
4. Die Konfigurationsdateien werden automatisch generiert
```
**Schritt 2 – Konfiguration anpassen**
```
1. Öffne plugins/TicketSystem/config.yml
2. Passe Speicherpfade, Nachrichten, Limits und Farben an
3. Aktiviere MySQL falls gewünscht und trage Zugangsdaten ein
4. Nutze /ticket reload um Änderungen zu übernehmen
```
**Fertig!** Dein Support-System ist einsatzbereit. 🎉
---
## ⚙️ Konfiguration
📄 Beispiel: config.yml (klicken zum Ausklappen)
```yaml
# TicketSystem - Hauptkonfiguration
# © 2026 Viper Plugins
version: "2.0"
debug: false
# Speicherung
data-file: "data.yml"
archive-file: "archive.yml"
use-mysql: false
use-json: false
# MySQL (nur wenn use-mysql: true)
mysql:
host: "localhost"
port: 3306
database: "tickets"
user: "root"
password: "password"
useSSL: false
# Archivierung
auto-archive-interval-hours: 24 # 0 = deaktiviert
# Allgemein
prefix: "&8[&6Ticket&8] &r"
ticket-cooldown: 60 # Sekunden zwischen Tickets
max-description-length: 100
max-open-tickets-per-player: 2
```
---
## 💬 Befehle & Permissions
### Spieler-Befehle
| Befehl | Beschreibung | Permission |
|---|---|---|
| `/ticket` | GUI mit allen offenen Tickets öffnen | `ticket.use` |
| `/ticket create ` | Neues Ticket erstellen | `ticket.use` |
| `/ticket close ` | Eigenes Ticket schließen | `ticket.use` |
### Admin-Befehle
| Befehl | Beschreibung | Permission |
|---|---|---|
| `/ticket claim ` | Ticket übernehmen | `ticket.admin` |
| `/ticket forward ` | Ticket weiterleiten | `ticket.admin` |
| `/ticket archive` | Tickets manuell archivieren | `ticket.admin` |
| `/ticket export ` | Tickets exportieren | `ticket.admin` |
| `/ticket import ` | Tickets importieren | `ticket.admin` |
| `/ticket migrate ` | Speicherart migrieren | `ticket.admin` |
| `/ticket stats` | Statistiken anzeigen | `ticket.admin` |
| `/ticket reload` | Konfiguration neu laden | `ticket.admin` |
### Permissions-Übersicht
```
ticket.use → Ticket erstellen und eigene Tickets verwalten (Standard für alle Spieler)
ticket.admin → Zugriff auf alle Admin- und Management-Funktionen
```
---
## ❓ FAQ
Kann ich zwischen MySQL und Datei-Speicherung wechseln?
Ja! Einfach per `/ticket migrate tomysql` oder `/ticket migrate tofile`. Das Plugin migriert alle Daten automatisch und sicher – kein Datenverlust.
Wie viele Tickets passen in die GUI?
Bis zu 54 Tickets pro Seite. Bei mehr Tickets wird automatisch geblättert.
Werden automatisch Backups erstellt?
Ja, bei jedem Speicherwechsel und regelmäßig nach dem konfigurierten Archiv-Intervall.
Wie aktiviere ich den Debug-Modus?
Setze `debug: true` in der `config.yml` und nutze anschließend `/ticket reload`.
Wie exportiere/importiere ich Tickets?
Mit `/ticket export ` und `/ticket import ` – ideal für Server-Umzüge oder Testumgebungen.
---
## 📊 Vergleich
| | **TicketSystem** | SimpleTickets | AdvancedTickets |
|---|:---:|:---:|:---:|
| Speicher-Migration | ✅ Vollständig | ⚠️ Nur manuell | ❌ |
| Automatische Backups | ✅ | ⚠️ Teilweise | ❌ |
| Dynamische GUI | ✅ Modern | ⚠️ Basic | ❌ |
| Archivierung | ✅ Auto & manuell | ⚠️ Nur manuell | ❌ |
| Export / Import | ✅ | ❌ | ❌ |
| Debug-Modus | ✅ | ❌ | ❌ |
| Update-Checker | ✅ | ❌ | ❌ |
| Unit-Tests | ✅ | ❌ | ❌ |
---
## 🆘 Support
Hast du Fragen, einen Bug gefunden oder eine Feature-Idee?
[](https://discord.gg/deinserver)
**Wir antworten in der Regel innerhalb von 24 Stunden!**
Bitte öffne für Bug-Reports ein Issue.
---
## 📜 Kompatibilität
| Plattform | Version |
|---|---|
| Paper | ✅ 1.18.x – 1.21.x |
| Spigot | ✅ 1.18.x – 1.21.x |
| Purpur | ✅ 1.18.x – 1.21.x |
| Folia | ❌ Nicht unterstützt |
---
**© 2026 Viper Plugins · TicketSystem · Alle Rechte vorbehalten**
Wenn TicketSystem deinen Server bereichert hat, freuen wir uns über einen ⭐ **Star** auf spigotmc!