Romna's Soulforging

Romna's Soulforging

Every item tells a different story.

Soulforging infuses Hytale weapons and armor with randomised soul traits — Diablo-style.
No two items are ever the same.

A Legendary sword might roll:

• Bonus Damage
• Life Steal
• Knockback Force
• Critical Chance

While another might roll:

• Execute
• Energy per Hit
• Flat Damage
• Bonus Durability

Each item receives:

• a unique name
• randomised stats
• a color-coded tooltip

---

⚙️ How It Works

When a quality-tier item (from Romna's Quality Crafting) enters your inventory,
Soulforging automatically rolls random soul traits based on the item's tier.

Tier	Traits
🟢 Uncommon	1 trait
🔵 Rare	2 traits
🟣 Epic	3 traits + suffix name (ex: "Copper Helmet of Vitality")
🟠 Legendary	4 traits + prefix & suffix (ex: "Vampiric Copper Sword of the Storm")

Each trait slot rolls with a descending tier quality:

Legendary item example:

1️⃣ Legendary roll
2️⃣ Epic roll
3️⃣ Rare roll
4️⃣ Uncommon roll

This creates a natural power curve inside a single item.

---

✨ 22 Soul Traits

⚔️ Weapons

• Bonus Damage
• Critical Chance
• Critical Damage
• Energy per Hit
• Life Steal
• Execute (bonus damage below 30% HP)
• Knockback Force
• Flat Damage

---

🛡 Armor

• Damage Resistance
• Fire Resistance
• Poison Resistance
• Thorns
• Health Boost
• Dodge Chance
• Flat Health
• Flat Stamina
• Stamina Boost

---

👢 Boots

• Speed Boost
• Jump Height
• Feather Falling

---

🧤 Gloves

• Critical Chance
• Critical Damage
  (plus all armor traits)

---

🧩 All Gear

Bonus Durability
Permanently increases the item's maximum durability at infusion time.

---

🎨 Tier-Colored Tooltips

Every trait line in the tooltip is color-coded to its roll tier so players instantly see the power level.

Color	Tier
🟠 Orange	Legendary roll
🟣 Purple	Epic roll
🔵 Blue	Rare roll
🟢 Green	Uncommon roll

---

🔧 Fully Configurable

Soulforging generates three JSON config files that allow full customization.

config.json

Controls global behaviour:

• Enable / Disable system
• Infusion chance
• Trait slot counts
• Value caps
• Tier colors

traits_config.json

Defines min/max values per tier for every trait.

names_config.json

Word pools for generated item names:

• Prefix lists
• Suffix lists
• Add your own for infinite variety

All configs are deep-merged on update, so your changes are never overwritten when new defaults are added.

---

💬 Commands

Command	Description
/soulstats	Shows all active soul trait bonuses from equipped gear
/souldebug <player>	Admin command to inspect raw soulforge metadata

---

📦 Requirements

Romna's Quality Crafting (Recommanded but not necessary) For random quality items. So you could have a legendary crude sword with nice stats. https://www.curseforge.com/hytale/mods/romnas-quality-crafting

DynamicTooltipsLib (REQUIRED !!) Without this, you wont be able to see the stats on the item tooltips. https://www.curseforge.com/hytale/mods/dynamictooltipslib

---

Made by Romna ❤️