StaffProtectionBubbleRemover

Staff Protection Bubble Remover

Remove the visual effects from the Staff of Protection while keeping its protective functionality completely intact. Now with universal Configuration Manager support - works with any Configuration Manager version!

Features

• Selective Effect Removal: Choose exactly which visual effects to disable
• Universal Configuration Manager Support: Works with any Configuration Manager version
• Performance Optimized: No unnecessary searches, targets only specific effects found in logs
• Debug Logging: Optional detailed logging for troubleshooting (disabled by default)
• Preserves Functionality: All protective benefits remain intact (damage reduction, blocking, etc.)

Configuration Options

With Configuration Manager (Recommended)

Install any Configuration Manager version and access via F1 key in-game:

Compatible with:

• shudnal's Configuration Manager
• Azumatt's Official BepInEx ConfigurationManager
• Any other BepInEx Configuration Manager

Without Configuration Manager

Edit config file directly: BepInEx/config/Caldor.StaffProtectionBubbleRemover.cfg

General

• ModEnabled: Master on/off switch for the entire mod

Specific Effects

• DisableStaffShieldVfx: Remove main staff shield sphere visual (enabled by default)
• DisableCentralOrb: Remove glowing central orb effect (enabled by default)
• DisableDroppingOrb: Remove falling orb particle effect (disabled by default)
• DisableFxShieldStart: Remove shield activation effects container (enabled by default)

Debug

• EnableDebugLogging: Enable detailed logging for troubleshooting (disabled by default)
• Logs saved to: Documents\StaffProtectionBubbleRemover\
• Warning: Impacts performance when enabled

Installation

• Install BepInEx for Valheim (5.4.22+)
• Download this mod
• Extract to BepInEx/plugins/ folder
• Optional: Install any Configuration Manager for easy in-game configuration
• Launch Valheim and press F1 if you have Configuration Manager, or edit config file directly

How it Works

The mod uses Harmony patches to intercept the visual effects of the Staff of Protection shield status effect ($se_shield). It specifically targets these GameObject components:

• vfx_StaffShield(Clone): Main shield sphere visual
• fx_shield_start(Clone): Shield activation effects container
• Central Orb: Glowing orb particle effect
• Dropping Orb: Falling orb particles

All protective mechanics remain completely untouched - only the visual renderers and particle systems are disabled.

Performance Notes

This version is highly optimized compared to previous releases:

• ✅ No recursive searching - targets specific effects only
• ✅ Minimal CPU usage - cleanup runs once per second, not every frame
• ✅ Optional logging - debug logging disabled by default for better performance
• ✅ Smart caching - prevents duplicate effect processing

Compatibility

• Valheim: Compatible with version 0.217.46+
• BepInEx: Requires version 5.4.22+
• Configuration Manager: Optional - works with any version (shudnal's, Azumatt's, official BepInEx)
• Other Mods: Compatible with most Valheim mods

Troubleshooting

• Effects still visible: Enable debug logging to see which effects are being processed
• Performance issues: Ensure debug logging is disabled in Configuration Manager
• Configuration not saving: Make sure Configuration Manager is installed properly

Version History

2.0.0

• Added Configuration Manager support with individual effect toggles
• Massive performance optimization (removed recursive searching)
• Smart effect caching to prevent duplicate processing
• Optional debug logging (disabled by default)
• Targeted specific effects based on actual game analysis

1.0.0

• Initial release
• Basic bubble visual removal functionality

Credits

Created by Caldor for the Valheim modding community.

Optimized based on extensive game effect analysis and community feedback.