Building and operating a plant in Nucleus
Mod version shipped with FlammiCraft: 0.556.0
Deutsch · Look up a Ponder scene
Nucleus adds uranium processing, reactors and turbines to Create.
The mod ID is nucleus. Ponder shows where the blocks go in game.
Start with a fresh world and configuration.
What do you want to do?
| Task | Instructions | What to look for |
|---|---|---|
| Build a plant | Two-circuit reactor and Steam Generator · RBMK · Reactor Sheet | Ponder at the Reactor Controller or RBMK Control Console shows the connections. In the Reactor Sheet, Review leads to the affected cell. |
| Link a reactor | Connections and controls · Link the Steam Generator | MAIN shows readings from the reactor on that frequency. |
| Start the plant | Two-circuit reactor · RBMK | PLANT shows startup conditions. In realistic mode, the Physics Desk shows core checks and estimates for a target load. |
| Shut down | Cool a two-circuit reactor · Stop an RBMK | The rods insert. On a two-circuit reactor, Cooldown shows the conditions for unsealing. |
| Diagnose a problem | Start refused · AUTO SCRAM · Annunciator | The action bar, alarm field and Log give a cause or the next check. |
| Maintain the plant | Power, emergency cooling and repair · Readings and action log | Status in PLANT and Engineer's Goggles show which supplies are available. |
Plan the complete plant first
- Choose a reactor. In a two-circuit reactor, the reactor heats coolant. The coolant carries heat to the Steam Generator and flows back. The generator heats water on its other side to make steam for the turbine. The coolant loop is called the primary circuit. In an RBMK, water boils inside the reactor and steam goes directly to the turbine.
- Build the plant. Open Ponder on the Reactor Controller or the RBMK Control Console. The scenes show the vessel and its connections. Build the power supply, cooling, steam outlet, water return and spent fuel route. Have protective gear and measuring tools ready.
- Check the plant cold. Link the Control Desk, fill the coolant circuit and open PLANT to see what startup still needs. Keep the rods fully inserted.
- Add fuel. Check the cooling and outlets again before pressing Start. In realistic mode, use the Physics Desk to review the core and target load.
FE is electrical energy. FE/t is the amount per game tick. SU is the load on a Create shaft. RPM is its speed. 1,000 mB fills one bucket. SCRAM is the emergency stop that inserts the rods. Keep cooling running after using it.
Connections and controls
A reactor frequency belongs to one reactor per world. Nozzles on the same reactor and its control desks can share the combination. Entering an occupied combination shows a message and keeps the previous frequency items. Registered reservations survive chunk unloads and restarts. Existing frequencies are registered as their nozzles load. If several reactors are registered with the same frequency, links on that frequency stay disabled until one owner remains. Give the other reactors unused combinations.
Right-click a Reactor Nozzle with an empty hand to cycle modes. Sneak-right-click to open its frequency slots.
| Mode | What it does |
|---|---|
| Hot Leg | RBMK: steam out. Two-circuit: hot coolant to the Steam Generator. |
| Cold Leg | RBMK: water in. Two-circuit: cooled coolant from the Steam Generator. |
| Fuel / Waste | Fuel in / spent fuel out. |
| Main Power / Reserve Power | Supplies the controls and internal RBMK circulation. |
| Emergency Coolant | Fills the reactor's makeup supply. |
| Emergency Spray | Fills the containment spray supply and allows sump drainage. |
| Relief | RBMK: vents the reactor. Two-circuit: indicates the linked generator's primary relief. |
| Emergency Hot Leg / Emergency Cold Leg | Connects the emergency cooling station. |
Copy the two items from the nozzle into the Reactor slots at the top right of the Control Desk, in the same order. Check the linked reactor under MAIN. The Link tab holds the separate Redstone command and status channels.
Scroll up over the rod slider to insert rods. Scroll down to withdraw them. Each notch changes the target by one percentage point. The Control Panel buttons use one point or ten with Shift. The slider tooltip shows the target, actual position and the reason if movement is blocked.
In simple mode, the linked Physics Desk displays readings. Realistic mode adds detailed checks and calculations. Start the reactor at the Control Desk.
Desk shortcuts
- Tab and Shift+Tab move between tabs, fields and buttons. Enter or Space activates the focused button.
- On the rod slider, the arrow keys change the target by one percentage point. Home selects 0% and End selects 100%. At 100%, the rods are fully inserted. The reactor's rod interlocks still apply.
- The Physics Desk accepts 0 to 48 hours and a target load of 1 to 100%. The calculation uses decimal values entered with a point or comma. Invalid input shows a hint next to the field.
- Tab leaves the field, Enter ends editing and Escape closes the desk. Resizing the window keeps the entered values.
- On the local Reactor Control Panel, Tab moves between SCRAM, ▼ to insert rods, ▲ to withdraw them, and R to reset. Use Enter or Space to activate a button. Hold Shift for rod steps of ten percentage points instead of one.
- If an instrument reports insufficient space, close it with Escape. Lower GUI Scale in Options → Video Settings or enlarge the window.
The desk has separate messages for loading, a missing reactor link and an incomplete structure.
A Create Display Link on the reactor controller, or on the control desk that already has its frequency items, reads power, temperature, pressure, rod insertion, coolant and status. Select the source in the link. A Create display or the Create: Controlling control console can be the target. The console does not write rods or SCRAM. An unloaded block has no live value. The controller reports itself; the desk reports the reactor linked by its frequency.
Start with rods inserted and verify water, output and waste paths before cautiously increasing power. Monitor pressure, temperature and return flow. Automatic SCRAM does not guarantee every accident is prevented.
Steam loop
On an RBMK, the Hot Leg feeds the turbine and the Cold Leg takes the condensed water. On a two-circuit reactor, Steam Out on the Steam Generator feeds the turbine, and Feedwater In takes the return. Either steam line can use Create pipes or Lead Pipes with compatible pumps. Lead Pipes connect to Lead Pipes, Lead Tanks, pumps and Nucleus blocks. Use a wrench to open or close a pipe window. Lead Tanks form their own multiblock. The Lead Tank Ponder scene shows the connections. The Reactor Creator places the cold two-circuit reactor. Build the Steam Generator and its lines afterwards.
Passive condensation defaults to steam.passiveCondensation=true in nucleus-common.toml. An existing explicit false remains unchanged after an update; change that value to enable it. Steam and Exhaust Steam slowly condense into water in tanks; adjacent ice or snow speeds this up. A lit Blaze Burner directly below the tank footprint prevents condensation; an empty burner does not. Disabling condensation keeps previously stored water.
Connect steam at the side or top and pump condensate out below. Both tank variants allow this while steam remains, without an additional switch. The Lead Tank bottom drains water only. Create tank bottom connections retain normal liquid handling but do not extract steam. Engineer's Goggles show stored condensate. Full condensate storage stops further condensation without discarding steam. Condensate remains stored through controller changes; check connections and amounts after resizing. Removing a controller transfers condensate to a surviving tank part when available. Empty the final tank block before removing it.
Turbines accept steam from below or from the sides perpendicular to the
shaft. With the default steam.turbineExhaustSteam=true, they release
Exhaust Steam above. Condense it in a Low Pressure Turbine, a Radiator
or a passive tank, then pump the water back to the appropriate return port.
Setting steam.turbineExhaustSteam=false gives the normal turbine a direct
water output. In FE mode, the turbine model spins and the turbine produces
FE while processing steam. In SU mode, steam drives its shaft.
Steam and Low Pressure Turbines each occupy nine blocks. Placement requires replaceable space and build permission at every position. Mining a housing block removes the turbine when you can break the entire footprint. Multiplayer claim behavior still needs in-game acceptance.
The steam side circulates water. The turbine uses steam to turn its shaft and produces Exhaust Steam by default. A Radiator with a fan or a Low Pressure Turbine turns it back into water. The Control Desk, Jade and WTHIT show the Steam Generator temperature. If there is a fault, check whether feedwater is reaching the generator and which side has failed. Feedwater can still carry heat away after a secondary breach. A primary breach loses coolant from the loop. See Failure and repair.
Cold primary coolant is a heated Create mixing recipe: 1,000 mB of water, sugar and a slimeball. Glycerin is not required. Water alone still runs an RBMK; the two-circuit primary circuit of a normal reactor takes primary coolant. The fluid id stays nucleus:primary_coolant_cold, so existing stocks remain valid. The old iron-nugget recipe no longer runs.
The code default of steam.fePerSteam is 100. At 2,400 mB/s that is 12,000 FE/t for one normal turbine: mB/s times fePerSteam, divided by 20. A low-pressure turbine scales with lowPressurePower. Shaft SU still comes from baseSU and does not change with this setting. A saved value, including 50 in an existing nucleus-common.toml, stays until it is edited.
steam.steamPerWater defines the steam-to-water ratio (0.1 to 10, default 1).
Vessels, turbines, radiators and passive condensation use the same conversion.
Condensate below 1 mB is retained as a fraction across reloads and tank controller
changes. Changing the setting does not retroactively convert stored water.
Fuel and waste
The internal fuel tank holds 1,000 mB per fuel-channel block, with a 4,000 mB minimum, for both water and RBMK reactors. Count every channel block, rather than just columns: 64 channel blocks provide 64,000 mB. The physics requires 150 mB per channel block for its full fuel-mass factor; the previous fixed 4,000 mB tank could not supply that from 27 channel blocks onward. Goggles and the Control Desk show the amount and capacity. Continue filling through the Fuel inlet.
Consumption follows relative reactor power. At full power, 1,000 mB of four-percent fuel lasts fuelLifetimeTicks in nucleus-common.toml (default 12,000 ticks, ten minutes). That lifetime applies to the whole reactor; extra channel blocks enlarge the tank. An existing saved value of 12,000 now has this meaning. Spent fuel is produced in the same volume. The internal waste tank remains 4,000 mB and still needs to be pumped out. Richer fuel lasts longer at the same power. The change has an offline check; confirm supply on a running plant in game.
Capacity is derived automatically on load and structure scans. Existing fuel and its mixture survive resizing and temporarily invalid structures. If stored fuel exceeds the new design capacity, it is retained and further filling is refused until room becomes available within that capacity. Connected pumps can automatically fill the larger tank, increasing the reactivity of a previously underloaded core. Begin the first test with rods inserted and check supply and measurements. Capacity changes have offline regression coverage; larger installations still require in-game acceptance.
Gas centrifuge cascades use seven to twelve vertical stages, each at 128 RPM or more. At 128 RPM, each stage costs 1,024 SU, for a total of 7,168 SU across seven stages or 12,288 SU across twelve. Engineer’s Goggles show the load of the whole column and why production is stopped. Feed and depleted output connect below; enriched fuel exits above. The seven-stage Ponder example is the starting point:
| Stages | U-235 enrichment |
|---|---|
| 7 | 4.30 % |
| 8 | 5.52 % |
| 9 | 7.06 % |
| 10 | 8.98 % |
| 11 | 11.37 % |
| 12 | 14.30 % |
Each cascade processes up to 60 mB of uranyl nitrate per game second. At 14.30% enrichment, it produces about 118 mB of fuel per minute at 20 TPS with a continuous feed and room in both output tanks. The yield is about 33 mB of fuel per 1,000 mB of feed.
Fewer than seven stages produce no reactor fuel; more than twelve give no further enrichment. Higher grades yield less enriched solution per unit of feed, but last longer at equal reactor power. Realistic mode uses the actual enrichment for core reactivity, so review rod positions and shutdown margin before changing fuel. Simple mode retains its power limits while richer fuel still reduces consumption.
Regulating and shutdown rod worth automatically compensates the extra fuel reactivity above four percent. The tested reference core can regulate a full 14.30-percent charge and become subcritical after SCRAM. No additional setting is required. Rod positions and drives are retained; after an update, the controller derives rod worth from the saved fuel mixture. Core layout, complete rod coverage and supply still matter; this does not automatically correct an unsuitable core design.
Existing rod speeds and SCRAM times remain: two seconds for the water reactor and eighteen seconds for the RBMK in the realistic model. The RBMK graphite tips can briefly increase reactivity during the first part of SCRAM travel. Normal rod travel has no graphite-tip pulse. SCRAM does not eliminate decay heat or cooling needs. Offline checks cover cold/hot reference cores and cooled shutdown sequences; actual in-game construction and operation still require acceptance.
Each grade is a separate fluid with matching bottles, buckets and Create Spout/Item Drain recipes. Its percentage appears in its name. Use separate external tanks for different grades; the reactor's Fuel inlet mixes accepted quantities by volume. Goggles and the Control Desk display the resulting reactor enrichment. Existing fuel, containers and Reactor Creator fuel remain four-percent fuel.
After changing column height, drain the previous product grade. Production waits instead of relabelling or discarding stored fluid. Goggles show the target and stored grades and the drain hint. Fractional products remain stored by grade for later production or merging. Former bottom stages retain fluids that cannot yet move into the current bottom's matching product tank.
The new grades add saved fluid and container IDs. Worlds containing them require matching client/server builds that know these IDs; older JARs do not. Existing worlds undergo no bulk conversion.
Pump spent fuel to a Spent Fuel Pool. An adjacent Reprocessing Plant takes it after cooling. Feed Nitric Acid and drive the plant at 64 RPM or faster. Filter Uranyl Nitrate, Plutonium Nitrate and High-Level Waste into separate tanks. For MOX, mix the Plutonium Nitrate with Depleted Uranyl Nitrate from the centrifuges. Use small rod adjustments and watch the power in realistic mode.
Press Sand, an Iron Ingot and High-Level Waste in a heated Basin to make a Vitrified Waste Canister. Place the canister in a closed Bentonite chamber with a Repository Vault facing out. The vault must be at Y −32 or lower by default. Right-click it to check the chamber and permanently seal the canisters.
Pool inputs are marked for saving immediately. A water bucket requires 1,000 mB of free space; with less room, both the bucket and pool contents remain unchanged and a message explains the refusal. Automated fluid input may still fill partial remaining space. Cooled-fuel output waits for loaded neighbors without loading chunks. These cases have offline regression checks; actual saving, chunk changes and bucket interaction still require manual gameplay acceptance.
RBMK and radiation
RBMK uses different blocks and physics: steam bubbles add reactivity and SCRAM is slower with an initial graphite-tip effect. Verify it in a disposable world first. Lead Pipes, with or without a window, Lead Tanks and the Coolant Buffer provide lead-strength radiation shielding; this does not make them valid reactor containment walls. Review nucleus-common.toml accident/protection settings and actual measurements; removing a visible spill does not prove all contamination is gone.
Starting and stopping an RBMK
- Open The RBMK and The RBMK Steam Loop at the RBMK Control Console.
- Link the Control Desk to an RBMK Nozzle. Keep the rods inserted, feed water into Cold Leg, and check that steam can reach the turbine from Hot Leg. Set up the power supply and waste route before adding fuel.
- Check the readings under MAIN and the supplies under PLANT. Press START at the Control Desk and watch the actual rod position and power.
- Press STOP for a planned shutdown or SCRAM for a rapid shutdown. Keep the water supply and steam outlet open as the rods insert and the core cools. After AUTO SCRAM, read the trip reason.
Reactor Glass and metallic reactor parts shield Nucleus radiation like
Reactor Casing. This includes controllers, nozzles, Control Panels, Heat Ports,
fuel channels, rod drives and their RBMK counterparts including caps. RBMK
Biological Shield uses concrete-strength shielding; both graphite variants use
separate material values. With radiation.blockThicknessCm = 10, one crossed
layer of Reactor Glass or Casing transmits a calculated 6.25% of gamma radiation.
Additional layers increase shielding; openings provide no protection. Ordinary
glass remains weaker. Existing blocks gain this protection without rebuilding
or saved-data migration. Material classification and radiation transmission have
offline checks; actual plant exposure still needs gameplay acceptance. This
block shielding does not change Mekanism radiation sources or existing doses.
World behaviour
Nucleus protects reactor water during chunk unloading itself, including without TDCreate. Unloading neither reads nor changes interior blocks; ordinary controller removal still clears water. No new setting or saved-data migration is required. Both teardown paths have offline regression checks; chunk transitions and server shutdown with a real plant still need manual acceptance.
A valid assembled reactor blocks ordinary mob spawning inside the shell, including fish and squid. Animals already present or placed by players stay.
Troubleshooting
- Start refused. Read the action bar. For a two-circuit reactor, check its startup conditions. For an RBMK, check the structure, console, drives and fuel.
- Pressure or temperature rising. Trigger SCRAM, keep cooling running and check the measured supply and outlet. For an automatic trip, follow the diagnostic steps.
- Reprocessing has stopped. Check the pool state, adjacency, shaft speed, acid and free outputs. The Ponder scene shows how the connections are assigned.