Confirm with your password

MetalShaderFix

MAC ONLY (Apple M-series): does nothing on Windows/Linux. Fixes pink cubes and flat, opaque or pale materials from mods whose shaders have no Metal version.

Client-only

· MIT license

Stars
1
Downloads
2
Version
0.6.1
Updated
Author
Lemuria
Virus scan
✓ Scan successful
Runs on
Client-only

Description

MetalShaderFix

For Macs with Apple M-series chips only. On Windows, Linux or Steam Deck it switches itself off and does nothing, so only the Mac players in your group need it.

What it fixes

Many mods ship asset bundles built only for Windows, so their shaders have no Metal version. On a Mac their materials then render as pink cubes, or as flat, opaque, pale shapes (particles, smoke, fire, creatures).

This plugin finds those shaders at runtime, for any mod, and points their materials at:

  1. a Metal port from its own bundle (metalshaderfix_shaders, installed next to the DLL): rune decals, particle shaders;
  2. otherwise the game's working shader with the same name (or a known alias);
  3. otherwise a generic stand-in built from the material's own textures and colours, or it hides helper/screen-effect materials.

When a mod looks a shader up by name (Shader.Find) and Unity hands it another mod's broken copy, the plugin returns the working shader of that name instead (config RedirectShaderFind). Natural Rivers, for example, then gets the particle shader it asks for for its foam instead of falling back to Sprites/Default.

Install (Mac only)

Install the package with your mod manager, or copy plugins/MetalShaderFix.dll and plugins/metalshaderfix_shaders together into one folder under BepInEx/plugins/. The two files must be in the same folder.

Client-side only: it changes nothing in the world or in saves, and other players don't need it.

Diagnostics

BepInEx/MetalShaderFix_report.txt lists every broken shader found and what was done with each material.

Changelog

  • 0.6.1: Shader.Find returns the working shader instead of a broken mod copy of the same name.
  • 0.6.0: first packaged release.

Files

5 files · 54 KB download

Loading files…

Manual installation instructions
1

Install BepInExPack Valheim

BepInExPack Valheim is required to run mods in Valheim.

Download BepInExPack Valheim 5.4.2360 · View mod page

Check out the mod page for detailed installation instructions.

2

Install MetalShaderFix

This mod only needs to be installed on the client.

Download MetalShaderFix 0.6.1

Extract the ZIP and place the file(s) into the BepInEx/plugins/ folder inside your Valheim game folder.