RealHoppers

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

• 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.

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


Photos




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

• /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
• /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

Permissions

• 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.

• %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.