diff --git a/README.md b/README.md index 3ac1760..e640b74 100644 --- a/README.md +++ b/README.md @@ -13,11 +13,18 @@ Station Master is a railroad operations board game with an authoritative multipl solitaire needs no server and is not what this package is for. This package runs that server — the browser client, the lobby, and the intent/SSE API — as a single StartOS service. -**Bundled version: 0.8.0.9.** The bots that fill empty seats play far better — they plan each switching -turn, stop wasting their draws, and build their districts — and the engine checks moves about three times -faster. **Games in progress on this server resume normally**: no rule changed, and the speed-up was proven -to leave play identical by hashing every event of 32 seeded games before and after each step. The game's -`CHANGELOG.md` has the measurements. +**Bundled version: 0.8.0.10.** Fixes from the first multiplayer playtests: the Superintendent is no +longer asked to rule on a train BEHIND the one departing (which cost a real game a collision), the screen +says whose move it is showing while the board catches up, the history no longer races ahead of it, a +Realignment says which card it converted and flashes it on the map, and a seated player can download their +own game as a save file. v0.8.0.9 before it rebuilt the bot and made the engine about three times faster. + +**GAMES IN PROGRESS DO NOT ALL SURVIVE THIS ONE**, and that is the exception to the rule below rather +than a break in it. A save is the seed and the moves replayed through the CURRENT rules, so correcting +WHEN a ruling is asked for strands a game that holds one the rules no longer ask: the server refuses that +game, logs the move it stopped at, and leaves its file untouched. Measured: 28 of 40 recorded four-seat +games stop, usually 5-40% of the way in. Jesse's call (2026-09-15) was to ship it as is; a game worth +finishing can be finished by putting v0.8.0.9 back. The paragraphs below were written for the 0.7.9.8 bump and still describe how a bump is checked. diff --git a/instructions.md b/instructions.md index 6f5d362..6be9031 100644 --- a/instructions.md +++ b/instructions.md @@ -35,6 +35,27 @@ watches the table — there is nothing else to open. Solitaire runs entirely in your own browser and needs nothing from the server, so it works here exactly as it does on the public Station Master site. +**What changed in 0.8.0.10. GAMES ALREADY RUNNING ON THIS SERVER MAY NOT RESUME** — this update fixes a +rule, and a saved game is replayed through the current rules, so a game that contains a decision the rules +no longer ask for stops at that point. Nothing is deleted: the server says which move it stopped at and +keeps the file, and re-installing 0.8.0.9 lets such a game be played out. + +**The fix is worth it.** The Superintendent was being asked to rule on a train BEHIND the one leaving, +which is nobody's concern — and holding the leaving train kept the only arrival track occupied, so the +train behind arrived into it and was destroyed. A train moving away behind you no longer holds you up +either. + +**Watching other players is clearer.** While your board catches up on everyone else's moves, the screen +names the player whose move you are watching rather than whoever the game is really waiting on, and the +history no longer runs ahead of the board — each line appears as its move is drawn, with Skip still +showing everything at once. The name on the Division map is readable again. A Realignment now says which +card it converted, and that card flashes on the map as it changes. A move made by holding the +Superintendent's office says so, and no line names a player twice. + +**You can save a multiplayer game to a file.** The **Save replay** button on the play screen now works in +multiplayer as well as solitaire, and writes the game to your Downloads folder — the same save the Manage +Game action hands back as text. + **What changed in 0.8.0.9. Games already running on this server are not affected** — they resume normally; no rule changed. diff --git a/startos/versions/current.ts b/startos/versions/current.ts index fc555ae..dd742a4 100644 --- a/startos/versions/current.ts +++ b/startos/versions/current.ts @@ -10,81 +10,104 @@ export const current = VersionInfo.of({ // — checked against the SDK's own parser rather than assumed, since every example in `versions.md` // has three: `0.7.9.8:0` parses to upstream `[0,7,9,8]`, which sorts above `[0,7,9]`, so a box on // 0.7.9:0 sees this as an update rather than refusing it as a downgrade. - version: '0.8.0.9:0', + version: '0.8.0.10:0', releaseNotes: { en_US: - 'Bundles Station Master v0.8.0.9 — the bots play much better, and the server does its work ' + - 'faster. GAMES IN PROGRESS ON THIS SERVER ARE UNAFFECTED and will resume normally: no rule ' + - 'changed. A bot filling an empty seat now plans its whole switching turn before its first ' + - 'move, so it delivers cars to industries that can work them instead of choosing one move at a ' + - 'time, and it brings expedited trains back to the station. It no longer takes face-up cards ' + - 'it cannot play only to throw them back, so it builds its district — more track, more ' + - 'industries, and run-arounds far more often, because it now lays track where it opens up ' + - 'something to do. And it no longer runs a Second Section by accident when it meant to start ' + - 'an Extra, which caused many of its collisions. Measured over thousands of simulated games, a ' + - 'bot now earns about 4.8 Revenue a game, where it earned about −0.3 before. Behind the ' + - 'scenes, working out where a train can move is now done once per position instead of several ' + - 'times, which makes the server about three times faster at checking moves — with play proven ' + - 'identical.', + 'Bundles Station Master v0.8.0.10 — fixes from the first multiplayer playtests. **GAMES IN ' + + 'PROGRESS ON THIS SERVER WILL OFTEN NOT RESUME AFTER THIS UPDATE**, because a rule about when ' + + 'the Superintendent is asked to rule has been corrected, and a saved game is replayed through ' + + 'the current rules: a game holding a ruling the rules no longer ask for stops there. The ' + + 'server says which move it stopped at and leaves the game\u2019s file untouched, so nothing ' + + 'is lost — and putting v0.8.0.9 back lets such a game be finished. The fix: the ' + + 'Superintendent was asked to rule on a train BEHIND the one departing, which is nobody\u2019s ' + + 'concern — it cost a real game a collision, because holding the departing train kept the only ' + + 'arrival track full and the train behind it arrived into it and was destroyed. A train moving ' + + 'away behind you no longer holds you either. Also in this release: while your board is ' + + 'catching up on other players\u2019 moves, the screen now says whose move you are watching ' + + 'instead of naming whoever the game is really waiting on, and the history no longer races ' + + 'ahead of the board — lines appear as their moves are drawn, and Skip still shows everything ' + + 'at once. The name on the Division map is readable again. A Realignment says which card it ' + + 'converted — “Mainline card 3, Curves, converted to Plains” — and the card flashes on the map ' + + 'as it changes. A move made by holding the Superintendent\u2019s office reads “Superintendent ' + + 'Player Tom”, so it is clear it was not their ordinary turn, and no line names a player twice ' + + 'any more. And a seated player can now download their own game as a save file from the play ' + + 'screen, which previously only solitaire could do.', es_ES: - 'Incluye Station Master v0.8.0.9 — los bots juegan mucho mejor y el servidor trabaja más ' + - 'rápido. LAS PARTIDAS EN CURSO EN ESTE SERVIDOR NO SE VEN AFECTADAS y se reanudarán con ' + - 'normalidad: no ha cambiado ninguna regla. Un bot que ocupa un asiento vacío planifica ahora ' + - 'su turno de maniobras completo antes de su primer movimiento, así que entrega vagones a las ' + - 'industrias que pueden trabajarlos en lugar de decidir movimiento a movimiento, y devuelve ' + - 'los trenes expresos a la estación. Ya no toma cartas descubiertas que no puede jugar solo ' + - 'para volver a descartarlas, así que construye su distrito — más vía, más industrias y vías ' + - 'de circunvalación mucho más a menudo, porque ahora tiende vía donde abre algo que hacer. Y ' + - 'ya no lanza una Segunda Sección por accidente cuando quería poner en marcha un Extra, lo que ' + - 'causaba muchas de sus colisiones. Medido en miles de partidas simuladas, un bot gana ahora ' + - 'unos 4,8 de Ingresos por partida, frente a unos −0,3 antes. Por dentro, calcular adónde ' + - 'puede moverse un tren se hace ahora una vez por posición en lugar de varias, lo que hace al ' + - 'servidor unas tres veces más rápido al comprobar movimientos — con el juego demostrado ' + - 'idéntico.', + 'Incluye Station Master v0.8.0.10 — correcciones de las primeras partidas de prueba ' + + 'multijugador. **LAS PARTIDAS EN CURSO EN ESTE SERVIDOR A MENUDO NO SE REANUDARÁN TRAS ESTA ' + + 'ACTUALIZACIÓN**, porque se ha corregido una regla sobre cuándo se pide una decisión al ' + + 'Superintendente, y una partida guardada se reproduce con las reglas actuales: una partida ' + + 'que contenga una decisión que ya no se pide se detiene ahí. El servidor indica en qué ' + + 'movimiento se detuvo y deja intacto el archivo, así que no se pierde nada; volver a la ' + + 'v0.8.0.9 permite terminar esa partida. La corrección: se pedía decidir sobre un tren DETRÁS ' + + 'del que salía, lo que no afecta a nadie — y costó una colisión real, porque retener el tren ' + + 'que salía mantenía ocupada la única vía de llegada y el tren de atrás llegaba y quedaba ' + + 'destruido. Un tren que se aleja por detrás tampoco te retiene ya. Además: mientras tu ' + + 'tablero se pone al día con los movimientos de otros, la pantalla dice de quién es el ' + + 'movimiento que estás viendo en lugar de nombrar a quien realmente espera la partida, y el ' + + 'historial ya no se adelanta al tablero — las líneas aparecen según se dibujan sus ' + + 'movimientos, y Saltar sigue mostrándolo todo de golpe. El nombre en el mapa de la División ' + + 'vuelve a leerse bien. Una Realineación dice qué carta convirtió y la carta parpadea en el ' + + 'mapa. Una jugada hecha como Superintendente se lee «Superintendent Player Tom», y ninguna ' + + 'línea nombra dos veces al jugador. Y quien ocupa un asiento puede descargar su propia ' + + 'partida como archivo desde la pantalla de juego, algo que antes solo podía el solitario.', de_DE: - 'Enthält Station Master v0.8.0.9 — die Bots spielen deutlich besser, und der Server arbeitet ' + - 'schneller. LAUFENDE SPIELE AUF DIESEM SERVER SIND NICHT BETROFFEN und werden normal ' + - 'fortgesetzt: Keine Regel hat sich geändert. Ein Bot auf einem freien Platz plant jetzt ' + - 'seinen ganzen Rangierzug, bevor er sich zum ersten Mal bewegt, und stellt Wagen daher bei ' + - 'Industrien zu, die sie bearbeiten können, statt Zug um Zug zu entscheiden; beschleunigte ' + - 'Züge bringt er zum Bahnhof zurück. Er nimmt keine offenen Karten mehr, die er nicht spielen ' + - 'kann, nur um sie wieder abzuwerfen, und baut deshalb seinen Bezirk aus — mehr Gleis, mehr ' + - 'Industrien und viel öfter Umfahrgleise, weil er Gleis jetzt dort legt, wo es etwas zu tun ' + - 'eröffnet. Und er setzt keinen zweiten Zugteil (Second Section) mehr aus Versehen ein, wenn ' + - 'er einen Sonderzug starten wollte, was viele seiner Zusammenstöße verursachte. Über Tausende ' + - 'simulierter Spiele gemessen, erzielt ein Bot jetzt etwa 4,8 Einnahmen pro Spiel, vorher etwa ' + - '−0,3. Im Hintergrund wird jetzt einmal pro Stellung statt mehrfach berechnet, wohin ein Zug ' + - 'fahren kann, was den Server beim Prüfen von Zügen etwa dreimal schneller macht — bei ' + - 'nachweislich identischem Spielverlauf.', + 'Enthält Station Master v0.8.0.10 — Korrekturen aus den ersten Mehrspieler-Testpartien. ' + + '**LAUFENDE SPIELE AUF DIESEM SERVER WERDEN NACH DIESEM UPDATE OFT NICHT FORTGESETZT**, weil ' + + 'eine Regel dazu korrigiert wurde, wann der Superintendent entscheiden muss, und ein ' + + 'gespeichertes Spiel mit den aktuellen Regeln nachgespielt wird: ein Spiel mit einer ' + + 'Entscheidung, die es nicht mehr gibt, bricht dort ab. Der Server nennt den Zug, an dem er ' + + 'stehen blieb, und lässt die Datei unangetastet — nichts geht verloren, und mit v0.8.0.9 ' + + 'lässt sich ein solches Spiel zu Ende spielen. Die Korrektur: Es wurde über einen Zug HINTER ' + + 'dem abfahrenden entschieden, was niemanden betrifft — und kostete real eine Kollision, weil ' + + 'das Halten des abfahrenden Zuges das einzige Ankunftsgleis belegt hielt und der Zug dahinter ' + + 'hineinfuhr und zerstört wurde. Auch ein entgegenkommender Zug hinter Ihnen hält Sie nicht ' + + 'mehr auf. Außerdem: Während Ihr Spielfeld die Züge der anderen nachholt, zeigt der ' + + 'Bildschirm, wessen Zug Sie gerade sehen, statt den zu nennen, auf den das Spiel wirklich ' + + 'wartet; und die Historie eilt dem Spielfeld nicht mehr voraus — Zeilen erscheinen, während ' + + 'ihre Züge gezeichnet werden, und Überspringen zeigt weiterhin alles sofort. Der Name auf der ' + + 'Divisionskarte ist wieder lesbar. Eine Neutrassierung nennt die umgewandelte Karte, und die ' + + 'Karte blinkt auf der Landkarte. Ein Zug als Superintendent liest sich „Superintendent Player ' + + 'Tom“, und keine Zeile nennt einen Spieler doppelt. Und wer einen Platz hat, kann sein Spiel ' + + 'jetzt als Datei vom Spielbildschirm herunterladen — bisher konnte das nur das Solospiel.', pl_PL: - 'Zawiera Station Master v0.8.0.9 — boty grają znacznie lepiej, a serwer pracuje szybciej. GRY ' + - 'W TOKU NA TYM SERWERZE NIE SĄ ZAGROŻONE i zostaną normalnie wznowione: żadna zasada się nie ' + - 'zmieniła. Bot zajmujący wolne miejsce planuje teraz całą swoją turę manewrów przed pierwszym ' + - 'ruchem, więc dostarcza wagony do zakładów, które mogą je obsłużyć, zamiast decydować ruch po ' + - 'ruchu, i odprowadza pociągi przyspieszone z powrotem na stację. Nie bierze już odkrytych ' + - 'kart, których nie może zagrać, tylko po to, by je odrzucić, więc rozbudowuje swój okręg — ' + - 'więcej torów, więcej zakładów i znacznie częściej tory objazdowe, bo kładzie teraz tor tam, ' + - 'gdzie otwiera to coś do zrobienia. I nie uruchamia już przez przypadek Drugiej Sekcji, gdy ' + - 'chciał wypuścić pociąg dodatkowy, co powodowało wiele jego zderzeń. Zmierzone w tysiącach ' + - 'symulowanych gier: bot zarabia teraz około 4,8 Przychodu na grę, wcześniej około −0,3. W tle ' + - 'to, dokąd pociąg może pojechać, jest teraz liczone raz na pozycję zamiast kilka razy, co ' + - 'czyni serwer około trzy razy szybszym przy sprawdzaniu ruchów — przy udowodnionym ' + - 'identycznym przebiegu gry.', + 'Zawiera Station Master v0.8.0.10 — poprawki z pierwszych testowych partii wieloosobowych. ' + + '**GRY W TOKU NA TYM SERWERZE CZĘSTO NIE ZOSTANĄ WZNOWIONE PO TEJ AKTUALIZACJI**, ponieważ ' + + 'poprawiono zasadę mówiącą, kiedy Superintendent ma rozstrzygać, a zapis gry jest odtwarzany ' + + 'według bieżących zasad: gra zawierająca rozstrzygnięcie, o które już się nie pyta, ' + + 'zatrzymuje się w tym miejscu. Serwer podaje, przy którym ruchu stanął, i zostawia plik ' + + 'nietknięty — nic nie ginie, a powrót do v0.8.0.9 pozwala taką grę dokończyć. Poprawka: ' + + 'pytano o pociąg ZA odjeżdżającym, co nikogo nie dotyczy — i kosztowało to prawdziwe ' + + 'zderzenie, bo zatrzymanie odjeżdżającego pociągu blokowało jedyny tor przyjazdowy, a pociąg ' + + 'z tyłu wjeżdżał na niego i ulegał zniszczeniu. Pociąg oddalający się za tobą też już cię nie ' + + 'zatrzymuje. Ponadto: gdy twoja plansza nadrabia ruchy innych, ekran mówi, czyj ruch ' + + 'oglądasz, zamiast wskazywać tego, na kogo gra naprawdę czeka, a historia nie wyprzedza już ' + + 'planszy — wiersze pojawiają się wraz z rysowaniem ruchów, a Pomiń nadal pokazuje wszystko ' + + 'naraz. Nazwa na mapie Dywizji znów jest czytelna. Zmiana trasy podaje, którą kartę ' + + 'przekształcono, a karta miga na mapie. Ruch wykonany jako Superintendent brzmi ' + + '„Superintendent Player Tom”, i żaden wiersz nie nazywa gracza dwa razy. A gracz przy stole ' + + 'może teraz pobrać swoją grę jako plik z ekranu gry — wcześniej potrafił to tylko tryb ' + + 'samotny.', fr_FR: - 'Inclut Station Master v0.8.0.9 — les bots jouent beaucoup mieux, et le serveur travaille ' + - 'plus vite. LES PARTIES EN COURS SUR CE SERVEUR NE SONT PAS AFFECTÉES et reprendront ' + - 'normalement : aucune règle n’a changé. Un bot qui occupe une place libre planifie désormais ' + - 'tout son tour de manœuvres avant son premier mouvement, si bien qu’il livre les wagons aux ' + - 'industries capables de les traiter au lieu de décider coup par coup, et il ramène les trains ' + - 'accélérés en gare. Il ne prend plus de cartes face visible qu’il ne peut pas jouer pour les ' + - 'défausser aussitôt, donc il développe son district — plus de voie, plus d’industries et bien ' + - 'plus souvent des voies d’évitement, parce qu’il pose désormais la voie là où elle ouvre ' + - 'quelque chose à faire. Et il ne lance plus une Deuxième Section par erreur quand il voulait ' + - 'faire partir un train supplémentaire, ce qui causait beaucoup de ses collisions. Mesuré sur ' + - 'des milliers de parties simulées, un bot gagne maintenant environ 4,8 de Revenu par partie, ' + - 'contre environ −0,3 auparavant. En coulisses, le calcul des endroits où un train peut aller ' + - 'se fait désormais une fois par position au lieu de plusieurs, ce qui rend le serveur environ ' + - 'trois fois plus rapide pour vérifier les coups — avec un jeu prouvé identique.', + 'Inclut Station Master v0.8.0.10 — corrections issues des premières parties de test ' + + 'multijoueurs. **LES PARTIES EN COURS SUR CE SERVEUR NE REPRENDRONT SOUVENT PAS APRÈS CETTE ' + + 'MISE À JOUR**, car une règle sur le moment où le Superintendent doit trancher a été ' + + 'corrigée, et une partie sauvegardée est rejouée selon les règles actuelles : une partie ' + + 'contenant une décision que l’on ne demande plus s’arrête là. Le serveur indique à quel coup ' + + 'il s’est arrêté et laisse le fichier intact — rien n’est perdu, et réinstaller la v0.8.0.9 ' + + 'permet de terminer une telle partie. La correction : on faisait trancher au sujet d’un train ' + + 'DERRIÈRE celui qui partait, ce qui ne concerne personne — et cela a coûté une vraie ' + + 'collision, car retenir le train au départ gardait l’unique voie d’arrivée occupée et le ' + + 'train derrière y arrivait et était détruit. Un train qui s’éloigne derrière vous ne vous ' + + 'retient plus non plus. Également : pendant que votre plateau rattrape les coups des autres, ' + + 'l’écran indique de qui est le coup que vous regardez au lieu de nommer celui que la partie ' + + 'attend vraiment, et l’historique ne devance plus le plateau — les lignes apparaissent à ' + + 'mesure que leurs coups sont dessinés, et Passer affiche toujours tout d’un coup. Le nom sur ' + + 'la carte de la Division est de nouveau lisible. Un Réalignement indique quelle carte il a ' + + 'convertie, et la carte clignote sur la carte. Un coup joué en tant que Superintendent se lit ' + + '« Superintendent Player Tom », et aucune ligne ne nomme deux fois un joueur. Enfin, un ' + + 'joueur assis peut désormais télécharger sa propre partie sous forme de fichier depuis ' + + 'l’écran de jeu, ce que seul le solitaire permettait.', }, migrations: { /** @@ -154,6 +177,21 @@ export const current = VersionInfo.of({ * and after each step, and the game's `test/route-cache.test.ts` pins the split. Everything else is the * developer bot, whose past moves are already intents in a save. Games in progress resume. * + * v0.8.0.10 IS THE FIRST BUMP THAT BREAKS RESUMES, AND IT DOES SO DELIBERATELY. It corrects WHEN §8.1 + * asks the Superintendent to rule (Gitea#26): a train on a card BEHIND the one departing is nobody's + * concern, and was being counted. A save is the seed and the moves replayed through the CURRENT rules, + * so a game holding a `mainline.clearance` the rules no longer ask for is refused at that move with + * NO_PENDING_DECISION — `tryResumeSession` reports which move, and `index.ts` logs the refusal and + * leaves the file alone. Measured before shipping: 40 four-seat co-op games recorded by bots under + * v0.8.0.9 and replayed under this release — 28 stop, usually 5-40% of the way in. Jesse's call + * (2026-09-15): no games in progress need keeping, so this ships without a per-game switch for the old + * rule, and the release notes say so in all five locales. A game worth finishing can be finished by + * putting v0.8.0.9 back — the save file is untouched. + * + * The rest of the release is the screen and the log — who the board says it is waiting on, what the + * history says and when it says it, a flash on a realigned Mainline card — plus one new read-only + * route (`GET /api/save?token=…`) that hands a seated player their own save. None of it is on disk. + * * A NEW STATE FIELD CANNOT STRAND A SAVE HERE, which is the property worth naming rather than * re-deriving: a `SavedGame` holds `{ seed, config, history }` and NOT a serialised `GameState`. * Resuming calls `createGame` — which fills the new field from `setup.ts` — and then replays the diff --git a/station-master b/station-master index 76c6e10..4adf149 160000 --- a/station-master +++ b/station-master @@ -1 +1 @@ -Subproject commit 76c6e103b392ab3dfccede10c041a8756f46a751 +Subproject commit 4adf149ba5595ef53e2b8217af026ee34d12c9ac