file in abyss
フォーマット一覧へ戻る

3D

VRM VRM Avatar

glTF/GLBをベースに人型アバター向けメタデータや拡張を加えた形式。ファイル先頭はGLBと同じglTFです。

Extensions .vrm
MIME model/vrm, model/gltf-binary

マジックナンバー

ファイルを解析
オフセット 0 GLB magic with VRM extension metadata
67 6C 54 46
glTF

構造

  1. GLB header
  2. JSON chunk
  3. VRM extension
  4. BIN chunk

注意点

  • 先頭マジックナンバーだけではGLBと区別できません。JSONチャンク内のVRMまたはVRMC_vrm拡張を確認します。
  • VRMは実質的にGLBコンテナなのでMIMEや拡張子だけの判定は避けます。

判定コード例

SIGNATURE = bytes.fromhex("676c5446")
OFFSET = 0

def is_vrm(path: str) -> bool:
    with open(path, "rb") as f:
        f.seek(OFFSET)
        head = f.read(len(SIGNATURE))
    return head == SIGNATURE

実践的な使い方

ユースケース

VRM Avatar は3Dビューア、アセットパイプライン、モデル変換、アバター読み込み、シーン検証などで使われます。コンテナ・拡張子・バイナリチャンク・テクスチャ参照が実装の挙動に影響します。

よくある判定ミス

  • .vrm という拡張子だけではファイルの中身を保証できません。アップロードや変換の処理では、拡張子・MIMEタイプ・先頭バイト・形式固有の構造チェックを組み合わせるべきです。
  • VRM Avatar は 67 6C 54 46 のようなシグネチャで始まりますが、関連するコンテナや破損ファイルでは追加の検証が必要になる場合があります。

セキュリティ上の注意

形式が判定できたからといって、信頼できない入力が安全とは限りません。パーサ例外・巨大ファイル・想定外のエンコーディング・外部参照を考慮してください。

サンプルの活用

9 個のサンプルで、ビューアの読み込み・拡張子判定・ファイルサイズごとの読み込み時間をテストできます。

サンプルファイル

9 / 9 files
Sample Traits Size Source / license / SHA-256
3D

Sendagaya Shibu VRM

Sendagaya Shibu VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

01-sendagaya-shibu.vrm
Type Sample
Large file
16.26 MB
SHA-256 b7bcad5e5890abc4d7c65f9afc31da2445db03197d44f1ec10447f9db5abeaff
Download
3D

Vivi VRM

Vivi VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

02-vivi.vrm
Type Sample
Large file
17.25 MB
SHA-256 eaf902e041a7a810f1423599ae75682f61184ab6ef0206da9a8ed9caa8ec3a9d
Download
3D

Vita VRM

Vita VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

03-vita.vrm
Type Sample
Large file
13.69 MB
SHA-256 f2bf78f28a24e2f75f5ca0b6c3b646654c394e4b03592dfaa0d0633ef0972b4d
Download
3D

Victoria Rubin VRM

Victoria Rubin VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

04-victoria-rubin.vrm
Type Sample
Large file
14.76 MB
SHA-256 b1372131bdbf233f46320146d565f342a7e4f6f4b8f2aefb301f1a283ec07e1e
Download
3D

Sakurada Fumiriya VRM

Sakurada Fumiriya VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

05-sakurada-fumiriya.vrm
Type Sample
Large file
18.45 MB
SHA-256 d8fb05f33e377df028cb6b9d58c441ce68326c41fa23f6c735d40c65ae3dc710
Download
3D

Sendagaya Shino VRM

Sendagaya Shino VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

06-sendagaya-shino.vrm
Type Sample
Large file
14.38 MB
SHA-256 1e177c1a7b14f783a9c48395831db8616260d3bddd4154cb2784b779adca49b5
Download
3D

HairSample Female VRM

HairSample Female VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

07-hair-sample-female.vrm
Type Sample
Large file
16.71 MB
SHA-256 adfd242317aaabc773f31f7fff7b013979fbb5baa47e97427a78913d9cb4e979
Download
3D

HairSample Male VRM

HairSample Male VRM is a VRM Avatar sample based on VRoid Help. It can be used to test downloads, parsers, previews, and file type detection.

08-hair-sample-male.vrm
Type Sample
Large file
17.63 MB
SHA-256 7aeca142dabbc26ba0f5b9c998c8f3cb6df341287d67788427ac837223785a3f
Download
3D

100Avatars Devil VRM

100Avatars Devil VRM is a VRM Avatar sample based on Open Source Avatars. It can be used to test downloads, parsers, previews, and file type detection.

100avatars-devil.vrm
Type Sample
Large file
1.33 MB
SHA-256 2e428dd1846504a77f3936259f489a899cc92aa6179b769a1aee230f875a9b4d
Download

よくある質問

VRM Avatar のマジックナンバー(ファイルシグネチャ)は?

VRM Avatar ファイルはバイトシグネチャ 67 6C 54 46 ("glTF") で始まります。拡張子に頼らず、この先頭バイトを読み取って形式を判定してください。

VRM Avatar のMIMEタイプは?

VRM Avatar のMIMEタイプは model/vrm, model/gltf-binary です。

VRM Avatar の拡張子は?

VRM Avatar ファイルは .vrm 拡張子を使います。拡張子は慣習にすぎず中身を保証しないため、シグネチャや構造のチェックと組み合わせてください。

関連フォーマット