Official Mods

MODs extend Desktop Homunculus with characters, animations, sound effects, UI panels, and integrations. The following official MODs are maintained as part of the project.

MOD List

MOD	Description	Install
@hmcs/assets	Default VRM character model, VRMA animations, and sound effects	Recommended
@hmcs/elmer	Default character that spawns Elmer with idle, grab, and sitting animations	Recommended
@hmcs/menu	Right-click context menu with a WebView-based HUD overlay	Recommended
@hmcs/character-settings	Per-character settings panel (name, scale, persona, OCEAN traits)	Recommended
@hmcs/settings	Application settings panel (frame rate, shadow opacity) via system tray	Recommended
@hmcs/voicevox	Text-to-speech integration using the VoiceVox engine	Optional

Managing MODs

List installed MODs

hmcs mod list

Example output:

 NAME           VERSION  DESCRIPTION
 @hmcs/elmer    1.0.0    Default character model
 @hmcs/menu     1.0.0    Context menu

Install a MOD

hmcs mod install <package>...

For example, to install the VoiceVox MOD:

hmcs mod install @hmcs/voicevox

Uninstall a MOD

hmcs mod uninstall <package>...

For detailed CLI reference, see hmcs mod.