Valheim Performance Engine

Valheim Performance Engine is an advanced, high-performance optimization and visual clarity engine for Valheim, engineered with deep native support for Linux (Vulkan) and Windows (DirectX).

It eliminates micro-stutter, silences log I/O overhead, manages CPU worker threads on high-core processors, auto-enables GPU Instancing, and introduces an innovative Global Vulkan Shader Resolver that cures missing Windows DirectX shaders in mods without breaking textures.

---

🇧🇷 Português

Principais Recursos

• Resolução Global de Shaders Vulkan (Plataforma 18): Intercepta e traduz preventivamente shaders antigos ou exclusivos do DirectX (muito comuns em mods como MonsterLabZ, Warfare, Valharvest, SouthsilArmor) para shaders nativos do Linux. Elimina os erros repetitivos Desired shader compiler platform 18 is not available in shader blob e previne texturas magenta/quebradas.
• Preservação de Fidelidade Visual: Ao substituir shaders incompatíveis, copia automaticamente mapas normais (_BumpMap), albedo (_MainTex), emissão de luz (_EmissionMap) e modos de transparência para manter a aparência original do mod intacta.
• Varredura Dinâmica em Tempo de Execução: Intercepta o carregamento assíncrono de AssetBundles e faz varredura de novos monstros e objetos no exato momento em que eles dão spawn no mundo.
• GPU Instancing Universal: Habilita GPU Instancing em todos os materiais de peças de construção e itens, reduzindo drasticamente as draw calls em bases gigantes.
• Fim do Stutter de I/O em Disco: Silencia o redirecionamento de logs de debug excessivos para o Player.log, evitando travamentos causados por escrita pesada em disco.
• Coletor de Lixo (GC) Incremental Calibrado: Ajusta a fatia do Garbage Collector da Unity para 8ms, eliminando congelamentos repentinos de coleta de memória ("Stop-the-World").
• Otimização de Threads da CPU: Balanceia a fila de worker threads da Unity para evitar gargalos de escalonamento em processadores com muitas threads (ex: Intel Xeon / AMD Ryzen).
• Modo Nitidez & Visão Noturna (Night Vision): Pressione F7 para alternar entre visão nítida padrão e o modo de claridade máxima (+75% luz em cavernas e noites). Pressione F8 para telemetria em tempo real no HUD.

---

🇺🇸 English

Key Features

• Global Vulkan Shader Resolver (Platform 18 Fix): Proactively intercepts and converts legacy or DirectX-only shaders (found in popular mods such as MonsterLabZ, Warfare, Valharvest, SouthsilArmor) to native Vulkan-supported shaders on Linux. Permanently cures the infamous Desired shader compiler platform 18 is not available in shader blob spam and stops pink/magenta glitches.
• Visual Fidelity Preservation: When replacing incompatible shaders, automatically transfers normal maps (_BumpMap), albedo (_MainTex), emission (_EmissionMap), and blend modes to maintain full visual detail.
• Dynamic Runtime Scanner: Hooks into asynchronous AssetBundle loading and world spawns (ZNetScene.CreateObject), curing newly spawned creatures and assets on the fly with zero hitching.
• Universal GPU Instancing: Injects GPU Instancing into building pieces and items, substantially cutting draw calls in massive player villages.
• Disk I/O Stutter Elimination: Removes aggressive Unity debug forwarding to Player.log, curing disk write bottlenecks during combat and exploration.
• Tuned Incremental GC: Configures Unity's Garbage Collector slice to 8ms, eliminating abrupt Stop-the-World memory collection freezes.
• Balanced Job Worker Threads: Automatically limits worker threads on high-core CPUs (e.g. Xeon / Ryzen) to prevent thread scheduler contention.
• Enhanced Visual Clarity & Night Vision: Press F7 to toggle between clean daylight post-processing and Night Vision (+75% ambient lighting in crypts/nights). Press F8 to view live in-game engine telemetry.

---

Controls & Hotkeys (Configurable)

Key	Action
F7	Alternar Visão Noturna / Toggle Night Vision Clarity (+75% Exposure)
F8	Exibir Telemetria de Desempenho / Display Live Telemetry HUD

---

Compatibility

• Client-side & Server-friendly: 100% safe to join vanilla and modded dedicated servers.
• Fully compatible with BepInEx 5.4.x and Jotunn.