🧩 Zion XRay

Setup Wizard

The Zion XRay Setup Wizard creates and validates a starter configuration for your player. It can add scanner components, GPS trail support, objective setup, input references, HUD overlay, world markers, generated assets and optional demo content.

Opening the wizard

Tools → Zion Games → Zion XRay → Setup Wizard

Setup video

This setup video shows the Zion XRay 1.1 Setup Wizard workflow in Unity 6, including the main setup tabs, generated HUD, diagnostics and Play Mode scanner test.

Reference fields

Field	Purpose
Player Object	The object that receives or already owns the Zion XRay player components.
Active Objective	The starting objective transform used by the demo provider and GPS trail.
XRay Input Action	The Unity Input System action used to activate scanner mode.

Setup tab

The Setup tab handles the main runtime components:

• Add XRay Scanner.
• Add XRay Controller.
• Add GPS Trail.
• Add Demo Objective Provider when testing the included demo flow.
• Add XRay Target to the starting objective.
• Create a basic GPS chevron arrow prefab when one is not already assigned.

HUD tab

The HUD tab creates or configures the UI Toolkit overlay used for scanner status, objective title, distance display, scan reticle, control hints and world marker rendering.

• Create HUD UI object.
• Create or assign UI Document and Panel Settings.
• Generate HUD USS/UXML files under the generated UI folder.
• Add the runtime HUD controller and marker system.
• Create presentation settings for HUD and marker behaviour.

Demo tab

The Demo tab can generate simple test targets and scene utilities for learning the system. Demo objects are useful for validation, screenshots and onboarding, but should be replaced by your own gameplay objects in production scenes.

Diagnostics tab

The Diagnostics tab lets you run validation directly from the wizard. It can open the full Diagnostics window using the selected player reference and can attempt safe reference fixes.

• Run Full Validation: opens diagnostics and checks the current scene.
• Fix Safe References: fills blank references only when the matching component already exists unambiguously.
• Open Diagnostics After Setup: opens validation automatically after setup completes.

Recommended setup order

1. Create or open your gameplay scene.
2. Place your player and camera.
3. Ensure walkable ground has valid NavMesh data if you want GPS trail arrows.
4. Open the Setup Wizard.
5. Assign the player object, active objective and XRay input action.
6. Enable only the systems you want the wizard to create.
7. Run setup.
8. Run diagnostics from the Diagnostics tab.
9. Enter Play Mode and test scanner mode.

Replacing demo content

When you are ready to add Zion XRay to your own level, remove or disable generated demo targets, then add ZionXRayTarget and ZionXRayTargetHighlighter to your real gameplay objects as needed.