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.

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

Optional Integrations

• WorldGuard — region exemptions
• Spark — pending hopper queue in /spark health

Compatibility

• Paper 1.21+
• Not supported on Spigot