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 <trait> <tier>.

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 <trait> [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 <name>	Renames the hopper; & colour codes are allowed	Owner
/rh access <public|private>	Sets who can open the hopper	Owner
/rh whitelist <add|remove|list> [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.<trait>	Can add one trait, e.g. realhoppers.trait.suction
realhoppers.limit.<number>	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_<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.}