Skip to content

Program for controlling recoil in the game Counter-Strike 2 using an Arduino Leonardo.

License

Notifications You must be signed in to change notification settings

DeniedAccessLife/ArduinoStrike

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ArduinoStrike

ArduinoStrike is a program designed to control the recoil of weapons in Counter-Strike 2 using Arduino Leonardo or any other compatible board. This tool simulates mouse movements for recoil control, implements rapid fire for semi-automatic weapons and adds bunny hop functionality. The software does not interact with the game client in any way, which makes it difficult to be detected by anti-cheat.

Table of Contents

Key Features

Feature Description
Bhop Automatically jumps while holding spacebar, improving movement speed.
ColorBot Detects color changes when aiming and fires instantly without delay.
RapidFire Increases the fire rate of semi-automatic weapons for faster shooting.
FastReload Speeds up reloading in certain situations, allowing faster combat readiness.
AutoAccept Automatically accepts match requests when the button appears on the screen.
RecoilControl Reduces recoil by simulating controlled mouse movements for better accuracy.

Additional Details

  • Note: To enable the bhop feature, enter the command bind mwheeldown +jump in the game console.
  • Important: ArduinoStrike does not require a USB Host Shield - the board connects to a PC via USB and works as an HID device.

Getting Started

Requirements

  • Software: Arduino IDE or PlatformIO, Counter-Strike 2
  • Hardware: Arduino Leonardo (or compatible board with native USB HID support)

Installation

Option 1: Using PlatformIO (Recommended)

  1. Clone the Repository

    git clone https://github.com/DeniedAccessLife/ArduinoStrike.git  
    cd ArduinoStrike  
  2. Upload the Firmware

    • Navigate to the PlatformIO folder:

      cd PlatformIO  
    • Run the upload.bat script for Windows.

    • The script will automatically compile and upload the firmware to your connected Arduino board.

    • Ensure the correct board and port are specified in the platformio.ini file.

  3. Adding Support for Custom HID-Compatible Boards

    • If you plan to use a custom board with HID emulation, update the platformio.ini file located in the PlatformIO folder with the appropriate configurations for your board.
    • Modify the upload.bat script in the same folder to support additional options.

Option 2: Using Arduino IDE

  1. Clone the Repository

    git clone https://github.com/DeniedAccessLife/ArduinoStrike.git  
    cd ArduinoStrike  
  2. Locate the Sketch File

    • The sketch file is located in the PlatformIO/src folder as ArduinoStrike.cpp.
  3. Convert the Sketch for Arduino IDE

    • Rename ArduinoStrike.cpp to ArduinoStrike.ino.
    • Create a new folder named ArduinoStrike in the Arduino projects directory on your system.
    • Move the renamed file into the newly created ArduinoStrike folder.
  4. Open the Project in Arduino IDE

    • Launch the Arduino IDE and open the newly created ArduinoStrike.ino file.
  5. Connect and Configure Arduino

    • Connect your Arduino board to your computer.
    • In the Arduino IDE, select the appropriate Board (e.g., Arduino Leonardo) and Port.
  6. Upload the Firmware

    • Click the Upload button to flash the firmware onto your board.

Configuration

On first launch, an interactive setup wizard will guide you through feature selection, sensitivity settings, and key bindings. Your preferences will be saved in Config.json.

Feature Selection

You will be asked whether to enable the following features:

Feature Description Options
Bunny Hop Auto-jumps while holding spacebar for better movement. Y (enable) / N (disable)
Rapid Fire Increases the fire rate of semi-automatic weapons. Y (enable) / N (disable)
Fast Reload Reduces reload time for faster weapon switching. Y (enable) / N (disable)

Parameter Settings

You will set the following parameters:

Setting Description Range Example
Sensitivity Controls general mouse movement speed. 1 (slow) to 8 (fast) 8
Zoom Sensitivity Adjusts sensitivity when aiming down sights. 0.01 (low) to 3.00 (high) 1.00
ColorBot Threshold Determines color variation tolerance for ColorBot activation. Lower values are stricter. 0 (exact match) to 20 (high tolerance) 20

Key Bindings

You can assign keys to specific actions. Press the desired key when prompted, or ESC to disable the hotkey.

Action Description Type
Recoil Control Confirmation Confirms activation of recoil control while held. Hold
ColorBot Activates ColorBot only while the key is held down. Hold
AutoAccept Toggles automatic match acceptance on/off. Toggle
Weapons Assign keys for different weapons (UMP-45, M4A1-S, M4A4, etc.). Press

View

Window of the program.

alt text

Contributing

If you want to contribute to this project:

  • Request enhancements
  • Report bugs and errors
  • Create issues and pull requests
  • Spread the word about this project

Please read CONTRIBUTING for details on our code of conduct and the process for submitting pull requests.

License

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