Version 2.2 is in beta — the GUI, command framework, config validators and performance engine are in. Every feature carries the lifecycle the mod's registry gives it, so expect some rough edges while the experimental tier is wired up.

Beta Clients & Launchers v2.2

Hero Client

The most advanced Minecraft client. Performance, and the Hero Studios ecosystem.

Download Client Platform View all features Documentation Roadmap

Beta · v2.2 beta — Multi-version builds published for Minecraft 1.21 through 1.21.11 (12 releases); 26.x builds in progress. Command framework, config validators, performance engine, accessibility, HUD editor, keybind editor, mod menu with search, settings screen. 127 features across 16 registry categories — every one carries the lifecycle the mod's registry gives it.

Why it exists

Purpose

Most clients focus on a single feature or a locked-in experience. Hero Client is a feature-rich modular client with 127 registered features across 16 categories — performance, visuals, HUD, social, and more — built as the natural home for the Hero Studios ecosystem, without sacrificing frames.

Who it's for

PvP players, performance-focused players, creators, and anyone who wants a Lunar-style feature set in one place.

Key capabilities

Performance-first core

A modular backend built around speed, with a service container and strict quality gates.

127 registered features

Visuals, HUD, freelook, zoom, fullbright, waypoints, performance stats and more — every one catalogued with its real lifecycle from the mod's registry.

AI assistance (in development)

Chat assistant, build planner, redstone engineer and programming assistant across six providers — planned, not yet shipped.

Social layer

Friends, parties, guilds and voice chat — the social layer around the client, with marketplace and cloud sync planned.

Features

Everything Hero Client does

39 features across 8 categories — 29 live, 10 planned. Every feature carries its real lifecycle.

Visual 4 features

Freelook

Free camera movement with smooth animation and active indicator — look around without turning your body.

Zoom

Smooth zoom with scroll-wheel level cycling (2x, 4x, 8x) via the FOV pipeline.

Fullbright

Gamma and night-vision modes — see in the dark your way.

Crosshair

Custom crosshair with CROSS, DOT, CIRCLE and DYNAMIC styles — dynamic colors by target type.

HUD 10 features

Keystrokes

Live WASD, space and mouse buttons with real CPS tracking.

CPS Counter planned

Clicks-per-second counter fed from real attack/use events.

Armor Status

Armor slots, defense and durability percentages.

Potion Status

Active effects with amplifier and formatted duration.

Coordinates

Position, facing direction, biome and time of day.

Compass

Cardinal direction compass bar.

Waypoints

Add persistent waypoints with live distance, saved between sessions.

FPS Display planned

Colour-coded frames-per-second counter.

Memory Stats planned

JVM memory usage with GC deltas.

Performance Stats

FPS and memory in one panel.

Performance 4 features

Performance Engine

Real FPS, frametime, 1% low, CPU/GPU/RAM/TPS monitoring.

Mod Menu

Press M to open the mod menu and toggle all features.

Keybind Editor

Real rebinding with conflict detection.

HUD Editor

Drag, align, and persist HUD element positions.

Social 3 features

Social Hub

Friends, guilds, parties and presence — wired to your account.

Voice Chat

In-game voice chat sessions.

Profile

Your HeroProfile — identity, stats and gamemode.

Tools 5 features

Screenshot Studio

Real framebuffer capture with a live gallery.

Replay Studio

Recording sessions with timeline controls.

Macros planned

Deterministic, non-cheating macro automation.

Creator Toolkit planned

Creator workflows and publishing tools.

Marketplace planned

Browse cosmetics, themes and tools.

AI (BYOK) 3 features

AI Chat Assistant planned

Bring-your-own-key across OpenAI, Anthropic, Gemini, Groq, OpenRouter and Ollama.

Build Planner planned

AI-assisted build planning and material calculation.

Redstone Engineer planned

AI-assisted redstone circuit design and analysis.

System 4 features

Notifications

In-game toast notifications for events and status.

Cloud Sync planned

Encrypted cloud sync for settings, waypoints and profiles.

Mod Compatibility

Detects incompatible mods and reports conflicts.

Crash Handler

Graceful crash handling with detailed reports.

Accessibility 6 features

Color Blind Filter

Protanopia, deuteranopia, tritanopia and achromatopsia modes.

High Contrast

High contrast theme for better visibility.

UI Scaling

Custom UI scale from 0.5× to 4.0×.

Screen Reader

Screen reader announcements for key events.

Reduced Motion

Disables non-essential animations.

Keyboard Navigation

Enhanced keyboard navigation with focus traversal.

Getting Started

How to use Hero Client

Run Minecraft on Java 21 — see the FAQ below if the client does not appear.
Install Fabric Loader for your Minecraft version.
Download the Hero Client JAR and Fabric API into your mods folder.
Launch the game with the Fabric profile.
Press M to open the mod menu and toggle features.
Connect your AI provider keys (BYOK) for the AI assistant — planned for Phase 2.

View the full Hero Client tutorial →

Comparison

Why Hero Client?

How it stacks up against the other clients out there.

Feature	Hero Client	Other clients
Feature set	127 features across the 16 categories the mod declares — every one catalogued with a lifecycle from the real registry.	A fixed bundle of features, most of which you will never switch on.
Minecraft versions	Real per-version builds for Minecraft 1.21 through 1.21.11 — 12 releases published separately, one JAR each. 26.x builds are in progress.	Support tracks one or two versions at a time, then goes quiet.
Price & accounts	Free, account-free, with an open API. Download the JAR and play.	Accounts, subscriptions, or cosmetics locked behind a paywall.
Honesty	Every feature carries a real lifecycle straight from the mod's registry — stable, beta or experimental — never faked as shipped.	'Coming soon' shipped as a feature; toggles that do nothing.
Performance	Real FPS, average FPS, 1% low, frametime ring buffer and a CPU/memory/TPS dashboard.	Marketing claims with no numbers attached.
Ecosystem	The natural home for the Hero Studios ecosystem — HeroSync, Hero Agent, DPT and more.	A standalone app you install once and forget.

Controls

Default keybinds

All keybinds are rebindable in the Keybind Editor.

General

Action	Default key
Mod Menu	M
Hero Settings	RSHIFT
Hero Dashboard	R
Toggle Overlay	O
Notifications	N
Accessibility Settings	NONE
Backup	NONE
Keybind Editor	NONE
Commands	/

HUD

Action	Default key
HUD Editor	H
Performance	T

Tools

Action	Default key
Screenshot	F2
Replay	J
Creator Toolkit	G
Build Planner	B
Macros	NONE
Inventory Tools	I

Social

Action	Default key
Marketplace	K
Social Menu	Y
Voice Chat	V
Friends	F
Guilds	NONE
Profile	U

Compatibility

Versions & loaders

Property	Value
Loader / platform	Fabric
Latest version	2.2
Minecraft versions	1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11

Per-version builds ship as separate Fabric JARs — install the one matching your Minecraft version. Java 21 for 1.21.x. All 12 releases of 1.21 through 1.21.11 are published; 26.x builds are in progress.

Version history

Changelog

2.2

2026-10-01 Beta Latest

Phase 1 — multi-version + full GUI

Per-version builds published for Minecraft 1.21 through 1.21.11 (26.x builds in progress)
Full GUI: mod menu, settings screen, HUD editor and keybind editor
QoL pass: smooth zoom (2x/4x/8x scroll levels), animated freelook, fullbright modes, dynamic crosshair, waypoint colours
Accessibility: six features wired into the mod, settings screen, colour-blind filter in the overlay
Phase 1: command framework, config validators, performance engine
Build tooling: build-all-versions.ps1, test-all-versions.ps1, deploy-downloads.ps1
Loom 1.13.6 + Gradle 8.14.3 stable build; CLIENT_PERFECTION_PLAN.md
Feature catalog mirrored onto the website from FeatureRegistry (127 features, 16 categories)

Warning. Requires Java 21 for 1.21.x, Java 25 for 26.x

Fixed: UpdateInfo reporting

2.1

2026-09-28 Release

Stabilisation and launch fix

Released for Minecraft 1.21.11
Fixed launch crash: glGetString with no GL context crashed the client on every launch
Fixed mixin crash: MouseClickMixin never applied — startUseItem returns void
Wired module-ai into the Gradle reactor
Fixed timing-dependent managerGetHealth test (0 ms is valid uptime)

Warning. Requires Java 21 — the mod's fabric.mod.json enforces it; older JREs fail silently

Fixed: client crashed on every launch before the OpenGL context existed

dev

2026-09-06 In development

Milestone stream — M2/M5 and hero-client-web

M2: PerformanceManager presets, FrameTimeMonitor (avg/min/max/1% low), PerformanceDiagnostics, AdaptiveQualityEngine, context overrides
M5: Screenshot Studio and Replay Studio — real disk export, gallery rename/delete/export
hero-client-web (Spring Boot support site) restored and stabilised

Warning. Development milestones — no tagged release artefacts

Fixed: H2 database lock crash on startup (AUTO_SERVER enabled)

Roadmap

Where it's going

Feature parity

now

Complete all 200 specs across the 15 modules.

Per-version CI/CD

Automated builds for every supported Minecraft version.

Ecosystem integration

Deep integration with HeroSync, Hero Agent, and DPT.

NeoForge support

later

Bring Hero Client to NeoForge without a rewrite via the Platform SPI.

FAQ

Questions, answered

Which Java version do I need?

Java 21 for Minecraft 1.21.x, and Java 25 for 26.x. Minecraft 1.21.x will not start on an older JRE — and a newer JDK, 25 for example, fails before the game loads. If Hero Client does not appear at all, check this first: it is the single most common reason it looks broken.

Which Minecraft versions are supported?

1.21 through 1.21.11 — 12 releases, each with its own real JAR. Experimental 26.x builds (26.1–26.3) are in progress.

Is Hero Client a fork or a wrapper?

Neither — it is an original client built from scratch on Fabric.

Does it require an account?

No. Downloading and playing is free and account-free. An account is only used for optional social and cloud-sync features.

How does the AI assistant work?

Bring-your-own-key across OpenAI, Anthropic, Gemini, Groq, OpenRouter and Ollama, with encrypted key storage. It is part of the planned Phase 2 parity pass — not yet shipped.

Is it stable yet?

Version 2.2 is in beta. Every feature on this site carries the lifecycle the mod's own registry gives it — stable, beta or experimental — so nothing is advertised as shipped when it isn't. Expect some rough edges while the experimental tier is wired up.

How do I install it?

Install Fabric Loader for your Minecraft version, drop the Hero Client JAR and Fabric API into your mods folder, launch with the Fabric profile and press M.

Can I rebind keys?

Yes — the Keybind Editor (press M, then Keybinds) supports click-to-rebind, conflict detection and per-row reset. Every bind persists between sessions.

Is it client-side only?

Yes. Hero Client runs entirely on your machine and requires nothing on the server. Features that touch multiplayer state respect server rules.

How do I report a bug?

Use the support portal — it routes your report to the right place with the right details. The crash handler also produces a detailed report you can attach.

Compatibility & limitations

What to know

Compatibility. Per-version builds ship as separate Fabric JARs — install the one matching your Minecraft version. Java 21 for 1.21.x. All 12 releases of 1.21 through 1.21.11 are published; 26.x builds are in progress.

Status. v2.2 beta — Multi-version builds published for Minecraft 1.21 through 1.21.11 (12 releases); 26.x builds in progress. Command framework, config validators, performance engine, accessibility, HUD editor, keybind editor, mod menu with search, settings screen. 127 features across 16 registry categories — every one carries the lifecycle the mod's registry gives it.

Downloads

Get Hero Client

Install as a Fabric mod alongside Fabric API.

Fabric mod JAR View Tutorial

Ecosystem

Part of something bigger

Every Hero Studios product is engineered to work with the rest of the ecosystem — one design language, one performance bar, one long-term vision. Hero Client belongs alongside these tools.