Document party mechanics cleanup

2026-08-17 21:08:02 -07:00
parent 879cfd4fd0
commit d3dd64291e
1 changed files with 47 additions and 0 deletions
@@ -0,0 +1,47 @@
 _model: devlog-entry
 ---
 schema_version: 1
 ---
 title: Four-player parties reform each floor with rolling turns
 ---
 date: 2026-08-17
 ---
 author: Codex and Christopher Chambers
 ---
 summary: Twungeon now enforces four fixed party slots, reforms the party between floors, uses a five-second rolling player-phase timer, and presents consistent player colors in responsive desktop and mobile Extension layouts.
 ---
 tags: implementation, multiplayer, party system, turn timer, Twitch Extension, mobile, responsive UI, testing
 ---
 source_commit: 879cfd4fd071a240b79c25b5054a195578855130
 ---
 body:
 Twungeon's party and turn rules have been tightened around a predictable
 four-player multiplayer loop. Each character now occupies one of four fixed
 slots with a stable color: blue, green, red, or yellow. A fifth spawn is
 rejected as party-full, and defeated characters continue to hold their slot
 until the floor concludes.
 Completing a floor now clears the active party and returns the game to its
 dormant state with the next dungeon ready. Connected and authenticated viewers
 remain eligible to spawn again, so every floor begins with a fresh, first-come
 party formation instead of carrying character state forward.
 The player phase now runs on a rolling five-second deadline. The first accepted
 command from each active player restarts that deadline from the command's
 arrival time. Repeat commands, rejected actions, and duplicate submissions do
 not extend the phase, keeping turns responsive without allowing one player to
 stall the game indefinitely.
 The Twitch Extension now uses the same slot colors across dungeon markers,
 names, party status, action feedback, and administrative views. Its single
 frontend adapts to desktop and mobile contexts: mobile viewers receive larger
 movement and action controls plus an at-a-glance identity, color, health,
 action-point, and healing display.
 Documentation and acceptance coverage were updated alongside the mechanics.
 The completed change passed the domain and integration suites, linting, type
 checking, production build, and desktop and mobile browser layout checks.
 The implementation is recorded in
 [commit `879cfd4fd071a240b79c25b5054a195578855130`](https://git.labyricorn.com/Labyricorn/Twungeon/commit/879cfd4fd071a240b79c25b5054a195578855130).