Update von 1.4.1 auf 1.4.2
Vielen Dank, dass du BanMenu verwendest!
Version 1.4.2 führt ein vollständig konfigurierbares Wartungssystem mit dynamischer MOTD- und Server-Icon-Verwaltung ein – inklusive tiefer Minecraft- und Discord-Integration.
Dieses Update konzentriert sich auf die Serververfügbarkeits-Steuerung, den Spielerfluss während Wartungen sowie ein klares visuelles Server-State-Management.
────────────────────────────────────────────────────────
✨ Neue Features
Server State Management (Wartung, MOTD & Icons)
Erweiterter Wartungsmodus
- Neues globales Wartungssystem mit vollständiger Kontrolle über den Spielerzugang.
- Wartung aktivieren mit:

• /maintenance on
• /maintenance on <time>
• /maintenance off

- Unterstützte Zeiteinheiten:

• s (Sekunden)
• m (Minuten)
• h (Stunden)
• d (Tage)

Beispiel: /maintenance on 10m, /maintenance on 2h, /maintenance on 1d
- Wird kein Timer angegeben, wird die Wartung sofort aktiviert und ein konfigurierbarer Kick-Countdown aus der maintenance.yml gestartet.
- Wird ein Timer angegeben, definiert dieser die Dauer des Wartungsmodus, nach der sich die Wartung automatisch deaktiviert.
- Während eines laufenden Countdowns gilt:

• Spieler ohne banmenu.maintenance.join werden nach Ablauf des Countdowns gekickt.
• Spieler mit dieser Permission können auch während des laufenden Countdowns beitreten.

- Alle Kick-, Join- und Wartungsnachrichten sind vollständig konfigurierbar.
────────────────────────────────────────────────────────
⏳ Dynamisches Countdown-System
- Die Anzeige des Countdowns passt sich automatisch an die verbleibende Zeit an:

• > 48 Stunden → nur Tage (z. B. 5 Tage)
• > 24h & ≤ 48h → Tage + Stunden (z. B. 1 Tag 14 Stunden)
• ≥ 2h & ≤ 24h → nur Stunden
• ≥ 60m & < 120m → Stunden + Minuten
• ≥ 2m & < 60m → nur Minuten
• ≥ 60s & < 120s → Minuten + Sekunden
• < 60s → nur Sekunden

- Alle Zeiteinheiten sind in der maintenance.yml frei konfigurierbar.
────────────────────────────────────────────────────────
Wartungs-Bossbar
- Optionale Bossbar, die nur während der Wartung angezeigt wird.
- Zeigt dynamische Countdown-Informationen.
- Sichtbarkeit ist permissions basiert:

• Nur Spieler mit banmenu.maintenance.bossbar.show sehen die Bossbar.

- Text und Darstellung sind vollständig konfigurierbar.
────────────────────────────────────────────────────────
Dynamisches MOTD-System
- Neue motd.yml mit Unterstützung für:

• Mehrere MOTDs
• Zufällige MOTD-Auswahl pro Server-Refresh

- Getrennte MOTD-Pools für:

• Normalbetrieb
• Wartungsmodus

- Wartungs-MOTDs sind nur aktiv, wenn explizit aktiviert.
- Automatischer Wechsel je nach Serverstatus.
────────────────────────────────────────────────────────
️ Dynamisches Server-Icon-System
- Neue Ordnerstruktur server-icons/.
- Unterstützt:

• Mehrere Server-Icons
• Zufälliges Icon pro Server-Refresh

- Getrennte Icon-Pools für:

• Normalbetrieb
• Wartungsmodus

- Wartungs-Icons werden nur verwendet, wenn aktiviert.
- Icons wechseln automatisch mit dem Wartungsstatus.
────────────────────────────────────────────────────────
Discord-Integration
- Alle Wartungsbefehle sind auch über Discord verfügbar:

• /maintenance on
• /maintenance on <time>
• /maintenance off

- Verfügbarkeit über Discord setzt voraus:

• Korrekt eingerichtete Discord-Integration
• Verknüpfte Minecraft-Permissions

- Aktuell erfolgt die Rechteprüfung über Minecraft-Permissions.
- Geplantes Feature: Native rollenbasierte Discord-Permissions.
────────────────────────────────────────────────────────
Neue Permissions
────────────────────────────────────────────────────────
Technische Änderungen
- Neue Konfigurationsdateien:

• maintenance.yml
• motd.yml

- Neue Ordnerstruktur:

• server-icons/

- Alle bestehenden Konfigurationsdateien wurden erweitert.
- Interne Überarbeitungen für:

• Verbessertes Wartungs-State-Handling
• Optimierte Server-Ping-Logik (MOTD & Icons)
• Bessere Synchronisation zwischen Serverstatus und visueller Darstellung

────────────────────────────────────────────────────────
⚠️ Wichtige Hinweise
- Backup vor dem Update dringend empfohlen.
- Dieses Update enthält Soft Breaking Changes.
- Empfohlener Update-Ablauf:

1. Backups aller Konfigurationen erstellen.
2. Server stoppen.
3. BanMenu-Plugin-Ordner löschen.
   • SQLite: Datenbank kann behalten werden.
   • MySQL: Keine Datenbankänderungen notwendig.
4. Server starten, um neue Configs zu generieren.
5. Einstellungen Abschnitt für Abschnitt aus den Backups übertragen.

- Server-Neustart nach dem Update erforderlich.
- Wartungs-Permissions und Discord-Integration vor Produktivbetrieb testen.

BanMenu Update 1.4.1

Update von 1.4.0 auf 1.4.1
Vielen Dank, dass du BanMenu verwendest! Version 1.4.1 bringt neue Features, Verbesserungen und Bugfixes für Discord-Integration und das Unverify-System.

---

✨ Neue Features

Discord Role Sync – Erweiterungen

Default-Rolle für nicht gemappte Gruppen
- Neue konfigurierbare default-role in discord_role-permissions.yml.
- Spieler ohne gemappte Minecraft-Gruppe erhalten automatisch die Default-Rolle.
- Vorher gemappte Discord-Rollen werden entfernt, bevor die Default-Rolle zugewiesen wird.

Sync-Logik bei /role give
- Neue Option sync-on-role-give ( true = Standard) aktiviert die automatische Rollenbereinigung.
- Nur die zugewiesene Rolle wird hinzugefügt, alle gemappten Rollen werden entfernt.
- Gewährleistet konsistente Rollenverwaltung.

Verbesserte /dc-sync Logik
- Rollen, die ein Spieler basierend auf seinen Minecraft-Gruppen behalten sollte, werden nicht entfernt.
- Reduziert unnötige Rollenänderungen und verbessert die Performance.

---

Erweiterte Rollenänderungs-Beschränkungen

Schutz vor unberechtigten Änderungen
- cant-change-user-with-discord-role: Schutz für bestimmte Discord-Rollen.
- cant-change-user-with-minecraft-role: Schutz für bestimmte Minecraft-Gruppen.

Selbstmodifikationsschutz
- Spieler können ihre eigenen Rollen nicht ändern.
- Bypass-Permission: banmenu.discord.role.change.ignore.

Konfigurierbare Fehlermeldungen
- cant-change-discord-role, cant-change-minecraft-role, cant-change-self.

---

Unverify-System – Verbesserungen

Datenbankgestütztes Unverify-Code System
- Codes werden in der Datenbank ( discord_unverify) gespeichert.
- Abgelaufene Codes werden automatisch gelöscht.
- Wiederverwendung aktiver Codes mit Hinweis-Nachricht unverify-code-already-exists.

Tab-Completion für Unverify-Codes
- Vollständige Tab-Completion für /dc-unverify confirm <code>.
- Schnell dank Memory-Cache.
- Funktioniert auch für Bedrock-Spieler.

Verbesserte Bedrock-Unterstützung
- SUGGEST_COMMAND statt RUN_COMMAND.
- Korrekte Button-Formatierung und angepasste Nachrichten für Bedrock-Spieler.

Multi-Line Nachrichten
- Mehrzeilige Nachrichten für unverify-code-already-exists.
- Platzhalter {code} in allen Zeilen verfügbar.

---

Bugfixes

Discord-Integration
- Button-Text Formatierung für Bedrock-Farbcodes korrigiert.
- Tab-Completion bei /dc-unverify confirm <code> für Bedrock korrigiert.
- /dc-sync entfernt jetzt nur Rollen, die tatsächlich gemappt sind.

Unverify-System
- Codes gehen nicht mehr bei Server-Neustart verloren.
- Keine rohen Farbcodes im Chat mehr.

---

Technische Änderungen

Neue Konfigurationen
- discord_role-permissions.yml:
- sync.default-role, sync.sync-on-role-give
- groups.*.cant-change-user-with-discord-role
- groups.*.cant-change-user-with-minecraft-role
- messages.cant-change-discord-role, messages.cant-change-minecraft-role, messages.cant-change-self
- discord.yml:
- unverify-code-already-exists (mehrzeilig, {code}-Platzhalter)

Datenbank
- Neue Tabelle discord_unverify für Unverify-Codes.

Neue Permission
- banmenu.discord.role.change.ignore – Umgeht Selbstmodifikationsschutz.

Code-Verbesserungen
- Refactoring für bessere Bedrock-Unterstützung.
- Memory-Cache für Tab-Completion.
- Optimierte Datenbankabfragen.

---

Hinweise

Breaking Changes
- Keine – vollständig rückwärtskompatibel.

Update-Anleitung
1. Backup der Konfiguration und Datenbank erstellen.
2. Alte banmenu-1.4.0.jar ersetzen.
3. Server neu starten.
4. Neue Optionen in den Configs prüfen und ggf. anpassen.

Empfehlungen
- Default-Rolle konfigurieren.
- Rollenschutz aktivieren.
- Unverify-Codes auf Test-Server prüfen.
- Tab-Completion für Java- und Bedrock-Spieler testen.

---

Dokumentation
- PLUGIN_OVERVIEW.md
- BanMenu_Dokumentation_DE.html
- BanMenu_Dokumentation_EN.html
- DISCORD_SETUP.md

---

Feedback & Support
- Website: https://www.endcrystal.eu/
- Forum: https://www.endcrystal.eu/forum/
- Discord: https://discord.gg/UZstsKfRm5

---

Viel Spaß mit BanMenu 1.4.1!
Entwickelt von EndCrystalTV

BanMenu Update 1.4.0
Update von 1.3.1 auf 1.4.0

Danke, dass du BanMenu nutzt! Hier sind die wichtigsten Änderungen und Features der neuen Version:

✨ Neue Features
Discord Rules Bot

• Quiz-System verbessert: Direkt im Rules-Channel mit Ephemeral Messages (keine DMs mehr)
  
  
• Bessere Übersicht: Nur Zusammenfassung am Ende, kein sofortiges Feedback nach jeder Frage
  
  
• Verifizierungsprüfung: Spieler mit role-to-assign Rolle müssen Quiz nicht erneut durchführen
  
  
• Mehrsprachigkeit: „Bereits verifiziert“-Nachrichten konfigurierbar in discord_rules_bot.yml (DE/EN)
  

Discord Role Management

• Flexible Rollenverwaltung über Discord Slash Commands
  
  
• Gruppenbasierte Berechtigungen: Admin/Moderator-Gruppen mit individuellen Rechten
  
  
• Neue Config: discord_role-permissions.yml für flexible Rollenverwaltung
  
  
• Slash Commands: /role give & /role remove
  
  
• Minecraft-Integration: Rollen auch über /discord-role verfügbar
  

Rollen-Synchronisation

• Bidirektional: Minecraft-Gruppen ↔ Discord-Rollen
  
  
• Priorität konfigurierbar: minecraft, discord oder both
  
  
• Manuell synchronisieren: /dc-sync für Selbst- oder Fremd-Sync
  
  
• Nachrichten anpassbar: Alle /dc-sync Meldungen über Config
  

Discord Slash Commands

• Alle Rules Bot Commands nun als Slash Commands verfügbar
  
  
• Channel-Einschränkungen konfigurierbar
  
  
• Immer registriert, auch wenn Module deaktiviert
  
  
• Neue IDs: rule-config-channel-id & role-permission-set-channel-id
  
  
• Mehrzeilige Hilfe-Nachrichten im Embed-Format
  

Konfigurationsverbesserungen

• Discord-Configs in Unterordner Discord-Configs/ verschoben
  
  
• Neue Dateien: discord_role-permissions.yml, erweiterte discord.yml
  
  
• Viele Nachrichten nun anpassbar über Config
  

Bugfixes
Discord-Integration

• IllegalStateException bei /role give behoben
  
  
• Permission-Problem bei /discord-role behoben
  
  
• Discord ↔ Minecraft Synchronisation korrigiert
  
  
• IllegalAccessException in LuckPerms behoben
  
  
• Graceful Shutdown: Warnungen entfernt
  

Allgemein

• Stabilere LuckPerms-Integration
  
  
• Verbesserte GroupManager-Unterstützung
  
  
• Erweiterte Logging-Ausgaben
  

Technische Änderungen
Neue Befehle

• /dc-sync – manuelle Synchronisation für sich selbst
  
  
• /dc-sync <Spieler> – Synchronisation für andere (Permission banmenu.discord.role.sync.other nötig)
  

Neue Permissions

• banmenu.discord.role.sync.use – Selbst-Sync
  
  
• banmenu.discord.role.sync.other – Andere-Sync
  
  
• banmenu.discord.role.use – Verwendung /discord-role
  

Code-Verbesserungen

• Refactoring DiscordRoleSyncManager
  
  
• Optimierte Fehlerbehandlung & Logging
  
  
• Verbesserte JDA-Integration
  

Wichtige Hinweise
⚠️ Breaking Changes

• Alle Discord-Configs jetzt in plugins/BanMenu/Discord-Configs/
  
  
• Nach Update Config-Dateien verschieben
  
  
• Neue discord_role-permissions.yml wird beim ersten Start erstellt
  

Update-Anleitung

1. Backup der Config & Datenbank
   
   
2. Alte banmenu-*.jar ersetzen
   
   
3. Discord-Configs in neuen Ordner verschieben
   
   
4. Server neustarten
   
   
5. Neue Optionen prüfen (discord_role-permissions.yml)
   

Empfehlungen

• Discord Role Sync aktivieren: discord-role-sync: true
  
  
• Permissions prüfen & zuweisen
  
  
• Features auf Test-Server prüfen
  

Dokumentation

• Deutsch: BanMenu Dokumentation DE (PDF)
  
  
• Englisch: BanMenu Documentation EN (PDF)
  

Feedback & Support

• Website: endcrystal.eu
  
  
• Forum: endcrystal.eu/forum
  
  
• Discord: Support-Server
  

Viel Spaß mit BanMenu 1.4.0!
Entwickelt von EndCrystalTV