FFItemRarityModifiers

FFItemRarityModifiers

Sometimes the sword you just crafted turns out a little special. FFItemRarityModifiers gives gear a rarity, from Common all the way up to Epic, along with small bonuses. By default there’s a small chance it occurs from crafting, but higher from looting or trading.

How it works

• Every weapon, armor piece and tool gets a rarity when you craft, fish, trade for, loot or pick it up from mobs. Most come out Common, but every so often you’ll land an Uncommon, Rare or Epic one.
• Each item can roll a few small modifiers, like extra damage, faster attacks, stronger arrows, more durability or longer reach. Common items get none; rarer items get more (and stronger) ones. No rarity gets drawbacks by default, though datapacks can add them.
• A datapack-added drawback never appears alongside its matching bonus on the same item.
• Tooltips show the rarity after the item name (“Iron Sword – Rare”) and the modifiers below it. Hold Shift for the exact numbers.
• Villager trades show the rolled item before you buy it. Higher rarities cost more.
• Bows, crossbows, fishing rods, shields, elytra and more count too, and each only rolls modifiers that suit it.

Configuration

You can adjust:

• Server config: whether trades, mob drops and loot tables roll rarities, and debug logging
• Client config: when the rarity and modifier lines show, the tooltip layout for the normal and Shift tooltips, and the good and bad modifier colors

Chances, rarity weights and the modifiers themselves are set with datapacks (see below). Operators can also use /ffitemraritymodifiers apply to give a held item a specific rarity.

Mod compatibility

• Accessory mods: their equippable items can opt in through a tag, with no hard dependency.

Version differences

FFItemRarityModifiers works the same on every supported version and loader.

For datapack makers

Datapacks control nearly everything: how often each source rolls a rarity, how likely each rarity is, what each modifier does, which items can roll, and special rules for specific mobs or loot chests. Click the Wiki link in the sidebar and open the Datapacks page for details.

For mod developers

Other mods can roll rarities for their own rewards with a single call. Click the Wiki link in the sidebar for the API guide and examples.

What’s with the FF prefix?

It stands for Fyxe’s Features! It’s a clean way to easily find all of my mods when changing configs or creating packs. Mods that are a part of the “FF” system are usually smaller and unintrusive.

Feedback

If you have any ideas for improvements, questions, or concerns, I am open to communicating through email: [email protected]