Codex Storage Interface

Storage Interface

The Storage Interface is the door of a storage network for pipes, hoppers and other mods. Everything that goes in on any of its six sides lands in the network; what may come out is decided by its extraction filter.

The rule

• Insert: anything. Every side takes any item, fluid or gas into the network, as far as the network has room.
• Extract: filter only. Pipes can only take what the filter lets out, nothing else.

Link the interface to a Storage Controller with the Quanta Linker (interface first, then controller). Without a reachable network it takes and gives nothing.

The filter

The extraction filter has 18 places. Each place is either an exact resource or a pattern:

• Exact: click a place while holding an item: that item, with its data, is set. Holding a filled bucket sets its fluid; hold Shift to set the bucket item itself instead.
• Pattern: type into the pattern field and press Set or Enter; the pattern goes into the first free place.
• #namespace:tag: every item or fluid with this tag, for example #c:ingots.
• @mod: everything of one mod, for example @minecraft.
• an id: a gas, fluid or item of that id (a gas is tried first, then a fluid, then an item). This is how you set a gas, for example qnet:hydrogen.
• Remove: right-click a place with an empty hand.

Changing the filter needs the admin role in the owner's team; viewers may look.

What pipes see

Pipes do not see the whole network, only a short list, the view: the places in their order, an exact place as its resource, a pattern as the matching resources of the network, the largest amounts first. The view holds at most storage.interfaceView (default 64, allowed 1–256) entries.

• An exact place keeps its position even while the network has none of it, so pipes that count on slot numbers keep working.
• Items appear as slots (one stack at a time), fluids and gases as tanks. One empty slot and one empty tank at the end take anything.
• Only what is free can be taken: amounts that the Factory Controller has reserved stay in the network.
• The view is rebuilt on the server tick when the filter or the network changed, at most every 0.5 seconds.

The screen

• Network: connected, offline or not linked, and the members online.
• Pipes: the rule (insert anything, extract filter only).
• View: how full the view is (entries of the possible storage.interfaceView (default 64, allowed 1–256)).
• Extraction filter: the 18 places. The tooltip of an exact place shows how much of it is free in the network, that of a pattern how many kinds of the view it stands for.
• Pattern field with the Set button.
• Pipes see (in order): the view as pipes see it, page by page (arrows or mouse wheel); the tooltip shows the position and the free amount.

AE2 and other storage mods

With Applied Energistics 2 (NeoForge), an AE2 storage bus on a Storage Interface mounts the network directly instead of reading slots:

• With an empty filter AE2 sees everything the network's own members hold; with a filter only the view.
• Only items and fluids; no gases.
• Foreign storages behind External Storage Interfaces are left out, so a storage that AE2 sees on its own never shows up twice.
• What AE2 stores goes into the network's own members, without a filter.

The integration can be switched off with features.integration.ae2 (default true).

In the world

The violet rings in the ports turn for 20 ticks after something moved.

Building it

	Hopper
			→ Storage Interface
	Hopper

Tip

Exporting to a machine Put the interface next to a machine's input with an extracting pipe and set the filter to what the machine needs, for example #c:raw_materials for an ore line. For machines that the Factory Controller should run, use a Machine Interface instead.

Caution

Two interfaces on one pipe A pipe between two interfaces of the same network moves things out and straight back in. Give every interface its own pipe line.