BoneMod — Valheim 1.0 Compatibility Fix

A small compatibility update for BoneMod, originally created by an0nymooose.

All credit for BoneMod, its design, and its original implementation belongs to an0nymooose. This release only updates the existing mod so it works with Valheim 1.0.

BoneMod lets you change the scale of individual character bones with in-game chat commands. Character proportions are saved locally and can be synchronized so other players running BoneMod can see them in multiplayer.

Valheim 1.0 compatibility fixes

• Updated the chat hook for Valheim 1.0's UserInfo sender data.
• Updated HUD/message calls for the current Character.Message signature.
• Fixed map pings by allowing empty/non-BoneMod chat packets to pass through untouched.
• Limited BoneMod command parsing to messages beginning with !bm.
• Preserved the original command syntax, save data format, configuration behavior, and multiplayer synchronization.

Installation

Thunderstore / r2modman / Gale

Install the package normally with your preferred Thunderstore-compatible mod manager. The required Valheim BepInEx package is declared as a dependency.

Manual

1. Install BepInExPack for Valheim.
2. Copy BoneMod.dll into Valheim/BepInEx/plugins/.
3. Remove any older BoneMod DLL before launching the game.

Commands

Open Valheim chat and use the following commands.

Scale a body part

!bm bodypart x y z

Example:

!bm head 2 1 2

To use the same scale on all three axes, provide only one number:

!bm head 1.25

Other commands

• !bmreset — Reset your character's scaled bones.
• !bmstop — Stop sending your bone scaling data to other BoneMod clients.
• !bmstart — Resume bone scaling synchronization.
• !bmclearsave — Clear saved BoneMod character data and reset your character.
• !bmhelp — Display BoneMod command help and available bones.

Available bones

jaw
head
chest
neck
spine
hips
lefthand
righthand
leftfoot
rightfoot
leftleg
rightleg
leftarm
rightarm

Groups

arms
legs
feet
hands

Multiplayer

Every player who wants to see custom character proportions should have BoneMod installed.

Bone scaling data is synchronized between BoneMod clients. Changes made to a nearby player can appear immediately, while synchronization for players elsewhere may take a few seconds.

Save data

BoneMod stores character bone data locally and reapplies it when the character is loaded again. Saved data can be cleared in-game with !bmclearsave.

Credits

Original author: an0nymooose
Original BoneMod page: https://www.nexusmods.com/valheim/mods/326
Valheim 1.0 package: compatibility fix only.

Changelog

1.0.2

• Fixed an intermittent NullReferenceException when joining or disconnecting from a server before the local player object had been created.
• BoneMod now skips save attempts when Player.m_localPlayer is unavailable.
• Normal character save behavior remains unchanged once the player has loaded.

1.0.1

• Updated BoneMod for the Valheim 1.0 release.
• Updated Chat.OnNewChatMessage compatibility for the current UserInfo sender argument.
• Updated Character.Message calls for the current five-argument signature.
• Fixed Valheim map pings being interrupted by BoneMod's chat hook.
• Restricted BoneMod chat parsing to !bm commands so unrelated chat traffic passes through normally.
• Preserved the original save format, command syntax, configuration behavior, and multiplayer bone synchronization.