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

====== Aliases and Commands (YAML) ======

Aliases let the player navigate or interact by typing a short keyword, without knowing the exact room id or action name.

===== Command in a choice =====

''command:'' in a choice defines the keyword the player can type to take that exit.

<code yaml>
choices:
  - command: north
    button: "⬆️ Go north"
    to: north_forest

  - command: back
    to: home
</code>

Without ''command:'', the room is still reachable via its id (''go north_forest''), but not via a custom shortcut.

===== Global aliases =====

''global_aliases:'' maps a command to a reusable button label available in every room. Useful for recurring buttons (back, inventory, help…).

<code yaml>
global_aliases:
  back: "🏠 Home"
  help: "❓ Help"
</code>

In any room, a choice with ''command: back'' automatically inherits the label ''🏠 Home'' without repeating ''button:'' everywhere:

<code yaml>
choices:
  - command: back
    to: home      # displays "🏠 Home" from global_aliases
</code>

===== Action alias =====

In ''actions:'', ''alias:'' creates a shortcut: the player can type the word alone instead of the full ''verb target'' pair.

<code yaml>
actions:
  - verb: inspect
    target: still
    alias: still
    if: ~
    text_ok: "The still awaits your ingredients."
</code>

The player can type ''still'' instead of ''inspect still''.

===== Global navigation aliases =====

''global_aliases:'' can also point to a room to make it accessible from everywhere:

<code yaml>
global_aliases:
  map: "🗺️ View map"

rooms:
  - id: world_map
    ...
  - id: corridor
    choices:
      - command: map
        to: world_map    # "map" available from every room
</code>

===== See also =====

  * [[en:yaml:choix|Choices and buttons]]
  * [[en:yaml:actions|Custom actions]]
  * [[en:yaml:evenements-globaux|Global events]]

**Join us on [[https://discord.gg/Z63DtVV|Discord Make&Play]]**