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 mods folder
Start the server — config files generate automatically
The mod will create:
- mods/irai.mod.reforge_SocketReforge/RefinementConfig.json
- mods/irai.mod.reforge_SocketReforge/SocketConfig.json
- mods/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

Source: GitHub
Test Video: YouTube
Discord: Discord
Support:

Made by iRaiden