Install tools / community project

Avatar Loader Autoinstall

Avatar Loader Autoinstall is an archived convenience tool that installs MelonLoader and Custom Avatar Loader on Windows 10 or 11. It is an installer, not a separate avatar mod, and inherits the loader's legacy compatibility limits.

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

Custom Avatar Loader tutorial showing a VRM character in Desktop Mate.
Real loader tutorial context; the installer repository has no separate preview.Original author material
Legacy

Archived installer tool (April 16, 2026)

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

Version
1.1.1
Author
RestartB
Platform
Windows 10/11
Loader
PowerShell or Python EXE
License
GPL-3.0
Published

WHAT IT DOES

Avatar Loader Autoinstall features

The project offers a prebuilt Python EXE and PowerShell scripts. Automated installers make several changes at once and can be harder to audit than a manual ZIP install. The repository is GPL-3.0 and public, but the published EXE is unsigned and the underlying Custom Avatar Loader is archived, so the manual process is the preferred learning path.

  • Automates MelonLoader and Custom Avatar Loader setup.
  • Offers a Windows EXE and inspectable PowerShell/Python source.
  • Targets Windows 10 and Windows 11 only.
  • Keeps the original loader repository as its dependency source.
Custom Avatar Loader tutorial showing a VRM character in Desktop Mate.
Real loader tutorial context; the installer repository has no separate preview.

REQUIREMENTS

Check the stack before installing

  • Platform: Windows 10/11
  • Loader or runtime: PowerShell or Python EXE
  • Release: 1.1.1
  • License: GPL-3.0
  • File: autoinstall-windows.exe (10.4 MB)

How to install Avatar Loader Autoinstall

  1. Prefer the manual Custom Avatar Loader instructions if you want to understand every changed file.
  2. If testing the installer, use Windows 10/11 and back up the Desktop Mate folder first.
  3. Download only from RestartB's original v1.1.1 release.
  4. Scan the EXE and compare the public source before running.
  5. After installation, verify the MelonLoader and mod paths rather than assuming success.

How to use it

  • Run the installer only for a deliberately chosen legacy environment.
  • Read its output and note every destination folder.
  • Test Custom Avatar Loader with a licensed sample VRM, then keep the rollback copy.

Desktop Mate compatibility

The installer repository was archived on April 16, 2026, and the underlying loader is also archived. It does not make Custom Avatar Loader compatible with current Desktop Mate; it only automates the old setup.

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

Use the backed-up installation or manually remove the files installed by MelonLoader and Custom Avatar Loader, then verify Desktop Mate through Steam. Avoid broad deletion of the game directory if you store VRM files there.

Troubleshooting

  • Antivirus warning: do not disable protection. Inspect the source, scan the file, or use the manual method.
  • Installer succeeds but F4 fails: the current Desktop Mate build is probably incompatible with the archived loader.
  • Wrong folder selected: remove the injected files and reinstall Desktop Mate cleanly through Steam.

Avatar Loader Autoinstall FAQ

Is the autoinstaller itself a mod?

It is a setup tool for MelonLoader and Custom Avatar Loader, so the catalog labels it an install tool.

Why not use the one-line PowerShell command?

Piping remote code directly into PowerShell reduces reviewability. Downloading and reading the script first is safer.

Does it support macOS?

No. The author documents Windows 10 and Windows 11 only.

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.