MCPcopy Index your code
hub / github.com/Valthrun/valthrun-cs2

github.com/Valthrun/valthrun-cs2 @v0.5.17

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.5.17 ↗ · + Follow
722 symbols 1,535 edges 154 files 17 documented · 2%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Valthrun CS2 Logo

Valthrun is an open source external Counter-Strike 2 read only kernel-level gameplay enhancer.
That's a lot of descriptive words, but what does each of them mean?
- Valthrun The name of this project - open source This application is open source and for everyone to learn from - external We do not inject any DLLs into the target process - read only We do not write to the CS2 process in any way, therefore being impossible to detect by scanning the process memory - kernel We do not use any user level WinAPIs in order to get information from the CS2 process

This project is mainly a fun example for exploring the Windows Kernel with Rust and exploring the world of game enhancements :)

WARNING

Valthrun is not a plug 'n play solution.
Instead Valthrun aims to achieve maximum stealth and stay invisible for other applications.
Please read How to use carefully and try troubleshooting issues on your own.

Features

Due to Valthrun being read-only (as of now), there are limitations on what features are possible to implement (eg. skin changer). Regardless of this limitation, Valthrun supports the following features:

  • External radar
    Publish your game for everybody on https://radar.valth.run
  • Player ESP
    ESP with a lot of configuration possibilities like: Skeleton, Boxes3D and Boxes2D
  • Configurable colors to distinguish between enemy and team players
  • ESP includes player health, a health bar, weapon and a lot more
  • Bomb Info
  • Time until the bomb detonation
  • Defuser info such as a defuse timer
  • Bomb site where the bomb is located
  • Trigger Bot
    Shoot your enemy (or team mates) as soon they enter your crosshair
  • Spectator info
  • List of player currently watching you / the observer target
  • Stream proof by default
    Never show your Valthrun overlay on any screen shares

To access Valthruns settings overlay press PAUSE.

Planned Features

  • Aimbot
  • Player competitive ranks / wins

How to use / Getting started

Please follow this guide to get started:
https://wiki.valth.run/getting-started/

Troubleshooting

If you are having issues mapping the kernel driver or starting the controller, please take a look here:
https://wiki.valth.run/category/troubleshooting

The issue you encounter is most likely covered. If you still have any questions or need assistance, feel free to checkout the official Valthrun Discord server (click to join).

VAC

The same considerations as mentioned in this link have been taken into account.
With these precautions and some minor improvements, such as omitting the Valthrun identifier and using xor encryption for strings, the driver/overlay should avoid VAC detection. However, I must clarify that I haven't extensively studied VAC, so my conclusion is speculative. Personally, I have been using a C based driver/overlay like this with CSGO for several years without ever getting VAC banned. But be aware of overwatch!
With VAC live being enabled now, use this with caution. As always take the necessary precautions into consideration.

Screenshots

Help

You can find help on the official Valthrun Discord server:
Discord Shield

Extension points exported contracts — how you extend this code

State (Interface)
(no doc) [26 implementers]
utils/state/src/lib.rs
Enhancement (Interface)
(no doc) [8 implementers]
controller/src/enhancements/mod.rs
RenderBackend (Interface)
(no doc) [3 implementers]
overlay/src/lib.rs
SearchPattern (Interface)
(no doc) [2 implementers]
cs2/src/pattern.rs
CStringUtil (Interface)
(no doc) [2 implementers]
cs2-schema/cutl/src/cstr.rs
RadarGenerator (Interface)
(no doc) [2 implementers]
radar/client/src/generator/mod.rs
EmitOutput (Interface)
(no doc) [1 implementers]
cs2-schema/definition/src/writer.rs
SchemaProvider (Interface)
(no doc) [1 implementers]
cs2-schema/provider/src/provider.rs

Core symbols most depended-on inside this repo

clone
called by 104
cs2-schema/cutl/src/entity.rs
to_string
called by 80
cs2-schema/cutl/src/cstr.rs
text
called by 73
overlay/src/font.rs
build
called by 61
cs2-schema/definition/src/inheritance.rs
view_arc
called by 59
cs2/src/handle.rs
view
called by 58
cs2/src/handle.rs
get
called by 32
utils/state/src/lib.rs
emit_line
called by 32
cs2-schema/definition/src/writer.rs

Shape

Method 379
Class 159
Function 116
Enum 46
Interface 22

Languages

Rust91%
TypeScript9%

Modules by API surface

controller/src/settings/esp.rs33 symbols
utils/state/src/lib.rs29 symbols
cs2/src/handle.rs28 symbols
controller/src/settings/config.rs28 symbols
radar/web/src/utils/ee.ts24 symbols
controller/src/settings/ui.rs23 symbols
cs2/src/schema/schema.rs22 symbols
controller/src/main.rs21 symbols
radar/server/src/server.rs20 symbols
overlay/src/font.rs20 symbols
controller/src/utils/imgui.rs20 symbols
radar/web/src/backend/connection.ts17 symbols

For agents

$ claude mcp add valthrun-cs2 \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page