Il gioco desktop di v0.5.0 si avviava senza codice C# perché Godot esporta gli assembly .NET solo se trova la soluzione del client, che non era nel repository. Aggiunge RailEnterprise.Client.sln con le configurazioni di esportazione, fa fallire il rilascio se mancano gli assembly, porta la versione di sviluppo a 0.5.1 e indica nel modello di PR le parole chiave inglesi che Gitea usa per chiudere le issue. 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
