README.md aktualisiert
This commit is contained in:
131
README.md
131
README.md
@@ -17,65 +17,9 @@
|
||||
- Vollständige Validierung & Fehlerausgaben
|
||||
- Debug-Modus & Versionsprüfung
|
||||
- Anpassbare Nachrichten, Farben, Limits, Speicherpfade, Archiv-Intervall, Cooldowns, Rechte
|
||||
## Sprachdateien (lang_de.yml / lang_en.yml)
|
||||
|
||||
Alle Plugin-Texte und Nachrichten werden in den Sprachdateien verwaltet. Du kannst sie komplett anpassen und eigene Farben, Prefixe und Texte nutzen.
|
||||
|
||||
**Farbcodes:**
|
||||
- `&` (z.B. &a = Grün, &c = Rot, &e = Gelb, &7 = Grau)
|
||||
- HEX: `&#RRGGBB` (z.B. &#FFD700 = Gold)
|
||||
|
||||
**Platzhalter:**
|
||||
- `{id}`: Ticket-ID
|
||||
- `{player}`: Spielername
|
||||
- `{claimer}`: Name des Supporters
|
||||
- `{category}`: Ticket-Kategorie
|
||||
- `{priority}`: Ticket-Priorität
|
||||
- `{server}`: Servername (BungeeCord)
|
||||
- `{message}`: Ticket-Beschreibung
|
||||
- `{comment}`: Kommentar des Supports
|
||||
- `{count}`: Anzahl (Tickets, FAQs, etc.)
|
||||
- `{reason}`: Grund (Blacklist)
|
||||
- `{author}`: Name des Kommentarautors
|
||||
- `{time}`: Zeitstempel
|
||||
- `{page}`: Seitenzahl (GUI)
|
||||
- `{total}`: Gesamtanzahl (Tickets/FAQs)
|
||||
- `{value}`: Wert für Lore-Labels (z.B. Ersteller, Kategorie)
|
||||
|
||||
**Befehls-Platzhalter:**
|
||||
- `{cmd_create}`: Ticket erstellen
|
||||
- `{cmd_list}`: Ticket-Liste anzeigen
|
||||
- `{cmd_comment}`: Kommentar hinzufügen
|
||||
- `{cmd_rate}`: Ticket bewerten
|
||||
- `{cmd_claim}`: Ticket annehmen
|
||||
- `{cmd_close}`: Ticket schließen
|
||||
- `{cmd_forward}`: Ticket weiterleiten
|
||||
- `{cmd_reload}`: Konfiguration neu laden
|
||||
- `{cmd_stats}`: Statistiken anzeigen
|
||||
- `{cmd_archive}`: Tickets archivieren
|
||||
- `{cmd_migrate}`: Speicherart wechseln
|
||||
- `{cmd_export}`: Tickets exportieren
|
||||
- `{cmd_import}`: Tickets importieren
|
||||
- `{cmd_blacklist}`: Blacklist verwalten
|
||||
- `{cmd_setpriority}`: Priorität ändern
|
||||
- `{cmd_faq}`: FAQ-System
|
||||
- `{cmd_top}`: Top-Ersteller
|
||||
|
||||
**Wofür stehen die Variablen?**
|
||||
- Sie werden automatisch durch die passenden Werte ersetzt, z.B. `{id}` durch die Ticketnummer, `{player}` durch den Spielernamen.
|
||||
- Die `{cmd_X}`-Platzhalter werden je nach Spracheinstellung (de/en/both) durch den richtigen Befehl ersetzt.
|
||||
- Alle Variablen findest du in der lang_de.yml und lang_en.yml, jeweils im Kontext der Nachricht.
|
||||
|
||||
**Beispiel:**
|
||||
```
|
||||
- Dynamische GUI mit Seiten-System
|
||||
- Kategorie- und Prioritäten-System
|
||||
- Bewertungs- und Kommentar-System
|
||||
```
|
||||
→ Zeigt nach dem Erstellen: „Ticket #123 wurde erfolgreich erstellt!“
|
||||
|
||||
**Tipp:**
|
||||
- Du kannst eigene Nachrichten und Farben setzen.
|
||||
- Die Sprachdatei ist sehr ausführlich kommentiert und enthält alle verfügbaren Variablen.
|
||||
- Offline-Benachrichtigungen
|
||||
- Discord-Webhook mit Embeds & Rollen-Ping
|
||||
- Blacklist für Spieler
|
||||
@@ -138,6 +82,78 @@ Alle Plugin-Texte und Nachrichten werden in den Sprachdateien verwaltet. Du kann
|
||||
|
||||
---
|
||||
|
||||
## Mehrsprachigkeit
|
||||
|
||||
TicketSystem unterstützt drei Sprachmodi, die über einen einzigen Schlüssel in der `config.yml` gesteuert werden:
|
||||
|
||||
```yaml
|
||||
language: de # Deutsch – deutsche Texte & deutsche Befehlsnamen
|
||||
language: en # Englisch – englische Texte & englische Befehlsnamen
|
||||
language: both # Beides – deutsche Texte & beide Befehlsnamen gleichzeitig
|
||||
```
|
||||
|
||||
> `command-language` existiert nicht mehr. Alle Einstellungen laufen über `language`.
|
||||
|
||||
### Befehlsnamen je Sprachmodus
|
||||
|
||||
| Interner Schlüssel | `language: de` | `language: en` | `language: both` |
|
||||
|--------------------|---------------------------|-------------------------|-------------------------------------------|
|
||||
| `create` | `/ticket erstellen` | `/ticket create` | `/ticket create §8(§7erstellen§8)` |
|
||||
| `list` | `/ticket liste` | `/ticket list` | `/ticket list §8(§7liste§8)` |
|
||||
| `comment` | `/ticket kommentar` | `/ticket comment` | `/ticket comment §8(§7kommentar§8)` |
|
||||
| `rate` | `/ticket bewerten` | `/ticket rate` | `/ticket rate §8(§7bewerten§8)` |
|
||||
| `claim` | `/ticket übernehmen` | `/ticket claim` | `/ticket claim §8(§7übernehmen§8)` |
|
||||
| `close` | `/ticket schließen` | `/ticket close` | `/ticket close §8(§7schließen§8)` |
|
||||
| `forward` | `/ticket weiterleiten` | `/ticket forward` | `/ticket forward §8(§7weiterleiten§8)` |
|
||||
| `reload` | `/ticket neuladen` | `/ticket reload` | `/ticket reload §8(§7neuladen§8)` |
|
||||
| `stats` | `/ticket statistik` | `/ticket stats` | `/ticket stats §8(§7statistik§8)` |
|
||||
| `archive` | `/ticket archivieren` | `/ticket archive` | `/ticket archive §8(§7archivieren§8)` |
|
||||
| `migrate` | `/ticket migrieren` | `/ticket migrate` | `/ticket migrate §8(§7migrieren§8)` |
|
||||
| `export` | `/ticket exportieren` | `/ticket export` | `/ticket export §8(§7exportieren§8)` |
|
||||
| `import` | `/ticket importieren` | `/ticket import` | `/ticket import §8(§7importieren§8)` |
|
||||
| `blacklist` | `/ticket sperrliste` | `/ticket blacklist` | `/ticket blacklist §8(§7sperrliste§8)` |
|
||||
| `setpriority` | `/ticket priorität` | `/ticket setpriority` | `/ticket setpriority §8(§7priorität§8)` |
|
||||
| `faq` | `/ticket faq` | `/ticket faq` | `/ticket faq` |
|
||||
| `top` | `/ticket top` | `/ticket top` | `/ticket top` |
|
||||
|
||||
### `{cmd_X}`-Platzhalter in den Sprachdateien
|
||||
|
||||
Alle Hilfetexte, Fehlermeldungen und GUI-Hinweise in `lang_de.yml` / `lang_en.yml` verwenden `{cmd_X}`-Platzhalter statt fester Befehlsnamen. Beim Anzeigen ersetzt der `LanguageManager` diese automatisch anhand des aktiven Sprachmodus.
|
||||
|
||||
| Platzhalter | Beispiel-Ausgabe (`language: en`) |
|
||||
|----------------------|-----------------------------------|
|
||||
| `{cmd_create}` | `/ticket create` |
|
||||
| `{cmd_list}` | `/ticket list` |
|
||||
| `{cmd_comment}` | `/ticket comment` |
|
||||
| `{cmd_rate}` | `/ticket rate` |
|
||||
| `{cmd_claim}` | `/ticket claim` |
|
||||
| `{cmd_close}` | `/ticket close` |
|
||||
| `{cmd_forward}` | `/ticket forward` |
|
||||
| `{cmd_reload}` | `/ticket reload` |
|
||||
| `{cmd_stats}` | `/ticket stats` |
|
||||
| `{cmd_archive}` | `/ticket archive` |
|
||||
| `{cmd_migrate}` | `/ticket migrate` |
|
||||
| `{cmd_export}` | `/ticket export` |
|
||||
| `{cmd_import}` | `/ticket import` |
|
||||
| `{cmd_blacklist}` | `/ticket blacklist` |
|
||||
| `{cmd_setpriority}` | `/ticket setpriority` |
|
||||
| `{cmd_faq}` | `/ticket faq` |
|
||||
| `{cmd_top}` | `/ticket top` |
|
||||
|
||||
**Verwendungsbeispiel in der Sprachdatei:**
|
||||
```yaml
|
||||
help:
|
||||
create: "&e{cmd_create} [Kategorie] <Text> &7– Neues Ticket erstellen"
|
||||
# → language: de gibt aus: /ticket erstellen [Kategorie] <Text>
|
||||
# → language: en gibt aus: /ticket create [Kategorie] <Text>
|
||||
```
|
||||
|
||||
### GUI-Sprachanpassung
|
||||
|
||||
Seit dieser Version sind auch alle **GUI-Texte** vollständig sprachabhängig – Inventar-Titel, Item-Lore-Labels und Action-Buttons werden aus `gui.item.*` in der aktiven Sprachdatei geladen. Nach einem `/ticket reload` mit geändertem `language`-Wert wechselt die gesamte Oberfläche sofort.
|
||||
|
||||
---
|
||||
|
||||
## FAQ-System
|
||||
|
||||
Das FAQ-System ermöglicht es Admins, häufige Fragen und Antworten direkt im Spiel zu verwalten. Spieler können die FAQs per GUI oder Befehl einsehen.
|
||||
@@ -271,7 +287,6 @@ TicketSystem bietet volle Unterstützung für BungeeCord-Netzwerke:
|
||||
| Bewertungs-System | ✔️ | ✖️ | ✖️ |
|
||||
| Update-Checker | ✔️ | ✖️ | ✖️ |
|
||||
| BungeeCord-Unterstützung | ✔️ | ✖️ | ✖️ |
|
||||
| 2-Sprachigkeit (de/en) | ✔️ | ✖️ | ✖️ |
|
||||
|
||||
Legende: ✔️ Vollständige Unterstützung · ⚠️ Eingeschränkt · ✖️ Nicht vorhanden
|
||||
|
||||
|
||||
Reference in New Issue
Block a user