Graphe de récompenses

Le graphe de récompenses est un éditeur visuel pour construire des récompenses de niveaux avancées.

Au lieu de simplement attribuer un rôle à un niveau, tu peux construire des chaînes de récompenses avec des déclencheurs, des conditions et des actions.

🧩 Qu’est-ce qu’un graphe de récompenses ?

Un graphe de récompenses est un ensemble de nœuds connectés.

Chaque chaîne suit généralement cette structure :

1. Déclencheur : quand la chaîne de récompenses doit-elle s’exécuter ?
2. Condition : qui a le droit de recevoir la récompense ?
3. Action : que doit faire YAWBDB ?

Exemple :

Quand un membre atteint le niveau 10, s’il n’a pas déjà le rôle Booster, attribuer le rôle Membre actif et envoyer un message de félicitations.

⚡ Nœuds déclencheurs

Les nœuds déclencheurs définissent quand une chaîne démarre.

Exemples :

• Niveau atteint
• Seuil d’XP atteint
• Série atteinte
• Premier message
• Minutes vocales atteintes
• Décroissance XP
• Prestige
• Top XP du jour
• Début d’événement XP

Déclencheurs inter-fonctionnalités (affichés verrouillés dans la palette tant que la fonctionnalité correspondante n’est pas activée) :

• À la victoire d’un giveaway / À la participation à un giveaway : nécessitent la fonctionnalité Tirages au sort. Récompense les membres avec de l’XP, des rôles ou des titres quand ils gagnent un tirage ou y participent.
• À la création d’une suggestion / À l’approbation d’une suggestion : nécessitent la fonctionnalité Suggestions. Accorde de l’XP quand un membre soumet une suggestion ou en fait approuver une.
• Wordle résolu : nécessite la fonctionnalité Jeux avec Wordle activé. Se déclenche quand un membre résout le Wordle du jour, avec deux conditions facultatives directement sur le nœud : résolu en N essais maximum et série Wordle ≥ N. Idéal pour un rôle-badge « résolu en 3 » ou une récompense de série.
• À l’anniversaire : nécessite la fonctionnalité Anniversaires. Se déclenche une fois par an pour chaque membre, juste après l’envoi de l’annonce de son anniversaire. Associe-le à Accorder des XP ou Multiplicateur XP pour un bonus d’anniversaire, ou attribue un rôle ponctuel.
• Formulaire envoyé : nécessite la fonctionnalité Créateur de formulaires. Se déclenche quand un membre envoie n’importe quel formulaire. Accorde de l’XP pour une candidature remplie, ou attribue automatiquement un rôle « candidat ». Ajoute un nœud Cooldown si un formulaire n’a pas de délai d’attente propre.
• Mini-jeu gagné : nécessite la fonctionnalité Jeux. Se déclenche quand un membre gagne au pendu, à pierre-papier-ciseaux ou au quiz, avec l’indication du jeu concerné pour qu’un graphe puisse bifurquer dessus. Note que chaque mini-jeu a déjà son propre réglage XP en cas de victoire : utilise ce déclencheur pour tout ce qui est plus riche que de l’XP.
• A voté sur top.gg - se déclenche la prochaine fois que le membre gagne de l’XP sur ce serveur après avoir voté pour le bot sur top.gg (un message, du temps vocal, une réaction à son message), pas au moment du vote lui-même : top.gg ne dit pas de quel serveur vient un vote, donc le graphe attend que le membre se manifeste réellement ici. Une fois par vote et par serveur ; voter de nouveau le réarme. Indépendant du multiplicateur d’XP distinct Bonus de vote top.gg. Récompense-le avec un rôle, un message ou de l’XP bonus.

Ils te permettent de transformer l’engagement (participer à des tirages, publier des suggestions) en XP. Ajoute un nœud Cooldown pour éviter le farm.

❓ Nœuds de condition

Les nœuds de condition décident si la chaîne doit continuer.

Exemples :

• Le membre a un rôle
• Le membre n’a pas un rôle
• Plage de niveaux
• Plage d’XP
• Série minimale
• Est booster du serveur
• Ancienneté du compte
• Ancienneté sur le serveur
• Jour de la semaine
• Fenêtre horaire
• Prestige requis

Les conditions t’évitent de donner des récompenses aux mauvais membres ou de déclencher des actions au mauvais moment.

🎬 Nœuds d’action

Les nœuds d’action définissent ce qui se passe quand la chaîne réussit.

Exemples :

• Attribuer un rôle
• Retirer un rôle
• Échanger les rôles
• Envoyer un message privé
• Envoyer un message dans un salon
• Accorder de l’XP
• Déclencher le prestige
• Définir un multiplicateur personnel
• Attribuer un titre
• Épingler un message

✏️ Variables à mettre dans un message

Toute action qui écrit du texte (Envoyer un DM, Publier dans un salon) accepte ces espaces réservés. Ils sont remplacés par les vraies valeurs du membre au moment de l’envoi du message.

Après une action Déclencher le prestige, {prestige} dans les messages suivants affiche le rang que le membre vient d’atteindre, pas celui qu’il a quitté.

Un espace réservé mal orthographié est affiché tel quel : si un message montre {presige} à tes membres, vérifie d’abord l’orthographe.

✨ Laisse l’assistante le construire

Si décrire ce que tu veux est plus facile que de tout câbler, l’assistante de graphes propose un graphe à partir d’une phrase. Elle n’applique jamais rien toute seule : tu relis la proposition et tu décides.

ℹ️ Le bouton (i) sur chaque carte

Chaque carte de l’éditeur porte un petit (i) dans son coin supérieur droit. Il ouvre un panneau qui répond aux trois questions que la carte elle-même ne peut pas te montrer.

Ce que cette carte lit. Les valeurs qu’elle regarde : le niveau du membre, ses rôles, depuis combien de temps il est sur le serveur, etc. Sur un graphe de commande, certaines apparaissent barrées : une commande ne les transporte pas, donc une carte qui en dépend ne peut jamais se déclencher là. Le déclencheur Seuil XP est le cas le plus net, car il a besoin de connaître l’XP que le membre avait avant l’événement, et une commande n’a pas de « avant ».

Ce qui la ferait ne rien faire. C’est la partie qui mérite d’être lue. Plusieurs cartes sont ignorées en silence quand un champ obligatoire est laissé vide : un Attribuer un rôle sans rôle choisi, un Envoyer un message avec un message vide. Rien n’est journalisé et rien n’est signalé ; le graphe s’exécute simplement sans cette carte. Le panneau nomme le champ exact qui en serait la cause.

Deux conditions échouent dans le sens inverse, et le panneau le dit aussi : A le rôle sans rôle sélectionné ne passe jamais, donc tout ce qui suit est inaccessible. N’a pas le rôle sans rôle sélectionné passe toujours, donc il ne filtre rien du tout.

Quelles variables fonctionnent ici. Sur les cartes qui écrivent du texte, le panneau liste les espaces réservés valides sur cette carte, pour que tu n’aies jamais à deviner ni à revenir sur cette page.

Les cartes ne se passent pas de valeurs entre elles. Tout ce qu’une carte lit vient de l’événement qui a démarré le graphe, et se lit de la même façon dans toutes les cartes de ce graphe, la première comme la dernière. C’est pourquoi une carte peut utiliser {user} même quand elle est câblée directement au déclencheur, et pourquoi il n’y a aucun moyen de faire calculer quelque chose par une carte pour que la suivante l’utilise.

Le bouton (i) fait partie de l’éditeur complet, il apparaît donc sur ordinateur. Le résumé mobile reste une vue d’ensemble en lecture seule.

🧠 Nœuds de logique

Les graphes avancés peuvent utiliser des nœuds de logique pour contrôler le flux.

⚠️ ET, OU et NON se lisent à l’envers. Ils jugent les cartes câblées en entrée, pas celles qui viennent après. C’est le seul endroit de l’éditeur où les flèches ne veulent pas dire « puis » : elles veulent dire « fait partie de ce qui est testé ». Câble tes conditions vers la porte, et câble la porte vers la récompense.

Une porte sans rien câblé en entrée n’a rien à tester : ET et NON laissent tout passer, OU bloque tout. Aucune n’affiche d’erreur : une condition débranchée par accident devient donc une récompense qui se déclenche pour tout le monde, ou pour personne.

Ces nœuds t’aident à construire des systèmes de récompenses plus complexes tout en gardant tout visuel.

📱 Comportement sur mobile

L’éditeur visuel s’utilise de préférence sur ordinateur.

Sur les petits écrans, le panel peut proposer une vue simplifiée ou en lecture seule selon la mise en page.

Pour les modifications importantes du graphe de récompenses, utilise un navigateur sur ordinateur.

💡 Bonnes pratiques

🌱 Commence petit

Crée d’abord une récompense simple, puis teste-la.

Par exemple :

• Déclencheur : niveau 5 atteint
• Action : attribuer le rôle Membre+

Une fois que ça marche, ajoute des conditions et des actions supplémentaires.

🏷️ Utilise des noms de nœuds clairs

Garde ton graphe lisible. Si tu construis beaucoup de chaînes, utilise des commentaires ou des étiquettes quand ils sont disponibles.

📈 Évite les récompenses en double

Utilise des conditions comme « n’a pas le rôle » pour éviter d’attribuer plusieurs fois la même récompense.

⏱️ Utilise les cooldowns avec prudence

Les cooldowns sont utiles pour empêcher le spam, mais de longs cooldowns peuvent rendre les tests confus.

📈 Teste d’abord avec une récompense de bas niveau

Avant de construire une chaîne de récompenses complexe au niveau 50, teste la même structure à un niveau bas.

💡 Idées de récompenses

• Attribuer un rôle au niveau 10
• Retirer l’ancien rôle et en attribuer un nouveau au niveau 25
• Envoyer un message privé quand un membre atteint un palier de série
• Donner un multiplicateur d’XP temporaire aux participants actifs d’un événement
• Annoncer le début d’un événement XP double
• Donner un titre spécial après un prestige
• Attribuer un rôle de champion du jour au meilleur gagnant d’XP

Le graphe de récompenses est l’une des parties les plus puissantes du système de niveaux de YAWBDB. Il te permet de concevoir des règles de progression adaptées à ta communauté au lieu de t’imposer une structure de récompenses figée.