Un scénario peut proposer ses propres succès. Ils sont conservés sur l'appareil du joueur, indépendamment de la sauvegarde de la partie : une fin, un abandon ou une nouvelle partie ne les effacent pas.

Le bouton trophée ouvre la collection sans quitter la partie. Les succès obtenus et ceux qui restent à débloquer sont séparés. Un succès secret apparaît sous le nom « Succès caché » tant qu'il n'a pas été obtenu.

Un scénario qui utilise des succès doit avoir un id: stable :

id: mon-scenario

succes:
  premiere_victoire:
    titre: Première victoire
    description: Terminer le scénario avec une victoire.
    points: 20
    icone: 🏆

  passage_secret:
    titre: Derrière le mur
    description: Découvrir le passage caché.
    points: 40
    icone: images/succes/passage.png
    secret: true

titre, description et points sont obligatoires. icone et secret sont facultatifs. Sans icône, JDR-Bot affiche un trophée. L'icône peut être un emoji, un court texte ou le chemin d'une image.

L'identifiant du succès, comme premiere_victoire, est ce qui est enregistré chez le joueur. Ne le changez pas après publication. Le titre et la description peuvent en revanche être réécrits.

Utilisez l'action succes:identifiant dans un événement, une action personnalisée ou l'effet d'un choix :

evenements:
  - si: "v_victoire_v = 1"
    faire: "succes:premiere_victoire"

choix:
  - commande: fouiller
    bouton: Fouiller le mur
    vers: passage
    effet: "succes:passage_secret"

Un succès déjà obtenu n'est jamais ajouté deux fois et sa notification ne réapparaît pas. Il est donc possible de tenter son déblocage à chaque passage sans ajouter de condition spéciale.

Le linter avertit lorsqu'un succès déclaré n'est débloqué nulle part dans le scénario.

Les versions française et anglaise d'un même scénario peuvent partager leur progression. Elles doivent utiliser le même id: de scénario et les mêmes identifiants de succès. Seuls les titres et les descriptions ont besoin d'être traduits.

Les points peuvent être différents d'une langue à l'autre. Dans ce cas, le score utilise la valeur de la langue actuellement sélectionnée, sans compter le succès deux fois.

Ces balises fonctionnent dans le texte d'une salle et dans un HUD :

Ajoutez -ICONE à la fin du nom pour afficher les icônes, par exemple SUCCES-SCENARIO-ICONE ou premiere_victoire.

Les succès ne font pas partie de la sauvegarde d'une partie. Le bouton Réinitialiser efface les succès et les variables persistantes ''_p'' du scénario courant, puis lance immédiatement une nouvelle partie. Les succès globaux ne sont pas effacés.

Sur Web, Android et dans un standalone, les données sont conservées dans le stockage local du navigateur. Desktop utilise son stockage local. Discord garde seulement les succès de la partie en cours.

L'onglet Succès de l'Explorateur permet de créer et modifier les succès. Le constructeur d'actions propose ensuite Débloquer un succès avec la liste de leurs identifiants.

Si le scénario n'a pas encore d'ID, l'éditeur propose de le renseigner au moment d'ajouter le premier succès. Il reste également modifiable sous le titre dans le panneau Globaux.

Les succès du scénario sont toujours inclus dans son export standalone. Les succès globaux de JDR-Bot sont exclus par défaut. L'option Inclure les succès globaux compatibles permet d'ajouter uniquement ceux qui peuvent être obtenus dans un jeu autonome.

Voir aussi Export standalone et PDF.