DEV - DynamicButtonEvent
Hinweis:Du kannst maximal 25 Buttons erstellen! Jeder Button mus einen eindeutigen Namen haben. Doppelte Namen werden nicht akzeptiert.
Aufbau
| Spezial | System-Name | Art | Validierung | Data-Typ |
|---|---|---|---|---|
| uniqe | systemname | F | a-z_ | String |
| displayname | F | A-Za-z0-9 | String | |
| conditions | F | JsonArray | ||
| minimalReqVersion | S | Float | ||
| comment | O | A-Za-z0-9 !#&<>.,-_ | String | |
| actions | F | JsonArray | ||
| buttonType | F | danger/primary,secondary,success | String | |
| permission | O | main.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": [],
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": []
}