Zum Hauptinhalt springen

Befehle

Schalte die integrierten Befehle deiner aktivierten Module ein oder aus und benenne die Kontextmenü-Befehle (Rechtsklick) um, die deine Mitglieder sehen - alles direkt aus dem SCNX-Dashboard.

Übersicht​

Die Seite Befehle listet jeden Befehl auf, den die aktuell aktivierten Module bereitstellen, und lässt dich entscheiden, welche davon bei Discord registriert werden. Befehle sind nach Typ in drei Reitern gruppiert:

  • Slash - die /befehl-Einträge, die Mitglieder in das Chatfeld eingeben.
  • Nutzer - Kontextmenü-Befehle, die angezeigt werden, wenn du mit der rechten Maustaste auf ein Mitglied klickst (Apps-Untermenü).
  • Nachricht - Kontextmenü-Befehle, die angezeigt werden, wenn du mit der rechten Maustaste auf eine Nachricht klickst (Apps-Untermenü).

Für jeden Befehl kannst du ihn aktivieren oder deaktivieren. Bei Nutzer- und Nachricht-Befehlen kannst du zusätzlich eine eigene Bezeichnung festlegen - den Text, den Discord im Apps-Menü anzeigt. Eine Live-Vorschau bildet das Apps-Flyout von Discord nach, damit du siehst, wie die Nutzer- und Nachrichten-Menüs aussehen werden, bevor du speicherst.

Hier erscheinen nur Befehle aus aktivierten Modulen. Aktiviere zuerst ein Modul, falls der gesuchte Befehl fehlt.

Info

Diese Seite verwaltet die Befehle, die mit den Modulen des Bots ausgeliefert werden. Sie unterscheidet sich von den beiden benachbarten Seiten:

  • Slashcommands & Berechtigungen - die eigenen Berechtigungssteuerungen von Discord pro Befehl (welche Rollen, Nutzer und Kanäle einen Befehl ausführen dürfen). Diese werden in deinen Discord-Servereinstellungen konfiguriert, nicht hier.
  • Eigene Befehle - erstelle deine eigenen Befehle von Grund auf mit dem visuellen Flow-Editor.

Nutze die Seite Befehle, um integrierte Modulbefehle ein- oder auszuschalten und Kontextmenü-Einträge umzubenennen; nutze die beiden anderen Seiten für Berechtigungen und zum Erstellen eigener Befehle.

Slash-, Nutzer- und Nachricht-Befehle​

Discord unterstützt drei Befehlstypen, und die Seite hält sie in getrennten Reitern, weil jeder eigene Regeln und ein eigenes Budget hat.

TypWo Mitglieder ihn findenKann hier umbenannt werdenStandardmäßig aktiviert
SlashAls /befehl in das Nachrichtenfeld getipptNeinJa
NutzerRechtsklick auf ein Mitglied → AppsJa (eigene Bezeichnung)Nein
NachrichtRechtsklick auf eine Nachricht → AppsJa (eigene Bezeichnung)Nein

Jeder Reiter zeigt einen Budget-Zähler (verwendet / Limit), damit du auf einen Blick siehst, wie viel des Discord-Kontingents pro Typ du bereits verbraucht hast.

Aktivieren und Deaktivieren​

Nutze den Schalter in jeder Befehlszeile, um ihn zu aktivieren oder zu deaktivieren.

Die Standardwerte unterscheiden sich je nach Typ:

  • Slash-Befehle sind standardmäßig aktiviert. Ein Slash-Befehl, den du nie angerührt hast, ist bei Discord registriert. Deaktiviere ihn hier, um ihn zu entfernen.
  • Nutzer- und Nachricht-Befehle sind standardmäßig deaktiviert. Kontextmenü-Befehle sind optional - sie erscheinen erst in Discord, wenn du sie hier aktivierst.

Jeder Befehl gehört zu einem Modul und ist unter dem Abschnitt dieses Moduls gruppiert. Wenn du ein ganzes Modul (auf der eigenen Seite des Moduls) deaktivierst, werden alle seine Befehle von dieser Seite entfernt.

Kontextmenü-Befehle umbenennen​

Nutzer- und Nachricht-Befehlen kann eine eigene Bezeichnung gegeben werden - der Text, den Mitglieder im Apps-Menü von Discord sehen. Slash-Befehle können hier nicht umbenannt werden (ihre Namen folgen den eigenen Regeln von Discord und werden mit dem Modul verwaltet).

  • Tippe deine bevorzugte Bezeichnung in das Umbenennungsfeld des Befehls. Lass es leer, um auf den Standardnamen des Befehls zurückzufallen.
  • Bezeichnungen sind auf 32 Zeichen begrenzt (ein Discord-Limit). Die Seite markiert jede zu lange Bezeichnung und blockiert das Speichern, bis du sie kürzt.
  • Die Live-Apps-Vorschau aktualisiert sich beim Tippen, sodass du die Formulierung vor dem Speichern bestätigen kannst.

Limits​

Discord erzwingt ein festes Budget pro Befehlstyp. Die Seite erzwingt dieselben Limits und lässt dich keine Auswahl speichern, die sie überschreitet:

TypMaximal aktivierte Befehle
Slash100
Nutzer15
Nachricht15

Zusätzliche Regeln:

  • Länge der Kontextmenü-Bezeichnung: eigene Nutzer-/Nachricht-Bezeichnungen dürfen höchstens 32 Zeichen lang sein.
  • Namenskollisionen: zwei aktivierte Befehle desselben Typs, deren aufgelöste Bezeichnungen (eigene Bezeichnung oder der Standardname, falls keine eigene Bezeichnung gesetzt ist) beim Vergleich ohne Beachtung der Groß-/Kleinschreibung identisch sind, kollidieren. Die Seite markiert die Kollision und blockiert das Speichern, bis du einen davon umbenennst oder deaktivierst. Report und report zählen als derselbe Name.

Wird eine dieser Regeln verletzt, zeigt die Seite den Grund an und deaktiviert das Speichern, bis er behoben ist.

Speichern und mit Discord synchronisieren​

Deine Befehlsauswahl wird wie jede andere Modulkonfiguration gespeichert und über den normalen Konfigurations-Speicherpfad geschrieben - nutze die Aktion Speichern genauso, wie du es auf jeder Konfigurationsseite tun würdest. Es gibt keinen separaten Absende-Schritt.

Nach dem Speichern aktualisiert der Bot die bei Discord registrierten Befehle so, dass sie deiner Auswahl entsprechen.

Befehlssynchronisierung

Wie bei allen Befehlsänderungen kann es einige Zeit dauern, bis Aktualisierungen in Discord erscheinen - neu aktivierte Befehle können eine Weile brauchen, um aufzutauchen, und entfernte eine Weile, um zu verschwinden. Dies ist eine Verzögerung bei der Verbreitung auf Discord-Seite, dasselbe Verhalten, das in der Anleitung Slashcommands & Berechtigungen beschrieben wird. Gib ihm etwas Zeit, bevor du annimmst, dass etwas nicht stimmt.

Kontextmenüs​

Kontextmenü-Befehle sind die Benutzer- und Nachricht-Befehle, die erscheinen, wenn du in Discord per Rechtsklick auf ein Mitglied oder eine Nachricht das Untermenü Apps öffnest. Sie sind standardmäßig ausgeschaltet, du musst also die gewünschten aktivieren.

Kontextmenü-Befehle einrichten​

  1. Stelle sicher, dass das Modul, das den Befehl bereitstellt, aktiviert ist. Weitere Module kannst du über den Link Module verwalten oben auf der Seite Befehle hinzufügen.
  2. Öffne die Seite Befehle im Bot-Bereich des SCNX-Dashboards.
  3. Wechsle zum Tab Benutzer für Befehle auf Mitglieder oder zum Tab Nachricht für Befehle auf Nachrichten. Mit Befehle durchsuchen findest du einen Befehl nach Name oder Modul.
  4. Aktiviere den Schalter jedes Befehls, den du anbieten möchtest. Der Zähler am Tab zeigt, wie viele der 15 erlaubten Befehle du nutzt.
  5. Optional kannst du im Feld neben dem Befehl einen neuen Namen eingeben. Das Feld ist nur bearbeitbar, solange der Befehl aktiviert ist.
  6. Prüfe die Mitglieder-Vorschau rechts. Sie zeigt das Discord-Menü so, wie deine Mitglieder es sehen, inklusive Name und Avatar deines Bots.
  7. Speichere über die Leiste am unteren Rand (Du hast ungespeicherte Befehlsaenderungen). Wenn das Speichern blockiert ist, listet die Seite unter Bitte vor dem Speichern beheben auf, was zu korrigieren ist.
  8. Bestätige im Dialog nach dem Speichern Konfiguration jetzt neu laden. Änderungen an Befehlen werden erst angewendet, wenn dein Bot seine Konfiguration neu lädt.

Um einen Befehl in Discord zu nutzen, klicke mit der rechten Maustaste auf ein Mitglied (Benutzer) oder eine Nachricht (Nachricht), öffne Apps und wähle den Befehl unter dem Namen deines Bots.

Befehle verwalten​

Auf der Seite Befehle legst du auch generell fest, welche Befehle dein Bot anbietet:

  • Tab Slash: Befehle sind standardmäßig aktiv und können deaktiviert werden. Slash-Befehle lassen sich hier nicht umbenennen. Siehe Aktivieren und Deaktivieren.
  • Gruppierung: Befehle sind nach Modul gruppiert. Befehle ohne Modul stehen in der Gruppe Integriert. Die Zahl neben jeder Gruppe zeigt, wie viele ihrer Befehle aktiviert sind.
  • Wer einen Befehl nutzen darf: Jeder Befehl zeigt ein Label, entweder Alle oder Team mit der benötigten Berechtigung. Wer ihn ausführen darf, kannst du in Discord unter Servereinstellungen -> Integrationen ändern, siehe Slashcommands & Berechtigungen.
  • Umbenennen: Namen dürfen bis zu 32 Zeichen lang sein und müssen pro Tab eindeutig sein (ohne Beachtung der Groß-/Kleinschreibung). Siehe Kontextmenü-Befehle umbenennen.
  • Limits: Discord erlaubt 100 Slash-Befehle, 15 Benutzer- und 15 Nachrichten-Kontextbefehle. Ist ein Tab voll, öffnet das Aktivieren eines weiteren Befehls Befehlslimit erreicht und der Befehl bleibt aus. Siehe Limits.
  • Plan-gesperrte Befehle: Einige Befehle sind standardmäßig aktiv und lassen sich nur mit einem Professional-Plan deaktivieren. Ohne ihn ist der Schalter gesperrt und die Zeile zeigt, dass der Plan zum Deaktivieren erforderlich ist.
  • Die Seite Befehle befindet sich aktuell in der Beta, daher kann sich das Verhalten noch ändern.

Fehlerbehebung​

Ein Befehl, den ich erwartet habe, wird nicht aufgelistet
  • Die Seite listet nur Befehle aus aktivierten Modulen auf. Aktiviere zuerst das zugehörige Modul.
  • Stelle sicher, dass dein Bot online ist und seinen Befehlskatalog synchronisiert hat.
Ich kann meine Änderungen nicht speichern
  • Überprüfe die Warnung oben in der Liste - sie nennt, was zu beheben ist.
  • Du hast möglicherweise ein Budget pro Typ überschritten (Slash 100, Nutzer 15, Nachricht 15). Deaktiviere einige Befehle dieses Typs.
  • Zwei aktivierte Befehle desselben Typs teilen sich möglicherweise einen Namen (ohne Beachtung der Groß-/Kleinschreibung). Benenne einen davon um oder deaktiviere ihn.
  • Eine eigene Kontextmenü-Bezeichnung ist möglicherweise länger als 32 Zeichen. Kürze sie.
Ein Rechtsklick-Befehl (Nutzer / Nachricht) erscheint nicht in Discord
  • Kontextmenü-Befehle sind standardmäßig deaktiviert - aktiviere sie zuerst auf dieser Seite.
  • Befehlsänderungen können einige Zeit brauchen, um sich zu Discord zu verbreiten. Warte eine Weile und versuche es erneut.
  • Bestätige, dass du deine Änderungen gespeichert hast.
Mein umbenannter Befehl zeigt weiterhin den alten Namen
  • Speichere deine Änderungen und gib Discord dann Zeit, die neue Bezeichnung zu synchronisieren.
  • Überprüfe, dass die Bezeichnung nicht mit einem anderen aktivierten Befehl desselben Typs kollidiert.
Brauchst du mehr Hilfe?
Findest du nicht, wonach du suchst? Unser Team hilft dir gerne.