From 1a8121236f078ae85a53c5057fea0c7ad32deb75 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Wed, 25 Feb 2026 18:28:09 +0000 Subject: [PATCH] README.md aktualisiert --- README.md | 131 ++++++++++++++++++++++++++++++------------------------ 1 file changed, 73 insertions(+), 58 deletions(-) diff --git a/README.md b/README.md index e2e92c0..ff87ea6 100644 --- a/README.md +++ b/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] &7– Neues Ticket erstellen" + # → language: de gibt aus: /ticket erstellen [Kategorie] + # → language: en gibt aus: /ticket create [Kategorie] +``` + +### 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