promotional bannermobile promotional banner
premium banner
Adds a keybord preview that shows which keys are used!

Description

Modrinth Downloads CurseForge Downloads

⚠️ KNOWN INCOMPATIBILITY (Controlling Mod)

If you are using the Controlling mod, it overrides the native screen logic. This completely hides the inline "Ignore" buttons and bypasses ViewBoard's conflict suppression, causing text brackets to remain red on the vanilla page.

  • Status: A proper compatibility hook fix is actively being worked on right now.
  • You can still safely configure your ignore rules by clicking Keyboard View in the bottom right, and navigating to the Manage Rules dashboard.

IMPORTANT NOTE: A GUI scale of 3 or below is heavily recommended to display the keyboard in a resolution of 1080p or more.

TL;DR

This mod adds a button in the bottom-right corner of the keybinds settings. It opens a preview of your keyboard and color codes each key depending on whether it's:

  • Free (No keybinds are using the key)
  • Used (The key is being used by one keybind)
  • Conflicting (Multiple keybinds use the key)

This mod is especially useful if you are playing a large modpack with multiple keybinds using the same key. You can also use it to find which key on the keyboard is free and can be assigned to a new keybind.

New Features in ViewBoard 1.1.0

  • Support for most GUI scales (best results at GUI scale 3 or below)
  • Ignore system for keybinds that lets intentional conflicts exist without warnings
  • Integration with Vanilla Controls / Key Binds:
    • Respects ignored keybinds
    • Suppresses warnings there as well
  • Keybind group system:
    • Grouped keybinds share a forced key
    • Key is removed when bindings leave the group
  • Multiple keyboard layouts in keyboard view:
    • QWERTY, AZERTY, and QWERTZ
  • Mouse button support in keyboard view
  • Detection and display of custom keys assigned via Minecraft's keybind settings

Usage

  1. Open Minecraft → Controls / Key Binds
  2. Click the Keyboard View button (bottom-right) to open the keyboard map
  3. Hover keys to inspect:
    • Conflicts
    • Ignored bindings
    • Grouped bindings
  4. Use Manage Rules to configure keybind rules
  5. In Keybind Rules:
    • Search keybinds
    • Toggle ignored bindings
    • Jump into group editing for specific keybinds
  6. In Keybind Groups:
    • Create and rename groups
    • Assign a shared trigger key
    • Add or remove bindings
  7. Ignored bindings will no longer trigger conflict warnings in:
    • ViewBoard
    • Vanilla keybind screen (Note: Broken if 'Controlling' mod is present)

Bugs

  • Active Issue: UI rendering and logic conflict when paired with the Controlling mod (Fix in progress).

If you encounter any other bugs, please report them on the mod's GitHub page.