Faster Hoppers

v2.0.2 - Changelog

• Added items-per-stack config — set how many items are pulled per slot per transfer
• Fixed items-per-transfer — now correctly cycles through slots per tick
• Worlds not in enabled-worlds now run at vanilla speed instead of freezing
  • Thanks to ronko_01 for reporting on discord.

A lightweight Paper/Spigot plugin that makes hoppers transfer items faster. Works on Minecraft 1.21.x+

How It Works

Vanilla hoppers transfer 1 item every 8 ticks (2.5 items/second). This plugin:

1. Cancels vanilla hopper transfers (via InventoryMoveItemEvent)
2. Runs its own transfer system at your configured speed
3. Handles both PUSH and PULL operations

Installation

1. Download FasterHoppers-2.0.2.jar
2. Put it in your plugins/ folder
3. Restart the server
4. Done! Hoppers are now 8x faster by default

Commands

| Command | Description |
|---------|-------------|
| /fh reload | Reload config and restart hopper task |
| /fh speed <ticks> | Set transfer speed (1-100) |
| /fh debug | Toggle debug mode |
| /fh info | Show current settings |

Permissions

| Permission | Description |
|------------|-------------|
| fasterhoppers.admin | Access to all commands |

Troubleshooting

Hoppers aren't faster after changing config

1. Make sure disable-vanilla-transfer: true is set
2. Run /fh reload (this restarts the task with new settings)
3. Enable debug mode: /fh debug - you should see transfer messages

Hoppers stopped working entirely

1. Check if hoppers are powered (redstone disables them)
2. Check enabled-worlds in config - empty list means all worlds
3. Check server console for errors

Server lag with many hoppers

Set max-hoppers-per-tick to limit processing:

performance:
  max-hoppers-per-tick: 500

Debug mode

Run /fh debug to enable. You'll see messages like:

[DEBUG] Pulled 1 items from above
[DEBUG] Pushed 1 items to DOWN
[DEBUG] Processed 24 hoppers this tick

Speed Reference

| transfer-speed | Transfers/sec | Multiplier |
|----------------|---------------|------------|
| 1 tick | 20/sec | 8x faster |
| 2 ticks | 10/sec | 4x faster |
| 4 ticks | 5/sec | 2x faster |
| 8 ticks | 2.5/sec | Vanilla |
| 20 ticks | 1/sec | Slower |

Requirements

• Paper/Spigot 1.21.x or newer
• Java 21+