platform-vr
Installation
SKILL.md
Platform: VR
90+ FPS, comfort-first design, and motion control accuracy define VR development.
Available Scripts
vr_physics_hand.gd
Expert physics-based hand controller with grab detection and velocity throwing.
NEVER Do in VR Development
- NEVER drop below 90 FPS — 72 FPS in VR = instant nausea. MUST maintain 90 FPS minimum (Quest 2/3), 120 FPS preferred. Use Debug → Profiler aggressively.
- NEVER use smooth rotation without vignetting — Smooth camera rotation = vestibular mismatch = motion sickness. Provide snap turning (30°/45°) OR vignette during rotation.
- NEVER place UI too close or too far — UI at 0.5m = eye strain, at 10m = unreadable. Optimal distance: 1-3m from player.
- NEVER ignore motion-to-photon latency — >20ms latency = visible lag in hand tracking = breaks immersion. Minimize physics steps + rendering delay.
- NEVER skip teleport locomotion option — Not everyone tolerates smooth locomotion. MUST offer teleport as alternative for accessibility.
- NEVER forget physical boundaries — Player punches wall IRL = lawsuit. Use
XRServer.get_reference_frame()to respect guardian/chaperone bounds. - NEVER use standard 3D audio — Stereo audio in VR = disorienting. Use spatial audio (AudioStreamPlayer3D) for positional sound cues.