メインコンテンツまでスキップ

クイックスタート

始める前に

インストールガイドを完了していることを確認してください。Desktop Homunculus と公式 MOD がインストールされ、アプリが起動している必要があります。

キャラクターとの出会い​

公式 MOD がインストールされた状態で Desktop Homunculus を起動すると、デスクトップに Elmer が表示されます。Elmer はデフォルトのキャラクターで、他のアプリケーションの上に浮かぶ透明ウィンドウ内にレンダリングされる VRM 3D モデルです。

Elmer には @hmcs/elmer と @hmcs/assets MOD によるアニメーションと動作が組み込まれています。キャラクターはアイドル状態になり、掴まれると反応し、カーソルを追従します。

キャラクターとのインタラクション​

ドラッグ＆移動​

キャラクターをクリックしてドラッグすると、デスクトップ上の好きな位置に移動できます。ドラッグ中、Elmer は「掴まれた」アニメーションに切り替わります。離すと新しい位置にキャラクターが配置されます。

キャラクターの状態​

キャラクターはさまざまな状態に応じて、それぞれのアニメーションで反応します：

状態トリガーアニメーション
アイドルデフォルト状態手を組んで立つアイドルモーション、目がカーソルを追従
掴まれたキャラクターをクリック＆ドラッグ移動中のリアクションポーズ
座りウィンドウの端にキャラクターをドロップ座ったアイドルループ

コンテキストメニュー​

キャラクターを右クリックすると、コンテキストメニューオーバーレイが開きます。ここから設定や、インストール済み MOD が提供するその他のアクションにアクセスできます。

設定​

右クリックのコンテキストメニューから設定パネルを開きます。設定 UI では、アプリケーションや MOD 固有のオプションを構成できます。

公式 MOD の紹介​

Desktop Homunculus には @hmcs スコープ配下の公式 MOD セットが同梱されています：

MOD説明
@hmcs/elmerデフォルトキャラクター（Elmer）を制御 — キャラクターの生成、アニメーションとカーソル追従の管理
@hmcs/assetsデフォルトの VRMA アニメーション（idle-maid、grabbed、idle-sitting）と効果音
@hmcs/character-settingsコンテキストメニューからアクセスできるキャラクターごとの設定パネル
@hmcs/settingsシステムトレイからアクセスできるアプリケーション設定パネル
@hmcs/menu右クリックのコンテキストメニューオーバーレイ

追加 MOD​

オプションの MOD で Desktop Homunculus を拡張できます。CLI を使っていつでもインストールできます：

MOD説明
@hmcs/voicevoxVoiceVox エンジンを使用した音声合成連携
VoiceVox のセットアップ

@hmcs/voicevox MOD を使用するには、VoiceVox エンジンを別途インストールして起動しておく必要があります。インストール方法は VoiceVox の Web サイトをご覧ください。

hmcs mod install @hmcs/voicevox

次のステップ​