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