> For the complete documentation index, see [llms.txt](https://mauvemc.gitbook.io/mauvemc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mauvemc.gitbook.io/mauvemc/features/upgradeable-hoppers.md).

# Upgradeable Hoppers

Upgradeable hoppers are "wireless" hoppers that can be upgraded, given filters and transfer items long distances, massively reducing the amount of hoppers needed and speeding up the process.

<figure><img src="https://868686433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZ0mkT7SIaNYPhsxyNVl%2Fuploads%2Fah8t80N7plW7R59VwtPy%2Fupgradeable-hoppers-menu.gif?alt=media&amp;token=cfa4d86d-d9be-4a79-9765-adeb45bebdfe" alt="" width="563"><figcaption></figcaption></figure>

## **How do I use them?**

Place the hopper, and left click it to open the menu. There are multiple upgradeable features like link distance, suction radius, max links, transfer amount.

## **Linking Hoppers**

To link a Hopper to another container, left-click the hopper and press "Link Containers" then left-click on the desired container.

<figure><img src="https://868686433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnZ0mkT7SIaNYPhsxyNVl%2Fuploads%2F6kjfnKR08ISuNGFWHZbL%2Flink-hopper-to-chest.gif?alt=media&amp;token=dec1944f-64c9-4bf9-9e90-9f3e37fb7eac" alt="" width="563"><figcaption></figcaption></figure>

You can link multiple containers, to unlink a container repeat the same steps but right-click on "Link Containers" or open "Links" and use the drop key while hovering over the link.

## **Managing Links**

Next to "Link Containers" is the "Links" menu. This menu has all the information of linked containers including the name, type, location. You can unlink containers or manage filters through this menu.

## Link Item Filters

Each linked container lets you filter what items are allowed to pass through. Left-click the linked container in the menu to open the Link Filter. Put items into the menu to add them to the filter. Left-clicking will remove them from the filter.

#### Mode

Left-click the mode button to toggle the filter mode. by default Blacklist is enabled, when enabled any item in the filter will not go in the container. if whitelist is enabled, only the selected items will be collected by the hopper.

#### Strict Filtering

If strict filtering is enabled, the item added to the filter must have the same exact NBT data. This includes name, enchants, lore, durability.

## Delete Items

If an item doesn't match the filters of any linked containers the item will be deleted when enabled.

## Toggle Suction

If enabled it will automatically suck up any items within a certain radius depending on the upgrade, left click to disable.

## Upgrades

#### Links Amount

Allows you to link more containers to your hopper, the default amount is 2 linked containers.

* 2 Links - Default
* 4 Links - $5,000
* 8 Links - $15,000
* 16 Links - $50,000

#### Transfer Amount

Increases how many items it can transfer at once.

* 4 Items - Default
* 8 Items - $5,000
* 16 Items - $10,000
* 32 Items - $20,000
* 64 Items - $40,000

#### Suction Radius

Increases the chunk area that the hopper covers

* 1 Chunk - Default
* 2 Chunks - $25,000
* 3 Chunks - $50,000
* 4 Chunks - $100,000

#### Max Link Distance

Increases the distance you can have between the hopper and linked containers.

* 100 Blocks - Default
* 150 Blocks - $10,000
* 200 Blocks - $20,000
* 250 Blocks - $30,000