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