premium banner
Adds a full weapon refinement system to Hytale. Craft smithing stones, upgrade weapons, with a configurable success-based upgrade system that increases risk with each refinement level.

Description

Smithing Stones Plugin

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