Mantieni piccolo il tuo primo progetto: una conversazione, una scelta memorizzata, due finali. Questo esempio segue persone chiaramente adulte che collaborano alla preparazione di uno studio. La loro decisione cambia il finale della storia, offrendoti un modo gestibile per imparare dialoghi, diramazioni e stato. Non servono immagini o voci scaricate, quindi ci sono meno elementi da controllare se qualcosa non funziona.
Scarica lo script dalla pagina dei modelli. Rispetta la documentazione di riferimento ufficiale del linguaggio, ma non è stato testato nel motore Ren'Py. Annota la versione del motore che usi, poi esegui i controlli di lint e le prove di gioco descritti sotto prima di considerare l’esempio una build funzionante.
Crea un progetto pulito
Scarica Ren'Py dal sito ufficiale, apri il launcher e crea un nuovo progetto in una posizione in cui hai accesso in scrittura. Conserva i file dell’interfaccia generati. Scegli una risoluzione e un tema che garantiscano una buona leggibilità, poi avvia il progetto senza modificarlo. Questo primo avvio ti offre una base funzionante prima di cambiare qualsiasi cosa.
Fai una copia di backup del file script.rpy generato prima di sostituirlo con l’esempio fornito. Mantieni una sola etichetta start nel progetto. Ren'Py combina i file di script nella directory game, quindi lasciare l’etichetta start del modello insieme a quella dell’esempio crea un conflitto.
Leggi la struttura prima di modificarla
L’esempio definisce un personaggio, inizializza un flag di scelta con default e comincia da label start. Un menu offre due risposte: proporre un piano condiviso o mantenere piani separati. Ogni risposta imposta il flag e salta a una discussione comune ai due percorsi. Una condizione finale usa il flag per selezionare una delle due etichette dei finali.
Rispetta esattamente l’indentazione: definisce i blocchi dello script. Mantieni etichette e definizioni al livello previsto e indenta le istruzioni che appartengono a ciascuna opzione del menu. Apporta una piccola modifica alla volta e avvia il progetto dopo ogni modifica, così puoi ricondurre un problema all’intervento che lo ha causato.
Rendi comprensibile la scelta
Lascia che le parole e la situazione facciano capire al giocatore che cosa sta scegliendo. Qui i collaboratori decidono se seguire un piano condiviso. Il finale rispecchia quella risposta, rendendone facile da riconoscere la conseguenza. Una scelta sembra significativa quando la storia la ricorda e il giocatore può vedere quale effetto ha avuto.
Per ricordare una specifica decisione, questa scena richiede soltanto una variabile booleana con un nome. Un valore numerico della relazione aggiungerebbe lavoro di gestione senza una regola utile da applicare. Introduci contatori quando sai come dovrebbero combinarsi più decisioni e scrivi quella regola prima di aggiungere altre diramazioni.
Aggiungi gli elementi di presentazione quando il percorso funziona
Inizia con il testo e lo sfondo predefinito. Quando entrambi i finali funzionano, aggiungi uno sfondo originale e uno sprite del personaggio con un piccolo insieme di espressioni. Usa nomi coerenti e annota la fonte e i diritti di ogni risorsa. Tenere queste informazioni aggiornate durante il lavoro è più semplice che ricostruirle quando sei pronto a pubblicare.
Controlla ogni immagine nell’area di visualizzazione effettiva. Anche un rendering dettagliato a piena risoluzione può rendere un personaggio poco riconoscibile una volta ritagliato. Mantieni visibili la casella di testo, i menu e gli indicatori di focus, e colloca i controlli del suono e delle animazioni in un punto accessibile dell’interfaccia.
Testa in modo mirato salvataggi e rollback
Salva prima del menu, dopo il menu e al finale. Ricarica ogni salvataggio e verifica che la scelta memorizzata e i dialoghi corrispondano a ciò che ti aspetti in quel momento. Dopo aver completato un percorso, avvia una nuova partita e controlla che inizi con lo stato iniziale previsto.
Usa i normali controlli del progetto per tornare indietro oltre la scelta con il rollback e annota che cosa succede quando la raggiungi di nuovo. Se in seguito aggiungi effetti esterni irreversibili, come modifiche all’account o transazioni remote, progetta la loro interazione con il rollback prima di collegarli a una scelta narrativa.
Prepara il pacchetto e controlla il risultato
Esegui Check Script (Lint) dal launcher e analizza le segnalazioni. Il lint può rilevare problemi nello script; per valutare la scrittura e la coerenza dei percorsi è comunque necessario giocare. Raggiungi entrambi i finali partendo ogni volta da una nuova partita, poi chiedi a un secondo tester di ripetere le prove. Usa la matrice di test dei percorsi per annotare ciò che è successo davvero.
Crea una distribuzione per la piattaforma scelta ed esegui la build pacchettizzata al di fuori della directory del progetto. Controlla lì i salvataggi, le impostazioni e il comportamento in caso di file mancanti. Archivia lo script, la versione del motore e le note dei test. Amplia la storia con una scena testata prima di affrontare una riscrittura completa dell’interfaccia.
Decisioni chiave
- Mantieni una sola etichetta start e rispetta l’indentazione dello script.
- Testa entrambi i finali prima di aggiungere immagini.
- Controlla separatamente lo stato di una nuova partita, i salvataggi e il rollback.
- Esegui la build pacchettizzata dopo il lint e le prove di gioco nel progetto.
File della guida
Script di esempio Ren'Py ↓Matrice di test dei percorsi ↓Le comunità esterne dedicate ai modelli e i siti di pubblicazione esterni possono contenere materiale esplicito. I link alle fonti si aprono in una nuova scheda; questa guida non carica le relative anteprime.
Fonti e approfondimenti +
Ultimo controllo 5 ottobre 2026.