**Language / Langue :** **FR** | [[en:yaml:achievements|EN]]

====== Succès ======

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.

===== Déclaration =====

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

<code yaml>
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
</code>

''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.

===== Débloquer un succès =====

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

<code yaml>
evenements:
  - si: "v_victoire_v = 1"
    faire: "succes:premiere_victoire"

choix:
  - commande: fouiller
    bouton: Fouiller le mur
    vers: passage
    effet: "succes:passage_secret"
</code>

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.

===== Traductions =====

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.

===== Afficher une collection dans un texte =====

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

^ Balise ^ Contenu ^
| ''[[SUCCES]]'' | Tous les succès disponibles |
| ''[[SUCCES-ACQUIS]]'' | Tous les succès déjà obtenus |
| ''[[SUCCES-SCENARIO]]'' | Succès du scénario courant |
| ''[[SUCCES-SCENARIO-ACQUIS]]'' | Succès obtenus dans ce scénario |
| ''[[SUCCES-GLOBAUX]]'' | Succès globaux de JDR-Bot |
| ''[[SUCCES-GLOBAUX-ACQUIS]]'' | Succès globaux déjà obtenus |
| ''[[SUCCES:identifiant]]'' | Un succès précis du scénario |

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

===== Persistance et réinitialisation =====

Les succès ne font pas partie de la sauvegarde d'une partie. Le bouton **Réinitialiser** efface les succès et les [[fr:yaml:variables|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.

===== Dans l'éditeur =====

L'onglet **Succès** de l'[[fr:editeur:explorateur|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 [[fr:editeur:globaux|panneau Globaux]].

===== Standalone et succès 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 [[fr:yaml:export|Export standalone et PDF]].