Skip to content

README.md

Latest commit

 

History

History
245 lines (174 loc) · 6.54 KB

README.md

File metadata and controls

245 lines (174 loc) · 6.54 KB

CS2 External Cheat

A modern, external cheat for Counter-Strike 2 (CS2) built with C++ and featuring automated build pipelines, memory dumping, and module-based architecture.

🌟 Features

  • External Memory Access - No injection required, safer detection profile
  • Automated Build Pipeline - One-command setup and execution
  • Dynamic Offset Updates - Automatically fetches latest CS2 memory offsets
  • Modular Architecture - Clean, maintainable code structure
  • Cross-Platform Scripts - Works on Windows, WSL, and Linux environments

Cheat Modules

  • ESP Module - Visual overlays and information display
  • Aimbot Module - Aim assistance functionality
  • Root Module - Core cheat management and coordination

🚀 Quick Start

Prerequisites

  • Windows OS with CS2 installed
  • Visual Studio Build Tools or Visual Studio (for MSBuild)
  • Git Bash or WSL (recommended for script execution)
  • curl (for downloading dependencies)

One-Command Setup

# Clone and setup everything
git clone <repository-url>
cd External-cheat
./run.sh --build

This will:

  1. 📥 Download the latest CS2 dumper
  2. 🔍 Generate current memory offsets
  3. 🔨 Build the application
  4. 🚀 Launch the cheat

Quick Launch (After Setup)

# Quick run - uses existing build
./run.sh

📋 Usage Modes

Build Mode

./run.sh --build    # Force rebuild with latest offsets
./run.sh -b         # Short form

Quick Mode

./run.sh           # Skip dumper, use existing application

Individual Components

./scripts/update-dumper.sh    # Update CS2 dumper
./scripts/dump.sh             # Generate memory offsets
./scripts/build.sh            # Build application only

🏗️ Project Structure

External-cheat/
├── 📁 Application/           # Main cheat application
│   ├── Application.cpp       # Entry point
│   ├── Application.h         # Main application header
│   ├── 📁 Gui/              # User interface components
│   ├── 📁 Instances/        # Game object representations
│   └── 📁 Modules/          # Cheat functionality modules
├── 📁 Engine/               # Core engine and utilities
│   ├── Engine.h             # Main engine header
│   ├── Memory.h             # Memory manipulation
│   ├── 📁 Classes/          # Utility classes
│   ├── 📁 GameDumper/       # CS2 offset dumping tools
│   ├── 📁 Math/             # Mathematical utilities
│   └── 📁 Shell/            # System interaction
├── 📁 ImGui/                # Dear ImGui integration
├── 📁 Build/                # Compiled outputs
│   └── 📁 Release/          # Release build artifacts
├── 📁 scripts/              # Build and utility scripts
│   ├── build.sh             # Application builder
│   ├── dump.sh              # Memory dumper
│   ├── update-dumper.sh     # Dumper updater
│   └── README.md            # Scripts documentation
├── run.sh                   # Main pipeline orchestrator
└── Application.sln          # Visual Studio solution

🔧 Development

Building

The project uses MSBuild with a Visual Studio solution:

# Debug build
./scripts/build.sh --debug

# Release build (default)
./scripts/build.sh

Memory Offset Management

CS2 updates frequently change memory layouts. The project uses cs2-dumper to automatically generate current offsets:

# Update dumper tool
./scripts/update-dumper.sh

# Generate fresh offsets (requires CS2 running)
./scripts/dump.sh

Generated offsets are stored in Engine/GameDumper/Dumps/ as C++ header files.

Module Development

Create new cheat modules in Application/Modules/:

// Example module structure
class NewModule : public Module {
public:
    void Initialize() override;
    void Update() override;
    void Render() override;
};

⚙️ Configuration

Build Configuration

  • Platform: x64 (64-bit)
  • Configuration: Release (optimized) / Debug (development)
  • Compiler: MSVC via MSBuild

Runtime Requirements

  • Administrator Privileges - Required for memory access
  • CS2 Running - Target process must be active
  • Antivirus Exclusions - May be needed for memory access

🛡️ Safety & Ethics

This project is for educational purposes and legitimate testing environments only.

Important Notes

  • External Implementation - Safer than injection-based cheats
  • Detection Risks - Use responsibly and at your own risk
  • Game Integrity - Respect other players and game rules
  • Educational Focus - Primarily for learning memory manipulation techniques

🔍 Troubleshooting

Common Issues

Build Failures

# Check MSBuild availability
msbuild --version

# Verify Visual Studio installation
./scripts/build.sh --debug

Dumper Issues

# Run as administrator
# Ensure CS2 is running
# Check antivirus settings

Memory Access Errors

  • Run as Administrator
  • Verify CS2 process is active
  • Update memory offsets with fresh dump

Debug Mode

# Build with debug symbols
./run.sh --build --debug

# Check build logs
./scripts/build.sh --debug 2>&1 | tee build.log

📜 Scripts Documentation

All build and utility scripts are documented in scripts/README.md.

Script Architecture

  • Modular Design - Single responsibility per script
  • Error Handling - Graceful failure recovery
  • User Feedback - Clear progress and status messages
  • Cross-Platform - Git Bash, WSL, Linux compatible

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Implement your changes with proper error handling
  4. Test on multiple environments
  5. Submit a pull request with clear description

Code Style

  • C++17 standard compliance
  • RAII memory management
  • Clear naming conventions
  • Comprehensive comments for complex logic

📄 License

This project is provided for educational purposes. Use responsibly and in accordance with applicable laws and game terms of service.

🔗 Related Projects

⚠️ Disclaimer: This software is for educational and research purposes only. Users are responsible for complying with applicable laws and game terms of service.