CryoHoppers - Ultra fast hoppers v1.0.0

Cryo Series · Hopper optimizer plugin

Batched deferred transfers, chain-skip through hopper lines,
TPS/MSPT guard, chunk heat, per-world rules, admin GUI.
$8.99 USD · one-time · Paper / Spigot 1.8 – 1.21.x & 26.x · Folia

================================================================================
OVERVIEW
================================================================================
CryoHoppers is the Cryo Series hopper optimizer for Paper and Spigot. It replaces
vanilla 1-item/tick hopper cadence with Paper-safe deferred batch transfers,
walks multi-hopper chains to terminal containers in one move, and throttles
work when TPS/MSPT drop or chunks overheat. Per-world YAML rules, staff bypass
zones, an admin settings GUI, and live stats — all config-driven with hot reload.

8 items/tick (default) | Chain skip | Performance guard
Chunk heat limits | Admin GUI | Folia supported

================================================================================
PLATFORMS
================================================================================
Paper · Spigot · Folia
Minecraft 1.8 through 1.21.x and 26.x

================================================================================
FEATURES
================================================================================
[Batch defer] Cancel vanilla InventoryMoveItemEvent only after a successful
batch; apply slot transfers on next tick — avoids Paper setItem
duplication bugs

[Chain skip] Walk hopper output facing to find chain end; transfer source →
terminal container in one deferred move. Mute intermediate
hopper events and sync cooldowns on skipped blocks

[Performance Rolling TPS/MSPT averages trigger emergency mode — slower
guard] transfer intervals, smaller batches, tighter per-chunk caps
until server recovers

[Chunk heat] Sliding window tracks item moves per chunk; hot chunks get
reduced batch sizes and transfer caps automatically

[Per-world transfer-interval-ticks, max-items-per-transfer,
rules] max-transfers-per-chunk-per-tick per world; disable hoppers
in specific dimensions

[Bypass zones] Staff with cryohoppers.bypass get relaxed limits within
configurable radius — farms, creative testing, events

[Optimizations] idle-fast-path · intermediate-event-mute ·
chunk-defer-coalescing · player-proximity skip

[NMS bridge] Hopper cooldown sync via Bukkit setTransferCooldown (1.21+,
26.x) or NMS field reflection (1.16.5) — keeps vanilla cadence

[Admin GUI] /cryohoppers gui — global toggles, world rules, stats panel
Vertex MiniMessage styling

[Metrics] Transfer counters, chain-skip hits, idle skips, proximity
skips, NMS bridge mode — GUI and /cryohoppers stats

================================================================================
COMMANDS
================================================================================
Aliases: /choppers · /cryohopper

/cryohoppers gui Open admin settings GUI
/cryohoppers stats Print live TPS/MSPT and transfer metrics
/cryohoppers world <world> Open per-world settings GUI
/cryohoppers reload Reload config and locale

================================================================================
PERMISSIONS
================================================================================
cryohoppers.use Base command access (default: op)
└─ cryohoppers.gui Open settings GUI (default: op)
└─ cryohoppers.stats View stats output (default: op)

cryohoppers.reload Reload plugin (default: op)
cryohoppers.admin Full admin — grants gui, stats, reload (default: op)
cryohoppers.bypass Relaxed hopper limits in bypass radius (default: op)

================================================================================
CONFIG HIGHLIGHTS (config.yml v3)
================================================================================
chain-skip.enabled: true
compatibility.vanilla-hopper-to-hopper: false # required for chain batching
optimizations.idle-fast-path: true
optimizations.intermediate-event-mute: true
optimizations.chunk-defer-coalescing: true
performance-guard.enabled: true
chunk-heat.enabled: true
global.nms-cooldown-sync: true

plugins/CryoHoppers/
config.yml Behavior, worlds, guard, heat, bypass
locale/en.yml MiniMessage chat messages

================================================================================
WHY CRYOHOPPERS?
================================================================================
+ Up to 8 items per transfer tick vs vanilla 1
+ Chain-skip through hopper lines — one move to terminal chest
+ Paper-safe deferred transfers — no duplication from setItem batching
+ TPS/MSPT performance guard with emergency throttling
+ Chunk heat limits for overloaded farm chunks
+ Per-world rules, bypass zones, hopper minecart support
+ Admin GUI + live stats without editing YAML
+ Folia + 1.8 → 1.21.x & 26.x with NMS cooldown bridge
+ $8.99 one-time (not subscription)

================================================================================
SETUP (quick)
================================================================================
1. Drop CryoHoppers-1.0.0.jar into plugins/ and restart
2. Set compatibility.vanilla-hopper-to-hopper: false for chain batching
3. Tune worlds.default max-items-per-transfer and transfer-interval-ticks
4. /cryohoppers gui — verify settings and watch stats

Reload live: /cryohoppers reload

================================================================================
Cryo Series — CryoHoppers · $8.99 one-time
================================================================================