Unidye
Vanilla Minecraft gives you sixteen dyes and that is it. Sixteen colors for wool, terracotta, concrete, banners, and everything else you can tint. For builders who care about palettes, that ceiling gets old fast. Unidye tears that ceiling down by letting you mix dyes together, exactly the way you would blend colors on a painter's palette. The result is a near-infinite range of custom shades that behave like real dyes across the entire game.
What Unidye Actually Does
At its core, Unidye adds a mixing system. Combine two or more dyes in a crafting grid and you get a brand new custom dye whose color is a blend of the ingredients. That custom dye is not a cosmetic gimmick. It works anywhere a vanilla dye works: dyeing wool, staining terracotta, tinting glass, crafting concrete powder, coloring banners, and even changing beacon beam colors. You can also redye blocks that already carry a custom color, and the new shade will be a mix of the old and new dyes, just like redyeing leather armor.
If you have ever wanted a muted sage green terracotta, a dusty rose concrete, or a deep teal wool that matches a specific build, this is the add-on that makes it possible. The color count is no longer finite.
Supported Versions and Loaders
Unidye is built for Fabric and targets Minecraft 1.20 through 1.21.1. If you are running a Forge or NeoForge setup, the Sinytra Connector bridge is the recommended path for compatibility. The developer has stated that native Forge and NeoForge ports are not planned for the near future, and no versions above 1.21.1 are currently on the roadmap given how frequently Mojang's new drop system pushes updates.
Getting Started with Mixing
Before you craft your first blend, the developer strongly recommends installing Polymorph. Without it, vanilla dye recipes will conflict with the custom mixing recipes. If you skip Polymorph, you simply need to add a stick to the crafting grid alongside your vanilla dyes to force the custom recipe. Once you are working with custom dyes as ingredients, the stick is no longer required, Polymorph or not.
- Crafting from vanilla dyes without Polymorph: add a stick to the recipe.
- Crafting from vanilla dyes with Polymorph: pick the custom result from the recipe selector.
- Crafting from other custom dyes: no stick needed in any setup.
How to Install
Installation follows the standard Fabric routine. Drop the Unidye jar into your mods folder alongside Fabric API, launch the game, and you are ready to start blending. If you would rather skip the manual file shuffling, the foxygame.net launcher handles the whole process for you, offering a curated add-on catalog where Unidye sits ready for one-click installation with automatic version matching. That takes the guesswork out of picking the right build for your game version.
To download Unidye for Minecraft, always grab the file that matches your exact game version, since the item data format changed between 1.20.4 and 1.20.5. Loading a mismatched build will either fail outright or produce broken colors.
Using Custom Dyes in the World
Inspect a custom dye and you will notice it displays slightly different colors depending on context. This mirrors how vanilla dyes behave, where terracotta reads more muted than concrete. The add-on respects that logic, so a custom terracotta will look appropriately desaturated compared to its concrete counterpart.
Beyond blocks, custom dyes work on pet collars, sheep wool, fireworks, and beacon beams. Made a mistake or want to start over? Right-click a water cauldron to strip the color from any custom or vanilla dyed item and get it back to default.
Command Shortcut for Exact Colors
If you want a block in a precise shade without mixing, use the give command. On Minecraft 1.20 through 1.20.4, the syntax is /give @p unidye:custom_concrete{display:{color:}} with the color value in decimals. On 1.20.5 and above, the format switches to the component style: /give @p unidye:custom_concrete[minecraft:dyed_color=].
Compatibility Notes
Mods like Dye Depot that introduce new base dyes are semi-supported for now, with fuller compatibility planned. Mods that give vanilla dyes extra uses will be handled on a case-by-case basis, since no single developer can account for every add-on in the ecosystem. If you are a mod author and want to build proper integration, the project accepts feature suggestions on GitHub.
Unidye is one of those small add-ons that quietly reshapes how you build. Sixteen colors become hundreds, and every wool farm, terracotta wall, and banner design suddenly has room to breathe. If color variety has ever limited a project, this is the mod that removes the limit.