SyncBoost

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

1. 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