# RealHoppers A GUI-based, simple and efficient hopper upgrade plugin. **[Discord](https://discord.gg/SK7M7f2YkV)** | **[Source Code](https://github.com/joserodpt/RealHoppers)** | **[Report a Bug](https://github.com/joserodpt/RealHoppers/issues)** --- ## 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](https://modrinth.com/plugin/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](https://www.spigotmc.org/resources/34315/) and an economy plugin (needed only for `AUTO_SELL` and tier upgrades) - *Optional:* [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi), [RealPermissions](https://github.com/joserodpt/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](https://discord.gg/SK7M7f2YkV)** | **[GitHub Issues](https://github.com/joserodpt/RealHoppers/issues)** _{*This plugin uses bStats to collect anonymous usage statistics. You can turn this off in `plugins/bStats/config.yml`.*}

RealHoppers

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

RealHopper screen

RealHoppers settings

RealHoppers traits settings dialog