Skip to content

Native Text Capture

shmitzas edited this page Nov 10, 2026 · 4 revisions

Native Text Capture

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 Enabled on. Turning it off, and every other change, applies on save.
  • A kind is captured only when its own profile, or Default for a kind without one, has "Capture": true.
  • A kind's own profile does not inherit from Default: give it "Capture": true itself.

Kinds

Profile Sent with Message type
Center SendCenter 4
Alert SendAlert 6
Notify SendNotify 1
Chat SendChat 3
ChatEndOfRound SendChatEOT 5
Console SendConsole 2
  • SendMessage lands on the profile for its message type.
  • SendCenterHTML is 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": true on Default takes over every kind without its own profile, chat and console included.

Example

Centre text and alerts in CustomHUD's layouts:

{
  "CustomHUD": {
    "NativeText": {
      "Enabled": true,
      "Center": { "Capture": true, "File": "hud_text.vxml_c", "DurationSeconds": 5 },
      "Alert": { "Capture": true, "File": "hud_alert.vxml_c", "DurationSeconds": 4 }
    }
  }
}

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.

Clone this wiki locally