Eymistaken's HUD

A modular PvP HUD for Fabric — seven modules, a drag & drop editor, and a plugin API.

Visit the Official Website & User Guide

Module showcases, the Keystrokes Designer guide and the full API documentation live there.

Eymistaken's HUD gives you the competitive overlay of a modded client without the modded client. Everything is drawn client-side, placed exactly where you want it, and stored in a single config file you can share as a string of text.

Why this mod

Modules

CPS

Left and right click counters with a configurable separator and free-text prefixes/suffixes, so you can render
12 | 4, CPS: 12, or anything else you like.

Keystrokes

A fully custom keystroke display, not a fixed WASD block. The bundled Keystrokes Designer lets you draw your own layout: add any key or mouse button, resize it, drag its label independently, recolor individual keys, and pick a press animation (none, squish, ripple, or both). Any key can carry its own CPS counter.

Combo

A hit-streak counter with a heatmap: the number changes color as your streak climbs, and shakes at the top tier. Three difficulty curves decide where those tiers sit.

It also understands how you fight. Classic mode counts every swing; Modern mode respects the 1.9+ attack cooldown so spam clicking doesn't inflate your streak. You choose whether the combo breaks on any damage taken, whether it survives switching targets, and how long it lingers before timing out.

Reach

Shows the exact distance of your last hit, with decimals. Optionally filters to players only, and can stay on screen with a custom "no hit yet" label instead of disappearing.

Armor

Your armor, main hand and off hand as item icons with durability bars. Lay them out vertically or horizontally, draw them on hotbar-style slot backgrounds, print exact durability numbers, and flash a slot red when it takes damage. Every slot is an independently placeable element — you can scatter them around the screen individually if you want.

FPS & Ping

Lightweight performance readouts with custom label text, color, scale and background — for when you want the numbers without opening F3.

The layout editor

Press Right Shift in game to open the editor. Everything you see is the real HUD, live.

• Drag any module — or any individual armor slot — to place it exactly.
• Right-click an element for a context menu of its own settings, straight from the HUD.
• Multi-select two or more elements to unlock align left/center/right, align top/middle/bottom, and distribute horizontally/vertically.
• Snapping to other modules' edges, plus an optional pixel grid (4/8/16/32).
• Prevent Overlap keeps two modules from ever covering the same pixels.
• Right-click empty space for the global menu: settings, presets, server configs, share codes and a full layout reset.

The settings screen

A purpose-built settings screen — one page per module, split into tabs, with a search box that finds any setting by name, per-row descriptions and defaults, and a one-click reset on anything you've changed. It holds a single readable size at any Minecraft GUI Scale, and you can nudge that baseline from 50% to 200%.

Open it from ModMenu, or from the editor's global menu.

Presets, server configs & share codes

Appearance

Five bundled fonts on top of vanilla — Inter, Rubik, JetBrains Mono, Bebas Neue and the enchanting-table font — applied only to HUD elements and this mod's own screens, never to chat or vanilla menus. Add a thin black outline instead of the vanilla drop shadow, and set color, scale, background and opacity per module.

(Still improving fonts. They are not perfect yet. Sorry.)

Installation

1. Install Fabric Loader (0.18.4 or newer).
2. Install Fabric API.
3. Download Eymistaken's HUD and drop the .jar into your .minecraft/mods folder.

ModMenu is optional and only adds a button to open the settings screen. There is no Cloth Config requirement — the settings screen is built into the mod.

Requirements: Minecraft 26.1–26.2 · Java 25 · Fabric · client-side only.

⚠ Updating from a version older than v1.0.8?

Delete your old simplecps.json config file first to avoid layout issues and to pick up the newer defaults.

For developers

Third-party mods can register their own HUD modules through the eymistaken_hud entrypoint. A registered module gets a settings page, a slot in the drag & drop editor, and its state carried inside presets, server configs and share codes — for free.

public class MyPlugin implements EymistakenHudPlugin {
    @Override
    public void registerHudModules(HudModuleManager manager) {
        manager.registerModule(new MyHudModule());
    }

    @Override
    public void registerEvents(EymistakenHudEventBus bus) {
        bus.subscribe(ComboStreakEvent.class, event -> {
            if (event.level() >= 2) playHypeSound();
        });
    }
}

Modules can declare their own settings tabs, expose sliders/toggles/color pickers/text fields to the editor's right-click menu, and split into independently placeable sub-elements. Full documentation is on the official website.

A third-party module registered through the API — it gets its own settings page, its own tabs, and a slot in the editor, listed under PLUGINS in the sidebar.

Links

• Official Website & User Guide
• Source Code
• Report an Issue

Licensed MIT.