Improve command discovery and welcome messages

This commit is contained in:
2026-10-19 14:37:24 -04:00
parent e93182cd02
commit a457cbe539
12 changed files with 378 additions and 26 deletions
+32 -3
View File
@@ -462,7 +462,9 @@ Records use the same service area, right aligned: `Map Record | Round N`,
followed by every tied holder on a separate line. After a blank row,
`Your Best | Round N` uses the same heading style as the map record, distinct
from the holder names. The entire announcement is visible at once for 12 seconds;
records have no pages, counter or footer. Help pauses a visible record and
records have no pages, counter or footer. The initial `Type .help for commands`
hint uses the same private native message area and style as unknown-command
replies. Help pauses a visible record and
resumes its remaining time when help ends. `.leaders` during help replaces the
pending record with a fresh replay. Round-start reminders use just the record
header and one proximity or milestone line for six seconds. They skip busy
@@ -486,7 +488,7 @@ avoiding dynamic counter strings in the text config-string pool. Numeric HP
still uses `SetValue`. On r5334+, deploy the updated HUD script and restart
the map; no full server-process restart is required. On older Plutonium
revisions, update clients and server and fully restart them before deploying.
Leaderboard `1.3.1` requires matching common `1.6.1+` for personal records
Leaderboard `1.4.1` requires matching common `1.7.0+` for personal records
and round-start reminders.
AFK `2.0.0` requires plugin `1.4.0+`,
common `1.4.0+` and the EC reserve service; see the [AFK guide](docs/afk.md). Existing
@@ -547,10 +549,37 @@ Before rollout, validate both engines in Plutonium:
notifications and other installed HUD mods; portable allocation checks do
not establish live T5 SP rendering capacity.
## Chat command discovery (T5 and T6)
Common `1.7.0` replies privately to unknown messages starting with `.` or `!`:
`Unknown command. Type .help for the list`. It compares the first word with
installed modules' registered commands, so `.w 2000` and `.afk buy 10` are
recognized without changing their existing argument handling. Ordinary chat
gets no fallback reply. Bang commands are recognized only if registered with `!`.
`.info` and `.command` are case-insensitive aliases for `.help`; `.commands`
continues to work. Leaderboard `1.4.1` adds `.record` as an alias for `.leaders`.
Aliases use the same exact-message handling as their original commands and
add no duplicate help rows. Without the enabled leaderboard module, `.record`
and `.leaders` receive the unknown-command reply.
On welcome, `Type .help for commands` appears once through the same private
`iPrintLn` message area and style as unknown-command replies, after readiness
and the five-second welcome delay. It does not wait for record data, occupy a
record HUD row, or repeat on manual replay. Install matching common `1.7.1` and
leaderboard `1.4.1` scripts together and restart the map. There is
no new native-plugin or backend dependency and no full process restart needed.
Run `node tools/check_commands.mjs`, `node tools/check_hud.mjs` and
`node tools/check_leaderboard.mjs` for portable command and display checks.
Live chat/privacy and rendering checks are in the
[T5 module checks](t5/scripts/README.md#tws_t5_commongsc) and
[T6 notes](t6/scripts/NOTES.md#checks).
## Map record announcements
Install `tws_t5_leaderboard.gsc` for T5 or `tws_t6_leaderboard.gsc` for T6,
**along with common `1.6.1+`** for that game when using leaderboard `1.3.1`.
**along with common `1.7.0+`** for that game when using leaderboard `1.4.1`.
Copy both scripts for each installed game and restart the map. This update
adds no native-plugin or backend requirement and needs no full server-process
restart when existing leaderboard dependencies are already installed.