Skip to content

Native Text Capture

shmitzas edited this page Nov 12, 2026 · 3 revisions

Native Text Capture

CustomHUD can draw the game's own HUD messages — 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. Messages in config.jsonc picks a layout for each kind; by default the game draws them all.

  • Changes apply on save, capture turning on or off included.
  • A captured message is drawn by CustomHUD in place of the game's own.
  • !ch_test center and !ch_test alert send you one of each and name what draws it — Commands.

Kinds

Setting Sent with Message type
Center SendCenter 4
Alert SendAlert 6
Notify SendNotify 1
Chat SendChat 3
ChatEndOfRound SendChatEOT 5
Console SendConsole 2
  • Chat, ChatEndOfRound and Console are not in config.jsonc; add them under Messages yourself. A captured chat line becomes a HUD message that disappears, not a line players can scroll back to.
  • SendMessage lands on the setting for its message type.
  • SendCenterHTML is not captured; the game draws it as before.

Layouts

Value Draws
"game" Nothing: the game shows the message
"hud_text" A small box near the top of the screen, for 5 seconds
"hud_alert" A larger, louder box, for 4 seconds
"hud_text_v2" The small box in CS2's own store look, for 5 seconds
"hud_alert_v2" The larger box in CS2's own store look, for 4 seconds

A layout of your own: Layouts.


Example

Centre text and alerts in CustomHUD's layouts:

{
  "CustomHUD": {
    "Messages": {
      "Center": "hud_text",
      "Alert": "hud_alert"
    }
  }
}

Centre messages draw in the small box for 5 seconds and alerts in the larger one for 4, in place of the game's own. Notifications stay the game's.

Clone this wiki locally