Retrievers

Retrievers are items that can be installed on itemduct and fluiduct connections. They pull items or fluids towards themselves from other blocks connected to the duct network.

Obtaining

Crafting

Upgrading

Usage

Installation

A retriever can be installed on an itemduct or fluiduct connection by using it on the connection. It can be removed by using a wrench on it.

Configuration

An installed retriever can be configured by using it. The available options depend on whether the retriever is installed on an itemduct or on a fluiduct.

A retriever’s configuration can be saved on a redprint to be copied to other retrievers, servos or filters.

Redstone control

By default, a retriever is only active when powered with redstone. However, this is configurable. A retriever can be in one of three modes:

Ignored

Redstone control is disabled. The retriever is always active.

Low

The retriever is active when not powered. When powered, it becomes inactive.

High

The retriever is only active when powered. This is the default mode.

Item transfer

When installed on an itemduct connection, an active retriever extracts items from blocks in the network and inserts them into the block it is connected to.

Items are extracted from blocks in stacks. The maximum size of each stack and the speed at which stacks are extracted depends on the retriever’s tier. The maximum stack size can be configured to be lower.

Retrievers at higher tiers give extracted items a speed boost, causing them to move faster through the itemducts.

A retriever can be configured to limit the total stored amount of an item in the connected block. This option is only available at higher tiers, and its maximum value depends on the tier. By default, any amount of items is allowed.

Item filtering

A retriever can be configured to only retrieve items that match a given list of items. It has various options that determine how this list is used to match items. Some of these are only available at higher tiers.

Blacklist/Whitelist

Treat the list of items as a blacklist (retrieve all items except these) or as a whitelist (only retrieve these items). The list is used as a blacklist by default.

Metadata

Match items by their exact metadata / damage value. This is used by default.

NBT

Match items by their exact NBT data. This is used by default.

Ore Dictionary

Match items that are considered equivalent, like the various versions of copper and tin ingots added by different mods. This is ignored by default.

Mod Owner

Match items that are added by the same mod. This is ignored by default.

Item routing

At higher tiers, a retriever can be configured to prefer extracting items from certain blocks in the network.

Nearest-First

Items are extracted from the connected block that has the shortest path to it first, taking into account dense and vacuum itemducts. This is the default mode.

Furthest-First

Items are extracted from the connected block that has the longest path to it first, taking into account dense and vacuum itemducts.

Random

Each item is extracted from a random connected block.

Round Robin

Items are extracted from each connected block in a repeating order.

Fluid transfer

When installed on a fluiduct connection, an active retriever extracts fluids from blocks in the network and inserts them into the block it is connected to. The rate at which fluids are extracted depends on the retriever’s tier.

Fluid filtering

A retriever can be configured to only retrieve fluids that match a given list of fluids. The retriever has various options that determine how this list is used to match fluids.

Blacklist/Whitelist

Treat the list of fluids as a blacklist (retrieve all fluids except these) or as a whitelist (only retrieve these fluids). The list is used as a blacklist by default.

NBT

Match fluids by their exact NBT data. This is used by default.

Tiers

Retrievers come in five tiers.