Skip to main content

DEV - DynamicButtonEvent

danger

Hinweis:Du kannst maximal 25 Buttons erstellen! Jeder Button mus einen eindeutigen Namen haben. Doppelte Namen werden nicht akzeptiert.

Aufbau

SpezialSystem-NameArtValidierungData-Typ
uniqesystemnameFa-z_String
displaynameFA-Za-z0-9String
conditionsFJsonArray
minimalReqVersionSFloat
commentOA-Za-z0-9 !#&<>.,-_String
actionsFJsonArray
buttonTypeFdanger/primary,secondary,successString
permissionOmain.botctl.dyn.String

* = A-Za-z0-9* bedeutet, dass alle Zeichen außer Sonderzeichen erlaubt sind. Sonderzeichen auf eigenes Risiko verwenden. Ggf. prüfen ob Json Escaping notwendig ist.

Systemname & Displayname

"systemname": "angezeigtername",
"displayname": "Angezeigter Name",

Jede Action besteht aus einem "systemname"´n dieser wird aus dem Anzeigenamen "displayname" generiert. (nur a-z)


Conditions / Bedingungen für Events

"conditions": [],
Anleitung

Wie man Event-Bedinungen/Conditions nutzt findest du Übersicht der Conditions


Minimale Benötigte Version

"minimalReqVersion": 1,

Jedes Event kann nach Updates eine höhere Version benötigen. In der Regel muss hier "1" gesetzt werden. Der Editor setzt standardmäßig "1".


Kommentar

"comment": "Ein optimaler Kommentar der die Funktion beschreibt.",

Du kannst einen Kommentar zu jedem Event erstellen um dir zusätzliche Informationen zu einem Event zu speichern.


Actions

 "actions": []

Im JsonArray "actions" werden die Aktionen hinterlegt.


ButtonType

Hier sind die verschiedenen Discord-Button-Typen, dargestellt mit ihrem jeweiligen Stil:

  • primary: Ein Button mit einer markanten blauen Farbe.
  • secondary: Ein Button mit einer grauen, grauen Farbe.
  • success: Ein Button mit einer grünen Farbe, die Erfolg anzeigt.
  • danger: Ein Button mit einer roten Farbe, die Gefahr oder Warnung signalisiert.

Permissions

Du kannst Permissions festlegen die eine Discord-ID haben muss, um den Button zu nutzen. Die Permission wird mit "main.botctl.dyn." eingeleitet.

Wenn du das Feld frei lässt, kann jeder den Button nutzen.


Beispiel

{
"systemname": "test",
"displayname": "test",
"minimalReqVersion": 1,
"conditions": [],
"comment": "",
"permission": "main.botctl.dyn.test",
"dynButtonType": "primary",
"actions": []
}