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

• Introduction
• Key Features
• Getting Started
  • Requirements
  • Installation
• Configuration
• View
• Contributing
• License

Key Features

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)

Dry Run Mode

For testing purposes, you can run ArduinoStrike without connecting an Arduino device using the dry run mode:

ArduinoStrike.exe --dry-run
# or
ArduinoStrike.exe -d

In dry run mode:

• No Arduino connection is established
• All messages are simulated and logged to file
• Configuration and hotkeys work normally
• Perfect for testing configuration and features

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:

Parameter Settings

You will set the following parameters:

Key Bindings

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

View

Window of the program.

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.