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

# 🟪 QTE

# 🟪 QTE

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

QTE signifie « Quick Time Event » (un défi en temps limité) : ce bloc permet de créer un défi rapide où l'utilisateur doit agir vite (par exemple appuyer plusieurs fois sur l'écran) avant la fin d'un chronomètre, sinon il échoue.

Inspiré des mécaniques de jeu vidéo, ce bloc est idéal pour simuler des situations de tension comme une fuite, un combat ou une action urgente nécessitant une réaction immédiate.

## 📥 Entrées

-   in (Flux) : Déclenche immédiatement l'événement QTE.
-   choice (Texte localisé) : Texte d'instruction affiché pour guider l'utilisateur (ex: "Appuie rapidement !", "Fuis !").
-   timer (Nombre) : Durée maximale (en secondes) pour accomplir l'objectif. Par défaut : 3 secondes.
-   objective (Nombre) : Nombre de pressions requises pour réussir. Par défaut : 10.

## 📤 Sorties

-   success (Flux) : Chemin emprunté si l'utilisateur atteint l'objectif avant la fin du timer.
-   failure (Flux) : Chemin emprunté en cas d'échec (timer écoulé ou inaction).

## 💡 Exemple d'utilisation

Scénario : Échapper à une explosion

1. Le joueur se trouve dans un bâtiment en feu et doit fuir avant l'effondrement.
1. Le flux active le bloc QTE pour simuler la course vers la sortie.
1. Paramétrage du bloc :

- choice : "COURS VERS LA SORTIE !"
- timer : 4 secondes
- objective : 15 pressions rapides

1. Si le joueur réussit, la sortie success mène à une cinématique de fuite réussie.
1. En cas d'échec, la sortie failure déclenche un écran de game over.

## ⚙️ Détails Techniques

-   Blocage de l'interface : Pendant le QTE, l'écran est verrouillé pour maximiser l'immersion et la tension.
-   Support multilingue : Le texte choice est compatible avec les systèmes de traduction.
-   Feedback visuel : Une jauge de progression ou un effet animé sur le bouton est généralement affiché pour guider l'utilisateur.

---

*Version documentée : v2*