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>
Rail Enterprise
Gestionale ferroviario visto dall'alto, ambientato dal 1850 in una regione immaginaria: binari con pendenze, trincee, ponti e gallerie; economia con prezzi globali e locali; pendolarismo di lavoratori e personale; manutenzione per componente di treni e industrie; concorrenti IA, borsa e scalate; un mondo che non finisce mai.
Il motore di gioco è headless e deterministico (C# su .NET 10) e gira sia dentro il gioco desktop (client Godot 4 .NET, che avvia un server locale) sia come server Linux in Docker.
Scaricare
Ogni versione è sulla pagina Release:
| File | Per |
|---|---|
RailEnterprise-<versione>-windows-x64.zip |
il gioco desktop: estrai e avvia RailEnterprise.exe («Partita locale» avvia il server in server/) |
RailEnterprise-Server-<versione>-windows-x64.zip / -linux-x64.tar.gz |
il server senza Docker |
immagine gitea.encke-hake.ts.net/balbosoft/rail-enterprise-server:<versione> |
il server in Docker / Unraid |
Requisiti per lo sviluppo
- .NET SDK 10.x (
dotnet --version) - Godot 4.7 .NET come
godotnel PATH (solo per avviare o esportare il client) - Docker (solo per l'immagine del server)
Compilare e provare
scripts/build.sh # controllo "zero NuGet" + build Release
scripts/test.sh # validazione dei dati + tutti i test
scripts/test.sh --skip-slow # senza i test di accettazione pluriennali
Su Windows (PowerShell): ./scripts/build.ps1 -Test.
Avviare in locale
Server da sorgente (porta 7400, token prova, salvataggi in ./dati-locali):
dotnet run --project src/RailEnterprise.Server -c Release -- --port 7400 --token prova --data ./dati-locali
Poi http://localhost:7400/health e http://localhost:7400/metrics. Con --local il server sceglie una porta libera e stampa LISTENING <porta> (è il modo in cui lo avvia il client).
Server in Docker (dalla radice del repository):
docker compose -f docker/docker-compose.yml up -d --build
Variabili: RE_TOKEN (obbligatoria in rete), RE_DIFFICULTY, RE_SEED, RE_MAP_SIZE, RE_DATA_DIR (default /data), RE_AUTOSAVE_MIN, RE_TICK_MS, RE_LOG_LEVEL.
Client Godot:
dotnet build src/RailEnterprise.Server -c Release
dotnet build client/RailEnterprise.Client/RailEnterprise.Client.csproj
godot --path client/RailEnterprise.Client
Dal menu, «Partita locale» avvia il server compilato (src/RailEnterprise.Server/bin/Release/... oppure RE_SERVER_PATH); «Connetti a un server» usa indirizzo e token di un server già avviato.
Collaudi senza mani:
dotnet run --project src/RailEnterprise.Tools -- smoke --url ws://127.0.0.1:7400/ws --token prova
GODOT=/percorso/godot scripts/client-autopilot.sh
Strumenti
dotnet run --project src/RailEnterprise.Tools -- <comando>: validate-data, genmap, profile, simulate, bench, smoke, replay (vedi la Wiki).
Struttura
| Cartella | Contenuto |
|---|---|
src/RailEnterprise.Core |
simulazione, dati, mappa, economia, rete ferroviaria, salvataggi |
src/RailEnterprise.Protocol |
protocollo binario su WebSocket |
src/RailEnterprise.Server |
server autorevole (Kestrel) |
src/RailEnterprise.Tools |
railenterprise-tools |
tests/RailEnterprise.Tests |
harness di test interno e scenari |
client/RailEnterprise.Client |
client Godot |
data/ |
parametri di gioco in JSON con schema |
docker/ |
Dockerfile, compose, template Unraid |
docs/ |
guida, GDD, architettura, protocollo, stato, ADR, schermate |
reference/ |
immagini di riferimento visivo vincolanti (01–09) |
.gitea/ |
workflow di CI e rilascio, modelli di PR e issue |
CI e rilasci
- CI (
.gitea/workflows/ci.yml): su ogni PR e sumain— zero NuGet, build, dati, test, server per Windows, client, immagine Docker con healthcheck. - Rilascio (
.gitea/workflows/release.yml):git tag v0.6.0 && git push origin v0.6.0pubblica la release con il gioco per Windows, i server eSHA256SUMS, e l'immagine Docker:<versione>(:latestper le versioni stabili). - Nightly (
.gitea/workflows/nightly.yml): immagine:nightlydamainogni notte.
Dettagli in ADR 0014.
Il server parla WebSocket in chiaro: fuori da una rete privata mettilo dietro un reverse proxy con TLS ed esponi solo wss://.
Documentazione
docs/GUIDA.md— specifica operativa vincolantedocs/GDD.md— design del giocodocs/ARCHITECTURE.md— architettura del codicedocs/PROTOCOL.md— protocollo di retedocs/STATE.md— stato dei lavoridocs/adr/— decisioni architetturali- Wiki — guida del giocatore e schermate
