KeyMap HUD
A visual keybinding manager for Minecraft that helps you find conflicts, discover unused keys, rebind controls, add custom key labels, and save or share keybinding profiles.
截图
介绍
KeyMap HUD
A visual keybinding manager for Minecraft Fabric.
KeyMap HUD provides an interactive keyboard and mouse overlay that makes it easy to see, understand, and manage your Minecraft keybindings. Quickly find conflicting keybinds, discover unused keys, search through actions, and organize different control setups with profiles.
▶ See a showcase of the features of KeyMap HUD on YouTube
Features
Visual Keyboard & Mouse HUD
View your keybindings directly on a complete visual keyboard and mouse layout.
Keys are color-coded to make your controls easy to understand at a glance:
- Green — Unused key
- Amber — One action bound
- Red — Conflicting bindings
Hover over a key to see its assigned actions and additional information.
Conflict Detection
Immediately identify keys assigned to multiple actions, making it much easier to resolve conflicts in large modpacks.
Search & Filtering
Search your controls and filter keybindings by:
- Conflicts
- Free/unused keys
- Bound keys
- Mouse buttons
- Categories
- Individual mods
KeyMap HUD also supports search prefixes such as mod: and cat: for more targeted searches.
Key Rebinding
Select an action and visually choose the key you want to assign to it. Available keys are highlighted to make finding a good binding easier while still allowing you to intentionally create conflicting bindings when desired.
Safe Conflicts
Not every keybinding conflict is actually a problem. KeyMap HUD lets you mark intentional conflicts as safe, changing the key from red to amber so it no longer appears as an active conflict.
Safe conflicts are automatically cleared if one of the bindings is reassigned or if another binding is added to the key, ensuring new conflicts are still brought to your attention. You can also manually clear the safe status at any time.
Custom Key Labels
Give individual keys custom labels that appear directly on the KeyMap HUD keyboard.
Custom labels make it easy to identify important controls at a glance without needing to remember what every key is assigned to. Labels can be added, edited, or removed directly from the key tooltip and are saved as part of your KeyMap HUD configuration.
This is especially useful for large modpacks where a key’s function may not be obvious from the key itself.
Keybinding Profiles
Create and manage multiple keybinding profiles for different playstyles or mod setups.
Profiles can be:
- Created
- Renamed
- Duplicated
- Deleted
- Switched without manually rebuilding your entire control layout
Designed for Modded Minecraft
KeyMap HUD is especially useful for large modpacks where dozens—or even hundreds—of actions may compete for a limited number of convenient keys.
Current version
- Minecraft 1.21.1
Additional version support may be considered in the future.
Requirements
- Fabric API
- Mod Menu
- Cloth Config API
License
All Rights Reserved.
KeyMap HUD and its source code are publicly available for viewing and reference purposes only.
You may use the mod for personal use and include it in modpacks. Redistribution, rehosting, modification, or publication of modified or ported versions of the mod is not permitted without explicit permission from the author.
© 2026 Itinerant Mods
Support
If you enjoy my mods and would like to support future development, you can find Itinerant Mods on Ko-fi.
Author

Created by Itinerant Mods.
常见问题
KeyMap HUD 支持哪些 Minecraft 版本?
KeyMap HUD 支持 Minecraft Java 版 1.21.1,可用的加载器:Fabric。下载时注意选择和你游戏版本一致的文件。
KeyMap HUD 怎么安装?
先用 PCL2 或 HMCL 启动器安装对应版本的 Fabric,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。运行环境:仅客户端。
评论
登录后评论和评分