ModiQDocs

Custom Commands

Baue eigene Slash-Befehle mit Aktionen, Bedingungen und eigenem Speicher — ohne Programmieren.

Mit Custom Commands erstellst du eigene Slash-Befehle für deinen Server. Jeder Befehl hat einen Namen, eine Beschreibung und optionale Optionen; anschließend fügst du Aktionen hinzu, die der Bot ausführt (antworten, Embed senden, Rollen vergeben, Werte speichern, Bedingungen prüfen und mehr). Über Platzhalter greifst du auf Nutzer, Datum, Optionen, Variablen und Speicherwerte zu. Nach dem Speichern registriert der Bot den Befehl automatisch bei Discord. Das Dashboard hat drei Bereiche: Befehle, Variablen und Datenbanken. (customcommands)

Bild folgt

Das Dashboard mit geöffnetem Tab „Custom Commands“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.

Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.

public/docs-assets/modules/customcommands.png · 1600x900 · dunkles Design

Die drei Bereiche

Befehle
Liste und Editor deiner eigenen Befehle mit Name, Beschreibung, Optionen und Aktionskette.
Variablen
Server-weite Werte (Guild-Variablen), unabhängig vom Pro-Nutzer-Speicher.
Datenbanken
Werte pro Mitglied, z. B. balance oder wins, genutzt über {db:schluessel}.

Aktionen

  • Nachrichten — Nachricht antworten, Embed senden, Nachricht in Kanal senden, Reaktion hinzufügen.
  • Rollen — Rolle hinzufügen, Rolle entfernen.
  • Datenbank & Economy — Datenbank-Wert lesen (pro User), Datenbank-Wert ändern (+/-), Datenbank-Wert setzen, Bestenliste anzeigen.
  • Guild-Variablen — Guild-Variable lesen, ändern (+/-), setzen.
  • Spiele & Zufall — Zufallszahl.
  • Logik — Bedingung (Wenn / Sonst), Warten (Sekunden), Variable setzen, Abbrechen.

Eine Bedingung kann Options-Werte, Variablen, Datenbank-Werte, Guild-Variablen, die ID des Ausführenden, eine Rollen-Zugehörigkeit und den aktuellen Kanal prüfen.

Platzhalter & Regeln

  • {user} — Erwähnung des Nutzers; {user_id} — Nutzer-ID
  • {date} / {time} — Datum und Uhrzeit
  • {option:name} — Wert einer Option
  • {var:name} — eigene Variable
  • {db:schluessel} — Datenbank-Wert pro Nutzer
  • {gvar:name} — Guild-Variable (server-weit)
Befehlsnamen und Optionsnamen bestehen aus a–z, 0–9, - und _ (max. 32 Zeichen). Schlüssel für Variablen und Datenbanken bestehen aus a–z, A–Z, 0–9, - und _ (max. 32 Zeichen).

Die Daten liegen in data/custom-commands.json, Variablen in data/custom-commands-guildvars.json und Pro-Nutzer-Werte in data/custom-commands-db.json.

Einstellungen im Dashboard

EinstellungTypBedeutung
Modul Custom Commands aktivcustomCommandsEnabledSchalterSchaltet das Modul ein oder aus. Aus: Eigene Befehle werden auf dem Server deaktiviert.

Stolperfallen

  • Eigene Befehle werden erst nach dem Speichern bei Discord registriert — kurz danach sind sie als Slash-Befehl verfügbar.
  • Optionstypen sind Text, Ganzzahl, Ja/Nein, Nutzer, Kanal, Rolle, Nutzer/Rolle, Zahl und Datei.

Siehe auch

Clone-SystemWirtschaft
ZurückClone-SystemWeiterLinked Roles