CHUDCS2
Architecture, setup, features and development notes for the Linux overlay.
CHUDCS2 is a C++20 Linux application that reads Counter-Strike 2 state, renders a transparent OpenGL and Dear ImGui overlay, and includes a C++ unit-test harness.
Install and run
Install Arch Linux dependencies, build the binary and launch the live overlay.
Architecture
Follow game data from ingestion through frame preparation, rendering and input.
Feature list
See the visual overlay, grenade tools, input helpers and diagnostics in the current tree.
Develop
Use the repository layout, build targets and workflow for code changes.
Where to start
- New users: Installation, then Quick start.
- Code changes: Architecture, Project layout, and Development.
- Test changes: Testing and Packet layout.
- Feature workflows: Keybinds, Web radar, and Grenade authoring.
- Profiles and appearance: Manage profiles, Visual settings, and Focus and shortcuts.
- Runtime tuning: Configuration, Launch options, and Display scaling.
- Performance: Performance tuning and Collect diagnostics.
- Failures: Troubleshooting.
Repository conventions
The executable expects assets/, offsets.json, and configuration data beside the binary. Build output is normally written to build/. The docs in this site describe the source tree as it exists in the repository, including the optional AimAssist module.
Was this page helpful?
Last updated on