Modular Compatibility: Materials

Modular Compatibility: Materials is a compatibility module focused on cleaning up duplicate metals, gems, ores, and other material variants across modded Minecraft packs.

Many mods add their own versions of the same materials, which can lead to several different copper plates, tin ingots, silver dusts, lead ores, raw materials, gears, rods, wires, and other overlapping items all existing at once. This module helps unify those duplicates automatically using common item and block tags.

What This Module Does

Modular Compatibility: Materials looks through material-related tags and identifies cases where multiple items or blocks represent the same material variant. When duplicates are found, the module chooses one canonical version and redirects compatible gameplay systems toward that version.

It can unify common material variants such as:

Ingots
Gems
Nuggets
Dusts
Plates
Rods
Gears
Wires
Clumps
Shards
Crystals
Coins
Raw materials
Crushed ores
Dirty dusts
Storage blocks
Ores
Ore clusters
Small dusts
Tiny dusts

How It Works

The module scans common material tags, finds duplicate entries, and selects a canonical item or block using a consistent priority system.

Once a canonical version is selected, the module can:

Hide non-canonical duplicate items from creative tabs
Hide duplicate material items from JEI when possible
Rewrite recipe inputs to use material tags instead of one specific duplicate item
Rewrite recipe outputs to produce the canonical material item
Canonicalize loot drops so duplicate materials are replaced with the chosen version
Replace duplicate material blocks in newly generated chunks with their canonical block version

Why Use This?

This module is designed for modpacks where multiple mods add overlapping materials. Instead of manually resolving every duplicate ingot, plate, dust, ore, or storage block, Modular Compatibility: Materials handles material unification automatically through tags.

The result is a cleaner inventory, less recipe confusion, and a more consistent progression experience across large modded setups.

Compatibility Notes

This module works best when mods use standard material tags for their items and blocks. The more consistently a modpack uses shared tags, the more effectively the module can unify duplicate materials.

Recipe viewer hiding is handled on a best-effort basis, while creative tab hiding, recipe unification, loot canonicalization, and newly generated block replacement are handled directly by the module.

Requirements

Minecraft: 1.21.1
Mod Loader: NeoForge
Required Dependency: Modular Compatibility: Foundation