Overview#
Modular Diversity is a utility addon for the Modular Machinery mod in Minecraft. Its primary purpose is to expand the capabilities of custom multiblock machines by allowing them to interact with resources and mechanics from other popular mods.
Instead of being limited to standard Forge Energy (FE) or items, Modular Diversity allows machine creators to require or produce magical energy like Mana and Ember, mechanical power like BWM Axles, or environmental conditions like specific Biomes and Dimensions. It is an essential tool for modpack developers looking to create deeply integrated progression systems.
Energy & Resource Hatches#
These hatches allow Modular Machinery multiblocks to interface with external power systems and magical energies.
Mekanism Laser Acceptor
This block allows a machine to receive energy via Mekanism Lasers. It features a massive internal buffer of 5 GJ.
- Type:
meklaser - IO-Type:
input(Output is not supported) - Syntax Example:
{ "type": "meklaser", "io-type": "input", "energy": 20000000 }
Ember Hatch (Embers Rekindled)
Interfaces with the Embers mod. It can consume or produce Ember via Emitters and Receptors.
- Type:
ember - IO-Type:
inputoroutput - Syntax Example:
{ "type": "ember", "io-type": "input", "ember": 16.0 }
Mana Hatch (Botania)
Allows machines to use or generate Mana. Input is handled via Mana Bursts (Spreaders), while output functions like a Mana Pool.
- Type: "mana"
- IO-Type: "input" or "output"
- Syntax Example:
{ "type": "mana", "io-type": "input", "mana": 500 }
Mechanical Hatch (Better With Mods)
Interfaces with BWM mechanical power. It connects to Axles and Gearboxes.
- Type:
mechanical - Level: 1 (Wooden), 2+ (Steel/Overpowered)
- Syntax Example:
{ "type": "mechanical", "io-type": "input", "level": 1 }
Laser Hatch (Buildcraft)
Allows machines to be powered by Buildcraft Lasers, similar to an Assembly Table.
- Type:
laser - Unit: micro-MJ (1,000,000 micro-MJ = 1 MJ)
- Syntax Example:
{ "type": "laser", "io-type": "input", "micro-mj": 30000000 }
Environmental Detectors#
Detectors act as recipe conditions, ensuring a machine only operates under specific world circumstances.
| Detector Type | JSON Key | Values / Description |
|---|---|---|
| Biome | biome |
Single ID or Array of Biome IDs |
| Weather | weather |
0 (Clear), 1 (Rain), 2 (Thunder) |
| Dimension | dimension |
Dimension ID (e.g., 0 for Overworld, -1 for Nether) |
| Time | time |
World time range (0-24000) |
Biome Detector Example
{
"type": "biome",
"io-type": "input",
"biome": [1, 35]
}
Weather Detector Example
{
"type": "weather",
"io-type": "input",
"weather": 2
}Specialized Integration Hatches#
Modular Diversity includes highly specific hatches for deep mod integration.
Pumpjack Hatch (Immersive Petroleum)
This hatch functions as a fluid input but draws directly from an Immersive Petroleum Reservoir in the current chunk. If no reservoir is present, the hatch remains empty.
Mineral Hatch (Immersive Engineering)
Allows a multiblock to act as an excavator, consuming resources from Immersive Engineering Mineral Deposits located in the chunk.
Aura Hatch (Nature's Aura)
Allows machines to drain or replenish the environmental Aura from the Nature's Aura mod.
Starlight Hatch (Astral Sorcery)
Interfaces with Astral Sorcery to require specific levels of Starlight for a recipe to process.
Mechanics & Configuration#
Modular Diversity does not add new mobs, biomes, or structures. Instead, it provides the logic for Modular Machinery to interact with existing ones.
Recipe Logic
- Per-Tick vs. One-Time: Resources like FE and Mechanical Power are typically consumed per-tick. Magical resources like Mana and Ember are usually consumed once at the start of the recipe.
- Detector Logic: Detectors must be satisfied for the recipe to start. If the condition (like weather) changes during processing, the machine will pause until the condition is met again.
Configuration
The mod includes a configuration file (modulardiversity.cfg) where specific integrations can be toggled. This is useful for reducing overhead if certain mods (like Botania or Embers) are not present in the modpack.