Dal livello che sblocca il commercio la compagnia può comprare e vendere merci in proprio. Così può fare arbitraggio tra un produttore con il magazzino pieno e un consumatore a secco anche dove il vettore non ha contratti. Le regole sono nell'ADR 0016. - Ogni stazione della compagnia ha un magazzino: 500 unità e una giacenza di 25 centesimi per unità al mese, in balance.json, blocco «trading». La merce in magazzino rientra nell'invariante delle merci. - BuyGoods compra al prezzo locale marginale dell'ADR 0004, unità per unità, partendo dal più economico, dai produttori del bacino e dagli hub. La merce presa dagli hub conta come importata. - SellGoods vende ai consumatori del bacino partendo dal prezzo più alto, entro lo spazio libero e la cassa di ciascuno. Vende anche agli hub, e quella merce conta come esportata. - Il denaro di entrambi i comandi passa dal registro, sulla voce «Commercio». - ShipGoods (comando 40) spedisce la merce propria come pacchetto senza tariffa né consumatore. Il pacchetto entra nel magazzino di destinazione, che riserva lo spazio alla partenza. Il percorso dei pacchetti già esistenti non cambia: l'accettazione F4 dà ancora 35/20 guasti senza la linea e 75/2 con la linea. - Il salvataggio passa al corpo versione 4 (TradingSerializer). I salvataggi più vecchi si caricano con i magazzini vuoti, e i magazzini entrano nell'hash di stato. - MarketReport porta i magazzini nel blocco 1. Il Mercato globale ha il riquadro «Compravendita in proprio». - Le IA non commerciano ancora. Refs #31. 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
