HopperFlowLimiter

# HopperFlowLimiter TPS-aware hopper throttling for Paper servers. HopperFlowLimiter reduces lag caused by massive hopper systems, item sorters, storage networks, and automated farms — without permanently blocking item movement. Designed especially for survival servers with around 20–30 players that struggle with TPS drops caused by large redstone and hopper-based infrastructure. Unlike hard limiter plugins, HopperFlowLimiter is built to avoid breaking farms and multi-item sorting systems as much as possible. Transfers are delayed with cooldowns instead of deleting items or completely disabling hoppers. ## Features - TPS-aware throttling - Hotspot-based limiting - Chunk-aware optimization - No item deletion - Designed to preserve vanilla behavior as much as possible - Supports large automated factories and sorter systems - Global or localized limiting modes - Optional WorldGuard integration - Optional Spark integration - Paper-only optimization ## Example  ## How it works - **Hoppers:** extends vanilla `transferCooldown` after a successful pull - **Droppers:** output (and optionally input) is denied during cooldown Limiting only applies when the configured trigger and scope match. | When | Where | |------|-------| | `tps` — only when TPS is low | `global` — entire server | | `always` — always active | `hotspot` — overloaded chunks only | ## Recommended Mode `tps + hotspot` Only overloaded factory areas are slowed when server TPS drops, helping preserve normal gameplay elsewhere. ## Perfect for - Large survival servers - Massive storage systems - Multi-item sorters - Industrial farms - Item transport networks - Automation-heavy player worlds ## Commands | Command | Permission | |---------|------------| | `/hfl reload` | `hopperflowlimiter.admin` | | `/hfl status` | `hopperflowlimiter.inspect` | | `/hfl inspect` | `hopperflowlimiter.inspect` | | `/hfl top [n]` | `hopperflowlimiter.inspect` | | `/hfl where` | `hopperflowlimiter.inspect` | ## Optional Integrations - **WorldGuard** — region exemptions - **Spark** — pending hopper queue in `/spark health` ## Compatibility - Paper 1.21+ - Not supported on Spigot