Sueta

FoliaHopper

4.0

Tune hopper transfer rate and stack batching

·Plugin

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.

Config

config
config
config
config
config
config


Commands

Alias: /fh. Permission: foliahopper.admin (op by default).

CommandWhat it does
/foliahopper infoShow current settings
/foliahopper reloadReload the config (a full restart is safest)
/foliahopper speed <tick-cooldown> <batch-size>Set transfer speed
/foliahopper tpsShow TPS protection settings
/foliahopper tps monitor true/falseTurn 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 heatShow chunk heat settings
/foliahopper heat enabled true/falseTurn 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

Similar projects

Plugin →