Sol's Item Rarity: RPG Gear, Tool Perks & Loot Tiers

A configurable Minecraft RPG rarity and loot progression mod for weapons, armor, tools, materials, collectibles, and modded items.

Give every item a sense of value. Equipment can roll permanent rarity tiers with stronger stats or utility perks, while materials and special items can receive fixed rarities based on how difficult they are to obtain.

Supported versions

• Minecraft 1.21.1 - NeoForge
• Minecraft 1.20.1 - Forge
• Minecraft 1.16.5 - Forge

Author: solmochi
RPG expansion: Sol's Relic System

Join The Community

Need help, want to suggest a feature, or found a bug?

Join the Discord for support, previews, development updates, and upcoming changelogs.

Turn Minecraft Loot Into RPG Progression

Sol's Item Rarity adds a persistent, per-item rarity system inspired by RPG loot and gear progression.

Two copies of the same item can roll different rarities, giving players a reason to inspect new equipment, hunt for upgrades, and keep especially powerful or visually rare finds.

• Seven rarity tiers from Common to Supreme
• Random rarity rolls for equipment
• Weapon and armor stat bonuses
• Dedicated utility perks for tools
• Fixed rarity for rare materials, boss drops, and collectibles
• Animated item names, borders, glow, and chroma effects
• Support for vanilla and modded items
• Server-to-client configuration synchronization

Seven Rarity Tiers

Rarity chances and multipliers are configurable. Item material also affects the default rarity pool, so high-end equipment can access rarities that basic equipment normally cannot.

RPG Weapon And Armor Bonuses

Weapons and armor receive bonuses suited to their equipment type.

• Swords and recognized weapons can gain Attack Damage and Attack Speed
• Armor can gain Armor, Toughness, and Max Health
• Boots can gain Movement Speed
• Shields can gain Knockback Resistance
• Higher rarity increases the strength of applicable bonuses
• Vanilla enchantments such as Sharpness, Protection, and Power retain their normal purpose

Supported modded weapons and armor can be detected automatically or configured manually.

Utility Tool Perks

Pickaxes, normal axes, shovels, and hoes use their own utility perk system instead of receiving inappropriate weapon damage bonuses.

Utility tools can roll multiple perks with tiers from I to V. Higher item rarity improves perk count and the chance of stronger perk tiers. Supreme items guarantee Tier V perks.

Shared Tool Perks

Break Efficiency
Increases block-breaking speed and stacks with Minecraft's Efficiency enchantment.

Durability Guard
Each time the tool would lose durability, this perk has a chance to prevent that durability loss. It works together with Unbreaking and Mending.

Pickaxe Perk: Vein Miner

Sneak while mining to break additional connected matching blocks that the pickaxe can correctly harvest, including stone, deepslate, ores, and compatible modded blocks.

Axe Perk: Timber

Sneak while chopping to break additional connected matching axe-effective blocks, including logs and compatible modded blocks.

Shovel Perk: Excavation

Sneak while digging to break additional connected matching shovel-effective blocks, including dirt, sand, gravel, clay, snow, and compatible modded blocks.

Hoe Perks

Harvest Replant
Harvests mature crops and replants them at age zero. Sneak-harvesting can affect additional nearby mature crops of the same type.

Bountiful Harvest
Gives mature crops a tier-based chance to drop bonus produce.

All connected block-breaking perks use normal Minecraft breaking behavior, including durability use, Fortune, Silk Touch, Unbreaking, drops, permissions, and tool harvest requirements.

Compatibility With Excavation Mods

Players or server owners using another vein-mining, ore-excavation, tree-felling, or area-digging mod can disable ItemRarity's connected block-breaking perks.

In solsitemrarity-common.toml:

[general]
disableConnectedToolPerks = false

Set this to true to disable only:

• Vein Miner
• Timber
• Excavation

Break Efficiency, Durability Guard, and hoe perks remain enabled.

Fixed Rarity For Materials And Collectibles

Not every rarity represents combat power.

Rare materials, boss drops, structure loot, special components, and collectibles can receive fixed rarity based on their obtainability or importance.

Fixed-rarity items receive the appropriate rarity name and visuals without automatically receiving equipment stats.

This allows the system to represent both:

• Power rarity for equipment progression
• Value rarity for difficult-to-obtain items

Built-in vanilla rarities can be extended or overridden through configuration.

Visual Rarity Effects

Make valuable items immediately recognizable.

• Rarity-colored item names
• Animated chroma text
• Inventory and hotbar slot borders
• Tooltip borders matching item rarity
• Glow, sparkle, pulse, and traveling-light effects
• Simpler static rendering modes for improved performance

Visual effects can be configured or disabled independently.

Persistent Per-Item Rolls

Rarity and utility perks are stored directly on each item.

• Two identical items can have different rarity rolls
• Rarity survives inventory movement, storage, death, and multiplayer use
• Perks are rolled during item assignment, never by hovering over a tooltip
• Existing eligible items missing current perk data are migrated automatically

Modded Item And SetID Support

Sol's Item Rarity supports custom content through item IDs and SetID data.

Server owners and modpack creators can configure:

• Modded weapons, armor, tools, and items
• Custom rarity pools
• Fixed rarities
• Custom attributes
• Utility perk weights and values
• Boss rewards and unique equipment sets

Item IDs use the standard modid:item_name format.

Multiplayer And Server Support

• Server rarity configuration synchronizes to connected players
• Utility perk values and compatibility settings are synchronized
• Item rarity and perk data persist on the item
• /sr reload reloads JSON configurations without restarting the server
• Designed for modpacks, dedicated servers, and single-player worlds

Configuration

Configuration is located in:

.minecraft/config/solsitemrarity/

Important files include:

• solsitemrarity-common.toml - general settings and compatibility options
• rarity_chances.json - random rarity pools
• custom_rarities.json - fixed rarity overrides
• rarity_attributes.json - custom item bonuses
• utility_buffs.json - utility perk pools, tier odds, and perk values
• setid_* files - custom SetID rarity and attribute rules
• _instruction.txt - included configuration guide

Commands

The full command name /solsrarity is also available.

Sol's Relic System Integration

Sol's Relic System expands combat equipment with leveling, main stats, sub-stats, critical-hit mechanics, rerolling, and set bonuses.

When both mods are installed:

• Relic stats remain focused on weapons and armor
• Utility tools keep ItemRarity utility perks
• Overlapping weapon and armor rarity stats are disabled by default
• Old relic data on utility tools is ignored and cleaned up

Sol's Relic System is optional. Sol's Item Rarity works independently.

Installation

1. Install the correct Forge or NeoForge version for your Minecraft version.
2. Download the matching Sol's Item Rarity .jar.
3. Place the file in your Minecraft mods folder.
4. Launch the game.

The internal mod ID and JAR naming remain itemrarity / sols_itemrarity, even if the CurseForge project title is expanded.

Why Use Sol's Item Rarity?

This mod is designed for players and modpacks looking for:

• Minecraft RPG loot
• Item rarity tiers
• Random gear progression
• Weapon and armor stat bonuses
• Tool perks and utility upgrades
• Vein mining, tree chopping, and excavation perks
• Rare collectible classification
• Animated rarity visuals
• Configurable modded-item support
• Multiplayer-ready RPG progression

License

All Rights Reserved. Copyright solmochi.

Sol’s Item Rarity Mod (Forge 1.16.5 & 1.20.1)

Advanced RPG Rarity System | Attribute Scaling | Fully Configurable

Author: solmochi
Recommended Addon: Sol’s Relic System

Support

Need help, want to suggest a feature, or found a bug?

Join our community to catch exclusive early previews and upcoming changelogs before they go live!

Turn Minecraft Into a True RPG Experience

Sol’s Item Rarity Mod adds a fully customizable RPG-style rarity system to Minecraft.

Every weapon, armor piece, and item can have unique rarity tiers, stat bonuses, animated visuals, and persistent attributes.

• Randomized loot progression
• Scalable item stats
• Works with ALL mods
• Fully configurable JSON system
• Multiplayer-ready (server sync supported)

Key Features

Dynamic Rarity System

• Weapons & armor roll random rarity on first use
• Items store rarity using NBT (persistent per item instance)
• Same item can have different rarities

Visual Enhancements

• Animated chroma item names
• Rarity-colored inventory & hotbar borders
• Multi-layer UI effects (glow, bevel, sparkle for high tiers)
• Tooltip borders match rarity

Attribute Scaling System

• Items gain stat bonuses based on rarity
• Fully configurable multipliers
• Auto-applies stats to all weapons & armor (including modded)

Fully Configurable

• JSON-based configs for:
  • Rarity chances
  • Fixed rarities
  • Attributes
  • Set-based items
  • Works with any mod using modid:itemname

Multiplayer Support

• Server configs auto-sync to all players
• /sr reload updates everyone instantly
• No client-side desync issues

Rarity Tiers

How It Works

Random Rarity (Weapons & Armor)

• Rolls when first held
• Stored permanently in NBT
• Higher rarity = stronger stats

Fixed Rarity (Items & Materials)

• Uses built-in + custom configs
• Ideal for rare drops, boss items, and special materials

Priority System

Rarity is assigned in this order:

1. SetID fixed rarity
2. Custom / internal fixed rarity
3. SetID rarity pool
4. Item rarity pool
5. Auto-detected weapon/armor
6. Default fallback

SetID System (Custom Loot)

Create boss drops and unique gear:

/give @p minecraft:diamond_sword{SetID:"boss_drop"} 1

Supports:

• Fixed rarity
• Custom rarity pools
• Custom attributes

Auto-Attributes

All gear automatically gains bonuses:

• Swords → Damage + Speed
• Armor → Health + Armor
• Boots → Movement Speed
• Shields → Knockback Resistance
• Works without config
• Scales with rarity

Sol’s Relic System Integration

Enhances gameplay with:

• Gear leveling
• Sub-stats
• Crit mechanics
• Set bonuses

Compatibility:

• No hard dependency required
• Automatically disables overlapping stats
• Uses reflection detection

Configuration

Located in: .minecraft/config/solsitemrarity/

Main files:

• rarity_chances.json
• custom_rarities.json
• rarity_attributes.json
• setid_* configs

Full guide included in _instruction.txt

Commands

Installation

1. Install Minecraft Forge
2. Download the mod .jar
3. Place it in /mods folder
4. Launch Minecraft

Mod Compatibility

• Works with ALL mods
• Auto-detects weapons & armor
• Supports modded items via config

Support

Join the Discord:

License

All Rights Reserved © solmochi

Final Note

If you want:

• RPG progression
• Loot rarity systems
• Scalable gear stats
• Better item visuals

This mod is built for you.