Modular Machinery Reborn · Getting started · Beginner
Modular Machinery Reborn Getting Started Guide: Building Your First Multiblock
Modular 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.
What you need
- Modular Machinery Reborn installed alongside a global datapack loader or KubeJS (required to load machine definitions and recipes)
- 1 Machine Controller (or a machine-specific controller depending on your modpack's setup)
- 1 Machine Blueprint
- Machine Casings (Normal, Reinforced, or custom blocks specified by your pack's recipe)
- At least 1 Energy Input Hatch (Tiny, Small, Normal, Reinforced, Big, Huge, or Ludicrous tier)
- At least 1 Item Input Bus and 1 Item Output Bus (or Fluid Hatches if your chosen machine processes liquids)
- JEI or EMI installed to view multiblock layouts and recipes
Step by step
1Verify Loaded Machines in JEI
Before crafting anything, open your inventory and search for '@modular_machinery_reborn' in JEI or EMI. Because this mod is a framework toolset for modpack developers, it does not come with survival machines out of the box unless a datapack or KubeJS script is present. Look for custom Machine Blueprints or check the uses of the Machine Controller to see what structures are available in your specific modpack.
Tip: If you are building your own modpack and see no machines, you must first load the official test datapack or write a simple machine JSON or KubeJS script.
2Obtain and Preview the Blueprint
Craft or acquire the Machine Blueprint for the specific multiblock you want to build. Hold the Blueprint in your main hand and right-click in the air, or check its recipe preview tab in JEI. This opens a 3D interactive preview showing the exact block count, layer-by-layer structure, and valid block replacements.
Tip: Pay attention to blocks that flash or cycle in the preview; these represent slots where you can swap standard Machine Casings for functional Input/Output Buses and Hatches.
3Place the Machine Controller
Clear a flat workspace large enough for your structure and place the Machine Controller block down. The controller is the brain of the operation, and the entire multiblock structure builds out relative to its facing direction. Make sure the front face of the controller points toward your main walkway so you can easily access its GUI later.
Tip: If you insert a Machine Blueprint into the controller's GUI slot (or shift-right-click the controller with a blueprint, depending on your pack settings), it will project a translucent ghost-block hologram in the world to guide your block placement.
4Construct the Casing Frame
Using the hologram or JEI layer guide, start placing your Machine Casings and structural blocks around the controller. Build layer by layer from the bottom up so you do not miss any internal blocks or required air gaps. Do not fill in the entire outer wall with plain casings yet—leave a few accessible spots open for your buses and hatches.
5Install Input and Output Buses
In the spots where the blueprint allows dynamic components, place your Item Input Bus, Item Output Bus, and Energy Input Hatch. The tier you choose (such as Tiny, Small, or Reinforced) determines how many inventory slots the bus has and how much Forge Energy (FE) the hatch can hold. Place input buses where your pipes or hoppers can easily reach them, and put the Energy Input Hatch near your power cables.
Tip: Never mix up Input and Output components! An Item Input Bus will only accept ingredients, and a machine will stall if it has no valid Item Output Bus to dump the finished product.
6Verify Structure Formation
Once the final block is placed, wait a second for the controller to scan the area, then right-click the Machine Controller to open its interface. Look at the status text inside the GUI. If built correctly, the status will change from an unformed error message to indicate the structure is recognized and idle.
Tip: If it fails to form, double-check that there are no torches, snow layers, or stray cables occupying air blocks inside the multiblock's bounding box.
7Power Up and Insert Ingredients
Connect a fluxduct or energy cable from your power generation setup directly to the Energy Input Hatch. Next, right-click your Item Input Bus (or Fluid Input Hatch) and place the exact recipe ingredients inside. The Machine Controller will immediately detect the satisfied recipe requirements, draw power from the energy hatch, and begin the crafting cycle.
Tip: You can automate the entire process by connecting hoppers, pipes, or ME Interfaces directly to the Input and Output Buses—never connect them to the Machine Controller itself.
How it works
Modular Machinery Reborn operates on a decoupled architecture that separates the machine's logic from its inventory and power storage. The Machine Controller does not hold items, fluids, or energy by itself. Instead, it periodically scans surrounding blocks in a coordinate grid relative to its own direction. When the physical blocks in the world match the JSON or KubeJS definition, the controller links all attached Buses and Hatches into a single virtual network.
When a machine is formed, the controller checks the contents of all connected Input Buses against its list of valid recipes. Because buses and hatches are modular and tiered, upgrading a Tiny Item Input Bus to a Huge Item Input Bus simply expands the inventory array the controller can read from, without changing the core machine identity. During crafting, the controller drains energy from the Energy Input Hatch every tick, and once the progress timer completes, it pushes the final results directly into the linked Output Buses.
Common mistakes
- Connecting pipes or power cables to the Machine Controller: The controller only manages logic and status. You must attach your item pipes to the Item Buses, fluid pipes to Fluid Hatches, and power cables to the Energy Hatches.
- Using the wrong orientation: The multiblock pattern rotates based on the direction the Machine Controller is facing. If you build the structure rotated 90 degrees away from the controller's front face, it will never form.
- Under-tiering your Buses and Hatches: If a recipe requires 50,000 FE per tick or 4 different item types, a Tiny Energy Input Hatch or a 1-slot Tiny Item Input Bus will not hold enough to start the recipe. Always check recipe requirements in JEI and upgrade your hatch tiers accordingly.
- Installing the mod without a Datapack or KubeJS script: Standalone, Modular Machinery Reborn provides only the building blocks (casings, hatches, controllers). Without custom recipes or a modpack's datapack loader, the machines have nothing to form into.
FAQ
Why do no multiblocks show up in JEI when I install the mod by itself?
Modular Machinery Reborn is a sandbox framework designed for modpack creators. It does not include pre-made survival machines by default. To use it in a custom world, you must add a global datapack loader or KubeJS along with custom machine scripts, or download the author's test datapack.
Can I replace every Machine Casing with a Bus or Hatch?
Generally yes, as long as the modpack developer defined those slots using a modular casing tag in the machine file. However, some structural blocks (like glass, coils, or decorative frames) are strict requirements and cannot be swapped for hatches.
Why did my machine stop working mid-recipe and lose progress?
This usually happens for two reasons: either your power supply couldn't keep up with the FE/tick drain and the Energy Input Hatch ran dry, or the Item Output Bus is completely full and has nowhere to eject the finished items.
What is the difference between a Bus and a Hatch?
Following classic tech mod conventions, 'Buses' handle solid items (Item Input Bus, Item Output Bus), while 'Hatches' handle non-solid resources like liquids and power (Fluid Input Hatch, Energy Input Hatch).
By combining a Machine Controller with properly oriented casings and tiered buses and hatches, you can easily construct and automate any custom multiblock in Modular Machinery Reborn.