Menu di debug
In lavorazione
Questa documentazione è ancora in espansione e in fase di revisione. Funzionalità, screenshot e descrizioni possono cambiare fino al rilascio pubblico di Talescape. Se qualcosa non è chiaro o hai bisogno di aiuto, chiedi sul Discord ufficiale di Talescape. Siamo felici di chiarire o aggiornare le pagine se necessario.
Il Menu di debug è uno strumento di test che ti permette di ispezionare e modificare lo stato della tua storia mentre la visualizzi in anteprima nell'editor. Ti consente di vedere i log, modificare variabili e simulare cambiamenti nell'inventario per testare come la tua storia reagisce in diverse condizioni.
Puoi aprire il Menu di debug durante Anteprima della storia selezionando l'icona Debug.
1. Panoramica
Il Menu di debug contiene tre schede principali:
- Log: Mostra eventi della storia, azioni e messaggi di sistema durante l'anteprima.
- Inventario: Ti permette di vedere e modificare le quantità degli oggetti usati nella tua storia.
- Variabili: Ti permette di vedere e modificare i valori delle variabili in tempo reale.
Qualsiasi modifica fatta tramite il Menu di debug riguarda solo la sessione di anteprima corrente. Non vengono salvate nella tua storia e si azzerano quando riavvii l'anteprima.
2. Log
La scheda Log mostra cosa accade dietro le quinte mentre la tua storia viene eseguita. Ti aiuta a seguire il flusso narrativo, testare la logica e capire quando si verificano certi eventi.
Cosa puoi vedere:
- Attivazioni di trigger e risultati delle azioni
- Avanzamento dei dialoghi e verifiche delle condizioni
- Modifiche di variabili o oggetti causate dalle scelte del giocatore
La scheda Log è principalmente uno strumento narrativo che aiuta i Bards a confermare che la logica della storia venga eseguita nell'ordine previsto. Non mostra errori tecnici o di runtime.
3. Inventario
La scheda Inventario elenca tutti gli oggetti disponibili nella storia, non solo quelli attualmente posseduti dal giocatore. Puoi modificare liberamente le loro quantità per testare crafting, puzzle o condizioni basate sugli oggetti.
Puoi:
- Aggiungere o rimuovere quantità per qualsiasi oggetto usando i pulsanti + / −.
- Cercare gli oggetti per nome.
Questo ti permette di testare scenari come:
- Creare nuovi oggetti usando le ricette.
- Verificare se gli eventi si attivano quando un oggetto è presente.
- Verificare i percorsi della storia che dipendono dagli oggetti raccolti.
4. Variabili
La scheda Variabili mostra tutte le variabili definite nella tua storia e i loro valori attuali. Puoi modificarle per simulare decisioni del giocatore o testare percorsi alternativi della storia.
Puoi:
- Alternare flag (true/false).
- Modificare direttamente i numeri.
- Modificare i valori di testo.
- Reimpostare variabili individuali.
L'elenco delle variabili si aggiorna automaticamente quando nuove variabili vengono create o modificate.
5. Flusso di test
Il Menu di debug è pensato per il test creativo, non per il debug tecnico. Ti aiuta a verificare che:
- Scelte e variabili si comportino come previsto.
- Gli oggetti e la logica di crafting funzionino correttamente.
- I rami della storia si sblocchino alle condizioni corrette.
- Le transizioni dello stato del giocatore siano coerenti.
Puoi combinare il Menu di debug con il Editor Checks System per un flusso di validazione completo prima del rilascio.
6. Buone pratiche
- Usa i Log per tracciare il flusso della storia e confermare l'ordine degli eventi.
- Usa le Variabili per saltare direttamente a rami specifici per test rapidi.
- Usa l'Inventario per testare il crafting o le condizioni basate su oggetti senza dover rigiocare le scene iniziali.
- Reimposta spesso per verificare che la tua storia funzioni correttamente da zero.
Il Menu di debug ti dà il pieno controllo sui test, permettendoti di esplorare ogni ramo, scelta e risultato prima che la tua storia raggiunga i Dreamers.