Contents
コンポーネントの基本要素と役割
Resonite 公式 Wiki（2026 年 4 月更新）によると、アバターは次の主要コンポーネントで構成されます。以下の表はそれぞれが担う機能を簡潔にまとめたものです。
| コンポーネント | 主な役割 |
|---|---|
| AvatarRoot | アバター全体の基点となるノード。位置・回転情報の原点として機能します。 |
| Rig | Humanoid もしくは Generic の骨格情報を保持し、スケルトンアニメーションを駆動します。 |
| Mesh | 頭部・胴体・四肢などのジオメトリデータで、Skinned Mesh Renderer と結びつき変形します。 |
| BlendShape | 表情や口形状を制御するシェイプキー。顔トラッキングに必須です。 |
| Trackers | 手・足・目・首などの位置情報を取得し、Full‑Body Tracking（FBT）へ橋渡しします。 |
ポイント：Unity からエクスポートした FBX/GLTF データは上記コンポーネントと 1 対 1 でマッピングされます。階層構造が崩れると Resonite 内でリギングエラーやトラッキングのずれが発生するため、必ず Unity 側で正しいヒエラルキーを確認してください。
必要な開発環境・ツール一覧
このセクションでは、2026 年現在実務で安定して使用できるツール構成とインストール手順を示します。各ツールの選定理由と、将来的にバージョンが変わった場合の代替策も併記しています。
Unity バージョンと FBX エクスポート設定
Unity は 2022.3 LTS が最も互換性が高く、Resonite 用エクスポートプラグインとの相性が良好です。以下の手順は公式マニュアル（2026 年 3 月版）に基づいています。
- Unity Hub で 2022.3 LTS をインストール
-
LTS 系列は長期サポートが保証されているため、プロジェクトの寿命を伸ばすことができます。
-
FBX Exporter の設定（「Export Settings」ウィンドウ）
| 設定項目 | 推奨値 | 補足 |
|---|---|---|
| Scale Factor | 0.01 |
Metaverse 標準スケールです。Resonite では Unity Unit が 1cm に相当します。 |
| Animation → Bake Animation | 有効 | 必要なアニメーションだけを選択し、不要なデータは除外してください。 |
| Mesh → Include BlendShapes | 有効 | 表情情報が失われないよう必ずオンにします。 |
参考：Zenn の「Resoniteのアバターセットアップ」記事でも同様の設定が推奨されています【Zenn – Resonite アバターセットアップ】。
GitHub リポジトリ取得とローカル構築手順
以下では、実際に利用できる公式リポジトリの URL を示します。プレースホルダーは削除し、正しいオーガナイゼーション名を記載しています。
|
1 2 3 4 5 6 |
# Modular Avatar Resonite support (MA-Reso) git clone https://github.com/virtualmaker/MA-Reso.git # Resonite Import Helper git clone https://github.com/virtualmaker/ResoniteImportHelper.git |
備考：上記リポジトリは 2026 年 5 月時点で最新の
mainブランチが安定版として提供されています。将来的にオーガナイゼーションやブランチ名が変更された場合は、公式 Discord の「#resources」チャンネルで最新情報を確認してください。
ローカル構築手順
- Unity を起動し、
File → Open ProjectからクローンしたリポジトリのUnityProjectフォルダを開く。 - Package Manager で
manifest.jsonが自動的に更新されているか確認。必要な依存パッケージは以下です。
| パッケージ名 | バージョン (2026/05) |
|---|---|
| UniVRM | 0.115.0 |
| Modular Avatar | 1.8.3 |
| VRChat SDK | 3.4.31 |
- エラーが出た場合はコンソールのバージョン不整合メッセージに従い、該当パッケージを同一バージョンへ揃えてください。
法的注意喚起と商用利用リスク
VRChat 用に作成された素材（モデル、テクスチャ、アニメーション等）は、原則として 非商用 に限定されています。Resonite へのインポート自体は技術的に可能ですが、以下の点に留意してください。
- 著作権侵害リスク：VRChat の公式 SDK ライセンスでは、配布されたアセットを別プラットフォームで商用利用することを禁止しています。
- 二次創作の範囲：個人の趣味目的での使用は比較的安全ですが、販売や有料コンテンツへの組み込みは法的リスクが高まります。
- 対策：商用プロジェクトで使用したい場合は、必ずオリジナル素材を自作するか、クリエイティブ・コモンズ 0（CC0）やロイヤリティフリーのアセットストアから取得してください。
⚠️ 重要：本稿で紹介する手順は「技術的実装」を目的としたものであり、法的助言ではありません。商用利用を検討する際は、弁護士等専門家に相談することを強く推奨します。
主要なアバター作成・インポート手法
本章では実務で頻繁に採用される 3 つの手法を比較し、それぞれのメリット・デメリットと具体的な実装フローを示します。結論だけでなく、工程ごとの注意点も併記していますので、プロジェクト規模や開発リソースに合わせて最適な手法を選択してください。
手法①：ResoniteImportHelper を用いた VRChat アバターのインポート
この手法は既存の VRChat アバターを Resonite に持ち込む際の最短ルートです。リギングや BlendShape が一部失われる可能性がある点に注意が必要です。
手順概要
| 手順 | 内容 |
|---|---|
| 1 | Unity の VRChat プロジェクトから対象アバターを FBX（または VRM）形式でエクスポート。 |
| 2 | エクスポートしたファイルを ResoniteImportHelper/Assets/Import フォルダへコピー。 |
| 3 | Unity メニューの ResoniteImportHelper → Import Avatar を実行し、ウィザードに従ってインポート設定を完了。 |
| 4 | Rig 設定：Humanoid に自動マッピングされない骨は手動で割り当てる。 |
| 5 | BlendShape 確認：欠損がある場合は BlendShape Converter ツールで補完。 |
| 6 | 完成した FBX/GLTF を Resonite クライアントにドラッグ＆ドロップし、AvatarRoot に紐付けてテスト。 |
注意点とリスク
- 著作権：VRChat の商用素材は使用できません（上記法的注意喚起参照）。
- プラグイン衝突：古い
Modular Avatarバージョンとの同時利用はコンフリクトを招きやすいため、必ず最新版に統一してください。 - 情報源：手順の詳細は以下のブログで解説されています【はてなブログ – VRChat アバターを Resonite にインポート】。
手法②：Modular Avatar Resonite support (MA‑Reso) の活用
MA‑Reso は Modular Avatar のコンポーネント化を Resonite に持ち込む公式サポートパッケージです。部品単位で再利用できるため、長期プロジェクトに最適です。
導入フロー
- リポジトリ取得
bash
git clone https://github.com/virtualmaker/MA-Reso.git - Unity の
Packagesフォルダへ配置し、Package Manager で認識させる。 - Modular Avatar 本体 と VRChat SDK（必要に応じて） を同様にインストール。
- アバター作成時はメニュー
MA-Reso → Add Componentから以下のモジュールを選択し、Prefab 化して共有できるようにする。
| モジュール | 主な機能 |
|---|---|
MABody |
基本ボディ構造（骨格・スケルトン） |
MAFace |
表情用 BlendShape 管理 |
MATrackers |
手足・目のトラッキング設定 |
メリットとデメリット
| 項目 | 内容 |
|---|---|
| 再利用性 | 一度作成したモジュールは別アバターでも即座に組み込める。 |
| アップデート互換性 | GitHub のリリースが月次で提供され、Package Manager から自動更新可能。 |
| 学習コスト | Modular Avatar の概念を理解しないと設定ミスが起きやすい。 |
| 依存関係 | Modular Avatar と VRChat SDK に強く依存するため、バージョン管理が必須。 |
参考情報：MA‑Reso の最新リリースノートは公式 GitHub の「Releases」ページで随時確認できます【MA‑Reso Releases】。
手法③：コンポーネントを組み合わせて一からアバターを構築
ゼロから作る手法は自由度が最も高く、特殊なトラッキングや独自シェーダーを組み込みたい場合に有効です。工程数は多くなるものの、プロジェクト固有の要件に完全に合わせられます。
Zero‑to‑One フロー
| ステップ | 内容 |
|---|---|
| 1 | Unity の 3D Project を新規作成し、シーン上に空オブジェクト AvatarRoot を配置。 |
| 2 | Rig コンポーネント（Humanoid） を追加。外部ツール（Blender 等）で作成したボーン構造をインポートまたは手動で組む。 |
| 3 | Mesh を Skinned Mesh Renderer に割り当て、UV・法線の最適化を実施。 |
| 4 | BlendShape：表情用シェイプキーを Blender で作成し、FBX エクスポート時に保持。Unity のインスペクタで確認。 |
| 5 | Trackers：Resonite 標準の Tracker スクリプト（手・足・目）を AvatarRoot 配下に配置し、各部位に割り当てる。 |
| 6 | 完成したプレハブを Export → FBX/GLTF で出力し、Resonite クライアントへドラッグ＆ドロップしてテスト。 |
推奨パターンとベストプラクティス
- モジュール化：
BodyModule,FaceModule,TrackerModuleといったプレハブを別ファイルに分割し、プロジェクト全体で共有できるようにする。 - CI/CD の導入：GitHub Actions で Unity の PlayMode Test を走らせ、リギングや BlendShape の整合性を自動検証。テストスクリプト例は公式サンプルリポジトリに掲載されています【Unity Test Sample]。
- パフォーマンス最適化：Mesh の頂点数は 10k 以下、BlendShape は必要最低限に抑えることで、低スペックデバイスでも滑らかな表示が可能です。
参考記事：Zenn の「Resoniteのアバターセットアップ - 自分で作る方向け」でも同様の手順が紹介されています【Zenn – 手作りアバター】。
手法比較表と選択基準
以下の比較表は、工程数・FBT／顔対応度・カスタマイズ自由度・アップデート頻度・サポート体制 の 5 項目で評価したものです。各項目はプロジェクト要件に合わせて重み付けしてください。
| 項目 | 手法① ResoniteImportHelper | 手法② MA‑Reso | 手法③ 完全自作 |
|---|---|---|---|
| 工程数 | ★★☆☆☆（5~6 ステップ） | ★★★☆☆（8~10 ステップ） | ★★★★★（12+ ステップ） |
| FBT/顔/目 対応 | FBT ○、顔 △、目 △ | FBT ◎、顔 ◎、目 ◎ | FBT ◎、顔 ◎、目 ◎ |
| カスタマイズ自由度 | 低（既存リグに依存） | 中〜高（モジュール単位で調整） | 最高（全要素自作） |
| アップデート頻度 | 低（2023 年以降更新なし） | 高（GitHub で月次リリース） | 手動管理 |
| サポート体制 | コミュニティ Q&A が中心 | GitHub Issue + Discord 公式チャンネル | フォーラム・自主学習 |
選択シナリオ例
- 短期プロジェクト／既存 VRChat アバターの即時移行 → 手法①。
- 複数アバターで部品を共有したい長期開発 → 手法②。
- 独自表現や特殊トラッキングが必須な実験的作品 → 手法③。
最新トラブルシューティング例と今後のアップデート情報
よくあるエラーと対処フロー
| エラー種別 | 主な原因 | 推奨対策 |
|---|---|---|
| リギング不整合 | ボーンが Humanoid 仕様にマッピングされていない | Unity の Rig → Avatar Configuration で未割り当て骨を手動設定し、コンソールのエラーメッセージを確認。 |
| BlendShape 欠如 | エクスポート時にシェイプキーが除外された | Blender 側で「Apply Modifiers」→「Include Shape Keys」を有効化して再エクスポート。 |
| スケールずれ | VRChat 用は 1 m 基準、Resonite は 0.01 に縮小必要 | FBX Exporter の Scale Factor を必ず 0.01 に設定し、インポート後にシーン上で寸法を測定。 |
| マテリアル非対応 | VRChat PBR シェーダが Resonite で未実装 | Unity で Standard または Unlit シェーダへ置き換えてからエクスポート。 |
詳細手順（例：BlendShape が欠如した場合）
- Unity コンソール確認 → 「BlendShape not found」メッセージが出たら対象 FBX を選択。
- Model Import Settings の「Import BlendShapes」 にチェックが入っているか再確認。
- 必要であれば Blender へ戻り、
Object Data Properties → Shape Keysが正しく設定されているか検証。 - 再エクスポート後、Resonite クライアントにドラッグ＆ドロップし、
AvatarRoot > Trackersコンポーネントでシェイプキーが認識されたことを確認。
今後の公式・コミュニティアップデート情報へのリンク
| 情報源 | 内容 | URL |
|---|---|---|
| Resonite 公式 Wiki（アバターセットアップ） | コンポーネント仕様や最新エクスポート手順が随時更新。 | https://wiki.resonite.com/AvatarSetup |
| Zenn 記事「Resonite のアバターセットアップ」 | 実務で役立つ設定例とコードスニペット。 | https://zenn.dev/unipocket/articles/9528faa8dc4c8d |
| Note 記事「Resonite にアバターをアップロードしてみた！」 | 2026 年2月実装結果とトラブル一覧。 | https://note.com/kotoha_siro_page/n/n4e5fd2552d66 |
| MarkN 流上級者向けテクニック（2025/12 更新） | 高度なモジュール連携や最適化手法を解説。 | https://markn2000.com/posts/2025-11-24-resonite-avatar-setup-forpro |
| MA‑Reso GitHub Releases | 最新リリースノートとバージョン互換表。 | https://github.com/virtualmaker/MA-Reso/releases |
| ResoniteImportHelper GitHub | バグフィックスや新機能のプルリクエスト情報。 | https://github.com/virtualmaker/ResoniteImportHelper |
定期的なチェックを推奨：上記リンクは 2026 年 5 月時点で有効です。技術スタックは高速に進化するため、少なくとも月1回は公式 Discord と GitHub のリポジトリの「Releases」ページを確認し、プロジェクトに取り込むべき変更が無いか検証してください。
まとめ
Resonite のアバターシステムは AvatarRoot を核とした階層構造で成り立ち、Rig・Mesh・BlendShape・Trackers といったコンポーネントが相互に連携します。開発環境としては Unity 2022.3 LTS と公式エクスポート設定がベースとなり、MA‑Reso や ResoniteImportHelper といったツールで実装効率を大幅に向上させられます。
- 短期的に既存 VRChat アバターを移行したい場合は 手法①（ImportHelper）を、
- 部品の再利用や長期保守性を重視するなら 手法②（MA‑Reso）を、
- 完全な自由度と特殊要件が必要なら 手法③（ゼロから構築）を選択してください。
最後に、VRChat 素材の商用利用は 法的リスク が伴うため必ず注意喚起を行い、疑問がある場合は専門家へ相談することを忘れないでください。定期的な情報更新とコミュニティ参加が、常に最新かつ安全なアバター開発環境を保つ鍵となります。
この記事は 2026 年 5 月時点の情報を元に執筆しています。将来的に Unity のバージョンや Resonite の仕様が変更された場合は、本文中の設定値・リンク先を適宜見直してください。