> ## 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).

# 🟥 Chemin aléatoire

# 🟥 Chemin aléatoire

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

![Chemin aléatoire](https://celestory-docs-illustrations.netlify.app/fr/Cheminaleatoire_FR.svg)

Le bloc Chemin aléatoire tire au sort, au hasard, l'un des chemins que vous avez préparés dans votre histoire. C'est ce qui permet de créer des surprises : un joueur qui ouvre le même coffre deux fois peut tomber sur un trésor la première fois, et sur un piège la seconde.

Utilisez-le chaque fois que vous voulez qu'un même endroit de l'histoire ne se déroule pas toujours de la même façon : une rencontre, une récompense, un obstacle...

## 📥 Entrées

-   in (Flux) : Déclenche le tirage au sort lorsque le flux atteint ce bloc.
-   chemins (Nombre) : Nombre de chemins possibles parmi lesquels le bloc va choisir aléatoirement (par défaut : 2).
-   mélanger (Booléen) : Si activé (Vrai), le bloc mémorise les chemins déjà empruntés (tirage sans remise) et les exclut jusqu’à ce que tous aient été utilisés au moins une fois.

## 📤 Sorties

-   1, 2, 3... (Flux) : Sorties numérotées correspondant aux chemins possibles (leur nombre dépend de la valeur de "chemins"). Une seule sortie est activée aléatoirement.
-   fin (Flux) : Sortie déclenchée uniquement si "mélanger" est activé et que tous les chemins ont déjà été empruntés au moins une fois.

## 💡 Exemple d'utilisation

Scénario : Ouverture d’un coffre mystérieux

1. Le joueur trouve un coffre dans une pièce sombre.
1. Un message s’affiche : "Vous ouvrez le coffre avec précaution...".
1. Le bloc Chemin aléatoire est placé avec nombre = 3 pour simuler trois issues possibles.
1. Le bloc choisit aléatoirement une sortie :

- Sortie 1 : "Le coffre contient 100 pièces d’or !" (récompense).
- Sortie 2 : "Un piège se déclenche ! Vous perdez 20 PV." (danger).
- Sortie 3 : "Le coffre est vide..." (déception).

1. Le flux continue vers l’événement correspondant à la sortie sélectionnée.

## ⚙️ Détails Techniques

-   Gestion des chemins : Les sorties sont générées dynamiquement en fonction de la valeur de "chemins". Si chemins = 2, seules les sorties 1 et 2 seront disponibles.
-   Mode "mélanger" (tirage sans remise) : Lorsque ce mode est activé, le bloc utilise une liste interne pour suivre les chemins déjà empruntés. Une fois tous les chemins utilisés, la sortie "fin" est déclenchée.
-   Réinitialisation : Le bloc ne réinitialise pas automatiquement son état entre les sessions de jeu. Pour un nouveau tirage complet, désactivez puis réactivez le mode "mélanger".

---

*Version documentée : v2*