[sivert-io]

Custom in-game HUD for Ready Up: the server drives Panorama layouts from the Auto Tournament HUD Workshop addon (3827905393) through CS2's custom_hud_layout entity. Players can click buttons on it. Vikunja #428.

Design: HUD kit canvas. The "Buttons (v2)" page is what this PR builds; "Commands (v1)" is the earlier typed-command design. Plan and test list: hud/BUTTONS-PLAN.md.

Addon (hud/)

• at_ui (v2, clickable), generated by hud/tools/gen_ui.py. One card (bottom left) and one centre panel (lower half) with fixed slots: text, team dots, confirm chips, command chips, 8 pill buttons and a close button. Colours and motion follow the canvas.
• at_kit (v1) is kept for the end-screen leaderboard. at_hello is the P0 proof and at_click the first click test.
• hud/build.ps1 compiles everything with the Workshop Tools resource compiler.

Server

• core: ru_api 1.18 run_chat_command(slot, text) runs a line as if the player typed it in chat (same routing and permission checks). Buttons use it.

• hud.so: readyup.hud.v1 gains screen(slot, spec, on_click, user). A whole screen is given as key=value lines (plugins/hud/hud_screen.h, new ctest hud_screen). Behaviour:

  • A new screen id plays the leave and enter animation; the same id updates in place.
  • hud.so owns the cursor: mouse=on captures it, mouse=b captures it while the buy menu is open (B), and chips=1 never does.
  • The cursor is released on a click, when the screen changes, or on disconnect.
  • Clicks come from user message 390 through a verified ClientSvcUserMessage vtable hook (gamedata/engine-surface.hud.json).
  • Debug tools: ru hudkit demo <screen> [slot], ru hudkit screen <slot> k=v;k=v, and ru hudkit buttons (held-keys probe).

• match.so (hud_screens.{h,cpp}, built from the same data as the center-HTML panels):

  • warmup card with Ready / Unready (B)
  • "everyone ready" countdown
  • knife side pick: CT / T for the winners (cursor on, no close); "picking a side" for everyone else
  • pauses: an Unpause button, confirm chips, then "Waiting for …"
  • give up vote (.gg) and replay request (.stop)
  • .menu: the admin menu (pause, replay a round, change map, swap, force ready, restart, end match with a confirm) or help for players

  Mid-round no screen takes the cursor; buttons are drawn as typed commands instead. readyup.cfg hud_screens=0 (or no hud.so) keeps the center HTML.

Tested

• All 57 ctests pass (Debian build container).
• Deployed to the test instance (0.1.0-hud.10): selftest PASS, the click hook is installed, and ru hudkit demo creates the at_ui entity and writes slot state.
• In game earlier (v1 layouts, at_click): the layouts render, blur works, and clicks arrive with forced capture.

Not done

• Publish the addon update that contains at_ui, then check every screen in game (BUTTONS-PLAN.md, "Tomorrow").
• Section 1 server tests: Y chat without capture, buying while captured, Tab / E / R probe.
• The map vote, plus the welcome, go-live and result cards, still use center HTML.

🤖 Generated with Claude Code