Hero Client Docs

~2 min read v2.2 Fabric

Overview #

Hero Client is the Hero Studios client — a feature-rich modular Fabric client with 50+ toggleable features: performance, visuals, HUD overlays, BYOK AI assistance, social tools, marketplace access and cloud sync. It installs like any Fabric mod and runs as a Lunar-style mod menu (press M).

Most clients focus on a single feature or a locked-in experience. Hero Client is a feature-rich modular client with 50+ toggleable features — performance, visuals, HUD, social, marketplace, and cloud sync — 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.

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 plus experimental 26.x builds.
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.
Is it stable yet?
Version 2.1 is the first build that launches without crashes on clean installs. It is now in beta — still expect some rough edges while all 200 feature specs are completed.

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, 26.1, 26.1.1, 26.1.2, 26.2, 26.3
Latest version2.2

Per-version builds ship as separate Fabric JARs — install the one matching your Minecraft version. Java 21 for 1.21.x, Java 25 for 26.x. All 17 releases supported.

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.