Skip to content

Codex Processing Matter Reconstructor

CaptainGummiball edited this page Nov 10, 2026 · 1 revision

Matter Reconstructor

The Matter Reconstructor turns one material into another: iron into gold, coal into diamonds, netherrack into netherite scrap. It dissolves the input in its first chamber, sends the matter through a conduit and builds the target in its last chamber. It never makes something from nothing: every conversion costs more material than it gives, and a huge amount of energy.

How it works

  1. Scan a pattern: the reconstructor only makes targets it has a pattern of. Put one target item and a blank Matter Pattern into the scanner slots; the scan takes a large one-time amount of energy and writes the pattern.
  2. Load the patterns: put written patterns into the six pattern slots.
  3. Reconstruct: inputs come in through the Item Input Port. Whenever the inputs fit a reconstruction recipe whose target has a pattern, a run starts.
  4. Products go into the output slots, from where pipes take them through the Item Output Port.

Building

Shown size: 7 wide, 7 high, 11 deep.

Shown size: 7 wide, 7 high, 11 deep.

This plant has a fixed size; the rules on this page say what may differ.

Key Block Count
A Precision Casing 294
D Industrial Sight Glass 14
F Matter Conduit 5
G Energy Input Hatch (Tier 5) 2
E Dissolution Chamber 1
C Item Input Port 1
H Item Output Port 1
B Pattern Scanner 1
I Reconstruction Chamber 1
0 Matter Reconstructor Controller 1

Step by step

Each picture adds one layer, from the bottom up; the newest layer is bright. The controller wall faces you on the left.

Step 1: Layer 1

Top-down map of the layer: the yellow bar marks the controller wall.

Parts in this step: Precision Casing (A) ×77

Step 2: Layer 2

Top-down map of the layer: the yellow bar marks the controller wall.

Parts in this step: Precision Casing (A) ×31, Matter Reconstructor Controller (0) ×1

Step 3: Layer 3

Top-down map of the layer: the yellow bar marks the controller wall.

Parts in this step: Precision Casing (A) ×29, Item Input Port (C) ×1, Item Output Port (H) ×1, Pattern Scanner (B) ×1

Step 4: Layer 4

Top-down map of the layer: the yellow bar marks the controller wall.

Parts in this step: Precision Casing (A) ×18, Industrial Sight Glass (D) ×14, Matter Conduit (F) ×5, Dissolution Chamber (E) ×1, Reconstruction Chamber (I) ×1

Step 5: Layers 5–6 (identical)

Top-down map of the layer: the yellow bar marks the controller wall.

Place this layer 2 times on top of each other.

Parts in this step: Precision Casing (A) ×32

Step 6: Layer 7

Top-down map of the layer: the yellow bar marks the controller wall.

Parts in this step: Precision Casing (A) ×75, Energy Input Hatch (Tier 5) (G) ×2

Rules

  • Size: exactly 7 wide, 7 high and 11 deep.
  • Edges and corners: only Precision Casing.
  • Walls, floor and roof: Precision Casing, Industrial Sight Glass, exactly one Pattern Scanner, ports and the controller.
  • Inside: a line along the middle, at mid height, from the controller wall to the back: one block of air, the Dissolution Chamber, five Matter Conduits, the Reconstruction Chamber, one block of air. Everything else inside is air.
  • Energy Input Hatches: up to 8.
  • Controller: in one of the two square (7 × 7) end walls, not on an edge, front facing out, with the inside directly behind it.
  • Ports: Item Input Port, Item Output Port and Energy Input Hatches. Every port works only on its outer face.

Patterns and the scan

  • A Matter Pattern is blank when made. A written pattern shows its target in its name and is an item: it survives the plant and can be moved to another reconstructor.
  • Put the target item into the scan slot and a blank pattern into the slot next to it. The scan draws energy from the buffer, up to 64,000,000 E per tick, until it reaches the target's scan energy. Then the blank becomes a pattern of that target.
  • With one blank, the written pattern stays in the blank slot: move it into a pattern slot. With several blanks, the written pattern goes into a free pattern slot by itself.
  • The target item is not used up by the scan.
  • Only items that some reconstruction recipe makes can be scanned, and only items without extra data (no name, no enchantment).

Note

Swapping the target The reconstructor keeps the scan of the last target. Take the target out or put another item in, and the scan of the old target waits; put it back and the scan goes on from there. Only one scan is kept: a third target replaces it, and that energy is lost.

Note

All pattern slots full With more than one blank in the blank slot and all six pattern slots full, a finished scan waits: the status line says "Scan done, pattern slots full: free one", the scan keeps its energy and takes no more, the blank stays. Free a pattern slot and the pattern is written into it at once.

Reconstruction rules

Most recipes come from rules in data packs (data/<namespace>/qnet/reconstruction_rule/). A rule turns the named forms (for example ingots and dusts) of every other material into one target, strictly by material units (MU): for one piece of the target it takes the given ratio times its MU, in whole pieces, rounded up. A ratio below 1 is not allowed, so a rule never gains material. QNet brings two rules:

Target From Ratio Not from
Gold ingot ingots and dusts of every other metal 4: four ingots or dusts for one gold ingot netherite
Iron ingot ingots and dusts of every other metal 2: two ingots or dusts for one iron ingot netherite, gold

Every rule recipe runs for ten seconds at 1,000,000 E per tick, and the target needs a scan of 1,000,000,000 E once.

These recipes come as fixed recipes:

In Out E/t Ticks
16 × any Block of Coal Diamond 2000000 400
64 × Netherrack, 8 × any Nether Quartz, Exotic Matter Netherite Scrap 4000000 600

Explicit recipes like these need a scan of the target as well; the recipe viewer shows its scan energy.

Energy

  • The energy buffer holds 128,000,000 E, multiplied by the speed factor of the Plant Speed Modules. The modules speed up the runs, not the scan.
  • A run draws the energy of its recipe in every tick; when the buffer holds less, it waits and keeps its progress. The scan takes what it can get, but it shares the buffer with the run.

Important

Millions per tick The example has two tier 5 hatches (4,096,000 E/t each): a rule recipe needs 1,000,000 E in every tick, the explicit recipes up to four times as much, a scan a billion in all. Two tier 4 hatches (512,000 E/t each) carry the rule recipes only; with small hatches a single gold ingot takes more than an hour.

The screen

  • Bars for energy and for the scan (with the name of the target being scanned), the progress of the run.
  • Six input slots, four output slots, the six pattern slots, the scan slot and the blank slot below, and the module slot at the right edge.
  • The status line.

What the status line says

Status Meaning
Ready, 2 patterns Formed, with two patterns loaded; waiting for inputs.
No pattern: scan a target first No written pattern lies in a pattern slot.
Reconstructing A run is in progress.
Waiting for energy A run has started and waits for energy: add hatches or feed more power.

Automation

  • Pipes put inputs in through the Item Input Port; only items a reconstruction recipe uses and that carry no extra data are accepted.
  • Items can only be taken out of the output slots.
  • A Grid Monitor can pause the reconstructor.

Error messages

Message What to do
The controller must sit in a wall, front facing out Put the controller into a square end wall, front outwards, with the inside behind it.
Structure too small (…) / Structure too large or not closed near … Build exactly 7 × 7 × 11 and close every wall.
Wrong block at … (expected: Precision Casing) Only Precision Casing on edges and corners.
Wrong block at … (expected: Dissolution Chamber) The second block of the middle line must be the Dissolution Chamber.
Wrong block at … (expected: Matter Conduit) Five Matter Conduits follow the Dissolution Chamber.
Wrong block at … (expected: Reconstruction Chamber) The line ends with the Reconstruction Chamber.
Wrong block at … (expected: Air) Nothing else inside, also not in the first and last block of the middle line.
Missing parts: Pattern Scanner ×1 Put a Pattern Scanner into a wall.
Too many ports of one kind At most 8 Energy Input Hatches and one Pattern Scanner.
Port not allowed here Only item ports and Energy Input Hatches work.

Breaking the controller

Everything in the slots drops, the patterns too, together with the inputs of the run in progress. The stored energy and the progress of a scan are lost.

In the world

During a run the input dissolves in the first chamber, a stream of matter runs through the conduit, and the target takes shape in the last chamber.

Building the controller and the patterns

→ Matter Reconstructor Controller
→ Matter Pattern

Tip

One scan, many reconstructors A pattern is never used up. Scan each target once and move the pattern to the reconstructor that needs it.

QNet Codex

Getting Started

Energy

Processing

Rift

Storage

Logic

Reference

Items and Blocks

Clone this wiki locally