Mirror — Changelog

All notable changes to this pack are recorded here.

The format follows Keep a Changelog and the pack follows Semantic Versioning.

The version below must always match the one declared in Runtime/AssemblyInfo.cs — that is the version the FOS Hub shows, and the one the Hub compares against the installed Core.

---

Unreleased

Nothing yet.

---

1.0.0 — 2026-08-20

First release. Requires FOS Essentials Core 1.0.0.

Added

Core components

• FOSMirrorManager — one per scene, owns the loop and arbitrates every mirror.
• FOSMirrorTarget — one per mirror, holds its settings and its on/off state, and does no per-frame work.
• FOSMirrorButton and FOSMirrorInteract — manual controls, each able to toggle, force on or force off.

Switching

• Distance culling with squared distances, two-threshold hysteresis and round-robin checks, spread over a configurable per-frame budget.
• A mirror switched on is measured immediately instead of waiting for its turn.
• Free and Exclusive modes; exclusive is enforced at startup as well.
• Toggle scope per mirror: Local (no networking) or Synchronized ([UdonSynced], manual sync, ownership taken before writing, state rebuilt for late joiners through OnDeserialization).
• FOSTurnAllOff() on the manager as a panic button.

Appearance

• Mirror surface handling: hide the renderer, or swap it to an off material — a disabled mirror component otherwise leaves a pure black rectangle.
• Materials/FOSMirrorOff.mat, a dark glossy pane, using Unity’s built-in Standard shader so the material never depends on assets outside Unity.
• Extra components and extra colliders switched along with the mirror, in separate lists.

Quality

• m_ReflectLayers and m_DisablePixelLights exposed on the target, applied at Start.
• Presets: Untouched (default, writes nothing), Players only, Players and world, World only, Nothing, Custom. The preset resolves into the layer mask field immediately, so the mask shown is the mask applied.
• Apply to the mirror now, to write the settings in the editor as well.

Editor tooling

• Scene scan: adds the components, wires mirror, manager and surface, fills the manager’s list. Re-runnable without overwriting manual settings; legacy non-SDK3 mirrors are counted and reported.
• Automatic OnClick wiring for a UI Button, including detection of an existing wiring through SerializedObject, argument included.
• Indicative cost estimate, per mirror and per scene, weighted in the order that actually matters: reflected layers, then how many mirrors can render at once, then screen coverage.
• Orientation gizmo: mirror plane, arrow on the reflecting face, back face crossed out. The normal is read from the mesh.
• Warnings for the classic mistakes: untouched default layer mask, UiMenu or PlayerLocal reflected, players reflected without MirrorReflection, several managers in the scene, a mirror missing from the manager’s list, several mirrors starting on in exclusive mode, and a toggle collider listed among the extra colliders.
• Interface translated into English, French, Spanish and German.

Prefabs

• FOSMirrorManager and FOSMirrorExample.

Notes

• No [CustomEditor(typeof(VRC_MirrorReflection))] is declared: Unity accepts only one per type and VRWorldToolkit already ships one. Both tools work side by side.
• The reasoning behind each of these choices is in README.md.