Tutorial guidato e facoltativo della prima partita (ADR 0023). Riguarda solo il client: Core, protocollo, server e formato dei salvataggi non cambiano.
I passi
19 passi in assets/tutorial/tutorial.json: mappa e zoom, velocità, due stazioni, deposito, binario con profilo e opere, costruzione, locomotiva e carri, treno, linea e assegnazione, Mercato globale, Finanze, La tua scalata, consigli finali.
I passi avanzano su ciò che il client riceve: esiti dei comandi della propria compagnia, entità nella copia locale e pannelli aperti.
Interfaccia
Riquadro in basso a sinistra, che si può comprimere, con Avanti, Salta passo e Chiudi; F1 lo nasconde o lo riapre.
Il contorno animato segue gli scorrimenti dei pannelli.
Nella schermata di connessione ci sono la casella «Mostra il tutorial» e il pulsante «Tutorial», che apre una partita di prova nuova senza toccare quella del giocatore.
Avanzamento: si salva per partita in user://settings.cfg (origine, seme, mappa, anno, regione, compagnia) e riprende dopo un caricamento.
Logica e test: la logica pura (copione, condizioni, macchina a stati) non dipende da Godot e ha 10 test nel harness, compresa una prima partita simulata che percorre il copione vero.
Pilota automatico: non crea il tutorial, quindi le schermate di gioco non cambiano.
Due revisori hanno trovato 12 rilievi, tutti corretti; il ramo è già allineato con main.
## Cosa cambia e perché
Tutorial guidato e facoltativo della prima partita (ADR 0023). Riguarda solo il client: Core, protocollo, server e formato dei salvataggi non cambiano.
**I passi**
- 19 passi in `assets/tutorial/tutorial.json`: mappa e zoom, velocità, due stazioni, deposito, binario con profilo e opere, costruzione, locomotiva e carri, treno, linea e assegnazione, Mercato globale, Finanze, La tua scalata, consigli finali.
- I passi avanzano su ciò che il client riceve: esiti dei comandi della propria compagnia, entità nella copia locale e pannelli aperti.
**Interfaccia**
- Riquadro in basso a sinistra, che si può comprimere, con Avanti, Salta passo e Chiudi; F1 lo nasconde o lo riapre.
- Il contorno animato segue gli scorrimenti dei pannelli.
- Nella schermata di connessione ci sono la casella «Mostra il tutorial» e il pulsante «Tutorial», che apre una partita di prova nuova senza toccare quella del giocatore.
**Avanzamento:** si salva per partita in `user://settings.cfg` (origine, seme, mappa, anno, regione, compagnia) e riprende dopo un caricamento.
**Logica e test:** la logica pura (copione, condizioni, macchina a stati) non dipende da Godot e ha 10 test nel harness, compresa una prima partita simulata che percorre il copione vero.
**Pilota automatico:** non crea il tutorial, quindi le schermate di gioco non cambiano.
Due revisori hanno trovato 12 rilievi, tutti corretti; il ramo è già allineato con main.
Closes #45
## Fase
F6
## Verifica
- [x] `scripts/build.sh` verde
- [x] `scripts/test.sh --skip-slow` verde: 208 su 208
- [x] Client: 0 avvisi, 0 errori
- [x] `strings.csv`: solo righe aggiunte (51)
- [x] `docs/STATE.md`, `ARCHITECTURE.md` aggiornati, ADR 0023
- [ ] Prova in Godot: non possibile qui
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Tutorial facoltativo che accompagna il giocatore dalla mappa alla prima
linea in servizio e poi a Mercato globale, Finanze e La tua scalata. È
un'esperienza del solo client: osserva ciò che il client già riceve
(entità della compagnia in ClientWorld, esiti riusciti dei comandi,
pannello aperto, camera, velocità, anteprime del tracciato), non invia
comandi e non decide regole; Core, Protocol, Server e salvataggi non
cambiano (ADR 0023).
- Copione in assets/tutorial/tutorial.json (19 passi, chiavi di testo
per T(), elemento da evidenziare con ripiego, condizione osservabile),
esportato con il gioco; testi italiani e inglesi in strings.csv.
- Logica pura senza Godot in scripts/Tutorial/Logic: copione con
validazione, fatti, condizioni counter/panel/all/any, macchina a stati,
avanzamento salvato; compilata anche dal progetto dei test (8 test).
- Riquadro non modale in basso a sinistra della mappa, contorno ambra
animato, Avanti / Salta passo / Chiudi tutorial, F1 per nasconderlo o
riaprirlo; nel menu la casella «Mostra il tutorial» (attiva alla prima
partita) e l'opzione «Tutorial».
- Avanzamento per partita in user://settings.cfg, ripreso dopo il
caricamento; il pilota automatico non crea il tutorial.
Refs #45.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Unisce origin/main (audio, ere e obsolescenza, scheda dell'industria e
schermata di connessione) e corregge i rilievi della revisione del
tutorial (ADR 0023 aggiornato).
- Chiave dell'avanzamento senza l'impronta del terreno, che il server
ricalcola e che cambia giocando (città, industrie): origine della
partita, seme, lato, anno d'inizio, regione e compagnia. Un tutorial
ripreso dopo un anno di gioco ritrova la sua voce.
- «Tutorial» apre una partita locale di prova sempre nuova in
user://tutorial-server invece di riprendere l'autosalvataggio del
giocatore e rifare il tutorial lì dentro; con salvataggi locali già
presenti la casella «Mostra il tutorial» parte spenta. Casella e
pulsante passano nella nuova ConnectScreen (MenuScreen non c'è più).
- La casella spuntata vale anche su una voce chiusa o completata (stesso
seme di una partita vecchia).
- Contorno ritagliato dai contenitori a scorrimento, con l'elemento
portato in vista; del tutto nascosto si usa il ripiego.
- Pulsanti del riquadro senza fuoco: Invio e spazio restano alla
partita (Costruisci, pausa) e non saltano il passo.
- La base di «increase» è presa al completamento del passo precedente e
gli esiti dei comandi si valutano subito: un binario costruito appena
dopo conta per il passo nuovo.
- Velocità contata solo dalle richieste di questo client.
- Copione mancante o non valido segnalato nella partita; validazione
dei null ammessi dal JSON.
- Test: chiave stabile con impronta diversa, base al completamento,
piano con la casella, null nel copione. 228 test (208 senza i lenti).
Refs #45.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96
merged commit 1579f63287 into main2026-11-08 14:57:43 +01:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Cosa cambia e perché
Tutorial guidato e facoltativo della prima partita (ADR 0023). Riguarda solo il client: Core, protocollo, server e formato dei salvataggi non cambiano.
I passi
assets/tutorial/tutorial.json: mappa e zoom, velocità, due stazioni, deposito, binario con profilo e opere, costruzione, locomotiva e carri, treno, linea e assegnazione, Mercato globale, Finanze, La tua scalata, consigli finali.Interfaccia
Avanzamento: si salva per partita in
user://settings.cfg(origine, seme, mappa, anno, regione, compagnia) e riprende dopo un caricamento.Logica e test: la logica pura (copione, condizioni, macchina a stati) non dipende da Godot e ha 10 test nel harness, compresa una prima partita simulata che percorre il copione vero.
Pilota automatico: non crea il tutorial, quindi le schermate di gioco non cambiano.
Due revisori hanno trovato 12 rilievi, tutti corretti; il ramo è già allineato con main.
Closes #45
Fase
F6
Verifica
scripts/build.shverdescripts/test.sh --skip-slowverde: 208 su 208strings.csv: solo righe aggiunte (51)docs/STATE.md,ARCHITECTURE.mdaggiornati, ADR 0023🤖 Generated with Claude Code