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!

Need help creating, leveling, ascending, or rerolling relics?
The complete guide includes progression walkthroughs, calculators, recipes, stat tables, drop rates, configuration, and troubleshooting.

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.7+ as a dependency. It will not work without it.

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

📍 What this mod adds

With Sol's Relic System, eligible gear can gain:

• 1 Main Stat
• up to 4 Sub-Stats
• Relic Levels and Relic EXP
• Milestone upgrades every 4 levels
• Crit Rate / Crit Damage builds
• Armor set bonuses
• Aster Core progression
• Dust of Enlightenment endgame rerolls
• Phantom weapon stat-stick slots
• A full stat summary screen

This makes the mod great for:

• RPG Minecraft modpacks
• Survival progression servers
• PvE grinding and boss content
• Build-focused min-max gameplay
• Long-term equipment progression

📍What becomes a Relic?

The relic system applies to eligible combat and equipment items, including:

• swords
• axes
• pickaxes
• shovels
• hoes
• bows
• crossbows
• tridents
• many modded weapons and weapon-like tools
• armor pieces
• elytra

The mod also supports modded gear through tags, weapon checks, material checks, and naming heuristics.

If needed, server owners can block specific items or even entire mods with relic_blacklist.json.

📍How Relics work

When an eligible item gets processed by the mod, it receives relic data:

• a main stat
• randomized sub-stats
• a level
• stored relic EXP
• a deterministic upgrade seed

That last part matters: milestone outcomes are locked to the relic itself, so reloading the world does not reroll future milestone results.

📍Main Stat pools

Each relic gets 1 main stat, based on item slot:

📍Sub-Stats

Relics can have up to 4 sub-stats.

Possible sub-stats include:

• ATK
• DEF
• HP
• ATK%
• DEF%
• HP%
• Crit Rate
• Crit DMG
• Move SPD
• ATK SPD
• Jump Boost
• Luck%

Notes:

• A sub-stat cannot duplicate the main stat
• Durability% is a weapon main-stat only
• Each sub-stat roll has 4 quality tiers
• Crit sub-stats are intentionally rarer by default than most other rolls

Starting sub-stats by rarity

Higher rarity relics start stronger and have a much higher ceiling.

Max level by rarity

Relic EXP cost scales upward each level, so early upgrades are fast while endgame relics take real investment.

📍Milestone upgrades

Every 4 levels a relic reaches a milestone:

• +4
• +8
• +12
• +16
• +20
• +24

At each milestone the relic will:

• add a new sub-stat if it still has open slots, or
• upgrade one existing sub-stat if it already has 4

The mod shows this through a dedicated milestone upgrade sequence, and if you still have enough materials afterward, you can continue with Upgrade Again.

📍Aster Table

The Aster Table is the mod's main progression block.

It is also the only supported upgrade and reroll station in the current versions of the mod. When Sol's Item Rarity is installed, the Aster Table displays as Legendary rarity.

Use it to:

• awaken eligible gear into relics
• preview relic info
• level relics with Aster Cores
• reroll max-level relics with Dust of Enlightenment

Recipe:

Any item in the solsrelicsystem:aster_cores tag works in the recipe's top-center slot.

📍Aster Cores

Aster Cores are your main relic leveling currency.

Important:

• Drops only happen if the kill is credited to a player
• Aster Core mob access is controlled by aster_core_mobs.json
• The table preview only uses the number of cores needed for the shown upgrade step, not blindly the whole stack

By default, the generated Aster Core mob list includes many standard hostiles plus stronger enemies like Piglin Brutes, Elder Guardians, Withers, Ender Dragons, and Wardens.

📍Relic Rarity Ascension/Upgrades

Resonance Core

A max-level relic can be ascended by one rarity at the Aster Table.

Resonance Core I: Common to Uncommon

Resonance Core II: Uncommon to Rare

Resonance Core III: Rare to Epic

Resonance Core IV: Epic to Legendary

Resonance Core V: Legendary to Mythical

Resonance Core VI: Mythical to Supreme

Place a max-level relic and its matching Resonance Core in the Aster Table, review the Current and After comparison, and confirm the ascension.

The item's normal rarity limit still applies. Items capped at Mythical cannot become Supreme, while fixed-rarity and specially controlled relics keep their intended progression.

What Ascension Does

• Preserves the main-stat type.
• Preserves every unlocked sub-stat type.
• Never deletes or duplicates preserved stat types.
• Resets the relic to Level 0 with zero experience.
• Resets stat values to fresh base rolls for the new rarity.
• Resets previous sub-stat upgrade rolls.
• Allows the new rarity to provide additional starting sub-stats through its normal rules.

Ascended relics display Ascended I-VI and add (A1) through (A6) to their names.

How to Obtain Resonance Cores

All six Resonance Cores can be crafted through a Crafting Table progression using lower Resonance Cores and Aster Cores.

Resonance Core I and II can also drop from eligible hostile mobs killed by a player:

• Resonance Core I: 0.8%
• Resonance Core II: 0.5%

By default, eligible enemies include:

• Zombies, Husks, and Drowned
• Skeletons and Strays
• Creepers
• Spiders and Cave Spiders
• Endermen and Endermites
• Witches
• Pillagers, Vindicators, Evokers, and Ravagers
• Blazes, Ghasts, and Magma Cubes
• Silverfish
• Guardians and Elder Guardians
• Phantoms
• Shulkers
• Piglin Brutes
• Withers
• Ender Dragons
• Wardens on Minecraft versions where Wardens exist

Eligibility follows the same configurable mob list used for Aster Core drops. Server owners can add supported modded enemies or remove default enemies through aster_core_mobs.json.    

📍Dust of Enlightenment

Dust of Enlightenment is the endgame reroll item.

It can only be used on relics that are:

• Epic rarity or higher
• already at max level
• already have sub-stats

What it does:

• keeps the same sub-stat types
• rerolls the upgrade distribution and final values
• lets you compare old vs new
• lets you choose Keep New or Keep Old

Default mob drop rates:

Important:

• Dust mob drops only happen when the kill is credited to a player
• Mob-specific Dust rates are controlled by dust_of_enlightenment_mobs.json
• Existing configs are migrated only when they still use the old default values; custom player/server edits are preserved

Pity system: by default, every 5th reroll triggers pity. On pity rerolls, you can pick 2 target sub-stats, and the system guarantees extra upgrade distribution into those chosen lines.

📍Chest loot

Aster Cores and Dust can also appear in chest loot.

Dust of Enlightenment uses direct final chest chances:

Aster Cores still use the separate Aster Core chest multipliers in config.

Version note:

• 1.21.1 NeoForge includes Trial Chambers support
• Trial Chambers normal chests use the common chest category
• Trial Chambers reward tables use the rare chest category

📍Crit system

This mod adds a full Crit Rate / Crit Damage system.

Default settings:

• Base Crit Rate: 5%
• Base Crit Damage: 50%
• Max Crit Rate Cap: 100%
• Vanilla jump crits disabled by default: Yes

Crit multiplier formula:

• 50% Crit DMG = 1.0x
• 100% Crit DMG = 1.25x
• 150% Crit DMG = 1.50x
• 200% Crit DMG = 1.75x
• 250% Crit DMG = 2.00x

Crit stats come from:

• relic main stats
• relic sub-stats
• set bonuses

📍Universal damage scaling

With Universal Damage enabled, relic ATK stats can affect more than melee.

Supported damage ownership includes:

• melee hits
• arrows
• throwable projectiles
• tridents
• magic-like projectile sources
• some tamed or player-owned damage chains

This makes relic builds useful for more than just sword combat.

Material scaling and balance

Relic stats scale with the item's material tier:

Default balance caps and rules:

• Offhand stat efficiency: 50%
• Max total ATK SPD from relics: +25%
• Max total Move SPD from relics: +20%
• Jump Boost is handled as a custom jump-height bonus

📍Set bonuses

Wear matching armor to activate 2-piece and 4-piece bonuses.

Default material sets:

Extra support:

• custom item-based sets through set_bonuses.json
• automatic fallback archetypes for unknown modded armor materials
• fallback archetype pool includes: Crit Slayer, Berserker, Guardian, Swift Striker, Vitality, Balanced

📍Phantom weapon slots

Phantom slots let you use weapon relic stats without actively holding that weapon.

Features:

• Phantom Mainhand
• Phantom Offhand
• left-click to place or take a weapon
• right-click to toggle active/inactive
• active phantom weapons override the real hand's relic-stat source
• only valid weapon-type items can be placed there
• phantom items drop on death unless keepInventory is enabled

Safety behavior:

• phantom interaction can be combat-locked for a configurable number of seconds
• while a phantom hand is active, the mod blocks equipping another weapon into that same real hand
• the combat lock badge position can be configured in common config

📍Stat summary screen

Press I by default to open the Stat Summary screen.

It shows:

• total Crit Rate / Crit DMG
• offensive, defensive, and utility totals
• equipped relic overview
• active set bonuses
• phantom-slot-aware stat sources

📍Commands

Full alias also works: /solsrelic

📍Recycling

Use /srs recycle while holding a leveled relic to destroy it and get back Tier 3 Aster Cores.

Default refund:

• 60% of invested relic EXP
• output is converted into Tier 3 Aster Cores
• recycling is blocked in Creative Mode
• the mod validates the held item again before confirming the recycle, to prevent exploits

📍Configuration

The mod is highly configurable for servers and modpacks.

Main common config: solsrelicsystem-common.toml

Generated JSON configs:

Supported mob key formats:

• exact entity id: minecraft:wither
• whole namespace: modid
• specific entity UUID: uuid:1234...

Common things you can tune:

• enable or disable whole systems
• Aster Core chances and EXP values
• Dust pity threshold
• chest loot multipliers
• crit base values and crit cap
• speed caps
• offhand efficiency
• ATK / HP / DEF scaling multipliers
• set bonuses
• phantom slot combat lock
• phantom HUD badge position
• blacklist behavior
• cross-mod stat handling with Sol's Item Rarity

Multiplayer and anti-exploit safety

This mod was clearly built with server play in mind.

Notable protections include:

• deterministic milestone results
• server-side confirmation flows
• input consumption before output on upgrade and reroll flows
• Dust recovery if the reroll flow is interrupted
• recycle validation against item swaps
• phantom combat lock and equip restriction handling
• client config sync for UI consistency

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! 🎲

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! 🎲