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.3

Hero Client

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

Download Client Platform View all features Documentation Roadmap

Beta · v2.2.3 beta — the connected build: signs in to Hero Studios, reads your shared plan and reports progress milestones back to your account page. v2.2.2: every keybind off vanilla controls + config version gate. v2.2 (pinned to Minecraft 1.21.11); every keybind moved off vanilla controls (W/R/T/F//), and a config version gate restores feature defaults for players upgrading from builds that saved everything off. v2.2 multi-version builds remain published for 1.21 through 1.21.10 (12 releases total); 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.

What's new

Latest in Hero Client

Full changelog

2.2.3 Latest 2026-11-03 Beta

Connected: shared account, plan and progress

Reads the shared Hero Studios plan (/api/account/plan) — one plan across the website, both mods and Hero Agent
Reports progress milestones to /api/account/progress (10 milestones: launch, HUD, zoom, waypoints, cosmetics, cloud sync...)
PlanService: 5-minute cache, local dedupe, fully guarded reporting
4,715 automated tests passing

2.2.2 2026-11-03 Beta

Everything works again

Removed every keybind conflict with vanilla controls (W, R, T, F and / moved to F6-F11)
Config version gate re-applies feature defaults when upgrading from builds that saved everything OFF — HUD, screens and toggles work again
Version stamp persists across saves so your own choices are never overwritten
Custom value.* settings survive upgrades

See it in action

Hero Client v2.2.3 — the real thing, not a mockup

No demo video — run it yourself

We do not publish mockups as proof of working software. This page describes build 2.2.3: launch it, follow the tutorial step by step, or read the docs — every claim links to something you can execute today. Recorded walkthroughs are tracked on the roadmap.

Follow the tutorial instead

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 a feature registry of 127 entries across 16 categories — 42 implemented and live, 85 still planned — so nothing counts as shipped before it is. 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 · 42 live · 85 planned

Registry snapshot from the mod's own FeatureRegistry (v2.2.3, 6 Nov 2026): every entry carries its real lifecycle — visuals, HUD, freelook, zoom, fullbright, waypoints, performance stats and more.

AI assistance (in development)

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

Social layer

Friends is live on the web platform (beta in-game); parties, guilds and voice are planned. Marketplace and cloud sync already ship on the web platform — see the capability matrix below for exactly where each works.

Where it works

Capability matrix — Web platform vs In-game client

Live = shipped and usable today · Beta = usable with limits · Planned = designed, not shipped. As of 6 Nov 2026 (v2.2.3).

Capability	Web platform	In-game client
Store browsing & checkout	Live	Planned
Cosmetics ownership & equip	Live	Live
Cloud sync (settings, modules, waypoints)	Live	Live
Account, plans & progress	Live	Live
Friends & presence	Live	Beta
Parties	Planned	Planned
Guilds	Planned	Planned
Voice chat	Planned	Planned

Features

Hero Client — feature registry

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.

Quick start

Get started with Hero Client in minutes

Follow these steps — most installs take under five minutes.

Step 1

Run Minecraft on Java 21 for 1.21.x (Java 25 for 26.x) — see the FAQ below if the client does not appear; a wrong JRE is the single most common cause.

Step 2

Install Fabric Loader for your exact Minecraft version (the downloads page lists the matching Fabric Loader, Fabric API and Java version for every release).

Step 3

Download the Hero Client JAR for your Minecraft version and Fabric API into your mods folder (%appdata%\.minecraft\mods on Windows).

Step 4

Launch the game with the Fabric profile so the config folders are created on first run.

Step 5

Press M to open the mod menu, browse category tabs, and use live search to find and toggle features.

Step 6

Press T for the performance panel (real FPS, frametime, CPU/RAM/TPS) and H for the HUD editor to drag, snap and persist HUD elements.

Step 7

Rebind keys in the Keybind Editor (M → Keybinds) — click-to-rebind, conflict detection, per-row reset; five actions ship unbound.

Step 8

Connect your AI provider keys (BYOK) for the AI assistant when it ships — planned for Phase 2, not yet available.

Full Hero Client tutorial Documentation Download now

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.3
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.3

2026-11-03 Beta Latest

Connected: shared account, plan and progress

Reads the shared Hero Studios plan (/api/account/plan) — one plan across the website, both mods and Hero Agent
Reports progress milestones to /api/account/progress (10 milestones: launch, HUD, zoom, waypoints, cosmetics, cloud sync...)
PlanService: 5-minute cache, local dedupe, fully guarded reporting
4,715 automated tests passing

2.2.2

2026-11-03 Beta

Everything works again

Removed every keybind conflict with vanilla controls (W, R, T, F and / moved to F6-F11)
Config version gate re-applies feature defaults when upgrading from builds that saved everything OFF — HUD, screens and toggles work again
Version stamp persists across saves so your own choices are never overwritten
Custom value.* settings survive upgrades
4,715 automated tests passing

2.2.1

2026-10-15 Beta

Crash fix release

Fixed HudElementManager crash on server join (lazy singleton)
ALL features now work on fresh install (defaults applied)
Fixed all keybinds (direct API, no reflection)
Fixed mod menu text rendering
Added zoom/fullbright/freelook keybinds
Fixed CPS display (wired mouse clicks)
Fixed feature state persistence
Redesigned mod menu GUI (rounded cards, accent colors, better layout)
Fixed vanilla crosshair hidden when custom crosshair active
Fixed armor per-slot display
Fixed title screen button
Fixed mojibake in 3 files
Pinned MC to 1.21.11
Unified version to 2.2
Fixed ALL keybinds (direct API calls, no reflection)
Fixed mod menu text rendering
Added zoom/fullbright/freelook keybinds
Fixed CPS display
Fixed feature state persistence
Fixed mojibake in chat messages
Pinned MC to 1.21.11
Unified version to 2.2
Fixed all invisible text in mod menu (DrawStringCompat direct calls)
Fixed FreelookMixin for 1.21.11 (Level parameter)
Removed broken KeyInputMixin
HUD overlay null-safety

2.2

2026-10-01 Beta

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 (backend support site) restored and stabilised

Warning. Development milestones — no tagged release artefacts

Fixed: 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.3 beta — the connected build: signs in to Hero Studios, reads your shared plan and reports progress milestones back to your account page. v2.2.2: every keybind off vanilla controls + config version gate. v2.2 (pinned to Minecraft 1.21.11); every keybind moved off vanilla controls (W/R/T/F//), and a config version gate restores feature defaults for players upgrading from builds that saved everything off. v2.2 multi-version builds remain published for 1.21 through 1.21.10 (12 releases total); 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.

Stable

HeroSync

Latency compensation that makes high-ping gameplay feel local.

Released and maintained — r1.4.0 across 1.21–1.21.11 and 26.x. Built from 100 specification documents with a fully modular engine.

vr1.4.0 Fabric Performance

Beta

Hero Renderer

A professional-grade, backend-independent rendering engine for Minecraft.

Active development — v2.1 with real Fabric builds. Milestones M0–M9 complete: HGFX (OpenGL 4.6 + Vulkan), frame graph, chunk renderer, ad…

v2.1 Fabric Performance