unity-xr

Configure and validate XR interactions in Unity projects across XRI 2.x and 3.x.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-xr-mandexonla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/mandexonla/Top-Down-Template/tree/main/.codex/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/mandexonla/Top-Down-Template --skill unity-xr-mandexonla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configuring robust XR interactions in Unity projects can be complex due to version fragmentation and API differences. This Skill provides a unified approach to set up XR rigs, interactors, locomotion, UI, and diagnostics, ensuring consistent behavior across XR Interaction Toolkit versions.

Core Features & Use Cases

  • Setup and validate XR rigs (XROrigin) with default controllers and camera
  • Add and configure interactors (XRRayInteractor, XRDirectInteractor, XRSocketInteractor)
  • Enable UI interaction through XR Canvas setup and XRUIInputModule
  • Provide diagnostic reporting and compatibility notes across XRI 2.x and 3.x
  • Quick-start workflows for project initialization and scene setup

Quick Start

Initialize an XR Origin rig, attach an interactor to each controller, and enable XR UI in your scene.

Frequently Asked Questions about unity-xr

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

FAQPage Schema
How do I configure XR interactions in Unity across different XR Interaction Toolkit versions?

Configure XR interactions in Unity using reflection-based API access to ensure compatibility across XRI 2.x and 3.x. This approach validates XR rigs, interactors, and UI modules while handling version fragmentation automatically.

What do I need to set up an XR rig with interactors and UI in Unity?

Setting up an XR rig requires initializing an XR Origin with default controllers and camera, attaching interactors like XRRayInteractor or XRSocketInteractor, and enabling UI interaction through XR Canvas and XRUIInputModule.

Does Unity XR validation check for XRInteractionManager and colliders?

Yes, Unity XR validation checks for XRInteractionManager presence, exactly 1 XR Origin, and correct colliders. It provides diagnostic reporting and compatibility notes to ensure scene setup meets runtime requirements.

Why are my Unity XR interactors and teleportation locomotion not working correctly?

XR interactors and locomotion often fail due to missing XRInteractionManager, incorrect colliders, or invalid XR Origin setup. Runtime diagnostics validate these components and provide compatibility notes to resolve configuration errors.

Can I add XR socket and direct interactors for VR object interaction in Unity?

Yes, you can add and configure XRRayInteractor, XRDirectInteractor, and XRSocketInteractor to enable VR object interaction. The configuration process attaches these interactors to controllers on the XR Origin rig.

What's the best way to initialize a Unity VR scene with teleportation and locomotion?

The best way to initialize a Unity VR scene is applying quick-start workflows for project initialization and scene setup. This configures XR rigs, interactors, teleportation, and locomotion while validating compatibility across XRI versions.