# Conflicts: # client/RailEnterprise.Client/assets/i18n/strings.csv # client/RailEnterprise.Client/scripts/Main.cs # client/RailEnterprise.Client/scripts/Screens/MenuScreen.cs # docs/ARCHITECTURE.md # docs/PROTOCOL.md # docs/STATE.md # src/RailEnterprise.Protocol/Client/ClientWorld.cs
30 KiB
Rail Enterprise — Protocollo di rete
Stato: normativo da F3. Ogni messaggio e ogni comando ha un test di round-trip
(tests/RailEnterprise.Tests/Protocol/ProtocolTests.cs); decisioni in ADR 0009.
1. Trasporto
- WebSocket su
ws://<host>:<porta>/ws(TLS a carico del reverse proxy:wss://). - Solo messaggi binari. Un messaggio WebSocket contiene esattamente un frame.
- Porta predefinita 7400 (
RE_PORT). Il primo messaggio del client dev'essereHelloentro 10 s.
2. Frame
offset tipo campo
0 u32 length lunghezza di messageId + payload (byte)
4 u16 messageId identificativo stabile del messaggio
6 ... payload corpo serializzato a mano
- Little endian. Dimensione massima 4 MB: frame più grandi chiudono la connessione (1009).
SpanWriter/SpanReaderconWrite(ref SpanWriter)/Read(ref SpanReader)per ogni messaggio.
Tipi elementari
| Tipo | Codifica |
|---|---|
bool |
1 byte, 0 o 1 (altri valori: errore) |
u8/u16/u32/u64, i16/i32/i64 |
little endian a larghezza fissa |
varuint |
LEB128 (lunghezze e conteggi) |
f32/f64 |
IEEE 754 little endian |
string |
varuint lunghezza in byte + UTF-8 |
bytes |
varuint lunghezza + byte |
Money |
i64 centesimi |
Vec2 |
due f64 (metri) |
| identità | i32 (−1 = nessuna) |
| liste | varuint conteggio + elementi |
flags |
u8 di estensione in coda a ogni messaggio e record (0 oggi) |
Evoluzione
- Gli id dei messaggi, dei comandi e l'ordine dei campi non cambiano mai.
- I campi nuovi si aggiungono in coda, dopo il byte
flags, che dice quali blocchi seguono. Un lettore vecchio ignora i byte residui; un messaggio vecchio senzaflagsvale 0. protocolVersion(oggi 1) cresce solo per modifiche incompatibili.- Blocchi: il bit 0 di
flagsannuncia il blocco 1 (campi della fase F4), i bit successivi i blocchi delle fasi future. Messaggi e comandi nuovi prendono id nuovi; un lettore vecchio scarta i messaggi che non conosce.
3. Handshake
Client → Hello { protocolVersion: u16, clientVersion: string, token: string, resumeSessionId: u64, dataHash: u64 }
Server → Welcome { sessionId: u64, summary: WorldSummary, dataHash: u64, difficulty: string }; blocco 1 (F6): server: ServerInfo
| Reject { code: u16, reason: string }
resumeSessionId≠ 0 riprende una sessione disconnessa da meno di 120 s (stato rimandato per intero).dataHash≠ 0 deve coincidere con l'hash dei dati del server.- Codici di
Reject: 1 versione del protocollo, 2 token errato, 3 dati diversi, 4 server pieno, 5 nessuna partita. Welcomepuò arrivare di nuovo durante la sessione (nuova partita o caricamento): il client azzera la copia del mondo.- Blocco 1 del
Welcome(F6, ADR 0021): stato del server per la schermata di connessione (immagine 09), calcolato all'invio delWelcome.
ServerInfo { version: string (versione del server), os: string (sistema operativo), container: bool (in Docker), uptimeSeconds: i64 (da quando il processo è attivo), tickMs: f32 (passo del ciclo di gioco: 1000 / tickMs tick al secondo), sessions: i32 (client collegati, compreso chi riceve il messaggio), maxSessions: i32, local: bool (server figlio del gioco) }. La latenza non viaggia: il client la misura con Ping/Pong.
WorldSummary { seed: u64, sizeKm: i32, startYear: i32, tick: i64, date: string, companyId: i32, companyName: string, regionId: string, widthCells: i32, heightCells: i32, cellSizeM: f64, chunkCells: i32, speed: u8, terrainHash: u64, costMultiplier: f64 }
4. Messaggi Client → Server
| id | Nome | Contenuto |
|---|---|---|
| 1 | Hello | vedi handshake |
| 2 | Ping | nonce: u64 |
| 3 | Subscribe | x0, y0, x1, y1: i32 (celle, estremi inclusi), lod: u8 |
| 4 | Command | seq: u32, type: u16, payload: bytes (vedi sotto) |
| 5 | SetSpeed | speed: u8 (0, 1, 2, 4, 8) |
| 6 | ListSaves | — |
| 7 | Save | name: string |
| 8 | Load | saveId: string |
| 9 | NewGame | seed: u64, sizeKm: i32, startYear: i32 (0 = predefinito), difficultyPreset: string, overrides: [(key: string, value: f64)], endlessFlags: u32 |
| 10 | RequestDetail | kind: u8 (1 cartella di manutenzione di un treno, 2 registro officina di un deposito, 3 registro degli impieghi; dalla F5: 4 scheda di una compagnia, 5 scheda di un'industria, 6 Cronaca; dalla F6: 7 quadro del mercato globale, 8 quadro della scalata, 9 quadro delle finanze, 10 quadro del rinnovo della flotta), target: i32 (id del treno, del deposito, della compagnia o dell'industria; ignorato per 3, 6, 7, 8, 9 e 10). Aggiunto in F4 |
Comandi (Command.type, payload in ordine)
| type | Comando | Payload |
|---|---|---|
| 1 | BuildTrack | polyline: [Vec2], heightOffsetM: f64, allowBridges: bool, allowTunnels: bool, trackClass: string, doubleTrack: bool, electrified: bool, expectedCostCents: i64 (0 = non verificare) |
| 2 | RenewTrack | edge: i32 |
| 3 | UpgradeTrack | edge: i32, trackClass: string, doubleTrack: bool, electrified: bool |
| 4 | Demolish | target: u8 (0 arco, 1 stazione, 2 deposito, 3 segnali), id: i32 |
| 5 | BuildStation | position: Vec2, platforms: i32, name: bool + string |
| 6 | BuildDepot | position: Vec2, size: string, name: bool + string |
| 7 | PlaceSignal | edge: i32, positionM: f64 |
| 8 | BuyVehicle | vehicleType: string, depot: i32, count: i32 |
| 9 | SellVehicle | vehicle: i32 |
| 10 | ComposeTrain | depot: i32, vehicles: [i32], name: bool + string |
| 11 | CreateLine | name: string, color: string, stops: [LineStop] |
| 12 | EditLine | line: i32, stops: [LineStop], name: bool + string |
| 13 | AssignTrain | train: i32, line: i32 (−1 = togli dal servizio) |
| 14 | SendToDepot | train: i32, depot: i32 |
| 15 | SetReserve | train: i32, reserve: bool |
| 16 | SetMaintenancePolicy | scope: u8 (0 compagnia, 1 linea, 2 treno), target: i32, policy: string |
| 17 | ScheduleService | train: i32, intervention: string (id di maintenance.json; dalla F6 anche «renewal», il rinnovo dei veicoli superati: in officina si vendono e si sostituiscono con il successore consigliato, ADR 0020) |
| 18 | OrderParts | depot: i32, quantity: i32; blocco 1 (F5): industry: i32 (ricambi ordinati per un'industria posseduta, oltre la scorta della politica) |
| 19 | TakeLoan | amount: Money |
| 20 | RepayLoan | loan: i32, amount: Money |
| 21 | AcceptAgreement | agreement: i32 |
| 22 | RejectAgreement | agreement: i32 |
| 23 | BuyGoods | station: i32, good: string, units: i32, maxUnitPrice: Money |
| 24 | SellGoods | station: i32, good: string, units: i32, minUnitPrice: Money |
| 25 | BuyIndustry | industry: i32, offer: Money |
| 26 | SetIndustryPolicy | industry: i32, budget: u8 (0 nessuno, 1 base, 2 alto) |
| 27 | OverhaulIndustry | industry: i32 |
| 28 | UpgradeIndustry | industry: i32 |
| 29 | Ipo | floatShare: f64 |
| 30 | BuyShares | company: i32, shares: i64, maxPrice: Money |
| 31 | SellShares | company: i32, shares: i64, minPrice: Money |
| 32 | PayDividend | perShare: Money |
| 33 | LaunchBid | target: i32, pricePerShare: Money, targetShare: f64 |
| 34 | RespondBid | bid: i32, accept: bool; blocco 1 (F5): defense: u8 (0 nessuna, 1 riacquisto, 2 dividendo straordinario, 3 cavaliere bianco), knight: i32 |
| 35 | BuyConcession | region: i32 |
| 36 | AcceptContract | contract: i32 |
| 37 | FundResearch | project: string, amount: Money |
| 38 | DelegateRegion | region: i32, objective: string, budget: Money |
| 39 | MergeCompany | subsidiary: i32 — fusione di una controllata dopo 360 giorni di controllo (aggiunto in F5) |
| 40 | ShipGoods | from: i32, to: i32, good: string, units: i32 — spedizione di merce propria tra due magazzini della compagnia (aggiunto in F6, ADR 0016) |
LineStop { station: i32, load: bool, unload: bool, waitFull: bool, maxWaitDays: i32 }. Ogni payload termina con flags.
I codici coincidono con l'enum CommandType di Core. Dalla F4 i comandi 15–18 e 21–22 sono attivi
(policy: economy, standard, thorough, oppure inherit per togliere l'eccezione di linea o
treno; intervention: inspection, service, overhaul; OrderParts fissa la scorta desiderata
del deposito). Dalla F5 sono attivi anche 25–34 e 39 (industrie, borsa, offerte, fusioni; LaunchBid su
una compagnia fallita è un'offerta all'asta degli attivi: prezzo per azione × azioni). Dalla F6 sono attivi
23–24 e 40 (compravendita in proprio dal livello che sblocca trading: si compra dal più economico e si vende
al più caro nel bacino della stazione, entro maxUnitPrice/minUnitPrice per unità; ADR 0016). Fino alla
loro fase i comandi 35–38 rispondono NotImplemented. Il server imposta l'emittente in base alla sessione.
5. Messaggi Server → Client
| id | Nome | Contenuto |
|---|---|---|
| 101 | Welcome | vedi handshake |
| 102 | Reject | vedi handshake |
| 103 | Pong | nonce: u64, serverTick: u64 |
| 110 | MapChunk | cx, cy, width, height: i32, compression: u8 (1 = Brotli), data: bytes = altezze u16 (dm) + tipi u8 + larghezza fiumi u8 |
| 111 | EntitySnapshot | tick: i64, EntityLists |
| 112 | EntityDelta | tick: i64, EntityLists (nuovi o cambiati), removed: [(type: u8, id: i32)] |
| 113 | TrackWorks | edges: [EdgeInfo], removed: [i32] (lotti sotto 1 MB) |
| 114 | TrainMotion | trainId: i32, tick: i64, state: u8, condition: f32, speed: f32 (m/s), lengthM: f32, headDistance: f64, segments: [(edge: i32, forward: bool, fromS: f64, toS: f64)] |
| 120 | DailyDigest | day: i64, tick: i64, date: string, cash: Money, netWorth: Money, rating: string, prices: [Money], events: [EventInfo], stateHash: u64, slow: bool, speed: u8, tickMs: f32; blocco 1 (F6): worldEvents: [WorldEventInfo] (eventi del mondo in corso su tutta la mappa, solo se ce ne sono; ADR 0017) |
| 121 | MaintenanceAlert | train: i32, depot: i32, component: string, condition: f32, dueDays: i32, text: string |
| 122 | EmploymentReport | day: i64, rows: [EmploymentRow]; blocco 1: agreements: [AgreementInfo] (mensile, su richiesta e dopo Accept/RejectAgreement) |
| 123 | MarketTape | day: i64, shares: [SharePrice], bids: [BidInfo] |
| 124 | MaintenanceCard | train, day: i64, condition: f32, status: u8, policy: u8, policyOverride: u8, reserve, failure: u8, failedVehicle, failedComponent: string, rescueHours: f32, nextIntervention: string, nextDueDays: f32, plannedIntervention: string, maintenanceDepot, serviceKmPerDay: f32, costThisYear: Money, costLastYear: Money, failuresThisYear, failuresTotal, coveredBy, covering, vehicles: [VehicleCard], history: [MaintenanceRecordInfo] (su richiesta, F4) |
| 125 | WorkshopRegister | depot, day: i64, stalls, jobsStaff, staffPresent: f32, workRate: f32, spareParts, partsTarget, partsReserved, jobs: [WorkshopJobInfo], booked: [WorkshopJobInfo] (su richiesta, F4) |
| 126 | CompanyCard | company, totalShares: i64, treasury: i64, holdings: [HoldingInfo], priceHistory: [f64] (centesimi, mensile), history: [CompanyYearInfo], annualProfit, dividendsYear, debt, marketCap: Money, controlDays: i64, auctionMin, auctionBest: Money, auctionBestBidder, auctionEndDay: i64 (su richiesta, F5) |
| 127 | IndustryCard | industry, margin, conditionMultiplier, wearPerDay, recoveryPerDay: f32, maintenanceCostPerDay, maintenanceSpentYear: Money, partsTarget, partsPerMonth, partsOrdered, machineryRequired, upgradeCost, valuation, cash: Money, breakdownChancePerYear: f32, stops: [IndustryStopInfo] (su richiesta, F5); blocco 1 (F6): sheet: IndustrySheetInfo, la scheda dell'immagine 07 calcolata dal Core (IndustryOutlook) per la compagnia della sessione (ADR 0021) |
| 128 | Chronicle | gameOver: bool, reason: u8 (1 fallimento, 2 scalata, 3 riscatto scaduto), text, winner, day: i64, company, foundedYear, prestige: i64, history: [CompanyYearInfo], records: [RecordInfo], highlights: [string] (alla fine della partita e su richiesta, F5) |
| 129 | MarketReport | day: i64, index: f32 (100 = prezzi base), indexChange: f32, goods: [GoodMarketInfo], hubs: [HubMarketInfo], eventGood: i32 (−1 nessuno), eventShock: f32 (con segno, frazione del prezzo base), eventMonths: f32, tradingUnlocked: bool, tradingTier: u8, tradingProgress: f32, netWorth, netWorthRequired: Money, townsConnected, townsRequired, townPopulation: i32, rating, ratingRequired: string, ratingMet: bool; blocco 1: warehouses: [WarehouseInfo] (magazzini della compagnia, solo se ne ha; ADR 0016); blocco 2: goodEvents: [WorldEventInfo] (eventi del mondo sulla domanda di un bene, mostrati come «evento in corso»; ADR 0017). I due blocchi sono indipendenti: flags bit 0 e bit 1, in quest'ordine (su richiesta, F6; ADR 0015) |
| 130 | CommandResult | seq: u32, type: u16, error: u16, message: string, created: [i32], tick: i64 |
| 131 | Notification | EventInfo |
| 132 | Newspaper | day: i64, title: string, articles: [(headline: string, body: string)] |
| 133 | SaveList | saves: [SaveInfo] |
| 134 | ClimbReport | day: i64, company: i32, foundedDay: i64, initialCapital: Money, tier: u8, nextTier: u8 (0 all'ultimo livello), tiers: [TierInfo]; requisiti del prossimo livello: netWorth, netWorthRequired: Money, netWorthFraction: f32, netWorthMet: bool, towns, townsRequired, townPopulation: i32, townsFraction: f32, townsMet: bool, rating, ratingRequired: string, ratingFraction: f32, ratingMet: bool, progress: f32 (media delle tre frazioni); stato patrimoniale: assets: [AmountInfo] (kind 0 binari e opere, 1 stazioni e depositi, 2 veicoli, 3 industrie possedute, 4 merce propria), portfolio, cash (positiva), totalAssets, loans: Money, loansRate: f32 (medio), overdraft (scoperto), totalLiabilities, balanceNetWorth: Money (= totalAssets − totalLiabilities = patrimonio netto del motore); conto economico: incomeYear: i32, incomePartial: bool, income: [AmountInfo] (kind 0 tariffe e noli, 1 altri ricavi, 2 costi operativi, 3 manutenzione, 4 interessi; con segno), profit: Money; prestiti: loanList: [LoanInfo], maxLoan, loanAvailable: Money, newLoanRate: f32, loansAllowed: bool; history: [NetWorthPointInfo] (fondazione, fine di ogni anno, oggi) (su richiesta, F6; ADR 0018) |
| 135 | FinanceReport | day: i64, company: i32, cash, netWorth, loans, overdraft: Money; conto economico: lines: [FinanceLineInfo] (voci in ordine di presentazione), columns: [IncomeColumnInfo] (mese in corso, mesi chiusi dal più recente, anno in corso, anni chiusi dal più recente); rating: rating: string, ratingInitial: bool, ratingMonths, revenueMonths: u8, marginNeutral: bool (margine 0 finché la finestra non è piena e ha meno di minRevenueMonths mesi con ricavi), minRevenueMonths: u8, margin, leverage: f32, leverageUnbounded: bool, marginWeight, leverageWeight, marginComponent, leverageComponent, score: f32, thresholds: [RatingThresholdInfo], nextRating: string ("" ad AAA), nextThreshold: f32, nextAlreadyMet: bool (il punteggio basta già: rating scoreRating al prossimo calcolo mensile, obiettivi a zero), scoreRating: string, marginNeeded: f32, marginReachable: bool, leverageMax: f32 (sempre finita), leverageReachable: bool, debtToRepay: Money, repayAffordable: bool (il rimborso non supera la cassa né il residuo dei prestiti; lo scoperto non si rimborsa); prestiti: loanList: [FinanceLoanInfo], maxLoan, loanAvailable: Money, newLoanRate, baseRate, spread: f32, loanTermMonths: i32, loanStep: Money, loansAllowed: bool; bancarotta: negativeCashDays, bankruptcyDays: i32, bankrupt, receivership: bool (su richiesta, F6; ADR 0019) |
| 136 | FleetReport | day: i64, company, year: i32, era, nextEra: string (id di eras.json; nextEra "" all'ultima), nextEraYear: i32 (0 all'ultima), renewalIntervention: string (id per ScheduleService), bookValueTotal: Money (coincide con la voce «veicoli» dello stato patrimoniale), vehicles: [FleetVehicleInfo] (veicoli non venduti della compagnia, per id), models: [VehicleModelInfo] (solo i modelli in produzione nell'anno, nell'ordine di vehicles.json), trains: [RenewalTrainInfo] (treni con veicoli da rinnovare) (su richiesta, F6; ADR 0020) |
Record (ognuno chiude con flags):
EntityLists: liste in quest'ordine diCompanyInfo,TownInfo,IndustryInfo,HubInfo,NodeInfo,StationInfo,DepotInfo,LineInfo,VehicleInfo,TrainInfo.CompanyInfo { id, name, color, isPlayer, cash: Money, netWorth: Money, rating, tier: u8, bankrupt }; blocco 1:maintenancePolicy: u8(0 economica, 1 standard, 2 accurata); blocco 2 (F5):personality: string, listed, sharePriceCents: f64, sentiment: f32, founderShare: f32, controlledBy: i32, merged, receivership, receivershipUntilDay: i64, annualProfit: MoneyTownInfo { id, name, position: Vec2, population: i32, radiusCells: f64, satisfaction: f32, services: i32 }IndustryInfo { id, type: string, name, position, footprintCells: i32, level: i32, closed, efficiency: f32, condition: f32, owner: i32 }; blocco 1 (F5):budget: u8 (0 nessuno, 1 base, 2 alto), spareParts, machinery, stoppedUntilDay: i64, stopKind: u8 (1 guasto, 2 incidente, 3 revisione, 4 ammodernamento), pendingWork: u8 (1 revisione, 2 ammodernamento), partsShort: boolHubInfo { id, kind: string, name, position }NodeInfo { id, position, heightM: f64, owner, station, depot, edges: [i32] }StationInfo { id, owner, name, node, position, platforms: i32, waitingUnits: i32, industries: [i32], towns: [i32] }DepotInfo { id, owner, name, node, position, size: string }; blocco 1:stalls, jobsStaff, staffPercent: u8, spareParts, partsTarget, jobs, waitingParts: boolLineInfo { id, owner, name, color, stops: [LineStop] }; blocco 1:policy: u8(255 = quella della compagnia)VehicleInfo { id, owner, type: string, depot, train, condition: f32 }TrainInfo { id, owner, name, line, state: u8, vehicles: [i32], maxSpeedKmh: f32, lengthM: f32, load: i32, capacity: i32, depot: i32 }; blocco 1:condition: u8(componente più debole),maintenance: u8(0 in servizio, 1 intervento prenotato, 2 in officina, 3 guasto lieve, 4 fermo in linea, 5 rimorchiato),reserve: bool,policy: u8(255 = ereditata),nextIntervention: string,nextDueDays: i32,maintenanceDepot: i32EdgeInfo { id, owner, a, b, trackClass: u8, doubleTrack, electrified, state: u8, condition: f32, structureCondition: f32, progress: f32, samples: [(s, x, y, h, ground: f64, kind: u8, speedLimitKmh: f64)], signals: [f64] }EventInfo { day: i64, kind: u8, severity: u8, text, entity: u8, entityIndex: i32, company: i32 };kind10 = evento del mondo (inizio e fine, F6), 11 = novità tecnologiche dell'anno (era che inizia, modelli introdotti, superati e fuori produzione; F6, ADR 0020);day−1 = avviso del server alla sola sessione che ha chiestoLoadoNewGamee se l'è visto rifiutare (gli eventi del mondo hanno sempre il giorno della partita, ≥ 0)WorldEventInfo { id: i32, type: string (id di events.json), entity: u8 (1 città, 2 industria, 7 deposito), entityIndex: i32, good: i32 (−1 se nessuno), startDay: i64 (dopodayper un evento estratto oggi, che inizia domani), endDay: i64 (primo giorno senza l'evento: il server lo toglie quel mattino), severity: u8, effects: [f32] }:effectssono i moltiplicatori nell'ordine degli effetti del tipo nel catalogo (ADR 0017)EmploymentRow { industry, jobsWorkers, jobsStaff, workersPresent: f32, staffPresent: f32, reason, sources: [EmploymentSource { town, homeStation, line, category: u8, headcount, coverage: f32 }] }; blocco 1:kind: u8(0 industria, 1 deposito:industryè allora l'id del deposito),workersReason: u8,staffReason: u8(0 nessuno, 1 nessuna stazione, 2 nessuna città entro il tempo massimo, 3 nessun lavoratore libero, 4 città senza servizi per il personale, 5 capacità delle carrozze insufficiente),workersReasonLine: i32,staffReasonLine: i32AgreementInfo { id, industry, carrier, seatsPerDay, monthlyFee: Money, state: u8 (0 proposta, 1 attiva, 2 rifiutata, 3 scaduta, 4 saltata, 5 conclusa), proposedDay: i64, startDay: i64, endDay: i64, coverage: f32, shortDays }VehicleCard { vehicle, type: string, odometerKm: f32, ageYears: f32, ageFactor: f32, components: [ComponentCard { component: string, condition: f32, wearPerDay: f32 }] }MaintenanceRecordInfo { day: i64, intervention: string, cost: Money, depot, parts }WorkshopJobInfo { train, intervention: string, inStall, started, progress: f32, days: f32, parts, queuedDay: i64 }SharePrice { company, price: Money, change: f32, listed }; blocco 1 (F5):priceCents: f64, outstanding: i64, freeFloat: i64, founderShare: f32, controlledBy: i32BidInfo { bid, bidder, target, pricePerShare: Money, targetShare: f64, expiresDay: i64 }; blocco 1 (F5):state: u8, committedShare: f64, defenses: u8 (bit per difesa usata), knight: i32, accepted: bool(la compagnia della sessione ha aderito)HoldingInfo { holder: i32 (−1 fondatore, −2 mercato, altrimenti compagnia), shares: i64 },CompanyYearInfo { year, netWorth, cash, revenue, profit: Money, tier: u8, trains, trackKm: f32, sharePrice: Money }IndustryStopInfo { day: i64, days, kind: u8 },RecordInfo { title, value: string, year }SaveInfo { saveId, name, gameDate, sizeBytes: i64, savedUnixMs: i64, autosave }GoodMarketInfo { good, available, price: f64 (centesimi), change: f32 (30 giorni), supplyMonth, demandMonth, worldSupplyMonth, worldDemandMonth, stockUnits: f64, stockMonths: f32 (−1 senza domanda), history: [PricePointInfo { day: i64, price: f64 }] (un campione per mese, l'ultimo è oggi), forecast: [ForecastInfo { months: u8, price, low, high: f64 }], sellPlaces: [SellPlaceInfo { kind: u8 (0 industria, 1 hub), target, price: f64, line: i32 (−1 non collegato) }] }TierInfo { level: u8, nameIt, nameEn: string, netWorthRequired: Money, townsRequired, townPopulation: i32, ratingRequired: string, reached: bool, reachedDay: i64 (fondazione per il livello 1; −1 se non raggiunto o sconosciuto), unlocks: [UnlockInfo] };UnlockInfo { kind: u8 (0 fido, 1 squadre di cantiere, 2 compravendita in proprio, 3 acquisto di industrie, 4 quotazione, 5 scalate ostili, 6 concessioni), value: i64 (fido in centesimi o numero di squadre; 0 per gli altri) }: gli sblocchi che il livello aggiunge al precedenteAmountInfo { kind: u8, value: Money },LoanInfo { loan, remaining: Money, annualRate: f32, monthsLeft: i32 },NetWorthPointInfo { day: i64, value: Money }LedgerEntry(voce del registro, u8): 0 FreightRevenue (noli merci), 1 PassengerRevenue (biglietti), 2 Construction (costruzioni), 3 VehiclePurchase (acquisto di treni), 4 VehicleSale (vendita di treni), 5 RunningCosts (esercizio dei treni), 6 TrackMaintenance (manutenzione dei binari), 7 FleetMaintenance (manutenzione dei treni), 8 Wages (stipendi), 9 Interest (interessi), 10 LoanTaken (prestiti ricevuti), 11 LoanRepaid (prestiti rimborsati), 12 Trading (commercio in proprio), 13 IndustryPurchase (acquisto di industrie), 14 Dividends (dividendi pagati), 15 Shares (azioni), 16 Contracts (contratti), 17 Penalties (penali), 18 Other (altro), 19 Industries (industrie possedute), 20 Subsidiaries (controllate), 21 StationUpkeep (stazioni e depositi), 22 Storage (magazzini), 23 Duties (dazi), 24 DividendsReceived (dividendi incassati). Sezione: ricavi 0, 1, 12, 16, 19, 20, 24; costi 5–9, 17, 21–23; investimenti e finanziamenti gli altri (ADR 0019)FinanceLineInfo { kind: u8 (LedgerEntry), section: u8 (0 ricavi, 1 costi, 2 investimenti e finanziamenti) },IncomeColumnInfo { kind: u8 (0 mese in corso, 1 mese chiuso, 2 anno in corso, 3 anno chiuso), year: i32, month: u8 (1–12, 0 per gli anni), values: [AmountInfo] (solo le voci diverse da zero, kind = LedgerEntry, con segno), profit: Money (utile operativo del motore), cashFlow: Money },RatingThresholdInfo { rating: string, minScore, loanRate: f32 },FinanceLoanInfo { loan: i32, principal, remaining: Money, annualRate: f32 (fisso), monthsLeft: i32, payment, nextInterest: Money, maturityDay: i64 }HubMarketInfo { hub, kind: u8 (0 porto, 1 valico), monthlyCapacity, duty: f32, usedThisMonth, line: i32 (−1 non collegato) }FleetVehicleInfo { vehicle: i32, type: string, train, depot: i32 (−1 se nessuno), ageYears: f32, lifeYears: i32, condition: f32 (media dei componenti, 0–1), inProduction, superseded: bool, supersededYear: i32 (0 senza successore), successor: string (consigliato, "" se non superato o senza successore in produzione), bookValue, resale: Money, maintenanceFactor: f32 },VehicleModelInfo { type: string, superseded: bool, supersededYear: i32, successor: string, lastYear: i32 (ultimo anno di produzione, 0 se non previsto) },RenewalTrainInfo { train, vehicles: i32, netCost: Money (successori − rivendite + lavoro, può essere negativa), affordable: bool (la cassa basta al netto degli altri rinnovi prenotati), booked: bool (rinnovo già prenotato, non ancora avviato) }WarehouseInfo { station, capacity, incoming: i32 (merce propria in viaggio verso la stazione), goods: [WarehouseGoodInfo] }(stazioni vive della compagnia)IndustrySheetInfo { level, maxLevel: u8, efficiency: f32, limit: u8 (fattore più basso sotto 1: 0 nessuno, 1 materie prime, 2 lavoratori, 3 personale, 4 redditività, 5 impianti, 6 giacimento, 7 evento, 8 ferma, 9 inattiva), covInput, covWorkers, covStaff: f32 (coperture medie mobili), coverageWindowDays: i32 (finestra delle coperture), profitFactor, depletion, eventCapacity: f32, reserveFraction: f32 (−1 senza giacimento), storageDays: i32, inputs: [IndustryFlowInfo], outputs: [IndustryFlowInfo], workers: WorkforceInfo, staff: WorkforceInfo, salePrice: f64 (prezzo di vendita del prodotto in centesimi: il prezzo globale del giorno, a cui le industrie vendono al mercato, ADR 0004; −1 senza prodotti o con più prodotti), annualProfit: Money (utile annuo stimato dalle medie mobili), lastScore, shipped, coverage, profit, score: f32 (punteggio di crescita del trimestre in corso e componenti), upgradeThreshold, downgradeThreshold: f32, upgradeQuarters, quartersAbove: u8, quarterDay, quarterDays: i32, served: bool (servita da un vettore: solo allora cambia livello), servingStations: [i32], servingLine: i32 (−1 nessuna), forSale, buyUnlocked: bool, buyTier: u8, buyProgress: f32 }IndustryFlowInfo { good: i32, fullMonth: f32 (a piena capacità, unità al mese), currentMonth: f32 (all'efficienza di oggi), stock, storage: i32, days: f32 (ingressi: giorni di scorta; uscite: giorni al magazzino pieno; −1 senza consumo o produzione), limiting: bool (l'ingresso che limita), partners: [ChainPartnerInfo] }ChainPartnerInfo { kind: u8 (0 industria, 1 hub, 2 città), target: i32, monthlyUnits: f32 (produzione o fabbisogno mensile del partner), price: f64 (centesimi: prezzo globale, locale o dell'hub), line: i32 (linea della compagnia con treni che serve entrambi; −1 non collegato), distanceKm: f32 }: fornitori per gli ingressi, clienti per le uscite, prima i collegati poi i più vicini, al massimoindustry.outlook.partnersPerGoodWorkforceInfo { jobs: i32, present: f32, onSite: f32 (persone in sede: posti coperti da chi vive negli alloggi dell'industria), coverage: f32, missing: i32, reason: u8 (comeEmploymentRow), reasonLine: i32, averageMinutes: f32 (−1 senza pendolari in treno visibili), sourceCount: i32, sources: [WorkforceSourceInfo] }(al massimoindustry.outlook.workforceSourcesprovenienze). Come nel Registro degli impieghi, provenienze,sourceCounteaverageMinutescontano solo i contratti a piedi, quelli trasportati dalla compagnia della sessione e, se l'industria è sua, quelli di tutti i vettoriWorkforceSourceInfo { town, headcount: i32, coverage: f32, line: i32, carrier: i32, minutes: f32, walking: bool }WarehouseGoodInfo { good, units: i32 (in magazzino), buyPrice: f64 (centesimi, prossima unità; −1 nessun venditore), buyUnits: i32, sellPrice: f64 (−1 nessun compratore), sellUnits: i32 }(beni in magazzino o scambiabili nel bacino)
6. Flusso e interest management
- Dopo il
Welcomeil server mandaEntitySnapshote tutti iTrackWorks; i chunk arrivano dopo il primoSubscribe(viewport con un chunk di margine), una volta per sessione, e si rimandano se cambiano. EntityDeltaeTrackWorksincrementali dopo ogni comando riuscito e a ogni cambio di giorno.TrainMotionogni 100 ms per i treni in moto con la testa nel viewport (più un chunk), una volta per quelli fermi: al massimo 10 aggiornamenti al secondo per treno. Il client avanza la testa a velocità costante tra un moto e l'altro (fattore 60: un tick = 3 s di orologio dei treni).DailyDigesteMarketTape(listino delle compagnie attive e offerte in corso) a ogni giorno;EmploymentReporta ogni mese;Notificationper gli eventi non informativi della compagnia della sessione;MaintenanceAlertquando un treno scende sotto le soglie d'avviso (40) o critica (30) e quando un'officina resta senza ricambi.- Dettagli su richiesta (F4):
MaintenanceCard,WorkshopRegisteredEmploymentReportrispondono aRequestDetailper entità della compagnia della sessione (le richieste per entità altrui o inesistenti non hanno risposta). Il client li richiede mentre il pannello è aperto (una volta al secondo): i componenti di tutti i veicoli non viaggiano nei delta delle entità. Dalla F5 ancheCompanyCard(qualunque compagnia),IndustryCard(qualunque industria aperta) eChronicle; la Cronaca arriva da sola, una volta per sessione, quando la partita del giocatore finisce. Dalla F6MarketReport(quadro del mercato globale per la compagnia della sessione), che il pannello chiede all'apertura e a ogni nuovo giorno; il server non lo manda da solo. Così ancheClimbReport(quadro della scalata), che il pannello chiede all'apertura, a ogni nuovo giorno e dopo un prestito, e la barra superiore una volta al mese, eFinanceReport(quadro delle finanze), che il pannello «Finanze» chiede all'apertura, a ogni nuovo giorno e dopo un prestito o un rimborso, eFleetReport(quadro del rinnovo della flotta), che i pannelli Treni e Officine chiedono all'apertura, a ogni nuovo giorno e dopo i loro comandi. - Backpressure: i moti si scartano oltre 256 KB in coda; oltre 64 MB di messaggi affidabili la sessione si chiude (il client può riprenderla).
- Obiettivo di banda in regime: < 100 KB/s per client.