HeadbangVRM

DAW上で動作するVST3プラグイン。MIDIキックドラムのタイミングに合わせて、VRMアバターがヘドバンします。

プラグインのダウンロード

HeadbangVRM v1.0.1 (Windows x64)

動作要件

• OS: Windows 10 以降（x64）
• DAW: VST3対応のDAW（Cubase / Studio One / FL Studio / Ableton Live / Reaper / Bitwig 等）
• ランタイム: Microsoft Edge WebView2 Runtime
  • Windows 11 には標準搭載

インストール（バイナリ配布版）

1. HeadbangVRM_Setup_x.x.x.exe を実行
2. 指示に従ってインストール（管理者権限が必要）
3. DAWでVST3プラグインをスキャン → HeadbangVRM を読み込む

インストール先: C:\Program Files\Common Files\VST3\HeadbangVRM.vst3

ビルドから始める場合

必要なもの

ツール	バージョン	備考
Visual Studio Build Tools 2022	最新	C++デスクトップ開発、MSVC v143、Windows SDK
CMake	3.25以降	インストール時にPATHへ追加
Git	任意
Node.js	v20以降
pnpm	任意	npm install -g pnpm
iPlug2	最新	C:\Dev\iPlug2 に配置（後述）

1. iPlug2の準備

mkdir C:\Dev
cd C:\Dev
git clone https://github.com/iPlug2/iPlug2.git

iPlug2の依存物（VST3 SDK、WebView2 SDKなど）を C:\Dev\iPlug2\Dependencies に配置してください。
詳細は docs/01_環境構築.md を参照してください。

2. リポジトリのクローン

git clone <this-repo> HeadbangVRM
cd HeadbangVRM

3. フロントエンドの依存パッケージをインストール

cd project\resources\web
pnpm install

npmを使う場合:

npm install

4. CMakeでビルド構成を生成

cd <repo-root>
cmake -B build -DCMAKE_BUILD_TYPE=Release -DIPLUG2_DIR=C:\Dev\iPlug2

5. ビルド

cmake --build build --config Release

または Visual Studio のソリューション build\HeadbangVRM.slnx を開いて Release ビルド。

ビルド成果物: build\out\HeadbangVRM.vst3

ビルド時にフロントエンドのビルド（pnpm run build）とVST3バンドルへのアセットコピーが自動実行されます。

フロントエンドのみ再ビルドする場合

cd project\resources\web
pnpm run build

またはプロジェクトルートの project\build_web.bat を実行。

使い方

1. DAWのインストゥルメントまたはエフェクトとして HeadbangVRM を挿入
2. MIDIキックをプラグインに送る（デフォルトのキックノート番号: 36）
3. DAWを再生するとVRMアバターが動き始めます

VRMモデルの差し替え

プラグインUIのファイル選択ボタンから任意の .vrm ファイルを読み込めます。

VRMAモーションの差し替え

任意の .vrma ファイルを読み込むと、アイドルモーションを置き換えられます。

ライセンス

プラグイン本体は独自商用EULAで配布しています。同梱の LICENSE.txt を参照してください。

使用ライブラリ:

• iPlug2 — MIT License
• Three.js — MIT License
• @pixiv/three-vrm — MIT License
• VST3 SDK — MIT License