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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

More Mekanism guides

Mekanism · Addon guideMekanism Generators Guide: How to Build an Ethylene Gas-Burning Power PlantThis guide teaches you how to transition from early-game Wind Generators to a fully automated, self-sustaining Ethylene Gas-Burning Power Plant using the Mekanism Generators addon. Mastering this setup is essential because Ethylene provides a massive, reliable mid-game power boost capable of running heavy machinery like the Digital Miner and advanced ore processing factories.Beginner8 steps
Mekanism · Setup guideHow to Use and Filter the Digital Miner in MekanismThe Digital Miner is Mekanism's premier automated excavation machine, allowing you to targetedly extract specific ores from the ground without destroying the surrounding landscape. By mastering its advanced filtering system and power management, you will secure a practically infinite supply of raw materials to feed your high-tier ore processing factories.Intermediate7 steps
Mekanism · AutomationMekanism QIO Storage Network & Auto-Crafting GuideOnce you reach Mekanism's late-game progression, traditional chest networks and long pipe corridors quickly become an unorganized mess. This guide will walk you through setting up a wireless Quantum Item Orchestration (QIO) network and linking it to a Formulaic Assemblicator and Logistical Sorter to create a cable-free storage and passive auto-crafting system.Intermediate8 steps
Mekanism · PowerHow to Build a Safe Mekanism Fission Reactor & Industrial TurbineThis guide walks you through constructing a fully automated and explosion-proof Fission Reactor paired with an Industrial Turbine in Mekanism. Mastering this advanced setup provides massive mid-to-late-game power generation and produces the Nuclear Waste required to unlock Polonium, Plutonium, and the endgame Mekasuit.Advanced8 steps
Mekanism · ProgressionMekanism Nuclear Waste, Polonium, Plutonium & SPS GuideMastering Mekanism's endgame requires turning hazardous Nuclear Waste from your Fission Reactor into Polonium, Plutonium, and ultimately Antimatter. This advanced guide covers the safe handling of radioactive gases, the automation of Pellet production, and the construction of both the Induction Matrix and the massive Supercritical Phase Shifter (SPS). Completing this progression unlocks the absolute pinnacle of Mekanism technology, including the modular MekaSuit and high-tier QIO storage components.Advanced8 steps
Mekanism · PowerMekanism Fusion Reactor Guide: D-T Fuel & Laser Ignition SetupMastering the Mekanism Fusion Reactor is the ultimate endgame milestone, providing millions of FE/t to power massive industrial bases and the Supercritical Phase Shifter. This guide breaks down the entire automated infrastructure required to refine Deuterium and Tritium, charge a Hohlraum, align a high-energy Laser Amplifier ignition system, and push your reactor to its absolute maximum energy output.Advanced7 steps