Woppers

Woppers adds item filters and custom transfer speeds to normal Minecraft hoppers.

Rename a hopper in an anvil, place it, and you're done.

No custom blocks, no client mod, and no setup menu needed for normal players.

Hopper Names

Lower cooldowns are faster.

Item Filters

Use the Minecraft material name as the hopper name:

IRON_INGOT
DIAMOND
NETHERITE_INGOT

Multiple items can be joined with +:

IRON_INGOT+GOLD_INGOT
DIAMOND+EMERALD

Transfer Speed

Use */ followed by the cooldown in ticks:

*/4
*/8
*/20

Filters and speeds can be combined:

IRON_INGOT/4
COBBLESTONE/16
IRON_INGOT+GOLD_INGOT/8

Item Data Filters

Woppers can also filter more specific items using their data.

STICK{custom_model_data:1001}/4
PAPER{lore_contains:"Ticket"}/8
DIAMOND_SWORD{enchants:[sharpness:5]}/4

Item data filtering can be turned off by the server owner if it isn't needed.

Admin Panel

Server admins can use:

/woppers

The panel lets you manage:

• Item filtering
• Speed control
• Item data filters
• Minimum and maximum cooldowns
• Player usage permissions
• Naming guide
• Configuration reload

Players don't need the panel to use Woppers.

Vanilla Behavior

Hoppers without a valid Woppers name behave like normal vanilla hoppers.

The rule is read from the hopper's own name, so configured hoppers keep their setup through chunk unloads and normal server restarts.

Compatibility

• Paper 1.21.11 through 26.2
• Java Edition
• Geyser and Floodgate
• Existing worlds
• Fully server-side

Installation

1. Put the Woppers .jar in your server's plugins folder.
2. Start or restart the server.
3. Rename a hopper in an anvil and place it.

That's it.

Paper Configuration

Woppers uses Paper's hopper inventory move event.

Make sure this remains disabled:

hopper:
  disable-move-event: false

Setting it to true prevents Woppers from receiving the hopper movement event it needs.

Commands

Permissions

License

Copyright © 2026 WafflyCatt.

All Rights Reserved.

Author

Made by WafflyCatt.