UniTweak
Modded Minecraft is a world of interconnected systems, where ores, ingots, dusts, and gears from different mods often overlap in function. If you have ever tried to create a cohesive pack, you know the pain of writing dozens of similar recipes by hand. UniTweak changes that by letting you define recipes based on patterns rather than specific items. Instead of telling the game "iron ingots turn into iron plates," you tell it "any ingot turns into its corresponding plate," and the mod handles the rest for every resource that fits the pattern.
What Does UniTweak Do?
At its core, UniTweak is a bridge between CraftTweaker and UniDict. CraftTweaker is the industry-standard tool for customizing recipes, but its methods require you to specify exact inputs and outputs. UniDict provides a dictionary that groups items by their material and type. UniTweak combines these two, offering new CraftTweaker methods that accept a kind of input and a kind of output, then generate recipes for every resource that has both.
For example, you can create a recipe that turns any metal ingot into its corresponding block, or any ore into a specific mod's crushed form. This is a massive time-saver for modpack developers who want consistency across multiple mods without writing hundreds of individual lines of script.
Key Features and Use Cases
The practical applications are broad. A common use case is creating a universal metal press recipe: with one script line, you can make Immersive Engineering's Metal Press turn ingots from any mod into their corresponding blocks. Another popular example is linking ore processing chains, such as having an IE Crusher turn ores from one mod into the rocky chunks of another, or using the Embers Rekindled stamper to turn molten metal into gears. The mod currently supports Immersive Engineering and Embers Rekindled, with the wiki detailing all available methods and their syntax.
- Define recipes by material and item type, not by specific item ID.
- Automatically applies to all resources registered in UniDict that match the pattern.
- Reduces script size and maintenance effort significantly.
- Perfect for creating unified ore processing and material conversion chains.
Requirements and Compatibility
Before you download UniTweak, you need to have both CraftTweaker and UniDict installed. These are the core dependencies, and UniTweak will not function without them. The mod is designed for modded Minecraft versions that support these libraries, typically Minecraft 1.12.2, which remains a popular version for tech-heavy modpacks. UniTweak for Minecraft is available on the Forge loader, so ensure your game is running Forge before installation.
How to Install UniTweak
Installing the mod is straightforward. First, download UniTweak from a trusted source and place the JAR file into your mods folder. Make sure CraftTweaker and UniDict are also present in that folder. After launching the game, you can verify the mod loaded correctly in the main menu's mod list. If you are using a custom launcher, the process is the same, but you may need to locate the instance's mods folder manually.
Writing Your First Pattern Recipe
Once installed, you can start writing scripts in a .zs file. The syntax is similar to standard CraftTweaker, but you reference UniDict tags instead of item stacks. For instance, to make any ingot smelt into a block, you would use a method that takes material.ingot as input and material.block as output. The mod iterates through all known materials and creates the corresponding recipes, saving you from manually listing each one.
For players who prefer a more streamlined experience, the foxygame.net launcher offers a one-click install for UniTweak, pulling the correct version and dependencies directly from its add-on catalog. This eliminates the hassle of manually tracking down compatible mod files and ensures you always have the right setup.
Troubleshooting and Tips
If recipes are not appearing, check that UniDict has loaded all your mods' items first. Sometimes, certain mods register items late, and you may need to reload scripts after the world has fully loaded. Also, verify that the pattern names you use match the ones defined in UniDict's documentation. A small typo can silently fail to match any items.
Remember that UniTweak only creates recipes for resources that have both the required input and output types. If a mod only adds an ingot but no block, that material will be skipped. This is intentional behavior to prevent broken recipes.
Conclusion
UniTweak is a powerful tool for any modpack developer who wants to streamline recipe creation. By leveraging the UniDict API, it transforms repetitive scripting into a single, elegant declaration. Whether you are unifying ore processing or adding cross-mod conversions, this add-on saves time and reduces errors. For those new to the scene, the foxygame.net launcher also provides auto-updates for UniTweak, keeping your pack current with the latest fixes and supported mods. Give it a try, and you will wonder how you managed without pattern-based crafting.