Show personal map records on join and replay

t5/scripts/README.md

@@ -16,7 +16,7 @@ Platform quirks and deploy commands: [NOTES.md](NOTES.md).
 | [tws_t5_join.gsc](tws_t5_join.gsc)     | `.join` lets newcomers spawn before the current round ends |
 | [tws_t5_lock.gsc](tws_t5_lock.gsc)     | Automatic lobby lock plus majority `.lock` / `.unlock` votes |
 | [tws_t5_telemetry.gsc](tws_t5_telemetry.gsc) | Direct HTTP game start, round, heartbeat, and game end reports |
-| [tws_t5_leaderboard.gsc](tws_t5_leaderboard.gsc) | Private map record on connection, `.leaders` replay and adaptive round-start reminders |
+| [tws_t5_leaderboard.gsc](tws_t5_leaderboard.gsc) | Private map and personal records on connection, `.leaders` replay and adaptive round-start reminders |
 | [tws_t5_bank.gsc](tws_t5_bank.gsc) | Persistent shared GUID bank and private balance/deposit/withdraw commands |
 | [tws_t5_moderation.gsc](tws_t5_moderation.gsc) | Optional controller-managed bans, mutes and live moderation; requires common 1.2.0+ and native plugin 1.3.0+ |
 
@@ -83,14 +83,16 @@ continue updating while hidden; game-over values remain frozen. Help, records
 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
+Records are right aligned: `Map Record | Round N`, every tied holder on its own
+line, then a blank row and a separate `Your Best | Round N` heading. The whole
+record is shown at once for 12 seconds, with no pages, counter or footer. Help displays
 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; the standard AFK command set uses multiple pages), four for records (five with a multi-page
-counter), or two for compact round-start reminders. Pages reuse elements; switching views or closing the service releases
+(20 with a multi-page counter), one element per holder plus two headings for
+full records, or two for compact round-start reminders. Help 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 + 2 elements.
 
@@ -99,15 +101,15 @@ HUD `1.4.2` requires common `1.4.0+` and
 `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. Leaderboard `1.2.0` requires common `1.5.0+` for its
-round-start reminders. AFK `2.0.0` requires the matching
+full restarts first. Leaderboard `1.3.1` requires common `1.6.1+` for its
+personal records and round-start reminders. 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
 
 Copy `tws_t5_leaderboard.gsc` and the updated `tws_t5_common.gsc` to
-`storage/t5/scripts/sp/`, then restart the map. Leaderboard `1.2.0` requires
-common `1.5.0+`; this script update adds no native-plugin or backend dependency
+`storage/t5/scripts/sp/`, then restart the map. Leaderboard `1.3.1` requires
+common `1.6.1+`; this script update adds no native-plugin or backend dependency
 and requires no full server-process restart. Leaderboard requires a
 [t5-gsc-utils](https://github.com/alicealys/t5-gsc-utils) build exposing
 `http::request`, `jsonParse`, `typeof` and `formatString`. A plugin upgrade
@@ -124,10 +126,14 @@ Round-start reminders use the latest usable cache at gaps of 20, 15, 10, 8 and
 6 rounds, then every round for the final five, followed by matching/overtake
 milestones. After the first overtake, reminders stop for that match; `.leaders`
 still works. A reminder shows the record and one short status line for six
-seconds. Join and manual announcements keep all holders and 12-second pages.
+seconds. Join and manual announcements show your personal best on the exact map variant
+below all holders, with one player per line and a blank row before the personal
+heading. Everything is visible at once for 12 seconds, with no record pages or
+counter. New players see `Your Best | None yet`; failed personal lookups show
+`Your Best | Unavailable`.
 Reminders skip busy help/record views, unready players, recent welcome/manual
 requests and empty/unavailable/expired records. Help discards a reminder instead
-of pausing it. No extra HTTP requests are made. Follow the shared live checks
+of pausing it. Round reminders make no extra HTTP requests. Follow the shared live checks
 for cadence, interruption, cleanup and operation without the optional HUD.
 
 ## Player commands
@@ -149,7 +155,7 @@ explicit row positions so T5 does not concatenate newline-separated text.
 | `.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) |
+| `.leaders` | Show map and personal records (leaderboard module required) |
 | `.b` | Check bank balance (bank module required) |
 | `.d <amount\|all>` | Deposit points (bank module required) |
 | `.w <amount\|all>` | Withdraw points (bank module required) |
@@ -162,9 +168,9 @@ also removes its entries from `.help` after a map restart. Lock and extended AFK
 commands appear on additional pages. Bank entries retain the full
 `.d <amount|all>` / `.w <amount|all>` syntax. Removing HUD removes `.hud` from the list.
 The enabled leaderboard module registers `.leaders`, which replays the latest
-cached map record privately. Repeating it restarts the record from the first page;
-help pauses the record's remaining page time and resumes it after the final
-help page. `.leaders` during help replaces the pending record replay from page one.
+map and personal records privately. Repeating it restarts the full 12-second
+announcement; help pauses the record's remaining time and resumes it after the
+final help page. `.leaders` during help replaces the pending record replay.
 
 ## Dependency graph
 
@@ -224,7 +230,7 @@ connect listener anywhere else crashes the T5 SP handshake.
 - Spawn-handler registry
 - Connection-handler registry for optional modules that serve spectator newcomers
 - `.help` / `.commands` listener and ordered help registry populated by installed modules
-- One service controller per player, with help/record pagination,
+- One service controller per player, with help pagination and complete record views,
   interruption/resume, request replacement and disconnect/game-end cleanup;
   display elements exist only for the active view and are released when idle
 - Core element registry with per-element alpha state and a per-player visibility mask
@@ -272,8 +278,8 @@ connect listener anywhere else crashes the T5 SP handshake.
    `.help` and the remaining commands still work. Restore the scripts afterward.
 3. Verify help closes after 12 seconds. Add custom registered commands to test
    the nine-row page limit, counter and repeat-to-restart behavior. Interrupt a record
-   with help and verify remaining page time resumes; repeat `.leaders` during
-   help and verify only the latest replay starts from page one.
+   with help and verify remaining display time resumes; repeat `.leaders` during
+   help and verify only the latest complete replay starts.
 4. Reopen after expiry, die/respawn and reconnect; verify no duplicate text or
    leftover elements. Repeat without the HUD module. Follow the complete
    [HUD validation guide](../../README.md#hud-validation) before rollout.