Menu de débogage

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.

Le Menu de débogage est un outil de test qui vous permet d'inspecter et de modifier l'état de votre histoire pendant que vous la prévisualisez dans l'éditeur. Il vous permet de consulter les journaux, d'éditer les variables et de simuler des modifications d'inventaire pour tester la réaction de votre histoire dans différentes conditions.

Vous pouvez ouvrir le Menu de débogage pendant la Prévisualisation de l'histoire en sélectionnant l'icône Déboguer.

1. Aperçu

Le Menu de débogage contient des onglets ciblés pour les principaux systèmes de prévisualisation :

Journaux : Affiche les événements, les actions et les messages système pendant la prévisualisation.
Inventaire : Vous permet de voir et de modifier les quantités d'objets utilisés dans votre histoire.
Variables : Permet de voir et de changer les valeurs de variables en temps réel.
Événements : Affiche l'état des événements et aide à vérifier quels événements de l'histoire sont actifs pendant la prévisualisation.
Minuteries : Affiche l'état des minuteries, y compris les compte-à-rebours actifs et le comportement des minuteries récurrentes.

Les modifications effectuées via le Menu de débogage n'affectent que la session de prévisualisation en cours. Elles ne sont pas enregistrées dans votre histoire et seront réinitialisées lorsque vous redémarrerez la prévisualisation.

2. Journaux

Painterly village scene with thatched cottages and flowering vines in warm sunlight, overlaid by a dark Talescape Editor debug panel at the bottom showing Logs, Inventory and Variables tabs and log entries such as “Item collected: 'Eggplant'.”

L'onglet Journaux montre ce qui se passe en coulisses pendant l'exécution de votre histoire. Il vous aide à suivre le déroulement, tester la logique et comprendre quand certains événements se produisent.

Ce que vous pouvez voir :

Activations de déclencheurs et résultats d'actions
Avancement des dialogues et vérifications de conditions
Modifications de variables ou d'objets causées par les choix du joueur

L'onglet Journaux est principalement un outil narratif qui aide les Bards à confirmer que la logique de l'histoire s'exécute dans l'ordre attendu. Il n'affiche pas les erreurs techniques ou d'exécution.

3. Inventaire

Painted village clearing with thatched cottages and trees. A dark translucent Talescape UI panel at the bottom shows tabs 'Logs', 'Inventory', 'Variables' and four inventory icons (bundle, eggplant with count 1, leaves, bowl). Top-right tooltip reads 'Item received: Eggplant'.

L'onglet Inventaire répertorie tous les objets disponibles dans l'histoire, pas seulement ceux détenus actuellement par le joueur. Vous pouvez ajuster leurs quantités librement pour tester la fabrication, les énigmes ou les conditions basées sur des objets.

Vous pouvez :

Ajouter ou retirer des quantités pour n'importe quel objet en utilisant les boutons + / −.
Rechercher des objets par nom.

Cela vous permet de tester des scénarios tels que :

Fabriquer de nouveaux objets à l'aide de recettes.
Vérifier si des événements se déclenchent lorsqu'un objet est présent.
Vérifier les chemins narratifs dépendant d'objets collectés.

4. Variables

Talescape editor view: warm painted village with thatched cottages and trees. A dark debugging panel overlays the bottom with tabs labeled Logs, Inventory, Variables and a list: “Bear guards the Cave Entrance” (toggle on), “Fisherman is angry”, “Gender of the Player”, “Money” with value 0 and Reset buttons. Small play/timer and eye icons in top corners.

L'onglet Variables affiche toutes les variables définies dans votre histoire et leurs valeurs actuelles. Vous pouvez les modifier pour simuler des décisions du joueur ou tester des branches alternatives.

Vous pouvez :

Basculer des drapeaux (vrai/faux).
Modifier directement des nombres.
Éditer des valeurs de texte.
Réinitialiser des variables individuellement.

La liste des variables se met à jour automatiquement lorsque de nouvelles variables sont créées ou modifiées.

5. Flux de test

Le Menu de débogage est conçu pour les tests créatifs, pas pour le débogage technique. Il vous aide à vérifier que :

Les choix et les variables se comportent comme prévu.
Les objets et la logique d'artisanat fonctionnent correctement.
Les branches de l'histoire se débloquent dans les bonnes conditions.
Les événements et les minuteries se déclenchent aux moments attendus.
Les transitions d'état du joueur sont cohérentes.

Vous pouvez combiner le Menu de débogage avec le Système de vérification de l'éditeur pour un workflow de validation complet avant la publication.

6. Bonnes pratiques

Utilisez les Journaux pour tracer le déroulement et confirmer l'ordre des événements.
Utilisez les Variables pour aller directement à des branches spécifiques pour des tests rapides.
Utilisez l'Inventaire pour tester l'artisanat ou les verrous liés aux objets sans rejouer les premières scènes.
Utilisez les Événements et les Minuteries pour confirmer le comportement des déclencheurs, du timing et des compte-à-rebours.
Réinitialisez souvent pour vérifier que votre histoire fonctionne correctement depuis le début.

Le Menu de débogage vous donne un contrôle total sur les tests, vous permettant d'explorer chaque branche, décision et résultat avant que votre histoire n'atteigne les Dreamers.

Suivant: Validation automatisée

Documentation