Protect server TPS from hopper farms — without breaking normal sorting
A revolutionary TPS protection plugin that introduces a completely different approach to hopper lag control.
Instead of globally nerfing every hopper on the server, ChestToHopperLimit intelligently targets only overloaded hot chunks and dynamically slows chest/barrel → hopper pulls only when necessary — preserving gameplay while aggressively protecting TPS.
By slowing only chest/barrel pull operations, the plugin can significantly reduce lag caused by massive storage sorters, item transport systems, and large hopper networks without breaking farms or normal sorting behavior.
What it does
ChestToHopperLimit slows chest / trapped chest / barrel → hopper item pulls when your server needs it.
Hopper push (output sorting) is not affected.
Designed for survival servers with large item farms, limiting applies only where needed instead of globally across the server.
- TPS-linked or always-on
- Hot chunk targeting
- Separate hopper & hopper minecart settings
- Per-world exemptions
- Optional action bar warnings
- Inspect & debug commands
- Paper & Spigot 1.21+
- Spark support (optional)
How limiting works
Code (Text):
limit = enabled
AND trigger active
AND not exempt world
AND (chunk is hot OR chunk_limit disabled)
Only then are chest/barrel → hopper pulls slowed in that area.
The plugin uses its own cooldown timing and does not modify vanilla hopper transfer cooldowns.
Commands
- /cthl reload
- /cthl status
- /cthl inspect
- /cthl top [count]
- /cthl where
- /cthl tp <world> <chunkX> <chunkZ>
Aliases:
/chesttohopperlimit, /ctl
Permissions
- chesttohopperlimit.admin
- chesttohopperlimit.inspect
Configuration
Code (Text):
enabled: true
limit_trigger: tps
tps_link:
engage_below: 19.0
engage_seconds: 10
recover_margin: 0.5
recover_seconds: 30
startup_grace_seconds: 120
chunk_limit:
enabled: true
window_seconds: 10
transfers_per_window: 30
radius_chunks: 3
include:
hopper_blocks: 64
hopper_minecarts: 16
exempt:
worlds: []
actionbar:
enabled: true
message: "&eChest-to-hopper pull limiting active in this area"
debug: false
Spoiler: Paper note
Set
hopper.disable-move-event: false in
paper-global.yml.
If enabled, Paper skips hopper move events and the plugin cannot limit pulls.
If enabled, Paper skips hopper move events and the plugin cannot limit pulls.
Support
Found a bug or have a suggestion? Leave a review or comment on this resource page.
If you encounter any bugs, compatibility issues, or have suggestions for improvements, please leave a review or comment.
I’m actively working to improve server performance and reduce lag as much as possible, and feedback from real servers helps a lot.
Discord
Join the Discord Server
Author: nanjyasorya_z
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ChestToHopperLimit is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1. Downloaded 11 times (via Spigot). Download it and open it directly in the game.