Hero Client

Install (Fabric, Java 21)

Hero Client is a **Fabric mod** with one JAR per Minecraft version. Install **Fabric Loader** for your exact Minecraft version (1.21 → 1.21.11 are published; 26.x builds are in progress), make sure **Fabric API** is in the same folder, then drop the matching Hero Client JAR into your mods folder — `%appdata%\.minecraft\mods` on Windows, `~/Library/Application Support/minecraft/mods` on macOS, `~/.minecraft/mods` on Linux. Launch once with the Fabric profile so the config folders are created.

What you'll see. On the Mods screen you should see Hero Client listed with its glyph. If it is missing, check Java first: **Java 21** for 1.21.x, **Java 25** for 26.x — an older JRE fails silently and a newer JDK fails before the game loads.

First run — press M

Launch the game with the Fabric profile and press **M** to open the mod menu. You get category tabs, live search and a feature card grid — each card carries its real lifecycle (stable, beta, experimental) straight from the mod's registry, so nothing is advertised as shipped when it isn't.

What you'll see. The mod menu is a full-screen overlay: a search box at the top, category tabs down the side, and feature cards with toggles in the middle. Typing in the search box filters cards live.

Core keybinds (all rebindable)

Defaults shipped with v2.2. Open **M** → Keybind Editor to rebind: click a row, press the new key, and conflicts are flagged automatically. Every bind persists per profile between sessions. Five actions ship unbound (Accessibility Settings, Backup, Keybind Editor, Macros, Guilds) — bind them yourself if you want.

• Tools: Screenshot (F2), Replay (J), Creator Toolkit (G), Build Planner (B), Inventory Tools (I).
• Social: Marketplace (K), Social Menu (Y), Voice Chat (V), Friends (F), Profile (U).
• HUD: Performance panel (T), HUD Editor (H).

M        Mod menu
RSHIFT   Hero settings
R        Hero dashboard
O        Toggle overlay
N        Notifications
H        HUD editor
T        Performance panel
F2       Screenshot
J        Replay
B        Build planner
/        Hero commands

Tune visuals: zoom, fullbright, crosshair

Open the mod menu (M) and enable **Zoom**, **Fullbright** and **Crosshair** from the Visual tab. Zoom uses smooth FOV-based zoom with scroll-wheel level cycling (2x, 4x, 8x). Fullbright has gamma and night-vision modes — pick the one that suits your monitor. The crosshair supports **CROSS, DOT, CIRCLE and DYNAMIC** styles, with dynamic colors by target type.

What you'll see. With Zoom enabled, holding the zoom key pulls the FOV in smoothly; scrolling the wheel steps through 2x → 4x → 8x and back.

Build your HUD

Press **H** to open the HUD editor: drag elements, snap them to the grid (a grid overlay guides placement), and positions persist as JSON between sessions. Enabled HUD modules include Keystrokes (live WASD + CPS), Armor Status, Potion Status, Coordinates, Compass, Waypoints and Performance Stats. Planned HUD items (FPS Display, Memory Stats, CPS Counter) show as 'planned' in the menu — they are not yet wired.

What you'll see. In the HUD editor the world dims slightly, draggable outlines appear around each enabled element, and a snap-to-grid overlay shows alignment guides as you drag.

Performance panel (T)

Press **T** for the performance engine: real FPS, average FPS, 1% low and a 240-slot frametime ring buffer, plus a CPU / RAM / TPS dashboard. These are measured numbers, not marketing claims — use them to compare presets before and after changes.

What you'll see. The performance panel is a live overlay: FPS and frametime graphs updating each tick, with memory and CPU rows beneath.

Accessibility settings

Open the settings screen (RSHIFT) → Accessibility. Six features are wired end to end: **Color Blind Filter** (protanopia, deuteranopia, tritanopia, achromatopsia), **High Contrast**, **UI Scaling** (0.5× to 4.0×), **Screen Reader** announcements, **Reduced Motion** and **Keyboard Navigation** with focus traversal. Everything is keyboard-reachable.

Configuration files and validators

Configuration lives in the config folders created on first launch (config/ under your .minecraft directory). v2.2 adds **config validators** — range checks, enum checks, a TTL cache and diagnostics — so an invalid value is caught and reported instead of silently breaking a module. Screenshot Studio and Replay Studio export real files to disk with a gallery you can rename, delete and export from.

• Edit files while the game is closed; most reload on next launch.
• The Crash Handler writes a detailed report — attach it to a support-portal report.
• Crash Recovery backs up feature state and restores it after a crash.

AI assistant — honest status

The AI chat assistant, Build Planner AI and Redstone Engineer are **planned for Phase 2** (BYOK across OpenAI, Anthropic, Gemini, Groq, OpenRouter and Ollama, with encrypted key storage). They are not shipped yet — you will not find a working AI provider screen in v2.2, and that is deliberate.

Common problems