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 le variabili e simulare cambiamenti dell'inventario per provare come la tua storia reagisce in diverse condizioni.
Puoi aprire il Menu di Debug durante l'anteprima della storia selezionando l'icona Debug.
1. Panoramica
Il Menu di Debug contiene schede dedicate per i principali sistemi di anteprima:
- Log: Mostra gli eventi della storia, le azioni e i messaggi di sistema durante l'anteprima.
- Inventario: Ti permette di visualizzare e modificare le quantità degli oggetti usati nella tua storia.
- Variabili: Consente di visualizzare e cambiare i valori delle variabili in tempo reale.
- Eventi: Mostra lo stato degli eventi e aiuta a verificare quali eventi della storia sono attivi durante l'anteprima.
- Timer: Mostra lo stato dei timer, inclusi i countdown attivi e il comportamento dei timer ricorrenti.
Le modifiche effettuate tramite il Menu di Debug influenzano solo la sessione di anteprima corrente. Non vengono salvate nella tua storia e verranno ripristinate quando riavvii l'anteprima.
2. Log
La scheda Log mostra cosa succede dietro le quinte mentre la tua storia viene eseguita. Ti aiuta a seguire il flusso narrativo, testare la logica e capire quando avvengono determinati eventi.
Cosa puoi vedere:
- Attivazioni di trigger e risultati delle azioni
- Avanzamento dei dialoghi e verifiche delle condizioni
- Modifiche a variabili o oggetti causate dalle scelte del giocatore
La scheda Log è principalmente un aiuto 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 il crafting, i puzzle o condizioni basate sugli oggetti.
Puoi:
- Aggiungere o rimuovere quantità per qualsiasi oggetto usando i pulsanti + / −.
- Cercare oggetti per nome.
Questo ti permette di testare scenari come:
- Creare nuovi oggetti usando ricette.
- Verificare se gli eventi si attivano quando un oggetto è presente.
- Confermare i percorsi della storia che dipendono da oggetti raccolti.
4. Variabili
La scheda Variabili mostra tutte le variabili definite nella tua storia e i loro valori correnti. Puoi modificarle per simulare decisioni del giocatore o testare percorsi alternativi della storia.
Puoi:
- Attivare/disattivare flag (true/false).
- Modificare i numeri direttamente.
- Modificare i valori di testo.
- Ripristinare variabili individuali.
L'elenco delle variabili si aggiorna automaticamente quando vengono create o modificate nuove variabili.
5. Flusso di test
Il Menu di Debug è pensato per il testing creativo, non per il debug tecnico. Ti aiuta a verificare che:
- Scelte e variabili si comportino come previsto.
- Oggetti e logica di crafting funzionino correttamente.
- I rami della storia si sbloccano nelle condizioni giuste.
- Eventi e timer si attivino nei momenti previsti.
- Le transizioni di stato del giocatore siano coerenti.
Puoi combinare il Menu di Debug con il Sistema di Controlli dell'Editor per un workflow di convalida 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 il gating degli oggetti senza riprodurre le scene iniziali.
- Usa Eventi e Timer per confermare tempistiche, comportamento dei trigger e dei countdown.
- Resetta spesso per verificare che la tua storia funzioni correttamente da un inizio pulito.
Il Menu di Debug ti dà il pieno controllo sui test, permettendoti di esplorare ogni ramo, decisione e risultato prima che la tua storia raggiunga i Dreamers.