Modulkonfiguration
Die Hauptansicht des Dashboards ist das Modulraster (Cogs) — Kacheln, die die einzelnen Bot-Funktionen repräsentieren. Von hier aus aktivieren, deaktivieren und konfigurieren Sie jedes Modul.
Zugang
Verfügbar für jeden Benutzer, der sich im Panel anmelden kann (ADMINISTRATOR oder Dashboard Users).
Modulraster (Module Grid)
Nach Auswahl eines Servers sehen Sie ein Kachelraster, unterteilt in Kategorien:
| Kategorie | Module |
|---|---|
| Administration | Settings, Moderation |
| Utilities | Logs, Translation, Message Builder |
| Community | Welcome, Reaction Roles, Suggestions, Polls, Duel Reminder, Schedule Events |
| Dark War Survival | Alliances, Presidents, Armory, APC |
Jede Kachel enthält:
- Modulname und Kategorie
- Ein-/Aus-Schalter (Toggle) — aktiviert/deaktiviert das Modul
- Info "config required" — wenn das Modul einen API-Schlüssel erfordert
- Kurzbeschreibung der Funktion
- Button "Edit" — öffnet das detaillierte Konfigurationspanel
Bot-Status
In der oberen rechten Ecke über dem Raster wird der Bot-Status angezeigt:
- Online (grüner Punkt) — Bot ist mit dem Server verbunden
- Offline (grauer Punkt) — Bot ist nicht erreichbar
Module ein- und ausschalten
Klicken Sie den Schalter (Toggle) auf der Modulkachel:
- Lila = aktiviert
- Grau = deaktiviert
Nach dem Umschalten eines Moduls wird der Bot innerhalb weniger Sekunden:
- Slash-Befehle synchronisieren — sie erscheinen oder verschwinden aus der Discord-Befehlsliste
- Auf Events des jeweiligen Moduls reagieren oder nicht mehr reagieren
Die Kachel "Settings" hat keinen Schalter — sie ist immer aktiv, da sie wichtige Servereinstellungen enthält.
Modul-Konfigurationspanel
Ein Klick auf "Edit" bei einer Kachel öffnet das detaillierte Konfigurationspanel. Eine Slide-Animation bringt Sie zur Bearbeitungsansicht.
Navigation
- Button "Back" (Pfeil nach links) — zurück zum Modulraster
- Bei ungespeicherten Änderungen wird die Rückkehr blockiert — die UnsavedBar blinkt rot
Einstellungstypen in den Panels
Je nach Modul kann das Konfigurationspanel enthalten:
| Element | Beschreibung |
|---|---|
| Kanalauswahl (Dropdown) | Textkanal, in dem das Modul arbeitet |
| Rollenauswahl (Multi-Select) | Rollen mit Modulberechtigungen |
| Farbe (Picker + Hex) | Embed-Farbe des Moduls |
| Schalter (Toggle) | Unterfunktionen aktivieren |
| Textfelder | Nachrichten-, Tag-Konfiguration usw. |
| Visueller Embed-Editor | Embed-Erstellung mit Live-Vorschau |
| Kartenraster | Reaction-Roles-Konfigurationen, Logs, Allianzen |
Befehlsliste des Moduls
Am Ende des Konfigurationspanels jedes Moduls (falls es Befehle hat) wird eine zweispaltige Liste seiner Slash-Befehle angezeigt:
- Befehlsname (lila, Code-Stil)
- Befehlsbeschreibung (grau)
Speichermuster (UnsavedBar)
Alle Konfigurationspanels verwenden ein einheitliches Speichersystem:
- Sie nehmen Änderungen an den Einstellungen vor
- Am unteren Bildschirmrand erscheint die Leiste "Unsaved changes"
- Sie haben zwei Buttons:
- Save — speichert Änderungen in der Datenbank
- Cancel — setzt alle Änderungen auf den zuletzt gespeicherten Stand zurück
- Nach erfolgreichem Speichern animiert sich die Leiste mit einem Gradient-Häkchen (Orange→Lila) und verschwindet
Verhalten bei Verlassensversuch
Wenn Sie versuchen, zum Modulraster zurückzukehren (Button "Back") und ungespeicherte Änderungen haben:
- Die Navigation wird blockiert
- Die UnsavedBar blinkt rot
- Der Bildschirm wackelt leicht
Sie müssen zuerst speichern oder abbrechen.
Das Panel vergleicht den aktuellen Formularstand mit dem zuletzt gespeicherten Stand (JSON.stringify). Jeder Unterschied — auch ein zusätzliches Leerzeichen — aktiviert die Leiste.
Module mit dedizierten Panels
Jedes Modul hat ein eigenes Panel, angepasst an seine Bedürfnisse:
| Modul | Panel-Besonderheit |
|---|---|
| Logs | Log-Kachelraster — jede mit Toggle, Kanal und Farbe |
| Welcome | Embed-Editor (Welcome + Goodbye) + DM-Nachricht |
| Moderation | Moderationsrollen + Verwarnungsschwelle |
| Translation | API-Schlüssel (DeepL/Groq) |
| Reaction Roles | Kartenraster mit Konfigurationen + Auto-Redeploy |
| Suggestions | Kanal + Farben + Berechtigungen |
| Polls | Farbe + Dauer + Berechtigungen |
| Message Builder | Vorlagen-Sidebar + visueller Embed-Editor |
| Alliances | Allianzen erstellen/bearbeiten + Mitgliederliste |
| Presidents | Präsidentensystem-Konfiguration |
| Armory | Waffenkammer-Rotationskonfiguration |
| Duel Reminder | Duell-Erinnerungskonfiguration |
| Schedule Events | CRUD für Ereignisse + Instanzen |
| APC | APC-Stärkeranking mit Leaderboard-Kanal |
Im Logs-Modul kann eine Log-Kategorie nicht ohne ausgewählten Zielkanal aktiviert werden. Ein Speicherversuch mit aktiviertem Log ohne Kanal verursacht:
- Rote Umrandung am Kanalfeld
- Toast-Fehlermeldung
- Speichervorgang wird blockiert