Alby96andClaude Opus 5.5 e57231b15a
CI / Build e test (pull_request) Successful in 3m12s
CI / Immagine Docker (pull_request) Successful in 37s
Rilascio: soluzione del client per l'esportazione Godot, versione 0.5.1
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>
2026-11-07 11:52:14 +01:00

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.

Linea con ponte nel client

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 godot nel 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 su main — 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.0 pubblica la release con il gioco per Windows, i server e SHA256SUMS, e l'immagine Docker :<versione> (:latest per le versioni stabili).
  • Nightly (.gitea/workflows/nightly.yml): immagine :nightly da main ogni 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 vincolante
  • docs/GDD.md — design del gioco
  • docs/ARCHITECTURE.md — architettura del codice
  • docs/PROTOCOL.md — protocollo di rete
  • docs/STATE.md — stato dei lavori
  • docs/adr/ — decisioni architetturali
  • Wiki — guida del giocatore e schermate
S
Description
Videogioco di treni con focus sulla crescita della propria impresa con una avanzata gestione economica
Readme
8.6 MiB
0 Stars 1 Watchers 0 Forks
2026-11-15 13:58:29 +01:00
Languages
C# 99.7%
Shell 0.2%