Modular Machinery Reborn · Addon guide · Intermediate

Modular Diversity, Modular Assembly & GuGu Utils: Addon Mechanics Explained

This guide explains how to master the extended Modular Machinery family, including Modular Machinery Reborn, by utilizing the Modular Assembly, Modular Diversity, and GuGu Utils addons. You will learn how to automate massive multiblock construction, integrate cross-mod magic and environmental requirements into your machines, and manage dynamic tick-based inputs. Mastering these addons is essential for navigating expert modpacks and automating complex custom factories without frustration.

What you need

  • Machine Controller (configured for your target structure)
  • Machine Blueprint (required in many configurations to define the structure)
  • Modular Assembly item (such as the Assembly Halo or Construct Tool, depending on your version)
  • Standard Modular Machinery blocks (Machine Casings, Item Input/Output Buses, Fluid Hatches, Energy Hatches)
  • Addon-specific Hatches (Mana Hatch, LP Hatch, Aspect Provider, or Environment Hatch)
  • Every exact block listed in the JEI multiblock preview loaded into your inventory

Step by step

  1. 1Inspect the Multiblock and Addon Requirements in JEI

    Open your inventory, locate the Machine Controller or its specific Machine Blueprint in JEI, and view its recipes and structure preview. Pay close attention to the required buses and any text overlays detailing environmental conditions, such as specific biomes, dimension restrictions, or altitude requirements added by Modular Diversity. Note the exact block counts by hovering over the ingredients list in the structure preview.

    Tip: You can pause the cycling block preview in JEI by holding the Shift key to see which specific tier of bus or hatch is allowed in a flexible slot.

  2. 2Place and Orient the Machine Controller

    Craft the Machine Controller and place it in the center of your designated building area. Ensure there is enough empty space behind, above, and below the controller to accommodate the full dimensions of the multiblock. If your modpack requires a Machine Blueprint to initialize the structure, insert it into the controller's dedicated GUI slot now.

    Tip: The front face of the Machine Controller completely dictates the rotation of the entire multiblock structure.

  3. 3Gather Materials for Modular Assembly

    Collect all the required Machine Casings, vents, circuitry, and standard Item or Fluid Hatches into your main player inventory. If the structure preview shows variable slots (like any tiered Input Bus), carry the exact tier you want the auto-builder to place. Keep your inventory organized, as the assembly tool pulls directly from your main slots.

    Tip: If a recipe requires hundreds of casings, some modpacks allow the assembly tool to pull directly from an adjacent chest placed next to the controller.

  4. 4Execute Instant Construction

    Equip your Modular Assembly tool or simply hold the required Machine Blueprint in your main hand (check your specific pack's tooltip for the exact trigger item) and Sneak + Right-Click the Machine Controller. The addon will instantly scan the area around the controller and place blocks from your inventory into their valid relative coordinates. If your inventory runs out of blocks mid-build, refill your slots and repeat the click to finish the structure.

    Tip: Clear out snow layers, tall grass, and invisible light blocks from modded lanterns beforehand, as they will block the auto-builder.

  5. 5Install Modular Diversity Magic Hatches

    For recipes that bridge technology and magic, replace one of the valid casing slots with the appropriate Modular Diversity hatch, such as a Botania Mana Input Hatch, Blood Magic Life Essence Hatch, or Mekansim Laser Hatch. Connect your magic transport network directly to this hatch—for example, aiming a Mana Spreader directly at the Mana Input Hatch. Open the Machine Controller GUI to verify that the multiblock still reads as 'Structure Formed'.

    Tip: Magic hatches follow the same tiering logic as item buses; ensure your hatch has a high enough maximum capacity to hold the total resource cost of the recipe.

  6. 6Satisfy Environmental Conditions

    If your recipe is provided by Modular Diversity or GuGu Utils, it may require passive environmental factors rather than physical items. Check the recipe page in JEI for icons indicating required daylight, weather, biome temperature, or minimum Y-level. Adjust your setup around the machine to meet these thresholds before inserting crafting ingredients, as the controller will refuse to start if conditions are unmet.

    Tip: Unlike standard inputs, environmental checks are evaluated continuously; if a recipe requires daytime and night falls mid-craft, the machine may stall or lose progress.

  7. 7Configure GuGu Utils Dynamic Ports

    When dealing with GuGu Utils components, such as the Environment Hatch, Starlight Input Hatch, or PneumaticCraft Pressure Hatch, attach your external gauges and regulators directly to the hatch. Many GuGu Utils recipes consume or check resources on a per-tick basis rather than all at once at the start. Set up a continuous buffer (like a pressurized air tank or a constant mana supply) so the input never drops to zero during the crafting cycle.

    Tip: Use redstone comparators on your hatches to automatically shut off item inputs if your per-tick auxiliary resource runs dangerously low.

How it works

At its core, the Modular Machinery system operates through the Machine Controller, which periodically scans a 3D coordinate grid relative to the direction it is facing. When you trigger Modular Assembly, the addon reads this exact internal JSON or KubeJS coordinate array and attempts to match items in your inventory to the block tags allowed at each coordinate. Instead of forcing you to build layer-by-layer, it iterates through the coordinate list and places valid blocks in a single server tick.

Modular Diversity and GuGu Utils expand the controller's recipe evaluation logic. Standard Modular Machinery only checks if its Item Buses, Fluid Hatches, and Energy Inputs contain the required starting amounts before locking the resources and advancing a crafting timer. The addons introduce new requirement types into this loop. Magic hatches act as specialized buffers that convert external mod APIs (like Botania Mana or Astral Sorcery Starlight) into numerical values the Machine Controller can read and deduct.

Furthermore, environmental and per-tick mechanics alter how the crafting timer progresses. Instead of a simple start-and-finish check, GuGu Utils and Modular Diversity inject validation checks into every single tick of the crafting process. If a recipe requires a specific biome temperature or a continuous stream of air pressure, the controller queries the world state or the hatch buffer twenty times a second. If the validation fails for even a single tick, the controller pauses the recipe or voids the progress entirely, depending on how the modpack author scripted the machine.

Common mistakes

  • Using the wrong tier of Bus or Hatch during auto-assembly: Modular Assembly will grab the first valid bus it finds in your inventory, which might be a Tiny Input Bus that lacks enough slots or capacity for late-game recipes. Only keep the exact tier you want to install in your inventory when clicking.
  • Ignoring non-air blocks in the build zone: Microblocks, torches, feral flare lantern lights, and tall grass will stop Modular Assembly from placing casings, leaving you with an unformed structure. Always clear the exact bounding box completely.
  • Underestimating per-tick consumption: Players often supply just enough energy, mana, or fluid to start a recipe, forgetting that GuGu Utils and Modular Diversity frequently use per-tick drains. If the buffer hits zero halfway through, the recipe resets and eats your initial items.
  • Placing hatches in non-designated casing slots: Not every Machine Casing in a multiblock can be replaced with an Input/Output Hatch. Always check the cycling blocks in the JEI preview to see which specific coordinates permit hatches.

FAQ

Why does my Machine Controller say the structure is incomplete after using Modular Assembly?

You likely ran out of a specific block in your inventory, or an obstacle like a torch blocked placement. Walk around the structure to find the missing gap, or click the controller again with the missing materials in your inventory.

How do I know which tier of hatch a recipe requires?

Check the numerical amount of the fluid, energy, or magic resource listed in the JEI recipe, then compare it to the tooltip capacity of the different hatch tiers. Your hatch (or combination of multiple hatches) must have a capacity greater than or equal to the recipe's total cost.

Can I use multiple Small Input Buses instead of one Huge Input Bus?

Yes, as long as the multiblock structure preview allows multiple bus placements. The Machine Controller pools the inventories of all attached input buses together when checking for recipe ingredients.

Why does my machine craft the recipe in JEI, but immediately stop at 1% progress?

This happens when a continuous per-tick requirement (like RF/t, Mana/t, or required air pressure from GuGu Utils) is not being replenished fast enough. Upgrade your power cables or fluid pipes feeding the input hatches.

By combining Modular Assembly's instant construction with the cross-mod hatches and environmental mechanics of Modular Diversity and GuGu Utils, you can effortlessly build and automate the most complex custom multiblocks in any modpack.

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