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 CHEST covers trapped chests, copper chests and chest minecarts.

---

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