Validazione automatica
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 Sistema di Controlli dell'Editor ti aiuta a verificare che la tua storia sia completa, coerente e pronta per il rilascio. Scansiona automaticamente la tua storia per problemi comuni (da asset mancanti a metadati incompleti) e ti fornisce feedback dettagliati su cosa correggere.
Questi stessi controlli sono usati anche durante la revisione automatizzata che viene eseguita prima della pubblicazione. Eseguirli direttamente nell'editor ti permette di risolvere i problemi in anticipo ed evitare il rifiuto durante il rilascio.
1. Esecuzione dei controlli
Puoi avviare i controlli in due modi:
| Ambito | Descrizione |
|---|---|
| Controllo globale (Panoramica) | Esegue tutte le validazioni disponibili per l'intera storia. Accessibile tramite il pannello Controlli nella barra laterale. |
| Controllo locale (Per elemento) | Esegue le validazioni per l'elemento che stai modificando, come un capitolo, una scena o un dialogo specifico. |
I risultati vengono mostrati immediatamente e raggruppati per categoria (es. Marketplace, Capitoli, Scene, Personaggi). Puoi rieseguire i controlli in qualsiasi momento cliccando Esegui controlli.
2. Livelli di gravità
A ogni problema viene assegnato un livello di gravità per indicarne l'importanza:
| Gravità | Descrizione | Azione |
|---|---|---|
| Info | Note informative o suggerimenti. | Nessuna azione richiesta, ma possono migliorare la qualità. |
| Avviso | Problemi potenziali che potrebbero causare inconvenienti a seconda del contesto. | Verifica e correggi se rilevante. |
| Errore | Errori critici che impediscono il rilascio della storia. | Devono essere risolti prima di creare un rilascio. |
Gli errori sono evidenziati chiaramente. Una storia con uno o più errori non può essere pubblicata finché non vengono risolti.
3. Controlli tipici
Il sistema copre sia validazioni tecniche che strutturali, come:
| Categoria | Esempi di controlli |
|---|---|
| Marketplace | Lunghezza della descrizione, avvisi sugli screenshot e requisiti dei tag. |
| Capitoli | Ogni capitolo ha una scena iniziale e almeno una via d'uscita. |
| Scene | Le scene sono raggiungibili e gli sfondi richiesti sono presenti prima del rilascio. |
| Dialoghi | Nessun ramo irraggiungibile o destinazione mancante. |
| Media | Tutti gli asset referenziati esistono e corrispondono ai formati richiesti. |
| Oggetti / Creazione | Ricette, riferimenti agli oggetti e le visuali rivolte al giocatore richieste sono valide. |
Ogni controllo mostra il risultato, il timestamp e un messaggio dettagliato così sai esattamente cosa modificare.
4. Controlli locali durante la modifica
Puoi anche eseguire controlli locali direttamente negli editor come Scene, Dialoghi o Capitoli.
Questi controlli mirati verificano solo il contenuto su cui stai lavorando, perfetti per una rapida validazione prima di proseguire lo sviluppo.
Esempio: mentre modifichi una scena, i controlli locali confermano uscite valide, utilizzi e eventuali requisiti di rilascio mancanti, come gli sfondi richiesti prima della pubblicazione.
5. Integrazione con il rilascio
Lo stesso sistema di validazione viene usato durante la fase di Revisione Automatica del flusso di rilascio. Se hai già risolto tutti i problemi mostrati nel Sistema di Controlli dell'Editor, la tua storia supererà automaticamente la fase di revisione automatica.
Questo assicura una transizione fluida dallo sviluppo alla pubblicazione.
6. Buone pratiche
- Esegui controlli completi della storia regolarmente, soprattutto prima della sottomissione.
- Risolvi tutti gli Errori e rivedi gli Avvisi per evitare sorprese durante la revisione.
- Usa frequentemente i controlli locali mentre modifichi per intercettare i problemi in anticipo.
- Controlla i timestamp per tracciare quando ogni verifica è stata eseguita l'ultima volta.
Il Sistema di Controlli dell'Editor funge da gate di qualità interno, assicurando che ogni storia pubblicata su Talescape sia stabile, completa e pronta per essere esplorata dai Dreamers.