Add map record HUD announcements for T5 and T6

t6/README.md

@@ -5,21 +5,27 @@ just like T5. There is no separate TWS config file or database setup.
 
 | File | Role | Dependencies |
 | --- | --- | --- |
-| `tws_t6_common.gsc` | Shared HUD values, helpers, `.help` and first-spawn dispatcher | Stock T6 |
+| `tws_t6_common.gsc` | Shared HUD values, helpers, `.help`, connection and first-spawn dispatchers | Stock T6 |
 | `tws_t6_hud.gsc` | Match/round timers, name, zombie count and health bar | Common |
 | `tws_t6_afk.gsc` | `.afk` / `.back`, protection, movement and weapon blocking | Common |
 | `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) | t6-gsc-utils |
 | `tws_t6_join.gsc` | `.join` chat command lets a spectator newcomer enter mid-match once | Common |
+| `tws_t6_leaderboard.gsc` | Private map high-round record and every tied holder on connection | Common, t6-gsc-utils |
 
 ## Install
 
-1. Copy these six `tws_t6_*.gsc` files into `Plutonium/storage/t6/scripts/zm/`.
-2. For telemetry, install [t6-gsc-utils v3.1.1](https://github.com/alicealys/t6-gsc-utils/releases/tag/v3.1.1)
-   in `Plutonium/plugins/` and restart the server process. The other four scripts
+1. Copy all seven `tws_t6_*.gsc` files into
+   `Plutonium/storage/t6/scripts/zm/`. Update common along with leaderboard.
+2. For telemetry or leaderboard, install [t6-gsc-utils v3.1.1](https://github.com/alicealys/t6-gsc-utils/releases/tag/v3.1.1)
+   in `Plutonium/plugins/` and restart the server process. The other five scripts
    do not require that plugin.
 3. Restart the map to load script updates.
 
+If upgrading from the earlier leaderboard filename, **remove
+`tws_leaderboard.gsc` from the T6 server script directory** before installing
+`tws_t6_leaderboard.gsc`, so both copies do not load.
+
 If updating an existing deployment, **remove `tws_t6_db.gsc` and
 `tws_t6_bank.gsc` from the server script directory**. Copying the remaining files
 will not remove those old scripts. Remove any `exec server.example.cfg` added for
@@ -29,7 +35,25 @@ Source `.gsc` files load directly under Plutonium's
 [documented T6 script layout](https://plutonium.pw/docs/modding/loading-mods/).
 Keep the filenames and `scripts/zm` location so shared references resolve.
 To omit telemetry, remove its script; disabling it at runtime does not remove
-its plugin dependency during linking.
+its plugin dependency during linking. The same rule applies to leaderboard.
+
+## Map record announcements
+
+`tws_t6_leaderboard.gsc` reads the public Electric Cherry API without credentials.
+It works independently of telemetry and HUD, and privately announces records
+once per connection, including newcomers waiting in spectator mode.
+
+Map selection uses stock `level.scr_zm_ui_gametype` and
+`level.scr_zm_map_start_location`, falling back to the corresponding
+`ui_gametype` / `ui_zm_mapstartlocation` dvars when absent. For example,
+`zstandard` + `town` selects `t6:zm_transit:town`, while `zclassic` + `transit`
+selects TranZit. Survival, Grief and Turned variants follow Electric Cherry's
+catalogue. An unknown mode/location is logged instead of guessing from the engine
+map. Use `tws_leaderboard_map_key` for a custom registered selection if needed.
+
+The plugin must expose `httpPost` (with the GET method override), `jsonParse`,
+`typeof` and `formatString`. [Shared configuration, caching and validation](../README.md#map-record-announcements)
+apply to both versions. All T6 script filenames use the `tws_t6_` prefix.
 
 ## Chat commands
 
@@ -115,7 +139,7 @@ another mod installed one first.
 
 ## Validation
 
-To compile all six scripts for T6 PC with gsc-tool 1.4.10:
+To compile all seven scripts for T6 PC with gsc-tool:
 
 ```powershell
 .\tools\check.ps1 -CompilerPath C:\path\to\gsc-tool.exe