ShadowPerson Material Fix

A lightweight client-side mod that fixes the notorious ShadowPerson material error spam in Valheim 1.0+ (Unity 6).

---

📖 About

After the Valheim 1.0 update (Unity 6), the game's built-in ShadowPerson material still references the old Standard shader, which no longer supports several texture properties:

• _SkinBumpMap
• _ChestTex
• _ChestBumpMap
• _LegsTex
• _LegsBumpMap
• _ChestMetal
• _LegsMetal

Every time the game tries to apply these textures — for example, when ghosts appear in the Deep North biome — Unity floods the log with hundreds of errors, causing stuttering, FPS drops, and even freezes.

This mod fixes the problem at its root: it finds a valid Valheim shader that has all the required properties and swaps it into the ShadowPerson material. Once the shader is replaced, Unity stops throwing errors and performance returns to normal.

---

✨ Features

• ✅ Completely eliminates the ShadowPerson error spam in the log
• ✅ Fixes stuttering and freezes in the Deep North biome
• ✅ Fixes long loading times when travelling through portals
• ✅ Three layers of protection:
  • Renderer.material patch
  • Renderer.materials patch
  • VisEquipment transpiler
• ✅ Does not alter gameplay, damage values, or visuals of any other materials
• ✅ Lightweight — no measurable performance impact
• ✅ Works entirely client-side — compatible with multiplayer

---

🔧 Installation

Recommended: Mod Manager (r2modman / Thunderstore Mod Manager)

1. Click Install with Mod Manager on the Thunderstore page.
2. Launch the game — that's it.

Manual Installation

1. Make sure BepInExPack Valheim is installed.
2. Extract the contents of the .zip into:

   ../Valheim/BepInEx/plugins/
   

3. Launch the game.

---

⚙️ Configuration

No configuration needed — the mod works out of the box.

If you want to verify it's running, look for log messages tagged [ShadowPerson Material Fix] in:

BepInEx/LogOutput.log

---

📋 Requirements

• BepInExPack Valheim — 5.4.2305 or newer
• Valheim 1.0+

---

ℹ️ Known Behavior

On the very first load into a world with active ghosts, you may briefly see a few error lines before the mod's shader swap completes. After that, the log stays clean — this is expected and harmless.

---

🐛 Feedback & Issues

If the mod doesn't work, causes problems while playing, or behaves incorrectly, please report it on GitHub:

👉 https://github.com/nezuma/valheim-shadow-person-material-fix/issues

---

📝 Author's Note

I ran into this problem myself and decided to fix it with the help of a neural network. Based on testing, the mod successfully handles the shader replacement and should fix the error that causes the ShadowPerson-related stutters.

I needed a quick solution that would fix the situation until the developers patch the game — you can use this workaround in the meantime. If the developers release an official fix, you can safely uninstall this mod.

---

🔗 Links

• GitHub: https://github.com/nezuma/valheim-shadow-person-material-fix
• Author: nezuma

---

📜 Changelog

1.1.0

• Initial release
• Fixed ShadowPerson material error spam
• Added three-layer protection (Renderer.material, Renderer.materials, VisEquipment transpiler)