Logica » Condizioni
April 22, 2026

Condizioni

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.

Condizioni definiscono quando qualcosa dovrebbe accadere o se qualcosa dovrebbe essere visibile. Sono uno degli strumenti principali di logica in Talescape e vengono usate non solo negli eventi, ma anche per controllare opzioni di dialogo, elementi della scena e altri sistemi interattivi.

1. Panoramica

1. Panoramica

Una condizione è un controllo logico che valuta lo stato attuale della storia. Se la condizione è soddisfatta (true), l'azione, il dialogo o l'elemento associato diventa attivo. In caso contrario viene saltato o nascosto.

Le condizioni possono verificare:

  • Variabili
  • Oggetti nell'inventario
  • Obiettivi
  • Probabilità casuale
  • Stato del sistema (es. capitolo o stato del timer)

Ti permettono di far reagire il mondo in modo dinamico alle scelte precedenti e ai progressi del giocatore.

2. Dove vengono usate le condizioni

Le condizioni non sono limitate agli eventi; vengono usate in tutto Talescape per definire visibilità e flusso logico:

  • Eventi: Decidono se l'evento deve essere eseguito quando il suo trigger si attiva.
  • Opzioni di dialogo: Controllano quali scelte di dialogo sono disponibili al giocatore.
  • Elementi della scena: Decidono quali oggetti, immagini o elementi di testo sono visibili.
  • Azioni: (In alcuni casi) Determinano se un'azione deve essere eseguita dopo una verifica.

Questa flessibilità ti permette di limitare il progresso, rivelare segreti o ramificare i dialoghi basandoti su decisioni precedenti, senza scrivere logica complessa a mano.

3. Tipi di condizioni

I tipi di condizione disponibili includono (a seconda della configurazione della tua storia):

  • Variabili: Confrontano valori numerici o testuali (size is \"small\", coins ≥ 5).
  • Scelte: Verificano se una scelta semplice on/off è impostata.
  • Inventario: Verificano se un giocatore possiede un oggetto o una quantità specifica.
  • Obiettivi: Verificano se un obiettivo è stato sbloccato.
  • Sistema: Valutano probabilità casuali, stati del timer o altre condizioni a livello di sistema.

Tutti i tipi di condizione supportati vengono mantenuti automaticamente aggiornati dall'editor.

5. Casi d'uso

  • Diramazione di dialogo: “Mostra questa battuta solo se il giocatore ha la mappa.”
  • Oggetto interattivo: “Mostra il forziere solo se non è ancora stato aperto.”
  • Evento: “Attiva il cambio scena quando il generatore è riparato.”
  • Oggetto nascosto: “Rivela l'artefatto solo se la variabile 'Perception' del giocatore ≥ 5.”

6. Valutazione delle condizioni

Le condizioni vengono valutate ogni volta che il loro elemento padre (evento, dialogo o scena) diventa attivo.
Se lo stato della storia cambia, il risultato della condizione si aggiorna automaticamente, garantendo che opzioni e elementi visivi corretti compaiano sempre.

7. Buone pratiche

  • Mantieni le condizioni semplici e descrittive.
  • Usa variabili e flag per tracciare lo stato a lungo termine.
  • Raggruppa le condizioni correlate sotto un singolo evento quando possibile.
  • Testa accuratamente i rami condizionali in Anteprima Storia.
  • Usa le condizioni casuali con parsimonia per variazioni narrative, non per la progressione principale.

8. Debug delle condizioni

Se un elemento non appare o un evento non si attiva:

  • Controlla il Menu di debug per vedere gli stati attuali di variabili e inventario.
  • Verifica che i valori della condizione corrispondano ai tipi di dati attesi (es. booleano vs numero).
  • Assicurati che la condizione sia collegata all'elemento o evento corretto.

Le condizioni sono ciò che rende le tue storie reattive e vive, permettendoti di plasmare un mondo che si adatta a ogni decisione, scoperta ed errore di un Dreamer.

Avanti: Azioni