Automationen

Eine Automation ist ein Satz:

Wenn jemand X tut, falls all das zutrifft, dann tue diese Dinge.

Regeln laufen je Auslöser unabhängig. Bis zu 50 Regeln pro Server.

Regel-Grundlagen

Regelname

1–60 Zeichen · Pflicht

Interner Bezeichner. Benenn ihn nach dem, was er tut — Willkommensrolle, Keine Links für Neue — denn in einem halben Jahr ist die Liste deine einzige Dokumentation.

Regel aktiv

Standard true

Eine einzelne Regel ausschalten, ohne sie zu löschen. Praktisch für saisonale Regeln und um einzugrenzen, welche Regel etwas verursacht.

Abklingzeit

0–86400 Sekunden · Standard 0

Wiederauslöse-Sperre pro Nutzer. 0 heißt keine Sperre. Ein Zeitplan hat keinen Nutzer, dort gilt die Sperre für die Regel selbst.

Auslöser

Das Ereignis, das die Regel startet. Genau einer pro Regel.

Ein Mitglied…

• sendet eine Nachricht
• bearbeitet eine Nachricht
• löscht eine Nachricht
• klickt einen Automations-Button
• fügt eine Reaktion hinzu
• erhält eine Rolle
• verliert eine Rolle
• betritt einen Voice-Kanal
• verlässt einen Voice-Kanal
• erstellt einen Thread
• tritt dem Server bei

Oder ganz ohne, dass jemand etwas tut:

• Zu einer festen Zeit (Zeitplan)

Auslöser-Filter

Optionale Einschränkung vor der Bedingungsprüfung — günstiger und klarer, als dasselbe als Bedingung auszudrücken.

Kanalfilter akzeptieren auch Kategorie-IDs — eine Kategorie-ID deckt jeden Kanal darin ab.

Zeitplan

Eine Zeitplan-Regel läuft nach der Uhr statt als Reaktion auf ein Mitglied. Sie braucht einen fünfteiligen Cron-Ausdruck — Minute Stunde Tag-des-Monats Monat Wochentag, wobei *, a,b, a-b und */n unterstützt werden, Namen wie MON oder Kürzel wie @daily nicht — und die IANA-Zeitzone, in der er gelesen wird (Europe/Berlin; leer heißt UTC). Der Editor bietet Vorlagen (jede Stunde, alle 6 Stunden, täglich um 20:00, jeden Montag um 20:00, am Monatsersten um 09:00) und zeigt die nächsten Läufe an. Die Auflösung ist eine Minute.

Ist Cloudy kurz ausgelastet oder startet neu, wird ein Lauf aus den letzten zehn Minuten nachgeholt — einmal, nicht einmal pro verpasster Minute. Bei der Umstellung auf Winterzeit feuert eine feste Uhrzeit wie 30 2 * * * nur beim ersten 02:30; eine Regel, die durch die Stunde läuft (*/5 * * * *), läuft in Echtzeit weiter. Bei der Umstellung auf Sommerzeit entfällt eine Uhrzeit, die es in dieser Nacht nicht gibt.

Weil niemand gehandelt hat, hat ein Zeitplan weder Mitglied noch Nachricht: Die Rollen-, Moderations-, DM-, Coin- und XP-Aktionen sowie jede Nachrichtenaktion außer Eine Nachricht senden stehen nicht zur Verfügung, und Eine Nachricht senden braucht einen ausdrücklichen Kanal. Auch Bedingungen treffen bei einem Zeitplan nie zu — es gibt keinen Nutzer und keinen Kanal zu prüfen —, lass die Liste also leer.

Bedingungen

Alle Bedingungen müssen zutreffen (logisches UND). Leere Liste heißt: läuft immer. Bis zu 20 Bedingungen.

Textabgleich ignoriert Groß- und Kleinschreibung. Grenzen: bis zu 100 Kanäle, 50 Rollen, 100 Nutzer-IDs, 100 Phrasen (je 1–200 Zeichen) pro Bedingung.

Aktionen

Werden der Reihe nach ausgeführt. Eine scheiternde Aktion wird übersprungen, der Rest läuft weiter. Zwischen 1 und 15 Aktionen pro Regel.

Rollen

Moderation

Nachrichten

Nachrichteninhalte unterstützen die üblichen Platzhalter. {server.memberCount} steht in der Sprache des Servers (1.234 / 1,234), auch bei einem Zeitplan.

Buttons

Eine Nachricht senden-Aktion kann bis zu fünf Buttons anhängen:

Die Button-ID ist das, worauf ein Button-Klick-Auslöser abgleicht. Genau das macht Automationen interaktiv: Regel A postet eine Nachricht mit einem Button namens apply, Regel B löst auf einen Button-Klick gefiltert auf apply aus und vergibt eine Rolle.

Economy & XP

Coin-Aktionen schreiben direkt ins Economy-Guthaben des Mitglieds. XP-Aktionen schreiben ins Leveling und scheitern, solange dieses Plugin deaktiviert ist.

Beispiele

Auto-Rolle beim Beitritt

Wenn:  Dem Server beitritt
Falls: (nichts)
Dann:  Diese Rollen dem Nutzer geben → @Member

Vorschlags-Threads

Wenn:  Eine Nachricht sendet
       Nur in diesen Kanälen → #vorschlaege
Falls: (nichts)
Dann:  Mit diesen Emojis reagieren → 👍 👎
       Aus der Nachricht einen Thread erstellen → "Diskussion"

Keine Links bis Level 5

Wenn:  Eine Nachricht sendet
Falls: Der Nutzer hat keine dieser Rollen → @Level 5
       Die Nachricht enthält eines dieser Wörter → http:// https://
Dann:  Die Nachricht löschen
       Dem Nutzer eine DM senden → "Links werden ab Level 5 freigeschaltet."

Ein Bewerbungs-Button zur Selbstbedienung

Regel 1
Wenn:  Dem Server beitritt
Dann:  Eine Nachricht senden → #welcome, "Bewerben?" + Button-ID "apply"

Regel 2
Wenn:  Einen Button klickt
       Nur diese Button-IDs → apply
Dann:  Diese Rollen dem Nutzer geben → @Bewerber
       Auf die Nachricht antworten → "Du hast jetzt @Bewerber — schau in #bewerbungen."

Wöchentliche Erinnerung

Wenn:  Zu einer festen Zeit → 0 20 * * 1, Europe/Berlin
Dann:  Eine Nachricht senden → #allgemein, "Community-Abend startet in einer Stunde!"

Verhaltenshinweise

• Regeln sind unabhängig. Zwei Regeln auf demselben Auslöser laufen beide; es gibt keine Priorität und kein Abbrechen nach der ersten.
• Bots lösen nie Regeln aus — Cloudys eigene Nachrichten und Reaktionen eingeschlossen.
• Löscht eine Nachricht greift nur für Nachrichten, die Cloudy noch im Speicher hatte. Bei einer älteren Nachricht verrät Discord nicht, wer sie geschrieben hat — sie könnte von einem Bot, einem Webhook oder Cloudy selbst stammen —, deshalb löst ihr Löschen nichts aus.
• Eine Regel, die sich selbst erneut auslöst, läuft weiter, bis der Server sein Budget von 30 Regelausführungen pro Minute erreicht; alles darüber wird für den Rest der Minute verworfen. Nutze Abklingzeiten und Kanalfilter, statt dich auf das Budget zu verlassen.
• Aktionen ohne die nötigen Rechte scheitern und werden übersprungen — in Discord ist davon nichts zu sehen —, der Rest der Regel läuft weiter. Prüfe deine Rechte, wenn eine Aktion nie zu passieren scheint.
• Rollenaktionen unterliegen der Rollenhierarchie: Cloudy kann keine Rolle über der eigenen vergeben. Solche Rollen und verwaltete Rollen (Bot- und Booster-Rollen) werden still übersprungen.
• Gespeicherte Änderungen erreichen den Bot binnen etwa einer Minute.
• Beitritts-Regeln greifen nicht für ein Mitglied, das der Raid- oder Alt-Schutz gerade in Quarantäne gesetzt, gekickt oder gebannt hat.
• Regeln für Rolle erhalten/verloren greifen auch bei Mitgliedern, die eine Weile inaktiv waren: Cloudy merkt sich die Rollen eines Mitglieds 7 Tage lang, nachdem es seinen Beitritt oder eine Rollenänderung zuletzt gesehen hat. Die erste Rollenänderung eines Mitglieds, das länger still war — oder das Cloudy seit dem Anlegen der Regel nie gesehen hat —, kann noch fehlen.
• Nachricht reposten verlinkt Anhänge über 10 MB statt sie neu hochzuladen und kürzt Text auf Discords 2000 Zeichen.
• Coins hinzufügen/entfernen tut nichts, solange das Economy-Plugin aus (oder nicht lizenziert) ist — wie die XP-Aktionen beim Leveling.