DisplayXR Unity Test Project

A minimal Unity test project for the DisplayXR Unity plugin. Use this project to validate the plugin against new releases, test scene setups, and try out the spatial display rendering on a tracked 3D display.

Requirements

• Unity 6000.3 LTS (Unity 6) or newer
• A spatial display supported by DisplayXR, or use the built-in sim_display driver for development without hardware
• The DisplayXR runtime installed (via the installer)

Opening the Project

1. Clone this repo:

   git clone https://github.com/DisplayXR/displayxr-unity-test.git

2. Open the project in Unity Hub (File → Open Project)
3. Unity will fetch dependencies — this may take a few minutes on first open
4. Open Assets/CubeTest.unity to load the test scene

Plugin Reference

The project depends on the DisplayXR Unity plugin via Unity Package Manager. The dependency is declared in Packages/manifest.json:

"com.displayxr.unity": "https://github.com/DisplayXR/displayxr-unity.git#upm/v1.0.0"

To test against a different plugin version, edit the URL fragment (#upm/v1.0.0) to point at the desired tag, then run Window → Package Manager → Refresh.

To test against a local development build of the plugin, change the dependency to:

"com.displayxr.unity": "file:/absolute/path/to/displayxr-unity"

Test Scenes

Scene	Description
Assets/CubeTest.unity	Minimal rotating cube on a tracked 3D display — verifies the basic rendering pipeline

Running the Project

1. With a spatial display connected: Press Play in the Unity Editor — the scene will render with stereo 3D and head tracking
2. Without hardware: The DisplayXR runtime's sim_display driver activates automatically — use WASD + mouse to simulate eye movement
3. To build a standalone player: File → Build Settings → Build

Reporting Issues

For plugin bugs, file issues on the DisplayXR Unity plugin repo. For runtime bugs, file issues on the DisplayXR Shell releases repo.

License

ISC. See LICENSE.