Befehlssystem — Übersicht
ArcBot verwendet Slash-Commands (Befehle mit vorangestelltem /), die nativ in die Discord-Oberfläche integriert sind. Befehle erscheinen im Menü nach Eingabe von / im Nachrichtenfeld.
Per-Guild-Synchronisierung
ArcBot registriert Befehle nicht global. Stattdessen synchronisiert es Befehle separat für jeden Server basierend auf aktivierten Cogs:
- Wenn ein Cog im Dashboard aktiviert wird → Config Polling (alle 5 Sekunden) erkennt die Änderung
- Bot ruft automatisch
_sync_guild_commandsfür den Server auf - Befehle des aktivierten Cogs erscheinen sofort im Slash-Commands-Menü
- Befehle eines deaktivierten Cogs verschwinden sofort
info
Das bedeutet, dass jeder Server nur die Befehle sieht, deren Cogs aktiviert wurden. Es gibt keine überflüssigen Befehle, die das Menü überfüllen.
Berechtigungsstruktur
ArcBot-Befehle nutzen mehrere Berechtigungsebenen:
| Ebene | Beschreibung |
|---|---|
| Everyone | Jeder Serverbenutzer |
| Moderation Roles | In cog_settings.moderation.moderation_roles konfigurierte Rollen |
| Custom Roles | Spezifische pro-Cog konfigurierte Rollen (z.B. create_roles für Umfragen) |
| Administrator | Erfordert die Discord-Berechtigung ADMINISTRATOR |
| Alliance R4/R5 | Rang im Allianzsystem |
Befehlsgruppen
Einige Befehle sind unter einem Präfix gruppiert:
/role add,/role remove— Rollenverwaltung (Moderation)/alliance create,/alliance inviteusw. — Allianzsystem/embed send,/embed list— Message Builder/event schedule,/event list,/event cancel— Geplante Ereignisse/duel send,/duel preview— Duell-Erinnerungen
Kontextmenüs
Neben Slash-Commands fügt der Cog Translation zwei Kontextmenüs hinzu (Rechtsklick auf Nachricht):
- Translate Message — übersetzt den Nachrichtentext
- Transcribe & Translate — transkribiert Audio und übersetzt
Fehlerverhalten
Alle Befehle antworten ephemeral (nur für den Benutzer sichtbar):
- Keine Berechtigungen → Meldung über fehlenden Zugang
- Rollenhierarchie-Fehler → Information über zu niedrige Position
- Fehlende Konfiguration → Anweisung zur Dashboard-Konfiguration
- Datenbank-/API-Fehler → allgemeine Meldung mit Bitte um Wiederholung
Limits
| Parameter | Limit |
|---|---|
| Reason (Grund) | max 512 Zeichen |
| Mute duration | 1–40320 Minuten (28 Tage) |
| Clear messages | 1–100 Nachrichten |
| Poll options | 2–10 Optionen |
| Poll question | max 256 Zeichen |
| Suggestion content | max 2000 Zeichen |
| Alliance name | 2–32 Zeichen (alphanumerisch, Leerzeichen, Bindestriche) |
| Alliance tag | 1–5 Zeichen (alphanumerisch) |
| Nickname | 1–32 Zeichen |
Liste der Cogs mit Befehlen
| Cog | Anzahl Befehle | Kategorie |
|---|---|---|
| Moderation | 10 | admin |
| Alliances | 10 | dark war survival |
| Polls | 2 | community |
| Suggestions | 1 | community |
| Message Builder | 2 | utilities |
| Translation | 2 + 2 Kontextmenüs | utilities |
| Schedule Events | 3 | community |
| Duel Reminder | 2 | community |