Skip to content

AC PyCheat - A modular ESP overlay for Assault Cube that demonstrates external memory reading techniques. Features include player ESP, distance tracking, and customizable settings. Built with Python and DearPyGui, this project serves as an educational tool for learning game memory analysis and overlay development.

License

Notifications You must be signed in to change notification settings

cloudlmao/ac_pycheat

Repository files navigation

AC PyCheat

A simple ESP overlay for Assault Cube.

Building from Source

  1. Make sure you have Python 3.8 or newer installed
  2. Run build.bat to install dependencies and build the executable
  3. The executable will be created in the dist folder

Usage

  1. Start Assault Cube
  2. Run AC_PyCheat.exe from the dist folder
  3. Press Insert to toggle the ESP menu
  4. Press Escape to exit the application!

Features

  • ESP boxes around players
  • Player names and distances
  • Snaplines to players
  • Customizable colors and settings
  • Auto-detection of game window

Requirements

  • Windows 10 or newer
  • Assault Cube running in windowed mode
  • Administrator privileges (for memory reading)

Troubleshooting

If the ESP doesn't appear:

  1. Make sure Assault Cube is running in windowed mode
  2. Run the application as administrator
  3. Check if the game window title is "AssaultCube"

License

This project is licensed under the MIT License - see the LICENSE file for details.

Assault Cube SDK Overlay

A modular SDK for interacting with Assault Cube game memory and rendering overlays. This project provides tools for reading game memory, rendering ESP overlays, and displaying player information.

This is an external cheat/overlay for Assault Cube.

License: This project is licensed under the MIT License. It is completely open source and free—anyone can use, modify, or distribute it for any purpose. The author assumes no responsibility or liability for any use of this software.

What This Project Does

  • Reads game memory externally (no code injection, no DLLs)
  • Renders an ESP (Extra Sensory Perception) overlay showing player positions, names, distances, and more
  • Tracks the game window and updates overlay position/size in real time
  • Provides a customizable UI for toggling ESP features and settings
  • All memory offsets and structures were reversed by the author for educational purposes

What This Project Does NOT Do

  • Does not inject code or DLLs into the game process
  • Does not modify game files or assets
  • Does not support multiplayer cheating or bypass anti-cheat (for learning only)
  • Does not work on games other than Assault Cube

What's Implemented

  • External memory reading (player, entities, view matrix)
  • ESP overlay: boxes, names, distances, snaplines
  • Overlay window with transparency and click-through
  • Configurable settings menu (Insert key)
  • Real-time window tracking and resizing
  • Color and style customization
  • All offsets and structures reversed by hand

What Needs to Be Improved / Not Implemented Yet

  • Aimbot logic (UI present, but not functional)
  • More advanced ESP features (health bars, weapon info, etc.)
  • Better error handling and stability
  • Support for more game versions or dynamic offset scanning
  • Code cleanup and modularization

Features

  • Memory reading and manipulation
  • Player position and view angle tracking
  • ESP overlay with configurable settings
  • Real-time game window tracking
  • Customizable UI with DearPyGui

Requirements

  • Python 3.8+
  • Assault Cube game running
  • Windows OS

Installation

  1. Clone the repository:
git clone https://github.com/cloudlmao/ac_pycheat.git
cd ac_pycheat
  1. Create and activate a virtual environment:
python -m venv .venv
.venv\Scripts\activate  # Windows
  1. Install dependencies:
pip install -r requirements.txt

Usage

  1. Start Assault Cube
  2. Run the overlay:
python main.py
  1. Use the Insert key to toggle the ESP settings menu

Project Structure

  • main.py - Main entry point
  • sdk/ - Core SDK modules
    • memory.py - Memory reading utilities
    • player.py - Player information handling
    • esp.py - ESP overlay implementation
    • overlay.py - Overlay window management
    • drawing.py - Drawing utilities
    • utils.py - General utilities
    • offsets.py - Game memory offsets (all reversed by hand)

License

This project is licensed under the MIT License. See the LICENSE file for details. This means you are free to use, modify, and distribute this software for any purpose, with no warranty or liability from the author.

Disclaimer

This project is intended for educational purposes and to demonstrate memory reading techniques. Using this software in online games may violate terms of service and result in account bans.


Author's Note: All offsets, structures, and memory layouts were reversed by myself for the purpose of learning game hacking and memory analysis. This project is not intended for malicious use or online cheating.

About

AC PyCheat - A modular ESP overlay for Assault Cube that demonstrates external memory reading techniques. Features include player ESP, distance tracking, and customizable settings. Built with Python and DearPyGui, this project serves as an educational tool for learning game memory analysis and overlay development.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published