Skip to main content
HayBox Logo

Welcome to HayBox

HayBox is a modular, cross-platform firmware designed for digital or mixed analog/digital controllers, primarily targeted at B0XX-style controllers. Built with flexibility and performance in mind, HayBox supports multiple microcontrollers, communication backends, and game modes.

Why HayBox?

Cross-Platform Support

Works on RP2040 (Raspberry Pi Pico) and AVR microcontrollers (Arduino-based boards)

Multiple Backends

Supports XInput, DInput, GameCube, Nintendo 64, and Nintendo Switch protocols

Game-Ready Modes

Pre-built modes for Melee, Project M, Ultimate, FGC games, and more

Fully Customizable

Create custom input modes, configure SOCD cleaning, and mix input sources

Key Features

  • Cross-platform support: RP2040 (e.g. Raspberry Pi Pico) and 16MHz AVR MCUs (e.g. ATMega32U4)
  • Wide controller compatibility: B0XX, LBX, Smash Box, GCCPCB/Model S, and more
  • Multiple communication backends: XInput, DInput, GameCube, N64, Switch, B0XX input viewer
  • Mixed input sources: GPIO buttons, switch matrix, Wii Nunchuk, GameCube controller
  • Up-to-date Melee mode: Compliant with B0XX V3 specifications
  • Existing game modes: Melee, Project M, Ultimate, Rivals of Aether, FGC, and more
  • Customizable SOCD cleaning: Configure button pairs and resolution methods per mode
  • Mode switching: Switch modes on the fly without unplugging
  • Automatic detection: Detects console vs USB automatically
  • Low latency: Optimized polling rates for console and PC use

Getting Started

Installation

Flash pre-built firmware to your controller

Building from Source

Customize and build your own firmware

Button Holds

Learn the default button combinations

Game Modes

Explore available game modes

Community and Support

GitHub Repository

View source code and contribute

Report Issues

Report bugs and request features

Troubleshooting

Find solutions to common problems

Contributing

Join the community

Build docs developers (and LLMs) love