The VRChat Documentation Hub

Welcome to the VRChat Documentation hub. You'll find comprehensive guides and documentation to help you start working with VRChat as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Quest Content Limitations

This page will describe various limits in place for the Oculus Quest version of VRChat. These limitations are in place in the interest of performance, user safety, and discouraging malicious behavior.

Find more information about limited components on our Quest Content Optimization page.

Avatar-Specific Limitations

Although the current version of VRChat does not implement it, we plan on implementing a hard limit for avatars based on triangle count, material counts, mesh counts, and other qualities. Please keep our recommendations in mind as described in Quest Content Optimization.

These limits will be implemented in an upcoming version of VRChat. All avatars will be subject to these limitations.

Currently, if you upload an avatar or avatar world that features avatars exceeding our recommendations, that world or avatar may be removed from public access.

Shaders

VRChat on Quest only permits the shaders provided with the latest SDK on avatars. The shaders are listed below with a short description and their inputs. This list may change, and we'll announce in our patch notes when new shaders are available.

All of the shaders listed below are under VRChat/Mobile in the shader selection dialog.

For performance reasons, make sure you always enable "Enable GPU Instancing" on your materials.

Shader Name

Shader Description

Standard Lite

A "Lite" version of Unity Standard. Supports diffuse, normal maps, metallic+smoothness maps, and optional emission maps. Channel mappings for relevant maps are identical to Unity Standard Metallic setup. The diffuse texture is tinted by the vertex colours

Requires a diffuse (RGB) base texture.

Bumped Diffuse

Diffuse but with a normal map. The diffuse texture is tinted by the vertex colours.

Requires a diffuse (RGB) base and a normal map. If you don't have a normal map, just use Diffuse.

Bumped Mapped Specular

Diffuse, but with a specular map (shininess) on the alpha channel. The diffuse texture is tinted by the vertex colours. Normal map also supported.

Requires a diffuse (RGB) base with specular (A) and a normal map.

Diffuse

Just diffuse! The diffuse texture is tinted by the vertex colours.

Requires a diffuse (RGB) base texture.

Matcap Lit

Diffuse, but with a matcap input. Can be used to simulate a shiny metal surface. The diffuse texture is tinted by the vertex colours.

Requires a diffuse (RGB) base texture and a matcap (RGB) texture. If you don't have a matcap texture, just use Diffuse.

Toon Lit

Provides toon-like shading and shadows. Should be used on cartoon-like characters with flat colors. The diffuse texture is tinted by the vertex colours.

Requires a diffuse (RGB) texture.

Particles/Additive

Should be used on particles. Blends using Additive mode.

Should not be used for avatars, only for particles.

Particles/Multiply

Should be used on particles. Blends using Multiply mode.

Should not be used for avatars, only for particles.

Lightmapped (Only available for worlds)

A basic diffuse shader that supports lightmapping. This shader is only meant for use on worlds. It cannot be used on avatars. It does not support real-time lighting.

Requires a diffuse (RGB) base texture.

Without a lightmap, it will be unlit. Do not use this shader unless you plan on baking lighting (which you should be).

Skybox (Only available for worlds)

This shader is an optimized skybox shader, meant for use in worlds.

Requires a cubemap.

Components

The following components are not supported on Quest and will not work. This list may change. We'll note in the Patch Notes and updated documentation when these change.

Component Name

Status

Dynamic Bones

Completely disabled in VRChat Quest.

Cloth

Completely disabled in VRChat Quest.

Cameras

Completely disabled on avatars in VRChat Quest.

Permitted for use in Worlds. Be careful with overuse.

Lights

Completely disabled on avatars in VRChat Quest.

Video Players

VRC_SyncVideoPlayer and VRC_SyncVideoStream are both completely disabled in worlds in VRChat Quest.

Placing either of these components in your Quest world will break compatibility between your Quest and PC world! Simply remove it from the Quest version.

Post-Processing

Post processing systems are disabled completely in VRChat Quest.

Audio Sources

Audio sources are disabled completely on avatars in VRChat Quest.

Audio sources are restricted in worlds in VRChat Quest.

Physics Objects

Rigidbodies, colliders, and joints are disabled completely on avatars in VRChat Quest.

They are permitted in worlds, but you should be careful not to go overboard with them.

Particle Systems

Particles are limited heavily on avatars in VRChat Quest.

Numbers for limits pending.

Updated 11 months ago


Quest Content Limitations


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.