Item Hopper

What is an Item Hopper?

Item Hoppers collect every item of certain types spawned in a chunk. An Item Hopper may e.g. collect every apple and beef in the chunk it's placed in.

Acquiring the Item Hopper

To acquire an Item Hopper, simply type:

/hopper give <player> item <amount>

This will give the specified player x amount of Item Hoppers.

Using the Item Hopper

After you have aquired an Item Hopper item, simply place it in the chunk you want to collect items from. A hologram should appear, displaying the hopper type, the owner name, and the hopper's total worth.

It should look something like this:

Item Hopper placed in the world.

Item filter

The hopper will now collect any items specified in the item filter from this chunk. To open the item filter, simply sneak + right click on the hopper, or click the filter item in the storage menu.

This will open a GUI menu, and from here you can add filter items by clicking any item in your inventory.

To remove an item from the filter, right click the item in the filter section (This will also sell every item of the removed type!)

Item storage

To open the item storage, right click on the hopper you want to open. This will open a GUI menu, which shows all your collected items and the amount and worth of each item.

In the storage menu, you can sell and withdraw your collected items.

• Sell: Left Click (Sells every item of that type)

• Withdraw: Rightclick (withdraws up to 64 items per withdrawal)

Sell all

You can also sell everything in a hopper by sneaking + left clicking it.

Auto Sell

All Item Hoppers have auto-sell funcionality. You can toggle auto-sell by clicking the auto-sell item at the bottom of the storage menu.

For more information about how auto-sell works, see Auto Sell.

Void Filter

The Item Hopper also has a void filter, which can be configured the same way as the item filter. To open the void filter, simply click the void filter item in the storage menu.

If an item that's added to the void filter spawns within the chunk, the item will be instantly removed by the Item Hopper. This makes it useful to automatically dispose unwanted items.

If you want, you can turn off all the custom GUI features, making Item Hoppers behave like vanilla hoppers except they collect all items within the chunk. To do this, simply enable disable_enchanced_gui in the config.

Custom Item Hoppers

As the server owner, you can create pre-configured custom Item Hoppers for your players. These hoppers will have a pre-determined and unchangable filter. You can create a new custom Item Hopper by creating a new file in the hopper_types folder. The ID of the Custom Item Hopper is the name of the file.

Example:

name: "Farm Items"
materials:
  - "WHEAT"
  - "CARROT"
  - "POTATO"
  - "BEETROOT"
  - "WHEAT_SEEDS"
  - "PUMPKIN_SEEDS"
  - "MELON_SEEDS"
  - "BEETROOT_SEEDS"
  - "SUGAR_CANE"
  - "POTATO_ITEM"
  - "CARROT_ITEM"

Acquire a Custom Item Hopper

To acquire a Custom Item Hopper, use this command where `<custom-id>` is the name of the Custom Item Hopper file.

/hopper give <player> item <amount> <custom-id>