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.

⚔️ Weapon & Armor Reforging

Craft Refinement Anvil from Workbench.

Take your equipment to a Reforge Bench and spend Refinement Globs (Refinement Glob + 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.

🔷 Socket Punching System

🔨 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

💎 Essence System

Fill your sockets with Essences to gain powerful stat bonuses! Each essence type provides unique effects based on its element and tier.

How to Craft

Essence Socket Bench — Craft at Workbench (Tier 2):

8 Iron Bars + 3 Wood

Usage

Punch Socket: Make sure a socket is punched using Socket Punch Bench
Socket Essence: Select slot to socket an essence into an empty socket at Essence Socket Bench to gain its effects
Remove/Clear Essence: Use Iron Building hammer as support to clear socketed essences

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: Select Voidheart as a support to repair broken sockets

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

✨ 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!

Hint: Recipes are obtainable throughout the world via kill or chest loots, rates are configurable via /runtimeconfig command

📜 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.

💎 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 Required

Get HyUI from CurseForge

Get Weapon-Visualization for the best experience!

🔐 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
/runtimeconfig — Mod configurations UI
/spawnequipchest — Spawns loot chest for testing chest drop rates
/spawnequipenemy — Spawns random enemy for testing npc drop rates

🔧 Fully Configurable

Everything is customizable through /runtimeconfig command

✨ 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 obtainable through drops or chest loots.
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
HyUI Support — Optional enhanced UI when HyUI mod is installed
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 /runtimeconfig command

🎮 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

🔗 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