Skip to content
InputBooster
Gamer GuideVisibility

The overlay

What the InputBooster HUD overlay draws, the exact conditions under which it appears, and how to configure it.

3 min readInputBooster 4.1.2-alphaMinecraft 26.2 / 26.3

The overlay is a small panel drawn over the HUD. It shows the engine state, the event counters and the dispatch timing. It is off by default outside the F3 debug screen.

When it draws

All of these must be true:

ConditionSource
show_f3_info is onThe master switch
A player existsmc.player != null
overlay_opacity is above 0.001opacity > 0.001f
overlay_mode is 1, or the F3 debug screen is openoverlay_mode

The vanilla HUD Overlay option in the options screen must also be enabled, otherwise the game does not draw the HUD at all.

What it shows

LineConfig that toggles itContent
TitlealwaysInputBooster <version>
Engineoverlay_show_engineThe engine mode and the current rate in Hz
Countersoverlay_show_eventsKeys, mouse and actions, abbreviated above 1000
Dispatchoverlay_show_overheadMean dispatch cost in microseconds and the queue depth
Warningalways, when relevantCustom keyboard handler is ALPHA

A rendered panel looks like this:

text
InputBooster 4.1.2-alpha
Engine: poll  200 Hz
Keys 1.2k  Mouse 430  Actions 880
Dispatch 3.41 us  Queue 0/128

The counter line abbreviates: 1.2k for 1200, 4.5m for 4,500,000.

Placement

overlay_position selects one of four corners:

ValueCorner
0Top-left (default)
1Top-right
2Bottom-left
3Bottom-right

The position is clamped inside the window, so the panel is never drawn off screen after a resize. A panel larger than the screen is pinned to 0 rather than drawn at a negative coordinate.

java
int maxX = Math.max(0, screenWidth - panelWidth);
int maxY = Math.max(0, screenHeight - panelHeight);
return new Pos(clamp(x, maxX), clamp(y, maxY));

Scale and opacity

SettingRangeDefaultEffect
overlay_scale0.5 to 3.01.0Multiplies the panel size and the glyphs together
overlay_opacity0.0 to 1.00.8The alpha of the panel background

Opacity multiplies the panel background, not the text. The text colours are full-alpha ARGB values.

Cost

The overlay's text is rebuilt at most four times a second — a 250 ms interval — and the result is kept in a reused array. The per-frame cost is one render-state submission per line, not string formatting every frame.

The keystrokes overlay

show_keystrokes exists as a config key, a settings toggle and a profile field. There is no renderer for it in 4.1.2-alpha, so no keystroke display appears anywhere.

The alpha handler warning

When custom_keyboard_handler is on, the overlay adds a warning line. It is the only line that uses the warn colour, and it is prefixed with ! internally to select that colour.