v3.4.1
- Deep North (1.0.7) Release
v3.3.0
- New code for Jotunn's MinimapCompose (fixes Map Overlays like used by Star Level Systems).
v3.2.4
- New shader code for MagicalMounts.
v3.2.0
- Improved automation for fewer rules.
- Updated txt files on my discord.
v3.1.0
- Brand new logic, Vanilla cache and protection.
- Changes too numerous to list.
v2.0.0
New: Per-mod txt configuration files
- Each mod now gets its own
.txt file in BepInEx/config/ShaderHelperForMac/ with section-based rules
- Sections:
[forcefallback], [forcetransparent], [fallback], [transparent], [original], [default]
[forcefallback] and [forcetransparent] handle shaders that report isSupported=true but still render pink on Metalmat:MaterialName and suffix:_name rules let you target specific materials without affecting the whole mod- Global BepInEx config prefix entries remain supported for backwards compatibility
New: shaderhelper initmod command
- Auto-generates a starter txt file for a mod from what the plugin has already observed in-game
- Includes confirmed replacements, suspected problem shaders (commented out), and suffix groupings
- Use
shaderhelper initmod <DllName> force to regenerate an existing file
New: shaderhelper nearby command
- Logs all materials on renderers within a configurable radius of the player
- Shows shader name, support status, action, and DLL attribution
- Supports
mod filter (hides vanilla shaders) and DLL name filter
- Scans
CanvasRenderer objects (TextMeshPro/UI elements) in addition to standard renderers
New: shaderhelper reload command
- Reloads all config files without triggering a full sweep
New: shaderhelper loaded command
- Scans all materials in memory, including prefab assets not yet placed in the scene
- Accepts an optional DLL name filter
Sweep improvements
shaderhelper sweep always reloads config files before sweeping (fixes macOS FileSystemWatcher reliability issues)- Sweep triggered by the console command now shows a center-screen HUD notification when complete
New Harmony patches
DungeonGenerator.GenerateDungeon postfix — sweeps after dungeon rooms are instantiated on zone loadVisEquipment.AttachItem postfix — sweeps immediately when weapons/armour/items are equippedAssetBundle.LoadAsset postfix — intercepts materials the moment a bundle is loaded, eliminating first-frame pink flicker
Shader fixes
TextMeshPro/Distance Field (Surface) — swapped to the non-Surface variant at runtime; fixes pink text on noticeboards and signsHidden/InternalErrorShader — now correctly receives the fallback shader instead of being left unchanged
Bug fixes
- Explicit
mat: rules now correctly override the _forceReplacedMaterialIds guard (fixes cases where a material couldn't be moved between transparent and fallback)
- initmod no longer emits suffix rules for materials using canonical Valheim shaders (e.g.
draugr_eyes_elite)
- initmod no longer emits entries in
[fallback]/[transparent] for shaders covered by built-in defaults (e.g. Legacy Shaders/Particles/)
shaderhelper nearby uses transform.position instead of bounds.center — fixes incorrect distances for TextMeshPro sub-mesh renderers whose bounds are uninitialized
Configuration changes
Default All Transparent now defaults to false — mods must be explicitly configured- Removed
Mod Enabled toggle (shader replacements are in-memory and cannot be undone without a restart)
- Config entries renamed for clarity:
Default All Transparent, Force Transparent Shader Prefixes, Force Fallback Shader Prefixes, Periodic Sweep Interval
- Assembly version updated to
2.0.0
v1.2.0
- Sweep interval made configurable via BepInEx config
- Periodic sweep skips when no local player is present (main menu, loading screen)
v1.1.0
- Added
usefallbackshader.txt — replaces broken shaders with a solid visible placeholder instead of making objects invisible
- Added
shaderhelper scan and shaderhelper dumpmod console commands
- ZNetScene.Awake postfix patch — catches Jotunn mod prefabs registered after startup sweep
v1.0.1
- Additional logic analysis to capture pinks
