VRM Fixes

Client-side fixes and packaged avatars for EnhancedValheimVRM 1.x.

• Restores VRM 1.0 spring-bone references lost when the loader clones an avatar. Hair and other authored spring chains can animate again.
• Loads named avatars from model packages installed in the current mod-manager profile.
• Keeps each avatar's model and settings together. An explicitly packaged character takes priority over an older manual copy.

Install

Install with dependencies in r2modman or Thunderstore Mod Manager, then fully restart Valheim with Start modded. Install an avatar package such as Neodin-Nordic_Avatars as well.

For a local ZIP, use Settings > Profile > Import local mod. Local import does not download dependencies: install denikson-BepInExPack_Valheim and Rawrtastic-EnhancedValheimVRM 1.x from Online first. Minimum package dependency versions are listed in the manifest.

If you previously installed the manual Enhanced VRM1 Spring Clone Fix 1.0.0, BepInEx selects the newer VRM Fixes because both use the same plugin identifier. Backing up and removing the old DLL is optional cleanup, not an installation requirement. Removing it also prevents the old fix from becoming active if VRM Fixes is disabled.

Behavior

• Install the same avatar packs on every player's client, including the host. This works with locally hosted worlds; this plugin does not add network transfer of avatars.
• Characters are matched by their Valheim character name, not their Steam name.
• Packaged VRM/TXT files stay in the profile. Other manually installed characters continue to use EnhancedValheimVRM's normal lookup.
• Restart the game after installing, updating, enabling or disabling a pack.
• The version gate admits the entire 1.x family, including 1.3.0, and rejects other major versions. Required methods and fields are checked before patching. A future incompatible upstream API can still disable the affected hooks with an error in the BepInEx log; accepting a version number is not a guarantee about future code changes.
• ___Default avatar replacement and in-game generation of outfit files for packaged avatars are outside this release. Existing packaged outfits may be supplied by a pack author.

For avatar-pack authors

Place the following under plugins/ in a standard Thunderstore ZIP:

plugins/
  avatar-pack.json
  models/
    Example.vrm
    settings_Example.txt

{
  "schemaVersion": 1,
  "packId": "YourTeam-YourPackage",
  "avatars": [
    {
      "character": "Example",
      "model": "models/Example.vrm",
      "settings": "models/settings_Example.txt"
    }
  ]
}

Use relative paths confined to the pack. Optional outfits names a matching outfits_Example.txt. Declare Neodin-VRM_Fixes-1.1.2 as a dependency for the 1.x version policy. Existing packs retain the same format. Two packs must not claim the same character name; duplicate claims are rejected instead of selecting an arbitrary winner. Never include game saves or copies of game/Unity libraries.

The runtime source is included in plugins/source. The upstream loader remains a separate dependency. This package is independently maintained by Neodin.

Credits

EnhancedValheimVRM by Midnight Nova / Rawrtastic; BepInEx; Harmony; UniVRM. Fixes and packaging by Neodin.