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

インストール

Desktop Homunculus をダウンロードしてインストールします。インストーラーには必要なものがすべて含まれています — エンジン、Node.js ランタイム、hmcs CLI、すべての公式 MOD が自動的にセットアップされます。

システム要件​

macOSWindows
OSmacOS 11（Big Sur）以降Windows 10 以降
CPUApple Silicon または Intelx86_64
ディスク容量600 MB 以上600 MB 以上
ネットワーク初回セットアップ時に必要初回セットアップ時に必要

Desktop Homunculus のインストール​

GitHub Releases ページから最新版をダウンロードしてください。

  1. .pkg ファイルをダウンロード
  2. インストーラーを開いて指示に従う
  3. アプリケーションからアプリを起動

インストーラーは以下を行います：

  • Desktop Homunculus アプリを /Applications にインストール
  • hmcs CLI を PATH に追加（/usr/local/bin/hmcs）
  • すべての公式 MOD を自動検出してインストール
Gatekeeper の警告

macOS で「Desktop Homunculus は開発元が未確認のため開けません」と表示された場合：

  1. システム設定 > プライバシーとセキュリティ を開く
  2. 下にスクロールして このまま開く をクリック
  3. 確認ダイアログで 開く をクリック

インストールの確認​

  1. Desktop Homunculus を起動
  2. システムトレイ（通知領域）にアプリアイコンが表示されるはずです

CLI が利用可能か確認することもできます：

hmcs --version

すべて正常であれば、セットアップ完了です！

次のステップ

基本コンセプトで Persona や MOD について学んでから、クイックスタートガイドに進みましょう。

開発者向け​

Desktop Homunculus の開発や MOD のソースビルドを行う場合は、Cargo 経由で CLI をインストールしてください：

# engine/ ディレクトリから実行
make install-cli

これにより hmcs が ~/.cargo/bin/hmcs にインストールされます。

トラブルシューティング​

hmcs: command not found​

  • macOS: ターミナルを再起動してください。インストーラーは /usr/local/bin/hmcs にシンボリックリンクを作成します。
  • Windows: ターミナルを再起動するか、サインアウトして再度サインインしてください。インストーラーは bin ディレクトリをシステム PATH に追加します。

Gatekeeper にブロックされる（macOS）​

上記のインストール手順を参照して、Gatekeeper を通してアプリを許可してください。

Windows でウィンドウの背景が黒い/不透明​

Windows でウィンドウの背景が透明ではなく黒く表示される場合、設定変更が必要な NVIDIA GPU を使用している可能性があります。上記の NVIDIA GPU セットアップ手順を参照してください。

起動してもキャラクターが表示されない​

セットアップ中に公式 MOD のインストールに失敗した場合（ネットワーク問題など）、手動でインストールしてください：

hmcs mod install @hmcs/assets @hmcs/persona @hmcs/menu @hmcs/settings @hmcs/app-exit

その後、Desktop Homunculus を再起動してください。

MOD のインストールに失敗する​

ネットワーク接続を確認して、もう一度お試しください。MOD のインストールには npm レジストリへのアクセスが必要です。