HotKeyBindings

A client-side Fabric mod for binding MaLiLib hotkeys to commands or chat messages.

Features

• Configure between 1 and 64 active binding slots; 16 are visible by default.
• Give every slot its own MaLiLib hotkey and command or chat text.
• Open the configuration screen from MaLiLib, Mod Menu, or an optional hotkey.
• Keep inactive slot values when the visible slot count is reduced.
• Use the interface in English or Simplified Chinese.

Requirements

• Minecraft 26.2
• Fabric Loader 0.19.3 or newer
• Fabric API 0.156.0+26.2 or newer
• MaLiLib 0.29.3
• Java 25

Mod Menu 20.0.0-beta.3 is optional. It only provides an additional entry point to the same configuration screen.

Installation

1. Install Fabric Loader, Fabric API, and MaLiLib for Minecraft 26.2.
2. Place hotkeybindings-fabric-26.2-0.1.0.jar in the client mods/ directory.
3. Start the client and open HotKeyBindings from a MaLiLib configuration screen or Mod Menu.

HotKeyBindings is client-side only. It does not need to be installed on the server.

Usage

Open the HotKeyBindings page from any MaLiLib-based configuration screen or from Mod Menu. Configure the number of visible slots under General, assign keys under Hotkeys, and enter their text under Messages.

Text beginning with / is sent as a command. Any other non-blank text is sent as chat. Up to 64 slots are retained; reducing the visible slot count does not erase hidden bindings.

The General tab controls the active slot count and the optional key used to open this screen. Hotkeys contains the active MaLiLib key bindings, while Messages contains the text paired with each slot. The All tab shows the same active options together.

Configuration is saved to config/hotkeybindings.json. Hidden slots remain in that file and become active again when the slot count is increased.

Sending behavior

• Leading and trailing whitespace is ignored and repeated internal whitespace is normalized before sending.
• A leading / is removed before the text is sent through Minecraft's command path. A bare slash and blank text do nothing.
• Other text is sent through Minecraft's normal signed-chat path.
• Text is limited to Minecraft's chat length. Nothing is sent while the client has no active player connection or the current chat permissions disallow it.

The mod does not bypass server permissions, command validation, chat signing, mute rules, or other server-side checks.

Compatibility

Version 0.1.0 targets Minecraft 26.2 and MaLiLib 0.29.x. Minecraft, Fabric API, and MaLiLib releases outside the versions listed above are not covered by this build.

Building

Build with Java 25:

./gradlew clean test build

The installable artifact is build/libs/hotkeybindings-fabric-26.2-0.1.0.jar. The -sources.jar artifact is for source browsing and should not be placed in mods/.

License

Copyright (c) 2026 sunyixuan. All rights reserved. See LICENSE.