Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:yaml:variables [2026/09/26 03:42] – documentation 4.15 : succès, variables persistantes et exports cyrilfiesta
+++ fr:yaml:variables [2026/10/20 22:19] (Version actuelle) – Mod?les sur_place, port?e des encadr?s et objets 4.17 cyrilfiesta
@@ Ligne 62: / Ligne 62: @@
 ===== Variables online _o =====
-Une variable ''_o'' est enregistrée sur le serveur et partagée entre les joueurs qui chargent la même source. Elle est liée à l'URL ou au chemin du scénario, pas à son ''id:''.
+Pour une source de scénario autorisée par le serveur, une variable ''_o'' est partagée entre les joueurs. Elle est liée à l'URL ou au chemin du scénario, pas à son ''id:''. Hors de ces sources, elle reste locale à la partie.
 <code yaml>
@@ Ligne 90: / Ligne 90: @@
 ===== Réponse libre =====
-Ajoutez ''repondre: true'' à une variable déclarée dans la salle pour attendre une saisie libre :
+Dans le ''init:'' d'une salle, ''repondre: true'' autorise le joueur à saisir une valeur :
 <code yaml>
-vars_texte:
+init:
-  nomjoueur:
+  - var_texte: nomjoueur
     valeur: "Aventurier"
     repondre: true
@@ Ligne 119: / Ligne 119: @@
 | ''v_nom_timer_v'' | Secondes restantes du timer ''nom'' |
-''v_tour_v|pad2'' ajoute des zéros devant un nombre : 7 devient 07.
+Pour une variable ''tour'' déclarée dans le scénario, ''v_tour_v|pad2'' affiche 7 sous la forme 07.
 ===== Piège classique =====
@@ Ligne 131: / Ligne 131: @@
     texte: "Nouveau record : v_score_v"
 </code>
+===== Chemins et écritures espacées (4.17) =====
+Les [[fr:yaml:listes-boucles|listes et collections]] ajoutent des chemins comme ''heros.vie'', ''sac[0]'' ou ''groupe[v_position_v].vie''. Les marqueurs restent ''v_..._v'' et ''t_..._t''.
+Dans ''faire:'', ''vie + 10'' est l'équivalent de ''vie.+.10''. Opérateurs : ''<nowiki>= + - * / // ** %%</nowiki>'' et tirage ''%''. ''/'' arrondit au pair en cas d'égalité, ''//'' tronque vers zéro et ''<nowiki>%%</nowiki>'' donne le modulo. La division par zéro est une erreur.
+<code yaml>
+faire:
+  - heros.vie + 10
+  - score + %1:6
+  - score + %2:70,5:30
+</code>
+Le dernier exemple tire 2 avec un poids de 70 ou 5 avec un poids de 30. ''resultat'' contient le nombre tiré avant l'application de l'opérateur. Les anciennes formes restent acceptées.
+''init:'' accepte aussi ''var: heros.vie'' ou ''var_texte: heros.nom'', avec ''modifiable: true'' ou ''repondre: true''. Le chemin doit traverser uniquement des collections et viser une propriété simple existante ; les indices de liste sont exclus de ces saisies.
+===== Décrire les données structurées =====
+Les listes, collections, propriétés et éléments peuvent recevoir une description séparée de leur valeur dans ''infos_donnees:'' (anglais : ''data_info:''). ''examiner heros.vie'' affiche la valeur et sa description. Les racines peuvent aussi être liées à des tags pour réinitialiser l'ensemble de leur contenu. Voir [[fr:yaml:listes-boucles|Descriptions et tags des données structurées]].
+Dans l'éditeur, les variables online restent rangées avec les nombres ou les textes selon leur type. Un nombre ''_o'' se déclare dans ''vars'', un texte ''_o'' dans ''vars_texte''. Les anciennes déclarations ''vars_online'' restent lisibles à l'import.