Belohnungsgraph

Der Belohnungsgraph ist ein visueller Editor, um fortgeschrittene Leveling-Belohnungen zu bauen.

Statt nur bei einem Level eine Rolle zu vergeben, kannst du Belohnungsketten aus Auslösern, Bedingungen und Aktionen aufbauen.

🧩 Was ist ein Belohnungsgraph?

Ein Belohnungsgraph ist eine Menge verbundener Knoten.

Jede Kette folgt normalerweise dieser Struktur:

1. Auslöser: Wann soll die Belohnungskette laufen?
2. Bedingung: Wer darf die Belohnung erhalten?
3. Aktion: Was soll YAWBDB tun?

Beispiel:

Erreicht ein Mitglied Level 10 und hat es die Booster-Rolle noch nicht, weise die Rolle Active Member zu und sende eine Glückwunschnachricht.

⚡ Auslöser-Knoten

Auslöser-Knoten legen fest, wann eine Kette startet.

Beispiele sind:

• Level erreicht
• XP-Schwelle erreicht
• Serie erreicht
• Erste Nachricht
• Sprachminuten erreicht
• XP-Verfall
• Prestige
• Tages-Top-XP
• Start eines XP-Events

Funktionsübergreifende Auslöser (in der Palette gesperrt angezeigt, bis die passende Funktion aktiviert ist):

• Bei Gewinnspiel-Sieg / Bei Gewinnspiel-Teilnahme: setzen die Funktion Gewinnspiele voraus. Belohne Mitglieder mit XP, Rollen oder Titeln, wenn sie ein Gewinnspiel gewinnen oder daran teilnehmen.
• Bei Vorschlagserstellung / Bei Vorschlagsannahme: setzen die Funktion Vorschläge voraus. Vergib XP, wenn ein Mitglied einen Vorschlag einreicht oder einer angenommen wird.
• Wordle gelöst: setzt die Funktion Spiele mit aktiviertem Wordle voraus. Wird ausgelöst, wenn ein Mitglied das tägliche Wordle löst, mit zwei optionalen Bedingungen direkt am Knoten: in höchstens N Versuchen gelöst und Wordle-Serie ≥ N. Ideal für eine Abzeichen-Rolle „in 3 gelöst“ oder eine Serien-Belohnung.
• Am Geburtstag: setzt die Funktion Geburtstage voraus. Wird einmal im Jahr pro Mitglied ausgelöst, direkt nachdem die Geburtstagsankündigung gesendet wurde. Kombiniere ihn mit XP vergeben oder XP-Multiplikator für einen Geburtstagsbonus oder vergib eine einmalige Rolle.
• Formular abgeschickt: setzt die Funktion Formular-Builder voraus. Wird ausgelöst, wenn ein Mitglied ein beliebiges Formular abschickt. Vergib XP fürs Ausfüllen einer Bewerbung oder verteile automatisch eine Rolle „Kandidat“. Füge einen Cooldown-Knoten hinzu, wenn ein Formular keine eigene Wartezeit hat.
• Minispiel gewonnen: setzt die Funktion Spiele voraus. Wird ausgelöst, wenn ein Mitglied Galgenmännchen, Schere, Stein, Papier oder Quiz gewinnt, und enthält, welches Spiel es war, sodass ein Graph danach verzweigen kann. Beachte, dass jedes Minispiel bereits eine eigene Einstellung XP bei Sieg hat: Nutze diesen Auslöser für alles, was über XP hinausgeht.
• Auf top.gg abgestimmt - wird beim nächsten Mal ausgelöst, wenn das Mitglied auf diesem Server XP verdient, nachdem es auf top.gg für den Bot abgestimmt hat (eine Nachricht, Sprachzeit, eine Reaktion auf seine Nachricht), nicht im Moment der Stimme selbst - top.gg sagt nicht, von welchem Server eine Stimme kam, daher wartet der Graph, bis das Mitglied tatsächlich hier auftaucht. Einmal pro Stimme und pro Server; erneutes Abstimmen schaltet ihn wieder scharf. Unabhängig vom separaten XP-Multiplikator Top.gg-Vote-Bonus. Belohne damit eine Rolle, eine Nachricht oder Bonus-XP.

So kannst du Engagement (an Gewinnspielen teilnehmen, Vorschläge posten) in XP umwandeln. Füge einen Cooldown-Knoten hinzu, um Farming zu verhindern.

❓ Bedingungs-Knoten

Bedingungs-Knoten entscheiden, ob die Kette fortgesetzt werden soll.

Beispiele sind:

• Mitglied hat eine Rolle
• Mitglied hat eine Rolle nicht
• Level-Bereich
• XP-Bereich
• Mindest-Serie
• Ist Server-Booster
• Kontoalter
• Server-Alter
• Wochentag
• Zeitfenster
• Prestige-Voraussetzung

Bedingungen helfen dir, Belohnungen nicht an die falschen Mitglieder zu vergeben oder Aktionen zur falschen Zeit auszulösen.

🎬 Aktions-Knoten

Aktions-Knoten legen fest, was passiert, wenn die Kette erfolgreich ist.

Beispiele sind:

• Rolle zuweisen
• Rolle entfernen
• Rollen tauschen
• Eine Direktnachricht senden
• Eine Nachricht in einen Kanal senden
• XP vergeben
• Prestige auslösen
• Einen persönlichen Multiplikator setzen
• Einen Titel zuweisen
• Eine Nachricht anheften

✏️ Variablen, die du in eine Nachricht einfügen kannst

Jede Aktion, die Text schreibt, also Eine Direktnachricht senden und Eine Nachricht in einen Kanal senden, akzeptiert diese Platzhalter. Sie werden in dem Moment, in dem die Nachricht gesendet wird, durch die echten Werte des Mitglieds ersetzt.

Nach einer Aktion Prestige auslösen zeigt {prestige} in den folgenden Nachrichten den Rang, den das Mitglied gerade erreicht hat, nicht den, den es verlassen hat.

Ein falsch geschriebener Platzhalter wird unverändert ausgegeben. Wenn eine Nachricht bei deinen Mitgliedern also {presige} zeigt, prüfe zuerst die Schreibweise.

✨ Lass den Assistenten es bauen

Wenn es einfacher ist zu beschreiben, was du willst, als es zu verdrahten, schlägt der Graph-Assistent aus einem Satz einen Graphen vor. Er wendet nie von sich aus etwas an: Du prüfst den Vorschlag und entscheidest.

ℹ️ Die Schaltfläche (i) auf jeder Karte

Jede Karte im Editor trägt oben rechts ein kleines (i). Es öffnet ein Panel, das die drei Fragen beantwortet, die die Karte selbst dir nicht zeigen kann.

Was diese Karte liest. Die Werte, die sie betrachtet: das Level des Mitglieds, seine Rollen, wie lange es schon auf dem Server ist und so weiter. In einem Befehls-Graphen erscheinen einige davon durchgestrichen: Ein Befehl liefert sie nicht mit, daher kann eine Karte, die von einem davon abhängt, dort nie ausgelöst werden. Der Auslöser XP-Schwellenwert ist der deutlichste Fall, denn er muss wissen, wie viele XP das Mitglied vor dem Ereignis hatte, und ein Befehl hat kein „Vorher“.

Was dazu führen würde, dass sie nichts tut. Das ist der Teil, den man lesen sollte. Mehrere Karten werden stillschweigend übersprungen, wenn ein erforderliches Feld leer bleibt: eine Aktion Rolle zuweisen ohne gewählte Rolle, ein Nachricht senden mit leerer Nachricht. Nichts wird protokolliert und nichts markiert; der Graph läuft einfach ohne diese Karte. Das Panel nennt das genaue Feld, das dies verursachen würde.

Zwei Bedingungen scheitern in die entgegengesetzte Richtung, und das Panel sagt das ebenfalls: Hat Rolle ohne gewählte Rolle trifft nie zu, sodass alles danach unerreichbar ist. Keine Rolle ohne gewählte Rolle trifft immer zu und filtert daher gar nichts.

Welche Variablen hier funktionieren. Bei den Karten, die Text schreiben, listet das Panel die Platzhalter auf, die auf dieser Karte gültig sind, sodass du nie raten oder auf diese Seite zurückkommen musst.

Karten geben einander keine Werte weiter. Alles, was eine Karte liest, stammt aus dem Ereignis, das den Graphen gestartet hat, und liest sich in jeder Karte dieses Graphen gleich, in der ersten wie in der letzten. Deshalb kann eine Karte {user} verwenden, selbst wenn sie direkt mit dem Auslöser verbunden ist, und deshalb gibt es keine Möglichkeit, dass eine Karte etwas berechnet, das die nächste verwenden soll.

Die Schaltfläche (i) gehört zum vollständigen Editor, erscheint also auf dem Desktop. Die mobile Zusammenfassung bleibt eine reine Leseübersicht.

🧠 Logik-Knoten

Fortgeschrittene Graphen können Logik-Knoten nutzen, um den Ablauf zu steuern.

⚠️ AND, OR und NOT lesen sich rückwärts. Sie beurteilen die Karten, die in sie hineinführen, nicht die, die danach kommen. Das ist die einzige Stelle im Editor, an der die Pfeile nicht „dann“ bedeuten: Sie bedeuten „ist eines der Dinge, die getestet werden“. Verdrahte deine Bedingungen in das Gate hinein und das Gate heraus zur Belohnung.

Ein Gate, in das nichts hineinführt, hat nichts zu testen: AND und NOT lassen alles durch, OR blockiert alles. Beides zeigt keinen Fehler an, sodass eine versehentlich getrennte Bedingung zu einer Belohnung wird, die für alle ausgelöst wird, oder für niemanden.

Mit diesen Knoten baust du komplexere Belohnungssysteme und behältst dabei alles visuell.

📱 Verhalten auf dem Smartphone

Der visuelle Editor lässt sich am besten auf dem Desktop nutzen.

Auf kleineren Bildschirmen bietet das Panel je nach Layout möglicherweise eine vereinfachte oder schreibgeschützte Ansicht.

Für größere Änderungen am Belohnungsgraphen nutze einen Desktop-Browser.

💡 Best Practices

🌱 Fange klein an

Erstelle zuerst eine einfache Belohnung und teste sie.

Zum Beispiel:

• Auslöser: Level 5 erreicht
• Aktion: Rolle Member+ zuweisen

Sobald das funktioniert, füge Bedingungen und weitere Aktionen hinzu.

🏷️ Verwende klare Knotennamen

Halte deinen Graphen lesbar. Wenn du viele Ketten baust, nutze Kommentare oder Bezeichnungen, wo verfügbar.

📈 Vermeide doppelte Belohnungen

Nutze Bedingungen wie „hat die Rolle nicht“, um zu vermeiden, dass dieselbe Belohnung wiederholt vergeben wird.

⏱️ Setze Cooldowns mit Bedacht ein

Cooldowns sind nützlich gegen Spam, aber lange Cooldowns können das Testen verwirrend machen.

📈 Teste zuerst mit einer Belohnung für ein niedriges Level

Bevor du eine komplexe Belohnungskette für Level 50 baust, teste dieselbe Struktur auf einem niedrigen Level.

💡 Beispiele für Belohnungsideen

• Bei Level 10 eine Rolle zuweisen
• Bei Level 25 die alte Rolle entfernen und eine neue zuweisen
• Eine DM senden, wenn ein Mitglied einen Meilenstein bei der Serie erreicht
• Aktiven Teilnehmern eines Events einen temporären XP-Multiplikator geben
• Ankündigen, wenn ein Doppel-XP-Event startet
• Nach Prestige einen besonderen Titel vergeben
• Dem Top-XP-Verdiener des Tages eine Rolle als Tagesmeister zuweisen

Der Belohnungsgraph ist einer der mächtigsten Teile des Leveling-Systems von YAWBDB. Er lässt dich Fortschrittsregeln entwerfen, die zu deiner Community passen, statt dich in eine feste Belohnungsstruktur zu zwingen.