Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
OptiHouse
High-performance client-side base optimization mod for Valheim. Fixes FPS drops in mega-bases via dynamic lighting shadow limits, particle suppression, indoor smoke physics throttling, and structural shadow culling.
| Date uploaded | 2 hours ago |
| Version | 1.4.0 |
| Download link | UncleBugDev-OptiHouse-1.4.0.zip |
| Downloads | 25 |
| Dependency string | UncleBugDev-OptiHouse-1.4.0 |
This mod requires the following mods to function
denikson-BepInExPack_Valheim
BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.
Preferred version: 5.4.2202README
OptiHouse ⚡
High-Performance Client-Side Base Optimization Mod for Valheim
Eliminates massive framerate drops in large player bases, villages, and castles with zero risk to game worlds.
🛡️ Zero-Risk Guarantee (No World or Structure Corruption)
Unlike destructive mods that merge or delete GameObjects and corrupt Valheim's persistent ZDO database (.db / .fwl), OptiHouse operates 100% on the client presentation layer:
- Zero ZDO modifications: Pieces are never deleted, baked into new GameObjects, or desynchronized.
- Save files remain 100% vanilla: You can safely install or uninstall OptiHouse at any time with zero impact on your saved worlds.
- Hammer Safety: Equipping a hammer or building tool instantly restores all colliders for pixel-perfect snapping and repairing.
OptiHouse is a client-side performance optimization mod engineered to eliminate framerate drops, stuttering, and render lag in large Valheim bases, villages, and mega-castles.
When hundreds of building pieces, torches, braziers, smoke puffs, tamed animals, trophies, banners, and crafting stations meet in one area, Valheim's rendering and physics pipeline bottlenecks your GPU and CPU with thousands of unculled shadow draw calls, redundant particle bursts, physics vertex calculations, and excessive indoor smoke raycasts. OptiHouse smartly optimizes these subsystems without altering building integrity, fire mechanics, or core gameplay visuals.
🚀 Key Features & Optimizations
💡 1. Dynamic Lighting & Shadow Management ([Lighting])
- Point Light Shadow Limiter: Dynamically tracks light sources around the player and restricts active shadow-casting point lights to the closest lights (default: 6). Excess lights continue to illuminate surfaces smoothly with shadows set to
None, drastically reducing shadow map render passes. - Torch & Sconce Shadow Stripping: Wall torches, sconces, and standing braziers maintain their ambient glow while stripping heavy real-time shadows.
- Interior Light Distance Culling: Intelligently reduces rendering overhead for distant small light sources within large settlements.
💨 2. Indoor Smoke Physics & Puff Throttling ([Smoke])
- Smoke Puff Hard Cap: Enforces a configurable cap on simultaneous active smoke particles (default: 25 vs vanilla's 100+). Prevents massive chimney bottlenecks and physics lag while keeping hearths functional.
- Ceiling Collision Throttling: Throttles continuous indoor raycasting for rising smoke puffs to save CPU cycles.
- Optional Smoke Rendering Toggle: Option to disable visual particle rendering while fully preserving fire, warmth, cooking, and comfort mechanics.
💥 3. VFX & Particle Suppression ([VFX])
- Cultivation & Terraforming Throttle: Suppresses repetitive, heavy particle bursts when cultivating soil, leveling ground, or using the hoe in base areas.
- Demolition Dust Suppression: Suppresses heavy debris chunk bursts and wood/stone dust particle spam when tearing down or rebuilding structures.
- Zero Risk to Gameplay: Does not affect item drops, resource yields, or damage indicators.
🏛️ 4. Structural Physics & Mesh Optimizations ([Structural])
- WearNTear Weather Cover Throttling: Throttles redundant
UpdateCoversky raycast checks on undamaged, static building pieces by 3–5x. Drastically reduces main thread CPU frame times in dense bases. - Small Piece Shadow Culling: Automatically disables shadow-casting on small structural pieces (short beams <= 2m, iron bars, decorative poles) beyond a configurable distance (default: 15m). Massive bases look identical from a distance while saving hundreds of shadow draw calls.
- PhysX Decorative Collider Optimization: Temporarily disables PhysX colliders on non-walkable decorative structural pieces (cross beams, ridge caps, trim elevated > 3.5m) to eliminate bounding-box scene query overhead.
- Hammer Safety Guarantee: Instantly and automatically restores all colliders whenever a hammer, hoe, or building tool is equipped, ensuring building, snapping, and repairing remain 100% pixel-perfect.
🚪 5. Interior Occlusion Culling ([Interior Occlusion])
- Enclosed Base Occlusion: Valheim lacks indoor occlusion culling, meaning indoor furniture, chests, and decor inside a closed building are still drawn even when standing outside. OptiHouse detects when the player is outside shelter and dynamically suppresses renderers of distant interior items beyond 18m.
- Instant Restore: Instantly restores all indoor renderers the moment you approach an entrance or enter shelter. Exterior walls and roofs always remain 100% rendered.
⚡ 6. Multi-Threaded Gfx Jobs Engine Tweak ([General])
- boot.config Tweaks: Unity's engine supports multi-threaded graphics rendering jobs (
gfx-enable-gfx-jobs=1,gfx-enable-native-gfx-jobs=1) which offloads draw call submission across CPU cores. OptiHouse automatically configures this invalheim_Data/boot.configwith a safe backup.
🚩 7. Cloth & Banner Physics Culling ([Cloth & Banners])
- Unity Cloth Solver Culling: Dynamically pauses heavy CPU vertex physics solvers on distant banners, flags, and tapestries beyond the culling distance (default: 15m).
- Hysteresis Smoothing: 3m hysteresis margin prevents rapid toggling when moving near the boundary; simulations smoothly resume when approaching.
📦 8. Storage & Trophy Stand Throttling ([Storage & ItemStands])
- Item & Armor Stand Throttling: Drastically cuts lag in dense storage halls and armories. Mounted glowing weapons (Frostner, Mistwalker, torches) and trophies pause particle systems and disable dynamic point lights when beyond the culling threshold (default: 12m).
- Instant Restore: Automatically restores full visual brilliance when walking up to inspect items or stands.
🐗 9. Farm Animal LOD & AI Throttling ([Farm Animals])
- Tamed Animal Animator LOD: Switches animators on tamed boars, wolves, chickens, and loxes in pens to efficient LOD culling modes beyond distance (default: 15m).
- Idle AI Throttling: Throttles non-critical pathfinding and idle queries for distant pen animals without interfering with breeding, taming, or defense mechanics.
🔨 10. Crafting Station Audio & Particle Culling ([Crafting Stations])
- Processing Station Culling: Pauses heavy particle emitters (sparks, bubbling liquids, grinding dust) and looping ambient sound sources on smelters, blast furnaces, kilns, cauldrons, fermenters, spinning wheels, and windmills beyond distance (default: 18m).
📊 11. Real-Time Benchmark HUD Overlay ([HUD & Benchmark])
- In-Game Diagnostics (
Shift+F7): High-contrast, flicker-free IMGUI overlay displaying real-time FPS, rolling Average FPS, true 1% Low framerate, and frame time in milliseconds. - Live Base Diagnostics: Displays total base pieces, shadow lights, smoke puffs, banner cloths, item stands, tamed animals, crafting stations, interior culled items, decorative colliders, and multi-threaded gfx jobs engine status.
- Status Indicator: Shows live
[OptiHouse: ACTIVE](green) or[OptiHouse: DISABLED](red) status. - Customizable: Change hotkey, anchor position (
TopLeft,TopRight,BottomLeft,BottomRight), and text size.
⌨️ 12. Runtime Toggle Hotkey
- Instant Toggle (
F7by default): Switch optimizations on and off in real time with an on-screen HUD message to easily benchmark before-and-after FPS in your base.
⚙️ Configuration
A configuration file is generated at BepInEx/config/com.unclebug.optihouse.cfg upon first launch. All settings can be tweaked live in-game using the BepInEx Configuration Manager (F1).
| Category | Setting | Default | Description |
|---|---|---|---|
| [1. General] | MasterOptimizationEnabled |
true |
Master switch for all OptiHouse base optimizations. |
| [1. General] | ToggleHotkey |
F7 |
Hotkey to toggle optimizations on the fly. |
| [1. General] | ShowNotificationOnToggle |
true |
Show on-screen MessageHud notification when toggling. |
| [1. General] | EnableLogging |
false |
Enable detailed diagnostic logging in BepInEx console. |
| [1. General] | EnableGfxJobsTweak |
true |
Enable multi-threaded graphics rendering job tweaks in boot.config. |
| [2. Lighting] | EnableLightOptimization |
true |
Enable dynamic base lighting and shadow management. |
| [2. Lighting] | MaxShadowCastingLights |
6 |
Maximum number of point lights allowed to cast real-time shadows near the player (0–32). |
| [2. Lighting] | DisableTorchShadows |
true |
Disable shadow casting on small wall torches and sconces. |
| [2. Lighting] | LightCullDistance |
45.0 |
Maximum distance at which small interior lights are actively processed (meters). |
| [3. VFX] | EnableVfxOptimization |
true |
Enable particle and visual effect throttling. |
| [3. VFX] | EnableFastParticleFade |
true |
Accelerate particle dissipation so dust, sparks, debris, and smoke vanish quickly. |
| [3. VFX] | ParticleLifetimeMultiplier |
0.35 |
Multiplier for particle lifetime (0.35 = particles fade ~3x faster, no lingering clouds). |
| [3. VFX] | MaxParticleLifetimeSeconds |
2.0 |
Maximum seconds any temporary VFX or debris particle can exist on screen. |
| [3. VFX] | ParticleSimulationSpeed |
1.5 |
Speed multiplier for particle animations so dust and sparks disperse rapidly. |
| [3. VFX] | SuppressCultivationParticles |
true |
Suppress heavy particle bursts when hoeing or cultivating ground. |
| [3. VFX] | SuppressDestructionParticles |
true |
Suppress massive dust/debris spam when breaking pieces. |
| [3. VFX] | VfxThrottlingDistance |
30.0 |
Distance beyond which non-critical ambient particles are throttled. |
| [4. Smoke] | EnableSmokeOptimization |
true |
Enable indoor smoke puff and physics optimization. |
| [4. Smoke] | MaxActiveSmokePuffs |
25 |
Hard limit for simultaneous active smoke puffs in base areas. |
| [4. Smoke] | SmokeLifetimeMultiplier |
0.35 |
Multiplier for chimney and hearth smoke puff lifetime (dissolves quickly). |
| [4. Smoke] | ThrottleSmokeRaycasts |
true |
Throttle indoor ceiling collision raycasts for smoke puffs. |
| [4. Smoke] | DisableSmokeRendering |
false |
Disable smoke particle visuals while keeping fire/comfort mechanics. |
| [5. Structural] | EnableStructuralOptimization |
true |
Enable structural piece shadow and CPU raycast optimizations. |
| [5. Structural] | EnableWearNTearThrottling |
true |
Throttle periodic sky/weather raycast checks on intact pieces. |
| [5. Structural] | WearNTearThrottleInterval |
10.0 |
Seconds between weather protection raycasts for static covered pieces. |
| [5. Structural] | EnablePieceShadowCulling |
true |
Disable shadow casting on small structural elements beyond culling distance. |
| [5. Structural] | PieceShadowCullDistance |
15.0 |
Distance beyond which small structural pieces stop casting shadows. |
| [5. Structural] | EnableDecorativeColliderOptimization |
true |
Temporarily disable colliders on non-walkable decorative pieces. |
| [6. Cloth & Banners] | EnableClothOptimization |
true |
Enable distance-based culling for Unity Cloth components on banners/flags. |
| [6. Cloth & Banners] | BannerClothCullDistance |
15.0 |
Distance beyond which cloth physics simulation is disabled. |
| [7. Storage & ItemStands] | EnableItemStandOptimization |
true |
Enable particle and light throttling on distant mounted trophies and weapons. |
| [7. Storage & ItemStands] | ItemStandCullDistance |
12.0 |
Distance beyond which item stand particles and lights are culled. |
| [8. Farm Animals] | EnableTamedAnimalLod |
true |
Enable animator LOD culling and AI throttling for distant tamed animals. |
| [8. Farm Animals] | TamedAnimalLodDistance |
15.0 |
Distance beyond which tamed animal animators switch to LOD mode. |
| [9. Crafting Stations] | EnableStationOptimization |
true |
Enable particle and ambient audio culling on distant crafting stations. |
| [9. Crafting Stations] | StationCullDistance |
18.0 |
Distance beyond which crafting station idle particles and loops pause. |
| [10. HUD & Benchmark] | EnableBenchmarkHUD |
true |
Enable the real-time in-game benchmark and diagnostics overlay. |
| [10. HUD & Benchmark] | BenchmarkHudHotkey |
F7 |
Hotkey to toggle the benchmark HUD overlay. |
| [10. HUD & Benchmark] | BenchmarkHudRequireShift |
true |
Require holding Shift with hotkey (Shift+F7) to toggle the benchmark HUD. |
| [10. HUD & Benchmark] | HudTextSize |
13 |
Font size for benchmark HUD overlay text (10–24). |
| [10. HUD & Benchmark] | HudPosition |
TopLeft |
Screen anchor position (TopLeft, TopRight, BottomLeft, BottomRight). |
| [11. Interior Occlusion] | EnableInteriorCulling |
true |
Enable interior piece and furniture culling when outside base shelter. |
| [11. Interior Occlusion] | InteriorCullDistance |
18.0 |
Distance (in meters) beyond which interior pieces are culled outside shelter. |
| [12. Terrain Helpers] | EnableTerrainSanityCheck |
true |
Detect legacy uncompressed terrain modification stacks in base zones. |
🛠️ Installation
Thunderstore Mod Manager (Recommended)
- Install Thunderstore Mod Manager.
- Search for OptiHouse and click Download.
Manual Installation
- Ensure BepInExPack Valheim is installed.
- Download
OptiHouse_v1.3.0.zipfrom Thunderstore or GitHub Releases. - Extract
OptiHouse.dllinto your Valheim directory underBepInEx/plugins/UncleBugDev-OptiHouse/. - Launch the game!
🌐 Compatibility & Multiplayer
- Client-Side Only: OptiHouse only runs on the client. It does not need to be installed on dedicated servers.
- Server Friendly: Safe to use on vanilla servers, community servers, and modded servers.
- Mod Compatibility: Fully compatible with Valheim+, ComfyQuickTransfer, PingMaker, PlantEasily, Gizmo, and other popular building mods.
🌟 Special Thanks & Credits
This mod was created and optimized thanks to the streamer DaymonMontage!
- 🎮 Twitch Channel: twitch.tv/daymonmontage
- 🌐 Daymon Community Hub: daymonmontage.github.io/daymon-site/
📜 License & Authors
- Author: UncleBug (GitHub)
- Special Thanks & Inspiration: DaymonMontage (Twitch | Web Hub)
- Licensed under the MIT License.
CHANGELOG
Changelog
All notable changes to OptiHouse will be documented in this file.
[1.4.0] - 2026-11-16
Fixed
- Smart Interior Occlusion Bugfix: Fixed a critical issue where entering shelter (
InShelter() == true) globally restored all interior furnishings across the entire base. Now uses smart per-room distance culling: immediate room furnishings remain visible, while distant buildings and rooms remain 100% culled even when under a roof.
Added
- Structural Detail Piece LOD (
[14. Structural Detail LOD]):- Dynamically culls
MeshRendereron small decorative micro-pieces (1m beams, 26°/45° cross beams, decorative brackets, dragonheads, trim, finials, roof crests) beyond 32m (configurable). - Keeps major structural walls, foundations, main pillars, and full roof slopes 100% visible so castle silhouettes remain grand and unbroken from afar.
- Slashes draw calls by 40–60% in high-detail bases.
- Automatically restores all detail renderers when holding a hammer, hoe, or building tool.
- Dynamically culls
- Ground Loot & Item Drop Optimizer (
[13. Item Drops & Loot]):- Auto-Stacker: Periodically merges identical loose ground drops (wood, stone, resin, trophies) within a 3.5m radius into consolidated max-size stacks, eliminating redundant GameObjects.
- Physics Sleep: Automatically puts Rigidbodies of motionless ground drops to sleep, halting continuous PhysX collision checks on bases.
- Particle & Floating LOD: Pauses sparkle particles and water floating script updates on distant drops (> 15m).
- HUD Diagnostics Expansion:
- Added live counters for Detail Pieces LOD and Ground Loot Clutter (sleeping & merged counts) to
Shift+F7overlay.
- Added live counters for Detail Pieces LOD and Ground Loot Clutter (sleeping & merged counts) to
[1.3.0] - 2026-11-16
Added
- Multi-Threaded Gfx Jobs Engine Optimization (
[1. General]):- Added
EnableGfxJobsTweak(default: true): Automatically enables multi-threaded graphics rendering job tweaks inboot.config(gfx-enable-gfx-jobs=1,gfx-enable-native-gfx-jobs=1) with automatic backup creation (boot.config.bak). - Unlocks multi-core CPU submission for Unity draw calls, dramatically improving base framerate.
- Added
- Interior Occlusion Culling (
[11. Interior Occlusion]):- Added
EnableInteriorCulling(default: true) andInteriorCullDistance(default: 18m). - Temporarily culls renderers on enclosed interior pieces (furniture, beds, chests, rugs, stands) when the player is outside shelter.
- Exterior walls, roofs, and facades remain fully rendered while saving hundreds of interior batch draw calls.
- Added
- PhysX Decorative Collider Optimization (
[5. Structural]):- Added
EnableDecorativeColliderOptimization(default: true). - Temporarily disables colliders on purely non-walkable decorative structural pieces (wood beam crosses, ridge caps, trim elevated > 3.5m) to reduce PhysX bounding-box query load.
- Hammer Safety Guarantee: Instantly restores all colliders when a hammer, hoe, or building tool is equipped so building, snapping, and repairing remain 100% pixel-perfect.
- Added
- Terrain Compaction Helper (
[12. Terrain Helpers]):- Added
EnableTerrainSanityCheck(default: true): Detects legacy uncompressed terrain modification stacks in active base zones and provides compaction utility.
- Added
- Benchmark HUD Overlay Upgrades:
- Integrated real-time indicators for Interior Culling, Decorative Colliders, and Multi-threaded Gfx Jobs status.
[1.2.0] - 2026-11-16
Added
- Fast Particle Dissipation System (
[VFX]):- Added
EnableFastParticleFade(default: true): Accelerates the dissipation and fading of all temporary particles across the game (demolition debris, combat impacts, dust, hoeing clouds, sparks). - Added
ParticleLifetimeMultiplier(default: 0.35): Reduces particle lifetime by ~65%, so particles fade away ~3x faster, eliminating lingering billboard clouds that choke GPU fillrate. - Added
MaxParticleLifetimeSeconds(default: 2.0s): Hard cap on the maximum time any temporary VFX or debris particle can exist on screen. - Added
ParticleSimulationSpeed(default: 1.5x): Increases animation speed of particles so dust, smoke, and sparks dissolve rapidly. - Added
SmokeLifetimeMultiplier(default: 0.35): Chimney and hearth smoke puffs fade and dissipate quickly instead of accumulating and lingering for up to a minute under high ceilings. - Patched
TimedDestruction.Awake,EffectList.Create(Postfix), andSmoke.Awakefor universal particle lifetime scaling.
- Added
- HUD Diagnostics:
- Added real-time Fast Particle Fade indicator to the Shift+F7 Benchmark HUD.
- Custom Meme Icon:
- Updated mod icon with high-res 256x256 "FPS STONKS / OPTIHOUZ" Viking meme artwork.
[1.1.0] - 2026-11-16
Added
- Cloth & Banner Optimizer (
[Cloth & Banners]):- Dynamic distance-based culling for Unity
Clothcomponents on banners, flags, and tapestries (BannerClothCullDistance, default: 15m). - Pauses costly CPU vertex physics solvers on distant decorative cloths, smoothly resuming when player approaches.
- Dynamic distance-based culling for Unity
- Storage & Trophy Room Optimizer (
[Storage & ItemStands]):- Performance throttling for mounted weapons, glowing items (Frostner, Mistwalker, torches), and trophies in
ItemStandandArmorStand(ItemStandCullDistance, default: 12m). - Pauses attached
ParticleSystemcomponents and disables dynamic light sources on distant mounts.
- Performance throttling for mounted weapons, glowing items (Frostner, Mistwalker, torches), and trophies in
- Farm Animal LOD & AI Optimizer (
[Farm Animals]):- Tamed animal animator culling and idle AI throttling for boars, wolves, chickens, and loxes (
TamedAnimalLodDistance, default: 15m). - Switches animator culling mode to LOD beyond distance while maintaining full game mechanics.
- Tamed animal animator culling and idle AI throttling for boars, wolves, chickens, and loxes (
- Crafting Station Audio & VFX Optimizer (
[Crafting Stations]):- Idle particle and looping ambient audio culling for crafting and processing stations (smelters, kilns, cauldrons, fermenters, windmills, spinning wheels) (
StationCullDistance, default: 18m).
- Idle particle and looping ambient audio culling for crafting and processing stations (smelters, kilns, cauldrons, fermenters, windmills, spinning wheels) (
- Real-Time Diagnostics & Benchmark HUD (
[HUD & Benchmark]):- In-game real-time diagnostics overlay toggled with
Shift+F7(BenchmarkHudHotkey,BenchmarkHudRequireShift). - Live FPS, rolling Average FPS, true 1% Low framerate, and frame time (ms).
- Live subsystem counters: total base pieces, active vs culled shadow lights, smoke puff count vs cap, culled cloths, culled item stands, tamed animals in LOD, and culled stations.
- Real-time
[OptiHouse: ACTIVE](green) vs[OptiHouse: DISABLED](red) indicator. - Configurable screen anchor (
HudPosition) and customizable font size (HudTextSize).
- In-game real-time diagnostics overlay toggled with
[1.0.0] - 2026-11-15
Initial Release
- Dynamic Lighting Optimizer:
- Added dynamic point light shadow budget (
MaxShadowCastingLights, default: 6 closest lights keep dynamic shadows). - Added torch and sconce shadow stripping (
DisableTorchShadows). - Added interior light distance culling (
LightCullDistance).
- Added dynamic point light shadow budget (
- Smoke Physics & Puff Optimizer:
- Implemented configurable hard cap on active smoke puffs (
MaxActiveSmokePuffs, default: 25). - Indoor ceiling raycast throttling for rising smoke particles.
- Optional visual smoke disabling (
DisableSmokeRendering) while retaining all warmth, fire, and comfort mechanics.
- Implemented configurable hard cap on active smoke puffs (
- VFX Particle Optimizer:
- Suppression of heavy dirt, ground, and terrain leveling particles during hoeing and cultivating (
SuppressCultivationParticles). - Suppression of massive wood and stone debris explosion particles on piece demolition (
SuppressDestructionParticles). - Distance throttling for ambient building particles (
VfxThrottlingDistance).
- Suppression of heavy dirt, ground, and terrain leveling particles during hoeing and cultivating (
- Structural Physics & Geometry Optimizer:
- Throttled
WearNTear.UpdateCoversky raycast weather checks for undamaged covered structures (EnableWearNTearThrottling). - Dynamic shadow culling for small building pieces, beams, and decorative elements (
EnablePieceShadowCulling,PieceShadowCullDistance).
- Throttled
- Controls & HUD:
- Added runtime hotkey toggle (
F7by default) with real-timeMessageHudnotification. - Added comprehensive BepInEx configuration categories (
[General],[Lighting],[VFX],[Smoke],[Structural]).
- Added runtime hotkey toggle (