OpenBotsDocs
03 Dashboard04 Fonctionnalites

Succès

Badges débloqués automatiquement selon des règles définies par le serveur.

🏆 Succès

Le module Succès affiche des badges que les membres débloquent automatiquement en respectant des conditions définies par le staff — pas de catalogue figé, tout se configure depuis le dashboard.


🧩 Comment ça marche

  • Les succès sont des règles de récompense (moteur Récompenses & Malus, partagé avec le module RPG) dont la cible est spécifiquement achievement. Une règle définit un déclencheur (mot-clé, majuscules, longueur de message, invitations, mentions, pièce jointe, etc.) et, si source vaut achievement, débloque un badge (code, libellé, emoji, description) plutôt qu'une récompense en monnaie ou en XP.
  • Le déblocage est idempotent : un même succès ne peut être débloqué qu'une fois par membre.
  • /succes affiche tes propres succès débloqués (et ceux restant à obtenir) ; /succes membre:<@quelqu'un> affiche ceux d'un autre membre.

🔔 Annonce du déblocage

  • Si achievements_announce est activé, le déblocage est annoncé dans un salon dédié (achievements_channel_id) — sinon dans le salon où le membre vient de monter de niveau.
  • achievements_dm envoie en plus un message privé au membre concerné.
  • Une réaction peut être ajoutée automatiquement au message de déblocage.
  • Log staff dédié : journalise chaque déblocage dans un salon staff, en plus de l'annonce publique.

🕵️ Succès secrets et paliers

  • Un succès marqué secret ne s'affiche pas dans la liste tant qu'il n'est pas débloqué — son déblocage déclenche une alerte dédiée, pour mettre en avant les succès les plus rares.
  • Annonce « premier du serveur » : met en avant le tout premier membre à débloquer un succès donné.
  • Rôle collectionneur : attribue automatiquement un rôle à un membre qui atteint un certain nombre total de succès débloqués.
  • Annonce complétionniste : célèbre le membre qui débloque tous les succès disponibles sur le serveur.

⚙️ Configuration

Le catalogue de succès se définit depuis le dashboard, dans l'onglet RPG → Récompenses & Malus, en créant une règle dont l'effet cible « succès » plutôt qu'une récompense classique. C'est le même moteur qui gère les bonus/ malus d'XP et de monnaie du serveur, donc les succès peuvent se combiner à n'importe quel déclencheur déjà disponible (mot-clé précis, comportement dans le chat, invitations envoyées, etc.).

On this page