Automationen: WENN-FALLS-DANN-Regeln ohne Code

Mit Automationen baust du eigene Regeln nach dem Muster WENN – FALLS – DANN, ohne Code: Ein Trigger (WENN) startet die Regel, beliebig viele Bedingungen (FALLS) prüfen, ob sie wirklich gilt, und die Aktionen (DANN) laufen der Reihe nach ab. Beispiel: *Wenn jemand beitritt, falls das Konto jünger als 7 Tage ist, dann sende eine Nachricht an das Team.*

Eine kurze Anleitung findest du in den Ratgebern Automationen und Automations-Regeln.

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Rechte von Kage: Je nach Aktion braucht Kage Nachrichten senden, Rollen verwalten, Nachrichten verwalten (löschen, anpinnen), Reaktionen hinzufügen oder Threads erstellen.
• Rollenreihenfolge: Für Rollen-Aktionen muss Kages Rolle über der Zielrolle stehen.
• Tarif: Welchen Tarif das Modul braucht, zeigt der Tarifhinweis oben auf dieser Seite. Läuft der Tarif aus, pausiert Kage alle Regeln.

Aufbau einer Regel

Eine Regel hat einen Namen, einen Trigger, null bis 20 Bedingungen und bis zu 10 Aktionen. Ohne Bedingungen feuert sie bei jedem Trigger. Ohne Aktionen tut sie nichts.

Trigger (WENN)

Bot-Nachrichten und -Mitglieder lösen nie eine Regel aus. Das ist eine feste Sicherheitsregel und lässt sich nicht abschalten.

Bedingungen (FALLS)

Das Dashboard zeigt zu jedem Trigger nur die sinnvollen Bedingungen an.

Standardmäßig müssen alle Bedingungen zutreffen (UND). Du kannst die Verknüpfung auf ODER umstellen: Dann genügt eine zutreffende Bedingung. Verschachtelte Klammern gibt es nicht.

Aktionen (DANN)

Der Trigger „Mitglied hat den Server verlassen“ erlaubt nur Nachricht, Embed-Vorlage und Protokoll. Der Zeitplan-Trigger erlaubt ebenfalls nur diese drei. Aktionen, die es bei einem Trigger nicht gibt (zum Beispiel Löschen ohne Nachricht), überspringt Kage.

Es gibt keine Kick-, Bann- oder Timeout-Aktion. Eine falsch eingerichtete Regel könnte sonst ganze Gruppen sperren. Dafür nutzt du die Moderation.

Platzhalter

In Texten kannst du diese Platzhalter verwenden:

Unbekannte Platzhalter bleiben stehen. Texte kürzt Kage auf 2.000 Zeichen. Bei Zeitplan-Regeln gibt es kein auslösendes Mitglied, {user} bleibt dort leer.

Der Zeitplan-Trigger

Alle Uhrzeiten gelten als UTC, es gibt keine Zeitzone pro Regel. Kage prüft jede Minute und löst eine Regel pro Zeitfenster nur einmal aus.

So führt Kage eine Regel aus

1. Ein Ereignis tritt ein. Kage sucht alle aktiven Regeln mit passendem Trigger.
2. Jede Regel hat eine Mindestpause von 3 Sekunden, damit eine Regel, die selbst Nachrichten sendet, keine Endlosschleife erzeugt.
3. Kage prüft die Bedingungen (UND oder ODER).
4. Treffen sie zu, führt Kage die Aktionen der Reihe nach aus. Scheitert eine (zum Beispiel wegen fehlender Rechte), läuft die nächste trotzdem weiter.
5. Kage zählt die Ausführung und merkt sich den Zeitpunkt, beides siehst du im Dashboard („N× ausgeführt“, „zuletzt …“). Im Reiter Logs steht jede Auslösung.

Im Dashboard

Unter Automationen legst du Regeln an, bearbeitest, pausierst und löschst sie. Mit Vorlagen startest du aus Beispielen. Jede Regel zeigt Trigger, Zahl der Bedingungen und Aktionen und ihre Ausführungsstatistik.

Das Dashboard begrenzt die Regelzahl nach Tarif: Premium bis zu 25 Regeln, Enterprise bis zu 150. Bereits vorhandene Regeln über der Grenze werden nicht gekürzt, nur weiteres Wachstum wird blockiert.

Einstellungen im Überblick

Ergebnis überprüfen

1. Einfache Testregel: Trigger „Nachricht gesendet“, Bedingung „Nachricht enthält Text“ mit „!ping“, Aktion „Nachricht senden“ mit „pong“.
2. Auslösen: Schreibe „!ping“. Kage antwortet mit „pong“.
3. Statistik: Die Regel zeigt „1× ausgeführt“, und der Reiter Logs nennt sie.

Fehlerbehebung

Die Regel feuert nicht

Prüfe, ob das Modul und die Regel aktiv sind, ob der Trigger zum Ereignis passt und ob alle Bedingungen (bei UND) zutreffen. Bots lösen nie aus. Bei Zeitplänen zählt die Uhrzeit in UTC.

Eine Aktion passiert nicht

Meist fehlt Kage ein Recht, oder die Rollenreihenfolge stimmt nicht. Das Betriebslog nennt die Aktion; in Discord erscheint keine Meldung. Außerdem gilt die Aktion nicht bei jedem Trigger (siehe Tabelle).

Die Regel feuert zu oft oder in Schleifen

Eine Regel pausiert nach jeder Auslösung 3 Sekunden. Baue Bedingungen so, dass die Antwort der Regel sie nicht erneut auslöst. Bots lösen ohnehin nie aus.

Der Zeitplan kommt zur falschen Uhrzeit

Alle Zeitpläne laufen in UTC. In Mitteleuropa liegt die Ortszeit 1 bis 2 Stunden darüber. Rechne die Uhrzeit um.

Die Regel lässt sich nicht speichern

Die Obergrenze deines Tarifs ist erreicht, oder die Regel enthält mehr als 20 Bedingungen bzw. 10 Aktionen.

Weiterführend

Einfache Text-Antworten: Eigene Befehle. Feste Zeitpläne für Nachrichten: Auto-Nachrichten. Gestaltete Nachrichten: Embeds.