NX-Radar-CS2-DMA (ESP32-S3 + ST7789)

Status: Undetected (External Hardware + Kernel Read)
IMPORTANT: The offsets have to be always updated, you can find it here:

• Offsets.hpp
• Client_dll.hpp

---

Disclaimer

EDUCATIONAL PURPOSES ONLY. Playing like an idiot will result in account bans (VAC/Game Ban). Since the software is undetected, the only way to get banned is by playing like a psycho and shooting through smokes all the time. Manual gameplay review is the only real threat, so just play like a 'very good player' and don't tell your team you have a 'little' help."

---

Hardware Requirements

• Microcontroller: ESP32-S3 (DevKitC or similar) running circuitpython.
• Display: ST7789 1.3" or 1.54" IPS LCD (240x240 resolution).
  • Note: Code is configured for Version 1.1 displays.
• Connection: USB-C Data Cable (for serial communication).
• Wiring:
  • CLK (SCL): GPIO 12
  • MOSI (SDA): GPIO 11
  • RES (Reset): GPIO 9
  • DC (Data/Command): GPIO 8
  • CS (Chip Select): GPIO 10

---

Project Structure

CS2-Hardware-Radar/
├── Driver/             # Kernel Driver (NXWire)
│   └── main.cpp        # Driver Entry & Memory Operations
├── Client/             # User-Mode Application
│   ├── main.cpp        # Logic to read memory & send to Serial
│   ├── client_dll.hpp  # Generated Schema
│   └── offsets.hpp     # Generated Offsets
└── Firmware/           # ESP32 CircuitPython Code
    ├── code.py         # Rendering Logic
    └── lib/
        ├── adafruit_display_text/  # Library to render text
        └── adafruit_st7789.mpy     # Library to render the graphs 

---

Installation & Setup

Part 1: The Kernel Driver (NXWire)

The driver handles the MmCopyVirtualMemory calls to read game memory from the kernel level, bypassing user-mode anti-cheat hooks.

1. Prerequisites:
   • Visual Studio 2022 with Desktop development with C++.
   • Windows Driver Kit (WDK) installed.
   • Important: Ensure your WDK version matches your Windows version and Visual Studio configuration. You may need to adjust the driver project properties to target the correct Windows SDK version and Driver Development Kit version if you encounter compilation errors. Check your WDK installation and update accordingly.
2. Build:
   • Open the Driver project properties.
   • Set configuration to Release / x64.
   • Note: If you encounter errors related to Windows SDK or WDK version mismatch, you may need to change the target driver development kit version in the project properties to match your installed WDK version.
   • Build the solution to generate NXWire.sys.
3. Loading:
   • This step depends, I sign this driver with a leaked chinese certificate that I found long time ago, if you don't have one, or you just use kdmapper, load it with that and you will be fine.

Part 2: The ESP32 Firmware

1. Install CircuitPython:
   • Put your ESP32-S3 into bootloader mode.
   • Flash the latest CircuitPython 9.x .uf2 for your specific board.
2. Install Libraries:
   • Download the Adafruit CircuitPython Bundle.
   • Copy the following folders/files to the lib folder on your CIRCUITPY drive:
     • adafruit_display_text/
     • adafruit_st7789.mpy
3. Deploy Code:
   • Copy the provided python script to the root of the drive and name it code.py.
   • Config: If your screen colors are inverted or the screen is mirrored, adjust ROTATION or the initialization arguments in code.py.

Part 3: The C++ Client

1. Update Offsets:
   • CS2 updates frequently. You must generate new offsets using a tool like a2x/cs2-dumper, or download it on the page I put on the top.
   • Place client_dll.hpp and offsets.hpp in the Client source folder.
2. Build:
   • Open the C++ Client project in Visual Studio.
   • Set configuration to Release / x64.
   • Build the executable.

---

How to Run

1. Connect the Hardware: Plug in the ESP32-S3 via USB. The screen should show:

   "WAITING FOR PROGRAM..."

2. Load the Driver:.
3. Start CS2: Launch the game and wait until you are in a match.
4. Run the Client:
   • Run the compiled NXConnect.exe as Administrator.
   • The client will automatically detect the COM port of your ESP32 and perform an automatic handshake (sending RADAR_INIT and waiting for RADAR_ACK).
   • If auto-detection fails, you will be prompted for the COM Port (e.g., if ESP32 is on COM3, type 3).
5. Play:
   • The "Waiting" screen on the ESP32 will disappear once data is received.
   • Enemies appear as Red Dots.
   • You are the Green Dot (Center).
   • Spectator Mode: If you die, the radar automatically adjusts to the POV of the player you are spectating, so a little help for the rest when you are dead.
   • Bomb: When planted, an 'A' or 'B' indicator appears at the top of the radar, this is not 100% accurate, so on a couple of maps B = A and A = B.

Automatic Handshake Protocol

The client uses an automatic handshake mechanism to establish communication with the ESP32 display:

• Handshake Message (RADAR_INIT): The client sends RADAR_INIT\n to the ESP32.
• Expected Response (RADAR_ACK): The ESP32 responds with RADAR_ACK\n.
• Timeout: The handshake has a 2-second timeout. If no acknowledgment is received within this time, the COM port is considered unavailable and the client moves to the next port.
• Auto-Detection: The client automatically scans COM ports 1-20 to find the ESP32, performing the handshake on each port until successful connection is established.

---

Video Demo / Streamable Video Demo / YouTube

---

Configuration

Radar Scale (Zoom)

To change how much of the map is visible, edit code.py:

# Lower = Zoom In | Higher = Zoom Out
scale = (WIDTH / 2) / 2100.0 

Player Position (Origin)

To move the player dot (to see more in front or behind), edit code.py:

# +50 moves player down (see more in front)
RADAR_CY = RADAR_Y_START + (RADAR_HEIGHT // 2) + 50 

---

Troubleshooting

• Screen is Black:
  • Check wiring (GPIO 12/11/9/8/10).
  • Ensure CircuitPython libraries are in lib/.
• Windows crashes:
  • The offsets might be outdated. Update them.
• Enemies Not Appearing:
  • Update the offsets and client_dll
• Debugging Issues:
  • The client creates a debug log file named out.txt on your Desktop if it already exists. To enable logging:
    1. Create an empty file named out.txt on your Desktop.
    2. Run NXConnect.exe as Administrator.
    3. Check out.txt for detailed logs about COM port detection, handshake attempts, and any errors encountered.
  • This log file includes information about the automatic handshake process and can help identify why the COM port auto-detection might be failing.

---

Hardware (Mandatory)

• ESP32 S3
  • Aliexpress, like $7.
  • ESP32
• SPI 240x240 ST7789
  • Aliexpress, like $4.
  • Screen

Hardware (Optional)

• Set 24AWG Cables, 8CM 120 u
  • Aliexpress, like $2
  • Cables
• Set Dupont Line, 10CM, 120 u
  • Aliexpress, like $2.7
  • Kit
• PCB Set, mixed, 5 u
  • Aliexpress, like $2.4
  • PCB
• 1x40Pin 2,54mm, 10 Uds
  • Aliexpress, like $1.8
  • Connectors