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.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 (
