Modular Machinery Reborn · Troubleshooting · Beginner
Modular Machinery Troubleshooting Guide: Fixing 'Invalid Structure' & Recipe Bugs
Building massive custom multiblocks in Modular Machinery Reborn can be incredibly rewarding, but seeing an 'Invalid Structure' error or watching a recipe stall at zero percent is a common hurdle for beginners. This guide will teach you how to systematically diagnose and fix structure formation failures, blockstate mismatches, and stuck crafting processes. Mastering these troubleshooting techniques will save you hours of frustration and keep your factory running smoothly.
What you need
- Machine Controller (configured for your specific multiblock)
- Blueprint (or access to the multiblock preview in JEI/EMI)
- Tiered Input/Output Buses (for items)
- Tiered Input/Output Hatches (for fluids)
- Tiered Energy Input/Output Hatches
- Machine Casings (and any specific decorative blocks required by your modpack's recipe)
- Wrench or Pickaxe for quick adjustments
Step by step
1Activate the Hologram Preview
Start by placing your Machine Controller in the world and checking the required structure in JEI or by holding a Blueprint. Activate the in-world holographic preview if your modpack provides one. This visual overlay projects the exact ghost blocks around your controller, showing you immediately if the machine is extending in the direction you expect.
Tip: Always clear a larger area than you think you need before placing the controller, including removing tall grass or snow layers that count as solid blocks.
2Verify Controller Orientation and Rotation
When you place the Machine Controller, its front face determines the relative rotation of the entire multiblock layout. If you built the structure facing North-South, but placed the controller facing East, the validation check will fail entirely. Break and replace the controller so its front texture aligns perfectly with the front of your build.
Tip: Press F3 to check your cardinal direction if you are building from a third-party schematic without an in-game hologram.
3Fix Blockstate and Directionality Mismatches
Inspect directional blocks like stairs, logs, pistons, or custom vents within your structure. Modular Machinery Reborn checks the exact blockstate (such as 'facing=north' or 'half=bottom') unless the modpack creator explicitly ignored it in the code. Use the hologram or JEI preview to see which way directional blocks are pointing, then break and replace yours to match the exact orientation.
Tip: Press F3 and look at a block to view its current blockstate data on the right side of your screen.
4Check Hatch and Bus Placements
Ensure you have placed your Item Buses, Fluid Hatches, and Energy Hatches in valid locations. Modpack authors usually designate specific casing blocks that are allowed to be replaced by functional hatches, while structural frames must remain strictly as Machine Casings. Furthermore, verify that you did not accidentally swap an Input Bus for an Output Bus, or use a Tiny hatch where a Reinforced or Bigger tier is explicitly required.
Tip: Check the JEI multiblock preview by hovering over the flickering casing blocks to see which specific buses and hatches are allowed in those spots.
5Resolve Shared-Wall and Chunk Conflicts
If you built two multiblocks right next to each other to save resources, they might be failing to form due to a shared-wall conflict. Most custom machines cannot share functional hatches, and many struggle to validate if another controller is already claiming the same Machine Casings. Separate your machines by at least one block of air, and press F3+G to ensure your multiblock does not cross into an unloaded chunk.
Tip: Keep the entire footprint of a massive machine inside a single chunk whenever possible to prevent validation resets when walking away.
6Diagnose Recipes Not Starting
Once the Machine Controller GUI says the structure is valid, insert your ingredients into the Input Buses and Fluid Hatches. If the machine refuses to start, double-check JEI for hidden requirements like specific fluid temperatures, exact item counts, or a minimum Energy Hatch tier. Remember that Modular Machinery Reborn separates items, fluids, and energy strictly into their respective buses and hatches.
Tip: Make sure you aren't piping items into the Machine Controller itself; items must always go into an Item Input Bus.
7Unstick Stalled Crafting Processes
If a recipe starts but freezes mid-operation or resets its progress, open your Energy Input Hatch and Output Buses immediately. A recipe will stall if your power generation drops below the machine's continuous tick requirement. It will also freeze at the very end of the cycle if the Item Output Bus or Fluid Output Hatch does not have enough empty capacity to receive the finished product.
Tip: Upgrade your Output Buses to a higher tier with more inventory slots if you are running recipes with multiple different byproducts.
How it works
Modular Machinery Reborn operates on a coordinate-offset validation system controlled by JSON datapacks or KubeJS scripts. The Machine Controller acts as the origin point (0,0,0). Periodically, the controller scans the surrounding coordinates relative to the direction it is facing. If even a single coordinate contains a block ID or blockstate that does not match the script's strict whitelist for that position, the scan aborts and outputs the 'Invalid Structure' error.
Once the structure validates, the controller links all attached Buses and Hatches into a single logical network. When you insert materials, the controller cross-references the contents of all Input Buses and Hatches against its registered recipe list. However, it only checks for recipe completion conditions and continuous power draw on a tick-by-tick basis. If the energy buffer empties for a single tick, or if the output inventories cannot physically accept the defined result array, the crafting logic pauses or aborts to prevent voiding items.
Common mistakes
- Leaving invisible blocks inside hollow structures: Air pockets inside a machine (like the center of a blast furnace) must actually be vanilla air. Residual light blocks from feral flare lanterns, cables, or snow layers will invalidate the structure.
- Confusing Buses with Hatches: Trying to pump fluids into an Item Bus or items into a Fluid Hatch is a frequent error. Always remember that 'Buses' are for solid items and 'Hatches' are for fluids and energy.
- Using the wrong hatch tier: Even if a Tiny Energy Input Hatch fits into the structure and validates the multiblock, its internal buffer might be too small to hold the total energy per tick required by an endgame recipe.
- Forgetting to load the datapack: If you are designing your own modpack or playing a custom map, remember that Modular Machinery Reborn is a framework toolset; it requires a datapack loader or KubeJS scripts to actually load the machine structures and recipes into the game.
FAQ
Why does my Machine Controller say 'Invalid Structure' when every block matches the JEI preview?
You likely have a blockstate mismatch (such as a stair, log, or directional casing facing the wrong way) or an invisible block (like a hidden light source from a mod) occupying a space that is supposed to be pure air.
Can I place my Input and Output Buses anywhere on the machine?
Usually, no. Modpack creators define specific zones (often replacing standard Machine Casings on the outer walls) where buses and hatches are allowed. Check the JEI preview to see which specific blocks cycle through the hatch options.
Why did my recipe progress bar stop moving at 99%?
Your Output Bus or Output Hatch is full, or it is too small to hold the recipe's output. Empty the output inventories or upgrade them to a higher-capacity tier so the machine can dump the finished product.
Do I need to specify which recipe the Machine Controller should run?
No, the controller automatically detects the recipe based on the items and fluids currently sitting in your Input Buses and Hatches, provided you also have the required energy available.
By verifying controller orientation, matching exact blockstates, ensuring proper hatch tiers, and keeping output inventories clear, you can easily resolve any structure or recipe bug in Modular Machinery Reborn.