unity-xr

Configure XR rigs and interaction components in Unity projects.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/YiDuandtdt/Bone-Throne --skill unity-xr-yiduandtdt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-xr
Source: https://github.com/YiDuandtdt/Bone-Throne/tree/main/.agents/skills/unity-skills/skills/xr
Command: npx skills add https://github.com/YiDuandtdt/Bone-Throne --skill unity-xr-yiduandtdt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up XR rigs, interactors, and UI in Unity is error-prone and time-consuming. This skill provides a repeatable workflow to automate XR Origin creation, interactor setup, teleportation, locomotion, and UI integration for VR/AR projects.

Core Features & Use Cases

  • XR Rig setup with origin and camera
  • Add and configure ray interactor, direct interactor, and socket interactor
  • Enable teleportation, continuous move, and turn providers
  • Prepare XR UI canvas and event system
  • Diagnostics and scene reporting to validate XR readiness

Quick Start

Create an XR Origin and camera, add a Right Controller ray interactor and a Left Controller direct interactor, then run xr_check_setup to verify readiness.

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 rig with interactors in Unity?

To set up a Unity XR rig, you need to configure the XR Origin, attach the camera, and add specific interactors like ray, direct, or socket interactors to the controllers. This automates the process to eliminate manual configuration errors.

What is the best way to configure teleportation and locomotion for VR in Unity?

The best way to configure VR locomotion in Unity is by enabling teleportation, continuous move, and turn providers on the XR rig. This provides consistent movement workflows without manual setup errors.

Does this Unity XR setup workflow support the XR Interaction Toolkit 2.x and 3.x?

Yes, the Unity XR setup workflow supports both XR Interaction Toolkit 2.x and 3.x versions. It uses a reflection-based bridge with safety guards to ensure compatibility and prevent version-specific configuration errors.

How do I prepare XR UI canvas and event systems in Unity?

To prepare XR UI in Unity, you must configure the UI canvas and event system specifically for XR input. This workflow integrates UI interactions seamlessly into VR/AR projects, ensuring the canvas responds to controller-based interactors.

Why does my Unity XR setup fail validation after manual configuration?

Manual Unity XR setup often fails validation due to missing interactors, locomotion providers, or UI event systems. Running an XR diagnostics and scene reporting check validates readiness by identifying these incomplete configuration components.