**Language / Langue :** [[fr:txt:evenements|FR]] | **EN**

====== 997 events (.txt format) ======

Room ''997'' in the exit list triggers an event. It can be automatic, fired when the player enters the room, or manual, through a Discord reaction.

===== Basic syntax =====

<code>
997|condition|action|text
</code>

  * ''condition'' - trigger condition (''null'' means always)
  * ''action'' - what happens (see the table below)
  * ''text'' - message shown (''null'' means nothing)

===== Conditions =====

^ Syntax ^ Meaning ^
| ''null'' | Always triggered |
| ''v_hp_v.=.0'' | If the ''hp'' variable equals 0 |
| ''object'' | If the player holds the object |
| ''-object'' | If the player does not hold the object |
| ''v_a_v.=.v_b_v'' | Compares two variables |
| ''v_a_v.=.1 v_b_v.=.2'' | Logical AND (a space between conditions) |

Comparison operators are ''.=.'', ''.!=.'', ''.>.'', ''.>=.'', ''.<.'' and ''.<=.''. ''.in.'' tests a range, as in ''v_dice_v.in.1-3''.

===== Actions =====

^ Syntax ^ Effect ^
| ''5'' | Go to room 5 |
| ''v_room_v'' | Go to the room whose number is held in the variable |
| ''score.+.10'' | Adds 10 to ''score'' |
| ''score.-.5'' | Subtracts 5 |
| ''score.=.0'' | Sets the value |
| ''score.=.%1:6'' | Random value between 1 and 6 |
| ''object&&inventory&&Description'' | Adds an object to the inventory (''inventaire'' also works) |
| ''-tired&&invisible&&You are not tired any more'' | Removes an invisible state |
| ''name&&variable&&value&&desc'' | Changes or declares a variable |

===== Multiple actions =====

Separate actions with ''@@'':

<code>
997|null|score.+.10@@3|You earn 10 points and move to room 3.
</code>

If one of the actions is a redirection (a room number), it runs last.

===== Sequential behaviour =====

Several ''997'' lines in the same room are evaluated in order. Each one sees the values already changed by the previous ones. A ''997'' that redirects stops the ones after it.

===== Full example =====

<code>
3 dice_roll
Roll the dice! Result: v_resultat_v
dice|variable|%=1:6|You roll v_resultat_v!|A six-sided die.
997|v_dice_v.in.1-3|1|Poor roll, you start over...
997|v_dice_v.in.4-6|4|Excellent! You move on.
</code>