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