Problemi comuni

Anche storie ben strutturate a volte possono non superare i controlli o comportarsi in modo diverso dal previsto. Questo articolo elenca i problemi più comuni riscontrati durante i test e la pubblicazione, insieme alle probabili cause e alle soluzioni.

1. Background o media mancanti

Sintomo: Una scena si carica con uno sfondo vuoto o nero.
Causa: L'immagine di sfondo è stata eliminata o non è stata assegnata.

Soluzione:

• Apri le Impostazioni Scena e assegna uno sfondo valido.
• Verifica che il file esista nella Libreria Media e rispetti i limiti di upload.

2. Scene orfane

Sintomo: Una scena non viene mai raggiunta durante la riproduzione della storia.
Causa: Nessun trigger o transizione porta a quella scena.

Soluzione:

• Usa i Controlli Scena per identificare le scene inutilizzate.
• Crea una transizione o un'azione di dialogo che la colleghi, oppure rimuovila se obsoleta.

3. Dialoghi irraggiungibili

Sintomo: Alcune opzioni di dialogo non compaiono mai.
Causa: L'opzione di dialogo è nascosta dietro condizioni che non si verificano mai.

Soluzione:

• Ricontrolla le variabili o flag correlati.
• Usa il Menu di Debug per attivare/disattivare valori delle variabili e confermare la visibilità.

4. Descrizioni o screenshot mancanti

Sintomo: Il rilascio non supera i controlli del Marketplace.
Causa: La storia manca dei metadati richiesti (es. lunghezza della descrizione, tag, screenshot).

Soluzione:

• Apri Impostazioni Storia → Marketplace.
• Aggiungi una descrizione (almeno 300 caratteri), tre screenshot e tre tag.

5. Classificazione dell'età o avvisi di contenuto errati

Sintomo: La storia viene segnalata o respinta durante la revisione.
Causa: Il gruppo d'età selezionato non corrisponde al contenuto della storia.

Soluzione:

• Consulta le Linee guida sui contenuti.
• Regola il gruppo d'età e seleziona tutti gli avvisi di contenuto applicabili.

6. La storia non termina correttamente

Sintomo: La storia continua indefinitamente o va in loop inaspettatamente.
Causa: Il capitolo finale non ha un trigger di completamento.

Soluzione:

• Aggiungi un'azione Successo Capitolo alla fine dell'ultimo capitolo.
• Testa con l'Anteprima Storia per confermare che i crediti appaiano correttamente.

7. Oggetti inutilizzati o rotti

Sintomo: Esistono oggetti ma non hanno un uso o effetto visibile.
Causa: Mancano ricette di creazione, trigger dell'oggetto o controlli dell'inventario.

Soluzione:

• Verifica che ogni oggetto sia referenziato in un evento, in una ricetta di crafting o in una condizione.
• Rimuovi gli oggetti non usati per mantenere il progetto pulito.

8. Disallineamento delle variabili

Sintomo: La logica non si comporta come previsto (si attivano rami sbagliati).
Causa: Tipo di variabile errato o valore impostato in modo scorretto.

Soluzione:

• Ricontrolla le azioni che modificano la variabile.
• Usa il Menu di Debug → Variabili per confermare i valori in tempo reale.

9. Transizioni di scena non funzionanti

Sintomo: Il giocatore rimane bloccato dopo una scelta o un click.
Causa: Il trigger o la condizione collegata alla transizione di scena è invalida.

Soluzione:

• Verifica che le Azioni contengano un passaggio valido “Vai alla scena”.
• Usa la scheda Log nel Menu di Debug per confermare l'attivazione del trigger.

10. Controlli che restano falliti dopo la correzione

Sintomo: Un problema risulta ancora “Failed” dopo averlo risolto.
Causa: I risultati dei controlli sono memorizzati nella cache.

Soluzione:

• Clicca di nuovo Esegui controlli per aggiornare i risultati di validazione.
• Assicurati che tutti i contenuti correlati siano salvati prima di rieseguire.

11. Il rilascio non passa alla revisione manuale

Sintomo: Il rilascio rimane in “Automated Review”.
Causa: Problemi di livello Failure non risolti nei Controlli.

Soluzione:

• Apri Controlli e risolvi tutti i failure elencati.
• Invia nuovamente il rilascio una volta che la storia supera la validazione.

12. Flag di contenuto mancanti o errati (AI)

Sintomo: La storia supera i controlli ma fallisce la moderazione.
Causa: Asset generati dall'AI non sono stati dichiarati.

Soluzione:

• Riapri Impostazioni Storia → Contenuto e abilita i flag AI rilevanti (es. “Immagini AI” o “Voci AI”).
• Invia nuovamente il rilascio.

13. Modifiche dei collaboratori non riflesse

Sintomo: Un collaboratore non può modificare o accedere a certe parti.
Causa: I permessi non sono stati aggiornati dopo aver aggiunto il collaboratore.

Soluzione:

• Apri Impostazioni Storia → Collaboratori.
• Assicurati che tutti i permessi rilevanti siano abilitati, poi clicca Salva modifiche.

14. Buone pratiche generali

• Esegui sempre i Controlli dell'Editor prima di creare un rilascio.
• Usa il Menu di Debug per confermare la logica e il comportamento dell'inventario.
• Mantieni i metadati (descrizione, classificazione per età, tag) completi e aggiornati.
• Riesegui i controlli dopo qualsiasi modifica importante per assicurarti della conformità.

Questi sono i problemi più frequenti segnalati da Bards e dai revisori. Risolverli per tempo garantisce che la tua storia superi la validazione senza intoppi e raggiunga i Dreamers senza ritardi.