Loopix Custom Hopper

Lightweight Paper 1.21 – 26.2 plugin that replaces vanilla hopper transfer with a fast, safe custom engine — optimized for high-speed item transport and Crafter compatibility.

Overview

Vanilla hoppers move ~2.5 items per second. Loopix Custom Hopper moves **8 items per transfer cycle**, configurable up to **48**, with safe and predictable item handling.

Features

Fast transfer — 8 items per cycle by default.
Custom speed— Configure speeds from 1 to 48.
Crafter support — Disabled Crafter slots remain locked.
Crafter output — Crafted items move normally into connected hoppers.
Safe transfers — Prevents item duplication and item loss.
Exact transfers — Only accepted items are transferred.
Admin GUI — Change hopper speed through an easy GUI.
Custom messages — Edit messages, titles, names, and lore.
Tested — Includes automated transfer and inventory tests.

Commands

Aliases: `/hopper`, `/ahopper`

Permissions

`loopixhopper.admin` — Access to all commands and the admin GUI.

Config

Everything is documented inside `config.yml`.

Customize:

* Hopper speed
* Transfer interval
* Chat messages
* GUI titles
* GUI item names
* GUI lore
* `&` color codes

Use `/loopixhopper reload` after editing.

Install

1. Download the `.jar`.
2. Place it in your `plugins/` folder.
3. Restart the server.
4. Use `/loopixhopper admin` or `/loopixhopper set 16`.

Requires **Paper 1.21+** (Java 21+). Supports every version from **1.21.0 to 26.2**, including **26.1 and 26.2**.

Compatible with Paper forks such as **Purpur**.

Support

When reporting an issue, include:

* Speed setting
* Block layout
* Item types
* Server version
* Relevant error messages

Changelog

1.0.1 — 2026-08-13

Added

* Support for Minecraft 26.1 and 26.2 (built against the latest Paper API).

Fixed

* Pull logic no longer steals ingredients from Crafters above hoppers.
* Crafter ejection is now exempted precisely (only Crafter-initiated moves).

Verified

* Rebuilt against Paper 26.2 API while keeping Java 21 bytecode.
* Every used API method cross-verified on 1.21.11 and 26.2.
* All 11 automated tests still pass.

1.0.0 — 2026-08-12

Added

* Fully rewritten Loopix Custom Hopper plugin.
* Renamed from its closed-source predecessor.
* No original code or assets used.
* New documented `config.yml`.
* Professional configuration layout.

Fixed

* NoSuchMethodError on Paper 1.21.11.
* Item duplication on partially full destinations.
* Incorrect Crafter output handling.
* Crafting stalls caused by ingredient removal.
* Disabled Crafter slots ignored during transfers.

Verified

* 11 automated tests.
* Stackable items.
* Non-stackable items.
* Max-stack-16 items.
* NBT-distinct items.
* Partial inventories.
* Disabled Crafter slots.
* 10,000-cycle transfer test.

Copyright

© 2026 Loopix Dev. All rights reserved.

Loopix Custom Hopper is an original project by Loopix Dev.