Quick start

Live modeCopy Anchor Link

1. Start Counter-Strike 2.

2. Start the overlay:

   sudo ./build/chudcs2

3. Focus the settings window. Press Ctrl+F or Ctrl+K to search for a feature.

4. Configure the features you need and save a profile in Config. See Settings menu and Keybinds.

The reader attempts to refresh offsets on startup. To refresh them separately without opening the overlay:

sudo ./build/chudcs2 --update-offsets

Use --validate-config to check default.json, or the file selected through CHUDCS2_CONFIG, without opening the overlay:

./build/chudcs2 --validate-config

Pass a file path after the flag to validate a different profile. See Configuration for profile locations.

Display backendCopy Anchor Link

The overlay selects native Wayland layer-shell in a Wayland session. Force X11/XWayland when the compositor does not support layer-shell:

sudo ./build/chudcs2 --x11

The current executable reads the live CS2 process. It does not implement the former shared-memory simulation mode. See Packet layout for the retained internal data types.

HyprlandCopy Anchor Link

For X11/XWayland placement, enable Hyprland Compatibility Mode in Debug and follow Hyprland setup. Native Wayland layer surfaces use separate compositor rules.