Hero Client Docs

~2 min read v2.2 Fabric

Overview #

Hero Client is the Hero Studios client — a feature-rich modular Fabric client with 127 registered features across 16 categories: performance, visuals, HUD overlays, social tools and more — each carrying its real lifecycle. It installs like any Fabric mod and runs as a Lunar-style mod menu (press M). BYOK AI assistance is planned for Phase 2.

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.

Quick start #

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

Frequently asked questions #

Which Java version do I need?
Java 21. 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 today — 12 releases, each with its own JAR. Experimental 26.x builds 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.
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 — 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.

Compatibility #

PropertyValue
Loader / platformFabric
Minecraft versions1.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
Latest version2.2

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.

Learn more. Step-by-step walkthroughs live in the tutorials, with install guides for every platform and a general guide to configuration. Still stuck? Open the support portal and we'll reply from support@herostudios.dev.