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