Almost Unified

Appearance

Getting Started ​

NOTE

This wiki is for Almost Unified for Minecraft 1.21.1 and above. For previous versions, please refer to the old wiki.

If you used Almost Unified with Minecraft 1.20 or earlier, read the What's New page first. The config format has changed completely.

Almost Unified is a mod for NeoForge and Fabric that unifies resources added by different mods. Instead of having five different silver ingots in a big modpack, every recipe will produce the same silver ingot while all recipes that consume silver ingots will still accept any of them.

Useful links:

Why Almost Unified? ​

Back in the days of Minecraft 1.12.2, mods used the Ore Dictionary to share resources such as ingots, dusts, or ores. While mods could use each other's resources in recipes, every mod still added its own variant of the same material. Big modpacks often ended up with a lot of copper ingots that didn't stack with each other. Mods like UniDict solved this by picking one dominant item for each resource and changing all recipes to output this item.

The Ore Dictionary has long been replaced by tags, but the problem remains the same. Almost Unified works in a similar fashion as UniDict did. You configure a list of tags and a list of mods ordered by priority. For each tag, the mod picks a single target item and changes recipes and other game content to use it.

Features ​

  • Recipe Unification
    Recipe inputs are converted to tags, so all variants of a resource remain usable. Recipe outputs are replaced with the target item of their tag. See How It Works.
  • Duplicate Removal
    Unification often results in identical recipes from different mods. Almost Unified detects these duplicates and only keeps a single recipe. See the Duplicates Config.
  • Loot Unification
    Loot tables can be unified so blocks, entities, and chests drop the target items. See Loot Unification.
  • World Generation Unification (NeoForge only)
    Ores of variant items can be removed from world generation, so only the target ores generate. See World Generation.
  • Recipe Viewer Integration
    Variant items are hidden in JEI, REI, and EMI. Recipes changed by Almost Unified are marked with an icon. See Recipe Viewers.
  • Flexible Configuration
    Multiple unification configs with their own mod priorities, custom placeholders, custom tags, tag substitutions, and tag inheritance. See the Configuration Overview.
  • Item Repair Support
    Tools and armor that are repaired with a unified resource also accept the target item, even if the repair ingredient of the tool only contains the variant item.
  • KubeJS Integration
    Query unification information from your scripts. See KubeJS.
  • API and Plugin System
    Mod developers can query unification information and register custom unifiers for their recipes. See the Developer Guide.
  • Reloadable
    All changes are applied when data packs are loaded. Most configs can be edited while the game is running and applied with the /reload command.

Almost Unified does not add any items, blocks, recipes, or world generation of its own. It only changes existing content of other mods.

Example ​

Imagine two mods, Mod A and Mod B, that both add a Silver Ore, a Raw Silver, and a Silver Ingot along with recipes to smelt the raw material into ingots. Both ingots are part of the c:ingots/silver tag.

Almost Unified picks one of the Silver Ingots as the target item. If mod_a is listed above mod_b in the mod_priorities of the unification config, the Silver Ingot of Mod A will be the target item. After the unification:

  • all recipes that output a Silver Ingot now output the Silver Ingot of Mod A
  • all recipes that accepted a specific Silver Ingot now accept the c:ingots/silver tag, so the Silver Ingot of Mod B can still be used if a player already has it
  • the smelting recipes of both mods are now identical, so only one of them is kept
  • the Silver Ingot of Mod B is hidden in recipe viewers

Installation ​

  1. Download the mod for your mod loader from CurseForge or Modrinth.
  2. Put the jar file into the mods folder of your instance.
  3. Start the game and load a world once. This generates the default configs in config/almostunified.

The default configs already cover common materials and tag conventions. To learn how to adjust them, head over to the Configuration Overview.

TIP

By default, Almost Unified has to be installed on both the server and the client. If you want to run it on the server only, take a look at the Startup Config.