RealHoppers

RealHoppers

A GUI-based, simple and efficient hopper upgrade plugin.

Discord | Source Code | Report a Bug

What is RealHoppers?

RealHoppers gives an ordinary hopper a job. Place a hopper, right-click it, and give it one or more traits. A hopper can send items to another hopper across the map, teleport players who step on it, break the block above it, kill mobs standing on it, or sell everything it collects straight into its owner's balance.

Features

• 14 traits that can be combined on the same hopper
• One GUI panel per hopper for its contents, balance, XP, traits and settings
• Upgradeable tiers, each with its own power and price, paid through Vault integration
• Hopper linking with a stick, with the connection highlighted while you link
• Ownership and access: public or private hoppers with a whitelist
• Per-player hopper limits set by permission
• Private hoppers can keep their owner and contents when broken
• Per-trait permissions, so you decide which traits each rank can use
• Material filter with a paginated picker for every material
• Uses the server's own furnace and crafting recipes, so datapack recipes work too
• On 1.21.6+, native dialogs for typed input and confirmations (uses chat on older versions)
• SQLite and MySQL storage
• PlaceholderAPI and RealPermissions support
• Fully configurable YAML config and language files

Traits

Trait · What it does
TELEPORT · Sends a player who steps onto the hopper to the hopper it's linked to.
ITEM_TRANSF · Pushes its contents into the linked hopper. Works as a wireless item pipe.
SUCTION · Pulls in dropped items from the blocks around it.
BLOCK_BREAKING · Breaks the block above it and collects the drop.
KILL_MOB · Damages mobs standing on it and collects their drops.
MOB_PULL · Drags nearby mobs onto the hopper. Pair it with KILL_MOB for a one-block grinder.
AUTO_SELL · Sells whatever doesn't fit into a balance the owner collects later.
AUTO_SMELT · Smelts what it takes in, e.g. cobblestone into stone and ore into ingots.
AUTO_COMPACT · Turns nine ingots into a block, nine nuggets into an ingot, and so on.
HARVEST · Cuts fully grown crops around it and replants them.
GROW · Speeds up crops around it, like bonemeal.
XP_COLLECT · Collects nearby experience orbs and stores them until someone claims them.
VOID · Destroys whatever doesn't fit instead of dropping it.
FILTER · Decides what the hopper keeps. The rest goes on to AUTO_SELL or VOID.

How traits work together

Every item that enters a hopper goes through its traits, whether RealHoppers put it there (suction, block breaking, harvesting, mob drops) or vanilla did (a chest above, another hopper feeding in). The order is always the same:

smelt it → store it if it fits → sell it if it doesn't → void it if it still has nowhere to go → otherwise drop it (when Drop-Items-If-Full is on).

Some combinations:

• TELEPORT + ITEM_TRANSF: a hopper has one link, and both traits use it, so a linked pair can teleport players and move items at the same time.
• MOB_PULL + KILL_MOB: a complete mob grinder in a single hopper.
• FILTER + AUTO_SELL: keep what's listed and sell the rest.
• FILTER + VOID: keep what's listed and destroy the rest.
• AUTO_SMELT or AUTO_COMPACT + AUTO_SELL: sells the smelted or compacted item, not the raw material.

Tiers

Most traits have tiers. Each tier has a power, which multiplies what the trait does, and a price, which the player pays through Vault to upgrade. Tiers are set per trait in config.yml, so each trait can have as many tiers as you want, and the powers don't need to go up evenly.

Players upgrade a trait by right-clicking it in the hopper's panel. Admins can set any tier for free with /rh settrait .

What each tier multiplies

Trait · Power multiplies
SUCTION · Pickup radius
BLOCK_BREAKING · How many blocks up the column it breaks
KILL_MOB · Damage per cycle
ITEM_TRANSF · Items moved per cycle (the default top tier moves a full stack)
AUTO_SELL · Sell price multiplier
MOB_PULL · Pull radius
HARVEST / GROW · Crop radius
AUTO_COMPACT · Compacting passes per cycle
XP_COLLECT · Orb pickup radius

TELEPORT, AUTO_SMELT, VOID and FILTER have no tiers.

Getting Started

1. Place a hopper. It's registered automatically.
2. Right-click it to open its panel.
3. Click a trait to add it, and click it again to remove it. Right-click a trait to buy its next tier.
4. To link two hoppers, hold a stick, right-click the first hopper, then right-click the one it should point to.
5. Click the hopper icon in the panel to collect the balance: left-click takes half, shift-left-click takes all.

Commands

Base commands: /realhoppers, /rh

Command · Description · Who
/rh reload · Reloads the config and language files · Admin
/rh settrait [tier] · Gives the hopper you're looking at a trait · Admin
/rh info · Shows the name, owner, access and whitelist of the hopper you're looking at · Everyone
/rh name · Renames the hopper; & colour codes are allowed · Owner
/rh access · Sets who can open the hopper · Owner
/rh whitelist [player] · Manages a private hopper's whitelist · Owner
/rh list [player] · Lists the hoppers a player owns · Everyone

Permissions

Permission · Description
realhoppers.admin · Full access, bypasses every ownership check
realhoppers.trait.* · Can add every trait
realhoppers.trait. · Can add one trait, e.g. realhoppers.trait.suction
realhoppers.limit. · Maximum number of hoppers the player can own
realhoppers.limit.none · No hopper limit
realhoppers.keepcontents · A broken private hopper keeps its owner and contents

Placeholders

Requires PlaceholderAPI.

Placeholder · Value
%realhoppers_hoppers% · Number of registered hoppers
%realhoppers_owned% · Number of loaded hoppers the player owns
%realhoppers_balance% · Total balance across all hoppers
%realhoppers_trait_% · Number of hoppers with a trait, e.g. %realhoppers_trait_SUCTION%
%realhoppers_version% · Plugin version

Requirements

• Java 16+
• Vault and an economy plugin (needed only for AUTO_SELL and tier upgrades)
• Optional: PlaceholderAPI, RealPermissions

Installation

1. Put the jar in your plugins folder.
2. Restart the server.
3. Edit plugins/RealHoppers/config.yml and run /rh reload.

Need help or found a bug?

Please don't use the comments for bug reports. Get in touch through:

Discord | GitHub Issues

This plugin uses bStats to collect anonymous usage statistics. You can turn this off in plugins/bStats/config.yml.