Download

Hero Client

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

Hero Client downloads are per Minecraft version. Installs, launcher builds, Java requirements and every supported Minecraft version are listed below — one JAR per release.

Hero Client 2.2.3

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.

Download latest
BuildFileSizeSHA-256Get
1.21.11 HC-2.2.3-1.21.11.jar 5.58 MB 6a1023c6ae09… JAR
1.21.10 HC-2.2-1.21.10.jar 5.06 MB 283e070d3030… JAR
1.21.9 HC-2.2-1.21.9.jar 5.06 MB 5ed9255d2f23… JAR
1.21.8 HC-2.2-1.21.8.jar 5.06 MB fb79ff849c6d… JAR
1.21.7 HC-2.2-1.21.7.jar 5.06 MB 18320f9f77db… JAR
1.21.6 HC-2.2-1.21.6.jar 5.06 MB 3eeb3cb450ad… JAR
1.21.5 HC-2.2-1.21.5.jar 5.06 MB 810a6a3581cb… JAR
1.21.4 HC-2.2-1.21.4.jar 5.06 MB f26a92ac38ff… JAR
1.21.3 HC-2.2-1.21.3.jar 5.06 MB 6d809324fee6… JAR
1.21.2 HC-2.2-1.21.2.jar 5.06 MB 470e8032171c… JAR
1.21.1 HC-2.2-1.21.1.jar 5.06 MB 3badf7561fd9… JAR
1.21 HC-2.2-1.21.jar 5.06 MB 34ea00862dae… JAR

Click a SHA-256 hash to copy it, then verify your download matches.

Downloads are provided under the HBBML license. Install instructions are in the documentation. Always verify the SHA-256 checksum of downloaded files.

Version history & known issues

All versions, every note

Every release of Hero Client with its warnings and known errors. The table above lets you download any version's files.

2.2.3 2026-11-03 Download files →

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 Download files →

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 Download files →

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 Download files →

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)
Requires Java 21 for 1.21.x, Java 25 for 26.x
Fixed: UpdateInfo reporting
2.1 2026-09-28 Download files →

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)
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 Download files →

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
Development milestones — no tagged release artefacts
Fixed: database lock crash on startup (AUTO_SERVER enabled)
Could not copy — select the hash manually.