You are viewing a potentially older version of this package. View all versions.
UncleBugDev-OptiHouse-1.4.0 icon

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-5.4.2202 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured and includes unstripped Unity DLLs.

Preferred version: 5.4.2202

README

OptiHouse Logo

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.

GitHub Release Thunderstore License: MIT Platform


🛡️ 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 UpdateCover sky 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 in valheim_Data/boot.config with 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 (F7 by 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)

  1. Install Thunderstore Mod Manager.
  2. Search for OptiHouse and click Download.

Manual Installation

  1. Ensure BepInExPack Valheim is installed.
  2. Download OptiHouse_v1.3.0.zip from Thunderstore or GitHub Releases.
  3. Extract OptiHouse.dll into your Valheim directory under BepInEx/plugins/UncleBugDev-OptiHouse/.
  4. 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!


📜 License & Authors

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 MeshRenderer on 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.
  • 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+F7 overlay.

[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 in boot.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.
  • Interior Occlusion Culling ([11. Interior Occlusion]):
    • Added EnableInteriorCulling (default: true) and InteriorCullDistance (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.
  • 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.
  • Terrain Compaction Helper ([12. Terrain Helpers]):
    • Added EnableTerrainSanityCheck (default: true): Detects legacy uncompressed terrain modification stacks in active base zones and provides compaction utility.
  • 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), and Smoke.Awake for universal particle lifetime scaling.
  • 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 Cloth components on banners, flags, and tapestries (BannerClothCullDistance, default: 15m).
    • Pauses costly CPU vertex physics solvers on distant decorative cloths, smoothly resuming when player approaches.
  • Storage & Trophy Room Optimizer ([Storage & ItemStands]):
    • Performance throttling for mounted weapons, glowing items (Frostner, Mistwalker, torches), and trophies in ItemStand and ArmorStand (ItemStandCullDistance, default: 12m).
    • Pauses attached ParticleSystem components and disables dynamic light sources on distant mounts.
  • 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.
  • 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).
  • 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).

[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).
  • 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.
  • 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).
  • Structural Physics & Geometry Optimizer:
    • Throttled WearNTear.UpdateCover sky raycast weather checks for undamaged covered structures (EnableWearNTearThrottling).
    • Dynamic shadow culling for small building pieces, beams, and decorative elements (EnablePieceShadowCulling, PieceShadowCullDistance).
  • Controls & HUD:
    • Added runtime hotkey toggle (F7 by default) with real-time MessageHud notification.
    • Added comprehensive BepInEx configuration categories ([General], [Lighting], [VFX], [Smoke], [Structural]).