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

====== Variables (YAML) ======

===== Numeric Variables =====

<code yaml>
vars:
  score: 0

  hp:
    value: 10
    description: "Health points"
</code>

The description is shown when the player examines the variable or when it is attached to a permanent option.

===== Text Variables =====

<code yaml>
text_vars:
  hero_name:
    value: "Adventurer"
    description: "Hero name"
</code>

Use text variables in text with ''t_hero_name_t''.

===== Online Variables =====

<code yaml>
online_vars:
  record_o:
    value: 0
    description: "Best score"
</code>

The name must end with ''_o''. Use it like any numeric variable: ''v_record_o_v''.

The variable ''nb_parties_o'' exists automatically and is incremented when a game starts.

===== Room init: =====

<code yaml>
init:
  - var: die
    value: "%=1:6"
    description: "Die roll result"
  - text_var: state
    value: "resting"
    description: "Current state"
</code>

===== Value Modifiers =====

^ Syntax ^ Effect ^
| ''0'' | Set to 0. |
| ''"+1"'' | Add 1. |
| ''"-3"'' | Subtract 3. |
| ''"%=1:6"'' | Random from 1 to 6. |
| ''"%+1:3"'' | Add random from 1 to 3. |
| ''"%=v_min_v:v_max_v"'' | Random using variables as bounds. |

===== In Text =====

  * ''v_name_v'' displays a numeric variable.
  * ''t_name_t'' displays a text variable.
  * ''v_turn_v|pad2'' displays the value padded to 2 digits.