Przejdź do głównej zawartości

Pierwsze kroki

Przewodnik po dodaniu ArcBota na serwer Discord i podstawowej konfiguracji.

Dodawanie bota na serwer​

  1. Otwórz link zaproszeniowy ArcBota
  2. Wybierz serwer, na który chcesz dodać bota
  3. Zatwierdź wymagane uprawnienia
  4. Kliknij Autoryzuj
Wymagane uprawnienia

ArcBot potrzebuje następujących uprawnień bazowych:

  • Zarządzanie rolami — tworzenie ról sojuszy, self-assign role
  • Banowanie / Wyrzucanie członków — komendy moderacyjne
  • Zarządzanie wiadomościami — czyszczenie wiadomości, usuwanie starych przypomnień
  • Wysyłanie wiadomości — embedy, logi, powiadomienia
  • Tworzenie wątków publicznych — wątki dyskusji pod sugestiami

Poszczególne moduły (cogi) mogą wymagać dodatkowych uprawnień.

Co się dzieje po dodaniu?​

Po dodaniu bota na serwer:

  1. Tworzenie konfiguracji — bot automatycznie tworzy domyślną konfigurację dla Twojego serwera (język: angielski, kolor embeda: #5865F2, brak włączonych modułów)
  2. Synchronizacja komend — komendy slash są synchronizowane per-serwer. Na początku żadne komendy nie są widoczne — pojawiają się dopiero po włączeniu odpowiednich modułów
  3. Przywracanie konfiguracji — jeśli bot był wcześniej na serwerze i został usunięty mniej niż 30 dni temu, poprzednia konfiguracja zostaje automatycznie przywrócona

Dostęp do panelu konfiguracyjnego​

ArcBot posiada webowy panel konfiguracyjny (dashboard):

URL: https://arcbot.pro

Kto ma dostęp?​

  • Użytkownicy z uprawnieniem Administrator na serwerze Discord
  • Użytkownicy dodani do listy dashboard_users w ustawieniach serwera

Jak się zalogować?​

  1. Przejdź na stronę dashboardu
  2. Kliknij Zaloguj przez Discord
  3. Autoryzuj aplikację OAuth2
  4. Wybierz serwer z listy (widoczne są tylko serwery, do których masz dostęp)

Podstawowa konfiguracja​

1. Ustaw język serwera​

Domyślny język to angielski. Aby zmienić na polski:

  1. Otwórz dashboard → Twój serwer
  2. Kliknij kafelek Settings (ustawienia serwera)
  3. Zmień język na Polski
  4. Zapisz zmiany
wskazówka

Język serwera wpływa na komunikaty bota (błędy, potwierdzenia, itp.). Użytkownicy mogą też ustawić własne preferencje językowe.

2. Włącz moduły (cogi)​

ArcBot jest w pełni modularny — żaden moduł nie jest włączony domyślnie. Aby włączyć moduł:

  1. Otwórz dashboard → Twój serwer
  2. W siatce modułów znajdź interesujący Cię moduł
  3. Kliknij przełącznik (toggle) aby go włączyć
  4. Komendy powiązane z modułem pojawią się na serwerze w ciągu kilku sekund

3. Skonfiguruj role moderacyjne​

Większość komend moderacyjnych wymaga posiadania roli z listy moderation_roles:

  1. Włącz moduł Moderation
  2. Kliknij Edit na kafelku Moderation
  3. Dodaj role, które mają mieć dostęp do komend moderacyjnych
  4. Zapisz zmiany

4. Skonfiguruj logi​

System logowania pozwala śledzić akcje na serwerze:

  1. Włącz moduł Logs
  2. Kliknij Edit na kafelku Logs
  3. Dla każdego typu logów (moderacja, welcome, sugestie, itp.):
    • Włącz moduł przełącznikiem
    • Wybierz kanał docelowy
    • Opcjonalnie zmień kolor embeda
  4. Zapisz zmiany
ostrzeżenie

Nie można włączyć modułu logów bez wybrania kanału docelowego. Dashboard podświetli brakujące pole i wyświetli komunikat błędu.

Pozycja roli bota​

Po dodaniu bota na serwer, Discord tworzy rolę ArcBot (lub podobną). Musisz ręcznie przesunąć tę rolę wyżej w hierarchii ról, aby bot mógł:

  • Zarządzać rolami użytkowników (ban, kick, mute, role sojuszy)
  • Nadawać role z reaction roles
  • Zmieniać pseudonimy

Aby to zrobić:

  1. Przejdź do Ustawienia serwera → Role
  2. Przeciągnij rolę bota powyżej ról, którymi ma zarządzać
  3. Zapisz zmiany
Ważne

Bot NIE MOŻE zarządzać rolami, które są wyżej od jego własnej roli w hierarchii. To ograniczenie Discord API i nie da się go obejść programistycznie.

Następne kroki​