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 ❤️