Co-op robustness, audio/a11y, new towers and enemies, Uplink rebalance
Co-op (QA'd with two to three real browsers, TCP-proxy chaos scenarios): - partner's tower changes are never dropped after a render stall or snapshot burst - half-open connections show "reconnecting" in ~6 s instead of 45-65 s - upgrade and next-wave are idempotent (stale commands refused), restart message, promoted host gets Play again, failed joins never kill a live game, listener leaks Audio / keyboard / a11y: - one Audio element per track, fade/stinger supersede tokens, play() retry on the next gesture, 5 s fallback to the synth, mute works everywhere, dialogs with role/aria-modal/focus handling, accessible names for sound/speed/pause New content: - enemies: Daemon (healer), Proxy (regenerating shield), Botnet (flyer swarm); waves weave them in from wave 9 (waves 1-8 unchanged) - towers: Sandbox (stun pulse), Load Balancer (fire-rate aura); hotkeys 1-9 - glyphs/shapes, stun/heal effects, gallery e2e that pixel-checks every kind Orbital Uplink rebalanced after playtesting (was affordable by wave ~6 and buyable in bulk from boss rewards): 1500 credits, upgrades 1200/2000/3200, and every Uplink already owned makes the next one 25% dearer to buy AND to upgrade (each tower remembers its multiplier, carried in the tower list as a 9th field). Shared TD.priceFor/upgradePrice so the UI shows exactly what the sim charges. Also: tablet/foldable viewports in the layout matrix (tolerant colour check), docs (README tower/enemy tables, PROTOCOL shield/stun/pm encodings, NEXT roadmap). Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Tb8pW2KAN4oFkh1aK1BfD8
This commit is contained in:
parent
962189419a
commit
28502984ec
29 changed files with 3370 additions and 230 deletions
|
|
@ -115,7 +115,7 @@ pid for the viewer's own entry and an opaque, stable per-room alias for the othe
|
|||
| message | meaning |
|
||||
|---|---|
|
||||
| `{t:'cmd', c:'place', type, x, y}` | build. Server calls `sim.cmd({...msg, by: slot})` (never trust a `by` from the client) |
|
||||
| `{t:'cmd', c:'sell', id}` / `'upgrade'` `id` / `'target'` `id,mode` / `'wave'` / `'auto'` `v` / `'continue'` | other sim commands, same path |
|
||||
| `{t:'cmd', c:'sell', id}` / `'upgrade'` `id, lv?` / `'target'` `id,mode` / `'wave'` `n?` / `'auto'` `v` / `'continue'` | other sim commands, same path. `lv` and `n` make `upgrade` and `wave` idempotent, see below |
|
||||
| `{t:'ctl', c:'pause', v:bool}` / `{t:'ctl', c:'speed', v:1\|2\|3}` | room-level; reflected in `snap.pa` / `snap.sp` |
|
||||
| `{t:'cursor', x, y}` | hover position in cell units (floats) or `x:null` to hide; clamp to board, round to 2 dp |
|
||||
| `{t:'mark', x, y}` | map ping; at most 1 per 400 ms per player; server broadcasts `mark` (below) |
|
||||
|
|
@ -124,12 +124,35 @@ pid for the viewer's own entry and an opaque, stable per-room alias for the othe
|
|||
| `{t:'newgame', map}` | **host only**: replace the sim with a fresh `new Sim({map})`; resets pause/speed |
|
||||
| `{t:'leave'}` | leave now |
|
||||
|
||||
**Idempotent `upgrade` and `wave`.** Two players who press Upgrade (or Next wave) at the same moment both send the command; without
|
||||
a guard the tower would be upgraded twice and the second player charged for a level they never asked for, or two waves would start.
|
||||
Both commands therefore carry what the sender *saw*: `lv` (upgrade) is the tower level on the sender's screen, `n` (wave) is the wave
|
||||
number the sender expects the command to start (the wave counter they saw, plus one). The sim applies the command only if that still
|
||||
holds; otherwise nothing changes and the sender gets `{ t:'reject', c, reason:'stale', id? }`. Clients treat `stale` as "your partner
|
||||
was a moment faster" and show nothing. Both fields are optional (no field, no check: older clients, the balance bot and the server's
|
||||
own auto-wave timer send none); when present they must be integers, anything else is a malformed message. `stale` is checked after
|
||||
`over` / `no_tower` and before `max` / `gold`, so a sender who is behind is told it is stale rather than that the tower is maxed out.
|
||||
|
||||
Command validation is the server's job: `t:'cmd'` must carry a string `c` in the whitelist above; unknown
|
||||
`c`, non-object, etc. count as malformed. A command the sim refuses (`{ok:false, reason}`) gets
|
||||
`{ t:'reject', c, reason, x?, y?, id? }` sent **to the sender only** (echo `x,y`/`id` when present).
|
||||
Successful commands send nothing extra; the effect arrives via `snap`.
|
||||
`newgame` from a non-host -> `reject` with `reason:'not_host'`; `newgame` with a bad map -> `reject` `bad_map`.
|
||||
|
||||
## Client behaviour that the protocol relies on
|
||||
|
||||
* **Dead connections.** A joined socket gets ~20 `snap`s per second even when the game is paused, so the client treats 5 s without any
|
||||
frame as a dead socket (a half-open connection after a Wi-Fi / cell switch or a NAT / proxy drop never delivers a close for a minute
|
||||
or more). It shows its "reconnecting" state at once, detaches the old socket and opens a new one with the same `join` (same `pid`);
|
||||
the server hands the seat to the new connection and closes the old one with 4001, which the abandoned socket ignores. A socket that
|
||||
has not reached `joined` 10 s after it was opened is abandoned the same way. Retries back off up to 5 s, 14 in all.
|
||||
* **Tower lists.** `tw` is sent once per `rev` change and must never be lost, whatever the render rate: a client that is stalled (hidden
|
||||
tab, long frame) and gets a burst of snapshots keeps the newest undisplayed `tw` when it trims its interpolation buffer, and asks for
|
||||
`sync` if `snap.rev` and the rev of the last applied list ever disagree.
|
||||
* **"No such room" after a reconnect** (`error` / `no_room` in answer to a `join` for the room the client was in) means the server
|
||||
restarted (rooms live in memory only) or the room expired. The client says so ("The server restarted, your game was lost.") and
|
||||
forgets the saved room; after a plain connection failure it keeps the saved room, because the seat is held for `graceMs`.
|
||||
|
||||
## Server -> client
|
||||
|
||||
```
|
||||
|
|
@ -148,6 +171,15 @@ Successful commands send nothing extra; the effect arrives via `snap`.
|
|||
* Snapshots are sent every `1000/snapshotHz` ms **whether or not** the sim advanced (paused rooms still send, so
|
||||
cursors keep moving) but only to online players, and only if at least one player is online.
|
||||
* `ev` events are drained from the sim once per snapshot, so every client sees every event exactly once.
|
||||
* **Tower rows** (`tw`, `state.towers`) are `[id, type, x, y, level, mode, spent, owner, pm]`; `pm` is the price multiplier the tower was bought at (1 for
|
||||
almost every tower; the Orbital Uplink gets dearer for every one owned, and its upgrades cost the same multiple). Clients that ignore the ninth
|
||||
field still work; the UI uses it to show the same upgrade price the sim will charge.
|
||||
* **Monster entries** in `snap.mo` are `[id, kindIndex, x, y, hp, maxhp, slow]`. `kindIndex` indexes `TD.ENEMY_ORDER` (append-only, so
|
||||
old and new clients agree). Two encodings keep the format fixed: a **shielded** enemy (the Proxy) sends `hp = hp + shield` and
|
||||
`maxhp = maxhp + maxShield` (the client derives the shield part from the kind's base hp : shield ratio); and the `slow` flag is `1`
|
||||
while the enemy is slowed **or stunned** (a stunned enemy simply stops moving, the client infers the stun from that).
|
||||
* New events: `stun {x, y, r, n}` (a Sandbox pulse: centre, radius, number of enemies hit) and `heal {x, y, r}` (a Daemon pulse), besides
|
||||
the Orbital Uplink's `beam {x, y, tx, ty, w, bx, by, br}`.
|
||||
* Because WebSocket is reliable and ordered, `tw` deltas cannot be lost; `snap.rev` lets a client detect a
|
||||
bug/desync (`rev` differs from the `rev` it last applied and no `tw` came along) and ask for `sync`.
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue