Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
Platforms
Tags
Creators
Details
Licensed ARR
Published 2 months ago
Updated 6 days ago
FoliaHoppers
Faster hoppers for Paper and Folia, with built-in lag protection.
Set how fast hoppers move items, and how many per move, while keeping vanilla hopper rules where they matter. Works with hopper minecarts.
Supports Paper and Folia 1.21.x - 26.x
Support: https://discord.gg/JTRzGaNdfK
Features
- Adjustable speed: choose how often hoppers move items and how many items move at once. Chests, barrels, shulker boxes, hoppers, droppers, dispensers, furnaces, crafters and chest/hopper minecarts are all supported.
- Vanilla rules kept: shulker boxes can't be placed inside shulker boxes, furnaces follow vanilla input and fuel rules, crafters spread items across slots, and locked hoppers stay locked.
- Special blocks left alone: composters, brewing stands, jukeboxes, lecterns, shelves, decorated pots and similar blocks keep normal Minecraft hopper behaviour.
- Folia support: region-safe scheduling, so hoppers work across region borders.
- TPS protection: when TPS drops below your threshold, hopper batches shrink automatically. If TPS gets too low, hoppers pause until the server recovers.
- Chunk heat throttling: tracks how many items each chunk moves over a sliding time window and slows hoppers in chunks that move too much.
- Configurable container types: pick which containers use the fast transfer. Names work as groups, so
CHESTcovers trapped chests, copper chests and chest minecarts.
Config

Commands
Alias: /fh. Permission: foliahopper.admin (op by default).
| Command | What it does |
|---|---|
/foliahopper info |
Show current settings |
/foliahopper reload |
Reload the config (a full restart is safest) |
/foliahopper speed <tick-cooldown> <batch-size> |
Set transfer speed |
/foliahopper tps |
Show TPS protection settings |
/foliahopper tps monitor true/false |
Turn TPS protection on or off |
/foliahopper tps threshold <value> |
TPS below which batches start shrinking |
/foliahopper tps halt <value> |
TPS at or below which hoppers pause |
/foliahopper heat |
Show chunk heat settings |
/foliahopper heat enabled true/false |
Turn chunk heat throttling on or off |
/foliahopper heat window <seconds> |
Length of the tracking window |
/foliahopper heat threshold <items> |
Items per window before a chunk is throttled |
/foliahopper heat factor <0.0-1.0> |
Minimum batch size in hot chunks, as a fraction |


