unity-xr

Configure XR rigs, interactors, and interactables in Unity scenes.

8|1|Updated Oct 7, 2025
One-click install
npx skills add https://github.com/Zzulin/unity-project01 --skill unity-xr-zzulin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/Zzulin/unity-project01/tree/main/URP1/Plugins/Unity-Skills-main/SkillsForUnity/unity-skills~/skills/xr
Command: npx skills add https://github.com/Zzulin/unity-project01 --skill unity-xr-zzulin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many Unity developers spend significant time wiring up XR rigs, controllers, interactors, and locomotion manually, frequently encountering silent failures due to mismatched API names, collider misconfiguration, or incompatible XRI versions. This Skill centralizes validation, creation, and configuration of XR components so scenes become interactive and stable without tedious trial-and-error.

Core Features & Use Cases

  • Project Validation: Scan scenes for XRI version, XRInteractionManager, XR Origin, EventSystem, and collider/rigidbody issues and produce a diagnostics report.
  • Rig & Interactor Setup: Create a complete XR Origin with camera and left/right controllers, add ray/direct/socket interactors, and attach visual rays and reticles.
  • Locomotion & UI: Configure teleportation areas/anchors, continuous movement and turn providers, and convert Canvases for XR UI interaction.
  • Interactable Configuration & Events: Make objects grabbable with correct Rigidbody/Collider settings, tune movement smoothing/throw, configure socket behavior, and wire interaction events and haptics.
  • Cross-version Safety: Uses reflection to support XRI 2.x and 3.x and enforces collider/rigidbody rules to prevent common runtime issues.

Quick Start

Call the unity-xr skill to validate your project and generate a complete XR Origin with controllers, interactors, teleportation, and XR-compatible UI.

Frequently Asked Questions about unity-xr

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an XR Origin rig with controllers and interactors in Unity?

To set up an XR Origin rig in Unity, you can automate the creation of the camera, left/right controllers, and ray/direct/socket interactors. This configures visual rays and reticles while enforcing collider and Rigidbody rules to ensure stable interactions.

Why are my Unity VR grabbable objects failing silently during interaction?

Grabbable objects in Unity VR fail silently due to collider misconfiguration or missing Rigidbody components. Diagnosing XR scenes validates interaction managers and physics rules, preventing common runtime issues and silent failures.

Does the Unity XR Interaction Toolkit support both XRI 2.x and 3.x versions?

The Unity XR Interaction Toolkit supports both XRI 2.x and 3.x versions by using reflection to handle API differences. This cross-version safety ensures compatibility while enforcing collider and Rigidbody rules across different package versions.

How do I configure teleportation and continuous movement in Unity XR?

Configuring Unity XR teleportation involves setting up teleportation areas and anchors, while continuous movement requires adding movement and turn providers. Automating this setup ensures proper locomotion configuration without manual trial-and-error.

What is the best way to convert Unity Canvases for XR UI interaction?

The best way to convert Unity Canvases for XR UI interaction is to automate the configuration process to ensure compatibility with XR ray and direct interactors. This enables functional UI interaction within VR and AR environments.

Do I need the com.unity.xr.interaction.toolkit package to diagnose XR scene issues?

Yes, you need the com.unity.xr.interaction.toolkit package to diagnose XR scene issues. Project validation scans scenes for XRI versions, interaction managers, and physics misconfigurations to produce a comprehensive diagnostics report.