Zum Hauptinhalt springen

Erste Schritte

Leitfaden zum Hinzufügen von ArcBot auf Ihren Discord-Server und zur grundlegenden Konfiguration.

Bot zum Server hinzufügen​

  1. Öffnen Sie den Einladungslink von ArcBot
  2. Wählen Sie den Server aus, auf den Sie den Bot hinzufügen möchten
  3. Bestätigen Sie die erforderlichen Berechtigungen
  4. Klicken Sie auf Autorisieren
Erforderliche Berechtigungen

ArcBot benötigt folgende Basisberechtigungen:

  • Rollen verwalten — Erstellung von Allianz-Rollen, Self-Assign-Rollen
  • Mitglieder bannen / kicken — Moderationsbefehle
  • Nachrichten verwalten — Nachrichten löschen, alte Erinnerungen entfernen
  • Nachrichten senden — Embeds, Logs, Benachrichtigungen
  • Öffentliche Threads erstellen — Diskussionsthreads unter Vorschlägen

Einzelne Module (Cogs) können zusätzliche Berechtigungen erfordern.

Was passiert nach dem Hinzufügen?​

Nach dem Hinzufügen des Bots zum Server:

  1. Konfiguration erstellen — Der Bot erstellt automatisch eine Standardkonfiguration für Ihren Server (Sprache: Englisch, Embed-Farbe: #5865F2, keine aktivierten Module)
  2. Befehlssynchronisierung — Slash-Befehle werden pro Server synchronisiert. Anfangs sind keine Befehle sichtbar — sie erscheinen erst nach Aktivierung der entsprechenden Module
  3. Konfiguration wiederherstellen — Falls der Bot zuvor auf dem Server war und vor weniger als 30 Tagen entfernt wurde, wird die vorherige Konfiguration automatisch wiederhergestellt

Zugang zum Konfigurationspanel​

ArcBot verfügt über ein webbasiertes Konfigurationspanel (Dashboard):

URL: https://arcbot.pro

Wer hat Zugang?​

  • Benutzer mit der Berechtigung Administrator auf dem Discord-Server
  • Benutzer, die zur Liste dashboard_users in den Servereinstellungen hinzugefügt wurden

Wie meldet man sich an?​

  1. Gehen Sie zur Dashboard-Seite
  2. Klicken Sie auf Mit Discord anmelden
  3. Autorisieren Sie die OAuth2-Anwendung
  4. Wählen Sie einen Server aus der Liste (es werden nur Server angezeigt, auf die Sie Zugriff haben)

Grundkonfiguration​

1. Serversprache einstellen​

Die Standardsprache ist Englisch. Um auf Deutsch zu wechseln:

  1. Öffnen Sie Dashboard → Ihr Server
  2. Klicken Sie auf die Kachel Settings (Servereinstellungen)
  3. Ändern Sie die Sprache auf Deutsch
  4. Speichern Sie die Änderungen
tipp

Die Serversprache beeinflusst die Bot-Meldungen (Fehler, Bestätigungen usw.). Benutzer können auch eigene Sprachpräferenzen festlegen.

2. Module (Cogs) aktivieren​

ArcBot ist vollständig modular — kein Modul ist standardmäßig aktiviert. Um ein Modul zu aktivieren:

  1. Öffnen Sie Dashboard → Ihr Server
  2. Finden Sie im Modulraster das gewünschte Modul
  3. Klicken Sie auf den Schalter (Toggle), um es zu aktivieren
  4. Die mit dem Modul verbundenen Befehle erscheinen innerhalb weniger Sekunden auf dem Server

3. Moderationsrollen konfigurieren​

Die meisten Moderationsbefehle erfordern eine Rolle aus der Liste moderation_roles:

  1. Aktivieren Sie das Modul Moderation
  2. Klicken Sie auf Edit bei der Moderation-Kachel
  3. Fügen Sie Rollen hinzu, die Zugriff auf Moderationsbefehle haben sollen
  4. Speichern Sie die Änderungen

4. Logs konfigurieren​

Das Protokollierungssystem ermöglicht die Verfolgung von Aktionen auf dem Server:

  1. Aktivieren Sie das Modul Logs
  2. Klicken Sie auf Edit bei der Logs-Kachel
  3. Für jeden Log-Typ (Moderation, Welcome, Vorschläge usw.):
    • Aktivieren Sie das Modul mit dem Schalter
    • Wählen Sie den Zielkanal
    • Ändern Sie optional die Embed-Farbe
  4. Speichern Sie die Änderungen
warnung

Ein Log-Modul kann nicht ohne ausgewählten Zielkanal aktiviert werden. Das Dashboard hebt das fehlende Feld hervor und zeigt eine Fehlermeldung an.

Position der Bot-Rolle​

Nach dem Hinzufügen des Bots zum Server erstellt Discord die Rolle ArcBot (oder ähnlich). Sie müssen diese Rolle manuell in der Rollenhierarchie nach oben verschieben, damit der Bot:

  • Benutzerrollen verwalten kann (Ban, Kick, Mute, Allianz-Rollen)
  • Rollen über Reaction Roles zuweisen kann
  • Spitznamen ändern kann

So geht's:

  1. Gehen Sie zu Servereinstellungen → Rollen
  2. Ziehen Sie die Bot-Rolle über die Rollen, die er verwalten soll
  3. Speichern Sie die Änderungen
Wichtig

Der Bot kann KEINE Rollen verwalten, die höher als seine eigene Rolle in der Hierarchie sind. Dies ist eine Einschränkung der Discord-API und kann nicht programmtechnisch umgangen werden.

Nächste Schritte​

  • Berechtigungssystem — Wie die Autorisierung in ArcBot funktioniert
  • Modulsystem — Module aktivieren, deaktivieren und konfigurieren
  • Moderation — Konfiguration der Moderationsbefehle
  • Logs — System zur Aktionsprotokollierung