VRM4U

English Doc

はじめに

VRM4UはUnrealEngine5(UE5, UE4)で動作する、VRMファイルのインポーターです。

使い方は こちらのページにあります

開発・サポートは @はるべえ が個人で対応しています。そのためレスポンスが遅いことがあります。

特徴

||| |----|----| ||| |||

• VRMファイルをインポートできます。
• アニメーション
  • 骨、Morphtarget・BlendShapeGroup、揺れ骨・コリジョン などが生成されます。
  • 揺れ骨の挙動はVRMSpringBoneかPhysicsAssetを選択できます。
  • Humanoid用のRIGが生成されるので、アニメーションを手軽にリターゲット可能です。
• マテリアル
  • MToonを再現したマテリアル。影色の指定や、アウトラインの色・太さ調整、MatCapなど一通り適用されます。
  • 既存のPBR背景の中にキャラクタを描画できます。ポストプロセスを利用しません。
• モバイル
  • BoneMapリダクションを使うことで、公式のUE4エディタからモバイルでSkeletalMeshを利用できます。
  • 描画はForward/Deferred両方に対応しています。

動作環境

• UE5.4〜5.0, UE4.27〜UE4.20
• Windows
• Mac(要プロジェクトビルド)
• mobile(Android, iOS)
• UE4.19も動きますが、マテリアルは生成されません。

使い方

• releasesより利用するバージョンのプラグインをダウンロードし、「.uproject」とおなじ場所に「Plugins」フォルダを展開、以下のように配置ください

 + MyProject
   - MyProject.uproject
   - Plugins
     - VRM4U
       - VRM4U.uplugin

サンプルマップ

• VRM4UContent/Maps/VRM4U_sample.umap
• ContentBrowserに表示されない場合は、以下の項目を確認ください。

使い方

• VRMファイルをドラッグ＆ドロップしてください

|| |----| || | https://www.youtube.com/watch?v=Qlz0bUSLjss|

仕組み

詳しく知りたい方はこちら

https://ruyo.github.io/VRM4U/10_detail/

作った人

@ruyo_h

ライセンス

||| |----|----| |MIT|VRM4U| |MIT|RapidJSON| |3-clause BSD-License|assimp(orig), assimp(vrm4u fork)|

ソースが必要なケース＆入手方法

• Windows向け
  • 特別な操作は不要です。zipを展開 or このリポジトリをクローンして利用ください。(assimpはビルド済のlibが入っています)
• Mac向け
  • カスタム版assimpのソース取得＆ビルドが必要です
• モバイル向け
  • 一般的な利用方法であれば、特別な操作は不要です。
  • ランタイムロードを利用する場合は カスタム版assimpのソース取得＆ビルドが必要です。

カスタム版assimpはこちらより入手ください

• 2023/11以前のプラグインを利用する場合
  • こちらより昔のソースを取得ください https://github.com/ruyo/UnrealEngine_VRM4UPlugin
  • （404エラーページが出る場合はこちらより紐付けをしてください）

開発支援

VRM4Uの開発を支援したい という奇特な方はこちらからどうぞ

公開の体裁を含め 多くの方の情報を参考にさせて頂いています。
ありがとうございます。

リリース履歴

• 2026/02/19
  • AndroidのPKG作成でエラーが出るのを対処
• 2026/02/14
  • 画面キャプチャの対象を、ゲーム画面のみにした
  • 対象モデルを2パス描画する仕組みを追加
  • SceneViewExtensionの登録タイミングを変更、lyraに導入するとクラッシュするのを修正
• 2026/01/01
  • 法線補正の方法を変更、デフォルト値を調整した
  • IKRigの設定をUE5.7に合わせた
  • サムネイルに文字が表示されないのを修正
  • Linuxビルドエラーを修正
• 2025/11/13
  • マテリアル一括生成ツールを追加
  • VRM Validationをランタイム時も有効化
• 2025/10/25
  • 自動生成したUE4マネキンのIKRigがうまく動作しないことがあるのを修正
  • VRM Validataion追加
• 2025/10/16
  • ポーズと同名のMorphがある場合、ポーズを追加しないよう修正
  • UE5.7でインポートしたモデルが開けないのを修正
• 2025/09/25
  • UE5.7previewのバイナリを追加した
  • ZOffsetについて、DepthとShadowを使い分けできるようにした
• 2025/09/21
  • SpecularTextureに対応した
  • ファイルによって、インポートでクラッシュが発生することがあるのを修正
• 2025/08/29
  • ファイルによって、インポートでクラッシュや不正書き込みが発生することがあるのを修正
  • VRM1の判定がうまくいかないことがあるのを修正
  • assimp 6.0.2に更新
• 2025/08/14
  • テクスチャ設定を省略したVRMの読み込みでクラッシュするのを修正
• 2025/08/13
  • VRoidStudio VRM1.0 のモデルを正しく読み込めなかったのを修正
  • パラメータを省略したVRMファイルでクラッシュするのを修正
  • Valkan SM6でクラッシュするのを修正
  • フィルタ有効時、ウインドウサイズ変更でクラッシュするのを修正
  • リムライトフィルタを追加
  • マテリアルのプレフィクスを M_ から MI_ に変更
• 2025/07/14
  • インポート後のUV座標が1以上になっていたのを修正した
  • MACでのビルドでエラーが出るのを修正した
  • Game起動時にPythonのエラーが出るのを修正した
• 2025/06/16
  • PKG作成に失敗するのを修正
• 2025/06/14
  • UE5.6にて マネキンのIKRigが無い場合にIKRigを生成するようにした
• 2025/06/04
  • UE5.6のバイナリを追加
  • インポート時にRetargeterを生成しないオプションを追加
• 2025/05/14
  • UE5.6Previewのバイナリを追加
• 2025/05/05
  • UE4マネキン用のRetargeterを追加
  • BVHインポート時、ダミーのRootBoneを追加した
  • PathTracingでモデルが真っ黒になってしまうのを対処
  • FilmicTonemap打消し率をマテリアルで制御できるようにした
  • VRM1のNormalMapをうまく処理できていなかったのを修正
• 2025/03/08
  • サンプルマップがクラッシュするのを修正
  • CustomAnisoパラメータを整頓
• 2025/02/06
  • アウトラインの太さが解像度に影響されるのを修正
  • MorphTarget名が特定の日本語の時 クラッシュするのを修正
  • UE5.5でマテリアルを切り替えた場合にクラッシュするのを修正
  • UE5.5でアセットを開いたままリインポートするとクラッシュするのを修正
  • VRM10: BindPoseの補正を無効化するオプションを追加
  • VRM10: Root骨の回転を初期化
  • VRM10: PhysicsAssetを生成できるようにした
• 2025/01/03
  • アウトラインが非表示になってしまうのを修正
  • UE5.5でインポート時にクラッシュすることがあるのをもう一度修正
  • 送信アプリによってVMCプロトコルを受信できないことがあるのを修正、姿勢を強制的に更新するオプションを追加
  • assimp更新5.4.3
• 2024/12/27
  • UE5.5でインポート時にクラッシュすることがあるのをさらに修正
• 2024/12/13
  • UE5.5でインポート時にクラッシュすることがあるのを修正
• 2024/12/06
  • メニューからEditorUtilityWidgetを呼び出せるようにした
  • モーフ制御用 汎用ControlRigを追加
  • VRM1: 揺れ骨計算を修正
• 2024/11/13
  • UE5.5リリース版に対応
• 2024/11/10
  • VrmAssetListがCook対象になるよう、Skeletalmeshからの参照を追加
  • Skeleton指定でインポートした際にクラッシュするのを修正
  • ランタイムロード時に複数のモデルのアセットが混ざってしまうことがるのを修正
  • VRM1: 反映されないマテリアルパラメータがあるのを修正（TwoSided, Matcap, Translucent）
  • VRM1: Retargeterに親指が一部欠けているのを修正
• 2024/10/07
  • Androidのcookエラーを修正
  • VMC受信アドレスの初期値をANYに変更
  • PKG起動時、PostProcessAnimBPのPoseのSearchが効かないのを修正
  • DropActorに同期読みオプションを追加
• 2024/10/02
  • UE5.5preview を追加
  • UE5マテリアルでSSSとLitが未設定なのを修正
• 2024/08/23
  • PKGからのランタイムロードでMorphが動かないのを修正
  • SSSProfile時、SSSのOpacityを変更できなかったのを修正
• 2024/07/28
  • マテリアルが不要なテクスチャ参照しているのを修正
  • PostToonサンプルがクラッシュするのを修正
  • UE5.4のPKGでランタイムロードがクラッシュするのを修正
• 2024/06/17
  • UEFNのMannequinに対応するIKRig, IKRetargeterを生成するようにした
  • VRM0のコリジョンがずれているのを修正
  • VRMSpringBoneのデバッグ表示がずれているのを修正
• 2024/06/06
  • MToonAttachActorが動作しなくなっていたのを修正
  • BVHアニメーションの座標がずれてしまうのを修正
  • PKG作成時にエラーが出ることがあるのを修正
• 2024/05/30
  • 注意）現バージョンより、デフォルトマテリアルをUE5ベースにします。エディタの安定性のためです。従来のものを利用する場合はインポートオプションで切り替えください。
  • 注意）現バージョンより、PrimitiveマージをデフォルトOFFにします。見た目のカスタマイズ性を担保するためです。負荷を考慮する場合はインポートオプションで切り替えください。
  • assimp更新。v5.4.1
  • Diffusionフィルタにクロス効果を追加
  • VMCプロトコルを複数ポート同時に受けられるようにした
• 2024/05/16
  • Diffusionフィルタを追加
  • ControlRigでRoot骨がベイクできないのを対処
  • VMCプロトコルでパーフェクトシンクが動作しないのを修正
  • VMCプロトコルをシーケンサーで記録した際、余計なカーブが残るのを修正
• 2024/05/07
  • VMCプロトコルのRoot姿勢が反映されていなかったのを修正
  • ue4mannequinのSkeletonについて、root骨を小文字に変更
• 2024/05/06
  • AnimNodeでVMCプロトコルを受け取れるようにした
  • VRM10: BlendShapeGroupが正しく取得できないのを修正した
• 2024/05/03
  • UE5.4.1のバイナリを追加した
  • PostAnimBPにBlendShape用ポーズをセットした
  • VRMSpringBoneのプレビューを修正した。1フレーム目の計算が間違っているのを修正した
• 2024/04/24
  • 注意）現バージョンより、VRM1.0のモデルはRoot骨のZ軸回転値が90度→0度に変わります。同時にローカル軸の回転値も変わります。VRM1.0のモデルはインポートしなおしてご利用ください
  • UE5.4正式版に対応した
  • アウトライン専用のコンポーネント BP_VrmOutlineComponentを追加、サンプルを追加した。
  • VRMA: 一部のファイルでアニメーションが崩れるのを修正した。expressionをAnimSequenceのカーブとして保持できるようにした。
  • VRM10: Root骨の回転値を0にした
• 2024/04/17
  • Blenderで出力したVRMファイルを読み込めないのを対応した(glTFの読み込み優先度を上げた)
  • マネキン骨名を小文字で統一した
  • PostProcessAnimBlueprintを自動生成、SkeletalMeshに設定した
  • SpringBone、Constraintノードで利用するMetaファイルを自動サーチできるようにした
  • IKRetargeterにRootMotion設定を追加した
  • VRM10: 揺れ骨のコライダ対応、Constraintにデバッグ表示を追加、ライセンスの取り込み対応
• 2024/04/02
  • UE5の配布バイナリパスが間違っていたのを修正
  • UE5.4: リターゲットポーズにAutoを追加
  • VRM10: 揺れ骨に仮対応
  • PMX: エディタ再起動後、テクスチャが消えてしまう不具合を修正
• 2024/03/23
  • UE5.4 previewに対応
  • UE5のみ プラグインビルドで配布バイナリを生成するようにした
• 2024/03/20
  • ビルド済バイナリにてUE4でのインポートが動作しなくなっていたのを修正
• 2024/03/07
  • アセットのサムネイルが真っ黒になってしまうのを修正
  • Humanoid用Skeletonがコンテンツブラウザに表示されないのを修正
• 2024/02/12
  • IKRigにIKBone設定を追加
  • Rig変換中にダイアログ表示を追加
  • シーンキャプチャサンプルを追加
• 2023/11/27
  • 注意）現バージョンより、インポート時に骨やMorphTargetの特殊文字（スペース「 」やピリオド「.」）をアンダースコア「_」に置き換えます。UE標準動作にあわせています。不都合ある場合はインポートオプションより無効化できます。
  • IKRetargeterにAポーズを自動で追加
  • NormalMapを2つ設定できるようにした
  • Aポーズを微調整した
  • UE5.3でMorphTargetが動かなかったり、フェイシャルのPoseアセットがクラッシュするのを修正
  • VRM10: VRM10として判定されないファイルがあったのを修正
• 2023/11/05
  • リポジトリをpublicに移動。ビルドスクリプトを修正
• 2023/10/30
  • マテリアルパラメータを変更した時にクラッシュすることがあるのを修正
  • Macでのインポート時にクラッシュするのを修正
• 2023/10/08
  • インポート時に骨名を有効な文字列のみに変更するオプションを追加
  • Rig生成のWBPでAssetが自動設定されないことがあるのを修正
  • MorphTargetWBPでエラーが出ることがあるのを修正
• 2023/09/22
  • ControlRigテンプレートについて、足首の位置がずれてしまうのを修正
  • TwoSidedのマテリアルについて法線をカメラ向きに合わせるよう修正
  • UE5向けのMorphTargetWBPを追加
  • UE5.3 MorphTargetに対応するCurveをSkeletonに含めるよう修正
• 2023/09/07
  • UE5.3 正式版に対応
• 2023/08/25
  • VRMA: 再生フレームレートがずれるのを修正
  • UEFN: MorphTargetを出力できるようにした
• 2023/08/13
  • VRMAファイルのインポートに対応
  • ZOffsetにマスクテクスチャを指定を追加
  • リインポート時、Skeletonのカーブ名が重複してしまうのを修正
  • UE5.2 ランタイムロード時、モデルが歪んでしまうのを修正（スキンのウェイトがずれるのを修正）
  • UE5.2 AllRigの生成(モーフ処理)に失敗するのを修正
  • UE5.3preview1 BPでエラーが出ているのを修正
• 2023/07/23
  • インポート時、Skeletonリネームするとクラッシュするのを修正した
  • matcapを2枚設定できるようにした
  • 白目補正マテリアルの中心が 黒フェードしてしまうことがあるのを修正した
  • UE5.2 ポーズアセットを正しく出力できないのを修正した
  • UE5.2 bvhインポートでクラッシュするのを修正した
  • UE5.3preview1 に仮対応した
• 2023/07/16
  • 骨を省略しているモデルをインポートをすると、クラッシュすることがあるのを修正した
• 2023/07/05
  • リインポートに対応した
  • Skin以外のメッシュを含むモデルが動作するようを修正した（骨のActiveリストに含まれるよう修正した）
  • 白目補正のマテリアルが壊れているのを修正した
  • アニメーション補助用のControlRigを追加した
  • UE5.0以降では 従来のBoneMappingContainerを設定しないようにした
  • UEFN: migrate専用のインポートオプションを追加した
• 2023/06/23
  • UE5.2でVRMSpringBoneノードを利用するとアニメーションが動かなくなることがあるのを修正した
  • BodyRigを別モデルに適用した時、クラッシュすることがあるのを修正した
  • VRM10: インポート時にモデルが壊れることがあるのを修正した（頂点最適化を無効化した）
• 2023/05/30
  • 骨数が多いモデルをインポートするとメッシュが描画されないことがあるのを修正した
  • VRM10: ランタイムロード時 クラッシュするモデルがあるのを修正した
• 2023/05/17
  • UE5.2の不具合を修正した。インポート時のウェイト修正、ControlRig生成時のクラッシュ修正
  • 骨のActiveリストを正しくした
  • Linuxビルドエラーを修正した。
• 2023/05/12
  • UE5.2 対応したが、モデルによって新規インポートモデルのウェイトが壊れる不具合がある。migrateした場合は問題ない。
  • 白目補正をmaskマテリアルに切り替えた
  • 自前シャドウマップの方向を任意に指定できるようにした
  • VRM10: ラインタイムロード時、コンストレイントを動作するようにした。
• 2023/04/23
  • UE5.2previ