Giter Club home page Giter Club logo

valthrun's Introduction

Valthrun CS2 Logo

Valthrun an open source external Counter-Strike 2 read only kernel 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 everbody to study
  • external We do not inject any ddls into the target process
  • Counter-Strike 2 The game we're enhancing
  • 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 currently not a pnp (plug 'n play) application.
Please read How to use carefully and try troubleshooting issues on your own.
The goal is to reach maximum stelth to avoid anti cheat detection.

Features

Valthrun provides a variety of external tools to enchant your gameplay experience.
As of now, Valthrun only reads memory and never writes anything. This implies some limitations as which features could be provided.
An example would be a skin changer which is not be possible without actively modifying the CS2 game state (e.g. writing into it's memory).

Regardless of this limitation, Valthrun supports the following features:

  • Player ESP Two modes are supported: Skeleton and Boxes
    • Configurable colors to distinguish between enemy and team players
  • Bomb Info
    • Time until the bomb detonation
    • Defuser info such as how long until the defuse has succeeded
    • Bomb site where the bomb is located
  • Trigger Bot

To access Valthruns settings overlay press PAUSE.

Planned Features

  • Aim Bot
  • Spectator info
    • List of player currently watching you / the observer target
  • Player competitive ranks / wins (I don't have access to the closed beta... so this has to wait a little)

Mess around:

Installation

Valthrun does not need to be installed.
In order to run Valthrun you only need the kernel driver (valthrun-driver.sys) and the controller (controller.exe).

Both can be accquired by downloading the precompiled release from GitHub.
Click here to view all releases.

Once downloaded read How to use to get started!

How to use

The following steps need to be done for starting/activating the overlay.

  1. Load the kernel driver
    The overlay requires the kernel driver for all memory reads and writes. Therefore we need to load the driver before we can start the overlay. It's not strictly required to load the driver before starting CS2 but logically it makes sense to start with the driver.

    There are two common options to load the kernel driver:

    1. Manually map the driver using a vulnerable driver The Valthrun kernel driver fully supports manual driver mapping using a any vulnerable driver. In order to detect the manual mapping the second driver entry argument (the registry patch) must be a null ptr.
      The kernel driver will automatically allocate a new driver for io communication.

      In order to manually map the Valthrun driver you can use tools like

    2. Setting Windows into test-signing mode
      TODO: Explain how to set Windows into test signing Helpfull guide: https://github.com/dretax/GarHal_CSGO#starting-driver

  2. Start Counter-Strike 2
    After loading the driver you can start Counter-Strike 2 as usual.

  3. Start Overlay
    With an open instance of Counter-Strike 2 you can start the overlay.
    Attention: You must start the overlay as administrator!

To explore all command line options of the controller, start the controller from the terminal and pass -h to display the command line interface:

.\controller.exe -h

When you want extra/verbose output, start the overlay from the terminal and previously set the RUST_LOG environment variable.
Example for executing the overlay with trace output:

$env:RUST_LOG="trace"
.\controller.exe

Troubleshooting

If you are having issues mapping the kernel driver or starting the controller, please take a look here:
https://github.com/WolverinDEV/Valthrun/tree/master/doc/troubleshooting

The issue you encounter is most likely covered. If you still have any questions or need assistens, 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-ing 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!
Unfortunately, since I'm not part of the closed CS2 beta,
I haven't had the opportunity to test the overlay with VAC live,
but I assume it should work similarly well.

Supported Windows Versions

All recent windows versions should be supported as all functions / struct offsets are resolved dynamically.
If you encounter an issue, please submit an issue containing your Windows version and detailing the error you encounter.

Screenshots

Help

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

valthrun's People

Contributors

wolverindev avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.