Hero Studios

Hero Client · Documentation

Everything you need to run Hero Client properly.

Installation, feature documentation, keybinds and the questions that actually come up — answered with the real reason behind each behaviour, not a shrug.

v2.2 Fabric mod 125 features documented Download →
Getting started Feature docs Keybinds FAQ

Getting started

From nothing to a working client in six steps

Hero Client is a Fabric mod — it installs exactly like one. There is no separate launcher, no account requirement and no installer. You need Minecraft, Fabric Loader and two JARs.

Check your Java version first. Java 21 for Minecraft 1.21.x, Java 25 for 26.x. If the client does not appear at all, this is almost always the reason — an older JRE silently drops the mod, and a newer JDK fails before the game loads.
1

Install Fabric Loader

Install Fabric Loader for the exact Minecraft version you play. Hero Client is a Fabric mod — it runs alongside Fabric API.

2

Check your Java version

Java 21 for 1.21.x, Java 25 for 26.x. If the client does not appear at all, this is the single most common reason — check it first.

3

Drop in the JARs

Place the Hero Client JAR for your Minecraft version — and Fabric API — into your mods folder.

4

Launch the Fabric profile

Start Minecraft with the Fabric profile. Hero Client loads automatically.

5

Press M

Open the mod menu, browse categories with live search and toggle features on or off.

6

Make it yours

Drag HUD elements into place, rebind keys in the Keybind Editor, and connect your AI provider keys (BYOK) when you want the assistant.

First launch

  • Launch Minecraft with the Fabric profile for your version — Hero Client loads automatically.
  • Press M to open the mod menu. Category tabs on the left, live search on top, feature cards with toggles below.
  • Open the HUD editor from the mod menu and drag elements where you want them — positions persist as JSON between sessions.
  • Open the Keybind Editor to rebind anything — conflicts are detected the moment you assign them.
  • Optional: connect your AI provider keys (BYOK) once the AI assistant ships in the Phase 2 parity pass.

Files and folders

Hero Client keeps everything in your normal Minecraft directory. Configs are human-readable JSON in your config folder, screenshots live in the Screenshot Studio gallery, and cloud sync (when enabled) is encrypted end to end.

WhatWhereNotes
Mod JARmods/One JAR per Minecraft version — never mix versions.
Fabric APImods/Required. Install the build matching your Minecraft version.
Configurationconfig/Validated JSON — invalid values are rejected at write time.
Keybinds & HUD layoutconfig/Persisted automatically; exported with your config.
Crash reportscrash-reports/Generated by the crash handler — attach them to bug reports.
Download Hero Client Ask on Discord Report a bug

Feature documentation

What each part of the client does

115 of the 125 features are implemented and working in-game. Open a category below to read what it does, then see the live registry with every description.

Visual

15

See the game your way — all client-side, all legitimate.

15 implemented →

HUD

17

A complete, editable heads-up display — drag, align and persist every element.

17 implemented →

Performance

8

A modular backend built around speed — with real telemetry, not marketing numbers.

8 implemented →

Social

6

Connect with the Hero Studios ecosystem — friends, parties, guilds and voice.

6 implemented →

Tools

8

Capture, create and automate.

8 implemented →

AI (BYOK)

5

Bring-your-own-key assistance across six providers — planned, not yet shipped.

0 implemented · 5 planned →

System

8

The plumbing that keeps the client stable, synced and self-healing.

8 implemented →

Accessibility

8

Built to be playable by everyone — six accessibility features wired end to end.

8 implemented →

Commands

6

A real command framework — parser, registry, completion engine and middleware pipeline.

6 implemented →

Configuration

6

Configurations that validate themselves and migrate cleanly.

6 implemented →

Combat

7

Classic client-side combat QoL — feedback you can actually read.

7 implemented →

Movement

6

Feel in your hands.

6 implemented →

Audio

4

Sounds that tell you what matters.

4 implemented →

Cosmetics

5

Look like yourself — cosmetics rendered entirely client-side.

4 implemented · 1 planned →

Developer

8

An open API for the whole client — configuration, events and HUD elements.

5 implemented · 3 planned →

Multi-Version

8

Real builds for every supported Minecraft release — never relabelled JARs.

7 implemented · 1 planned →

Keybind reference

Default keybinds

Defaults shipped with v2.2. Every bind is rebindable in the Keybind Editor — press M, then Keybinds. Click-to-rebind, conflict detection and per-row reset; your bindings persist between sessions.

General

ActionDefaultChange it in
Open mod menu M Mod menu → Keybinds → General
Open settings screen From mod menu Mod menu → Keybinds → General
Toggle HUD editor H Mod menu → Keybinds → General
Open quick commands bar G Mod menu → Keybinds → General

Visual

ActionDefaultChange it in
Zoom (hold) C Mod menu → Keybinds → Visual
Freelook (hold) Left Alt Mod menu → Keybinds → Visual
Fullbright toggle B Mod menu → Keybinds → Visual
Toggle freecam F4 Mod menu → Keybinds → Visual

HUD

ActionDefaultChange it in
Add waypoint P Mod menu → Keybinds → HUD

Tools

ActionDefaultChange it in
Screenshot Studio capture F2 Mod menu → Keybinds → Tools
Replay recording start / stop F8 Mod menu → Keybinds → Tools
Run selected macro F6 Mod menu → Keybinds → Tools

Social

ActionDefaultChange it in
Voice chat push-to-talk V Mod menu → Keybinds → Social
The mod menu itself is always M and is not rebindable — it is the one key that must work even when everything else conflicts. Keyboard navigation (Tab, Escape, arrow keys) is fully supported across every screen.

FAQ

Questions that actually come up

Including the one reason almost every "it doesn't work" report turns out to be.

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 plus experimental 26.1 through 26.3 builds — 17 releases in total, each with its own real JAR.
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 listed feature is implemented — no dead toggles — but expect some rough edges while the full 200-spec set is completed.
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.

Ready to install it?

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

Download Browse features See the roadmap