Sol's Relic System x Item Rarity

Transform every weapon and armor piece into an RPG relic with randomized stats, leveling, sub-stat upgrades, crit mechanics, set bonuses, and more. This mod introduces a stat-based crit system that replaces Minecraft's vanilla simple jump-crit.

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!

The relic and reroll system in this mod is inspired by the Artifact system from Genshin Impact by HoYoverse. All credit and respect to the original game for the brilliant design that served as the foundation for this mod's mechanics — including stat rolling, milestone upgrades, deterministic seeds, the leveling preview UI, the sub-stat reroll slot machine animation, and the stat summary screen.

📖 What Is This Mod?

Sol's Relic System x Item Rarity is an expansion of Sol's Item Rarity Mod that turns Minecraft's equipment into a full-blown RPG artifact system. Every weapon and armor piece that enters your inventory becomes a Relic — a piece of equipment with randomized main stats, up to 4 sub-stats, an XP-based leveling system, crit mechanics, armor set bonuses, and much more.

If you've ever played Genshin Impact and wished Minecraft had the same kind of artifact grinding, stat optimization, and upgrade excitement — this is the mod for you.

⚠️ This mod REQUIRES Sol's Item Rarity Mod v1.3.0+ as a dependency. It will not work without it.

✅ Fully Supports and recommends Sol's Damage Indicator v1.1.0+ as optional dependency. (For revamped crit system support)

⚔️ Features Overview

🔮 Relic Stats — Main Stats & Sub-Stats

Every piece of equipment is automatically assigned relic data when it enters a player's inventory. Each relic receives:

• 1 Main Stat — randomly rolled from a slot-specific pool
• Up to 4 Sub-Stats — randomly rolled from the full stat pool (excluding the main stat)

Main Stat Pools by Equipment Slot:

-

Starting Sub-Stats by Rarity:

-

Higher rarity items start with more sub-stats, giving them a massive head start. But even a lower-rarity relic can gain sub-stats through leveling!

Each sub-stat roll has 4 quality tiers (similar to Genshin Impact), meaning even two relics with the same sub-stats can have vastly different power levels depending on roll quality.

⬆️ **Leveling System — Aster Cores & Anvil Upgrades

**

Relics gain XP and level up using Aster Cores — special items that drop from hostile mobs. To upgrade a relic:

1. Place your relic in the first anvil slot
2. Place Aster Cores in the second anvil slot
3. A confirmation overlay shows you the upgrade preview (level change, stat increase, core cost)
4. Click Yes to confirm — cores are consumed and your relic levels up!

-

Max Level by Rarity:

XP cost scales quadratically — early levels are cheap, but pushing to max level requires serious investment.

🌟 Aster Core Items (Leveling Currency)

Three tiers of Aster Cores drop from hostile mobs:

Higher tier cores are rarer but provide significantly more XP. The game checks for the highest tier first when rolling drops. All drop rates and mob sources are fully configurable.

🎯 Milestone Sub-Stat Upgrades (Every 4 Levels)

Every 4 levels (+4, +8, +12, +16, +20, +24), your relic hits a milestone that either:

• Adds a new sub-stat (if you have fewer than 4), or
• Upgrades a random existing sub-stat (if you already have 4)

This milestone system plays a Genshin Impact-style step-by-step animation showing each level gained leading up to the milestone, culminating in a golden flash when the sub-stat upgrade occurs.

Anti-Save-Scum: Each relic has a unique deterministic seed. All future upgrades are pre-determined from the moment the relic is created. Reloading your save will always produce the same results.

After a milestone animation, if you have more Aster Cores available, an "Upgrade Again" button appears so you can immediately continue upgrading without re-placing items in the anvil.

✨ Custom Crit System

This mod introduces a stat-based crit system that replaces Minecraft's vanilla jump-crit:

• Base Crit Rate: 5% (configurable)
• Base Crit DMG: 50% (configurable)
• Max Crit Rate: 100% (configurable)
• Crit Rate and Crit DMG stats from relics, main stats, and set bonuses all contribute
• Vanilla jump-crits are disabled by default (configurable)

Crit Damage Multiplier Scaling:

• 50% Crit DMG = 1.0x damage (baseline)
• 100% Crit DMG = 1.25x damage
• 150% Crit DMG = 1.50x damage
• 200% Crit DMG = 2.0x damage
• 250% Crit DMG = 2.5x damage

The scaling is piecewise — slow ramp from 50–150%, faster ramp above 150% — rewarding heavy investment into crit builds.

🌍 Universal Damage Handler

ATK and ATK% stats apply to ALL player damage sources, not just melee:

• Magic damage
• Projectile damage (arrows, tridents)
• Summon/pet damage
• Any damage originating from the player

The mod traces the true player owner through projectile chains and entity ownership. Configurable efficiency multipliers balance this across damage types.

🛡️ Material Tier Scaling

Relic stat effectiveness scales with the item's material tier, ensuring balanced progression:

This prevents low-tier items from out-scaling higher-tier equipment through relic stats alone. Modded items are auto-detected.

Offhand weapons receive an additional 0.5x multiplier (configurable) to prevent dual-wielding from being overpowered.

🏅 Set Bonuses

Wearing matching armor pieces activates Set Bonuses — passive stat boosts similar to artifact set effects in Genshin Impact.

Built-In Material Sets:

Custom Sets can also be defined via JSON config, allowing server owners to create unique set bonuses for specific item combinations.

Modded armor that doesn't match known materials is auto-assigned to one of 6 archetypes: Crit Slayer, Berserker, Guardian, Swift Striker, Vitality, or Balanced.

💎 Dust of Enlightenment — Sub-Stat Reroll

An ultra-rare Supreme-rarity consumable item that lets you reroll all sub-stat upgrade allocations on a max-level relic.

• Drop Rate: 0.1% from hostile mobs (configurable)
• Can only be used on max-level relics
• Used in the anvil (relic + Dust)

Reroll Flow:

1. Place max-level relic + Dust in the anvil → Confirmation overlay appears
2. Click Yes → Dust is consumed → A slot machine animation plays (each sub-stat cycles through random values and locks in one by one with sound effects)
3. A side-by-side comparison of your old vs new sub-stats is displayed
4. Choose Keep New or Keep Previous — you're never forced to accept a bad reroll!

Pity System: Every N rerolls (default: 5), you get guaranteed bonus upgrade points on 2 sub-stats of your choice. This ensures dedicated players are always making progress.

👻 Phantom Weapon Slots

Two invisible extra weapon slots (mainhand + offhand) that overlay your inventory screen:

• Left-click to place, retrieve, or swap weapons
• Right-click to toggle a slot active/inactive
• When active, the phantom slot's relic stats override your equipped item's stats for that hand
• Only weapons can be placed in phantom slots (swords, axes, tools, bows, crossbows, tridents)
• Items drop on death (respects keepInventory gamerule)

This allows players to have a "stat stick" weapon whose relic bonuses apply without actually holding it in their hand.

♻️ Relic Recycling

Don't want a relic anymore? Use /solsrelic recycle (or /srs recycle) to destroy the relic you're holding and receive 60% of its invested XP back as Tier 3 Aster Cores.

A confirmation overlay shows your relic's full stats, a destruction warning, and the exact number of cores you'll receive before you commit.

📋 Stat Summary Screen

Press [I] (configurable keybinding) to open a comprehensive stat summary screen:

• Left column: Full stat breakdown table showing Base | Relic | Set | Total for all stat categories (Crit, Offensive, Defensive, Utility)
• Right column: Equipped relics list with rarity colors and main stat preview, plus active set bonuses showing 2-piece and 4-piece status
• Scrollable with mouse wheel

🎨 Rich Tooltips & Visual Polish

• Colorful relic tooltips with unique colors per stat type, separators, and XP progress bars
• Sub-stat upgrade dot indicators showing how many times each sub-stat has been upgraded
• Flash animation for recently upgraded stats
• Rarity-colored level prefix in item names (e.g., "+15 Diamond Sword")
• Set bonus section in tooltips with text wrapping

💬 Commands

⚙️ Configuration

This mod is fully configurable for server owners:

Forge Config (TOML)

• Toggle any feature on/off (crit system, set bonuses, universal damage, recycling, etc.)
• Adjust all drop rates, XP values, and balance multipliers
• Configure base crit rate/damage, max crit rate
• Set stat scaling multipliers for HP, DEF, ATK
• Offhand efficiency multiplier
• Max ATK SPD and Move SPD caps

JSON Configs (Hot-Reloadable with /srs reload)

• set_bonuses.json — Define custom armor set bonuses with specific item combinations
• aster_core_mobs.json — Whitelist/blacklist which mobs drop Aster Cores
• dust_of_enlightenment_mobs.json — Whitelist/blacklist which mobs drop Dust of Enlightenment
• relic_blacklist.json — Exclude specific items or entire mods from the relic system

All JSON configs support versioned migration with automatic backups when the format changes.

🔗 Cross-Mod Compatibility

• Sol's Item Rarity Mod (REQUIRED) — Provides the rarity tiers that determine max levels, starting sub-stats, and visual styling.
• Sol's Damage Indicator (Optional) — When installed alongside this mod, crit hit information is shared for enhanced damage number display.
• Config option to disable Item Rarity Mod's own stat bonuses to prevent double-dipping.

📦 Installation

1. Install Minecraft Forge for 1.16.5 / 1.20.1
2. Download and install Sol's Item Rarity Mod (v1.2.0 or higher)
3. Download Sol's Relic System x Item Rarity and place the .jar in your mods folder
4. Launch the game — configs will auto-generate on first run

Credits & Acknowledgments

• Mod Author: solmochi
• Inspiration: The relic/artifact stat system, sub-stat upgrade milestones, deterministic reroll seeds, slot machine reroll animation, and stat summary screen are all heavily inspired by the Artifact system from Genshin Impact by HoYoverse. Huge thanks and all credit to the brilliant designers at HoYoverse for creating the system that made this mod possible.
• Base Mod: This mod is a branch/expansion of Sol's Item Rarity Mod.

Happy grinding, and may your sub-stat rolls be ever in your favor! 🎲