Konfiguracja Modułów
Główny widok dashboardu to siatka modułów (cogs) — kafelki reprezentujące poszczególne funkcje bota. Z tego miejsca włączasz, wyłączasz i konfigurujesz każdy moduł.
Dostęp
Dostępne dla każdego użytkownika, który może zalogować się do panelu (ADMINISTRATOR lub Dashboard Users).
Siatka modułów (Module Grid)
Po wybraniu serwera zobaczysz siatkę kafelków podzielonych na kategorie:
| Kategoria | Moduły |
|---|---|
| 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 |
Każdy kafelek zawiera:
- Nazwę modułu i kategorię
- Przełącznik on/off (toggle) — włącza/wyłącza moduł
- Informację "config required" — jeśli moduł wymaga klucza API
- Krótki opis działania modułu
- Przycisk "Edit" — otwiera panel szczegółowej konfiguracji
Status bota
W prawym górnym rogu nad siatką wyświetlany jest status bota:
- Online (zielona kropka) — bot jest podłączony do serwera
- Offline (szara kropka) — bot jest niedostępny
Włączanie i wyłączanie modułów
Kliknij przełącznik (toggle) na kafelku modułu:
- Fioletowy = włączony
- Szary = wyłączony
Po przełączeniu modułu, bot w ciągu kilku sekund:
- Zsynchronizuje komendy slash — pojawią się lub znikną z listy komend Discord
- Zacznie lub przestanie reagować na zdarzenia powiązane z danym modułem
Kafelek "Settings" nie ma przełącznika — jest zawsze aktywny, ponieważ zawiera kluczowe ustawienia serwera.
Panel konfiguracji modułu
Kliknięcie "Edit" na kafelku otwiera panel szczegółowej konfiguracji. Animacja przesunięcia przeniesie Cię do widoku edycji.
Nawigacja
- Przycisk "Back" (strzałka w lewo) — powrót do siatki modułów
- Jeśli masz niezapisane zmiany, powrót jest blokowany — pasek UnsavedBar zamiga na czerwono
Typy ustawień w panelach
W zależności od modułu, panel konfiguracji może zawierać:
| Element | Opis |
|---|---|
| Wybór kanału (dropdown) | Kanał tekstowy, gdzie moduł działa |
| Wybór ról (multi-select) | Role z uprawnieniami do modułu |
| Kolor (picker + hex) | Kolor embedów modułu |
| Przełączniki (toggle) | Włączanie pod-funkcji |
| Pola tekstowe | Konfiguracja wiadomości, tagów itp. |
| Wizualny edytor embedów | Budowanie embedów z podglądem na żywo |
| Siatka kart | Konfiguracje Reaction Roles, logi, sojusze |
Lista komend modułu
Na dole panelu konfiguracji każdego modułu (jeśli ma komendy) wyświetlana jest lista jego komend slash w formacie dwukolumnowym:
- Nazwa komendy (fioletowa, w stylu kodu)
- Opis komendy (szary)
Wzorzec zapisu (UnsavedBar)
Wszystkie panele konfiguracji używają spójnego systemu zapisu:
- Dokonujesz zmian w ustawieniach
- Na dole ekranu pojawia się pasek "Unsaved changes"
- Masz dwa przyciski:
- Save — zapisuje zmiany do bazy danych
- Cancel — cofa wszystkie zmiany do ostatnio zapisanego stanu
- Po udanym zapisie pasek animuje się w kółko z gradientowym checkmarkiem (orange→purple) i znika
Zachowanie przy próbie opuszczenia
Jeśli próbujesz wrócić do siatki modułów (przycisk "Back") mając niezapisane zmiany:
- Nawigacja jest blokowana
- Pasek UnsavedBar miga na czerwono
- Ekran lekko się potrząsa
Musisz najpierw zapisać lub anulować zmiany.
Panel porównuje bieżący stan formularza z ostatnio zapisanym stanem (JSON.stringify). Każda różnica — nawet dodatkowa spacja — aktywuje pasek.
Moduły z dedykowanymi panelami
Każdy moduł ma swój własny panel dostosowany do swoich potrzeb:
| Moduł | Specyfika panelu |
|---|---|
| Logs | Siatka kafelków logów — każdy z togglem, kanałem i kolorem |
| Welcome | Edytor embedów (welcome + goodbye) + wiadomość DM |
| Moderation | Role moderacji + próg ostrzeżeń |
| Translation | Klucz API (DeepL/Groq) |
| Reaction Roles | Siatka kart z konfiguracjami + auto-redeploy |
| Suggestions | Kanał + kolory + uprawnienia |
| Polls | Kolor + czas trwania + uprawnienia |
| Message Builder | Sidebar szablonów + wizualny edytor embedów |
| Alliances | Tworzenie/edycja sojuszy + lista członków |
| Presidents | Konfiguracja systemu prezydentów |
| Armory | Konfiguracja rotacji zbrojowni |
| Duel Reminder | Konfiguracja przypomnień o pojedynkach |
| Schedule Events | CRUD wydarzeń + instancje |
| APC | Ranking siły APC z kanałem leaderboardu |
W module Logs nie można włączyć kategorii logowania bez wybrania kanału docelowego. Próba zapisania z włączonym logiem bez kanału spowoduje:
- Czerwone obramowanie na polu kanału
- Komunikat toast z błędem
- Zapis zostanie zablokowany