BettererLethalVRM

BettererLethalVRM

A maintained and optimized VRM mod for Lethal Company, providing a smoother experience!

This is a improved fork of the original BetterLethalVRM by OomJan and Ooseykins.

Replace player models with custom VRMs. This client mod requires some setup to see other players as VRM avatars. This is a tool specifically for Vtuber collabs, not a general-purpose model replacement for Lethal Company. Do not expect this mod to "just work" right away with your model, some edits to toggles and materials might need to be made. There are no models included with this mod; VRoid Studio (on Steam) models are free and fully compatible.

What's New in BettererLethalVRM?

• Model Height & Scale Adjustment: You can now adjust the overall height and scale of your VRM models using the scaleSize config to fit perfectly in-game. The size settings are automatically synchronized across the network to all clients!
• Advanced Facial Animations: Per-model blink and lip-sync settings with automatic VRM expression detection. The mod auto-detects VRM expressions from the model definition. If the model already uses "Blink" or "A" expressions with blendshape bindings, it will automatically use them and ignore manual index settings. Face settings are synced over the network on connect!
• Enhanced Camera & Immersion: Added 360-degree free-look camera support while using the terminal or climbing ladders. You can also automatically hide the first-person helmet when a VRM is active.
• Built-in Compatibility: Actively maintained with structural updates.

Configuration

General Settings

| Key | Default | Description |

|---|---|---|

| scaleSize | 1.0 | Scale size of VRM models, between 0.1 and 1.5. |

Face & Lip Sync Settings

| Key | Default | Description |

|---|---|---|

| BlinkBlendshapeIndex | -1 | Blendshape index for blinking. -1 to disable. Fallback for models without a "Blink" expression. |

| BlinkIntervalMin | 2.0 | Minimum seconds between blinks. Synced over network. |

| BlinkIntervalMax | 6.0 | Maximum seconds between blinks. Synced over network. |

| BlinkDuration | 0.15 | Duration of each blink in seconds. Synced over network. |

| MouthBlendshapeIndex | -1 | Blendshape index for lip sync. -1 to disable. Fallback for models without an "A" expression. |

| LipSyncSensitivitySelf | 2.0 | Mouth sensitivity for your own voice. Local only. |

| LipSyncSensitivityOthers | 2.0 | Mouth sensitivity for other players' voices. Local only. |

Camera & Immersion Settings

| Key | Default | Description |

|---|---|---|

| FreeLookTerminalLadder | true | Allow free camera look while using the terminal or climbing ladders. |

| FreeLookSensitivity | 1.0 | Mouse sensitivity for free look while in terminal or on ladder. 1.0 = default feel. |

| HideHelmetForVRM | true | Hide the default helmet model when a VRM is loaded for the local player. |

VRMs Setup

Browse to your Lethal Company installation (Find the VRM folder by going to your Steam library and right clicking Lethal Company -> Manage -> Browse Local Files.)

Create a folder in your Lethal Company folder called "VRMs" (if it does not exist already) and place your VRM file into that folder. Your VRM can be named using your steamID64 (dec) or your Steam username.

• Example of using the steamID64: 76561197974711290.vrm
• Example of using the Steam username: Zch.vrm

Since it is possible that two users have the same steam name, the Steam ID is preferred before the username. This mod requires you to send your VRM to the other people you're playing with! Make sure you trust the people you are sending your VRM models to!

Fallback Setup

Create a VRM named fallback.vrm and place it into your VRMs folder. Whenever a player joins who has no personal VRM file in your "VRMs" folder, the fallback will be used.

FAQ

Q: Do my friends need the mod to see my avatar?

A: Yes.

Q: My friends have the mod, why can't they see my avatar?

A: The avatars have to be configured on all players clients, with the VRM files named after each appropri