ZionGames Docs

Home / Zion Modules / Zion XRay

🧩 Zion XRay

Scanner mode, world markers, GPS objective trails and setup diagnostics for Unity 6.

Scanner Mode

ZionXRayController manages input, scanner activation, scan timing, HUD state and GPS visibility. It is the main runtime component for the player-side scanner experience.

Controller settings

Setting Description
Scanner Reference to the ZionXRayScanner component.
GPS Trail Reference to the ZionXRayGpsTrail component.
XRay Input Action The Unity Input System action used to activate scanner mode.
Hold To Activate When enabled, scanner mode is active while input is held. When disabled, input toggles scanner mode.
Scan Interval How often the scanner refreshes target data.
Show GPS Trail When Active Automatically shows the GPS trail when scanner mode starts.
Log Visible Targets Logs detected targets in the Unity Console for development and debugging.

Hold mode

Hold mode is useful when scanner mode is a temporary player tool. The player holds the XRay button, checks their target and releases it to return to normal gameplay.

Toggle mode

Toggle mode is useful when scanner mode represents a longer tactical state. Press the XRay input once to activate it, then press again to turn it off.

Scanner HUD feedback

Scanner mode can update the UI Toolkit HUD with active state, objective name, distance, optional compass heading and control hints. HUD visibility and presentation are configured through generated HUD presentation settings.

Scanner state

if (xrayController.IsScannerActive)
{
    // Scanner mode is active.
}
Performance: Keep scan intervals sensible. A short interval makes the scanner feel responsive, but scanning every frame is rarely necessary for normal objective guidance.