Différences

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

--- fr:yaml:alias [2026/05/03 17:01] – Alias et réactions YAML cyrilfiesta
+++ fr:yaml:alias [2026/05/03 18:47] (Version actuelle) – Harmonize FR/EN language switch cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-====== Syntaxe YAML — Alias et réactions ======
+**Language / Langue :** **FR** | [[en:yaml:alias|EN]]
-Les alias permettent d'associer des mots-clés à des salles, et les réactions (émojis) à des actions.
+====== Alias, commandes et boutons (YAML) ======
-===== Alias locaux =====
+Dans le YAML moderne, il n'existe pas de champ ''reaction:'' à ajouter à côté d'un choix ou d'une action. Les boutons affichés par l'interface se déclarent avec ''bouton:'', et les commandes textuelles avec ''commande:'' ou ''alias:'' selon le cas.
-Dans la section ''choix:'', chaque ''commande:'' est automatiquement un alias — le joueur peut taper ''avancer commande'' ou cliquer le bouton.
+===== Choix : commande + bouton =====
-Pour des alias supplémentaires sur un choix :
+Dans ''choix:'', ''commande:'' est l'alias textuel de navigation. ''bouton:'' est le libellé cliquable affiché au joueur.
 <code yaml>
 choix:
   - commande: nord
-    bouton: "⬆️ Aller au nord"
+    bouton: "Aller au nord"
     vers: salle_nord
-    si: "~"
-    alias:
-      - n
-      - haut
 </code>
-===== Réactions (émojis Discord) =====
+Le joueur peut cliquer le bouton ou taper la commande de navigation correspondante.
-Les réactions permettent d'associer un émoji à une action ou navigation :
+===== Choix sans bouton =====
+Un choix avec ''commande:'' mais sans ''bouton:'' reste utilisable au clavier, mais n'affiche pas de bouton local, sauf si la commande hérite d'un ''alias_globaux:''.
 <code yaml>
-# Dans les choix
 choix:
-  - commande: continuer
+  - commande: retour
-    bouton: "➡️ Continuer"
+    vers: accueil
-    vers: suite
+</code>
-    si: "~"
-    reaction: "➡️"
-# Dans les actions
+===== Alias globaux =====
+''alias_globaux:'' associe une commande à un label réutilisable. C'est pratique pour les boutons récurrents.
+<code yaml>
+alias_globaux:
+  retour: "Accueil"
+  aide: "Aide"
+salles:
+  - id: couloir
+    choix:
+      - commande: retour
+        vers: accueil     # affichera le label défini dans alias_globaux
+</code>
+===== Alias d'action =====
+Dans ''actions:'', ''alias:'' crée un raccourci pour déclencher une action sans taper le couple complet ''verbe cible''.
+<code yaml>
 actions:
-  - action: utiliser
+  - verbe: inspecter
-    cible: potion
+    cible: alambic
-    si: "o_potion_o"
+    alias: alambic
-    faire: "pv.+.10"
+    si: ~
-    texte: "+10 PV !"
+    texte_ok: "L'alambic central attend vos ingrédients."
-    reaction: "🧪"
 </code>
-===== Alias globaux =====
+Le joueur peut taper ''alambic'' au lieu de ''inspecter alambic''.
-Définis dans ''evenements_globaux:'' via ''actions_globales:'', ils sont disponibles dans toutes les salles.
+===== Boutons d'action et d'événement =====
+Les actions et les événements peuvent aussi exposer un bouton :
+<code yaml>
+actions:
+  - verbe: utiliser
+    cible: potion
+    bouton: "Boire la potion"
+    si: "potion"
+    faire:
+      - objet: potion
+        vers: inventaire
+        retirer: true
+      - "pv.+.10"
+    texte_ok: "+10 PV !"
+    texte_ko: "Vous n'avez pas de potion."
+evenements:
+  - si: ~
+    bouton: "Méditer"
+    faire: "mana.+.5"
+    texte: "+5 mana."
+</code>
 ===== Voir aussi =====
@@ Ligne 51: / Ligne 88: @@
   * [[fr:yaml:choix|Choix et boutons]]
   * [[fr:yaml:actions|Actions personnalisées]]
+  * [[fr:yaml:evenements-globaux|Alias et événements globaux]]