Logique » Événements & Déclencheurs
April 22, 2026

Événements & Déclencheurs

En cours

Cette documentation est encore en cours d'expansion et d'affinement. Les fonctionnalités, captures d'écran et descriptions peuvent changer jusqu'à la sortie publique de Talescape. Si quelque chose n'est pas clair ou que tu as besoin d'aide, demande sur le Discord officiel de Talescape. On est ravis de clarifier ou de mettre à jour les pages si besoin.

Événements sont au cœur du système de logique de Talescape. Ils définissent quand quelque chose se produit et quelles actions s'en suivent. Chaque événement a un déclencheur, des conditions optionnelles et une ou plusieurs actions qui s'exécutent lorsque ces conditions sont remplies.

Les événements peuvent exister au niveau de l'histoire, au niveau du chapitre ou à l'intérieur de scènes individuelles.

1. Vue d'ensemble

Un événement réagit à quelque chose dans l'histoire : par exemple une interaction du joueur, une ligne de dialogue ou un minuteur. Il exécute ensuite une ou plusieurs actions, comme modifier une variable, donner un objet ou passer à une nouvelle scène.

Tu peux créer et gérer des événements dans :

  • Le panneau d'aperçu Événements
  • L'Éditeur de scène ou l'Éditeur de chapitre
  • Directement dans des éléments interactifs (comme des déclencheurs ou des objets)

Les événements générés automatiquement (par exemple à partir d'éléments déclencheurs dans les scènes) apparaissent aussi dans la liste des événements, mais ne peuvent être modifiés qu'en ouvrant l'élément correspondant.

2. Portée de l'événement

Chaque événement a une portée qui détermine où il peut s'exécuter :

  • Histoire : L'événement peut s'exécuter dans toute l'histoire.
  • Chapitre : L'événement peut s'exécuter n'importe où dans le chapitre sélectionné.
  • Scène : L'événement ne s'exécute que tant qu'une scène spécifique est active.

Utilise les événements au niveau de la scène pour des interactions locales, au niveau du chapitre pour la logique partagée par un chapitre, et au niveau de l'histoire pour des systèmes généraux qui doivent fonctionner partout. Par exemple, une potion de soin peut utiliser une logique au niveau de l'histoire pour augmenter la santé du joueur, peu importe où elle est utilisée.

3. Paramètres de l'événement

Chaque événement inclut plusieurs options clés :

  • Nom : Une étiquette pour identifier l'événement dans la liste.
  • Exécuter une fois : Exécute l'événement une seule fois par partie. Utile pour des découvertes uniques ou des jalons narratifs.
  • Séquentiel : Exécute les actions dans l'ordre, en attendant la fin de chaque action avant de continuer.
  • Déclencheur : Définit ce qui provoque le déclenchement de l'événement.
  • Conditions : Spécifient quand l'événement est autorisé à s'exécuter.
  • Actions : Définissent ce qui se passe lorsque l'événement s'exécute.

4. Déclencheurs

Les déclencheurs définissent le point de départ d'un événement. Ils déterminent quand l'événement s'active.

Les déclencheurs courants incluent :

  • Entrée dans la scène – S'exécute quand une scène se charge.
  • Interaction avec un élément – S'exécute lorsqu'un objet cliquable est activé.
  • Ligne de dialogue affichée – S'exécute lorsqu'une ligne de dialogue spécifique apparaît.
  • Minuteur terminé – S'exécute lorsqu'un minuteur lié se termine.

Chaque déclencheur peut avoir ses propres conditions et actions, ce qui te donne un contrôle total sur le timing et le comportement. Les références de déclencheur restent synchronisées avec l'éditeur.

5. Conditions

Les conditions déterminent si l'événement peut s'exécuter. Elles vérifient l'état actuel de l'histoire : par exemple si une variable a une valeur spécifique ou si un objet existe dans l'inventaire du joueur. Si les conditions ne sont pas remplies, l'événement ne se déclenchera pas, même si son déclencheur s'active.

Types de conditions typiques : variables, choix, objets, succès, chance aléatoire.

Tu peux combiner plusieurs conditions pour créer une logique complexe.

6. Actions

Les actions définissent ce que fait l'événement une fois déclenché. Tu peux ajouter une ou plusieurs actions au même événement.

Exemples :

  • Définir ou modifier une variable.
  • Donner ou retirer un objet.
  • Jouer un son ou afficher du texte.
  • Aller dans une autre scène.
  • Débloquer un succès.

Si Séquentiel est activé, les actions s'exécutent les unes après les autres ; sinon, elles s'exécutent toutes en même temps.

7. Édition et organisation

Tu peux :

  • Voir tous les événements en une fois dans le panneau d'aperçu Événements.
  • Filtrer par scène, chapitre ou type de déclencheur.
  • Modifier directement depuis un élément de scène pour un flux de travail plus rapide.

Les événements générés automatiquement (comme les éléments déclencheurs) ne peuvent pas être déplacés ni renommés, mais ils restent toujours visibles dans la liste des événements à titre de référence.

8. Bonnes pratiques

  • Utilise Exécuter une fois pour les jalons narratifs qui ne doivent pas se répéter.
  • Garde des noms d'événements descriptifs pour rester organisé dans les gros projets.
  • Privilégie les événements au niveau de la scène pour la logique locale, les événements au niveau du chapitre pour les systèmes de chapitre et les événements au niveau de l'histoire pour la logique réutilisable qui concerne toute l'histoire.
  • Combine soigneusement conditions et actions pour éviter les conflits logiques.
  • Réutilise les minuteurs, déclencheurs et conditions entre les événements quand c'est possible pour un design plus propre.

Les événements sont l'endroit où la logique de ton histoire prend vie, connectant dialogues, scènes et gameplay en un seul flux interactif. Toute réaction, choix et conséquence dans Talescape commence par un événement.

Suivant: Conditions

Documentation