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)
- Container Sync: Does not intercept
sendContentUpdates(), avoiding revision / property / cursor protocol risks - 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
- 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
- Install the corresponding loader (Fabric / NeoForge / Forge)
- For Fabric, also install Fabric API
- Place the JAR file for your loader into the
modsfolder
