Start Here

  • Give yourself a VHopper with /vhopperadmin give.
  • Place it, right-click it, and open the control panel.
  • Install one module first, such as Collector, before testing more complex automation.
  • Use /vhopperadmin inspect when you need to check what is installed in a placed VHopper.

Core Purpose

VHoppers turns placed hoppers into protected custom machines with owners, trusted players, module slots, upgrades, GUI management, analytics, and persistent storage.

The plugin is designed for Minecraft 1.21.x, Java 21+, and production servers that need controlled automation rather than vanilla hopper behavior.

Player Flow

Place and manage

  • Admins give VHopper items with /vhopperadmin give.
  • Players place the item, open its GUI, and manage modules.
  • Owners can trust players and grant extra access permissions.

Automate with modules

  • Collector, Dealer, Void, Smelter, Compressor, and Seller modules handle different workflows.
  • Linked containers are selected with shift-click interactions.
  • Upgrades control range, capacity, speed, slots, and offline work.

Compatibility

  • Platform: Paper, Purpur, or compatible server software.
  • Minecraft version: 1.21.x.
  • Java version: 21+.
  • Storage backends: LOCAL, MYSQL, MARIADB, and H2.
  • Integrations include Vault, CoinsEngine, ExcellentEconomy, PlaceholderAPI, stacker plugins, protection plugins, custom item plugins, shop plugins, VContainer, and HeadDatabase.

File Layout

plugins/VHoppers/
|- config.yml
|- database.yml
|- messages.yml
|- modules.yml
|- upgrades.yml
|- currencies.yml
|- prices.yml
|- compress.yml
`- menus/
   |- main.yml
   |- modules.yml
   |- upgrades.yml
   |- players.yml
   |- player_select.yml
   |- trusted_permissions.yml
   |- analytics.yml
   |- pickup.yml
   `- filter.yml