Unifying Your Minecraft World with UnifyTags
Anyone who has assembled a large modpack knows the frustration of ending up with five different copper ingots, three types of tin dust, and a dozen silver nuggets that refuse to stack. This item clutter not only wastes inventory space but also breaks recipe automation. The UnifyTags script steps in as a lightweight, tag-based solution that harmonizes your entire modded ecosystem without requiring a degree in computer science.
What Exactly Is UnifyTags?
UnifyTags is a KubeJS script that acts as an item unifier, similar in spirit to tools like InstantUnify or UniDict. It leverages the power of ore dictionary tags (often called tags in modern Minecraft versions) to consolidate all variants of a material into a single preferred type. Whether you are playing on Forge or Fabric, once the script is in place, you will only ever have to worry about one kind of copper ingot, one steel plate, and so on. The magic happens both in the world and inside your inventory, so dropped items, mined blocks, and even smelting outputs all conform to the same standard.
How Does the Unification Engine Work?
The core of UnifyTags sits inside a single unify.js file located in the server_scripts folder. When the server starts or reloads, KubeJS reads this configuration and begins monitoring several events. First, it intercepts item entities in the world—meaning any item that drops from a block, mob, or chest—and replaces it with the unified version based on the tag it belongs to. Second, it scans your inventory whenever you pick up an item or open a container, instantly converting any non-unified stack. Third, it hooks into recipe outputs, automatically transforming crafting results and furnace products so that you never accidentally craft the “wrong” variant. This triple-layer approach ensures consistency across the entire gameplay loop.
Key Features at a Glance
- World item unification: All dropped items, except those from certain quarry-like blocks, are unified on the spot.
- Inventory integration: Items entering your inventory through any means are silently converted to the designated tag member.
- Recipe auto-fix: Crafting and smelting recipes automatically output the unified item, removing the need for manual conversion recipes.
- JEI cleanup: The script hides duplicate materials in Just Enough Items, decluttering your recipe viewer.
- Live configuration: Edit the tag unification list in server_scripts/unify.js and reload the server to apply changes instantly—no client restart required.
Setting Up UnifyTags in Your Instance
Because UnifyTags is a KubeJS script, the first requirement is to have KubeJS installed for your Minecraft version, whether you are running Forge or Fabric. Once KubeJS is in your mods folder, you need to obtain the three script folders: server_scripts, client_scripts, and startup_scripts. These can be downloaded from the official source. Then, navigate to your .minecraft/kubejs directory and drop all three folders inside. On a dedicated server, place server_scripts on the server side, client_scripts on each player’s client, and startup_scripts on both. After a server restart or a /reload command, UnifyTags will immediately begin working. For those who prefer a streamlined setup, the foxygame.net launcher provides a modern, flexible way to manage mods and scripts, letting you install UnifyTags directly from the launcher’s menu with just a few clicks.
Configuring Tags to Match Your Modpack
The true power of UnifyTags lies in its customizability. Open the unify.js file with any text editor, and you will see a list of material tags such as forge:ingots/copper or c:silver_ingots. Each tag points to a preferred item ID. If your modpack uses Thermal Series copper ingots, you can set that as the target; if you prefer Create’s variant, simply change the string. You can add entirely new materials by appending additional tag-to-item pairs. The script also supports priority ordering, so if multiple mods add items to the same tag, UnifyTags will respect the first match it finds. Changes take effect on server reload, making iteration during pack development incredibly fast.
Why Choose UnifyTags Over Other Unifiers?
While mods like Almost Unified provide a standalone, no-dependency approach, UnifyTags thrives in environments where KubeJS is already a backbone for custom recipes and world generation. It weighs next to nothing because it is just a script, not a compiled mod. This means zero additional RAM overhead and instant compatibility with any KubeJS-supported version. Moreover, the script is open-source under a permissive license, allowing pack makers to modify, bundle, and even sell it as part of their modpacks—as long as they remain honest about its origin. If you ever run into trouble, the script’s community on Discord is active, and the developer accepts support through Ko-Fi.
Conclusion
UnifyTags eliminates one of the most persistent annoyances in modded Minecraft: item bloat from overlapping mods. By harnessing KubeJS and the tag system, it delivers seamless unification without impacting performance. Whether you are building a kitchen-sink pack or a tightly tuned expert experience, this script saves you hours of manual recipe fixing and keeps your storage systems clean. Drop the folders into your kubejs directory, tweak the config to your liking, and let UnifyTags handle the rest. Your inventory will thank you.