LethalVRM
Replace player models with custom VRMs
About this mod Author’s original text
Lethal VRM
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.
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!
- Install the mod, launch the game once, and load into the ship. This will generate the VRMs folder in the root of Lethal Company. Text files will be generated with the SteamIDs of you and any player you join a game online with.
- Find the VRM folder by going to your Steam library and right clicking Lethal Company -> Manage -> Browse Local Files.
- Place your VRMs in this folder, named with an ID to match the player whose model should be replaced. For example: 12345678910111213.vrm
- Joining a game with the user who matches that ID will replace their player model with the VRM.
- If something wrong happens check the BepInEx console for errors related to LethalVRM.
- The easiest way to share your model for collab is to name it with your own SteamID before sharing, this way your collab partners won't need to manage and rename the files themselves.
- It can be hard to see if your own model loaded correctly, I suggest spending some time with someone in multiplayer making sure it looks OK before going live in a collab. Many modelling and texturing techniques DO NOT work in this mod, so your model might not look right at all.
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 appropriate ID. It seems more of a hassle than just automatically sending your avatar when you join a server, but there are 2 reasons this doesn't happen.
Most Vtubers try very hard to keep their model files safe, and sending your VRM to another person can be a little scary. Accidentally joining the wrong player would send them a copy of your model, and the inconvenience can be worth the protection. It's important that you trust the players you're playing or collabing with to not share your model around.
The other reason is that some VRM files are very big, and downloading them each time you join a server is a lot of data. Things are just a little simpler this way, if a little inconvenient.
Q: Why are my arms still the default character?
A: This mod only changes the 3rd person model. You will be able to see your own custom model while spectating other players.
Q: My avatar is a plain white texture, how do I fix this?
A: In most cases this seems to be caused by using a non-MToon shader material when exporting the VRM. Make sure all of the materials are MToon. The console log will show an error about this if a material is not MToon. If changing to MToon doesn't fix things, try using the MToon10 shader if available in your version of UniVRM.
Q: My model is very short or very tall, will that break things?
A: Hopefully not. The mod will try and scale your character and position the avatar's head at or near the regular player head height. If your model is scaling very strangely compared to the normal Lethal Company character, feel free to message me about this error! Moving the avatar's head bone (start, not end) in the armature before exporting the VRM can be used to change the avatar scale. If the avatar is appearing too big, move it up; too small move it down.
Q: Something about my model looks weird, bumpy, or wrong, why?
A: Unfortunately this mod requires many hacks and workarounds to make VRM work in Lethal Company. Most material properties from VRM will not carry over very well. This incl
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: