**Language / Langue :** **FR** | [[en:yaml:alias|EN]]

====== Alias, commandes et boutons (YAML) ======

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.

===== Choix : commande + bouton =====

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"
    vers: salle_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>

===== 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:
  - verbe: inspecter
    cible: alambic
    alias: alambic
    si: ~
    texte_ok: "L'alambic central attend vos ingrédients."
</code>

Le joueur peut taper ''alambic'' au lieu de ''inspecter alambic''.

===== 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 =====

  * [[fr:yaml:choix|Choix et boutons]]
  * [[fr:yaml:actions|Actions personnalisées]]
  * [[fr:yaml:evenements-globaux|Alias et événements globaux]]