SANDBOX — this is a test environment. No servers are actually deployed and no real payments are charged.
Source-checkedWorld generation

ShadowPersonMaterialFix

by rimworld · for Valheim

Fixes the ShadowPerson material error spam, stuttering and freezes in the Deep North biome (Valheim 1.0+ / Unity 6). Client-side, no config needed.

26Downloads
33d agoLast updated
BepInExLoaders
ThunderstoreSource

About ShadowPersonMaterialFix

From Thunderstore

Fixes the ShadowPerson material error spam, stuttering and freezes in the Deep North biome (Valheim 1.0+ / Unity 6). Client-side, no config needed.

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/
  1. 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)

Highlights

From source data

Loaders

Runs on BepInEx.

Footprint

Rated a light load on a server.

Last update

Its author last shipped an update 33d ago.

ShadowPersonMaterialFix on Nxeon

From our catalogue
One-click install
Supported on Nxeon Valheim servers, for BepInEx servers. We download it from Thunderstore, place it, and restart the server.
Server type needed
BepInEx
Server load
light
Smallest plan we suggest
Valheim — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
Latest build
1.1.0, released 2026-10-20

Game versions by loader

LoaderGame versionsNewest
BepInEx

From 1 recorded build of ShadowPersonMaterialFix.

Dependencies

Declared by the newest build that lists any. Required ones are installed with it on one-click installs.

Run ShadowPersonMaterialFix on a Valheim server

Pick a server or deploy a new one above; it is installed in one click.

What kind of mod it is

From the catalog
Listed on Thunderstore as “Content”

World generation

Changes or adds to how new terrain, biomes and structures are created.

Compatibility

Game
Valheim
Loaders
BepInEx
Requires
One-click install needs a BepInEx server.

Verified at the source

  • ✓ThunderstoreOfficial listing, checked 2026-10-20Open ↗
  • ✓Authorrimworld, as published on Thunderstore
  • ✓LicenseNot published by the sourceFree

ShadowPersonMaterialFix, answered

Generated from the mod’s own source data.

Which loaders does it support?

BepInEx.

Is it free?

Yes. ShadowPersonMaterialFix is free to download from Thunderstore.

How do I add it to my Nxeon server?

Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

NxLabs

Run ShadowPersonMaterialFix on a Valheim server.

Deploy in about a minute from $6.50 a month, then add ShadowPersonMaterialFix in one click.