Mekanism · Troubleshooting · Intermediate
Mekanism Troubleshooting Guide: Fixing Radiation, Pipe Jams & Multiblocks
Mekanism builds complex industrial lines, and a single misconfigured pipe or broken nuclear barrel can halt your entire base or render it uninhabitable. This troubleshooting guide provides practical solutions for clearing stuck chemicals, surviving radiation leaks, fixing incomplete multiblocks, and resolving processing bottlenecks. Mastering these fixes will save you hours of tearing down and rebuilding your automation setups.
What you need
- Configurator (fully charged)
- Gauge Dropper
- Hazmat Suit (Mask, Gown, Pants, Boots) or Mekasuit with Radiation Shielding Units
- Geiger Counter and Dosimeter (optional, for diagnostics)
- Tier Installers (Basic, Advanced, Elite, Ultimate)
- Speed, Energy, and Gas Upgrades
Step by step
1Purge Stuck Gases and Fluids with a Gauge Dropper
When the wrong chemical enters a machine, it blocks all future processing because Mekanism buffers only accept one substance at a time. Craft a Gauge Dropper, open the clogged machine's GUI, and click on the internal gas or fluid gauge with the Dropper in your cursor. Left-clicking extracts a small amount into the Dropper, while Shift-left-clicking completely voids the internal tank.
Tip: If a Pressurized Tube network is jammed with the wrong gas, break one segment to stop the flow, or pipe it into a Chemical Tank set to 'Dump' mode.
2Fix Pipe and Transporter Connection Refusals
If your Logistical Transporters, Pressurized Tubes, or Mechanical Pipes refuse to move resources, your machine sides are likely misaligned. Hold your Configurator and Shift-scroll to switch it to the corresponding transmission mode (Items, Gases, Fluids, or Energy) to see color-coded overlays on the machine faces. Open the machine GUI, click the Side Config tab on the left, ensure the correct resource tab is selected, and match the colored squares (e.g., Blue for Output, Red for Input) to the physical side where your pipe is attached.
Tip: Make sure the 'Auto-Eject' toggle in the top right of the Side Config menu is turned ON if you are not using a pipe set to 'Pull' mode.
3Survive and Contain Radiation Leaks
Breaking a machine, pipe, or Radioactive Waste Barrel containing nuclear materials (like Polonium, Plutonium, or Spent Nuclear Waste) releases lethal ambient radiation. Immediately craft and equip all four pieces of the Hazmat Suit to stop your player from absorbing further lethal doses while you clean up. Go to the leak source and seal off the flow from your Fission Reactor or processing line, ensuring any remaining waste is routed exclusively into intact Radioactive Waste Barrels.
Tip: Keep a spare Hazmat Suit and a bed in a chunk far away from your nuclear facility so you don't get stuck in a death loop at your spawn point.
4Clear Environmental and Player Radiation
Once leaked, radiation cannot be vacuumed up in survival mode; it must decay naturally over real-time hours depending on the severity of the spill. Use a Geiger Counter to measure environmental radiation and a Dosimeter to check your personal dose. If you are playing with cheats enabled or are a server admin, you can instantly fix an accidental base-ruining leak by running the command '/mek radiation heal' to cure yourself and '/mek radiation removeAll' to scrub the chunk clean.
Tip: Never use the 'Dump' button on a Chemical Tank holding radioactive gas, and never break a Pressurized Tube that still shows green or blue nuclear particles inside.
5Diagnose Multiblocks That Refuse to Form
When a Dynamic Tank, Industrial Turbine, Thermoelectric Boiler, or Fission Reactor does not show red particles upon placement, it has failed its structural check. First, verify that all outer edges and corners use solid Casing blocks rather than Structural Glass or Ports. Second, check the internal volume for accidental blocks like torches, light nodes from invisible lamps, or misplaced valves. Finally, ensure the footprint matches the allowed dimensions in JEI or the in-game guide, as many structures have strict height-to-width ratios.
Tip: Break and replace a single casing block on the exterior frame to force the multiblock to re-evaluate its structure.
6Eliminate Machine Processing Bottlenecks
If one machine in your ore processing chain is constantly full while the next is starving, you have a throughput bottleneck. Craft a Basic Tier Installer and Shift-right-click the slow machine in the world to convert it into a Factory, which adds parallel processing slots; repeat with Advanced, Elite, and Ultimate installers for up to 9 slots. Open the Factory GUI, enable 'Auto-Sort' on the left tab to evenly distribute incoming items across all slots, and insert Speed Upgrades and Energy Upgrades into the top-right upgrade window.
Tip: For Chemical Injection Chambers and Purification Chambers, always install 8 Gas Upgrades alongside your Speed Upgrades, or the machine will starve for Oxygen and Hydrogen Chloride before it can finish a cycle.
How it works
Mekanism transmitters (pipes, tubes, cables, and transporters) operate as unified networks with an internal buffer. Every connected segment shares the same chemical or fluid pool. Because a network can only hold one type of gas or fluid at a time, accidentally pumping Oxygen into a Hydrogen line locks the entire pipe network until it is completely drained or broken and replaced.
Machine side configurations are modular and resource-specific. A single physical block face on an Electrolytic Separator or PRC can handle multiple tasks, or be dedicated to one, depending on how you assign the color profiles in the Side Config menu. Meanwhile, the Configurator alters the pipe's state (Normal, Push, Pull, or None), which overrides passive machine behavior by actively pulling from inventories even if the machine's Auto-Eject is disabled.
Multiblocks use a master-slave block detection algorithm triggered when the final valid frame block is placed. The algorithm scans the outer bounding box for solid casings on the edges, valid ports/glass on the faces, and specific internal components (like Turbine Blades or Fission Fuel Assemblies) inside. If even a single non-air block or feral light source occupies an internal air gap, the scan aborts without forming.
Common mistakes
- Using Structural Glass on the edges or corners of a multiblock (glass is only valid on the flat inner faces of the walls, roof, and floor for most Mekanism structures).
- Forgetting to install Energy Upgrades alongside Speed Upgrades, as Speed Upgrades increase power consumption exponentially while Energy Upgrades expand the buffer and reduce per-tick cost.
- Breaking a Radioactive Waste Barrel to move it instead of letting it slowly decay its contents first, which triggers an immediate radiation catastrophe.
- Confusing Infuse Types, Gases, and Slurries in the Side Config tab—for example, trying to output a Slurry using the Fluid or Gas config tab instead of the dedicated Slurry tab.
FAQ
Why is my machine taking power and inputs, but the progress bar keeps resetting or stalling?
Your power generation cannot keep up with the machine's per-tick demand. The internal energy buffer is draining mid-operation. Add Energy Upgrades to the machine or upgrade your power cables and generators.
Can I drink Milk to cure Mekanism radiation poisoning?
No. Unlike vanilla potion effects, Mekanism radiation is a persistent player capability value. You must wear a Hazmat Suit or shielded Mekasuit and wait for the dosage to decay over time, or die (if your server config resets radiation on death).
Why won't my Tier Installer work on my machine?
You cannot skip tiers. You must apply a Basic Tier Installer first, then Advanced, Elite, and finally Ultimate in exact sequential order. Also, certain specialized machines (like the PRC or Electrolytic Separator) do not have Factory variants.
How do I empty a Pressurized Tube network without breaking every single pipe?
Connect a Chemical Tank to the tube network, set the connecting tube segment to 'Pull' mode with your Configurator so it drains the pipe buffer into the tank, and set the Chemical Tank's GUI mode to 'Dump'.
By mastering the Gauge Dropper, Configurator side-matching, Factory upgrades, and strict nuclear containment protocols, you can quickly diagnose and resolve any Mekanism automation failure.