Randopolis
Menu

Guide des déclencheurs Archipelago

Un déclencheur applique un ou plusieurs réglages lorsqu’une option prend une valeur précise. Il peut se trouver à la racine du fichier YAML ou dans la section du jeu. Placez-les en fin de section pour les retrouver facilement.

Définir un déclencheur

  • option_category désigne la section qui contient l’option à vérifier. Utilisez le nom du jeu ou null pour la racine.
  • option_name désigne l’option à vérifier.
  • option_result indique la valeur qui active le déclencheur. Pour plusieurs valeurs possibles, créez un déclencheur par valeur.
  • options indique les changements à appliquer, classés par section. Un déclencheur peut modifier plusieurs réglages à la fois.
triggers:
  - option_category: A Link to the Past
    option_name: shop_item_slots
    option_result: 15
    options:
      A Link to the Past:
        start_inventory:
          Rupees (300): 2

Dans cet exemple, le joueur commence avec 600 rubis si le nombre d’emplacements de boutique vaut 15. Gardez les noms d’options et d’objets attendus par le jeu dans le YAML.

On peut aussi utiliser des valeurs intermédiaires inventées pour chaîner des conditions. Par exemple, un premier déclencheur choisit entre normal, pupdunk_hard et pupdunk_mystery. Deux autres déclencheurs reconnaissent les valeurs intermédiaires et les remplacent par les difficultés valides hard et mystery, tout en modifiant d’autres options. Veillez à ce que chaque valeur intermédiaire soit remplacée avant la validation finale.

Ajouter ou retirer des éléments

Dans la section options, préfixez le nom d’une option par + pour ajouter des éléments ou par - pour en retirer.

  • Un ensemble ajoute ou retire les valeurs sans doublons.
  • Une liste conserve les doublons. La suppression retire la première occurrence correspondante.
  • Un dictionnaire ajoute les quantités aux clés existantes ou crée les clés manquantes. La soustraction fait l’opération inverse.
Super Metroid:
  start_location:
    landing_site: 50
    aqueduct: 50
  start_hints:
    - Morph Ball
  triggers:
    - option_category: Super Metroid
      option_name: start_location
      option_result: aqueduct
      options:
        Super Metroid:
          +start_hints:
            - Gravity Suit

Si le joueur commence à l’aqueduc, il obtient aussi un indice pour Gravity Suit, en plus de celui de Morph Ball.