Modular Machinery Reborn · Progression · Advanced

How to Design Modpack Progression with Tiered Multiblocks

This guide teaches modpack developers how to structure compelling, long-term progression using Modular Machinery Reborn. By leveraging tiered I/O components, structural casing upgrades, and parallel processing mechanics, you will create a dynamic factory evolution where players meaningfully upgrade existing multiblocks rather than constantly tearing them down.

What you need

  • Modular Machinery Reborn installed
  • A global datapack loader (such as Paxi or Open Loader) for loading custom machine JSONs
  • KubeJS installed for streamlined recipe scripting and dynamic modifiers
  • A code or text editor (like VS Code) to edit JSON and JavaScript files
  • JEI or EMI installed in-game to verify multiblock previews and tier limits

Step by step

  1. 1Plan Your Multiblock Progression Tiers

    Before writing any code, outline 3 to 5 clear technological eras for your modpack. Modular Machinery Reborn provides built-in component tiers ranging from Tiny, Small, and Normal up to Reinforced, Big, Huge, Ludicrous, and Ultimate. Assign these tiers to specific stages of your pack so that early-game recipes fit inside Tiny Input Buses, while late-game automation requires the massive throughput of Ultimate Hatches.

    Tip: Use JEI in-game to inspect the exact slot counts, fluid capacities, and energy buffer sizes of each default hatch tier before balancing your recipe costs.

  2. 2Define the Base Machine Structure with Tag-Based hatches

    Create your machine definition JSON file inside your global datapack's machines folder. When mapping out the block pattern around the Machine Controller, do not hardcode a specific tier like a Tiny Energy Input Hatch unless you intentionally want to cap the machine. Instead, use block tags or ingredient arrays that accept any tier of Item Input Bus, Fluid Output Hatch, or Energy Input Hatch.

    Tip: Allowing any hatch tier in the base structural JSON lets players upgrade the machine's I/O capacity in-place without breaking the multiblock formation.

  3. 3Gate Advanced Recipes via Bus and Hatch Capacities

    In your KubeJS server scripts, design early-game recipes that only require one or two unique item inputs and a modest amount of Forge Energy per tick. For mid-game recipes on the exact same machine, increase the required unique item inputs to four or five, and spike the energy consumption. Because a Tiny Item Input Bus only holds a very limited number of slots, the player will be forced to craft and install a Normal or Reinforced Item Input Bus to run the advanced recipe.

    Tip: Ensure your total recipe energy cost per tick does not exceed the transfer rate and total buffer of the target Energy Input Hatch tier.

  4. 4Implement Structural Casing Gating

    To gate progression visually and structurally, use the mod's functional structural blocks such as Machine Casing, Reinforced Machine Casing, Machine Vents, and Machine Circuitry. You can create a Tier 2 version of a machine in a new JSON file that shares the same overall shape as Tier 1, but replaces standard Machine Casings with Reinforced Machine Casings and adds a core of Machine Fireboxes. Gate the crafting recipes of these advanced casings behind the outputs of your Tier 1 multiblocks.

    Tip: Use the in-game blueprint preview in JEI to make sure your structural upgrades remain intuitive for players to build.

  5. 5Configure Parallel Processing Upgrades

    Rather than forcing players to spam dozens of identical basic machines, reward late-game progression with parallel processing. In your machine JSON or KubeJS modifier setup, define optional structural slots or specific modifier blocks—like replacing an outer Machine Casing with Machine Circuitry or a Parallel Hatch if configured. Set this modifier to multiply the machine's simultaneous recipe processing limit while proportionally scaling up energy consumption.

    Tip: Parallel processing drastically increases items and fluids consumed per operation, naturally forcing players to upgrade from Big to Huge or Ultimate buses to keep the machine fed.

  6. 6Balance Overclocking with Energy Tiers

    Add speed modifiers to your advanced multiblocks that reduce processing time at the cost of exponential energy usage. Tie these modifiers to high-tier structural blocks like Machine Vents or Advanced Circuitry. When a player installs these upgrade blocks into the multiblock frame, the sudden jump in FE/t demand will stall the machine unless they simultaneously upgrade their power infrastructure to Ludicrous or Ultimate Energy Input Hatches.

  7. 7Test and Validate in Survival Mode

    Load your pack, place down the Machine Controller, and build the Tier 1 structure using Tiny and Small components. Run a base recipe to verify it works, then attempt to insert a mid-game recipe to confirm it fails due to lack of bus slots or energy buffer. Swap the Tiny Bus for a Reinforced Bus in-place, confirm the Machine Controller immediately recognizes the new capacity, and verify that the higher-tier recipe begins processing.

    Tip: Use the /reload command after tweaking KubeJS recipe scripts to test balancing changes without restarting the entire game client.

How it works

Modular Machinery Reborn separates the physical structure validation from the recipe execution logic. When a Machine Controller forms a multiblock, it scans all attached buses and hatches and aggregates their inventory slots, fluid tanks, and energy buffers into a virtual pool. A recipe does not check which specific tier of hatch is installed; it only checks if the aggregated pool has enough distinct slots, fluid capacity, and energy per tick to satisfy the recipe's inputs.

This architecture is why hatch-gating works so smoothly. By allowing any tier of hatch in the machine's structural JSON, the multiblock stays valid regardless of whether the player uses Tiny or Ultimate components. However, when you script a recipe that demands more distinct item stacks than a Tiny Input Bus can hold, or requires more FE/t than a Small Energy Hatch can store, the recipe simply refuses to start. The player must physically upgrade the hatch block to expand the controller's virtual pool.

Parallel processing and modifier blocks hook directly into this virtual pool logic. When a modifier block (like Machine Circuitry) tells the controller to run four recipes in parallel, the controller multiplies the recipe's input, output, and energy requirements by four before checking the virtual pool. This creates an organic progression loop: unlocking parallel processing immediately bottlenecks the current hatches, pushing the player to craft the next tier of buses.

Common mistakes

  • Hardcoding specific hatch tiers in the machine JSON instead of using tags, which breaks the multiblock the moment a player tries to upgrade a Tiny bus to a Small bus.
  • Setting a recipe's FE/t requirement higher than the total internal buffer of the intended Energy Input Hatch, causing the machine to endlessly stall or fail to start.
  • Enabling high parallel processing multipliers without warning players that a small Output Bus will quickly overflow and void excess items or halt the machine.
  • Forgetting to install a dedicated datapack loader mod, resulting in custom machine JSONs failing to load into the game on world startup.

FAQ

Why do my custom machines not show up in JEI?

Modular Machinery Reborn requires an external global datapack loader (like Paxi or Open Loader) to read machine JSON files across all worlds. Ensure your JSON syntax is valid and placed in the correct data/modular_machinery_reborn/machines directory.

Can a player use multiple Tiny Input Buses instead of crafting one Normal Input Bus?

Yes, unless you restrict it in the machine pattern. To force players to upgrade hatch tiers rather than spamming cheap buses, limit the exact number of positions in your multiblock JSON where input buses are allowed to be placed.

How do I force a recipe to require a higher-tier machine casing without making a whole new machine?

You can use structural modifiers in your machine JSON. Define a core block position that accepts either a basic Machine Casing or Machine Circuitry, and attach a recipe modifier to the Circuitry block that unlocks speed or parallel capabilities needed to make late-game recipes viable.

What happens if an Output Hatch fills up during a parallel processing run?

Most properly configured KubeJS recipes will pause the Machine Controller or refuse to start the next cycle until there is sufficient space in the Output Bus or Hatch. This is why upgrading to Big, Huge, or Ultimate output components is critical for parallel setups.

By combining tag-based multiblock patterns with strategically scaled recipe requirements and structural modifiers, you can use Modular Machinery Reborn to build a seamless, rewarding progression system from Tiny components all the way to Ultimate factory automation.

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