Guide YAML avancé
Ce guide s’adresse aux joueurs qui modifient leurs fichiers YAML à la main. Vous pouvez aussi préparer un fichier depuis les options d’un jeu dans le catalogue. La page d’options permet d’exporter vos réglages ou de télécharger un modèle qui inclut les options absentes du formulaire.
Syntaxe YAML
Indentez chaque niveau de deux espaces et évitez les tabulations dans le fichier. Les noms d’options doivent correspondre à ceux définis par le jeu. Les noms de jeux et d’objets peuvent contenir des espaces et des majuscules. Après une modification, vous pouvez vérifier le fichier.
Quand une option accepte des valeurs pondérées, indiquez un poids pour chaque valeur. Un poids de 0 exclut la valeur. Avec des poids de 14 et de 43, les chances sont respectivement de 14 sur 57 et de 43 sur 57. Un poids plus grand rend donc la valeur plus probable.
Réglages à la racine
descriptionsert à identifier le fichier. Le générateur l’ignore.nameest le nom utilisé pour se connecter. Vous pouvez pondérer plusieurs noms.{player}est remplacé par le numéro du slot et{number}par le numéro d’occurrence du nom. Les variantes{PLAYER}et{NUMBER}restent vides lorsque le numéro vaut 1.gameindique le jeu. Vous pouvez pondérer plusieurs jeux. Dans ce cas, ajoutez une section pour chacun d’eux, même vide.quantityindique combien de fois le fichier doit être utilisé. La valeur par défaut est 1. Pour générer plusieurs slots avec le même fichier, utilisez les variables de nom ci-dessus pour obtenir des noms uniques.requirespermet d’indiquer une version d’Archipelago, des versions de mondes ou les modules de plando nécessaires.
Réglages communs aux jeux
Placez ces options dans la section du jeu.
accessibilitydéfinit les garanties d’accessibilité.fullrend tous les emplacements accessibles. Dans les mondes qui le prennent en charge,itemsgarantit l’accès aux objets pertinents pour la logique.minimalgarantit la possibilité d’atteindre l’objectif, sans garantir tous les emplacements.progression_balancingaide les joueurs qui avancent moins vite. Il va de 0 à 99 et vaut 50 par défaut. Par exemple, si le joueur le plus avancé a accès à 40 % de ses objets, le générateur essaie, avec le réglage par défaut, de donner accès à au moins 20 % des objets à chaque joueur. Ce seuil dépend des possibilités de placement.triggersapplique des réglages selon les valeurs obtenues. Voir le guide des déclencheurs.local_itemsimpose le placement de certains objets dans votre monde.non_local_itemsimpose leur placement dans d’autres mondes.start_inventorydonne des objets au début de la partie. Indiquez le nom exact de l’objet et sa quantité.start_hintsetstart_location_hintsdonnent des indices gratuits sur les objets ou les emplacements listés.exclude_locationsempêche de placer des objets utiles ou de progression dans les emplacements listés.priority_locationsprivilégie les emplacements indiqués pour y placer des objets de progression.item_linkspartage les objets deitem_poolentre les joueurs du même jeu qui utilisent le même nom de groupe. Lorsqu’un objet partagé est trouvé, chaque membre le reçoit. La quantité partagée est limitée à la plus petite quantité disponible chez les membres. Le groupe peut aussi définir des objets locaux ou non locaux.
Le guide du plando explique comment imposer certains placements.
Valeurs numériques aléatoires
random tire une valeur dans l’intervalle autorisé. random-low, random-middle et random-high favorisent respectivement le bas, le milieu et le haut de cet intervalle.
random-range-40-60 limite le tirage aux nombres de 40 à 60. Pour pondérer le tirage dans cet intervalle, utilisez random-range-low-40-60, random-range-middle-40-60 ou random-range-high-40-60. Certaines options de type ensemble utilisent aussi ces valeurs pour choisir combien d’éléments sélectionner.
Exemple
description: Exemple de choix pondéré entre deux jeux
name: Joueur{NUMBER}
game:
A Link to the Past: 10
Timespinner: 10
A Link to the Past:
accessibility: minimal
progression_balancing: random-range-40-60
Timespinner:
accessibility: full
Les deux jeux ont la même probabilité d’être choisis. Les options de la section correspondante s’appliquent ensuite.
Générer plusieurs mondes
Vous pouvez utiliser un fichier par monde ou regrouper plusieurs configurations dans un même fichier en les séparant par une ligne ---. Chaque document YAML possède ses propres clés à la racine.
name: Alice
game: A Link to the Past
A Link to the Past: {}
---
name: Bruno
game: Timespinner
Timespinner: {}