ErgoWarrior

ErgoWarrior is a completely open-source, ergonomic hitbox-style leverless controller. It was born out of a complete lack of contoured open-source ergonomic hitbox designs.

To the best of my knowledge, this is the first open-source Contoured Ergonomic Hitbox on a public platform.

Major Update: An overhaul of the Handle/Bridge Design is in the works. (As of 31/Mar/2026, the design is complete, fabricated and undergoing testing. Expect a v1.1.0 release in a few days, like the one in the picture.)

I had the Handle Fail and Break in my flight luggage as it was being thrown around. ErgoWarrior was designed to be robust, and this result was not good enough. The overhaul will also address the inability to completely remove cables once assembled, enhancing repairability.

ErgoWarrior v1.1.0 Mechanical Design.

ErgoWarrior v1.0.0 Mechanical Design.

ErgoWarrior v1.0.0 has a robust handle. (It did not, that has been fixed.)

Right Half of ErgoWarrior's Pre-Alpha Build.

Why an Ergo-Design Matters

Traditional flat controllers force the wrists and fingers into unnatural positions. Over time, this can lead to discomfort, fatigue, and even injuries such as Repetitive Strain Injury (RSI) or Carpal Tunnel Syndrome.

An ergo-design, like ErgoWarrior, is built to keep your hands and wrists in a natural, relaxed posture. This brings several benefits:

• Reduced Strain and Injury Risk: Many people (myself included) are highly prone to wrist injuries, ErgoWarrior is designed to keep wrists neutral, lowering stress on muscles and tendons.
• Better Comfort for Extended Use: Less fatigue during long sessions.
• Improved Precision and Performance: Inputs are always in reach and yet equally intuitive.
• Natural Hand Posture: Designed to closely match human anatomy for optimal control and comfort.
• Advanced Techniques Still Possible: Techniques like double taps or quick buffering inputs are still very much preserved and possible.

In short, ergonomic designs are not just about comfort, they improve performance and intend to protect your hands over the long term.

Hardware and Assembly

Raspberry Pi Pico is the main dev-board platform for ErgoWarrior. May change to a custom dev-board in the future.

Cherry MX Low Profile switches are the switches used throughtout all forseen generations of Ergowarrior.

ErgoWarrior is designed to go with M3 Hex Socket 10mm Screws and 8mm M3 Injection Molding Brass Inserts.

Refer to Instructions.md for full instructions in assembly.

Print Settings: All Prints except the ultralight arcade button are done at 0.2mm layer height with the latter at 0.08mm LH. Refer to 3mf files for full details. Note: Some Sanding is required on the jump buttons for optimal fit.

Firmware

Firmware used for ErgoWarrior is a tweaked build of GP2040-CE. Plug-and-Play firmware will drop soon. Until then stock GP2040-CE for the Raspberry Pi Pico must be used. Keybinds as below:

Note on Sizing

The ErgoWarrior is currently available in only one size, which corresponds to my personal hand size.
If you need a different size, you may scale and modify the model yourself with the step files to better fit your requirements.

If you're unsure how to do that, feel free to open an issue thread in the repository. I’m not making any promises at the moment, but I will look into it if possible.

Timeline

v0 (Alpha and Beta Builds) (Released on 19/Oct/2025) (Deprecated)

A kof style 4+4 (L+R) controller was released as Alpha Build by mid-October ~~with a beta build arriving on the same platform in late October~~. (Alpha Build out.) (Beta build cancelled, changes merged with v1.)

v1 (Full Release) (Released on 29/Nov/2025)

A Third-Strike style controller with a (6+10)* (L+R) layout was slated for release in ~~mid-November~~ late-November (Delay in arrival of PCBs).

* Tentative, may change.