CS2 VibeSignatures generates CS2 signatures and offsets, updates HL2SDK_CS2 C++ headers through Agent skills and MCP calls, and produces versioned downstream gamedata.
The project is designed to update signatures, offsets, and C++ headers without manual intervention. It currently automates the signatures and offsets consumed by CounterStrikeSharp, CS2Fixes, and other supported projects.
Install the requirements, then prepare and analyze one game version:
uv sync
uv run download_depot.py -tag 14156
uv run copy_depot_bin.py -gamever 14156 -platform all-platform
uv run ida_analyze_bin.py -gamever 14156 -oldgamever 14155These commands populate bin/<GAMEVER>/ and run the configured deterministic, LLM-assisted, and Agent-assisted analysis. Continue with the immutable candidate, gamedata, and C++ validation flow before publishing tracked outputs.
- Download the CS2 depot and copy target binaries.
- Analyze symbols declared by
configs/<GAMEVER>.yaml. - Build one immutable symbol and gamedata candidate.
- Run C++ layout validation against that candidate.
- Publish the validated snapshot and versioned gamedata.
Canonical tracked outputs are gamesymbols/<GAMEVER>.yaml and gamedata/<GAMEVER>/. Per-symbol analysis YAML remains private mutable state under bin/<GAMEVER>/.
- Requirements and environment setup
- Development checks: formatting and tests
- Binary acquisition and symbol analysis
- Process reporting, scheduling, and dashboard
- Reference YAML for
LLM_DECOMPILE - Snapshots, gamedata, and C++ validation
- Creating symbol-analysis skills
- CI/CD and Jenkins workflow reference
Versioned gamedata is generated for CounterStrikeSharp, CS2Fixes, CS2FOW, swiftlys2, plugify, cs2kz-metamod, modsharp, and CS2Surf/Timer. See supported gamedata paths and exceptions.