Staffs of Fracturing

Contains Ashlands equipment and material spoilers.

Staffs of Fracturing adds three Ashlands-tier variants of the Staff of Fracturing. Each keeps the familiar twelve-projectile fracture pattern, then gives every fractured ball a distinct gemstone effect.

The three staffs

Iolite Staff of Fracturing

• Fractured balls deal lightning damage.
• Their natural flight lifetime is doubled from the vanilla fracture-ball lifetime. Impacts can still end a ball earlier.
• On an enemy hit, each ball has a 25% chance to arc once to the nearest other enemy within 8 metres.
• Every unordered pair of balls from the same shot independently has a 25% chance to form a brief lightning link, limited to 24 links per shot and bounded by range.
• Enemies crossing a link take lightning damage, with a per-shot hit cooldown to prevent overlapping links from multiplying damage uncontrollably.

Jade Staff of Fracturing

• Every fractured ball bursts for blunt and native poison damage in a 3.5-metre radius.
• Each detonation leaves a networked poison-control haze for 5 seconds.
• Once per second, every affected enemy receives one independent 20% immobilization roll, even where multiple hazes overlap.
• Immobilization uses Valheim's native Immobilized status effect.

Bloodstone Staff of Fracturing

• Every fractured ball detonates on its first terrain or enemy impact for blunt damage in a 2.25-metre radius.
• Each detonation launches 5 fast, piercing blood-shard projectiles—60 shards if all twelve balls detonate. The shards have compact red visuals and short trails.
• Shrapnel launches twice as fast by default: 56 metres per second instead of 28. Its flight lifetime remains 1.6 seconds by default, allowing it to travel farther before expiring.
• Shrapnel is a real, blockable and dodgeable projectile and cannot fracture recursively.

Core damage scales by 25% of its configured base value per item-quality level above quality 1.

Staff-top appearance

Version 1.0.4 gives each crown its own color and restrained decoration: blue-white Iolite arcs and sparks, Jade haze, and Bloodstone drips with floating pointed particles. The shaft, grip, bottom and small lower gemstones retain their vanilla material. Decorative Bloodstone particles do not deal damage.

The effects are attached for held, sheathed and dropped items. Their final appearance in-game still needs verification.

Crafting and upgrading

Craft all variants at a level 2 Galdr table.

Upgrades consume additional Flametal and matching gemstones through Valheim's normal increasing recipe-upgrade flow.

Configuration

The generated BepInEx configuration file exposes bounded settings for:

• Lightning enemy-chain chance, ball-link chance, damage, range, link damage and hit cooldown
• Poison radius, blunt damage, poison damage, duration, immobilization chance and check interval
• Blood explosion radius and damage, shrapnel count, damage, base speed, speed multiplier and lifetime

Configuration is server-authoritative and synchronized through Jotunn. Only server administrators may change synchronized values.

Bloodstone launch speed is ShrapnelVelocity × ShrapnelSpeedMultiplier. The new multiplier defaults to 2, so existing configurations also receive the speed increase without resetting their base velocity. Set the multiplier to 1.5 for a 50% increase instead. Visual motion stretch and wake duration are compensated to retain the compact shard appearance.

Installation

Requires:

• BepInExPack Valheim 5.4.2350 or newer
• Jotunn 2.30.0 or newer

With a mod manager, install the package and its dependencies normally. For a manual installation, install BepInEx and Jotunn, then place StaffsOfFracturing.dll in BepInEx/plugins/.

This mod is required on the server and on every connecting client. Version matching is strict at the patch level.

When updating, replace the old mod DLL on the server and all clients. If upgrading from 1.0.0, also update both dependencies. Keep only one installed copy of StaffsOfFracturing.dll. Existing configuration keys and item prefab identifiers are retained.

Compatibility

Version 1.0.4 targets Valheim 1.0.12 (network version 40), with native assets inspected from Unity 6000.0.75f1. It retains all 1.0.3 gameplay, including doubled Bloodstone shrapnel speed and Iolite secondary natural lifetime, compact red fragments, first-contact Bloodstone detonations, damage settings, recipes and package artwork.

Validation includes compilation/API checks, offline native mesh/material inspection and a numerical audit that preserves all original vertex bytes and triangles. See VALIDATION.md for the final build results and remaining limits.

In-game visual validation is pending. Build and API checks passed. Final effects, animation, held/dropped appearance and multiplayer visuals have not been tested in-game.

The mod uses a single Harmony postfix pinned to the six-argument Projectile.Setup method; all content registration, recipes, networking and configuration synchronization are handled through Jotunn.

Source and license

Source is included in the separate source-project archive. See BUILDING.md there for build instructions. Staffs of Fracturing is distributed under the MIT License.

Changelog

1.0.5 - 2026-10-01

• Restore the SDK project and rebuild against Valheim 1.0.16, Jotunn 2.30.2 and BepInExPack 5.4.2351.
• Verify the current Projectile.Setup patch and external runtime API references, and review Jotunn registration/multiplayer contracts against its GitHub source.
• Clarify installation and staff effects. Lightning links damage enemies intersecting the segment when it forms; the visual does not check enemies crossing later.
• Preserve recipes, save identifiers, gameplay balance and existing crown/projectile appearance.

1.0.4 — 2026-09-12

• Add blue-white Iolite crown coloration with compact crackling arcs and sparks.
• Add Jade crown coloration and a small drifting poison haze around the top.
• Add a blood-red Bloodstone crown, subtle drips and floating pointed decorative particles around the top.
• Preserve the vanilla shaft, grip, bottom, lower gemstones and original model shape.
• Retain all 1.0.3 gameplay, compact fast Bloodstone fragments, instant Bloodstone ball impacts, doubled electric-ball lifetime, recipes, settings and package photo.
• Integrate the completed staff handoff and verify the release build, API compatibility and package contents. In-game visual validation remains pending.

1.0.3 — 2026-09-12

• Double Bloodstone shrapnel launch speed by default, from 28 to 56 metres per second. Add a synchronized speed multiplier so the increase also applies to existing configurations; 1.5 selects a 50% increase.
• Compensate motion-dependent shrapnel visuals to retain the compact red fragments introduced in 1.0.2 at the higher speed.
• Double Iolite secondary balls' natural flight lifetime. Primary timing, impact behavior, web-link chances, damage and link duration are retained.
• Keep Bloodstone's first-contact detonations, fragment flight lifetime and damage, Jade behavior, crafting recipes and package artwork.
• Rebuild against Valheim 1.0.12. See VALIDATION.md for build/API checks and the remaining in-game validation limits.

1.0.2 — 2026-09-11

• Make Bloodstone shrapnel particles 35% of their previous size, with substantially shorter motion stretch and trails. Visual particle lifetime and trail duration are 25% of their previous settings.
• Disable terrain bouncing on Bloodstone fracture balls so the native explosion and shrapnel callback run on the first terrain or enemy impact. Remove the spent ball immediately after impact.
• Preserve shrapnel launch speed, projectile lifetime, gravity, drag, collision radius, count, damage and red appearance. Iolite and Jade behavior is unchanged.
• Rebuild against the same Valheim 1.0.12 assemblies. Compilation, metadata checks and comparison of the unchanged shrapnel flight/damage instructions passed; final visuals and impact behavior still need an in-game check.

1.0.1 — 2026-09-11

• Rebuilt against Valheim 1.0.12 and updated dependencies to BepInExPack Valheim 5.4.2350 and Jotunn 2.30.0.
• Require Jotunn 2.30.0 or newer when loading the plugin.
• Pin the projectile setup patch to the verified six-argument signature and bind its arguments by position.
• Update build-path detection for current client/server folders and common Jotunn installation layouts.
• Resolve explicit game runtime references without importing unrelated Mono framework dependency conflicts into the build.
• Preserve the three staff mechanics, damage values, recipes, configuration keys, item identifiers and current package icon.
• Add a reproducible metadata compatibility audit. Compilation and API checks passed; in-game testing on 1.0 is still pending.

1.0.0 — 2026-08-25

• Added Iolite, Jade and Bloodstone variants of the Staff of Fracturing.
• Added bounded lightning chaining and same-shot lightning webs.
• Added owner-authored poison detonations, lingering haze and overlap-safe immobilization checks.
• Added blunt Bloodstone detonations and non-recursive piercing shrapnel.
• Added synchronized, server-authoritative balance configuration.
• Added Galdr table crafting and upgrade recipes, English localization, custom VFX styling and an original package icon.
• Added dedicated-server-safe content registration and strict client/server version compatibility.