Mirrors: Difference between revisions

From VRChat Wiki
(HUD link)
(added mirror performance issues, some performance fixes, and official documentation link)
Line 39: Line 39:
=== Transparent ===
=== Transparent ===
A transparent mirror usually reflects the avatars around it while acting like a window, showing what appears behind the mirror, and also having a faint reflection of world from the mirror's perspective. It requires a special set up, which is also available through transparent mirror prefabs from the community.
A transparent mirror usually reflects the avatars around it while acting like a window, showing what appears behind the mirror, and also having a faint reflection of world from the mirror's perspective. It requires a special set up, which is also available through transparent mirror prefabs from the community.
== Performance Issues ==
Every object reflected in a mirror has to be rendered again, separately from what the player sees in the playable world. A mirror reflecting the whole world will double the performance cost of rendering the world. Occlusion culling does not work in mirror reflections, so a mirror facing a wall will still try to render everything behind the wall too.
The performance cost of using mirrors in a world can be reduced in many ways, such as:
* Disabling all mirrors by default. Only enable a mirror when the player pushes a button, or physically approaches them.
* Disabling mirrors when a player leaves the area. This will remove the rendering cost of a mirror when a player isn't using it. Players will often not do this themselves, so use a script to do it for them.
* Considering the placement of mirrors. A mirror facing away from the center of the world will have to render less than one facing inward.
* Changing the layers a mirror reflects. A mirror only renders objects on the defined layers. For example, if you have a large outdoor world with a house in the middle, you could set the outdoor environment objects to the environment layer, and then disable the environment layer on the mirrors inside the house. This will stop the mirrors from trying to render the environment that they can't see.


== Resources ==
== Resources ==
[https://creators.vrchat.com/worlds/components/vrc_mirrorreflection/ VRChat Creator Documentation - VRC Mirror Reflection]

Revision as of 00:00, 12 September 2024

VRLogo.png
V · EThis is an official VRChat information page!
It is written and maintained by VRCWiki Team.
Vrrat posed-right.png
V · EThis page is a stub.
You can help the VRChat Wiki by improving it.
[Reason: Resources heading is empty. Proofread according to Manual of Style.]
File:Mirror.webp
People socializing in front of a mirror.

Mirrors are reflective surfaces that allow users to view a mirrored reflection of their avatar, alongside other users and/or the world they're in. Many worlds contain mirrors intended for users to sit in front of as they socialize, often referred to as "mirror dwelling". Users may also choose to summon a mirror of their own, only visible to them.

Types

World prefab

The VRChat SDK contains a prefab for a ready-to-use mirror that can be dragged into a scene. This prefab is found at the following path:
Packages\com.vrchat.worlds\Samples\UdonExampleScene\Prefabs\VRCMirror.prefab

User feature

Personal Mirror

A personal mirror is a type of mirror that can be summoned and moved by a user that can only be viewed by them.

It can be enabled and configured via the Action Menu or the Main Menu's Settings page.

Face Mirror

A face mirror is a type of mirror that displays the face of a user's avatar in their HUD. Face mirrors are designed to help a user stay aware of their avatar's facial expressions, especially if they're controlled by gestures. Unlike a traditional mirror, the face mirror does not portray depth.

It can be enabled and configured via the Action Menu or the Main Menu's Settings page.

Calibration Mirror

A calibration mirror is a type of mirror that activates automatically when the user presses the "Calibrate FBT" button. It is visible only to the user who is calibrating and disappears once they are done. The calibration mirror displays only the user's avatar, controllers, and FBT tracker model, which can be set in the Main Menu's Settings. If "Display Calibration Visuals" is enabled under Tracking and IK, the calibration mirror will also reflect these, showing which tracking points the trackers will track when calibration is done.

It can be enabled via the Action Menu or the Main Menu's Settings page, but there are no configuration options for the calibration mirror.

Common setups

The mirror prefab allows for selection of which layers are to be shown in the reflection. Therefore it is common that worlds have set up multiple different mirrors to toggle between. Which is why it usually breaks down to 3 options: high quality, low quality and transparent mirror. Some worlds offer even more specialized setups beyond these.

High quality

A high quality mirror acts as a mirror would in real life, reflecting the world and avatars around it from the perspective of the mirror.

Low quality

A low quality mirror usually mirrors the avatars around it at a lower resolution and replaces the reflection of the world with the skybox.

Transparent

A transparent mirror usually reflects the avatars around it while acting like a window, showing what appears behind the mirror, and also having a faint reflection of world from the mirror's perspective. It requires a special set up, which is also available through transparent mirror prefabs from the community.

Performance Issues

Every object reflected in a mirror has to be rendered again, separately from what the player sees in the playable world. A mirror reflecting the whole world will double the performance cost of rendering the world. Occlusion culling does not work in mirror reflections, so a mirror facing a wall will still try to render everything behind the wall too.

The performance cost of using mirrors in a world can be reduced in many ways, such as:

  • Disabling all mirrors by default. Only enable a mirror when the player pushes a button, or physically approaches them.
  • Disabling mirrors when a player leaves the area. This will remove the rendering cost of a mirror when a player isn't using it. Players will often not do this themselves, so use a script to do it for them.
  • Considering the placement of mirrors. A mirror facing away from the center of the world will have to render less than one facing inward.
  • Changing the layers a mirror reflects. A mirror only renders objects on the defined layers. For example, if you have a large outdoor world with a house in the middle, you could set the outdoor environment objects to the environment layer, and then disable the environment layer on the mirrors inside the house. This will stop the mirrors from trying to render the environment that they can't see.

Resources

VRChat Creator Documentation - VRC Mirror Reflection