Datenspeicher

Speichere und lese dauerhafte Werte, Zähler, Listen und Zuordnungen.

Strukturwert erstellen

Erstellt einen Strukturwert mit benannten, typisierten Feldern nach einer der Strukturen, die dieses Modul oder dieser Server festlegt. Jedes Feld bekommt einen Wert oder eine Verbindung.

Eingaben

Name	Typ	Pflicht	Details
Struktur	Struktur	Ja	Welcher Struktur der neue Strukturwert folgt. Sie bestimmt, welche Felder er hat und welchen Typ jedes davon hat.
Inhalt	Strukturwert	Ja	Ein Wert pro Feld der gewählten Struktur. Optionale Felder dürfen leer bleiben und werden dann als leer zurückgelesen.

Ausgaben

Name	Typ	Details
Strukturwert	Strukturwert	Der neue Strukturwert.

Feld eines Strukturwerts lesen

Liest ein Feld eines Strukturwerts. Der Wert hat den für dieses Feld festgelegten Typ und muss daher nicht umgewandelt werden.

Eingaben

Name	Typ	Pflicht	Details
Strukturwert	Strukturwert	Ja	Der Strukturwert, aus dem gelesen wird.
Feld	Feld eines Strukturwerts	Ja	Welches Feld gelesen wird. Maximale Länge: 64 Zeichen.

Ausgaben

Name	Typ	Details
Wert	Feldwert	Der Wert des Felds oder leer, wenn der Strukturwert dieses Feld nicht enthält. Kann leer sein.

Felder eines Strukturwerts ändern

Erstellt eine Kopie eines Strukturwerts, in der nur die gewählten Felder geändert sind. Alle anderen Felder behalten ihren Wert, du musst sie also nicht neu verbinden. Ohne gewählte Struktur werden die neuen Werte beim Ausführen des Flows nicht geprüft. Zum Hoch- oder Runterzählen nimm stattdessen "Gespeicherte Zahl erhöhen": dieser Schritt kann nichts zu einem Wert addieren. Lesen, Ändern und Speichern eines Eintrags sind getrennte Schritte, daher können sich zwei Läufe, die gleichzeitig denselben Eintrag ändern, gegenseitig überschreiben.

Eingaben

Name	Typ	Pflicht	Details
Strukturwert	Strukturwert	Ja	Der Wert, der geändert wird. Er selbst bleibt gleich: der Schritt gibt eine geänderte Kopie zurück.
Struktur	Struktur	Nein	Die Struktur des Werts. Ist sie gesetzt, werden die neuen Werte beim Ausführen des Flows daran geprüft, und Felder, die dem Wert fehlen, weil sie der Struktur später hinzugefügt wurden, bekommen ihren Standardwert.
Änderungen	Feldänderungen	Ja	Die zu ändernden Felder und ihre neuen Werte. Lass ein Feld weg, um es zu behalten. Ein leerer Wert ist nur bei Feldern erlaubt, die leer sein dürfen.

Ausgaben

Name	Typ	Details
Geänderter Wert	Strukturwert	Die Kopie mit deinen Änderungen. Speichere sie, damit sie erhalten bleiben.

Gespeicherten Wert lesen

Liest einen Wert aus einem Speicherfeld.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Standardwert	Gespeicherter Wert	Nein	Wert, der zurückgegeben wird, wenn nichts gespeichert ist (muss dem Feldtyp entsprechen).

Ausgaben

Name	Typ	Details
Wert	Gespeicherter Wert	Gespeicherter Wert oder leer, wenn nichts gespeichert ist. Kann leer sein.

Wert speichern

Schreibt einen Wert in ein Speicherfeld.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Wert	Gespeicherter Wert	Ja	Wert, der gespeichert wird. Muss dem auf dem Feld festgelegten Typ entsprechen.

Ausgaben

Name	Typ	Details
Ersetzt	Ja/Nein	Ob hier bereits ein Wert gespeichert war und jetzt überschrieben wurde.

Gespeicherte Zahl erhöhen

Addiert in einem sicheren Schritt (atomar innerhalb eines Bot-Prozesses) eine Zahl zu einem numerischen Speicherfeld oder zu einem Zahlenfeld in einer gespeicherten Struktur und gibt den neuen Wert zurück. Ein Strukturwert, der gespeichert wurde, bevor ein Feld dazukam, bekommt den Standardwert dieses Felds.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Feld in der Struktur	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Feld mit ganzer Zahl oder Dezimalzahl, das geändert wird. Bei einem einfachen Zahlenfeld leer lassen. Maximale Länge: 64 Zeichen.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Um	Dezimalzahl	Ja	Betrag, der addiert wird (kann negativ sein). Schalte Abziehen ein, um ihn abzuziehen. Standard: 1.
Abziehen	Ja/Nein	Ja	Zieht den Betrag ab, statt ihn zu addieren. Standard: Nein.

Ausgaben

Name	Typ	Details
Neuer Wert	Gespeicherter Wert	Wert nach der Änderung.

Gespeicherten Wert löschen

Löscht einen gespeicherten Wert aus einem Speicherfeld.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.

Speichereinträge auflisten

Gibt die obersten Einträge eines Speicherfelds sortiert nach Wert zurück (z. B. für Ranglisten). Personen ohne Zahl in diesem Feld werden ausgelassen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Rang nach Feld	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Zahlenfeld, nach dem die Einträge sortiert werden. Leer lassen, um alle Einträge aufzulisten. Maximale Länge: 64 Zeichen.
Richtung	Sortierrichtung	Ja	Sortierrichtung (absteigend liefert die höchsten Werte zuerst). Standard: Absteigend.
Limit	Ganzzahl	Ja	Maximale Anzahl an Einträgen (1-100). Wert: 1 bis 100. Standard: 10.

Ausgaben

Name	Typ	Details
Einträge	Liste von Speichereintrag	Sortierte Einträge, jeweils mit Subjekt und Wert.

Speichereinträge seitenweise auflisten

Gibt eine nach Wert sortierte Seite von Speichereinträgen samt Seitenmetadaten zurück. Benutzerbezogene Einträge stellen ihren Discord-Benutzer direkt bereit. Personen ohne Zahl in diesem Feld werden ausgelassen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Rang nach Feld	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Zahlenfeld, nach dem die Einträge sortiert werden. Leer lassen, um alle Einträge aufzulisten. Maximale Länge: 64 Zeichen.
Richtung	Sortierrichtung	Ja	Sortierrichtung (absteigend liefert die höchsten Werte zuerst). Standard: Absteigend.
Einträge pro Seite	Ganzzahl	Ja	Maximale Einträge pro Seite (1-100). Wert: 1 bis 100. Standard: 10.
Seite	Ganzzahl	Ja	Zurückzugebende Seitennummer, beginnend bei 1. Wert: 1 bis 1000000. Standard: 1.

Ausgaben

Name	Typ	Details
Einträge	Liste von Speichereintrag	Einträge dieser Seite. Der Wert ist bereits der gespeicherte Feldwert; Benutzerfelder stellen einen aufgelösten Benutzer bereit.
Einträge insgesamt	Ganzzahl	Gesamtzahl der Einträge über alle Seiten.
Seite	Ganzzahl	Die angeforderte Seitennummer.
Seitenanzahl	Ganzzahl	Gesamtzahl der verfügbaren Seiten.
Hat nächste Seite	Ja/Nein	Ob eine weitere Seite folgt.
Hat vorherige Seite	Ja/Nein	Ob eine vorherige Seite existiert.

Rang eines gespeicherten Werts abrufen

Gibt die Position eines Subjekts innerhalb eines Speicherfelds zurück, sortiert nach Wert (z. B. "#42 auf der Rangliste"). Personen ohne Zahl in diesem Feld werden ausgelassen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Rang nach Feld	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Feld mit ganzer Zahl oder Dezimalzahl, nach dem der Rang bestimmt wird. Maximale Länge: 64 Zeichen.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.

Ausgaben

Name	Typ	Details
Rang	Ganzzahl	Position sortiert nach Wert (beginnend bei 1) oder leer, wenn nichts gespeichert ist. Kann leer sein.

Eintrag zur gespeicherten Liste hinzufügen

Hängt einen Eintrag sicher ans Ende einer gespeicherten Liste an.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Eintrag	Beliebig	Ja	Eintrag, der angehängt wird.

Ausgaben

Name	Typ	Details
Neue Länge	Ganzzahl	Anzahl der Einträge in der Liste nach dem Hinzufügen. Sie ist 1, wenn dieses Hinzufügen die Liste angelegt hat. Das ist der sichere Weg, um ohne zusätzliches Lesen zu prüfen: "Bin ich der Erste?"

Aus gespeicherter Liste entfernen

Entfernt den Eintrag an der angegebenen Position sicher aus einer gespeicherten Liste.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Index	Ganzzahl	Ja	Position des Eintrags, der entfernt wird (beginnend bei 0).

Ausgaben

Name	Typ	Details
Entfernt	Ja/Nein	Ob wirklich ein Eintrag entfernt wurde. Falsch, wenn an dieser Position kein Eintrag lag.
Neue Länge	Ganzzahl	Anzahl der Einträge in der Liste danach.

Schlüssel in gespeicherter Zuordnung setzen

Setzt einen Schlüssel in einer gespeicherten Zuordnung sicher auf einen Wert.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Schlüssel	Text	Ja	Schlüssel innerhalb der gespeicherten Zuordnung.
Wert	Beliebig	Ja	Wert, der unter dem Schlüssel gespeichert wird.

Ausgaben

Name	Typ	Details
Ersetzt	Ja/Nein	Ob dieser Schlüssel bereits vorhanden war und jetzt überschrieben wurde.
Neue Schlüsselanzahl	Ganzzahl	Anzahl der Schlüssel in der Zuordnung danach.

Schlüssel aus gespeicherter Zuordnung entfernen

Entfernt einen Schlüssel sicher aus einer gespeicherten Zuordnung.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Schlüssel	Text	Ja	Schlüssel, der aus der gespeicherten Zuordnung entfernt wird.

Ausgaben

Name	Typ	Details
Entfernt	Ja/Nein	Ob der Schlüssel wirklich vorhanden war und jetzt entfernt wurde.
Neue Schlüsselanzahl	Ganzzahl	Anzahl der Schlüssel in der Zuordnung danach.

Gespeicherter Wert vorhanden?

Prüft, ob ein Speicherfeld aktuell einen Wert hat.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.

Ausgaben

Name	Typ	Details
Vorhanden	Ja/Nein	Wahr, wenn ein Wert gespeichert ist, sonst falsch.

Eintrag aus gespeicherter Liste entfernen

Entfernt passende Einträge anhand ihres Werts aus einer gespeicherten Liste.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Eintrag	Beliebig	Ja	Wert, der aus der Liste entfernt wird.
Alle entfernen	Ja/Nein	Ja	Jeden passenden Eintrag entfernen, nicht nur den ersten. Standard: Nein.

Ausgaben

Name	Typ	Details
Entfernt	Ja/Nein	Ob mindestens ein passender Eintrag entfernt wurde.
Anzahl entfernt	Ganzzahl	Wie viele Einträge entfernt wurden. Höchstens 1, außer "Alle entfernen" ist aktiv.
Neue Länge	Ganzzahl	Anzahl der Einträge in der Liste danach.

Gespeicherte Liste enthält Eintrag?

Prüft, ob eine gespeicherte Liste einen Wert enthält.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Eintrag	Beliebig	Ja	Wert, nach dem in der Liste gesucht wird.

Ausgaben

Name	Typ	Details
Enthält	Ja/Nein	Wahr, wenn die Liste den Eintrag enthält.

Schlüssel aus gespeicherter Zuordnung lesen

Liest einen einzelnen Schlüssel aus einer gespeicherten Zuordnung.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Schlüssel	Text	Ja	Schlüssel innerhalb der gespeicherten Zuordnung.
Standardwert	Beliebig	Nein	Wert, der zurückgegeben wird, wenn der Schlüssel nicht vorhanden ist.

Ausgaben

Name	Typ	Details
Wert	Beliebig	Unter dem Schlüssel gespeicherter Wert oder der Standardwert (bzw. leer), wenn nicht vorhanden. Kann leer sein.

Gespeicherte Zuordnung hat Schlüssel?

Prüft, ob eine gespeicherte Zuordnung einen Schlüssel enthält.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Schlüssel	Text	Ja	Schlüssel innerhalb der gespeicherten Zuordnung.

Ausgaben

Name	Typ	Details
Vorhanden	Ja/Nein	Wahr, wenn die Zuordnung den Schlüssel hat.

Einträge gespeicherter Zuordnung auflisten

Gibt jeden Schlüssel und Wert einer gespeicherten Zuordnung zurück.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.

Ausgaben

Name	Typ	Details
Einträge	Liste von Eintrag der Zuordnung	Jeder Eintrag der Zuordnung mit Schlüssel und Wert.

Speicherschlüssel auflisten

Gibt die Schlüssel (Subjekt-IDs) zurück, die aktuell einen gespeicherten Wert für das Feld haben. Funktioniert bei Feldern mit bis zu 10.000 Schlüsseln; bei einem größeren Feld schlägt die Aktion mit einem abfangbaren Limit-Fehler fehl.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.

Ausgaben

Name	Typ	Details
Schlüssel	Liste von Text	Die gespeicherten Schlüssel / Subjekt-IDs.

Speicherschlüssel suchen

Filtert die Schlüssel (Subjekt-IDs) des Felds nach einer Suchanfrage, zuerst nach Präfix, dann nach enthaltenem Text - wie bei der Autovervollständigung. Eine leere Anfrage gibt Schlüssel bis zum Limit zurück. Funktioniert bei Feldern mit bis zu 10.000 Schlüsseln; bei einem größeren Feld schlägt die Aktion mit einem abfangbaren Limit-Fehler fehl.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Suchanfrage	Text	Nein	Text, mit dem die Schlüssel verglichen werden (zuerst Präfix, dann enthalten). Leer lassen, um alle Schlüssel zurückzugeben. Maximale Länge: 100 Zeichen.
Limit	Ganzzahl	Ja	Maximale Anzahl zurückgegebener Schlüssel (1-100). Wert: 1 bis 100. Standard: 25.

Ausgaben

Name	Typ	Details
Schlüssel	Liste von Text	Die passenden Schlüssel / Subjekt-IDs, beste Treffer zuerst.

Speichereinträge suchen

Gibt die Einträge des Felds innerhalb eines numerischen Wertebereichs zurück, jeweils mit ihrem Gesamtrang im sortierten Feld.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Mindestwert	Dezimalzahl	Nein	Nur Einträge einbeziehen, deren Wert mindestens so groß ist (leer lassen für keine Untergrenze).
Höchstwert	Dezimalzahl	Nein	Nur Einträge einbeziehen, deren Wert höchstens so groß ist (leer lassen für keine Obergrenze).
Richtung	Sortierrichtung	Ja	Sortierrichtung für das Ranking (absteigend gibt dem höchsten Wert Rang 1). Standard: Absteigend.
Limit	Ganzzahl	Ja	Maximale Anzahl passender Einträge (1-100). Wert: 1 bis 100. Standard: 10.

Ausgaben

Name	Typ	Details
Einträge	Liste von Speichereintrag	Passende Einträge, jeweils mit Subjekt, Wert und Gesamtrang.

Speicherfeld aggregieren

Berechnet eine einzelne Zahl über die Einträge eines Felds - Summe, Durchschnitt, Anzahl, Minimum, Maximum oder Median - mit optionalem Wertebereichsfilter.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Operation	Aggregat-Operation	Ja	Welche Aggregation über die Werte des Felds berechnet wird. Standard: Summe.
Mindestwert	Dezimalzahl	Nein	Nur Einträge einbeziehen, deren Wert mindestens so groß ist (leer lassen für keine Untergrenze).
Höchstwert	Dezimalzahl	Nein	Nur Einträge einbeziehen, deren Wert höchstens so groß ist (leer lassen für keine Obergrenze).

Ausgaben

Name	Typ	Details
Ergebnis	Dezimalzahl	Die berechnete Zahl. Leer, wenn es nichts zu aggregieren gibt (Anzahl gibt 0 zurück). Bei einem Feld mit großer ganzer Zahl ist sie eine exakte ganze Zahl beliebiger Größe, Durchschnitt und Median werden auf die nächste ganze Zahl gerundet. Kann leer sein.
Anzahl	Ganzzahl	Wie viele Einträge zum Ergebnis beigetragen haben.

Zufällig aus Speicher wählen

Zieht zufällige Einträge aus einem Feld - gleichverteilt oder gewichtet nach dem Wert jedes Eintrags (eine Verlosung nach Losanzahl). Ziehungen erfolgen ohne Zurücklegen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Anzahl	Ganzzahl	Ja	Wie viele Einträge gezogen werden (1-100). Auf die Anzahl möglicher Einträge begrenzt. Wert: 1 bis 100. Standard: 1.
Gewichten nach	Ziehungsgewichtung	Ja	Wie wahrscheinlich jeder Eintrag gezogen wird: gleichverteilt über Schlüssel oder gewichtet nach Wert. Standard: Gleichverteilt.

Ausgaben

Name	Typ	Details
Ziehungen	Liste von Speichereintrag	Die gezogenen Einträge, jeweils mit Subjekt, Wert und Gesamtrang.

Erhöhen wenn (atomar)

Erhöht eine gespeicherte Zahl nur dann, wenn ihr aktueller Wert eine Bedingung erfüllt. Der sichere Weg für "ausgeben, wenn das Guthaben reicht".

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (bei schlüsselbezogenen Feldern). Maximale Länge: 100 Zeichen.
Bedingung	Vergleich	Ja	Wie der aktuelle Wert vor dem Anwenden mit dem Schwellenwert verglichen wird. Standard: Mindestens (≥)
Schwellenwert	Dezimalzahl	Ja	Wert, mit dem der aktuelle Wert verglichen wird. Standard: 0.
Betrag	Dezimalzahl	Ja	Wie viel addiert wird, wenn die Bedingung erfüllt ist (negativer Betrag zum Abziehen). Standard: 1.

Ausgaben

Name	Typ	Details
Angewendet	Ja/Nein	Ob die Bedingung erfüllt war und der Wert geändert wurde.
Neuer Wert	Dezimalzahl	Der resultierende gespeicherte Wert (unverändert, wenn die Bedingung nicht erfüllt war).

Gespeicherten Wert setzen wenn (atomar)

Schreibt einen Wert nur dann in ein Speicherfeld, wenn der dort aktuell gespeicherte Wert eine Bedingung erfüllt. Prüfen und Schreiben passieren in einem einzigen Schritt, deshalb können zwei gleichzeitige Durchläufe nie beide erfolgreich sein. Mit "Nur wenn nichts gespeichert ist" baust du eine Sperre: Wer "Angewendet" = wahr erhält, darf weitermachen, alle anderen müssen warten. Mit "Nur wenn er gleich ist" änderst du einen Wert sicher, nachdem du ihn gelesen hast.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.
Bedingung	Bedingung	Ja	Was auf den aktuell gespeicherten Wert zutreffen muss, damit der neue Wert geschrieben wird. Standard: Nur wenn nichts gespeichert ist.
Erwarteter Wert	Gespeicherter Wert	Nein	Wert, mit dem der gespeicherte Wert verglichen wird. Wird nur von den Bedingungen "gleich" und "ungleich" verwendet.
Wert	Gespeicherter Wert	Ja	Wert, der gespeichert wird, wenn die Bedingung erfüllt ist. Muss dem auf dem Feld festgelegten Typ entsprechen.

Ausgaben

Name	Typ	Details
Angewendet	Ja/Nein	Ob die Bedingung erfüllt war und der Wert geschrieben wurde. Mit "Nur wenn nichts gespeichert ist" ist das deine Sperre: wahr bedeutet, dieser Durchlauf hat sie bekommen.
Neuer Wert	Gespeicherter Wert	Der danach gespeicherte Wert: der neue Wert, wenn er geschrieben wurde, sonst der Wert, der schon da ist (so siehst du, wer die Sperre hält, oder kannst es mit dem aktuellen Wert erneut versuchen). Kann leer sein.

Speicherfeld leeren

Löscht jeden gespeicherten Wert eines Felds - oder nur den eines Subjekts/Schlüssels, wenn eines angegeben ist.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Wert gehört (erforderlich bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Wert gespeichert ist (erforderlich bei Feldern mit Schlüssel). Maximale Länge: 100 Zeichen.

Rangliste formatieren

Erstellt aus den obersten Einträgen eines Felds einen sendefertigen Rangliste-Text. Zeilenvorlage-Tokens: %rank%, %mention% (rendert <@key>, nur bei benutzerbezogenen Feldern sinnvoll), %key%, %value%. Personen ohne Zahl in diesem Feld werden ausgelassen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Rang nach Feld	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Feld mit ganzer Zahl oder Dezimalzahl, nach dem sortiert wird. Jede Zeile zeigt diese Zahl. Maximale Länge: 64 Zeichen.
Richtung	Sortierrichtung	Ja	Sortierrichtung (absteigend listet die höchsten Werte zuerst). Standard: Absteigend.
Limit	Ganzzahl	Ja	Maximale Anzahl an Zeilen (1-100). Wert: 1 bis 100. Standard: 10.
Zeilenvorlage	Text	Ja	Vorlage für jede Zeile. Tokens: %rank%, %mention%, %key%, %value%. Maximale Länge: 500 Zeichen. Standard: **#%rank%** %mention% - %value%.
Text bei leer	Text	Nein	Text, der verwendet wird, wenn das Feld keine Einträge hat. Maximale Länge: 2000 Zeichen.
Zahlen formatieren	Ja/Nein	Ja	Tausendertrennzeichen zu einem numerischen %value% hinzufügen. Standard: Nein.

Ausgaben

Name	Typ	Details
Text	Text	Der gerenderte Rangliste-Text.

Ranglistenseiten formatieren

Erstellt Discord-sichere Ranglistenseiten für „Paginierte Nachricht senden“. Tokens: %rank%, %mention%, %key%, %value%. Personen ohne Zahl in diesem Feld werden ausgelassen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, mit dem gearbeitet werden soll.
Rang nach Feld	Feld eines Strukturwerts	Nein	Bei einem gespeicherten Strukturwert: das Feld mit ganzer Zahl oder Dezimalzahl, nach dem sortiert wird. Jede Zeile zeigt diese Zahl. Maximale Länge: 64 Zeichen.
Richtung	Sortierrichtung	Ja	Sortierrichtung (absteigend listet die höchsten Werte zuerst). Standard: Absteigend.
Limit	Ganzzahl	Ja	Maximale Anzahl an Zeilen (1-100). Wert: 1 bis 100. Standard: 10.
Zeilenvorlage	Text	Ja	Vorlage pro Zeile. Tokens: %rank%, %mention%, %key%, %value%. Maximale Länge: 500 Zeichen. Standard: **#%rank%** %mention% - %value%.
Text bei leer	Text	Nein	Text, wenn das Feld keine Einträge hat. Maximale Länge: 2000 Zeichen.
Zahlen formatieren	Ja/Nein	Ja	Tausendertrennzeichen zu numerischen Werten hinzufügen. Standard: Nein.
Zeilen pro Seite	Ganzzahl	Ja	Maximale Zeilen pro Discord-Seite (1-100); Discords Nachrichtenlimit kann früher umbrechen. Wert: 1 bis 100. Standard: 10.

Ausgaben

Name	Typ	Details
Seiten	Liste von Nachrichteninhalt	Seiten, die direkt mit „Paginierte Nachricht senden“ verbunden werden können.
Seitenanzahl	Ganzzahl	Anzahl der erzeugten Seiten.

Cooldown prüfen und setzen

Prüft, ob ein Subjekt im Cooldown ist, und startet andernfalls einen neuen Cooldown, alles in einem sicheren Schritt. Der sichere Weg, einen Befehl pro Benutzer oder Schlüssel zu begrenzen.

Eingaben

Name	Typ	Pflicht	Details
Speicherfeld	Speicherfeld	Ja	Speicherfeld, das die Cooldown-Zeitstempel hält.
Subjekt	Benutzer	Nein	Benutzer, zu dem der Cooldown gehört (bei benutzerbezogenen Feldern).
Schlüssel	Text	Nein	Schlüssel, unter dem der Cooldown gespeichert wird (bei Schlüsselfeldern). Maximale Länge: 100 Zeichen.
Dauer	Dauer	Ja	Wie lange der Cooldown nach dem Start gilt. Wert: 1000 bis 2592000000.

Ausgaben

Name	Typ	Details
Im Cooldown	Ja/Nein	Wahr, wenn das Subjekt noch im Cooldown war (nichts wurde geändert).
Erneut ab	Dauer	Verbleibende Zeit bis zum Ende des Cooldowns (leer, wenn gerade ein neuer Cooldown gestartet wurde).