Variabili

Le variabili memorizzano informazioni su ciò che è successo nella tua storia e sulle azioni del giocatore. Permettono al gioco di ricordare le scelte, tracciare i progressi, controllare come il mondo reagisce e, opzionalmente, mostrare statistiche importanti visibili al giocatore.

Le variabili sono la base della logic in Talescape. Vengono usate comunemente per controllare le opzioni di dialogo, attivare eventi, sbloccare oggetti o determinare quali scene diventano disponibili.

Le variabili possono appartenere all'intera storia, a un capitolo o a una singola scena. Questo mantiene lo stato locale vicino al punto in cui viene usato, pur consentendo ai valori importanti di rimanere disponibili ovunque.

Le variabili si creano nel pannello Variabili. Ogni variabile include le seguenti impostazioni:

• Nome: Un'etichetta descrittiva usata per identificare la variabile nell'editor.
• Tipo: Determina che tipo di valore la variabile memorizza.
• Ambito: Determina se la variabile appartiene alla storia, a un capitolo o a una scena.
• Valore iniziale: Il valore assegnato quando la storia inizia.
• Impostazioni statistiche (opzionale): Determinano se la variabile dovrebbe essere mostrata al giocatore come una statistica visibile.

Il valore iniziale è opzionale. Se non viene fornito un valore, la variabile inizia vuota o col suo valore predefinito.

L'ambito di una variabile determina a cosa appartiene e dove dovrebbe essere usata normalmente.

• Storia: Usalo per valori che contano per tutta la storia, come salute, sanità mentale, affetto o una scelta importante che influisce sui capitoli successivi.
• Capitolo: Usalo per valori che contano solo all'interno di un capitolo, come il numero di documenti raccolti in quel capitolo.
• Scena: Usalo per stato locale in una scena, come se una TV è accesa.

Le variabili di storia corrispondono al comportamento precedente. Le variabili di capitolo e scena aiutano a mantenere i progetti grandi più leggibili perché gli interruttori temporanei non devono più stare accanto allo stato principale della storia.

Le variabili di scelta memorizzano un semplice valore vero o falso. Sono usate per decisioni sì/no e sono il tipo di variabile più comune.

Tipici usi includono:

• Tenere traccia se il giocatore ha compiuto una specifica azione.
• Registrare decisioni prese durante i dialoghi.
• Sbloccare eventi o opzioni di dialogo.

Esempi d'uso:

• Il giocatore ha aperto il baule?
• Il giocatore ha aiutato il pescatore?
• L'ingresso della caverna è sorvegliato?

Le variabili di scelta possono essere impostate su vero o falso tramite azioni o eventi.

Le variabili numeriche memorizzano valori numerici. Sono utili quando devi tracciare contatori, punteggi o valori di progressione.

Tipici usi includono:

• Tracciare risorse raccolte
• Contare quante volte qualcosa è successo
• Gestire valute o punti

Esempi d'uso:

• Quante chiavi ha il giocatore?
• Quanto denaro è stato raccolto?
• Quanti indizi sono stati scoperti?

Le variabili numeriche possono essere incrementate, decrementate o impostate a un valore specifico durante il gioco.

Le variabili di testo memorizzano brevi porzioni di testo. Sono utili quando devi ricordare nomi, codici o selezioni fatte dal giocatore.

Tipici usi includono:

• Memorizzare il nome scelto dal giocatore
• Registrare quale opzione è stata selezionata
• Salvare codici o identificatori

Esempi d'uso:

• Nome del giocatore
• Fazione selezionata
• Codice della porta inserito

Le variabili di testo possono essere aggiornate ogni volta che è necessario memorizzare un nuovo valore.

Le variabili calcolate ricavano il loro valore da un'espressione invece di contenere un valore fisso. L'espressione può usare numeri normali o segnaposti per altre variabili.

Gli operatori supportati sono *, +, /, %, - e parentesi.

Le variabili calcolate sono utili per valori come il danno dopo l'armatura, un punteggio derivato da diversi contatori o un valore di progresso basato sugli oggetti raccolti. Mantengono la logica derivata in un unico posto invece di richiedere diversi aggiornamenti separati delle variabili.

Le variabili possono restare nascoste come logica interna della storia oppure possono essere contrassegnate come statistiche quando il giocatore dovrebbe conoscere il valore corrente durante il gioco.

Le statistiche sono utili per valori come:

• salute o resistenza
• sanità mentale, sospetto o pericolo
• valori di relazione
• risorse raccolte
• progresso del capitolo o progresso di un puzzle

Una statistica può essere visualizzata in diversi formati:

• Testo: Mostra il valore direttamente. Utile per nomi, etichette, contatori o valori in cui la dicitura esatta è importante.
• Barra: Mostra il progresso come una barra riempita. Utile per salute, resistenza, sanità mentale o altri valori con un chiaro minimo e massimo.
• Segmenti: Mostra il progresso come spezzoni separati. Utile per cuori, cariche, progresso degli indizi o risorse limitate.

Contrassegna le variabili come statistiche solo quando è utile che il giocatore le veda. Le variabili che controllano solo condizioni nascoste, ramificazioni o lo stato interno della storia possono rimanere variabili normali.

Le variabili possono essere inserite nei campi di testo che supportano segnaposti. Quando un campo di testo supporta i segnaposti, l'editor mostra un selettore in modo che non sia necessario ricordare i nomi esatti delle variabili.

Questo è utile per nomi del giocatore, conteggi di oggetti raccolti, fazioni selezionate, risposte ricordate o qualsiasi altro valore che debba apparire nel testo.

Lo stesso selettore è disponibile anche dove condizioni e azioni richiedono un valore di variabile. Questo mantiene l'uso delle variabili coerente tra scrittura e logica.

Le variabili vengono usate in tutto l'editor per controllare il comportamento della storia.

Possono essere usate per:

• Mostrare o nascondere opzioni di dialogo
• Attivare trigger ed eventi
• Controllare i percorsi ramificati della storia
• Sbloccare scene, oggetti o interazioni
• Riempire campi di testo supportati con i valori memorizzati
• Calcolare valori da altre variabili

Ogni volta che una variabile cambia, il nuovo valore viene memorizzato immediatamente e rimane attivo per il resto della sessione di gioco.

Durante i test, puoi aprire il Menu di debug per ispezionare e modificare le variabili in tempo reale.

Questo ti permette di:

• visualizzare tutte le variabili attualmente usate nella storia
• cambiare valori per testare percorsi alternativi
• reimpostare le variabili ai loro valori iniziali
• verificare le variabili con ambito nella scena o nel capitolo pertinente

Questo rende più facile testare logiche ramificate complesse senza dover ripetere tutta la storia.

• Usa le variabili di scelta per decisioni semplici sì o no.
• Usa le variabili numeriche per contatori, risorse o per tracciare i progressi.
• Usa le variabili di testo solo quando devi memorizzare valori testuali.
• Usa le variabili calcolate per valori derivati da altre variabili.
• Mantieni lo stato temporaneo in variabili di scena o capitolo quando non è rilevante ovunque.
• Contrassegna le variabili come statistiche solo quando il giocatore dovrebbe vedere quel valore durante il gioco.
• Usa nomi di variabili descrittivi in modo che siano facili da capire in seguito.
• Rimuovi le variabili inutilizzate per mantenere il progetto organizzato.

Le variabili permettono a Talescape di ricordare cosa è successo e reagire di conseguenza. Costituiscono la spina dorsale delle condizioni, delle azioni e di ogni percorso ramificato nella tua storia.