💨 WarpHopper v2.0 – The Ultimate Routing Engine

"Precision Routing. Zero Lag. The Invisible Infrastructure for Your Minecraft Automations."

✔️ Round-Robin Logic • ✔️ Region Linking • ✔️ Admin Management • ✔️ High Performance • ✔️ Smart Filtering

MC Versions: 1.21.1 – 1.21.4
JAR Size: ~50 KB
API: PaperMC
Requirements: Java 21

🌐 What is WarpHopper?

WarpHopper is an enterprise-grade item distribution solution designed to replace messy, lag-inducing hopper lines with invisible, wireless connections. It transforms standard hoppers into intelligent gateways that beam items across your base directly into the containers they belong in, optimized for high-performance servers.

🚀 New in Version 2.0

Deterministic Round-Robin Routing — Items cycle evenly across linked containers in a strict sequence (#1 → #2 → #3). No more uneven distribution in your sorters.
Rapid Region Deployment — Select entire storage areas by clicking corner blocks. The engine automatically scans and deduplicates double-chests for instant bulk setup.
Collaborative Logistics — Add teammates as authorized Admins via the new management menu. They can manage filters and links without needing owner permissions.
Zero-Stall Performance Engine — Completely re-architected with Async Database Persistence and zero-latency caching to ensure a rock-solid 20.0 TPS.

⚙️ Core Capabilities

Triple Linking Modes — Use Single Link for quick setups, the Blaze Rod Wand for multi-clicks, or Region Mode for massive automated warehouses.
Intuitive 54-Slot GUI — A professional interface to manage ownership, view throughput stats, and configure routing rules in real-time.
Intelligent Overflow Management — If a targeted chest is full, WarpHopper automatically cycles to the next available link or fallback "Default" container.
Security & Safety — Integrated confirmation windows for de-registering hoppers prevent accidental data loss and link deletion.

📜 Command Architecture

WarpHopper v2.0 features a refined command suite for management and administration.

Command	Permission	Functionality
`/wh hopper`	`warphopper.use`	Convert the hopper you are looking at into a WarpHopper.
`/wh unregister`	`warphopper.use`	Decommission the hopper and purge its routing data (Secured with confirmation).
`/wh info`	`warphopper.use`	Display ownership, link saturation levels, and active admin lists.
`/wh addadmin <p>`	Owner / Admin	Grant a teammate management rights to your hopper.
`/wh removeadmin <p>`	Owner / Admin	Revoke management authorization from a player.
`/wh stats`	`warphopper.admin`	Monitor global throughput, total items warped, and network scale.
`/wh reload`	`warphopper.reload`	Force-refresh configurations and data with auto-field updating.

🖱️ Interaction Details

Right-Click your WarpHopper to open the 54-slot management GUI overview.
Add Filter: Hold an item in your hand and click the Filter icon.
Linking: Use the Blaze Rod wand or the new Region Mode in the GUI.

🛡️ Technical Specifications

Capacity: Up to 300 containers per individual hopper.
Storage: High-performance YAML database with off-thread saving.
Compatibility: Full support for Chests, Barrels, Shulkers, Droppers, and more.
Logic: Whitelist Filter -> Round-Robin Cycle -> Default Containers -> Internal Buffer.

Superior logistics. Optimized performance. Smarter storage.
Developed with Precision by BlackForgeStudio

Warp Hopper