# **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!** [![Join Discord](https://img.shields.io/badge/Discord-Join_Server-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.com/invite/PzYsNxanTA) *** > _The relic and reroll system in this mod is inspired by the Artifact system from [Genshin Impact](https://genshin.hoyoverse.com/) 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](https://www.curseforge.com/minecraft/mc-mods/sols-item-rarity) 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](https://www.curseforge.com/minecraft/mc-mods/sols-item-rarity) v1.3.0+ as a dependency.** It will not work without it. ✅ **Fully Supports and recommends [Sol's Damage Indicator](https://www.curseforge.com/minecraft/mc-mods/sols-damage-indicator) v1.1.0+ as optional dependency.** (For revamped crit system support) *** ## ⚔️ Features Overview ![image](https://media.forgecdn.net/attachments/description/null/description_619fa03c-b4e8-4b79-9e50-f0f7b1f48117.png) ![image](https://media.forgecdn.net/attachments/description/null/description_3d94a42a-f105-4e5b-82e4-58f3ebd175a7.png) ### 🔮 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:** | Slot |Possible Main Stats | | ---------- |----------------------------------------------- | | Helmet |Crit DMG, Crit Rate, Luck%, ATK SPD, Move SPD | | Chestplate |DEF%, HP%, ATK% | | Leggings |ATK (Flat) | | Boots |HP (Flat) | | Weapons |ATK%, ATK SPD, Crit Rate, Crit DMG, Durability% | \- **Starting Sub-Stats by Rarity:** | Rarity |Starting Sub-Stats | | -------------------- |------------------ | | Common |0 | | Uncommon |0–1 | | Rare |1–2 | | Epic |2–3 | | Legendary / Mythical |3–4 | | Supreme |4 (max) | \- 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: ![image](https://media.forgecdn.net/attachments/description/null/description_e1d4d8ad-ab81-4a4a-8224-6049dcdeb22e.png) ![image](https://media.forgecdn.net/attachments/description/null/description_cb9a5cba-b9dd-4e74-833e-48b7eadacbd9.png) ![image](https://media.forgecdn.net/attachments/description/null/description_ef7546b7-daca-45e1-9cde-17d83ff7d69c.png) 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! \- ![image](https://media.forgecdn.net/attachments/description/null/description_e7064779-4b52-489c-aa12-8dc486947e69.png) ![image](https://media.forgecdn.net/attachments/description/null/description_3e05dc0d-86b8-49cb-8c8a-8296813ec08a.png) **Max Level by Rarity:** | Rarity |Max Level | | ----------------- |--------- | | Common / Uncommon |+4 | | Rare |+9 | | Epic |+12 | | Legendary |+16 | | Mythical |+20 | | Supreme |+24 | 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: | Tier |XP Value |Default Drop Rate | | ---------- |-------- |----------------- | | ⭐ Tier 1 |500 XP |1% | | ⭐⭐ Tier 2 |200 XP |5% | | ⭐⭐⭐ Tier 3 |80 XP |10% | | | | | 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)** ![image](https://media.forgecdn.net/attachments/description/null/description_1b46afc5-af79-41dc-872b-14603cd11a2d.png) 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: | Material |Stat Multiplier | | ----------------- |--------------- | | Wood / Leather |0.45x | | Stone / Chainmail |0.60x | | Gold |0.70x | | Iron |0.85x | | Diamond |1.00x | | Netherite |1.12x | 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. ![image](https://media.forgecdn.net/attachments/description/null/description_12581209-8f4d-4283-a015-a023d37896b9.png) **Built-In Material Sets:** | Set |2-Piece Bonus |4-Piece Bonus | | --------- |--------------------------- |------------- | | Leather |HP% |— | | Iron |DEF% |— | | Gold |Luck% |— | | Diamond |ATK% + Crit Rate |— | | Netherite |ATK% + Crit Rate + Crit DMG |✔ | | Chainmail |DEF% + Move SPD |— | | Turtle |HP% + DEF% |— | | | | | **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. ![image](https://media.forgecdn.net/attachments/description/null/description_41dce851-8232-40c5-be96-48f4171b727c.png) ![image](https://media.forgecdn.net/attachments/description/null/description_ee1ead5f-0797-4328-86ee-ed7914b71a61.png) ![image](https://media.forgecdn.net/attachments/description/null/description_c44e80b5-b58b-4f96-9b07-99c97ba256f3.png) ![image](https://media.forgecdn.net/attachments/description/null/description_4b3822ed-be7b-4875-810e-fc1a004dd5bd.png) * **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: ![image](https://media.forgecdn.net/attachments/description/null/description_a0607701-ed5f-4d62-bf64-8691ac64d5d6.png) * **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. ![image](https://media.forgecdn.net/attachments/description/null/description_8d3713de-8fc8-49c9-b4ff-a0c0e0f86a7a.png) 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: ![image](https://media.forgecdn.net/attachments/description/null/description_bf0e2e7a-b3ce-4e86-9b00-1c02c7b039d4.png) ![image](https://media.forgecdn.net/attachments/description/null/description_66c26966-b35d-4904-ad2c-e9e97fe07e92.png) * **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 | Command |Permission |Description | | -------------------------------------------------------- |------------ |--------------------------------------------- | | /solsrelic info (or /srs info) |All players |Shows detailed relic data for held item | | /solsrelic stats (or /srs stats) |All players |Shows total stats from all equipment | | /solsrelic recycle (or /srs recycle) |All players |Recycles held relic for 60% XP as Aster Cores | | /solsrelic setlevel &lt;n&gt; (or /srs setlevel) |OP (level 2) |Sets held relic's level (admin/testing) | | /solsrelic resetrelic (or /srs resetrelic) |OP (level 2) |Removes all relic data from held item | | /solsrelic reload (or /srs reload) |OP (level 2) |Hot-reloads all JSON configs | | /solsrelic help (or /srs help) |All players |Shows command help | *** ## ⚙️ 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](https://www.curseforge.com/minecraft/mc-mods/sols-item-rarity)** (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](https://www.curseforge.com/minecraft/mc-mods/sols-item-rarity)** (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](https://genshin.hoyoverse.com/)** 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](https://www.curseforge.com/minecraft/mc-mods/sols-item-rarity). *** **_Happy grinding, and may your sub-stat rolls be ever in your favor!_ 🎲**

Sol's Relic System

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details