MaLiBind

MaLiBind makes key bindings feel intentional. It imports vanilla Minecraft keybinds into MaLiLib's configuration system, so you can manage every hotkey with MaLiLib's polished UI and powerful backend. It's lightweight, respectful of vanilla behavior, and designed to give players and modders clear, flexible control.

What MaLiBind gives you

• Clean organization — group related hotkeys together and keep your controls tidy.
• Powerful triggers — one key can do more thanks to configurable trigger settings.
• Minimal footprint — no invasive changes; only a small accessor mixin where necessary.

Requirements

• Minecraft >=1.21
• MaLiLib for your Minecraft version
• Fabric Language Kotlin >= 1.11.0+kotlin.2.0.0
• Fabric Loader compatible with MaLiLib
• (Optional) Mod Menu compatible with MaLiLib

Quick start

1. Open MaLiBind's configuration screen (default: K + B).
2. Choose a category from the dropdown.
3. Hotkeys are initially empty. Use the "Load" button to import the vanilla keybinds.
4. Adjust hotkeys and tune their trigger settings.
5. Use the "Clear Vanilla" button to remove the original vanilla binding and avoid duplicate triggers.

Make it yours: MaLiBind hands control to you while preserving the familiar vanilla experience.

When to Keep Vanilla Keybinds

Some keybinds may not be fully compatible with MaLiLib's system. For these, it's best to keep the original vanilla keybinds to ensure they work as expected. Examples include:

• Vanilla Minecraft inventory keybinds (1-9 and F)
• All JEI's keybinds
• The "Enlarge Minimap" action in Xaero's Minimap (when set to "hold")

For this reason, MaLiBind hides the keybind categories for vanilla inventory and JEI by default. To change this, edit the ignoredCategories list in the Generic tab of the configuration screen.

Development

Want to build or contribute? Great — here's how to get started.

• Clone the repository:

	git clone https://github.com/nealchen2003/malibind.git

• Build:

	./gradlew buildAndGather

• The built mod JAR will be in build/libs/.

Contributing

Contributions are welcome! Whether it's a bug report, a feature suggestion, or a pull request, your help is appreciated.

• Open an issue to propose a feature or report a bug.
• Send a focused pull request for fixes or enhancements.
• Follow the existing code style and add tests for new behaviors when practical.

Thank you for helping make MaLiBind better for everyone!

License

This project is distributed under the Apache-2.0 License. See the LICENSE.txt file for details.