StaffsOfFracturing
Adds Iolite, Jade, and Bloodstone Staffs of Fracturing with unique lightning, poison, and shrapnel mechanics.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.
- 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
Immobilizedstatus 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 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.
Crafting and upgrading
Craft all variants at a level 2 Galdr table.
| Staff | Base staff | Metal | Gemstone |
|---|---|---|---|
| Iolite | 1 Staff of Fracturing | 5 Flametal | 1 Iolite |
| Jade | 1 Staff of Fracturing | 5 Flametal | 1 Jade |
| Bloodstone | 1 Staff of Fracturing | 5 Flametal | 1 Bloodstone |
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, speed and lifetime
Configuration is server-authoritative and synchronized through Jotunn. Only server administrators may change synchronized values.
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.2 targets Valheim 1.0 and was compiled against the supplied Valheim 1.0.12 assemblies (network version 40). It clones vanilla prefabs at runtime. This update makes Bloodstone shrapnel substantially smaller and shorter, and removes the Bloodstone balls' inherited terrain bounce so they detonate on contact. Shrapnel flight distance, speed, damage, recipes and the package icon are retained.
Validation: Release build with zero warnings/errors; all 92 external runtime types and 266 external runtime members resolved against the supplied assemblies; the exact projectile setup signature, postfix argument bindings and impact callback were checked. The compiled shrapnel flight and damage instructions match 1.0.1. The production DLL contains no diagnostic hooks or logging.
The 1.0.2 changes have not been tested in-game here. The supplied Managed DLLs support compilation and API inspection but do not include the executable or game assets needed to check the final visual size, live impacts or multiplayer behavior. See VALIDATION.md for the checks performed and their limits.
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.
