Avatars / community project

Custom Avatar Loader C++

Name: Custom Avatar Loader C++
Author: Kimjio

Custom Avatar Loader C++ is a native port of YusufOzmen01's loader. Its documentation is unusually specific: version 1.0.1 supports Desktop Mate 1.1.1 only.

Open archived release file Original repository

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

Real Custom Avatar Loader tutorial context; this C++ port follows the original loader's usage.Original author material

Known broken

Desktop Mate 1.1.1 only

The author or project documentation says it does not work with the current app.

Version: 1.0.1
Author: Kimjio
Platform: Windows
Loader: Native version.dll
License: MIT
Published: 2025-02-18

WHAT IT DOES

Custom Avatar Loader C++ features

Unlike the MelonLoader original, the port uses a native version.dll placed beside the Desktop Mate executable. This loading method is convenient but sensitive to application version and DLL search behavior. The repository points users back to the original loader's F4 workflow and optionally exposes a console through a launch argument.

Native C++ port of the original Custom Avatar Loader.
Single version.dll deployment in the Desktop Mate folder.
Uses the original F4 model-selection workflow.
Optional --console launch argument for diagnostics.

Real Custom Avatar Loader tutorial context; this C++ port follows the original loader's usage.

REQUIREMENTS

Check the stack before installing

Platform: Windows
Loader or runtime: Native version.dll
Release: 1.0.1
License: MIT
File: version.dll (134 KB)

How to install Custom Avatar Loader C++

Confirm the target is Desktop Mate 1.1.1; the author does not claim other versions.
Back up the complete installation folder.
Download version.dll from the original GitHub 1.0.1 release.
Place version.dll directly beside DesktopMate.exe.
Launch and use the original loader's F4 workflow.

How to use it

Press F4 after the character becomes interactive.
Select a licensed local VRM model.
Add --console to Steam launch options only while collecting diagnostics.

Desktop Mate compatibility

The author states that only Desktop Mate 1.1.1 is supported. That makes the release incompatible with current automatic Steam updates unless independently updated by its maintainer.

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

Close Desktop Mate and remove only the version.dll added by this mod. Be careful not to delete an unrelated system or application DLL from another folder. Verify Steam files afterward.

Troubleshooting

App closes immediately: remove version.dll and confirm the exact Desktop Mate version.
F4 does nothing: the native hook probably did not load or the app version is unsupported.
Need logs: temporarily add --console, reproduce once, then remove the launch option.

Custom Avatar Loader C++ FAQ

Does the C++ port require MelonLoader?

Its documented installation uses version.dll directly and does not list MelonLoader.

Does it support the latest Desktop Mate?

No such claim is made; the README explicitly says Desktop Mate 1.1.1 only.

Is it the same author as the original loader?

No. Kimjio created the C++ port and credits YusufOzmen01's original project.

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