🧩 Zion XRay

Troubleshooting

For most setup issues, start by running:

Tools → Zion Games → Zion XRay → Diagnostics

Scanner input does not activate

• Check that XRay Input Action is assigned on ZionXRayController.
• Check that the Input Action has a valid binding.
• Check that the Input System package and project input settings are configured correctly.
• Check whether Hold To Activate matches the behaviour you expect.
• Check that another script is not disabling the assigned Input Action.
• Run diagnostics and confirm the XRay input action is valid.

GPS trail does not appear

• Check that ZionXRayGpsTrail is present and assigned to the controller.
• Check that scanner mode is active.
• Check that an active objective has been assigned.
• Check that your scene has a baked NavMesh.
• Check that player and objective are both on reachable NavMesh areas.
• Check that the GPS arrow prefab is assigned.
• Run diagnostics and confirm that a NavMesh route is valid.

XRay highlight does not appear

• Check that the target has ZionXRayTarget.
• Check that the target has ZionXRayTargetHighlighter.
• Check that the object has a supported renderer.
• Check that the target has been passed to SetGlobalActiveTarget(...).
• Check that another target is not still set as the active highlight target.
• Check that a valid highlight material is assigned.
• Use Force Show For Testing briefly to confirm the renderer and material are working.

One target remains permanently highlighted

• Check that Force Show For Testing is disabled.
• Check that the old objective is cleared when a new objective is set.
• Check that only one transform is passed to SetGlobalActiveTarget(...).

Target switches but XRay does not follow

Make sure your objective-switch code updates both systems:

objectiveProvider.SetActiveObjective(target);
ZionXRayTargetHighlighter.SetGlobalActiveTarget(target);

World marker does not show

• Check that the HUD and world marker system exist in the scene.
• Check that the target is registered as an XRay target.
• Check whether the marker is behind the camera or outside its visibility rules.
• Check whether the marker is configured for active objective only.
• Check marker presentation settings for opacity, distance fade and display flags.

Screen-edge marker looks clipped

• Check the marker edge padding in marker presentation settings.
• Check whether the marker is too large for the current screen size.
• Reduce active marker scale or increase edge padding if labels are clipped.
• Test with both 16:9 and ultrawide-style views if your game supports them.

Generated HUD USS warning

If Unity warns about unity-font-style, regenerate the HUD with the latest Setup Wizard or replace the old property with:

-unity-font-style: bold;