Mysterious Gem

Mysterious Gem

Roll a rarity on every piece of gear, enhance it up to +10, and socket powerful gems into weapons, armor, tools, staffs and Curios.

Mysterious Gem adds a full gear-progression system to Minecraft Forge 1.20.1. It has 13 rarity tiers, risky enhancing, gem socketing and an automated gem anvil. It is built to sit alongside big modpacks, and it works with Apotheosis, Iron's Spells 'n Spellbooks and Curios on the same items.

---

✨ Features at a glance

• 13 rarity tiers: Common → Uncommon → Rare → Super Rare → Epic → Legendary → Mythic → Artifact → Relic → Transcendent → Immortal → Divine → Cosmic. Relic has an animated rainbow name and Cosmic an animated starry name.
• Random rarity: gear rolls a rarity when you craft it, loot it from a chest or get it from a mob drop. This covers all equipment from every mod, including unbreakable staffs and Curios items.
• +LV enhancing up to +10, with a falling success chance and real risk on failure.
• Gem socketing: 1 to 5 sockets based on rarity, expandable on Mythic+ gear.
• 10 gem types with rolled abilities. Their power grows with gem rarity and gem level.
• Luck matters: every point of Luck adds +1% to all success chances and drop chances.
• Automation: the Crystal Shatter Anvil works with hoppers and runs on its own with a redstone signal.
• Configurable: most gem abilities are defined in JSON config files and can use attributes from other mods.

---

🛠 Workstations

Block	What it does
Crystal Shatter Anvil	Breaks a Raw Gem into 2–3 random gems. Salvages spare Rarity Stones into Crystal Lekis. Hopper-friendly and redstone-automated.
Enhance Table	Enhances gear and gems (+LV) using Crystal Lekis.
Gem Socket Table	Sockets gems into gear with a Gem Hammer (20 uses). Also uses Socket Expanders.
Rarity Table	Upgrades gear rarity with a Rarity Stone. Also fuses two same-tier stones into the next tier.
Gem Rarity Table	Upgrades gem rarity, or rerolls a gem's abilities with Crystal Lekis.

Getting started: kill mobs to get Raw Gems and Rarity Stones, then craft the Crystal Shatter Anvil. Salvage stones there into Crystal Lekis, and use the Lekis to craft the other tables.

---

⚔ Enhancing (+LV)

• Gear goes from +0 to +10. Success chance falls from 100% at +1 to 5% at +10.
• Gems level much higher, gaining 10 max levels per rarity tier (Common 10, Uncommon 20 … Cosmic 130). Higher-rarity gems are harder to enhance.
• Failing gear without protection: 40% chance the item becomes FAIL. It keeps its stats but cannot be enhanced or upgraded further. Otherwise it loses 1 LV.
• Failing with an LV Protection Stone: gear never becomes FAIL and has a 50% chance to lose 1 LV. Gems never lose LV.

💎 Socketing

• Socket count follows item rarity: Common has 1 socket, and Epic and above have 5.
• A gem can be at most one tier rarer than the item it goes into.
• Success chance starts at 50% and drops for rarer gems. A failed socket without a Gem Protection Stone (I / II / III) breaks the gem.
• Gem Socket Expander (craftable) adds +1 socket to Mythic+ gear, up to 3 extra. It has a 30% chance and is lost on failure.
• Pure Socket Expander (not craftable) does the same with no limit.
• Gem Unbinding Slate: used in a vanilla Smithing Table, it removes the last socketed gem and returns it to you with its level, rarity and abilities intact.

🔼 Rarity upgrades

• Upgrade chances start at 50% for Uncommon and get harder each tier, down to 0.38% for Cosmic.
• A failed upgrade only consumes the Rarity Stone. The item is safe.

---

💠 Gems

Gem	Fits in	Abilities
Overpar (red)	Weapons	2 of 5: flat damage, % damage, crit chance, lifesteal, lifesteal chance
Phokatik (cyan)	Armor	Armor, toughness, max health, knockback resistance …
Mycotic (green)	Tools	Mining speed, movement speed, luck …
Toughfiber (white)	Bows & crossbows	Extra arrow chance, projectile damage, draw speed …
Magic (purple)	Anything, incl. Curios	Spell power, max mana, mana regen, cast time, cooldown
Protection Magic / Protection I Magic	Anything	Magic resistances (Iron's Spells and addons)
Power Magic / Power Magic I	Anything	School spell power (Iron's Spells and addons)
Luck (dark green)	Anything	Luck. Rarer than other gems from Raw Gems.

• Gem power multiplies ×2.5 per rarity tier and grows +20% per gem level.
• Abilities that need another mod are skipped automatically if that mod is not installed.

---

🎲 Drops

• Any mob killed by a player has a 10% chance to drop Raw Gems and a 10% chance to drop Rarity Stones. Higher-tier stones are rarer.
• Luck increases the drop chance by +1% per point.
• Looting increases the amount: 1–3 items per drop, +1 maximum per Looting level.

---

🔗 Compatibility

• Apotheosis: works on the same item. Affixes, Apotheosis sockets and Mysterious Gem sockets all coexist.
• Curios (optional): Curios items can get a rarity, +LV and gem sockets. Their gems apply while worn.
• Iron's Spells 'n Spellbooks and many addons: staffs and wands are supported, and magic gems use their attributes.
• Every ID uses the mysteriousgem: namespace.

⚙ Configuration

Ability pools for attribute gems live in config/mysteriousgem/*.json. You can change values, add attributes from any mod and set caps.

---

Requirements: Minecraft 1.20.1, Forge 47+. Optional: Curios API.

🇹🇭 This mod's in-game text is available in English and Thai.