# \u2728 Why admins love it<\/p>\n
– One smart hopper per system \u2192 far fewer ticking blocks, lower server load.
\n– Remote routing across the same world with priorities, filters, round-robin\/fill-first.
\n– Lag-aware batching, skips blocked\/unloaded targets, optional bounded retry queue.
\n– Claim & trust built-in (or hook your region plugin); admin bypass supported.
\n– No commands needed for normal play \u2014 everything via a clear in-game GUI.
\n– Optional power system (free, redstone, or fuel chest \u2192 power units).
\n– Demo: YouTube \u2013 Quick Tour<\/p>\n
—<\/p>\n
# \ud83d\udce6 Requirements & Compatibility<\/p>\n
– **Hard dependency:** **Vault** (for economy; needed for smelter unlocks & upgrades).<\/p>\n
– **Soft dependencies:**
\n – **DecentHolograms** \u2014 floating HUD above nodes (ACTIVE\/IDLE, last transfer, power).
\n – **LuckPerms** \u2014 dynamic, permission-based limits.
\n – **SuperiorSkyblock2** or **BentoBox** \u2014 per-island limits & trust interop.<\/p>\n
– **Servers:** Paper\/Spigot 1.20+ (API 1.21 targeted).<\/p>\n
– **Regions:** Works with GriefPrevention\/WorldGuard; ships a lightweight internal claim system if absent.<\/p>\n
—<\/p>\n
# \ud83d\ude80 What it does (Core Features)<\/p>\n
### Remote Item Routing
\nLink one Improved Hopper to many containers in the same world. Configure:<\/p>\n
– Per-target priority (higher first)
\n– Whitelist\/blacklist item filters
\n– Distribution: Round-robin or Fill-first<\/p>\n
### Full In-Game GUI
\nRight-click: manage links, filters, power, trust, stats, simulate routes, toggle visuals.<\/p>\n
### Chat Search for Filters
\nClick the compass, type to search; Esc or \u201ccancel\u201d to exit.<\/p>\n
### Power Modes
\n– None: free operation
\n– Redstone: `requireRedstonePower` or `pauseWhenPowered`
\n– Fuel: link a Fuel Chest; fuel items convert to Power Units based on distance & amount<\/p>\n
### Trust & Claims
\nHoppers must be claimed; owner can `\/trust` users; admins bypass. Crafted nodes auto-claim.<\/p>\n
### Lag-Aware Batching
\nPer-tick caps & smart skipping of empty inputs\/blocked\/unloaded targets.<\/p>\n
### Visual Tools
\nParticle beams to targets; transfer trails; filter-focus visualization.<\/p>\n
### Built-in Smelter (optional)
\nVirtual smelting with Vault unlock & upgrades.<\/p>\n
### Craftable
\nRecipes configurable for both Improved Hopper and Fuel Chest.<\/p>\n
—<\/p>\n
# \ud83d\udee0\ufe0f Installation<\/p>\n
1. Place the JAR in `\/plugins`.
\n2. Ensure Vault is installed and an economy plugin is active.
\n3. (Optional) Install DecentHolograms, LuckPerms, and your Skyblock plugin.
\n4. Start server. Edit `\/plugins\/ImprovedHoppers\/config.yml` if desired.
\n5. `\/improvedhoppers reload` to apply changes.<\/p>\n
—<\/p>\n
# \u26a1 Quick Start (Player)<\/p>\n
1. Craft an Improved Hopper (and a Fuel Chest if using Fuel mode).
\n2. Place & Claim the hopper (crafted nodes auto-claim).
\n3. Open GUI \u2192 Add Targets \u2192 click containers to link
\n Tip: `\/improvedhoppers wand` for fast multi-link.
\n4. Set filters, priorities, and distribution mode.
\n5. Choose Power Mode. If Fuel, link Fuel Chest and insert fuel.
\n6. (Optional) Add redstone depending on redstone settings.<\/p>\n
—<\/p>\n
# \u2328\ufe0f Commands<\/p>\n
| Command | Description | Permission |
\n|———————————|——————————————|—————————————————————–|
\n| `\/improvedhoppers` | Show subcommands | (none) |
\n| `\/improvedhoppers wand` | Get link wand for multi-linking | `improvedhoppers.user.wand` |
\n| `\/improvedhoppers settings` | Open settings (node or admin view) | `improvedhoppers.user.settings` \/ `improvedhoppers.admin.settings` |
\n| `\/improvedhoppers remote` | Remote controller (view\/manage anywhere) | `improvedhoppers.user.remote` |
\n| `\/improvedhoppers reload` | Reload config | `improvedhoppers.admin.reload` |
\n| `\/improvedhoppers power apply` | Re-apply power settings | `improvedhoppers.admin` |<\/p>\n
—<\/p>\n
# \ud83d\udd10 Permissions<\/p>\n
## User
\n– `improvedhoppers.user.wand` (default: true)
\n– `improvedhoppers.user.settings` (default: true)
\n– `improvedhoppers.user.remote` (default: true)
\n– `improvedhoppers.user.*` (default: true)
\n– `improvedhoppers.user.restore` (default: true)<\/p>\n
## Admin
\n– `improvedhoppers.admin` (default: op) \u2014 moderation bypass
\n– `improvedhoppers.admin.reload` (default: op)
\n– `improvedhoppers.admin.settings` (default: op)
\n– `improvedhoppers.admin.*` (default: op)<\/p>\n
## Limits (override config) —<\/p>\n # \ud83e\uddea Crafting<\/p>\n **Improved Hopper \u2014 shaped recipe (all items configurable)**<\/p>\n “` **Fuel Chest \u2014 configurable (e.g., coal + chest)** —<\/p>\n # \u2699\ufe0f Config Highlights (sample)<\/p>\n “`yaml claims: routing: transfer: power: smelter: limits: storage: > Note: Vanilla `InventoryMoveItemEvent`\/`InventoryPickupItemEvent` are cancelled for claimed nodes to avoid conflicts.<\/p>\n —<\/p>\n # \ud83e\udded Routing Logic (at a glance)<\/p>\n 1. Pull up to `per_tick_item_cap` from source inventory. —<\/p>\n # \ud83d\udcc8 Performance Notes<\/p>\n – Batches and caps per tick to keep TPS smooth. —<\/p>\n # \ud83e\udde9 Compatibility & Hooks<\/p>\n – Hooks: Vault, LuckPerms, DecentHolograms, SuperiorSkyblock2, BentoBox, GriefPrevention, WorldGuard. —<\/p>\n # \ud83e\uddf0 Admin Tools<\/p>\n Look at a node and run `\/improvedhoppers settings` (admin view) to live-tune: link distance, suction\/transfer caps, fuel values, smelter rates, limits, particles\/holograms, world allowlists, recipes, and more.<\/p>\n —<\/p>\n # \ud83e\uddd1\u200d\ud83d\udcbb API & Events (for developers)<\/p>\n **Events (examples)**<\/p>\n – `HopperSorterTransferEvent` \u2014 per successful transfer **Example Listener**<\/p>\n “`java Minimal API sketches available for fuel providers & virtual targets.<\/p>\n —<\/p>\n # \ud83d\udcbe Storage & Persistence<\/p>\n – YAML (default) or SQLite. —<\/p>\n # \u2753 FAQ<\/p>\n **Q: Can I disable the power system?** **Q: Can players manage hoppers remotely?** **Q: Do vanilla hopper pulls still happen on claimed nodes?** —<\/p>\n # \ud83e\uddea Troubleshooting<\/p>\n – No transfers happening \u2192 Check claims\/ownership and power mode. Smart, claim-aware item routing<\/p>\n","protected":false},"featured_media":84534,"template":"","meta":{"_minecraft_slug":"improvedhoppers","_minecraft_project_id":"TqOuB4ae","_minecraft_author":"JakeHoolz","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":166,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"improvedhoppers.zip","_minecraft_size_bytes":3255183,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T13:15:59.029784Z","_minecraft_date_created":"2025-09-20T11:13:04.310357Z","_minecraft_date_modified":"2026-02-05T23:43:03.932542Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/improvedhoppers","_minecraft_icon_attachment_id":84534,"_minecraft_imported_at":"2026-06-04T20:03:50+00:00","_minecraft_import_hash":"883d62de332235c5d0e918a06b52cec6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,123],"mod_loader":[130,132,133],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-84533","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-technology","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n
\n– `improvedhoppers.limit.player.
\n– `improvedhoppers.limit.island.
\n– `improvedhoppers.limit.links.
\n– `improvedhoppers.limit.trusted.
\n– `improvedhoppers.limit.filter.
\n– `improvedhoppers.hopper.power.
\nI C I
\nR H R
\nI C I
\n“`<\/p>\n
\nSee `recipes.yml` for exact materials, names, and NBT settings.<\/p>\n
\ngeneral:
\n storage: YAML # YAML | SQLITE
\n locale: en_US
\n holograms:
\n enabled: true
\n update_ticks: 20
\n particles:
\n enabled: true
\n transfer_trail: true
\n filter_focus: true<\/p>\n
\n required: true
\n auto_claim_on_craft: true
\n admin_bypass: true<\/p>\n
\n link:
\n max_distance: 256
\n owner_must_be_online: false
\n cleanup_interval_ticks: 200
\n distribution: ROUND_ROBIN # ROUND_ROBIN | FILL_FIRST
\n filters:
\n default_mode: WHITELIST # WHITELIST | BLACKLIST
\n per_hopper_max: 32<\/p>\n
\n interval_ticks: 10
\n per_tick_item_cap: 256
\n suction:
\n radius: 2.5
\n enabled: true
\n cost_per_item: 0
\n retry_queue:
\n enabled: true
\n max_entries: 2048<\/p>\n
\n mode: NONE # NONE | REDSTONE | FUEL
\n redstone:
\n require_power: false
\n pause_when_powered: true
\n fuel:
\n enabled: false # flip to true to use fuel
\n capacity: 10000
\n regen_per_tick: 0
\n distance_cost_per_block: 0.25
\n amount_cost_per_item: 0.05
\n auto_refuel: true
\n link_limit: 1
\n max_link_distance: 16
\n fuels:
\n COAL: 160
\n CHARCOAL: 160
\n BLAZE_ROD: 240<\/p>\n
\n enabled: true
\n base_cook_ticks: 200
\n queue_size: 128
\n unlock_cost: 1000 # Vault currency
\n upgrade_costs:
\n level_2: 2500
\n level_3: 5000<\/p>\n
\n per_player: 20
\n per_island: 50
\n links_per_material: 4
\n trusted_slots: 8<\/p>\n
\n type: yaml # Storage backend: yaml, sqlite, h2, or mysql (yaml default)
\n save:
\n debounceTicks: 30 # Delay in ticks before saving after changes (0 = immediate)
\n intervalSeconds: 0 # Periodic autosave interval in seconds (0 = disabled)
\n h2:
\n file: hoppers # H2 database file (stored in plugin folder)
\n options: “” # Optional H2 connection options (e.g. AUTO_SERVER=TRUE)
\n username: “sa”
\n password: “”
\n mysql:
\n host: localhost
\n port: 3306
\n database: improvedhoppers
\n username: root
\n password: “”
\n parameters: “useUnicode=true&characterEncoding=utf8&serverTimezone=UTC&useSSL=false&allowPublicKeyRetrieval=true”
\n“`<\/p>\n
\n2. Filter items (whitelist\/blacklist).
\n3. Order targets by priority, remove unloaded or blocked.
\n4. **Distribution:**
\n – **Round-robin:** cycle targets per item type.
\n – **Fill-first:** fill the first valid target until it can\u2019t accept more.
\n5. Power accounting (if enabled): distance & amount \u2192 PU cost.
\n6. Apply retry queue if a move fails and queue is enabled.<\/p>\n
\n– Skips empty sources & blocked\/unloaded targets to save time.
\n– Optional distance-scaled power discourages extreme cross-map links.
\n– Visualizer is per-player; filter-focused trails reduce particle spam.<\/p>\n
\n– Ships internal claims if none detected.<\/p>\n
\n– `HopperSorterFuelConsumeEvent` \u2014 on fuel \u2192 power conversion
\n– `HopperSorterClaimEvent` \u2014 when ownership\/claims change
\n– Overflow & alert hooks<\/p>\n
\n@EventHandler(ignoreCancelled = true, priority = EventPriority.MONITOR)
\npublic void onTransfer(HopperSorterTransferEvent e) {
\n Player owner = e.getOwner();
\n ItemStack stack = e.getItem();
\n Location from = e.getSource();
\n Location to = e.getTarget();
\n int moved = e.getAmount();
\n \/\/ e.getCostPU() if fuel mode; e.isSimulated() for dry runs
\n if (owner != null && owner.isOnline()) {
\n owner.sendActionBar(Component.text(“\u00a7aMoved ” + moved + “x ” + stack.getType() + ” \u2192 ” + pretty(to)));
\n }
\n}
\n“`<\/p>\n
\n– Persists node power, names, particle colors, links, smelter state safely.<\/p>\n
\nA: Yes. It\u2019s off by default; set `power.fuel.enabled: true` to use Fuel.<\/p>\n
\nA: Yes. `\/improvedhoppers remote` opens a network overview or the node GUI.<\/p>\n
\nA: No. We cancel vanilla move\/pickup events for claimed nodes to prevent conflicts.<\/p>\n
\n– Hologram missing \u2192 Install\/enable DecentHolograms and ensure `holograms.enabled: true`.
\n– Skyblock limits ignored \u2192 Ensure SSB2\/BentoBox present; confirm LuckPerms dyn-limits if using permission overrides.
\n– High distance cost \u2192 Lower `power.fuel.distance_cost_per_block` or increase capacity.<\/p>\n","protected":false},"excerpt":{"rendered":"