Back to NxLabs

NxLabs / Vintage Story

Helve Hammer Extensions (Continued)

TBy Tirello

Allows you to forge almost all items with a helve hammer.

Helve Hammer Extensions (Continued)

Description

What this mod does

The vanilla helve hammer only knows how to forge plates and ingots. Every other smithing recipe still has to be hammered out by hand. Helve Hammer Extensions changes that: drop a started work item on a powered anvil and the helve will take over for almost any vanilla recipe.

What that means in practice:

  • Tool heads, tool parts, and resource recipes are all auto-forgeable. Every vanilla toolhead (pickaxe, axe, shovel, knife, hammer, scythe, saw, prospecting pick, and the rest) is covered.
  • An "all workable" config toggle lets the helve handle even mod-added recipes that haven't been tagged, with no per-recipe setup.
  • A configurable anvil-tier gate (iron by default) so the feature only kicks in once your smithing setup reaches the tier you choose.
  • A small per-recipe attribute that other mods can use to opt their items in or out individually.

Once your mechanical-power setup is built, the helve hammer stops being a niche curiosity for two recipes and becomes a real production tool.

 

Upgrading from the original mod

If you were running DArkHekRoMaNT's Helve Hammer Extensions, remove helvehammerext-*.zip from your Mods folder before installing this one. Both mods loaded at the same time will conflict. Your existing ModConfig/helvehammerext.json will be re-read by this fork without changes, since the config schema is unchanged.

 

Configuration

No setup required. With default settings, the mod tags every vanilla smithing recipe as helve-workable, so the helve hammer can work all of them as soon as your anvil reaches the configured tier.

Each recipe can opt in or out individually via a helvehammerworkable attribute on its output, which other mods can set on their own recipes too. AllWorkable is a global override that bypasses that per-recipe gate.

If you want to change behavior, edit <VS data dir>/ModConfig/helvehammerext.json (written on first run) and reload the world:

  • AllWorkable (default false): when true, every item is helve-workable regardless of per-recipe attributes. Use this if you want the helve to work on mod-added recipes that haven't been tagged.
  • DefaultWorkable (default true): fallback when a recipe output has no helvehammerworkable attribute set.
  • AnvilTier (default 3): minimum anvil tier required. 1 = copper, 2 = bronze, 3 = iron, 4 = steel.

 

Compatibility

Works in single-player and on dedicated servers. On a multiplayer server, both the server and connecting clients need the mod installed. No known conflicts with other smithing or anvil mods.

 

What changed versus the original mod
  • Built against Vintage Story 1.22 and .NET 10.
  • CommonLib dependency removed. Config loading now uses the native ICoreAPI.LoadModConfig API, so the mod ships as a single self-contained DLL and no longer requires CommonLib to be installed.
  • Stale config recovery: if an existing helvehammerext.json on disk fails to deserialize (for example, leftover CommonLib-shaped JSON), the mod logs a warning and resets to defaults instead of crashing on startup.
  • Vanilla JSON patches rewritten with the addmerge op. The same helvehammerworkable: true attribute is still applied to toolheads, tool parts, and resource recipes; addmerge just merges it into the existing attributes block instead of replacing the block wholesale. The original add op was harmless in earlier VS versions when most vanilla toolheads had an empty attributes block, but in 1.22 every vanilla toolhead ships with a populated one (transforms, handbook groupings, forgability flags), and an add against those would silently destroy the vanilla data. addmerge preserves it.
  • Harmony unpatch is scoped to the mod's own ID so that disposing this mod can never strip patches owned by other mods.
  • Asset folder renamed from helvehammerext/ to helvehammerextcontinued/ to match the new modid namespace. No registered blocks or items exist, so no world-save migration is needed.

 

About this fork

This is a continuation of DArkHekRoMaNT's Helve Hammer Extensions. DArkHekRoMaNT stated in April 2026 that he has paused his mods for the time being; the original Helve Hammer Extensions was last updated for Vintage Story 1.21 in September 2025. This fork picks up from there and ports the mod to 1.22. To coexist with the original on ModDB, it is published under the new modid helvehammerextcontinued.

 

Links

MIT (per the original mod).

Ratings & reviews

No ratings yet

Sign in to leave a rating or comment.