> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://documentation.celestory.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🟩 Choix

# 🟩 Choix

${frame}[Vidéo : anatomie du bloc Choix](https://celestory-docs-videos.netlify.app/fr/anatomie-bloc/choice.html)

![Choix](https://celestory-docs-illustrations.netlify.app/fr/Choix_FR.svg)

Le bloc Choix permet de mettre en pause une expérience interactive et de présenter des boutons à l'utilisateur pour qu'il prenne une décision. La suite du flux dépendra du bouton cliqué, permettant ainsi de créer des embranchements narratifs ou fonctionnels.

Ce bloc est essentiel pour toute interaction nécessitant une sélection utilisateur explicite, comme des dialogues à embranchements, des menus d'actions ou des confirmations.

## 📥 Entrées

-   in (Trigger) : Déclenche l'affichage des boutons à l'écran et met l'expérience en pause.
-   choix (Liste<Textes>) : Liste des propositions qui généreront les boutons à afficher. Chaque élément de la liste correspond à un bouton. La liste se remplit dans la fenêtre d'édition du bloc : on ne peut pas y brancher une variable.
-   (Nom de chaque choix) (Configuration de choix) : chaque choix ajouté crée aussi une entrée à son nom, qui permet de modifier ce bouton (par exemple avec un bloc Modifier choix).
-   chrono (Nombre) : (Optionnel) Temps limite en secondes avant expiration du choix. Si ce paramètre est vide ou égal à 0, le joueur dispose d'un temps illimité.

## 📤 Sorties

-   (Nom de chaque choix) (Trigger) : Une sortie est générée pour chaque élément de la liste "choix". Le flux emprunte la sortie correspondant au bouton cliqué par l'utilisateur.
-   temps écoulé (Trigger) : Cette sortie n'apparaît que si un chrono est défini. Le flux emprunte ce chemin si le temps imparti est écoulé sans action de l'utilisateur.

## 💡 Exemple d'utilisation

${frame}[Vidéo : le bloc Choix](https://celestory-docs-videos.netlify.app/fr/graphe-blocs/choix.html)

Scénario : Décision dans un jeu d'aventure

1. Le joueur arrive devant une porte mystérieuse dans un donjon.
1. Le bloc Choix est placé dans le graphe ; dans sa fenêtre d'édition, on ajoute trois textes au champ "choix" : "Ouvrir la porte", "Fouiller la serrure" et "Fuir".
1. Trois sorties sont automatiquement générées : Ouvrir la porte, Fouiller la serrure et Fuir.
1. Chaque sortie est reliée à une séquence différente :

- Ouvrir la porte mène à une scène où le joueur affronte un piège.
- Fouiller la serrure déclenche une mini-énigme pour trouver une clé.
- Fuir ramène le joueur à l'entrée du donjon.

## ⚙️ Détails Techniques

-   Génération dynamique des sorties : Le nombre de sorties "choix" est déterminé automatiquement en fonction du nombre d'éléments dans la liste fournie. Chaque sortie porte le nom exact de l'élément correspondant.
-   Gestion du chrono : Si le chrono est activé, le bloc affiche un compte à rebours visuel. Une fois le temps écoulé, le flux est automatiquement redirigé vers la sortie "temps écoulé".

---

*Version documentée : v2*