Randopolis
Menu

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

  • description sert à identifier le fichier. Le générateur l’ignore.
  • name est 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.
  • game indique le jeu. Vous pouvez pondérer plusieurs jeux. Dans ce cas, ajoutez une section pour chacun d’eux, même vide.
  • quantity indique 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.
  • requires permet 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.

  • accessibility définit les garanties d’accessibilité. full rend tous les emplacements accessibles. Dans les mondes qui le prennent en charge, items garantit l’accès aux objets pertinents pour la logique. minimal garantit la possibilité d’atteindre l’objectif, sans garantir tous les emplacements.
  • progression_balancing aide 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.
  • triggers applique des réglages selon les valeurs obtenues. Voir le guide des déclencheurs.
  • local_items impose le placement de certains objets dans votre monde. non_local_items impose leur placement dans d’autres mondes.
  • start_inventory donne des objets au début de la partie. Indiquez le nom exact de l’objet et sa quantité.
  • start_hints et start_location_hints donnent des indices gratuits sur les objets ou les emplacements listés.
  • exclude_locations empêche de placer des objets utiles ou de progression dans les emplacements listés. priority_locations privilégie les emplacements indiqués pour y placer des objets de progression.
  • item_links partage les objets de item_pool entre 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: {}