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