Keybind Atlas

Keybind Atlas is a client-side visual keybinding overlay that shows players what every key does, across vanilla and modded content.

How? When players open the atlas(default key K), it reads their current keybinding state and renders a live visual map of their keyboard and mouse. Each key is color-coded based on whether it's assigned, unused, or hidden, and hovering over a key shows an info box with the action name and source mod. Players can also enter edit mode to manage bindings directly from the overlay.

Why? Modpack controls get crowded fast. Instead of digging through long controls menus, players can open a readable map and understand where bindings come from at a glance, and easily edit them.

Features

Live Visual Overview

Keybind Atlas reads the current keybinding state from vanilla Minecraft and installed mods, then renders a live map of the player's keyboard and mouse. If a player changes a binding or adds a mod, the atlas updates dynamically.

Keys are visually separated by state:

Assigned for keys with active bindings
Unused for free keys
Hidden for bindings the player chooses to keep out of the overview

Hovering a key shows the action name and source mod. You can also search for a specific action or mod in the top search bar, highlighting the assigned keys.

In-Overlay Editing

Players can manage bindings directly from the overlay:

Remove or rebind an assigned key
Browse unassigned bindings grouped by mod
Assign actions to new keys
Undo changes, discard them, or apply them when ready
List all changes before applying

Keybind Sets

You can create and manage multiple keybind sets, allowing you to switch between different configurations easily. Each set is saved as a JSON file in the config folder, and you can rename or delete sets as needed. The selected set is remembered and automatically tracks edits. Includes a keybind to cycle between sets (default Alt+K).

Each snapshot is its own JSON file under config/keybindatlas/sets/, containing a display name and bindings mapped to key and modifier values. Names must be unique (case-insensitive).

Filtering and Customization

Players can filter visible bindings by mod or by specific actions to reduce noise and focus on the controls that matter. The atlas also supports custom color-coded categories for organizing assigned bindings, including creating, editing, and deleting categories directly in the overlay. Keyboard layout selection, function and extra key toggles, animation controls, hidden-binding controls, 16px and 32px pixel-art resolution, persisted mod and binding filters, and panel styling options are also available.

The Box Layout & Routing editor under Settings allows changes to box sizing, spacing, and connector preferences.

Why should I add this to my modpack?

If your pack depends on many key-driven features, vehicles, abilities, gadgets, magic systems, or utility menus, this mod gives players a much better first impression of the control setup and helps new players learn the controls faster. Players can reassign controls as they see fit in the same screen.

I recommend using this mod along with Default Options mod to ship a custom keybinding setup with your modpack.

Other Info

Side: Client-side only, no server installation is required.
Default open key: K
Open command: /keybindatlas, handled client-side without server installation or operator permissions.
Supported keyboard layouts: US QWERTY, UK QWERTY, Brazilian ABNT2, French AZERTY, Belgian AZERTY, German QWERTZ, Swiss QWERTZ, Spanish QWERTY, Italian QWERTY, and Nordic QWERTY
Mouse support: Integrated mouse visualization is included alongside the keyboard overlay.
Supported localizations: English (US), English (UK), Portuguese (Brazil), French, German, Spanish, Italian, Dutch (Belgium), Danish, Swedish, Norwegian Bokmal, Finnish, Russian, and Simplified Chinese

Showcase Videos

Thank you to all the content creators who have showcased the mod! If you have a video featuring Keybind Atlas that you'd like to share, please let me know.