Différences

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

--- fr:yaml:alias [2026/05/03 18:07] – Correction syntaxe JDR-Bot depuis moteur et showcase.yaml cyrilfiesta
+++ fr:yaml:alias [2026/05/03 23:59] (Version actuelle) – mise a jour wiki cyrilfiesta
@@ Ligne 1: / Ligne 1: @@
-====== Alias, commandes et boutons (YAML) ======
+**Language / Langue :** **FR** | [[en:yaml:alias|EN]]
-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.
+====== Alias et commandes (YAML) ======
-===== Choix : commande + bouton =====
+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 ''choix:'', ''commande:'' est l'alias textuel de navigation. ''bouton:'' est le libell? cliquable affich? au joueur.
+===== Commande dans un choix =====
+''commande:'' dans un choix définit le mot-clé que le joueur peut taper pour emprunter cette sortie.
 <code yaml>
 choix:
   - commande: nord
-    bouton: "?? Aller au nord"
+    bouton: "⬆️ Aller au nord"
-    vers: salle_nord
+    vers: foret_nord
-</code>
-Le joueur peut cliquer le bouton ou taper la commande de navigation correspondante.
-===== 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>
-choix:
   - commande: retour
     vers: accueil
 </code>
+Sans ''commande:'', la salle reste accessible via son identifiant (''avancer foret_nord''), mais pas via un raccourci personnalisé.
 ===== Alias globaux =====
-''alias_globaux:'' associe une commande ? un label r?utilisable. C'est pratique pour les boutons r?currents.
+''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"
+  retour: "🏠 Accueil"
-  aide: "? Aide"
+  aide: "❓ Aide"
+</code>
-salles:
+Dans n'importe quelle salle, un choix avec ''commande: retour'' hérite automatiquement du label ''🏠 Accueil'' sans avoir à répéter ''bouton:'' partout :
-  - id: couloir
-    choix:
+<code yaml>
-      - commande: retour
+choix:
-        vers: accueil     # affichera ?? Accueil
+  - commande: retour
+    vers: accueil      # affichera "🏠 Accueil" grâce à 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''.
+Dans ''actions:'', ''alias:'' crée un raccourci : le joueur peut taper le mot seul au lieu du couple ''verbe cible''.
 <code yaml>
@@ Ligne 52: / Ligne 49: @@
     alias: alambic
     si: ~
-    texte_ok: "L'alambic central attend vos ingr?dients."
+    texte_ok: "L'alambic central attend vos ingrédients."
 </code>
-Le joueur peut taper ''alambic'' au lieu de ''inspecter alambic''.
+Le joueur peut taper ''alambic'' plutôt que ''inspecter alambic''.
-===== Boutons d'action et d'?v?nement =====
+===== Alias globaux de navigation =====
-Les actions et les ?v?nements peuvent aussi exposer un bouton :
+''alias_globaux:'' peut aussi pointer directement vers une salle pour y donner accès depuis partout :
 <code yaml>
-actions:
+alias_globaux:
-  - verbe: utiliser
+  carte: "🗺️ Voir la carte"
-    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:
+salles:
-  - si: ~
+  - id: carte_monde
-    bouton: "? M?diter"
+    ...
-    faire: "mana.+.5"
+  - id: couloir
-    texte: "+5 mana."
+    choix:
+      - commande: carte
+        vers: carte_monde    # "carte" disponible dans toutes les salles
 </code>
@@ Ligne 85: / Ligne 74: @@
   * [[fr:yaml:choix|Choix et boutons]]
-  * [[fr:yaml:actions|Actions personnalis?es]]
+  * [[fr:yaml:actions|Actions personnalisées]]
-  * [[fr:yaml:evenements-globaux|Alias et ?v?nements globaux]]
+  * [[fr:yaml:evenements-globaux|Événements globaux]]
+**Retrouvez nous sur le [[https://discord.gg/Z63DtVV|discord Make&Play]]**