MagicStaffTweakerClientOnly

Client-only tuning for Valheim's vanilla magic staffs: costs, damage, summon health, summons per cast, and a local Dead Raiser summon-count bypass.

Edition and installation

Install this edition on your client. It does not synchronize settings with a server. Use the separate MagicStaffTweaker server-required edition when everyone should use the same synchronized settings.

Install with a compatible mod manager, or put MagicStaffTweaker.dll and MagicStaffTweaker.Core.dll under BepInEx/plugins. Keep only one edition installed. Requires BepInExPack Valheim and Jötunn.

The plugin identity and config filename are unchanged: com.magicstafftweaker.client.cfg. Keep your existing config when updating and back it up before switching Thunderstore listings.

Controls and fixes

• Staff-specific cost, projectile and damage controls.
• Outgoing staff damage scaling and an AOE fallback, without multiplying inherited damage twice.
• Summon Health uses the actual vanilla prefab baseline for its default and Reset button; positive custom values are preserved.
• Saved settings persist through restarts; missing keys alone receive defaults.
• Hidden settings no longer override skeleton movement, and shared summon weapon damage no longer compounds across equips.
• Summons Per Cast (1–20, default 1) for Dead Raiser, Trollstav, Staff of the Wild and Spirit Caller.
• Ignore Dead Raiser Level Limit (default off) bypasses staff-quality/Blood Magic count limits for locally owned skeletons following your player. Strength and star scaling are retained. Switching it off restores normal enforcement.

Use freshly summoned creatures when testing health or movement changes. Summons Per Cast requests a count; placement and ordinary active limits can still affect the result.

Multiplayer limitations

Your outgoing damage can be sent to an unmodded target owner, but settings remain local. Summons and persistent effects may be controlled by another client. Ownership changes, PvP checks, resistances and other mods can affect results. The local bypass does not enforce a shared server policy or guarantee the same behaviour on other clients.

Compatibility and release status

Built against the installed Valheim assemblies and Jötunn 2.30.x. Future game updates may require changes. The client 2.2.4 functionality was tested in-game by the author/user; 2.2.5 carries the same functionality with the Thunderstore name updated. Automated regression checks passed.

Changelog

2.2.5

• Rename the Thunderstore package to MagicStaffTweakerClientOnly.
• Update documentation to include local summon-count controls and ownership limitations.
• Retain the user-tested 2.2.4 fixes and controls; plugin GUID, config filename and DLL filenames are unchanged.

2.2.4

• Add Summons Per Cast (1–20, default 1) for Dead Raiser, Trollstav, Staff of the Wild, and Spirit Caller.
• Add Ignore Dead Raiser Level Limit (default off) to bypass staff-quality/Blood Magic summon-count enforcement for locally owned skeletons following your player.
• Preserve skeleton strength/star scaling, normal enforcement when off, and all previous client fixes.
• New spawning controls affect local cast instances rather than shared spawn prefabs. Multiplayer ownership restrictions still apply.
• Build, patch signature checks, and automated regression tests passed. These two new controls still require in-game testing.

2.2.3

• Correct Summon Health's displayed/reset default using the vanilla summon prefab health.
• Replace invalid legacy health placeholders while retaining positive custom values.
• Resolve known summon prefabs when attack spawn references do not expose their health.
• Keep all client-only 2.2.2 fixes, names, descriptions, and dependencies.
• Earlier 2.2.2 fixes confirmed working in-game by the user. The new health default passed automated checks and still requires an in-game UI check.

2.2.2

• Fix the client-only Projectile Damage Multiplier by scaling outgoing local staff hit damage instead of an absent projectile field.
• Handle locally initialized AOEs that use their own damage, without applying the multiplier twice to inherited attack damage.
• Preserve saved configuration values on subsequent launches and initialize only missing settings.
• Prevent hidden summon settings from overriding vanilla walking/running speeds and damage scaling.
• Ignore invalid summon health/cooldown values and recognize health inherited by Humanoid summons.
• Avoid repeated multiplication of shared skeleton weapon damage when new summons equip it.
• Keep the client plugin identity and configuration filename; server-required 2.3.3 is unchanged.
• Build and automated checks completed; in-game multiplayer and skeleton targeting still require play testing.

2.2.1

• Current tested client-only release.
• Provides the lighter local/single-player Magic Staff Tweaker configuration set.
• Keeps the client-only plugin separate from the server-authoritative multiplayer edition.