OnlyOneItem: The Ultimate Duplicate Unifier for Minecraft Modpacks
Every seasoned modpack builder knows the frustration: you open your storage system and find six different types of copper ingots, each from a different mod, none of them stacking together. Your crafting grid is a mess of incompatible recipes, and your carefully designed automation breaks because one machine expects a specific variant of a material. OnlyOneItem steps in as the elegant solution, a lightweight mod that consolidates functionally identical items and fluids into a single, unified entry. It doesn't just hide duplicates—it rewires the game's registry so that every instance of that material points to one reference, making your modpack feel coherent and your inventory manageable.
Why Duplicate Items Are a Nightmare
Modded Minecraft thrives on variety, but too much of a good thing can become a headache. When you install multiple tech or magic mods, each often adds its own version of common resources: copper, tin, silver, lead, and even fluids like oil or steam. These items are functionally identical yet exist under different registry names, meaning they won't stack, won't work interchangeably in recipes, and clog up storage drawers. A furnace might accept only one mod's copper ore, while your ore processing setup outputs another. This fragmentation forces players to juggle conversion mechanics or maintain separate stockpiles, pulling focus away from the actual gameplay.
OnlyOneItem was born from this exact pain point. The developer found themselves staring at a modpack with six distinct copper ores and decided enough was enough. The mod isn't a fork of any existing tool; it's a fresh take that intercepts item creation at a low level, redirecting duplicate registrations to a chosen target. It requires mixinbooter version 8.0 or higher, ensuring compatibility with modern Forge setups.
How OnlyOneItem Solves the Problem
At its core, OnlyOneItem acts as a registry redirector. When the game or any mod tries to create an item that matches a configured pattern, the mod silently replaces it with the designated target item. This happens early in the loading process, so by the time you open your inventory, only the unified item exists. The same logic applies to fluids, allowing you to merge "oil" from BuildCraft, Immersive Engineering, and Thermal Expansion into a single fluid that works in all machines.
The real magic is in the recipe handling. Once items are unified, all crafting recipes that used the original duplicates automatically point to the target item. The mod also scans workstation recipes (like crafting tables) and merges duplicate outputs. For example, if three mods each add a recipe for "copper block from copper ingots," OnlyOneItem combines them into one recipe that accepts any ore-dicted copper ingot. This merging happens automatically, with no extra configuration required—a massive time-saver for modpack developers.
Configuring OnlyOneItem: JSON and CraftTweaker
Flexibility is key, and OnlyOneItem offers two configuration paths. The simpler approach uses JSON files inside the /config/ooi/ folder, while more advanced users can leverage CraftTweaker scripts for dynamic, condition-based replacements. Getting the mod into your instance is straightforward; many players now turn to the foxygame.net launcher, a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, ensuring you always grab the correct version without hunting through forums. Once installed, you can start tweaking.
JSON Configuration
The JSON method is perfect for straightforward replacements. You create ooi_item.json to define item mappings, ooi_item_black_list.json to protect specific items from being replaced, and ooi_fluid.json for fluid unification. Here’s a basic item replacement example that redirects any gold ingot (by ID or ore dictionary) to the vanilla gold ingot:
- ooi_item.json:
[ { "matchItems": [ { "meta": 0, "id": "minecraft:gold_ingot" }, { "oreName": "ingotGold" } ], "targetID": "minecraft:gold_ingot", "targetMeta": 0 } ]
This particular example does nothing functional because both entries already point to the same item, but it demonstrates the syntax. The blacklist file uses a similar structure to exempt items, entire mods, or ore dictionary entries from being touched. For fluids, you can map multiple fluid names to one target, such as unifying all "water" variants.
CraftTweaker Scripts
For complex modpacks, CraftTweaker scripts offer unparalleled control. You can iterate over every ore dictionary entry, apply priority rules based on mod IDs, and handle edge cases like gems and ingots that also have block forms. The provided example script automatically picks the most preferred mod’s item (from a predefined list like minecraft, thermalfoundation, enderio, etc.) as the target for all ores, dusts, ingots, gems, nuggets, plates, gears, and sticks. It even links gem and ingot blocks to their respective items. This dynamic approach means you don’t need to manually list every duplicate—the script does the heavy lifting.
Remember that replacing items from certain mods can cause crashes if those items are used in non-standard ways. Always test thoroughly within your modpack. The CraftTweaker route is recommended for mass replacements because it can adapt to new mods and changes without constant JSON editing.
Automatic Recipe Merging and Other Key Features
Beyond item redirection, OnlyOneItem includes several standout features that make it indispensable:
- Recipe unification: After replacement, all recipes using the original items or fluids automatically use the unified target. No orphaned crafting steps.
- Duplicate workstation handling: Identical crafting table recipes from different mods are detected and merged. The inputs are converted to ore dictionary entries, so any compatible item works.
- Zero extra config for recipes: This merging happens automatically; you don’t need to write a single line of code to fix fragmented recipes.
- Fluid support: Unify liquids like oil, fuel, or molten metals that differ only by mod origin.
One caution: always test replacements, especially with mods that have unique item behaviors. A blacklist can prevent problematic items from being altered, keeping your pack stable.
Conclusion: A Breath of Fresh Air for Modpack Creators
OnlyOneItem transforms the way modpacks handle duplicate resources, turning a chaotic inventory into a streamlined experience. By redirecting items and fluids to a single reference and automatically merging recipes, it removes one of the biggest annoyances of modded Minecraft. Whether you prefer the simplicity of JSON or the power of CraftTweaker, the mod gives you the tools to enforce consistency without performance overhead. If your modpack is drowning in redundant ores and incompatible ingots, OnlyOneItem is the clean, efficient fix that lets your pack breathe—and lets players focus on building, exploring, and automating without inventory headaches.
--- **Update Sep 2, 2026:** Added 6 files for version 1.12.2 (Forge).