VRM1.0 Viewer

About

- ローカルで実行可能なVRM Viewerです。
- 外部通信は行わず、選択したフォルダ内のファイルのみを読み込みます。
- 各ファイルはご準備して頂く必要があります。
- あらゆるツールでの動作を保証するものではありません。
                                                             
- This is a locally executable VRM viewer. 
- It does not perform any external communication and only reads files within the selected folder. 
- You will need to provide all the necessary files yourself. 
- We do not guarantee compatibility with all tools.

■主な用途
1.VRM + VRMA の動作確認
2.Expression の確認
3.簡易ビューア（置き物用途）

■その他機能
1.HEXで背景色を指定可能
2.カメラ位置はマウス操作可能
3.瞬きや呼吸風の動き

■フォルダ構成
名称まで完全一致である必要はなく、拡張子があっていれば動作します。
指定するフォルダ/
 ├ character.vrm
 ├ anime1.vrma
 ├ anime2.vrma
 ├ anime3.vrma
 └ config.json

■JSONファイルフォーマット
JSONファイルは、下記の様な構成にしてください。
[
  {
    "background": "#00b148"
  },
  {
    "vrma": "anime1.vrma",
    "exp": { "happy": 0.8 }
  },
  {
    "vrma": "anime2.vrma",
    "exp": { "angry": 1.0, "blink": 0.5 }
  },
  {
    "vrma": "anime3.vrma",
    "exp": {}
  },
  {
    "vrma": "",
    "exp": {}
  }
]

■注意事項
VRMやVRMAファイルはライセンス周りが厳しいので、ご自身でご準備ください。
必要ファイルを一式読み込ませたタイミングで、拡張機能の方で

createVRMAnimationClip: VRMLookAtQuaternionProxy is not found. Creating a new one automatically. To suppress this warning, create a VRMLookAtQuaternionProxy manually

というエラーが出ます。three-vrmの方でもissueが上がっていますが、動作上問題のない無害な警告です。
モデル自体に問題がある場合、「Expressionが存在しない」「必須ボーンがない」等のエラーが出る場合がありますが、
本アプリに修正するための機能はありませんので、UnityやBlenderで修正してみてください。
本アプリの動作確認は、VRoidStudioで作成したモデルを「VRoid Project」様の配布しているアニメーション7種で動作確認しております。

■免責事項
本アプリ利用に伴ういかなる損害についても作者は責任を負いません。

■セキュリティ関連
この拡張機能はデータを外部に送信しません。
また広告による収益、データ取得はありません。
アカウント登録は必要ありません。
この拡張機能は、ユーザーが明示的に選択したディレクトリからのみファイルを読み取ります。

■技術関連
このプロジェクトでは、次のオープンソースライブラリを使用します。
* Three.js
* three-vrm
* three-vrm-animation
これらのライブラリは MIT ライセンスに基づいて配布されます。

ソースを見る方はこちらを参照してください。
https://github.com/Nitaro416/VRMViewer

■ライセンス（License）
MIT License

Copyright (c) 2026 Nitaro

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files to deal in the Software without restriction.

See the LICENSE file for full details.

■改版履歴
v1.0 初回リリース
v1.0.1 VRMが存在しない場合のエラー文の追加、再読み込み可能なように修正、ガイドページの追加、ファイルサイズの大きいVRMやVRMAを読み込んだ際に進捗がわかるように%で出力

■既知の問題
背景色を設定していない場合、ロードが止まる
VRM0.0を読み込むと読み込み完了し、アニメーションも動作するが、目の挙動がおかしくなる