Convalida 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. Analizza automaticamente la tua storia alla ricerca di problemi comuni (dagli asset mancanti ai metadati incompleti) e fornisce feedback dettagliati su cosa correggere.
Gli stessi controlli vengono utilizzati anche durante la revisione automatizzata che avviene prima della pubblicazione. Eseguirli all'interno dell'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 attualmente 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 può aiutare a migliorare la qualità. |
| Avviso | Problemi potenziali che potrebbero creare inconvenienti a seconda del contesto. | Rivedi e correggi se rilevante. |
| Errore | Errori critici che impediscono il rilascio della storia. | Devono essere corretti 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 le validazioni tecniche sia quelle strutturali, come:
| Categoria | Esempi di controlli |
|---|---|
| Marketplace | Lunghezza della descrizione, screenshot e requisiti dei tag. |
| Capitoli | Ogni capitolo ha una scena iniziale e almeno un'uscita. |
| Scene | Ogni scena ha uno sfondo ed è utilizzata da qualche parte nella storia. |
| Dialoghi | Nessun ramo irraggiungibile o destinazioni mancanti. |
| Media | Tutti gli asset referenziati esistono e corrispondono ai formati richiesti. |
| Oggetti / Crafting | Ricette e riferimenti agli oggetti sono validi. |
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 i controlli locali direttamente negli editor come Scene, Dialoghi o Capitoli.
Questi controlli mirati verificano solo il contenuto su cui stai lavorando in quel momento, perfetti per una rapida validazione prima di proseguire lo sviluppo.
Esempio: mentre modifichi una scena, i controlli locali confermano che abbia uno sfondo, uscite valide e che venga usata da qualche parte nella storia.
5. Integrazione con il rilascio
Lo stesso sistema di validazione viene usato durante la fase di Revisione automatizzata 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 automatizzata.
Questo garantisce una transizione fluida dallo sviluppo alla pubblicazione.
6. Buone pratiche
- Esegui controlli completi della storia regolarmente, soprattutto prima dell'invio.
- Correggi tutti gli errori e rivedi gli avvisi per evitare sorprese durante la revisione.
- Usa spesso i controlli locali mentre modifichi per individuare i problemi precocemente.
- Controlla i timestamp per vedere quando ogni controllo è stato eseguito l'ultima volta.
Il Sistema di Controlli dell'Editor funge da filtro di qualità interno, garantendo che ogni storia pubblicata su Talescape sia stabile, completa e pronta per essere esplorata dai Dreamers.