ZSRarity
In the vast world of Minecraft modding, the difference between a basic tool and a legendary artifact often comes down to presentation. You have spent hours crafting the perfect pack, tweaking recipes, and balancing progression, but your items all share the same bland, white name tag. ZSRarity changes that by introducing a simple yet powerful system that allows you to assign one of 16 distinct colors to any item's name, giving your players that immediate, visceral feedback of finding something truly special.
If you are a pack developer or a server admin looking to replicate the "mythic" or "legendary" item drops seen on popular multiplayer networks, this add-on is your ticket. Instead of relying on complex resource packs or manual language file edits, ZSRarity works in real-time, directly from your CraftTweaker scripts. This means you can dynamically change item rarities on the fly, creating complex effects that respond to player actions, quest completions, or even random drops.
Why Use ZSRarity Instead of Language Files?
You might be thinking, "I can just use color codes in my lang files." While that is true, ZSRarity offers several significant advantages that make it a superior choice for modern modpack development.
- Runtime Modification: Unlike static language files, ZSRarity allows you to change the color of an item's name while the game is running. This is perfect for creating items that "evolve" or have their rarity shift based on enchantments or player progression.
- Loop and Code Friendly: You can easily integrate ZSRarity calls into loops or other CraftTweaker logic. This means you can apply a specific rarity to hundreds of items with just a few lines of script, saving you hours of tedious editing.
- Universal Language Support: Because this mod does not edit language files, your colored names will work seamlessly with every language your players choose, without requiring extra translation files or manual duplication.
- Intuitive Color Names: Forget trying to remember hex codes or obscure formatting symbols. ZSRarity uses friendly names like
red,gold,dark_purple, andaqua, making it incredibly easy to understand which color your item will take without checking a wiki.
For players who love the visual sense of progression, this is a game-changer. Imagine mining a rare ore and seeing its name pop up in a shimmering gold or dark_aqua in your inventory GUI. It adds a layer of polish that makes your custom content feel integrated and intentional.
How to Install and Use ZSRarity
Learning how to install ZSRarity is straightforward. First, ensure you have the correct Minecraft version and loader. ZSRarity is designed to work with the Forge loader for Minecraft 1.12.2, which is a staple version for many tech and magic modpacks due to its stability and vast mod library. Simply place the mod jar file into your mods folder, along with CraftTweaker (and B.A.S.E. if you use ContentTweaker), and you are ready to start scripting.
Once installed, using the mod is as simple as adding a single line to your ZenScript files. For standard items, the syntax is: <modid:name>.setRarity(colorName);. For example, if you want a specific ingot to appear with a legendary purple hue, you would write: <minecraft:iron_ingot>.setRarity(dark_purple);. The case of the color name does not matter, so you can use Dark_Purple or DARK_PURPLE.
Supported Colors
The mod provides access to all 16 default Minecraft colors, ensuring you have a full palette to work with. You can choose from:
- red, blue, gold, dark_blue
- dark_purple, purple, green, dark_green
- dark_aqua, black, aqua, dark_red
- light_purple, white, yellow, gray, dark_gray
If you are looking to streamline your modpack setup, you might consider using the foxygame.net launcher, which features a one-click install system that automatically handles version compatibility for mods like ZSRarity, ensuring you spend less time troubleshooting dependencies and more time playing.
MaterialSystem and ContentTweaker Support
If you are a heavy user of ContentTweaker and the B.A.S.E. library, you might encounter a limitation. Due to how those mods handle the creation of material parts, the standard setRarity method does not work on those specific items. However, ZSRarity provides a dedicated workaround for this.
To apply rarity to items created via the MaterialSystem, you must use the special class zsrarity.MaterialPartRarity. This class has a single method: MaterialPartRarity.setRarity(MaterialPartDefinition part, string rarity). The MaterialPartDefinition is simply the result of the bracket handler <materialpart:material:part>. This ensures that even the most complex custom items can benefit from the visual flair that ZSRarity provides.
There is one minor limitation to keep in mind: changing your in-game language will not translate the names of ZSRarity-colored items into the new language. You will need to restart the game to see the translated names. This is a small price to pay for the dynamic functionality and universal language support the mod offers in all other scenarios.
For those looking to download ZSRarity, it is available on major mod repositories. When you download ZSRarity, you are not just getting a color tool; you are getting a way to communicate value and power to your players instantly. Whether you are building a skyblock pack where ore tiers matter or an RPG adventure map with epic loot, ZSRarity for Minecraft is the missing piece that ties your progression system together visually.
In conclusion, ZSRarity is a lightweight, essential utility for any modpack developer who wants to add a professional touch to their custom items. Its integration with CraftTweaker is flawless, the color system is intuitive, and the runtime capabilities open up a world of creative possibilities. Stop settling for bland item names and start giving your players the visual feedback they deserve. Furthermore, if you manage a server or a personal pack, the foxygame.net launcher offers an add-on catalog where you can manage ZSRarity alongside other mods, complete with auto-updates to keep everything running smoothly. Give your items the rarity they deserve with ZSRarity.