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>
44 lines
1.5 KiB
C#
44 lines
1.5 KiB
C#
using Godot;
|
|
|
|
namespace RailEnterprise.Client.Tutorial;
|
|
|
|
/// <summary>
|
|
/// Stato del tutorial nelle impostazioni del client (<c>user://settings.cfg</c>, sezione <c>tutorial</c>):
|
|
/// se il giocatore ha già aperto una partita (la casella «Mostra il tutorial» è attiva solo alla prima)
|
|
/// e l'avanzamento di ogni partita, con la chiave di <see cref="TutorialProgress.GameKey"/>.
|
|
/// </summary>
|
|
public static class TutorialSettings
|
|
{
|
|
private const string Path = "user://settings.cfg";
|
|
private const string Section = "tutorial";
|
|
|
|
/// <summary>Vero dopo la prima partita aperta.</summary>
|
|
public static bool Played
|
|
{
|
|
get => (bool)Load().GetValue(Section, "played", false);
|
|
set => Write(cfg => cfg.SetValue(Section, "played", value));
|
|
}
|
|
|
|
public static TutorialProgress? Read(string gameKey) =>
|
|
TutorialProgress.Decode((string)Load().GetValue(Section, gameKey, ""));
|
|
|
|
public static void Save(string gameKey, TutorialProgress progress) =>
|
|
Write(cfg => cfg.SetValue(Section, gameKey, progress.Encode()));
|
|
|
|
private static ConfigFile Load()
|
|
{
|
|
var cfg = new ConfigFile();
|
|
cfg.Load(Path);
|
|
return cfg;
|
|
}
|
|
|
|
private static void Write(Action<ConfigFile> change)
|
|
{
|
|
// si rilegge il file ogni volta: le altre impostazioni (lingua) restano com'erano
|
|
var cfg = Load();
|
|
change(cfg);
|
|
var error = cfg.Save(Path);
|
|
if (error != Error.Ok) GD.PushWarning($"Impostazioni del tutorial non salvate: {error}");
|
|
}
|
|
}
|