Description
Socket Reforge — Weapon & Armor Refinement for Hytale
Upgrade, enhance, socket, and risk it all. Socket Reforge brings a deep RPG equipment refinement system to Hytale, letting players upgrade their weapons and armor through a risk-reward reforging mechanic, punch sockets into equipment, and enhance them with powerful essences — all with configurable rates, sound effects, and custom UIs.
Latest update highlights: Hytalor-based Arcanist Bench compatibility, Spanish localization, and a fix for the unreleased hatchet secondary-click override.
The Arcanist Bench extension now patches Bench_Arcane through Hytalor instead of replacing the full asset, which helps it coexist with other mods that add their own Arcane bench categories.
⚔️ Weapon & Armor Reforging
Craft Reforge Bench from Workbench.
Take your equipment to a Reforge Bench and spend Refinement Globs (plus Refinement Glob Plus and Resonant Glob at higher tiers) to attempt upgrades up to a configurable cap (default +15). But be careful — every attempt carries risk!
Take Iron Ore to Salvage Station to get 15x Refinement Globs.
Upgrade Tiers — Weapons
| Level | Name | Damage Bonus |
|---|---|---|
| +0 | Base | — |
| +1 | ★ Sharp | +10% |
| +2 | ★★ Deadly | +15% |
| +3 | ★★★ Legendary | +25% |
Upgrade Tiers — Armor
| Level | Name | Defense Bonus |
|---|---|---|
| +0 | Base | — |
| +1 | ★ Reinforced | +5% |
| +2 | ★★ Fortified | +10% |
| +3 | ★★★ Impenetrable | +15% |
Note: Tables above show the baseline 0–3 tiers. Higher tiers, naming, and caps are fully configurable.
How It Works
Each reforge attempt rolls one of four outcomes:
- ⬆ Upgrade — Weapon gains a level
- 🎰 Jackpot — Weapon gains TWO levels!
- ➡ No Change — Nothing happens, material consumed
- ⬇ Degrade — Weapon drops a level
- 💥 Shatter — Weapon is destroyed!
Higher upgrade levels have harder odds and higher break chances, making endgame tiers rare and valuable.
Reforge Odds — Weapons
| Transition | Upgrade | Jackpot | No Change | Degrade | Break |
|---|---|---|---|---|---|
| +0 → +1 | 34% | 1% | 65% | 0% | 1% |
| +1 → +2 | 19% | 1% | 45% | 35% | 5% |
| +2 → +3 | 9.5% | 0.5% | 30% | 60% | 7.5% |
Reforge Odds — Armor
| Transition | Upgrade | Jackpot | No Change | Degrade | Break |
|---|---|---|---|---|---|
| +0 → +1 | 34% | 1% | 50% | 0% | 10% |
| +1 → +2 | 19% | 1% | 45% | 25% | 5% |
| +2 → +3 | 9.5% | 0.5% | 40% | 40% | 2% |
Note: Odds tables above cover early tiers; higher-tier weights are configurable.
*All rates are fully configurable via JSON config files!*
*Refinement support: Tool_Hammer_Iron reduces break chance (5% durability per use). Tool_Hammer_Thorium reduces break chance further (15% durability per use). Both are consumed at 0 durability.
🔷 Socket Punching System
Use a Socket Punch Bench to punch sockets into your equipment! Sockets can be filled with powerful essences to gain additional stat bonuses. Inspired by Path of Exile's socket system.
How Socket Punching Works
- Place your equipment (weapon or armor) in the bench
- Add a Socket Puncher material (required)
- Optionally add a Socket Stabilizer to reduce break chance
- Click to punch — success adds a socket, failure may destroy the item!
Socket Limits
| Equipment Type | Max Sockets |
|---|---|
| Weapons | 4 |
| Armor | 4 |
How to Craft
Socket Punch Bench — Craft at Workbench (Tier 2):
- 8 Iron Bars + 3 Emeralds
Socket Puncher — Craft at Salvage Bench:
- 1 Iron Bar → 15 Socket Punchers
Socket Stabilizer — Craft at Alchemy Bench (Tier 1):
- 15 Socket Punchers + 1 Emerald Gem
- Provides +15% success chance and -5% break chance
*Bonus 5th socket: 1% chance when punching the 4th socket!*
Socket Punching Odds
| Socket # | Success Chance | Break Chance |
|---|---|---|
| 1st Socket | 90% | 2% |
| 2nd Socket | 75% | 5% |
| 3rd Socket | 55% | 10% |
| 4th Socket | 35% | 18% |
*Each additional socket is harder to obtain with higher risk!*
💎 Essence System
Fill your sockets with Essences to gain powerful stat bonuses! Each essence type provides unique effects based on its element and tier.
Essence Types
| Type | Theme | Primary Effects |
|---|---|---|
| 🔥 Fire | Burns with intense heat | Damage, Fire Damage |
| ❄️ Ice | Glows with frost | Cold Damage, Slow Effect |
| ⚡ Lightning | Crackles with energy | Attack Speed, Crit Chance, Evasion (Armor) |
| 💚 Life | Pulses with vitality | Health, Life Steal |
| 🌑 Void | Shimmers with darkness | Crit Damage |
| 💧 Water | Flows with clarity | Damage (Weapon), Regeneration (Armor) |
Essence Tiers
Essences gain power based on consecutive count of the same type. For example: Life, Life, Life, Fire = Tier 3 Life, Tier 1 Fire. Higher tiers provide stronger effects!
| Essence Type | Tier 1 | Tier 3 | Tier 5 |
|---|---|---|---|
| Fire | +2% Damage, +3 Flat DMG | +6% Damage, +8 Flat DMG | +12% Damage, +15 Flat DMG |
| Ice | +2% Slow, +2 Cold DMG | +5% Slow, +6 Cold DMG | +5% Freeze, +12 Cold DMG |
| Lightning | Weapon: +3% ATK Speed, +2% Crit Armor: +1% Evasion |
Weapon: +7% ATK Speed, +4% Crit Armor: +3% Evasion |
Weapon: +15% ATK Speed, +8% Crit Armor: +5% Evasion |
| Life (Weapon) | +2% Lifesteal | +5% Lifesteal | +10% Lifesteal |
| Life (Armor) | +10 HP | +25 HP | +50 HP |
| Void | +5% Crit DMG | +12% Crit DMG | +25% Crit DMG |
| Water (Armor) | +1 Regeneration | +3 Regeneration | +5 Regeneration |
Available Stats
Essences can provide bonuses to the following stats:
- Offensive: Attack Speed, Damage, Crit Chance, Crit Damage
- Defensive: Health, Defense, Evasion
- Utility: Life Steal, Movement Speed, Luck
- Elemental: Cold Damage, Slow Effect, Fire Damage, Lightning Damage
Greater Essences
In addition to regular essences, Greater (Concentrated) Essences are available with enhanced power:
- Stronger stat bonuses than regular essences
- Available for all 6 essence types
- Craftable through the Essence Socket Bench
How to Craft
Essence Socket Bench — Craft at Workbench (Tier 2):
- 8 Iron Bars + 3 Wood
Essence Management
- Socket Essence: Place an essence into an empty socket at Essence Socket Bench to gain its effects
- Remove/Clear Essence: Use Tool_Hammer_Iron as support to clear socketed essences
- Clear Roll: On failure, durability is still reduced and a random socket can break
- Hammer Wear: Clearing uses 10% hammer durability per process and consumes the hammer at 0 durability
- Repair Broken Sockets: Use Voidheart to repair broken sockets
📜 Lore System (Spirits & Lore Sockets)
The Lore System adds spirit-bound abilities that can proc in combat when your weapon is aligned with the right gem and lore socket colors.
Core Loop
- Punch a lore socket: Use Ghastly Essence in the Socket Punch bench to add a lore socket to eligible equipment.
- Socket a Spirit gem: Use the Lore Socket bench to place a Spirit gem into that lore socket (the gem defines the socket color).
- Bind the Spirit: Defeat an NPC bound to that Spirit while holding the gem-matched weapon — the first eligible kill binds the Spirit and unlocks its proc.
- Grow the lore: Lore abilities gain XP each time they proc. Feed Resonant Essence at each feed threshold to keep leveling.
Binding & Proc Rules
- First kill binds: Binding only happens on the first eligible kill while the matching gem is socketed.
- Spirit selection: If the NPC is a known Spirit, that Spirit binds. Otherwise a Spirit is selected from the configured pool for that gem color.
- Color gates: Socket color must match the gem’s color. Use Resonant Essence to reroll lore socket colors if needed.
- Leveling: Each proc grants XP; leveling and feed costs scale from config.
Configuration Files
- LoreConfig.json — lore socket drop chances, min/max sockets, XP per proc, feed interval/cost, and feed/clear item IDs.
- LoreMappingConfig.json — gem color matches (e.g., rock_gem_*), spirit pools per color, core colors, and ability mappings.
Tip: Match your lore socket colors to the spirit’s gem alignment to enable its combat procs.
✨ Resonance System
Unlock powerful hidden effects by socketting specific essence combinations! The Resonance System is inspired by runewords — certain essence orders trigger unique bonuses that aren't available from individual essences alone.
How Resonance Works
- Fill All Sockets: Resonance only activates when every socket on your equipment contains an essence
- Order Matters: The sequence of essences determines which resonance effect you get
- Quality Tiers: Higher socket counts can unlock rarer resonance qualities
- Free Power: Once discovered, resonance effects require no extra materials!
- Multiple Weapons: Works with swords, daggers, bows, crossbows, and more!
Discover Hidden Combinations
There are many resonance effects waiting to be discovered across different socket counts and weapon types:
- On-Crit Effects: Some resonances trigger powerful effects when you land a critical hit
- On-Hit Effects: Certain combinations cause effects on every hit
- Chain Effects: Some resonances chain damage to nearby enemies
- Defensive Bonuses: Thorns, dodge, and shield effects
- Execute Mechanics: Deal extra damage to low-health enemies
- Aura Effects: Burn enemies around you
- Survival: Chance to cheat death or surge heal
- Elemental: Lightning strikes, frost novas, and more
Example: A sword with Fire + Lightning + Life essences creates "Kingsbrand" — granting +8% Damage, +6% Crit Chance, +2% Lifesteal, and a chance to call lightning strikes on hit!
Hint: Try different essence orders with 3, 4, and 5 sockets! Experiment with different combinations — share your discoveries with the community!
💎 Socket Loot System
Socketed equipment can now be found throughout the game world! No need to punch sockets yourself — find them as loot!
Loot Sources
- Enemy Drops — Defeated NPCs have a chance to drop equipment with sockets
- Treasure Chests — Found chests may contain socketed gear as rewards
Loot Rarity
- Higher socket counts are rarer to find
- Essence-filled sockets are more valuable
- All looted equipment have broken sockets that can be repaired in order to be used
Explore the world to find the best socketed equipment!
🛠️ HyUI Integration
Socket Reforge now supports HyUI for enhanced user interfaces! When HyUI is installed, players get access to improved, responsive UI elements for all reforging and socketing operations.
- Optional Dependency — Works with or without HyUI installed
- Enhanced Equipment List — Improved equipment selection with real-time filtering
- Better Socket Previews — Visual socket state display with progress tracking
- Improved Event Handling — No more UI freezes or client locks
Get HyUI from CurseForge for the best experience!
🔨 Socket Management Tools
New tools for managing your socketed equipment!
Iron Building Hammer
Manage socketed essences from your equipment with Iron Building Hammer:
- Clears socketed essences without deleting the socket layout
- Useful for re-configuring your build
- Failure can break a random socket
- Hammer durability is consumed on each clear process
❤️ Regeneration & Enhanced Effects
Essences now provide additional benefits beyond combat stats!
Regeneration System
- Life Essence Armor — Provides Max HP increase
- Water Essence — Grants natural regeneration benefits
- Stack multiple Life essences for increased regen rates
Extended Tier 5 Effects
Tier 5 essences now have enhanced effects on both weapons AND armor:
| Essence | Weapon T5 Effect | Armor T5 Effect |
|---|---|---|
| Fire | +12% Damage, +15 Fire DMG | +15% Fire DMG, Fire Reflection |
| Ice | +5% Freeze, +12 Cold DMG | +5% Freeze, +12 Cold DMG |
| Life | +10% Lifesteal | +50 HP, +5 HP/sec Regen |
| Void | +25% Crit Damage + Blood Pact (HP sacrifice adds bonus damage) | +25% Crit Damage |
| Water | N/A (weapons) | Regeneration bonus |
Armor identity prefixes at Tier 5: Fire armor uses Infernal prefix and Ice armor uses Glacial prefix.
🔐 Server Commands (OP Only)
/socketpunch— Open Socket Punch bench UI directly/essence— Open Essence Socket bench UI directly/rfadmin refine <0-max>— Set held item refinement level/rfadmin sockets <current> [max]— Set held item sockets/rfadmin addmax <amount>— Increase held item max sockets
🔧 Fully Configurable
Everything is customizable through auto-generated JSON config files:
RefinementConfig.json
- Maximum refinement level and tier thresholds
- Tiered refinement materials (glob / glob plus / resonant glob)
- Per-level prefix/suffix labels (weapon + armor)
- Damage multipliers per weapon upgrade level
- Defense multipliers per armor upgrade level
- Break chances for weapons and armor
- Reforge outcome weights (degrade/same/upgrade/jackpot) for each level
SocketConfig.json
- Maximum sockets for weapons and armor
- Socket punch success chances per socket count
- Socket punch break chances per socket count
- Essence clear/removal success chance behavior
SFXConfig.json
- Sound effects for every reforge event (start, success, jackpot, fail, no change, shatter)
- Valid reforge bench block IDs
📦 Installation
Install the Mod
- Copy the mod JAR to your Hytale server's
modsfolder - Start the server — config files generate automatically
- The mod will create:
mods/irai.mod.reforge_SocketReforge/RefinementConfig.jsonmods/irai.mod.reforge_SocketReforge/SocketConfig.jsonmods/irai.mod.reforge_SocketReforge/SFXConfig.json
✨ Features at a Glance
- Risk-reward reforging with configurable outcomes + shatter for both weapons and armor
- Scalable upgrade tiers (default +15) with configurable names/labels
- Socket punching system — add up to 4-5 sockets to weapons and armor
- 6 essence types (Fire, Ice, Lightning, Life, Void, Water) with tier-based effects
- Greater Essences — Concentrated higher-tier essence variants
- Consecutive tier system — stack same-type essences for higher bonuses
- Resonance System — discover hidden runeword-like effects by finding specific essence combinations
- Socket Loot System — enemies and chests can now drop socketed equipment!
- Average Damage Tooltips — see true weapon damage output in tooltips
- Extended T5 effects — includes Void Blood Pact bonus-damage behavior and armor prefixes
- Regeneration system — Life and Water essences grant HP regen on armor
- Iron Building Hammer support — used in both Essence and Reforge benches with durability wear
- DynamicTooltips compatibility — socket and essence info displayed as in-game tooltips
(Requires DynamicTooltipsLib) - HyUI Support — Optional enhanced UI when HyUI mod is installed
- HyUI fallback safety — bench interactions remain usable if HyUI is unavailable
- ECS damage & defense system that applies multipliers in real-time combat
- Bench preview UIs with detailed refinement/socket outcome information
- Socket Punching UI for adding sockets with risk/reward mechanics
- Essence Socketing UI for managing socketed essences
- Configurable sound effects for every reforge event
- Smart item detection via item ID, categories, and structure checks
- Metadata-based refinement — no item duplication or patching required
- Fully configurable rates, weights, multipliers, and sounds via JSON
🎮 For Server Operators
Socket Reforge is designed to be drop-in and configurable. Default values provide a balanced experience out of the box, but every rate can be tuned:
- Want easier upgrades? Increase upgrade weights and lower break chances
- Want a hardcore experience? Crank up degrade and shatter rates
- Want easier socketing? Increase success chances and reduce break rates
- Custom weapons? Just follow the categorization Category: Items.Weapon
🗺️ Roadmap
Here's what's planned for future updates:
| Feature | Description | Status |
|---|---|---|
| Refinement | Weapons and Armor upgrade system | ✅ Available |
| Socket Punching | Add sockets to equipment for essence insertion | ✅ Available |
| Essence Socketing | Socket essences for stat bonuses (Fire, Ice, Lightning, Life, Void, Water) | ✅ Available |
| Supporting Materials | Additional materials for socket punching bonuses | ✅ Available |
| Essence Crafting | Craft and upgrade essences | ✅ Available |
| Lore System | Spirit gems, lore sockets, and combat abilities tied to wild spirits | ✅ Available |
| Gem Socketing | Craft and upgrade essences | ✅ Available |
🔗 Links
Found any bugs? please post it here: https://legacy.curseforge.com/hytale/mods/socket-reforge/settings/issues
Made by iRaiden