SyncBoost

Container delta synchronization & hopper idle polling optimization mod — Fabric / NeoForge / Forge

Basic Info

Property	Value
Mod ID	syncboost
Version	1.0.0
Author	mccmcaozr
License	All Rights Reserved (closed source)
Environment	Client + Server
Minecraft	>=1.21 (1.21 ~ 1.21.11, 26.1 ~ 26.2)
Java	21+

Loader Support

Loader	Minimum Version	JAR Filename
Fabric	Loader 0.15.0 + Fabric API	syncboost-fabric-1.0.0.jar
NeoForge	21.1.236	syncboost-neoforge-1.0.0.jar
Forge	52.1.15	syncboost-forge-1.0.0.jar

Compatibility

• Recommended: Sodium, Lithium
• Optional: Iris, Xaero's Minimap, Xaero's World Map, REI, JEI
• Conflicts: FastHopper (hopper optimization logic conflict)

Overview

SyncBoost optimizes meaningless server-side hopper polling when idle. Container GUI synchronization is left entirely to vanilla to ensure gameplay correctness.

Core Strategy (Delivery Safe Version)

1. Container Sync: Does not intercept sendContentUpdates(), avoiding revision / property / cursor protocol risks
2. Hopper Idle Skip: Only skips 2 ticks when ALL of the following are met:
   • Server-side
   • Hopper not on cooldown (transferCooldown == 0 / Mojang: cooldownTime == 0)
   • Hopper itself is empty
   • An Inventory / Container exists directly above
   • Content hash of the above Inventory has not changed
3. Cross-Dimension Isolation: Tracking key includes dimension hash to prevent same-coordinate crosstalk

What It Does NOT Do

• Does not rewrite container network synchronization
• Does not skip item pickup path (passes through to vanilla when no container above)
• Does not modify hopper cooldown semantics

Cross-Loader Mapping Differences

Fabric (Yarn)	NeoForge/Forge (Mojang)
HopperBlockEntity.transferCooldown	HopperBlockEntity.cooldownTime
ScreenHandler.onClosed	AbstractContainerMenu.removed
Inventory	Container
ServerPlayerEntity.networkHandler	ServerPlayer.connection
ScreenHandlerSlotUpdateS2CPacket	ClientboundContainerSetSlotPacket

Installation

1. Install the corresponding loader (Fabric / NeoForge / Forge)
2. For Fabric, also install Fabric API
3. Place the JAR file for your loader into the mods folder