Smithing Stones - Weapon Refining

This mod adds a full weapon refinement system to Hytale, inspired on the smithing stones system from Elden Ring. Craft smithing stones at the Blacksmith's Anvil, upgrade weapons, with a configurable success-based upgrade system that increases risk with each refinement level.

Since version 0.4.0, DynamicTooltipsLib is used as an optional dependency to change the item's name, tooltip and quality. It is highly recommended installing it for the best experience.

Weapons can be upgraded through multiple refinement levels, each applying a configurable damage multiplier. Every tier also features its own distinct glow effect.

The mod includes a configurable success dropoff system, allowing you to control how punishing upgrades become over time. For example, with a 5% dropoff setting:

Refining to +2 has a 95% success chance
Refining to +3 has a 90% success chance
Refining to +4 has an 85% success chance
and so on.

This creates a risk–reward progression system that can be tuned to fit your server or singleplayer experience.

Since version 0.2.0, the smithing stones can also be made compatible with any custom mod weapon!

Stone Tiers

Lesser Smithing Stone: Refine weapons up to +3
Greater Smithing Stone: Refine weapons from +3 to +5
Master Smithing Stone: Refine weapons from +5 to +8
Ancient Smithing Stone: Refine weapons to +9 and +10

Configuration

config/smithing_stones_config.json:

Name	Description	Default Value
`damageMultiplierPerLevel`	Adjust the damage multiplier per refinement level	0.1
`enableRefinementGlowEffect`	Toggle the visual glow on refined weapons	true
`enableRefinementQualityOverride`	Allows refinement level to change weapon quality (only if higher than original quality)	true
`showRefinedItemBanner`	Toggle UI notification when equipping a refined weapon (auto-disabled if DynamicTooltipsLib is installed)	true
`refinementSuccessDropoff`	Percentage-based success chance dropoff per refinement level	5.0
`destroyItemOnFailure`	Determines whether the item is destroyed after failed refinement	true
`refinementFailRewardItemId`	Item ID given to the player after failed refinement (only works if `destroyItemOnFailure` is true)	Ingredient_Fabric_Scrap_Linen
`refinementFailRewardAmount`	Amount of reward item given after failed refinement	8
`customItemGroups`	List of item groups compatible with smithing stones (e.g., "WanMine" or "Keb")	["WanMine", "Keb"]
`customItemIds`	List of specific item IDs to enable refinement support	[]

Admin Commands

/refine – Increases the refinement level of the item you're currently holding by 1
/refine <level> - Applies the specified refinement level to the item you're currently holding
/refine add – Adds the item you’re currently holding to the customItemIds config
/refine remove – Removes the item you’re currently holding from the customItemIds config

Compatibility & Support

Since version 0.2.0, any custom item can be made compatible with the smithing stones using the customItemGroups and customItemIds configuration options.

Conflicts: May conflict with other mods that fundamentally overhaul the Blacksmith's Anvil UI or logic.
Bugs: Encountered a glitch? Please report any issues in the comments section!

Credits

Stone models created by the talented Robin