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.
• Corrects Paws of the Bear orientation and left-cuff stretching on Dark Urge and Sigrid with EnhancedValheimVRM 1.3.1. This uses avatar metadata, so all their character-name mappings receive the fix.
• Wardrobe: garments built into an avatar follow the helmet, chest and legs armor you wear, and change with the item's quality level. An avatar can also sink its skin under a shown garment (Mask_<garment> shape keys) so it cannot poke through. Other players with this version see your levels too; a wearer without it is shown at the lowest level.
• Breast physics for Sigrid and Dark Urge: soft, bounded motion when running, jumping, stopping and turning; they swing out a little in strikes, and are firmer under a chest garment.
• Glute physics (second plugin in this package): a small, firm push and return on jumps, landings, stops, turns and strikes, for avatars that carry glute bones (Sigrid and Dark Urge from Nordic Avatars 1.1.5).

Settings

In BepInEx/config, file local.valheim.vrm1springclonefix.cfg:

• [BreastPhysics] Enabled (restart after changing) and Amount (0-1.2).
• [Wardrobe] GiveTestGarments (off by default): gives one item of every garment level the avatar has, once per level and character. It spawns items, so use it for testing only.

File local.valheim.nordicglutephysics.cfg: [GlutePhysics] Enabled, Preset (light, visible, strong; default visible; read when the avatar loads) and Amount (0-1.5, live).

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.
• The Paws correction targets only FistBjornClaw and the Dark Urge / Sigrid models. Other avatars and items retain upstream behavior. This private equipment hook is enabled only on EnhancedValheimVRM 1.3.1; other 1.x versions still receive the existing spring and avatar-pack support.

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, or Neodin-VRM_Fixes-1.1.5 if the avatar has wardrobe garments (Garment_<ItemPrefab>_Q<level> meshes, Mask_<garment> skin shape keys with KeepAllBlendShapes=true in the settings) or glute bones. 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.