unity-xr

Validate and configure Unity XR Interaction Toolkit scenes and rigs.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/lrbjk/FenShen_Remake_V0 --skill unity-xr-lrbjk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/lrbjk/FenShen_Remake_V0/tree/main/.codex/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/lrbjk/FenShen_Remake_V0 --skill unity-xr-lrbjk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many Unity projects struggle with correctly configuring XR scenes: missing or misconfigured XR Origin rigs, XRInteractionManager, controller interactors, colliders, and EventSystem support cause silent failures and broken interactions. This Skill centralizes validation, guided setup, and deterministic fixes so developers can get working VR/AR scenes quickly and reliably.

Core Features & Use Cases

  • Project validation and diagnostics: Scans scenes for XRI version, XRInteractionManager, XR Origin, main camera, controllers, and common collider/Rigidbody issues.
  • Rig & input setup: Create a complete XR Origin with Camera, TrackedPoseDriver controllers, XRInteractionManager, and XR-friendly EventSystem.
  • Interaction primitives: Add Ray/Direct/Socket interactors, make objects grabbable or simple interactable, and configure interaction layers and haptics.
  • Locomotion & UI: Configure teleportation areas/anchors, continuous movement, snap or smooth turning, and convert Canvases for XR UI.
  • Use Case: Convert a legacy scene into a playable VR demo by auto-creating the XR rig, wiring interactors, marking teleportable surfaces, and making key objects grabbable.

Quick Start

Call the unity-xr skill to validate the project and create a full XR Origin with camera, controllers, interactors, teleportation, and XR-ready 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 Unity XR Interaction Toolkit?

Setting up an XR Origin rig with Unity XR Interaction Toolkit requires a Camera, TrackedPoseDriver, controllers, and an XRInteractionManager. This creates a complete VR rig with interactors and an XR-friendly EventSystem.

Why are my Unity VR grab interactions silently failing?

Unity VR grab interactions fail silently when scenes have missing or misconfigured XR Origin rigs, XRInteractionManager, controller interactors, or required colliders and Rigidbodies. Validating these components ensures reliable interactable objects.

Does Unity XR Interaction Toolkit 3.x require different scene configuration than 2.x?

Unity XR Interaction Toolkit 3.x and 2.x require different scene configuration approaches. The toolkit uses reflection to support both XRI 2.x and 3.x while enforcing consistent collider, Rigidbody, and TrackedPoseDriver setups across versions.

What's the best way to configure teleportation areas and continuous locomotion in Unity XR?

The best way to configure teleportation areas and continuous locomotion in Unity XR is through the XR Interaction Toolkit. You can define teleportation anchors and set up continuous movement or snap turning directly on the XR Origin rig.

How do I make a Unity Canvas work with VR controller input?

To make a Unity Canvas work with VR controller input, you must convert it for XR UI and ensure an XR-friendly EventSystem is present in the scene. This allows ray interactors to drive UI interactions correctly.

Do I need the com.unity.xr.interaction.toolkit package installed before configuring an XR scene?

Yes, you need the com.unity.xr.interaction.toolkit package installed before configuring an XR scene. The toolkit provides the necessary XR Origin, interactors, and interactables required to build functional VR and AR interactions.