StaffProtectionBubbleRemover
Remove Staff of Protection visual effects with optional Configuration Manager support. Toggle Central Orb, shield sphere, and particle effects individually. Works with any Configuration Manager.
About this mod Author’s original text
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.
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: