Repository navigation
Native Text Capture
shmitzas edited this page Nov 10, 2026
·
4 revisions
CustomHUD can draw the game's own HUD text — what plugins send with SendCenter, SendAlert and the other IPlayer send methods — in its layouts, so plugins that know nothing about CustomHUD match its style. It is set in NativeText, in config.jsonc, and is off by default.
-
Restart after turning
Enabledon. Turning it off, and every other change, applies on save. - A kind is captured only when its own profile, or
Defaultfor a kind without one, has"Capture": true. - A kind's own profile does not inherit from
Default: give it"Capture": trueitself.
| Profile | Sent with | Message type |
|---|---|---|
Center |
SendCenter |
4 |
Alert |
SendAlert |
6 |
Notify |
SendNotify |
1 |
Chat |
SendChat |
3 |
ChatEndOfRound |
SendChatEOT |
5 |
Console |
SendConsole |
2 |
-
SendMessagelands on the profile for its message type. -
SendCenterHTMLis not captured; the game draws it as before. - A captured chat line becomes a HUD message that disappears, not a line players can scroll back to.
-
"Capture": trueonDefaulttakes over every kind without its own profile, chat and console included.
Centre text and alerts in CustomHUD's layouts:
Centre messages draw in hud_text for 5 seconds and alerts in hud_alert for 4, in place of the game's own. Every other kind is left to the game. "Suppress": false on a profile shows both copies, which helps while restyling a layout.
{ "CustomHUD": { "NativeText": { "Enabled": true, "Center": { "Capture": true, "File": "hud_text.vxml_c", "DurationSeconds": 5 }, "Alert": { "Capture": true, "File": "hud_alert.vxml_c", "DurationSeconds": 4 } } } }