KeyboardShow

## Mod Description

**KeyboardShow** is a client-side mod for Minecraft Java that displays the keyboard and mouse buttons currently being pressed as an on-screen overlay. The overlay is compact and customizable, and it does not block or consume game input.

### Features

- **Compact keyboard display:** `ESC`, number keys `1–5`, `TAB`, `QWERT`, `ASDFG`, `ZXCVB`, `CAPS`, `SHIFT`, `CTRL`, and `SPACE`.
- **Mouse display:** left click, right click, middle click, and mouse side buttons 4 and 5. The side buttons appear as unlabeled rectangles.
- **Display options:** keyboard only, mouse only, or keyboard and mouse.
- **Overlay size:** 10% to 100% in 10% increments.
- **Opacity:** adjustable slider from 0% to 100%.
- **Accent colors:** purple, white, black, red, blue, yellow, green, orange, and pink.
- **Styles:** `DEFAULT`, `LIQUID GLASS`, `WHITE`, and `GALAXY PURPLE`.
- **Positioning:** four screen corners or a custom position using drag-and-drop.
- **Automatic saving:** settings are stored locally in `config/keyboardshow.properties`.

### How to Use

The overlay is enabled by default after installation. If you have not changed the settings, the defaults are **keyboard and mouse**, **60% size**, **100% opacity**, **purple** accent, **DEFAULT** style, and **bottom-right** position. If you have saved settings, the mod loads those instead.

Open the settings screen in either of these ways:

1. **Through Mod Menu:** open the configuration screen for KeyboardShow. Mod Menu is required for this option.
2. **Through in-game chat:** run `/keyboardshow`. Mod Menu is not required.

In the settings screen, click a button to cycle through its available options. **OVERLAY** enables or disables the overlay; **VIEW** selects which devices to display; and **STYLE**, **SIZE**, **CORNER**, and **COLOR** change their respective settings. Drag the **OPACITY** slider to adjust transparency.

To place the overlay freely, click **LAYOUT** until it displays `FREE`, then hold left-click and drag the overlay to the desired position. To return to corner positioning, change **LAYOUT** to `CORNERS`. Click **DONE** when you are finished. Settings are saved automatically.

> The settings screen is transparent and does not pause the game. Consider opening it while your character is somewhere safe.

### Client Commands

Run these commands in Minecraft chat:

- `/keyboardshow` — opens the settings screen.
- `/keyboardshow size 10` — changes the size. Available values: `10`, `20`, `30`, `40`, `50`, `60`, `70`, `80`, `90`, or `100`.
- `/keyboardshow position top_left` — selects a corner. Available values: `top_left`, `top_right`, `bottom_left`, or `bottom_right`.
- `/keyboardshow color purple` — changes the accent color. Available values: `purple`, `white`, `black`, `red`, `blue`, `yellow`, `green`, `orange`, or `pink`.
- `/keyboardshow toggle` — enables or disables the overlay.

**VIEW**, **STYLE**, **OPACITY**, and free positioning are configured through the settings screen; they do not have command sub-options.

### Input Detection and Limitations

KeyboardShow tracks keyboard and mouse events received by Minecraft, including `KeyMapping` state changes and clicks. Physical input and input from macros or additional software can be displayed when they are passed through Minecraft’s input or keybinding pathways. The mod does not cancel or consume player input.

KeyboardShow is a **visual overlay**, not an anti-cheat. It does not distinguish physical input from macros, monitor software outside Minecraft, or display actions that bypass all of the game’s input callbacks and keybindings. The overlay runs client-side; other players on a server will not automatically see it.

### Compatibility

- Minecraft Java **1.21.11**
- Fabric Loader
- Fabric API
- Java 21 or later

---

This description is original and does not claim affiliation with Mojang or Microsoft. However, an original description alone cannot guarantee that an entire upload is free of copyright claims. Make sure you have permission to distribute the included code and logo. The mod metadata currently lists **CC0-1.0**; use that license only if you have the rights to release all relevant assets under CC0.