Geplante Aktionen
Nachrichten, Embeds und Chat-Sperren zu einer festen Zeit ausführen lassen.
Mit geplanten Aktionen legst du fest, was der Bot zu einem bestimmten Zeitpunkt tun soll: eine Nachricht senden, ein gespeichertes Embed senden, den Chat sperren oder entsperren. Nachrichten und Embeds lassen sich zusätzlich nach einer Anzahl Sekunden automatisch löschen. Die Aktionen liegen in `data/scheduled.json`. (geplant)
Bild folgt
Das Dashboard mit geöffnetem Tab „Geplante Aktionen“: links die Modulliste, rechts die Einstellungen mit Speichern-Knopf.
Nur die Seite selbst zeigen – ohne Browserleiste, ohne persönliche Daten.
public/docs-assets/modules/geplant.png · 1600x900 · dunkles Design
Ablauf & Ausführung
Die Aktionen laufen im Hintergrund, nicht beim Speichern. Der Bot prüft alle 30 Sekunden, ob eine Aktion fällig ist; nach der Ausführung entfernt er den Eintrag aus data/scheduled.json.
- Aktion anlegen: Typ, Kanal und Ausführungszeit wählen — bei
messageundembedzusätzlich Inhalt bzw. Embed. - Der Bot wartet, bis der Zeitpunkt erreicht ist (Prüfung alle 30 Sekunden).
- Zur fälligen Zeit führt er die Aktion aus und streicht den Eintrag aus der Liste.
Zielkanal muss erreichbar sein
Findet der Bot den Zielkanal zur Ausführungszeit nicht mehr (gelöscht oder für ihn nicht erreichbar), wird der Eintrag trotzdem entfernt — die Aktion läuft dann nicht nach.Aktionstypen im Detail
message- Sendet den hinterlegten Text in den Kanal.
embed- Sendet ein im Embed-Modul gespeichertes Embed; es wird zur Ausführungszeit frisch aus der Embed-Ablage gelesen.
lock- Verweigert der
@everyone-Rolle das Recht „Nachrichten senden“ im Zielkanal. unlock- Nimmt diese Verweigerung wieder zurück (die Einstellung geht auf neutral), sodass die normalen Server- und Kanalrechte gelten.
Bei message und embed kannst du zusätzlich Nach X Sekunden löschen setzen: 1 bis 86400 Sekunden (24 Stunden). Leer oder 0 lässt die Nachricht stehen. Bei lock und unlock gibt es dieses Feld nicht.
Kanäle & Rechte
- Auswählbar sind Text- und Ankündigungskanäle.
- Für
messageundembedbraucht der Bot Nachrichten senden im Zielkanal. - Für
lockundunlockbraucht er Kanäle verwalten, um die Kanalrechte der@everyone-Rolle zu ändern.
Einstellungen im Dashboard
| Einstellung | Typ | Bedeutung |
|---|---|---|
Modul Geplante Aktionen aktivtimedEnabled | Schalter | Schaltet das Modul Geplante Aktionen ein oder aus. Nur bei aktivem Modul führt der Bot die Aktionen aus. |
Typtype | Text | Art der Aktion: message (Nachricht senden), embed (Embed senden), lock (Chat sperren) oder unlock (Chat entsperren). |
KanalchannelId | Kanal | Kanal, in dem die Aktion ausgeführt wird. Zur Auswahl stehen Text- und Ankündigungskanäle. |
AusführungszeitexecuteAt | Text | Zeitpunkt, zu dem der Bot die Aktion ausführt. Die Zeit muss in der Zukunft liegen. |
Nachrichtentextpayload.content | Text | Text der Nachricht. Nur beim Typ message. |
Embedpayload.embedId | Text | Auswahl eines gespeicherten Embeds aus dem Embed-Modul. Nur beim Typ embed. |
Nach X Sekunden löschen (optional)payload.deleteAfterSeconds | Zahl | Löscht die gesendete Nachricht oder das Embed nach dieser Anzahl Sekunden wieder. Leer lassen, um sie zu behalten. Erlaubt sind 0 bis 86400 Sekunden (24 Stunden). Nur bei den Typen message und embed. |
Stolperfallen
- Der Bot muss zur geplanten Zeit online sein. Überfällige Aktionen führt er beim nächsten Bot-Check aus.
- Die Ausführungszeit muss in der Zukunft liegen; ein Zeitpunkt in der Vergangenheit wird abgelehnt.
- Für den Typ
embedmuss ein gespeichertes Embed ausgewählt werden.
Siehe auch