- TrackGeometry: polilinea raccordata con il raggio della classe - TrackPlanner: campioni ogni 25 m, due passate di pendenza, smussatura, franchi sui fiumi, classificazione delle opere, costi, giorni, vincoli per era (campate per classe di fiume, lunghezza delle gallerie) - Scenari a mano (ScenarioLoader) e tests/scenarios/valdoria.json - viaferrea-tools profile; industrie al prezzo globale; servizi di base Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0191R7vXgtbAvSV4V8tj8uzL
Via Ferrea
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 client desktop (Godot 4 .NET) sia come server Linux in Docker.
Requisiti
- .NET SDK 10.x (
dotnet --version) - Godot 4 .NET, versione stabile più recente, come
godotnel PATH (solo per 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
Su Windows: ./scripts/build.ps1 -Test.
Struttura
| Cartella | Contenuto |
|---|---|
src/ViaFerrea.Core |
simulazione, dati, mappa, economia, rete ferroviaria, salvataggi |
src/ViaFerrea.Protocol |
protocollo binario su WebSocket |
src/ViaFerrea.Server |
server autorevole (Kestrel) |
src/ViaFerrea.Tools |
viaferrea-tools: validate-data, genmap, profile, simulate, bench, replay |
tests/ViaFerrea.Tests |
harness di test interno e scenari |
client/ViaFerrea.Client |
client Godot |
data/ |
parametri di gioco in JSON con schema |
docker/ |
Dockerfile, compose, template Unraid |
docs/ |
guida, GDD, architettura, protocollo, stato, ADR |
reference/ |
immagini di riferimento visivo |
Server in Docker
docker compose -f docker/docker-compose.yml up -d
curl http://localhost:7400/health
Variabili principali: VF_TOKEN (obbligatoria in rete), VF_DIFFICULTY, VF_SEED, VF_MAP_SIZE, VF_DATA_DIR (default /data).
Il server parla WebSocket in chiaro: per l'uso fuori da una rete privata mettilo dietro un reverse proxy con TLS (per esempio Caddy, Traefik o Nginx Proxy Manager su Unraid) 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