Différences

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

--- fr:yaml:evenements [2026/08/31 21:08] – Wiki : fins de pages homogènes, liens Discord retirés cyrilfiesta
+++ fr:yaml:evenements [2026/11/04 21:34] (Version actuelle) – Documentation 4.17 : objets, evenements et mise en page verifies cyrilfiesta
@@ Ligne 3: / Ligne 3: @@
 ====== Événements (YAML) ======
-Les événements sont des blocs d'action déclenchés automatiquement à l'entrée d'une salle ou via des boutons.
+Les événements sont des blocs d'action exécutés automatiquement ou appelés par une interaction : bouton, raccourci ou ''declencher_event:id'', par exemple.
 ===== Syntaxe de base =====
@@ Ligne 34: / Ligne 34: @@
 | ''timer_global:id:ON'' | Activer un timer global |
 | ''timer_global:id:OFF'' | Désactiver un timer global |
-| ''declencher_event:id'' | Déclencher un événement global par son id |
+| ''declencher_event:id'' | Appeler un événement local ou global actif par son id |
 Plusieurs actions dans un même événement :
@@ Ligne 58: / Ligne 58: @@
 </code>
-''fin:'' et ''faire:'' sont exclusifs. Pour faire une action ET terminer, utilisez une salle intermédiaire.
+''faire:'' peut accompagner ''fin:'' : les effets s'exécutent avant la fin de partie.
 ===== Redirection (vers:) =====
@@ Ligne 73: / Ligne 73: @@
 ===== Bouton sur un événement =====
-Un événement peut être transformé en **bouton cliquable** avec ''bouton:''. Sans ''bouton:'', il s'exécute automatiquement à l'entrée.
+Un événement peut être transformé en **bouton cliquable** avec ''bouton:''. Un bouton attend un clic. Sans bouton, ''manuel: true'' ou un raccourci réserve l'événement à un appel manuel. Le simple fait de citer son identifiant dans ''declencher_event:'' ne le rend jamais manuel : sans réglage manuel, il reste évalué automatiquement à l'entrée et après les commandes.
 <code yaml>
@@ Ligne 118: / Ligne 118: @@
 ''visible-si:'' masque le bouton si la condition est fausse. ''grise-si:'' laisse le bouton visible mais inactif si la condition est vraie.
-⚠ Sur Discord, les boutons sont figés dans le message envoyé. Cliquer sur 🔄 (rafraichir) force un réaffichage avec les boutons à jour.
+Sur Discord, les boutons sont figés dans le message envoyé. Cliquer sur 🔄 (rafraichir) force un réaffichage avec les boutons à jour.
 ===== Texte conditionnel sur un événement =====
@@ Ligne 135: / Ligne 135: @@
 ===== Comportement séquentiel =====
-⚠ Critique : les événements s'exécutent dans l'ordre. Chaque événement voit les valeurs **déjà modifiées** par les précédents. Un événement avec ''vers:'' ou ''fin:'' **stoppe** les suivants.
+Critique : les événements s'exécutent dans l'ordre. Chaque événement voit les valeurs **déjà modifiées** par les précédents. Un événement avec ''vers:'' ou ''fin:'' **stoppe** les suivants.
 ===== Timer déclenché par événement =====
@@ Ligne 177: / Ligne 177: @@
 Les événements locaux peuvent être contrôlés avec ''event:id:ON'', ''event:id:OFF'' et ''event:id:SWITCH''.
+===== Événement manuel sans bouton =====
+^ Clé ^ Effet ^
+| ''manuel: true'' | Empêche le déclenchement automatique, sans ajouter de bouton. |
+Un choix peut appeler explicitement cet événement. Ses conditions, son état et ses limites restent vérifiés.
+<code yaml>
+titre: 'Wiki 4.17 : manuel'
+salles:
+- id: depart
+  texte: Départ.
+  evenements:
+  - id: alerte
+    manuel: true
+    texte: Appelé seulement par le choix.
+  choix:
+  - commande: appeler
+    bouton: Appeler
+    vers: depart
+    effet: declencher_event:alerte
+</code>
+À l'entrée, le texte de l'alerte ne paraît pas. Le choix « Appeler » la déclenche. Retirer ''manuel: true'' la rend aussi automatique ; ''declencher_event:'' ne change pas cette règle. En anglais : ''manual: true'' et ''trigger_event:alerte''.