Files
Rail_Enterprise/client/RailEnterprise.Client/scripts/Tutorial/TutorialSettings.cs
T
Alby96andClaude Opus 5.5 ebe4308e75 F6: tutorial guidato della prima partita
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>
2026-11-08 14:21:12 +01:00

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}");
}
}