# Qu'est-ce que le déblocage par email ?
Le déblocage par email (action unlock) est un mécanisme qui permet au joueur de débloquer un choix dans l'histoire en cliquant sur un bouton intégré directement dans un email d'événement. C'est un outil puissant pour créer des moments d'immersion où le joueur interagit avec l'univers de l'histoire à travers sa boîte de réception.
Un pont entre email et récit
# Configurer le bouton de déblocage
Créez un événement de type Email
Dans l'éditeur d'événements, créez un nouvel événement de type "Email". Configurez l'expéditeur, le sujet et le contenu comme d'habitude.
Activez le bouton de déblocage
Dans les paramètres de l'événement email, renseignez le champ "Texte du bouton de déblocage" (unlockButtonText). Par exemple : "Accepter la mission", "Ouvrir le coffre" ou "Rejoindre le groupe".
Configurez la condition EventRead sur le lien
Sur l'étape cible, ajoutez une condition de type EventRead sur le lien que vous souhaitez débloquer. Sélectionnez l'événement email que vous venez de configurer.
Testez le parcours complet
Lancez une lecture de test, déclenchez l'événement email, ouvrez l'email et cliquez sur le bouton pour vérifier que le choix se débloque correctement.
# Le parcours du joueur
Voici ce que le joueur vit lorsqu'il interagit avec un email de déblocage :
- Réception de l'email — Le joueur reçoit un email fictif dans l'interface de lecture (et/ou par notification réelle selon la configuration).
- Lecture de l'email — Le joueur ouvre l'email et découvre le contenu narratif, accompagné d'un bouton d'action bien visible.
- Clic sur le bouton — Le joueur clique sur le bouton de déblocage. S'il n'est pas connecté, il est redirigé vers la page de connexion.
- Redirection automatique — Après connexion, le joueur est automatiquement redirigé vers l'étape en cours de son histoire.
- Choix débloqué — Le lien conditionné par EventRead est désormais visible et le joueur peut le sélectionner pour avancer dans le récit.
Texte du bouton personnalisé
# Combiner avec un délai en OR (filet de sécurité)
Un risque avec le déblocage par email est que le joueur ne consulte pas (ou ne reçoive pas) l'email, ce qui le bloquerait définitivement. Pour éviter cela, combinez la condition EventRead avec une condition DelayAfter en utilisant l'opérateur OR.
Condition 1 : EventRead (email "Mission secrète" lu)
OR
Condition 2 : DelayAfter >= 30 minutes
→ Le choix apparaît dès que le joueur clique dans l'email
OU après 30 minutes d'attente (filet de sécurité).Ne bloquez jamais le joueur
# Cas d'usage avancés
- Enquête interactive — Un informateur envoie un email contenant un indice. Le joueur clique pour "accepter le rendez-vous" et débloque une nouvelle scène d'interrogatoire.
- Mission à durée limitée — Combinez EventRead (AND) avec une condition horaire pour créer des missions disponibles uniquement si l'email est ouvert pendant la bonne plage horaire.
- Choix moral par email — Envoyez deux emails différents avec chacun un bouton de déblocage menant à un choix différent. Le joueur fait son choix directement depuis sa boîte de réception.
- Collaboration multijoueur — En mode multijoueur, un joueur reçoit un email dont le déblocage fait apparaître un choix pour un autre joueur (via une variable partagée).
# Récapitulatif
| Élément | Description |
|---|---|
| unlockButtonText | Texte affiché sur le bouton dans l'email (ex: "Accepter la mission") |
| EventRead | Condition de lien qui vérifie si le joueur a lu l'événement email |
| Opérateur OR | Permet d'ajouter un délai comme alternative au clic dans l'email |
| Redirection | Le joueur est redirigé vers l'histoire après connexion si nécessaire |