Avatars / community project

BepIn Character Swapper

BepIn Character Swapper is an alternative VRM loader built for BepInEx 6 rather than MelonLoader. It scans a local vrm folder and adds model buttons to Desktop Mate's Change Character menu.

Independent fan resource. Not affiliated with, endorsed by, or sponsored by infiniteloop Co., Ltd., Valve/Steam, or any character rights holder.

Desktop Mate character on the desktop with the product interface visible.
Official Desktop Mate screenshot; the repository's Discord preview link has expired.Official product context, not a mod preview
Legacy

Legacy BepInEx release

Built for an older Desktop Mate or loader version. Verify compatibility before using it.

Version
1.0.0
Author
EBro912
Platform
Windows
Loader
BepInEx 6 IL2CPP
License
MIT
Published

WHAT IT DOES

BepIn Character Swapper features

The mod creates or uses steamapps/common/Desktop Mate/vrm and loads the VRM files present at startup. It incorporates modified loader components from Custom Avatar Loader under the original MIT notice. Models added or removed while Desktop Mate is running are not detected until restart, and the original preview was hosted on an expired Discord attachment.

  • Loads all VRM files from a dedicated folder during startup.
  • Adds one Change Character button per detected model.
  • Uses BepInEx 6 IL2CPP instead of MelonLoader.
  • Keeps custom files in a predictable folder outside official DLC.
Desktop Mate character on the desktop with the product interface visible.
Official Desktop Mate screenshot; the repository's Discord preview link has expired.

REQUIREMENTS

Check the stack before installing

  • Platform: Windows
  • Loader or runtime: BepInEx 6 IL2CPP
  • Release: 1.0.0
  • License: MIT
  • File: BepInCharacterSwapper.dll (13 KB)

How to install BepIn Character Swapper

  1. Back up the Desktop Mate folder and confirm you understand this legacy setup.
  2. Download the documented BepInEx 6 Unity IL2CPP Windows x64 build from BepInEx.
  3. Extract BepInEx into steamapps/common/Desktop Mate.
  4. Download BepInCharacterSwapper.dll from the original GitHub release and place it in BepInEx/plugins.
  5. Create a vrm folder beside DesktopMate.exe and put only models you are licensed to use inside.
  6. Restart Desktop Mate after adding or removing models.

How to use it

  • Right-click the active character and open Change Character.
  • Choose the button whose label matches the VRM filename.
  • Restart the app whenever the contents of the vrm folder change.

Desktop Mate compatibility

The project has one January 2025 release and no current-build support statement. It depends on a specific bleeding-edge BepInEx 6 IL2CPP build; mixing it with MelonLoader mods is not documented.

Official Desktop Mate screenshot showing a character interacting with a desktop window.
Official product context: app updates can change the window and character behavior that mods depend on.

How to remove the mod

Delete the swapper DLL from BepInEx/plugins. Move your VRM files out of the vrm folder, then remove BepInEx only if no other plugin depends on it.

Troubleshooting

  • No model buttons: confirm VRM files are in the root vrm folder before startup.
  • Console log spam: the author suggests setting UnityLogListening=false in BepInEx/config/BepInEx.cfg.
  • App no longer starts: remove the plugin first, then test BepInEx and Desktop Mate separately.

BepIn Character Swapper FAQ

How is this different from Custom Avatar Loader?

It uses BepInEx and preloads a vrm folder, while the original loader uses MelonLoader and an F4 file picker.

Can models be added while Desktop Mate is open?

No. The documented release requires a restart to rescan added or removed VRM files.

Why is the page using an official screenshot?

The author's preview was an expiring Discord attachment and is no longer a reliable real asset.

Sources and verification

Page checked against the linked project material on 2026-07-22. Compatibility can change after Desktop Mate, MelonLoader, BepInEx, or the mod updates.

RELATED PROJECTS

Compare similar Desktop Mate mods