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_categorydésigne la section qui contient l’option à vérifier. Utilisez le nom du jeu ounullpour la racine.option_namedésigne l’option à vérifier.option_resultindique la valeur qui active le déclencheur. Pour plusieurs valeurs possibles, créez un déclencheur par valeur.optionsindique 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.