Modular Machinery Reborn · Addon guide · Intermediate

Modular Machinery Reborn Mekanism Guide: Gas, Slurry, and Pigment Hatches

This guide explains how to integrate Mekanism's chemical systems—including Gases, Slurries, Infuse Types, and Pigments—into custom multiblock machines using Modular Machinery Reborn. By mastering Chemical Hatches and recipe scripting, you can design massive, custom processing plants that scale far beyond standard single-block Mekanism machines. This allows modpack makers and advanced players to bridge the gap between custom multiblock architecture and high-tier chemical processing.

What you need

  • Modular Machinery Reborn (and its Mekanism compatibility addon if required by your specific Minecraft version)
  • Mekanism installed and loaded
  • KubeJS or a global Datapack Loader (such as Paxi or Open Loader)
  • Machine Controller and Modular Machine Casings
  • Chemical Input Hatch and Chemical Output Hatch (any tier, from Tiny to Ludicrous)
  • Mekanism Pressurized Tubes and a Configurator
  • JEI (Just Enough Items) for checking exact chemical registry IDs

Step by step

  1. 1Verify Chemical Hatch Availability

    Open your inventory and search JEI for 'Chemical Hatch' to confirm the Mekanism integration is active. You should see tiered variants of the Chemical Input Hatch and Chemical Output Hatch, ranging from Tiny and Small up to Massive and Ludicrous. Like fluid or item buses, higher tiers offer significantly larger internal storage capacities for gases and slurries. Check the tooltips in JEI to see the exact millibucket (mB) capacity for each tier in your current modpack configuration.

    Tip: In newer versions of Mekanism, Gases, Slurries, Pigments, and Infuse Types are unified under the 'Chemical' umbrella, meaning one hatch type handles all of them.

  2. 2Update Your Multiblock Structure JSON

    Navigate to your datapack or KubeJS data folder where your custom machine JSON is stored. In the structure layout definition, replace one or more standard Machine Casings with a Chemical Input Hatch and a Chemical Output Hatch. If you want players to use any tier of hatch, use the mod's hatch tag system or define an array of acceptable chemical hatch block IDs for that specific coordinate. Save the file and run the /reload command in-game to update the multiblock blueprint.

    Tip: Always allow multiple tiers of Chemical Hatches in your structure JSON so players can upgrade their machine's buffer capacity later without rebuilding the entire multiblock.

  3. 3Construct the Physical Multiblock

    In your world, build the custom multiblock according to your updated structure pattern. Place the Machine Controller, standard Machine Casings, Energy Input Hatch, and your newly added Chemical Input and Output Hatches in their designated spots. Once the final block is placed, right-click the Machine Controller to open its GUI. Verify that the status reads 'Structure Formed' rather than 'Invalid Structure'.

  4. 4Connect Mekanism Logistics

    Attach Mekanism Pressurized Tubes directly to the exposed faces of your Chemical Input and Output Hatches. Unlike standard Fluids which use Mechanical Pipes, all Mekanism chemicals (including liquid-like slurries and pigments) require Pressurized Tubes for transport. Equip your Mekanism Configurator, shift-right-click the connection point on the Chemical Output Hatch to set the tube to 'Pull', or configure the hatch's internal GUI if auto-ejection is supported.

    Tip: Never use Mechanical Pipes on Chemical Hatches; even if a Slurry or Pigment sounds like a liquid, the game engine treats it strictly as a Mekanism chemical.

  5. 5Find Exact Chemical Registry IDs

    Before writing a recipe, you need the exact registry names of the chemicals you want to process. Press F3 + H in-game to enable Advanced Tooltips, then open JEI and search for the Mekanism chemical (for example, Sulfuric Acid or Dirty Iron Slurry). Hover over the chemical in JEI to view its ID, such as 'mekanism:sulfuric_acid' or 'mekanism:dirty_iron'. Write these IDs down along with the required amounts in millibuckets (mB).

    Tip: Be careful not to confuse Fluid variants with Chemical variants! For example, 'mekanism:sulfuric_acid' is a chemical gas, while 'mekanism:flowing_sulfuric_acid' is a liquid fluid.

  6. 6Script the Chemical Recipe via KubeJS or JSON

    Open your server scripts folder (for KubeJS) or your recipe datapack folder. Create a new modular machinery recipe targeting your custom machine's ID. Add a chemical input requirement specifying the chemical ID and amount in mB, and a corresponding chemical output (or item/fluid output, depending on your goal). For example, in KubeJS, use the builder methods like `.requireChemical('1000x mekanism:oxygen')` or define the requirement type as `modular_machinery_reborn:chemical` in raw JSON.

    Tip: Check the mod's official test scripts or use the /kubejs hand command while holding a Chemical Gauge Dropper to verify the exact syntax for your specific version.

  7. 7Test and Balance Processing Rates

    Run /reload in-game to load your new recipe, then pump the required gas, slurry, or pigment into the Chemical Input Hatch. Watch the Machine Controller GUI to ensure the recipe detects the input, consumes energy from your Energy Hatch, and progresses the crafting bar. Once complete, verify that the output chemical appears in the Chemical Output Hatch and is successfully extracted by your Pressurized Tubes.

How it works

Modular Machinery Reborn operates on a controller-listener architecture. The Machine Controller does not hold items, fluids, or gases itself; instead, when the multiblock forms, the controller scans the structure and links to all attached hatches and buses. Each tick (or at a configured interval), the controller checks the inventory of its linked Chemical Input Hatches against its registered recipe list.

Mekanism handles gases, slurries, infuse types, and pigments using a custom capability separate from Minecraft's standard Forge/NeoForge FluidHandler capability. Because of this separation, standard Fluid Hatches cannot recognize Mekanism gases unless they are first condensed into liquid form via a Rotary Condensentrator. The Chemical Hatches provided by Modular Machinery Reborn act as a bridge, implementing Mekanism's specific chemical handler capability so the multiblock can directly read, consume, and generate raw Mekanism chemicals.

When a recipe runs, the Machine Controller deducts the exact millibucket requirement from the Chemical Input Hatch at the start of the cycle (or per-tick, if configured as a continuous requirement). At the end of the duration, it pushes the resulting chemical directly into the internal buffer of the Chemical Output Hatch. If the output hatch is full, the controller will pause or stall the recipe to prevent voiding valuable resources.

Common mistakes

  • Confusing Fluids with Gases in Recipes: Many Mekanism substances (like Oxygen, Hydrogen, or Brine) have both a Liquid Fluid form and a Gas Chemical form. If you put a Fluid ID into a Chemical Hatch recipe, or pump a Gas into a Fluid Hatch, the machine will never start.
  • Using the Wrong Mekanism Pipe: Players frequently attach Mechanical Pipes to Chemical Hatches when dealing with Slurries or Pigments because they sound like liquids. Always use Pressurized Tubes for any interaction with a Chemical Hatch.
  • Undersizing Hatch Tiers for High-Speed Recipes: If a recipe requires 10,000 mB of gas to start, but you only placed a Tiny Chemical Input Hatch with an 8,000 mB capacity on the multiblock, the recipe can never trigger. Either upgrade the hatch tier or add a second input hatch to split the buffer.
  • Cross-Contaminating Single Hatches: A single Chemical Input Hatch can usually only hold one type of chemical at a time. If your recipe requires both Hydrogen and Oxygen, you must build two separate Chemical Input Hatches into the multiblock structure.

FAQ

Can one Chemical Hatch handle Gases, Slurries, and Pigments, or do I need different blocks?

In modern versions of Modular Machinery Reborn paired with Mekanism, the unified Chemical Hatch handles all four Mekanism chemical types (Gas, Slurry, Infuse Type, and Pigment). However, a single hatch block can only store one specific substance at any given moment.

How do I clear a stuck chemical out of an Input Hatch?

You can use a Mekanism Gauge Dropper inside the hatch's GUI to manually pick up or dump small amounts of leftover gases and slurries, or simply break and replace the hatch block to clear its internal buffer.

Why does my machine say 'Missing Output Space' when the Chemical Output Hatch is empty?

This usually means the recipe outputs more millibuckets in a single craft than the total capacity of your currently installed Chemical Output Hatch tier, or there is a trace amount of a different chemical blocking the hatch tank.

Can I consume chemicals per-tick instead of all at once?

Yes. In your JSON or KubeJS recipe script, you can flag the chemical requirement as a per-tick consumption, which is ideal for continuous fuel burning or coolant injection mechanics.

By properly integrating tiered Chemical Hatches and referencing exact Mekanism chemical registry IDs in your scripts, you can seamlessly merge complex gas, slurry, and pigment processing into massive custom multiblocks.

More Modular Machinery Reborn guides

Modular Machinery Reborn · Getting startedModular Machinery Reborn Getting Started Guide: Building Your First MultiblockModular Machinery Reborn brings massive, custom factory automation to Minecraft by transforming standard blocks into unified processing structures. In this beginner guide, you will learn how to read blueprints, configure a Machine Controller, and assemble your very first functional multiblock machine. Mastering these core concepts is essential for navigating expert modpacks or designing your own custom machinery.Beginner7 steps
Modular Machinery Reborn · ExplainedBuses, Hatches, and Casings Explained: Tiered I/O LogicMastering the tiered input and output components of Modular Machinery Reborn is essential for constructing and scaling custom multiblock structures. This guide breaks down how Casings, Item Buses, Fluid Hatches, and Energy Hatches interact with the Machine Controller, allowing you to optimize resource throughput and upgrade your setups dynamically without rebuilding from scratch.Beginner7 steps
Modular Machinery Reborn · PowerHow to Power Modular Machines: Energy Hatches and RF/FE SetupThis guide explains how to supply Forge Energy (FE) or Redstone Flux (RF) to custom multiblocks in Modular Machinery Reborn, as well as how to extract power from custom generator structures. Mastering the tiered Energy Hatch system is essential for automating late-game modpack processing lines and preventing power bottlenecks during high-demand recipes.Intermediate7 steps
Modular Machinery Reborn · AutomationHow to Automate Modular Machinery: AE2, Refined Storage, and Pipe SetupsAutomating custom multiblocks in Modular Machinery Reborn requires smart routing across multiple input and output blocks rather than connecting to a single machine face. In this guide, you will learn how to integrate tiered Item Input Buses, Fluid Input Hatches, and Output blocks with Applied Energistics 2, Refined Storage, and standard logistics pipes. Mastering these setups prevents recipe deadlocks, stops input buses from overflowing, and enables hands-free batch crafting.Intermediate7 steps
Modular Machinery Reborn · Setup guideHow to Create Custom Multiblocks with JSON and DatapacksModular Machinery Reborn gives you the power to design and program massive, custom multiblock machines from scratch. In this guide, you will learn how to build a physical structure in-game, export its block pattern using the built-in Structure Creator tool, configure modifiers in JSON, and load your creation globally using a datapack loader.Intermediate7 steps
Modular Machinery Reborn · ExplainedModular Machinery Reborn KubeJS Guide: Scripting Custom RecipesModular Machinery Reborn is an empty canvas until you populate your custom multiblocks with functional processing rules. In this guide, you will learn how to write KubeJS server scripts to dynamically inject complex recipes into your machines without writing verbose raw JSON files. Mastering this allows you to balance processing ticks, combine item, fluid, and energy inputs, and design probability-based byproduct systems for an advanced modpack experience.Advanced7 steps