Ez Mace Keybinds

<center>

📖 Read the full wiki

</center>

Struggling to do Mace techniques? This could be your chance to get good like Mace PvPers!

Ez Mace Keybinds is a client-side mod that turns the fiddly hotbar juggling behind mace and elytra PvP into single keypresses. Air pot, swap between elytra and chestplate, fire fireworks, pearl catch, throw pearls, use wind charges and lunge swap, all with just keybinds.

<center>

</center>

• Trigger Air Pot: throws your splash potions (swiftness, healing, strength) and then a wind charge
• Trigger Elytra/Armor Swap: swaps between your elytra and a chestplate from your hotbar
• Elytra Armor Swap/Revert Mode: a keybind that toggles between Swap and Revert mode, with an action-bar message
• Trigger Firework: uses a firework rocket
• Trigger Wind Charge: uses a wind charge
• Trigger Pearl: throws an ender pearl
• Trigger Pearl Catch: throws an ender pearl, then uses a wind charge
• Trigger Lunge Swap (1.1): swaps to your spear, attacks, then swaps back

<center>

</center>

Every keybind is unbound by default, so nothing interferes with your controls.

1. Open Options > Controls > Key Binds.
2. Scroll to the Ez Mace Keybinds category.
3. Bind each action to the key you want.

Important: the items you use must be in your hotbar (slots 1–9). The mod looks for them there, and if an item is missing the keybind does nothing. After a sequence it switches you back to your original slot.

<center>

</center>

• Minecraft Java 1.21 – 1.21.11, or 26.x (pick the file for your version)
• Fabric Loader and Fabric API
• Java 21+ for 1.21.x, Java 25+ for 26.x

<center>

</center>

• Fabric: supported
• Quilt: should work through Fabric compatibility (use Fabric API), but it is not fully tested
• Forge / NeoForge: not supported
• 26.x: built against 26.2. 26.1 and 26.3 are untested
• The mod uses no mixins, so it isn't expected to conflict with other mods (not exhaustively tested)

<center>

</center>

The keybind does nothing. Why?

• Check that the keybind is actually set, since they're unbound by default.
• Check that the items it needs are in your hotbar, not deeper in your inventory.
• Check that you downloaded the file that matches your Minecraft version.

Which file should I download?

• Pick the file for your Minecraft version. For 1.21.11 there is a 1.1 build with Lunge Swap. For 1.21 – 1.21.10 use the 1.0 build, which has no Lunge Swap. For 26.x use the 26.x build, which needs Java 25.

Does it work on Quilt?

• It should, since Quilt loads Fabric mods. Use Fabric API. It hasn't been fully tested on Quilt, so please report any problems.

Does it work on Forge or NeoForge?

• No. It's a Fabric mod and has no Forge or NeoForge build.

Do I need to install it on the server?

• No. The mod is client-side only.

Is it allowed on servers?

• It automates item swapping and use in timed sequences, so check a server's rules before using it on multiplayer.

Can you port it to another Minecraft version?

• Open a Version Port issue on GitHub. Versions lower than 1.21 won't be ported.

<center>

</center>

Guides for every keybind, with GIFs, are on the wiki.

Found a bug or have an idea? Open an issue on GitHub and pick Bug report, Feature, Version Port or Message. For bugs, include your Minecraft version, loader, mod version and your latest.log or crash report.

Source code and changelog: github.com/Brenthgaming123/EzMaceKeybinds

Made by Timmy and Brenthgaming123. Licensed under MIT.