HeroSync tutorial | Hero Studios

Install HeroSync #

Install Fabric Loader for 1.21 (plus Fabric API if the downloads page asks for it), place the JAR in your mods folder, and launch with the Fabric profile.

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.

Working with HeroSync #

Product-specific steps, separate from the general install guide above.

Run it

Fully client-side — no server mod needed. Place the JAR in mods and launch; it starts already armed.

Command suite

Control everything from chat:

/herosync status
/herosync transaction list
/herosync registration info
/herosync stats
/herosync debug overlay
/herosync reload

Settings file

Optional tuning lives in **config/herosync.json** (create it after first launch or via /herosync reload). F3+L toggles the debug overlay.

Folder locations by platform #

Platform	mods / resourcepacks folder	config folder
Windows	%appdata%\.minecraft\mods · \resourcepacks	%appdata%\.minecraft\config
macOS	~/Library/Application Support/minecraft/mods	~/Library/Application Support/minecraft/config
Linux	~/.minecraft/mods · ~/.minecraft/resourcepacks	~/.minecraft/config

MultiMC / Prism users: these folders live inside Instances/<instance>/.minecraft/. Match the build to your exact Minecraft version — the compatibility table in the docs lists every supported version.

Configure #

Settings live in the config folder (JSON5 files you can edit by hand) and, where available, in the in-game settings screen the mod adds. The exact keys and keybinds are listed in the documentation and the FAQ below.

Tips for HeroSync #

Keep HeroSync on the version range shown on its product page.
If it doesn't load, confirm the JAR is in the right mods folder for the launcher and version you chose.
Bedrock Edition, mobile, and console can't run Java Edition mods or packs — for a port or custom variant, request a commission.

HeroSync FAQ #

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.

Still stuck? Open a guided request — every message is tagged and answered from support@herostudios.dev. Always include your Minecraft version and product version.

HeroSync