An open API service indexing awesome lists of open source software.

https://github.com/vrm-c/UniVRM

UniVRM is a gltf-based VRM format implementation for Unity. English is here https://vrm.dev/en/ . 日本語 はこちら https://vrm.dev/
https://github.com/vrm-c/UniVRM

gltf unity3d

Last synced: 7 days ago
JSON representation

UniVRM is a gltf-based VRM format implementation for Unity. English is here https://vrm.dev/en/ . 日本語 はこちら https://vrm.dev/

Awesome Lists containing this project

README

        

# UniVRM

[![GitHub latest release](https://img.shields.io/github/v/release/vrm-c/UniVRM?color=green)](https://github.com/vrm-c/UniVRM/releases/latest)
[![GitHub license](https://img.shields.io/github/license/vrm-c/UniVRM)](https://github.com/vrm-c/UniVRM/blob/master/LICENSE.txt)

The standard implementation of 3D Avatar file format [VRM](https://vrm-consortium.org/en/) for [Unity](https://unity.com/).

VRM is an extension of [glTF 2.0](https://www.khronos.org/gltf/), so this library also support glTF 2.0 files.

## Features

UniVRM supports the [VRM 1.0 specification](https://github.com/vrm-c/vrm-specification) and the [glTF 2.0 specification](https://registry.khronos.org/glTF/).

UniVRM can import/export following supported file types at both runtime and editor.

### Supported file types

- VRM 1.0 (.vrm)
- VRM 0.x (.vrm)
- glTF 2.0 (.glb | .gltf | .zip)
- VRM-Animation (.vrma)

### Import features

- You can import supported file types at both runtime and editor.
- Support for async/await importing at runtime.
- Support for Migration VRM 0.x files into VRM 1.0 files.
- Support for ScriptedImporter for VRM 1.0 and glTF 2.0.
- You can import glTF's PBR materials into Unity Built-in RP's Standard materials.

### Export features

- You can export supported file types at both runtime and editor.
- You can export Unity Built-in RP's Standard materials into glTF's PBR materials.

## Supported Environments

The latest UniVRM supports Unity 2022.3 LTS or later from `v0.128.0`.

UniVRM supports scripting backends both .NET and IL2CPP.

UniVRM supports the following building target platforms:

- Standalone (Windows/Mac/Linux)
- iOS
- Android
- WebGL

The other platforms maybe work but they are not tested.

## Installation

### Latest Release

[Download here](https://github.com/vrm-c/UniVRM/releases/latest)

Previous Releases

You can use an previous version of UniVRM if you use an older version of Unity.
These are **not supported**.

| Unity Version | UniVRM Release | VRM 1.0 support |
| ------------- | ----------------------------------------------------------------- | --------------- |
| 2021.3 | [v0.112.0](https://github.com/vrm-c/UniVRM/releases/tag/v0.127.0) | Yes |
| 2020.3 | [v0.100.0](https://github.com/vrm-c/UniVRM/releases/tag/v0.111.0) | Yes |
| 2019.3 | [v0.99.1](https://github.com/vrm-c/UniVRM/releases/tag/v0.99.1) | No |
| 2018.4 | [v0.79.0](https://github.com/vrm-c/UniVRM/releases/tag/v0.79.0) | No |

You can install UniVRM using the UnityPackage or the UPM Package.

### UnityPackage

From the [latest release](https://github.com/vrm-c/UniVRM/releases/latest), you can download the `.unitypackage` files.

- For import/export VRM 1.0
- You can download **VRM-0.XXX.X-YYYY.unitypackage**.
- You can also download sample projects as **VRM_Samples-0.XXX.X-YYYY.unitypackage**.
- For import/export VRM 0.x
- You can download **UniVRM-0.XXX.X-YYYY.unitypackage**.
- You can also download sample projects as **UniVRM_Samples-0.XXX.X-YYYY.unitypackage**.
- For import/export glTF 2.0
- You can download **VRM-0.XXX.X-YYYY.unitypackage**.

### UPM Package

From the [latest release](https://github.com/vrm-c/UniVRM/releases/latest), you can find UPM package urls.

- For import/export VRM 1.0
- You have to install all of the following UPM packages:
- `com.vrmc.gltf`
- `com.vrmc.vrm`
- For import/export VRM 0.x
- You have to install all of the following UPM packages:
- `com.vrmc.gltf`
- `com.vrmc.univrm`
- For import/export glTF 2.0
- You have to install all of the following UPM packages:
- `com.vrmc.gltf`

You can install these UPM packages via `Package Manager` -> `+` -> `Add package from git URL...` in UnityEditor.

## Documentation

- https://vrm.dev/en/vrm/index.html

### For developers

- https://vrm.dev/en/api/index.html

## License

- [MIT License](./LICENSE.txt)