https://github.com/x1unix/arduino-bunnyhopper

Space key keyboard spammer to make precise bhops in Valve games.
https://github.com/x1unix/arduino-bunnyhopper

arduino arduino-sketch bhop keyboard-emulation

Last synced: about 1 month ago
JSON representation

Space key keyboard spammer to make precise bhops in Valve games.

• Host: GitHub
• URL: https://github.com/x1unix/arduino-bunnyhopper
• Owner: x1unix
• Created: 2024-11-20T18:00:07.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2024-11-20T22:06:00.000Z (5 months ago)
• Last Synced: 2025-01-26T18:28:52.441Z (3 months ago)
• Topics: arduino, arduino-sketch, bhop, keyboard-emulation
• Language: C++
• Homepage: https://x1unix.github.io/arduino-bunnyhopper/tester/
• Size: 1.9 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Arduino Bunny Hopper

![pic](docs/pic.jpg)

A program that allows Arduino to act as a USB keyboard and fires *Space* key presses at a given interval.

## What's bunny hop?

> [Bunny hopping](https://en.wikipedia.org/wiki/Strafing_(video_games)#Bunny_hopping) is an advanced movement method used in some first-person shooter games which relies on exploiting movement mechanics by combining strafing and jumping. \

> *- Wikipedia*

## Requirements

- [Arduino Pro Micro](https://www.sparkfun.com/products/12640) or Leonardo

- Button

- Optional:

  - Potentiometer - to control frequency, see config below.

  - LED + 220Ω Resistor - to indicate keyboard status.

## Configuration

### Pinout

Pinouts configuration is defined in [include/config.h](include/config.h).

Potentiometer can be enabled by defining pin number with `PIN_BHOP_INTERVAL_CTRL`.

> [!IMPORTANT]

> In order for board to start, connect `PIN_KBD_JUMPER` pin to a ground.

> Otherwise, board will boot into recovery mode.

### Testing

Keyboard speed and latency test tool is available here: https://x1unix.github.io/arduino-bunnyhopper/tester/

### Debugging

Some boards can't be reprogrammed while they act as a USB keyboard.\

To address this, firmware comes with a recovery mode.

USB keyboard is disabled in recovery mode, so board can be easily reprogrammed.

To enable recovery mode, disconnect the `PIN_KBD_JUMPER` pin from a ground and reconnect a board.

> [!TIP]

> In recovery mode, status LED immediately turns on after board boots.