# 3D Custom Avatar Requirements

## Overview <a href="#overview" id="overview"></a>

### **Hallway Requires** [**VRM1**](https://vrm.dev/en/) <a href="#hallway-requires-vrm1" id="hallway-requires-vrm1"></a>

Hallway leverages the VRM standard for features like speech shapes (Visemes), expressions, physics, look-at, sharing animations via humanoid bone mappings, and much more.

* **If you already have a VRM1 avatar** from an app like VROID, it should work with Hallway as is!
* **If you don’t already have a VRM avatar** or you want to add features, follow the guide below:

| [VRM Addon For Blender Panel](https://github.com/saturday06/VRM-Addon-for-Blender/releases) ![](/files/35f67be7a6d63db6474ead0a1050504fa64df8e4) (You may use Unity or any other VRM authoring method of your choice) | We require you make your avatar following the [VRM 1.0 standard](https://github.com/vrm-c/vrm-specification/tree/master/specification/VRMC_vrm-1.0). Hallway also leverages the [ARKit 52 Shape](https://docs.google.com/spreadsheets/d/1M1BOr5bxC9AZGejm7nBS72P61zULh5AfTQX_QTunzY8/edit#gid=850913586) standard. *All shape keys must be mapped to a VRM expression bind* All materials must be MToon (see “VRM” section in material properties panel in blender) Add meta-data Add humanoid bone mappings Add spring bones if necessary Add Look-At Expression Binds |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **Test Avatars Here:** <a href="#test-avatars-here" id="test-avatars-here"></a>

While you are working on your avatar, you can upload and test VRM files (that conform to the rules above). Please contact the hallway team for access.

<figure><img src="/files/j4bEO1LPDHCCsnqTLuc6" alt="" width="404"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hallway.gitbook.io/embed/characters-for-embed/3d-custom-avatar-requirements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.