Overview #
HeroSync is a client-side latency-compensation framework. It does not reduce your ping — it reduces what your ping feels like. Actions register instantly on your side, then reconcile cleanly with the server so you stay in sync without a server mod.
Network latency makes otherwise-fine gameplay feel heavy. HeroSync removes that feeling client-side: your actions register instantly, then reconcile with the authoritative server — rolling back cleanly when the server disagrees.
Quick start #
- Download the HeroSync JAR for your Minecraft version.
- Place it in your Fabric mods folder (Fabric API recommended).
- Join any server — actions now feel responsive immediately.
- Tune or disable features from the in-game settings screen.
- Keep the JAR matched to your Minecraft version for best results.
Frequently asked questions #
Does this work on servers without the mod?
Yes. HeroSync is client-side and requires nothing on the server.
Will it get me banned?
It compensates for latency like predictive clients do — it never fabricates confirmations. Always check server rules first.
Which versions are supported?
1.21 through 1.21.11 plus 26.x builds.
Does it change my actual ping?
No — it changes how lag feels by making your inputs register locally (0ms perceived delay).
Can I turn it off?
Yes — individual features and the whole framework can be disabled from config/herosync.json.
How much does it affect performance?
It keeps a sub-2ms per-client-tick performance budget.
Is there a command interface?
Yes — /herosync exposes status, transaction lists, registration toggles, stats, a debug overlay (F3+L) and reload.
Can other mods integrate with it?
Yes — it ships a developer API (HeroSyncAPI) with registration rules, packet classifiers, snapshot providers and compatibility adapters.
Compatibility #
| Property | Value |
|---|---|
| Loader / platform | Fabric |
| 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 |
| Latest version | 1.4.0 |
26.x builds are experimental (bundled-mappings).
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.