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

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

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

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

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

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

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

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

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