Skip to main content

Normal reactor with two circuits

Mod version shipped with FlammiCraft: 0.556.0

Overview · Supply and maintenance · Deutsch

Build the Steam Generator · Link the reactor · Start · Shut down · Troubleshoot

The reactor heats coolant. It carries heat to the Steam Generator and flows back. This loop is the primary circuit. On its other side, the generator heats water to make steam for the turbine. Water pumped back to the generator is called feedwater. In an RBMK, steam forms in the reactor itself.

Make cold primary coolant in a heated Create Mixer from 1,000 mB of water, sugar and a slimeball. Fill the steam side with water.

Open Ponder on the Steam Generator controller for the vessel build, primary piping, steam side, startup and cooldown. The scenes use the same plant with one turbine branch. The cooldown scene adds a second Steam Out with a filtered pipe carrying exhaust steam to a separate Radiator.

How it fits together

PRIMARY CIRCUIT (sealed after filling)

  Reactor Hot Leg ──── pump ──── Lead Pipes ─────────► Hot Leg In  ─┐
                                                                    │ Steam Generator
                                       Coolant Buffer               │ (with built-in pressurizer)
                                             │                      │
  Reactor Cold Leg ◄── pump ◄── Lead Tank ◄── pump ◄── Lead Pipes ◄── Cold Leg Out ┘


STEAM SIDE

  Running
  Steam Out → Turbine → Radiator with fan → water tank → pump → Feedwater In

  Cooling down
  Second Steam Out → Exhaust Steam filter → pump → Radiator with fan
  Water from Radiator → water tank → pump → Feedwater In

To fill the plant, pump cold primary coolant into the Lead Tank with a Create pump. Add water to the water tank below the Radiator so the Feedwater Pump can move it into the generator. Build the cooldown branch before startup.

The Steam Generator holds most of the primary inventory, its pressurizer and its heaters. The pumps move the coolant from Cold Leg Out through the reactor and back into Hot Leg In. How much circulates, and so how much heat the circuit carries, the generator works out from the pumps themselves: their speed, their direction and their range on every stretch of both legs. Full tanks or a full reactor therefore never stall the circulation. Coolant on its way sits in the reactor and in Lead Tanks; the generator counts it as part of the circuit.

The hot leg shows how hot its coolant is. From 80 °C at the Hot Leg on, the reactor sends out hot primary coolant, below that cold coolant. Pipes and a Lead Tank between the Hot Leg nozzle and Hot Leg In then change their texture. The leg only shows cold again below 75 °C, so the display does not flicker. A Lead Tank takes on the temperature of the coolant arriving from the leg. Coolant added through the fill connection takes the temperature the tank currently shows. The cold leg carries cold primary coolant. The Cold Leg nozzle and Cold Leg Out still accept both kinds, so leftover hot coolant in a tank does not block the leg.

What you need

Part What it's for
Steam Generator Controller The controller, set into one face of the vessel.
Pressure Vessel Casing The walls, edges and corners of the vessel.
Heat Exchanger Tube Inside the vessel, at least one. More tubes pass more heat.
Steam Generator Port The connections on the vessel faces.
Lead Pipe The two primary legs. Glass Lead Pipes work as well.
A Primary Circulation Pump in every stretch Mechanical (shaft, SU) or electric (FE), see below.
Lead Tank Storage and fill connection for the example below. Goggles show the fill target.
Coolant Buffer Required: one column of up to five blocks on the cold leg. Takes up the expanding coolant.
Reactor Nozzle Hot Leg, Cold Leg, power and emergency modes on the reactor.
Two frequency items Link the generator to the reactor.
FE source Heater power, fed into the port in Power In mode.
Steam Turbine, Radiator with fan, a pump Turn steam into energy and back into feedwater.

Building the Steam Generator

The vessel is a closed box of exactly 7 × 7 × 7 blocks:

  • All edges and corners are Pressure Vessel Casing.
  • The inner 5 × 5 × 5 holds only Heat Exchanger Tubes and air, with at least one tube.
  • The faces are casing, the one Steam Generator controller and the ports. Only one controller fits in a vessel.

Place the Steam Generator within 256 blocks of a regular Reactor Nozzle with matching frequency items. Both must be loaded in the same dimension. The pipe search has its own limit, maximumGraphNodes (512 by default). Pump range is checked separately.

Primary legs

The legs between reactor and generator are built from Lead Pipes. Lead Pipes form their own network: they connect to other Lead Pipes, Lead Tanks, pumps and Nucleus blocks such as nozzles, ports and turbines, but not to Create pipes, Create tanks or other machines. They have no open ends either.

Use a wrench to open or close a pipe window. If only one axial end of a window pipe is connected, a single Lead Pipe beside it can continue the line around a corner. A fully connected straight run keeps both ends. Lead Pipes recheck connections after neighbours change and when they load. Wrenching a pipe with three or more connections keeps every branch connected. After the update, an existing window pipe restores its side connection on load once the adjacent chunks are available.

  • Pumps: only the two Primary Circulation Pumps move primary coolant. The Primary Circulation Pump is turned by a shaft. The Electric Primary Circulation Pump has no shaft: it turns itself while it gets FE. Give it FE from any side and set its speed on its value box (256 RPM by default); a redstone signal stops it. Other pumps, such as the Create Mechanical Pump or the electric pumps of Create Crafts & Additions and Electroenergetics, still connect to Lead Pipes, but in a primary leg the desk reports them and the reactor does not start. The pump switch on the control desk switches both kinds of Primary Circulation Pump.
  • Stretches: like Create, a pump moves coolant only from one endpoint to the next. Endpoints are the generator port, every Lead Tank and the reactor nozzle. Each stretch between two endpoints needs its own pump that pushes in the direction of flow: in the hot leg from the reactor to the generator, in the cold leg from the generator to the reactor. A wrench turns a pump around. The desk names the stretch that lacks a pump. Where two endpoints touch, such as a Lead Tank placed right on the port or on the nozzle, no pipe lies between them and that step needs no pump.
  • Lead Tank: a Lead Tank, also several blocks tall or wide, can sit in a leg; the cold leg is the usual place. It is counted towards the fill target. With Engineer's Goggles it shows how much coolant the circuit holds and how much is still missing, also after the circuit has sealed. The hot and the cold tank show the same total. While some is missing, the fill connection accepts it even when the tank itself is full, until the target is reached. A shortfall below 1 mB counts as full for the display and sealing because the connection can only accept whole mB.
  • No bridges: a pump that connects a Lead Pipe to a Create pipe or a foreign tank does not move primary coolant, and the leg check reports it. Steam and water on the steam side are not affected.
  • Fill point: a Create pipe or pump attached directly to a Lead Tank is its fill connection. A sealed circuit accepts only the coolant missing from its fill target. The connection lets coolant out while the circuit is unsealed.
  • Range: like a Create pump, a Primary Circulation Pump reaches at most 16 blocks along its pipe (mechanicalPumpRange in Create's config). Every pipe of a stretch must lie within that range of a running pump; a longer stretch needs another pump.

How fast the coolant moves follows the pump speed: a pump moves ten times its RPM in mB/s, so one at 256 RPM moves 2,560 mB/s. Several pumps in one stretch extend its range but do not add up; the fastest one sets the rate. The slowest stretch of both legs decides the circulation. Full heat transport needs the rated flow ratedPrimaryFlowMbPerSecond (2,000 mB/s by default). Below 3% only natural circulation is left. The Control Desk shows the pump flow. The Physics Desk labels the flow calculated from rated thermal output separately as a model value. The configured pump rating can be at most 2,560 mB/s.

The filling steps below use a Lead Tank. In a tankless layout, Hot Leg In and Cold Leg Out accept cold coolant through a compatible lead-side connection while the reactor is cold, in SCRAM, and the circuit is open. The completed legs still need to pass the pipe check.

Coolant Buffer

Hot water takes more room than cold water. The Coolant Buffer takes up what the expanding coolant no longer fits into the circuit, and gives it back when the coolant cools down.

  • Building: a column of one to five Coolant Buffer blocks, each 16,000 mB, so up to 80,000 mB. A sixth block on the column is not placed. Set the column on a Lead Pipe of the cold leg, beside the stretch rather than in it; the circulation does not pass through the buffer. Exactly one buffer belongs to a circuit, and none to the hot leg.
  • Fill: the buffer does not count towards the fill target, and it cannot be filled or drained from outside. It holds coolant beyond the rigid circuit of vessel, reactor and Lead Tanks due to thermal expansion or an existing surplus. Goggles on the buffer and the Coolant buffer row on the desk show its contents.
  • Expansion: water at 300 °C and 155 bar takes about 37% more room than at 20 °C. The buffer takes up only a share of that, set by coolantExpansionScale (0.1 by default). A circuit of 1.34 million mB then needs about 50,000 mB of buffer when hot; a small circuit needs much less.
  • Full buffer: once the buffer is full, the coolant has no room left. Every further mB raises the pressure steeply: 1% of the circuit volume without room is about 100 bar. With a port in Relief mode, the relief valve vents that coolant at once until the pressure is below its closing pressure again, even after a sudden jump. Without a Relief port, the Steam Generator fails at its failure limit. Build the buffer large enough before heating the plant.
  • Buffer size: before start, the Steam Generator checks at least the fill target and includes any coolant above it. The design temperature is the secondary boiling point plus the core temperature rise, at the primary pressure setpoint. If there is too little room, the desk reports the required capacity and refuses to start. If a running plant has surplus coolant that would overfill the buffer at the design temperature, it triggers SCRAM.
  • Briefly hidden buffer: when the buffer is out of reach only for a moment, for example right after loading or in an unloaded chunk, the Steam Generator keeps using its last seen size. Only a cold leg traced completely without a buffer counts as a circuit without one.
  • Leg briefly out of reach: in the same way the Steam Generator keeps the fill target while the reactor, a leg or a Lead Tank is out of reach, for example right after loading, in an unloaded chunk or with a broken pipe. Only a complete scan of both legs changes it, so a sealed circuit is never taken for smaller than it is.
  • Missing coolant: when the coolant shrinks below the rigid circuit, for example after the relief valve vented, voids form. The pumps then move less, and nothing at all once 5% are missing. Top the circuit up through a Lead Tank's fill connection. Coolant that is vented or escapes in a failure really leaves the circuit: when the vessel's own coolant is not enough, the Steam Generator takes the rest from the reactor and the Lead Tanks of the legs.

Ports and nozzle modes

Right-click with an empty hand switches a Steam Generator Port to its next mode. Jade and WTHIT show the mode and the Steam Generator readings; goggles show nothing on the Steam Generator or its ports.

Port mode Connect
Hot Leg In Lead Pipe from the reactor's Hot Leg nozzle; also takes the cold fill
Cold Leg Out Lead Pipe to the reactor's Cold Leg nozzle; also takes the cold fill while the circuit is open
Feedwater In water from the radiator
Steam Out pipe to the turbine; the generator pushes steam out here
Power In FE cable for the heaters; the only place that takes FE
Relief optional, no pipe; relief valve of the primary circuit: vents primary coolant when the primary pressure gets too high
Secondary Relief optional, no pipe; shows where the secondary safety valve blows off steam

Hot Leg In, Cold Leg Out and Power In are needed exactly once each. Feedwater In and Steam Out are needed at least once and allowed up to four times each. All Feedwater In ports fill the same tank. Every Steam Out port can draw from either of the generator's two buffers, one for Steam and one for Exhaust Steam. Relief and Secondary Relief are optional and allowed at most once each. Each side has its own valve:

  • Primary: the relief valve opens only with a port in Relief mode, at the relief pressure (175 bar by default), and closes 10 bar below it. It blows steam off the pressurizer. When the coolant is hotter than the closing pressure allows, venting cools it by evaporation until the valve closes again, so it does not empty the circuit.
  • Secondary: the secondary safety valve is built in and works without a port. When the steam cannot leave, for example because Steam Out is full, it blows off at the secondary relief pressure (80 bar by default), so the secondary side never reaches its failure limit. A port in Secondary Relief mode shows with steam clouds where this happens. Up to 0.535.0 the secondary side vented only with a Relief port. Up to 0.537.0 it could still burst with little water, at up to 220 bar; since then the valve vents as much as it must, and a dry secondary side holds no pressure.

Right-click a Reactor Nozzle with an empty hand to change its mode. Sneak-right-click opens its frequency link. The two-circuit plant vents through the Steam Generator Port set to Relief.

Nozzle mode What it does
Hot Leg, Cold Leg the two primary legs to the Steam Generator
Fuel, Waste as usual
Main Power, Reserve Power FE or Create drive for the controls. Power each primary pump at the pump itself.
Emergency Coolant fill point and injection path of the emergency coolant
Emergency Spray containment spray water; its bottom side drains the sump
Relief steam clouds and a hiss at the reactor while the linked Steam Generator's primary valve is open
Emergency Hot Leg, Emergency Cold Leg Hot coolant to the emergency cooling station and cooled coolant back

Emergency cooling station

The emergency cooling station is a 3 × 3 × 3 multiblock. Open Ponder on the Emergency Cooling Station, the Emergency Cooling Port or Pressure Vessel Casing; the scene shows the cube, both pipe runs and the reactor wall.

  1. Build all twelve edges and eight corners from Pressure Vessel Casing.
  2. Put the Emergency Cooling Station in the middle of one face. It is the controller.
  3. Put an Emergency Cooling Port in three of the other five face centres. Right-click them with an empty hand to set Inlet, Outlet and FE Input. Each mode appears exactly once. Unused face centres take Pressure Vessel Casing. The core block in the middle may stay empty.
  4. Set two reactor nozzles to Emergency Hot Leg and Emergency Cold Leg. Sneak-right-click each nozzle and right-click the station. Enter the same two frequency items in the same order in all three menus. No other reactor may use that pair.
  5. Run Emergency Hot Leg → Inlet and Outlet → Emergency Cold Leg through two separate, unbranched runs of Lead Pipe or Glass Lead Pipe. The station contains the pump and cooler.
  6. Supply the FE Input from an independent power network. The station stores up to 256,000 FE and draws 256 FE/t while cooling. Its takeover slots recharge at a combined 1 FE/t.

One station can serve each reactor. Engineer's Goggles on the station or any of its ports show the state and, on a fault, the exact reason and the position of the block at fault, plus stored FE and free switches. The Control Desk's Plant tab shows the state in short form, the reserve flow and the time until the next switch recharges. If a line fails, the desk shows the fault from the previously linked station even after a restart, once the station is loaded and has checked the lines.

Goggles show What to do
Shell incomplete Pressure Vessel Casing is missing at the shown position, or another block stands there.
Port on edge Ports only go in face centres; edges and corners take casing.
Port mode twice / Inlet, Outlet or FE port missing Switch ports with an empty hand until each mode appears exactly once.
Second station in shell Each station needs its own cube.
Inlet/Outlet: no pipe, two pipes Attach exactly one Lead Pipe to the port's outer side.
Line branches / open / too long At the shown position, remove the junction, close the gap or shorten the line. An unloaded chunk counts as open.
Wrong nozzle mode Set the shown reactor nozzle to Emergency Hot Leg or Emergency Cold Leg.
No frequency / Hot or Cold Leg frequency differs Enter the same two items in the same order on the station and both nozzles; no other reactor may own the pair.
Lines reach different reactors / Reactor not assembled / Not a two-circuit plant Both nozzles must belong to the same assembled two-circuit reactor.
Reactor has another station Remove the other station or change its frequency.
Primary circuit not sealed Fill the primary circuit until it seals. Without circulation the station cannot cool.

Random pump faults isolate one running primary pump for 20 seconds. The action log gives its position. If normal circulation falls below 50%, an available station takes over at up to 60% of rated flow while coolant can still circulate in a filled, sealed primary. During SCRAM it is requested only while the reactor or either primary leg is at least 80 °C. While on reserve, the controller inserts rods toward a 20% power target and blocks withdrawal. Reactor protection continues to evaluate temperature, pressure, and flow. The station checks both lines during a takeover. The running reactor trips if neither circuit provides sufficient circulation.

Each takeover while running occupies one of ten switch slots for ten loaded, powered minutes. Occupied slots survive saving and loading. If the plant needs another takeover with 0/10 slots free, it trips SCRAM. Primary pumps still delivering coolant continue running. A powered station with coolant to circulate can keep removing decay heat after SCRAM with the slots exhausted. When normal circulation returns, the station returns to standby.

Linking the reactor

Sneak-right-click a regular Reactor Nozzle and put two items in its frequency slots. Right-click the Steam Generator controller and put the same items in the same order in its slots. The generator links to the reactor that owns this frequency. A reactor accepts only one generator. Control desks can use the same frequency or a separate one assigned to the same reactor.

Starting the plant

The PLANT tab of the control desk shows the generator's status, what is still missing and its position. The Primary coolant row on the MAIN tab shows the coolant in the whole primary circuit against its fill target.

  1. Build: Complete the vessel, set all port modes, run both legs in Lead Pipes with a pump in every stretch, put the Coolant Buffer on the cold leg and link the reactor.
  2. Cold fill: With the reactor in SCRAM and cold, pump cold primary coolant from a Create pipe into the Lead Tank of either leg and keep the leg pumps running. While the circuit is open, the Steam Generator keeps its vessel full and passes on only the excess. Coolant sitting in a Lead Tank goes into that vessel first and then into the reactor, so the tank gains room again even when no pump stands between the tank and the nozzle. The leg pumps still carry coolant along the pipes. The fill target is the vessel volume plus the coolant the reactor holds plus the capacity of every Lead Tank in the legs, rounded up to 500 mB. The desk shows it, and the Lead Tank's goggle tooltip shows how much is still missing. Once it is reached, the primary circuit seals itself and the Hot Leg In and Cold Leg Out ports lock. The other ports can still switch between Feedwater In, Steam Out, Power In and Relief.
  3. Feedwater: Fill water into Feedwater In. Startup needs at least 20% on the water side.
  4. Heat up: The heaters run on FE fed into the Power In port and stored in the generator (4,096 FE/t at most by default) and build up pressure towards 155 bar. Heaters on the desk turns them on and off. How fast the pressure rises depends on the FE supply and the coolant in the whole primary circuit: at full heater power a circuit of 1.34 million mB takes about 20 minutes from 1 to 155 bar, and a smaller circuit is faster in proportion. A weaker supply reaches the setpoint more slowly. The Heaters row on the desk shows the FE/t actually used.
  5. Fuel and waste: Connect a fuel tank to Fuel and a Spent Fuel Pool to Waste. Prepare both paths before pumping fuel into the reactor.
  6. Start: The pressure threshold defaults to 132 bar. The pumps must reach at least half the configured rated flow. Start checks the buffer against the full design inventory, including at partial power. Power at the Physics Desk shows available capacity and required space. Press START under MAIN at the Control Desk and withdraw the rods slowly. Overtemperature protection reads the hot leg. With protection enabled, the default secondary pressure trip is 75 bar. Watch the Coolant Buffer level as the plant heats up.

Steam Out feeds the turbine. By default, the turbine sends Exhaust Steam to a Radiator with a fan or a Low Pressure Turbine. Pump the resulting water back into Feedwater In.

Size the steam and water lines. At 256 RPM, a standard Create pump moves up to 2,560 mB/s per line. A normal turbine accepts up to 2,400 mB/s by default. The 28,800 mB/s design example therefore needs twelve turbines at that limit. A bigger pump can supply a shared pipe, but each turbine still has its own intake limit. Size the condensers and water return for the same output. One bucket holds 1,000 mB.

Feedwater Pump: the Feedwater Pump is a Create pump with twelve times the pressure of a Mechanical Pump. Create limits throughput by the pump's pressure, not by the pipe; with it ordinary Create pipes carry 1,536 mB/t or 30,720 mB/s at 256 RPM, more than a reactor at full power boils off. One line can carry the feedwater and a second line can supply a bank of turbines, subject to the limits of the connected machines. It costs twelve times the stress of a Mechanical Pump, 48 SU per RPM, so 12,288 SU at 256 RPM. It moves any fluid like a Mechanical Pump; in a primary leg it does not count as a Primary Circulation Pump. Pressure factor and stress are feedwaterPumpPressureFactor (default 12) and feedwaterPumpStressPerRpm (default 48) under pressurizedPlant in nucleus-server.toml. The desk, Jade and WTHIT show the feedwater and steam tanks and how many ports each mode has. Jade and WTHIT also show the feedwater need now and at full power, how many pump lines at 256 RPM that is, and the secondary water against its target of 16,000 mB. Size a water supply from that: it must deliver the 16,000 mB to fill the side and, while running, whatever the loop does not bring back.

Electric Feedwater Pump: It delivers the same flow as the shaft-driven model and draws 4 FE/t per RPM by default, or 1,024 FE/t at 256 RPM. Power draw follows the speed even when no fluid is moving. Set the speed on the value box. Engineer's Goggles show the current draw and stored FE. To adopt the new default on an existing installation, set electricFeedwaterPumpFePerRpm = 4.0 under [pressurizedPlant] in the active nucleus-server.toml.

Stopping and cooling down

  1. Press STOP for a planned shutdown or SCRAM for a quick shutdown. Turn Heaters off under PLANT.
  2. Keep the Primary Circulation Pumps running, feedwater coming in and the steam outlet open. The core keeps giving off heat with the rods inserted. After SCRAM, cooldown starts immediately with the heaters off. After STOP, the plant waits for a 100% rod target and neutron flux below 1%.
  3. Route Exhaust Steam from the second Steam Out through a filter pipe to the Radiator. Add an Exhaust Steam Bucket to the pipe's allow-list. The generator can boil water at about 70 °C in this mode, so the plant can still shed heat when primary coolant is around 90 °C. The Cooldown row tells you which supply is missing.
  4. To open the circuit after a planned stop, press SCRAM as well. Wait for Ready to unseal. The reactor must be below 1% power. The reactor and both primary legs must be below 80 °C. Press Unseal. When Primary circuit unsealed appears, you can change the leg ports or pump cold coolant out through the Lead Tank's fill connection. The Steam Generator keeps its own volume.

At 5 bar absolute or higher, opening the primary circuit plays TNT particles and sound. Unsealing plays the effect at the Steam Generator. Breaking a Lead Pipe or Lead Pipe with Window that disconnects the circuit plays it at the break. The effect causes no damage or knockback.

Stop the coolant supply before draining an overfilled circuit. The circuit stays open after unsealing until the amount falls below the fill target. It seals again on refilling to the target. Buckets cannot be used on the leg ports. The heaters only heat a sealed circuit. While it is open, the desk shows On, idle (unsealed) for switched-on heaters.

When it won't continue

The desk, Jade and WTHIT give the same cause, and so do goggles on the reactor. Common cases:

Message What to do
No 7 × 7 × 7 vessel found around the controller Build all eight corners from Pressure Vessel Casing and put the controller in a face, not on an edge or corner.
A corner of the 7 × 7 × 7 vessel is missing Place Pressure Vessel Casing at the shown position. The message names the vessel missing the fewest corners.
An edge or corner is not Pressure Vessel Casing Replace the shown block with casing.
A vessel wall has a foreign block Replace the shown block with casing, a Steam Generator Port or the controller.
Only Heat Exchanger Tubes or air may be inside Remove the shown block from the interior.
A mode is missing or used twice Cycle modes with an empty hand. Hot Leg In, Cold Leg Out and Power In need one port each. Use one to four ports each for Feedwater In and Steam Out.
No Steam Generator is linked Use matching items in the same order at the controller and a loaded regular nozzle within 256 blocks, in the same dimension.
Hot Leg In / Cold Leg Out has no Lead Pipe attached Connect a Lead Pipe directly to that port.
The Hot Leg / Cold Leg pipe run ends open Check the position shown for a gap, ambiguous connection or sideways pump.
… reaches a nozzle that is not set to Hot Leg / Cold Leg, a nozzle of a different reactor, or more than one nozzle Each leg must reach exactly one nozzle of the right mode on the linked reactor. The position shows the nozzle that does not fit.
… leads back into the Steam Generator / is longer than the pipe limit Reroute the leg so it runs from its port to its nozzle without touching the vessel again, or shorten it.
The hot / cold leg has no Primary Circulation Pump Put a Primary Circulation Pump into the named leg and drive or power it. The position shows that leg's port.
Only Primary Circulation Pumps … may sit in a primary leg Replace the pump at the position the desk shows with a Primary Circulation Pump.
Place a Coolant Buffer … / A Coolant Buffer sits on the hot leg / more than one Coolant Buffer Keep exactly one buffer column, on a Lead Pipe of the cold leg. An overfilled circuit also trips with these messages instead of "too small" with 0 mB.
A stretch … has no Primary Circulation Pump Put a Primary Circulation Pump into the stretch at the position the desk shows.
The pumps of a primary leg stretch push against the flow Turn the pumps of that stretch around with a wrench.
The Coolant Buffer is too small for the hot circuit Add buffer blocks up to five. If five are not enough, build a smaller circuit, for example with smaller Lead Tanks.
The Coolant Buffer is full Let the plant cool down, then add buffer blocks up to five. Coolant topped up after sealing also fills the buffer.
Coolant is missing from the primary circuit Top it up through a Lead Tank's fill connection. The goggles name the missing amount, even on a full tank, and the connection accepts it.
The primary legs may only use Lead Pipes … Replace other pipes in the legs with Lead Pipes and remove pumps that lead into Create pipes or tanks.
The Primary Circulation Pumps move too little coolant Run the pumps faster, and check that electric ones get enough FE: half the rated flow needs at least 100 RPM. Check that every pipe lies within 16 blocks of a running pump.
Primary pressure is too low Let the heaters build pressure first.
The secondary side has too little water Feed water into Feedwater In.

A running reactor trips when the vessel breaks, the link or a leg is lost, the circuit is no longer filled or the generator fails.

Failure and repair

A breach triggers SCRAM. The Control Desk, Jade and WTHIT show which side failed and the pressure at failure. The server log also records the buffer level. The default failure limits are 195 bar on the primary side and 95 bar on the steam side.

Damage What happens Materials in Survival
Secondary breach The steam side opens. The primary stays sealed and full. Incoming feedwater can still carry away heat. 1 Pressure Vessel Casing
Primary breach Coolant escapes. The desk reports a failed Steam Generator and a breached reactor vessel. 1 Pressure Vessel Casing and 1 Reactor Casing
Containment failure The outer protective shell has failed. Close it and wait for less than 80 °C, less than 0.2 bar above outside pressure and less than 1% hydrogen by volume. Repair damaged wall blocks. Confirming the shell repair at the desk consumes no materials for the shell itself.

Keep the entire plant loaded, its structure valid and SCRAM latched. Wait for less than 1% power and for the reactor and hot leg to fall below 80 °C. Click Repair plant twice under PLANT. Hot coolant can retain pressure even with the valve open, around 20 bar at 210 °C. After repair, check the fill level, cooling and outlets before starting again. A melted core blocks this repair.

Resetting a controller

/reactorreset (permission level 2) resets the Reactor Controller you look at, within 10 blocks, to its freshly placed state. Run it once for a warning and then /reactorreset confirm. Fuel, coolant, buffers and the Steam Generator link are lost; the action log stays.

Existing worlds

Start Nucleus in a fresh world. Old block, item and fluid IDs have no migration path. Use the same Nucleus version on client and server and configure the plant in nucleus-common.toml and nucleus-server.toml.

Settings

The values are in the pressurizedPlant section of nucleus-server.toml: setpoints, relief and failure pressures for both sides, the low-pressure trip, heater FE per tick, the FE buffer, the design core rise, the heat transfer per tube, ratedPrimaryFlowMbPerSecond, the flow the pumps must move for full heat transport, coolantExpansionScale, the share of the real thermal expansion that the Coolant Buffer must take up, and primaryPumpWorkShare, the shaft work of the Primary Circulation Pumps, and electricPumpFeFactor and electricPumpBaseFePerTick for the electric pump.

Pump load: at full circulation the Primary Circulation Pumps take primaryPumpWorkShare (0.0005 by default) of the rated reactor heat from their shafts. Each leg carries half, split between its running Primary Circulation Pumps; the work falls with the cube of the circulation. With one Primary Circulation Pump per leg at 256 RPM that is about 5,000 SU per pump. The SU contribution for a given amount of calculated circulation work stays the same. Changing the flow changes that work. The base load scales with shaft speed at 4 SU per RPM. Setting primaryPumpWorkShare = 0 leaves only that base load.

Electric pump: the Electric Primary Circulation Pump draws electricPumpBaseFePerTick (8 FE/t at 256 RPM by default, less at lower speed) plus its share of the circulation work in FE, multiplied by electricPumpFeFactor (1 by default). With the default work share a leg needs about 60 FE/t at full circulation, split between its pumps. It stores up to 64,000 FE and takes up to 16,384 FE/t. Without enough FE it stops, and its stretch stops with it. A stopped pump starts again only once it has stored a second's worth of FE, so a weak supply runs it in spells instead of switching it on and off every tick. The goggles show its draw and its stored FE.

Open checks

Offline regressions cover the fill target, coolant and heat balances, pressure relief, the buffer, sealing, saving and loading. In-game checks still cover stretch detection on built pipe runs, the Coolant Buffer column, the Electric Primary Circulation Pump, chunk transitions and the controls from cold filling through unsealing.