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 23:59] (Version actuelle) – mise a jour wiki 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 et commandes (YAML) ======
-===== Alias locaux =====
+Les alias permettent au joueur de naviguer ou d'interagir en tapant un mot court, sans connaître l'identifiant exact d'une salle ou d'une action.
-Dans la section ''choix:'', chaque ''commande:'' est automatiquement un alias — le joueur peut taper ''avancer commande'' ou cliquer le bouton.
+===== Commande dans un choix =====
-Pour des alias supplémentaires sur un choix :
+''commande:'' dans un choix définit le mot-clé que le joueur peut taper pour emprunter cette sortie.
 <code yaml>
@@ Ligne 13: / Ligne 13: @@
   - commande: nord
     bouton: "⬆️ Aller au nord"
-    vers: salle_nord
+    vers: foret_nord
-    si: "~"
-    alias:
+  - commande: retour
-      - n
+    vers: accueil
-      - haut
 </code>
-===== Réactions (émojis Discord) =====
+Sans ''commande:'', la salle reste accessible via son identifiant (''avancer foret_nord''), mais pas via un raccourci personnalisé.
-Les réactions permettent d'associer un émoji à une action ou navigation :
+===== Alias globaux =====
+''alias_globaux:'' associe une commande à un label de bouton réutilisable dans toutes les salles. Pratique pour les boutons récurrents (retour, inventaire, aide…).
+<code yaml>
+alias_globaux:
+  retour: "🏠 Accueil"
+  aide: "❓ Aide"
+</code>
+Dans n'importe quelle salle, un choix avec ''commande: retour'' hérite automatiquement du label ''🏠 Accueil'' sans avoir à répéter ''bouton:'' partout :
 <code yaml>
-# Dans les choix
 choix:
-  - commande: continuer
+  - commande: retour
-    bouton: "➡️ Continuer"
+    vers: accueil      # affichera "🏠 Accueil" grâce à alias_globaux
-    vers: suite
+</code>
-    si: "~"
-    reaction: "➡️"
-# Dans les actions
+===== Alias d'action =====
+Dans ''actions:'', ''alias:'' crée un raccourci : le joueur peut taper le mot seul au lieu du couple ''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'' plutôt que ''inspecter alambic''.
-Définis dans ''evenements_globaux:'' via ''actions_globales:'', ils sont disponibles dans toutes les salles.
+===== Alias globaux de navigation =====
+''alias_globaux:'' peut aussi pointer directement vers une salle pour y donner accès depuis partout :
+<code yaml>
+alias_globaux:
+  carte: "🗺️ Voir la carte"
+salles:
+  - id: carte_monde
+    ...
+  - id: couloir
+    choix:
+      - commande: carte
+        vers: carte_monde    # "carte" disponible dans toutes les salles
+</code>
 ===== Voir aussi =====
@@ Ligne 51: / Ligne 75: @@
   * [[fr:yaml:choix|Choix et boutons]]
   * [[fr:yaml:actions|Actions personnalisées]]
+  * [[fr:yaml:evenements-globaux|Événements globaux]]
+**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**