SwiftHopper is a high-performance, lightweight Paper plugin built specifically for Paper 1.21+ and Java 21. It gives server administrators global control over hopper transfer speeds and item amounts across their entire server network.

Unlike older plugins that run heavy global background tasks or repeating tick loops, SwiftHopper hooks directly into native Paper inventory transfer events. This guarantees minimal CPU usage and eliminates server tick lag, even on large networks with thousands of active hoppers.

Technical Specifications & Requirements

Commands & Permissions

All administrative commands require the swifthopper.admin permission node (assigned to server OPs by default).

Command Aliases: /shopper, /fasthopper

Configuration File (config.yml)

The default configuration file handles global settings and chat outputs. All text entries support Adventure MiniMessage tags.

﹟ =========================================================
﹟                   SwiftHopper Config
﹟ =========================================================

prefix: "<#2b2d42>[<#00d2d3>SwiftHopper<#2b2d42>] <#f8f9fa>"

﹟ Server-wide Hopper Settings
transfer-cooldown: 4  ﹟ Cooldown in ticks between item transfers (Vanilla default: 8)
check-cooldown: 4     ﹟ Cooldown in ticks when checking empty slots (Vanilla default: 8)
items-per-transfer: 2 ﹟ Number of items moved per transfer cycle (Vanilla default: 1)

messages:
  no-permission: "<#ff6b6b>You do not have permission to use this command."
  player-only: "<#ff6b6b>This command can only be executed by a player."
  reload-success: "<#1dd1a1>Configuration reloaded successfully!"
  speed-updated: "<#1dd1a1>Global hopper settings set to: Cooldown: <#00d2d3><cooldown>t<#1dd1a1> | Rate: <#00d2d3><amount> items/cycle<#1dd1a1>."