Files
Rail_Enterprise/docs/GDD.md
T
Alby96andClaude Opus 5.5 c1a0049bcf
CI / Build e test (pull_request) Successful in 1m20s
CI / Immagine Docker (pull_request) Successful in 37s
Infrastruttura: nome «Rail Enterprise», CI e rilasci su Gitea, documentazione
Il progetto adotta il nome «Rail Enterprise» ovunque (codice RailEnterprise.*,
variabili RE_*, intestazioni RESV/RECL, immagine rail-enterprise-server) per
allinearsi al repository Gitea. Aggiunge Gitea Actions sul modello di Chronos:
CI su PR e main, rilascio da tag con gioco Windows (client Godot + server in
server/), server Windows/Linux e immagine Docker nel registro Gitea, nightly.
Aggiunge i riferimenti visivi 06–09, i modelli di PR e issue, l'ADR 0014 e
aggiorna README (comandi locali), STATE e CLAUDE.md. 120 test verdi.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-07 11:14:54 +01:00

8.0 KiB
Raw Blame History

Rail Enterprise — Game Design Document

Documento di design vivo. Le regole numeriche vincolanti sono in docs/GUIDA.md e i valori in data/*.json; qui si descrive che gioco è e perché le regole sono fatte così.

1. Visione

«Rail Enterprise» è un gestionale ferroviario visto rigorosamente dall'alto, ambientato in una regione europea immaginaria a partire dal 1850. Il giocatore guida una compagnia che costruisce binari veri (pendenze, trincee, ponti, gallerie), compra e mantiene treni, porta merci alle industrie e lavoratori ai posti di lavoro, compete con compagnie controllate dall'IA e, se vuole, le compra in borsa. Il mondo non finisce mai: regioni nuove, ere tecnologiche, decadenza delle opere e concorrenti rinnovati mantengono sempre qualcosa da fare.

Pilastri:

  1. Il territorio conta. Ogni tracciato è un compromesso tra costo, tempo di costruzione e prestazioni: la collina si aggira, si taglia in trincea o si buca in galleria; il fiume si attraversa dove è stretto.
  2. Un'economia che si muove da sola. Prezzi globali e locali, industrie che crescono o chiudono, città che migrano verso il servizio migliore. La ferrovia è il sistema circolatorio: dove arriva, il territorio fiorisce.
  3. Le persone sono un carico. Ogni industria ha bisogno di lavoratori e personale qualificato che vivono in città precise e vanno portati al lavoro ogni giorno.
  4. Le macchine invecchiano. Treni e impianti si usurano per componente; la manutenzione richiede ricambi che viaggiano in treno, depositi, personale e una politica.
  5. Leggibilità prima dell'effetto. La mappa è una carta: impronte chiare, palette sobria, ogni numero ha un tooltip che spiega il «perché».

2. Ciclo di gioco

  • Minuto per minuto: osservare i treni, intervenire su colli di bottiglia (segnali, raddoppi, locomotive), rispondere agli avvisi di manutenzione.
  • Giorno per giorno: il resoconto giornaliero (cassa, prezzi, eventi) suggerisce opportunità: un prezzo in rialzo, un'industria senza lavoratori, un deposito senza ricambi.
  • Mese per mese: nuove linee, nuovi treni, contratti di pendolarismo, la «Cronaca» con le notizie del mese; le IA pianificano.
  • Anno per anno: livelli della compagnia, ere tecnologiche, rinnovi di binari e ponti, concessioni, borsa e scalate.

3. Tempo (convenzione del genere)

Il tempo di calendario scorre a 240 tick al giorno (12 secondi reali a velocità 1×). I treni seguono un orologio proprio, 60 volte più rapido del tempo reale: un secondo reale è un minuto di marcia. Ne segue che un viaggio di 30 minuti di orologio dura 2,5 giorni di calendario. È la stessa convenzione di Transport Tycoon e Railway Empire: il calendario serve all'economia (produzioni mensili, crescita trimestrale, ere), l'orologio dei treni serve alla fisica e agli orari. Le soglie di pendolarismo (60 minuti per i lavoratori, 90 per il personale) sono espresse in minuti di orologio dei treni.

Velocità di gioco: pausa, 1×, 2×, 4×, 8×. In multigiocatore la velocità è decisa dal server.

4. Mappa

  • Regione quadrata di 64, 128 o 256 km con celle da 100 m, generata da un seme: colline e catene montuose con creste credibili (rumore di valore con dominio deformato), fiumi che scendono al mare allargandosi, laghi nelle conche, foreste sui pendii, paludi nelle pianure fluviali, giacimenti di carbone, ferro, pietra e petrolio con riserve finite.
  • Città su pianura vicino all'acqua, a non meno di 6 km l'una dall'altra; industrie primarie sui giacimenti, di trasformazione tra materie prime e città, manifatturiere accanto alle città.
  • Almeno un porto (hub verso il mercato mondiale) e un valico di frontiera.

5. Economia

  • Beni: materie prime (carbone, minerale di ferro, pietra, petrolio, tronchi, grano, bestiame), semilavorati (acciaio, legname, carburante, materiali edili), prodotti finiti (alimentari, merci varie, attrezzi) e beni di servizio (ricambi e macchinari) indispensabili alla manutenzione.
  • Prezzi: ogni bene ha un prezzo globale che reagisce lentamente al rapporto tra domanda e offerta della regione e a un ciclo mondiale con shock; ogni nodo ha un prezzo locale entro ±40 % del globale secondo lo squilibrio locale. Gli hub comprano e vendono al prezzo mondiale con un dazio.
  • Industrie: producono secondo la copertura minima tra input, lavoratori e personale, corretta dal margine economico e dalla condizione degli impianti. Crescono di livello se servite bene, regrediscono e chiudono se abbandonate; dove un bene resta insoddisfatto a lungo ne nasce una nuova.
  • Città: crescono con la soddisfazione (beni consegnati rispetto alla domanda) e l'occupazione; chi è mal servito emigra verso città meglio collegate.
  • Compagnia: incassa tariffe per merci e passeggeri (in funzione di distanza, prezzo del bene e puntualità), paga costruzione, manutenzione, personale e interessi. Rating di credito, prestiti, livelli che sbloccano strumenti (squadre di cantiere, commercio, acquisto di industrie, borsa, scalate, concessioni).

6. Costruzione

Il giocatore traccia una polilinea; il motore campiona il terreno ogni 25 m, calcola il profilo con il minimo movimento terra che rispetta la pendenza massima della trazione e classifica ogni tratto come sede naturale, rilevato, trincea, ponte o galleria. Ogni opera ha costo e tempo; le squadre di cantiere costruiscono in ordine lungo la linea. Le ere sbloccano ponti più lunghi e gallerie più profonde. L'anteprima nel client usa le stesse classi del server e mostra il grafico del profilo prima della conferma.

7. Pendolarismo

Ogni città ha una forza lavoro (40 % degli abitanti) e, se abbastanza grande e servita, personale qualificato (8 %). Ogni mese l'abbinatore crea contratti casa-lavoro sui percorsi della rete entro i tempi massimi; ogni giorno i contratti generano pacchetti di passeggeri e il vettore incassa per ogni tratta completata. La copertura dei posti di lavoro entra direttamente nell'efficienza delle industrie e nella velocità delle officine della compagnia. Il tratto a piedi è ammesso solo dentro il bacino di una stazione o tra città e posto di lavoro vicinissimi.

8. Manutenzione

Treni e industrie si usurano per componente. Il pianificatore predittivo manda i treni in deposito prima che un componente scenda sotto la soglia, scegliendo il deposito con ricambi e stalli liberi. Senza ricambi (che arrivano solo in treno) gli interventi aspettano e i guasti crescono; senza personale qualificato le officine rallentano. Le industrie non rifornite di ricambi e macchinari decadono: chi trasporta ricambi controlla la salute del territorio.

9. Concorrenza e finanza

Le compagnie IA giocano con gli stessi comandi e gli stessi vincoli del giocatore, con personalità diverse (espansiva, prudente, predatoria). Ogni compagnia ha un milione di azioni; quotazione, dividendi, scalate ostili e difese (riacquisto, dividendo straordinario, cavaliere bianco). Se il giocatore viene comprato, la difficoltà decide se continua in amministrazione controllata o se la partita finisce con la «Cronaca finale».

10. Gioco infinito

Regioni acquistabili ai bordi, ere senza fine con generazioni di veicoli, decadenza e rinnovo di ogni opera, giacimenti che si esauriscono, concorrenti finanziati dallo stato e antitrust, bandi e grandi opere, prestigio e dinastia, modalità holding e Nuova partita+. Lo stato «ho comprato tutto» non è stabile: il mondo lo erode.

11. Difficoltà

Quattro preset (Apprendista, Imprenditore, Magnate, Ferro e sangue) più Personalizzata. La difficoltà cambia capitale, credito, costi, tariffe, usura, volatilità, numero e forza delle IA, regole di scalata e bancarotta; non cambia mai i vincoli fisici.

12. Presentazione

  • Vista dall'alto, nessuna prospettiva (immagini reference/01–05).
  • Interfaccia scura blu-ardesia con un solo accento ambra; mappa chiara cartografica.
  • Titoli in Big Shoulders Display 800, testo e numeri in IBM Plex Sans con cifre tabulari, separatore delle migliaia con punto e decimali con virgola (₤ 1.284.500).
  • Testi in italiano con localizzazione inglese.