Fletchers Forge

Disassemble vanilla arrows into shafts and arrowheads, craft components at vanilla stations, and reforge ammunition in the field with the Fletcher's knife.

Current version: 0.1.30
Requires: BepInEx + Jötunn

What this mod does

There is no material salvage beyond shafts and heads (no wood/ore back from splitting).

Quick start

1. Install BepInEx and Jötunn (see Dependencies).
2. Install Fletchers Forge into BepInEx/plugins/Hardwire99-FletchersForge/.
3. Craft a Fletcher's knife at the Forge (level 1).
4. Hold the knife in your hand — the Fletcher's bench opens automatically.
5. Use Reforge or Split (buttons or keys below). Results go directly into your inventory — there is no take-all step.

Fletcher's knife

Arrow components

Shafts (inventory stack 100)

World drop: small arrow-shaft mesh (not the cargo crate).

Arrowheads (inventory stack 200)

Craft output is always 20 per recipe batch.

World drop: small cargo crate mesh (25% scale) — a square ship crate, not a chest with a lid.

Arrowhead inventory icons (embedded PNG)

Arrowhead icons ship inside FletchersForge.dll — players do not need an Icons folder in their profile.

Optional overrides: set AllowExternalHeadIconOverrides = true in config, then place PNGs in:

BepInEx/plugins/Hardwire99-FletchersForge/Icons/

Recommended: 128×128 PNG, transparent background. Restart after adding external overrides.

Icon gallery (bundled examples)

Fire	Flint	Bronze
Iron	Silver	Obsidian
Poison	Frost	Needle
Carapace	Charred

Field bench (Fletcher's bench)

Opens automatically when the Fletcher's knife is in your hand (same as holding it ready to use).

Slots

Actions

Results are added to your inventory immediately. You do not use Take all / Place stacks — those vanilla container actions are not part of this workflow.

The wood panel shows Reforge and Split in the usual container button row (repurposed from vanilla UI chrome).

Vanilla arrow mapping

Configuration

File: BepInEx/config/hardwire99.fletchersforge.cfg

There is no key to open the bench — it opens when the knife is in your hand.

After editing the config, restart Valheim (or reload the profile).

Bjornheim / legacy save cleanup

Early builds (0.1.1–0.1.8) spawned phantom bench objects in the world save. That can cause ChestSnap errors and hundreds of unknown ZDOs (hash 555343901).

0.1.30 runs cleanup after ZDOs load (ZDOMan.Load), on player spawn, and via fletcher.cleanup. It also sanitizes null ChestSnap network views so phantom benches from early builds no longer spam errors.

Manual cleanup (recommended once on affected saves)

1. Load the world (as host / single-player).
2. Open the console (F5).
3. Run: fletcher.cleanup
4. Run: save
5. Restart the game and confirm ChestSnap no longer spams errors.

Multiplayer notes

• Field bench uses a local inventory (not a world container) — each player reforges their own items.
• Knife equip / bench UI runs only for the local player (IsOwner()).
• Legacy ZDO cleanup runs on the server when purging save data; clients still sanitize null network views for ChestSnap.
• Not yet playtested on dedicated servers; code paths are local-player scoped and should be safe, but verify with your group.

Folder layout (plugin)

Hardwire99-FletchersForge/
  FletchersForge.dll    (includes embedded arrowhead PNG icons)
  manifest.json
  Icons/                (optional — only if AllowExternalHeadIconOverrides = true)

Known / upcoming

• [ ] Quiver and Unity Store weapon assets
• [ ] Dedicated multiplayer playtest

Credits

• Author: Hardwire99
• Framework: Jötunn / Valheim modding community

Changelog

0.1.30

• Fletcher's knife finalized — field-tool description, 1 pierce damage, 1 durability (breaks after one swing), no skill gain on attack.
• ChestSnap stability — sanitize null entries in ChestSnap object arrays; suppress residual null-ref noise during world scans after legacy cleanup.

0.1.29

• ChestSnap patches apply correctly — manual Harmony registration (optional string parameter broke automatic patching).
• Null ZNetView guard — ChestSnap lambda no longer throws when phantom views remain.

0.1.24

• Embedded arrowhead icons — PNG art ships inside FletchersForge.dll; no required Icons folder for players.
• Legacy ZDO cleanup — broader ZDOMan scan; runs on world load, player spawn, and via fletcher.cleanup.
• Deploy — build.ps1 -Deploy no longer overwrites profile Icons/ (embedded art is authoritative by default).

0.1.23

• Thunderstore README, icon gallery, and release metadata.
• Reforge / Split default keys set to None (button-only workflow).

0.1.1–0.1.22

• Initial v1: arrow shafts and heads, vanilla-station recipes, field Fletcher's bench, reforge / split / rehead (batch 20).
• Fletcher's knife kitbash, cargo-crate head drops, shaft mesh drops.
• Phantom bench ZDO cleanup for saves affected by early builds.