README.md aktualisiert
This commit is contained in:
250
README.md
250
README.md
@@ -1,99 +1,219 @@
|
|||||||
# TicketSystem
|
<div align="center">
|
||||||
|
|
||||||
[]() []() []()
|
# 🎫 TicketSystem
|
||||||
|
|
||||||
**TicketSystem** ist das umfassende Support- und Feedback-Plugin für Minecraft-Server. Es bietet flexible Speicherung (MySQL oder Datei), automatische Archivierung, Migration, Export/Import, Statistiken, vollständige Validierung, Debug-Modus, eine übersichtliche config.yml mit Versionsprüfung und eine dynamische GUI.
|
### Das flexible, moderne Support- und Feedback-System für Minecraft-Server
|
||||||
|
|
||||||
## Features (Details)
|
[](https://www.spigotmc.org/)
|
||||||
|
[](https://adoptium.net/)
|
||||||
|
[](https://github.com/)
|
||||||
|
[](LICENSE)
|
||||||
|
|
||||||
- **MySQL oder Datei-Speicherung** (YAML/JSON) – jederzeit umschaltbar, Migration und Backup inklusive
|
**⭐ Zero-Lag · Production Ready · Fully Customizable ⭐**
|
||||||
- **Automatische Backups & Migration** zwischen Speicherarten, Datenverlust ausgeschlossen
|
|
||||||
- **Export/Import** von Tickets (z.B. für Server-Umzüge oder Testumgebungen)
|
|
||||||
- **Statistiken & Archivierung** (inkl. automatischer Archivierung nach Zeitplan, manuelles Archivieren möglich)
|
|
||||||
- **Konfigurierbare Speicherpfade** für Daten und Archive (relativ oder absolut)
|
|
||||||
- **Vollständige Validierung** der Daten beim Laden (Fehlerausgabe im Log & Chat, fehlerhafte Tickets werden übersprungen)
|
|
||||||
- **Bessere Fehlerausgaben** für Admins im Chat und Log (inkl. Validierungs- und Speicherfehler)
|
|
||||||
- **Debug-Modus & Versionsprüfung** für Entwickler und Admins (veraltete config.yml wird erkannt)
|
|
||||||
- **Komplett anpassbar** (Nachrichten, Farben, Limits, Speicherpfade, Archiv-Intervall, Cooldowns, Rechte)
|
|
||||||
- **Unit-Tests** für die Speicher-Logik (maximale Zuverlässigkeit)
|
|
||||||
- **Dynamische GUI**: Die Ticket-GUI passt sich automatisch der Ticketanzahl an (bis zu 54 Tickets pro Seite, Blättern bei Bedarf)
|
|
||||||
- **Performance**: Optimiert für große Server, alle Operationen laufen asynchron und ressourcenschonend
|
|
||||||
- **Support & Erweiterbarkeit**: Sauberer Code, viele Hooks für eigene Erweiterungen
|
|
||||||
|
|
||||||
## Einrichtung & Konfiguration
|
[Features](#-features) · [Installation](#-installation) · [Konfiguration](#-konfiguration) · [Befehle](#-befehle--permissions) · [FAQ](#-faq) · [Support](#-support)
|
||||||
|
|
||||||
1. **config.yml** anpassen:
|
</div>
|
||||||
- `data-file`, `archive-file`: Speicherorte für Tickets und Archive (relativ oder absolut)
|
|
||||||
- `use-mysql`: true/false
|
|
||||||
- `auto-archive-interval-hours`: Intervall für automatische Archivierung (0 = aus)
|
|
||||||
- `debug`: true/false für ausführliche Logs
|
|
||||||
- `version`: Versionsprüfung für die config.yml
|
|
||||||
- Nachrichten, Farben, Limits, Cooldowns, Rechte individuell anpassbar
|
|
||||||
2. **MySQL** (optional): Zugangsdaten eintragen
|
|
||||||
3. **/ticket**-Befehl nutzen (inkl. Admin-Tools für Migration, Export, Import, Statistik, Archiv, Reload)
|
|
||||||
|
|
||||||
## Kompatibilität & Zielgruppe
|
---
|
||||||
|
|
||||||
- Minecraft 1.18.x – 1.21.x (Paper, Spigot, Purpur)
|
## 📋 Über TicketSystem
|
||||||
- Java 17+
|
|
||||||
- YAML/JSON oder MySQL/MariaDB
|
|
||||||
- Für Community-Server, Citybuild, Minigames, Survival, u.v.m.
|
|
||||||
|
|
||||||
## Support & Kontakt
|
**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.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Befehle & Rechte
|
## ✨ Features
|
||||||
|
|
||||||
- `/ticket` – Hauptbefehl für alle Ticket-Funktionen
|
| Feature | Beschreibung |
|
||||||
- `/ticket` – Übersicht aller offenen Tickets (GUI)
|
|---|---|
|
||||||
- `/ticket create <Nachricht>` – Erstellt ein neues Ticket
|
| 🗄️ **MySQL & Datei-Speicherung** | YAML/JSON oder MySQL/MariaDB – jederzeit umschaltbar, Migration & Backup inklusive |
|
||||||
- `/ticket claim <ID>` – Ticket übernehmen
|
| 🔄 **Automatische Migration** | Sicheres Wechseln zwischen Speicherarten, Datenverlust ausgeschlossen |
|
||||||
- `/ticket close <ID>` – Ticket schließen
|
| 📤 **Export / Import** | Tickets einfach zwischen Servern oder Instanzen übertragen |
|
||||||
- `/ticket forward <ID> <Spieler>` – Ticket weiterleiten
|
| 📊 **Statistiken & Archivierung** | Übersichtliche Auswertung, automatische & manuelle Archivierung nach Zeitplan |
|
||||||
- `/ticket archive` – Tickets archivieren (manuell)
|
| ✅ **Vollständige Validierung** | Fehlerhafte Tickets werden erkannt, gemeldet und übersprungen |
|
||||||
- `/ticket export <Datei>` – Tickets exportieren
|
| 🐛 **Debug-Modus** | Ausführliche Logs für Entwickler und Admins, erkennt veraltete `config.yml` |
|
||||||
- `/ticket import <Datei>` – Tickets importieren
|
| 🖥️ **Dynamische GUI** | Passt sich automatisch der Ticketanzahl an – bis zu 54 Tickets pro Seite mit Blättern |
|
||||||
- `/ticket migrate <tomysql|tofile>` – Migration zwischen Speicherarten
|
| ⚡ **Performance** | Alle Operationen laufen asynchron – optimiert für große Server |
|
||||||
- `/ticket stats` – Statistiken anzeigen
|
| 🔧 **Komplett anpassbar** | Nachrichten, Farben, Limits, Cooldowns, Rechte – alles in der `config.yml` |
|
||||||
- `/ticket reload` – Konfiguration neu laden
|
| 🧪 **Unit-Tests** | Getestete Speicher-Logik für maximale Zuverlässigkeit |
|
||||||
|
|
||||||
- Rechte:
|
---
|
||||||
- `ticket.admin` – Zugriff auf alle Admin- und Management-Funktionen
|
|
||||||
- `ticket.use` – (Standard) Ticket erstellen und eigene Tickets verwalten
|
|
||||||
|
|
||||||
## Beispiel-Konfiguration (Ausschnitt)
|
## 📦 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
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>📄 Beispiel: config.yml (klicken zum Ausklappen)</b></summary>
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
|
# TicketSystem - Hauptkonfiguration
|
||||||
|
# © 2026 Viper Plugins
|
||||||
|
|
||||||
version: "2.0"
|
version: "2.0"
|
||||||
debug: false
|
debug: false
|
||||||
|
|
||||||
|
# Speicherung
|
||||||
data-file: "data.yml"
|
data-file: "data.yml"
|
||||||
archive-file: "archive.yml"
|
archive-file: "archive.yml"
|
||||||
use-mysql: false
|
use-mysql: false
|
||||||
use-json: false
|
use-json: false
|
||||||
auto-archive-interval-hours: 24
|
|
||||||
|
# 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"
|
prefix: "&8[&6Ticket&8] &r"
|
||||||
ticket-cooldown: 60
|
ticket-cooldown: 60 # Sekunden zwischen Tickets
|
||||||
max-description-length: 100
|
max-description-length: 100
|
||||||
max-open-tickets-per-player: 2
|
max-open-tickets-per-player: 2
|
||||||
```
|
```
|
||||||
|
|
||||||
## FAQ
|
</details>
|
||||||
|
|
||||||
**Kann ich zwischen MySQL und Datei-Speicherung wechseln?**
|
---
|
||||||
> Ja, jederzeit per Migrationstool oder Befehl `/ticket migrate ...`.
|
|
||||||
|
|
||||||
**Wie viele Tickets passen in die GUI?**
|
## 💬 Befehle & Permissions
|
||||||
> Bis zu 54 pro Seite, bei mehr Tickets wird geblättert.
|
|
||||||
|
|
||||||
**Wie kann ich Nachrichten und Limits anpassen?**
|
### Spieler-Befehle
|
||||||
> Alle Texte, Farben und Limits findest du in der `config.yml`.
|
| Befehl | Beschreibung | Permission |
|
||||||
|
|---|---|---|
|
||||||
|
| `/ticket` | GUI mit allen offenen Tickets öffnen | `ticket.use` |
|
||||||
|
| `/ticket create <Nachricht>` | Neues Ticket erstellen | `ticket.use` |
|
||||||
|
| `/ticket close <ID>` | Eigenes Ticket schließen | `ticket.use` |
|
||||||
|
|
||||||
**Wie aktiviere ich den Debug-Modus?**
|
### Admin-Befehle
|
||||||
> Setze `debug: true` in der `config.yml`.
|
| Befehl | Beschreibung | Permission |
|
||||||
|
|---|---|---|
|
||||||
|
| `/ticket claim <ID>` | Ticket übernehmen | `ticket.admin` |
|
||||||
|
| `/ticket forward <ID> <Spieler>` | Ticket weiterleiten | `ticket.admin` |
|
||||||
|
| `/ticket archive` | Tickets manuell archivieren | `ticket.admin` |
|
||||||
|
| `/ticket export <Datei>` | Tickets exportieren | `ticket.admin` |
|
||||||
|
| `/ticket import <Datei>` | Tickets importieren | `ticket.admin` |
|
||||||
|
| `/ticket migrate <tomysql\|tofile>` | Speicherart migrieren | `ticket.admin` |
|
||||||
|
| `/ticket stats` | Statistiken anzeigen | `ticket.admin` |
|
||||||
|
| `/ticket reload` | Konfiguration neu laden | `ticket.admin` |
|
||||||
|
|
||||||
**Wie kann ich Tickets exportieren/importieren?**
|
### Permissions-Übersicht
|
||||||
> Mit `/ticket export <Datei>` und `/ticket import <Datei>`.
|
```
|
||||||
|
ticket.use → Ticket erstellen und eigene Tickets verwalten (Standard für alle Spieler)
|
||||||
|
ticket.admin → Zugriff auf alle Admin- und Management-Funktionen
|
||||||
|
```
|
||||||
|
|
||||||
## Support & Kontakt
|
---
|
||||||
|
|
||||||
Du hast Fragen, Feedback oder möchtest das Plugin erweitern? Melde dich direkt bei **Viper Plugins** – wir helfen schnell und unkompliziert!
|
## ❓ FAQ
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Kann ich zwischen MySQL und Datei-Speicherung wechseln?</b></summary>
|
||||||
|
|
||||||
|
Ja! Einfach per `/ticket migrate tomysql` oder `/ticket migrate tofile`. Das Plugin migriert alle Daten automatisch und sicher – kein Datenverlust.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Wie viele Tickets passen in die GUI?</b></summary>
|
||||||
|
|
||||||
|
Bis zu 54 Tickets pro Seite. Bei mehr Tickets wird automatisch geblättert.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Werden automatisch Backups erstellt?</b></summary>
|
||||||
|
|
||||||
|
Ja, bei jedem Speicherwechsel und regelmäßig nach dem konfigurierten Archiv-Intervall.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Wie aktiviere ich den Debug-Modus?</b></summary>
|
||||||
|
|
||||||
|
Setze `debug: true` in der `config.yml` und nutze anschließend `/ticket reload`.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary><b>Wie exportiere/importiere ich Tickets?</b></summary>
|
||||||
|
|
||||||
|
Mit `/ticket export <Dateiname>` und `/ticket import <Dateiname>` – ideal für Server-Umzüge oder Testumgebungen.
|
||||||
|
</details>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📊 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
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📜 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 |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
|
||||||
|
**© 2026 Viper Plugins · TicketSystem · Alle Rechte vorbehalten**
|
||||||
|
|
||||||
|
Wenn TicketSystem deinen Server bereichert hat, freuen wir uns über einen ⭐ **Star** auf spigotmc!
|
||||||
|
|
||||||
|
</div>
|
||||||
Reference in New Issue
Block a user