Add persistent AFK reserves for both engines (Refs #12)

2026-10-17 16:56:06 -04:00
parent 7b95f604b4
commit 6781a4ed5a
22 changed files with 3840 additions and 248 deletions
@@ -9,7 +9,7 @@ private server token.
 | --- | --- | --- |
 | `tws_t6_common.gsc` | Shared HUD values, helpers, paginated `.help`, service window, connection and first-spawn dispatchers | Stock T6 |
 | `tws_t6_hud.gsc` | Unboxed timers, branding, zombies/health and per-player `.hud` visibility toggle | Common 1.4.0+, Plutonium r5334+ |
-| `tws_t6_afk.gsc` | `.afk` / `.back`, protection, movement and weapon blocking | Common 1.4.0+ |
+| `tws_t6_afk.gsc` | Persistent AFK reserve, rewards and central countdown | Common 1.4.0+, telemetry 1.0.0+, plugin 1.4.0+, EC #151 |
 | `tws_t6_lock.gsc` | Lock at round 20; clear password on game over | Common, HUD |
 | `tws_t6_telemetry.gsc` | Async queued game reports (game_start/heartbeat/round_change/game_end) | tws-t6-gsc-utils |
 | `tws_t6_join.gsc` | `.join` chat command lets a spectator newcomer enter mid-match once | Common |
@@ -78,8 +78,7 @@ slim health bar at the bottom center. `N ZOMBIES` is one centered element at
 the health track's midpoint, using uniform font scale `1.25` so the whole group
 stays centered as the digit count changes. Its initial placeholder is
 `-- ZOMBIES`. Current/maximum HP appears to the right of the bar only while
-injured; it disappears at full health. The AFK indicator sits above the zombie
-count. There are no panel backgrounds or timer labels.
+injured; it disappears at full health. The AFK reserve countdown is independently centered on screen. There are no panel backgrounds or timer labels.
 Fullscreen X/Y anchors use the normalized `640 × 480` viewport directly and
 bypass safe-area insets. Font scale is at least `1.0`; verify text fit, stock
 HUD overlap and Plutonium tag clearance at each aspect ratio in-game.
@@ -90,7 +89,7 @@ clock. It persists across death and respawn. Clocks, health and zombie-count
 displays freeze at game over. Health fallbacks only affect the display and
 never modify gameplay max health.

-The exact, case-insensitive `.hud` command toggles your core and AFK indicator.
+The exact, case-insensitive `.hud` command toggles your core. The AFK countdown stays visible.
 It defaults visible, keeps your choice across death/respawn on the current
 connection/map, and resets visible on reconnect or map restart. Timers and data
 continue updating while hidden; game-over values remain frozen. Help, records
@@ -99,22 +98,22 @@ and the stock HUD are unaffected. `.hud` requires the HUD module.
 Common provides one unboxed upper-right service area below the Plutonium tag.
 Records are right aligned, with `Map record | Round N` followed by up to three
 holder lines; there is no replay footer or single-page counter. Help displays
-the full nine-command list in aligned rows. Services remain private, leave the
+the installed command list in pages of nine rows in aligned rows. Services remain private, leave the
 core in place and work without the HUD module installed. See the
 [shared layout and validation guide](../../README.md#core-hud-and-service-window-t5-and-t6).
 Only the active service view holds HUD elements: 19 for nine-command help
-(20 with a multi-page counter), or four for records (five with a multi-page
+(20 with a multi-page counter; the standard AFK command set uses multiple pages), or four for records (five with a multi-page
 counter). Pages reuse elements; switching views or closing the service releases
 them. Idle services hold no HUD elements, while the controller retains pending
-requests and interruption/resume behavior. Core + AFK use 10 + 1 elements.
+requests and interruption/resume behavior. Core + AFK use 10 + 2 elements.

 HUD `1.4.2` requires common `1.4.0+` and
 [Plutonium r5334+](https://plutonium.pw/docs/changelog/#r5334) for its
 `SetTextUnlimited` counter, updated only when the count changes. Deploy the
 updated HUD script and restart the map on r5334+; no full server-process
 restart is required. Older Plutonium revisions need client/server updates and
-full restarts first. AFK `1.2.0` and leaderboard `1.1.0` remain compatible;
-AFK still requires common `1.4.0+`. No new native-plugin or backend requirement.
+full restarts first. Leaderboard `1.1.0` remains compatible. AFK `2.0.0` requires the matching
+plugin `1.4.0+` and EC reserve service; see the [AFK guide](../../docs/afk.md).

 ## Map record announcements

@@ -149,8 +148,8 @@ explicit row positions so T5 does not concatenate newline-separated text.
 | Command | Description |
 | --- | --- |
 | `.help`, `.commands` | List available commands |
-| `.hud` | Hide or show your core HUD and AFK indicator (HUD module required) |
-| `.afk` | Pause with protection |
+| `.hud` | Hide or show your core HUD (AFK countdown stays visible) |
+| `.afk` | Enter protected AFK using your time reserve |
 | `.back` | Return from AFK |
 | `.join` | Join mid-round (newcomers only) |
 | `.leaders` | Show the map record again (leaderboard module required) |
@@ -282,3 +281,10 @@ research sources and live checks are in [NOTES.md](NOTES.md).
 Optional `tws_t6_moderation.gsc` 1.0.0 requires common 1.2.0 and the matching
 plugin 1.3.0. See the [moderation contract](../../docs/moderation.md) for private
 configuration, persistence, action results and deployment checks.
+
+## Persistent AFK reserve
+
+AFK `2.0.0` uses EC authorization and a local central countdown. See the
+[shared AFK guide](../../docs/afk.md) for exact commands, dependencies, recovery
+and live checks. Install plugin `1.4.0+` and fully restart the server process.
+The countdown remains visible with `.hud` hidden; expiration has no grace period.