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
| Requirement | Supported Target | Details |
|---|---|---|
| Server Platform | Paper 1.21+ | Compatible with Paper and forks (Purpur, Folia) |
| Java Environment | Java 21+ | Native Java 21 runtime required |
| Hard Dependencies | None | Standalone plugin (No Vault, ProtocolLib, etc.) |
| Text Formatting | MiniMessage | Native Adventure MiniMessage support |
Commands & Permissions
All administrative commands require the swifthopper.admin permission node (assigned to server OPs by default).
| Command | Permission | Description |
|---|---|---|
/swifthopper gui |
swifthopper.admin |
Opens the interactive 27-slot admin control menu |
/swifthopper setspeed <cooldown_ticks> [items_per_transfer] |
swifthopper.admin |
Sets the global transfer speed and bulk rate directly |
/swifthopper reload |
swifthopper.admin |
Reloads config.yml settings from disk |
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>."
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as SwiftHopper-1.0-.jar — drop this file into the mods folder
- Download size: 13 KB
- Download link checked 1 Oct 2026 — working
These come from our own check of the pack file, not from the source page.