ZionGames Docs
```cshtml

Home / Zion Modules / Zion XRay

🧩 Zion XRay

Scanner mode, active-objective highlighting, world markers and NavMesh GPS trails for Unity projects.

Scanner Mode

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

Controller settings

Setting Description
Scanner Reference to the ZionXRayScanner component.
GPS Trail Reference to the ZionXRayGpsTrail component.
Xray Action The Unity Input System action used to activate scanner mode.
Hold To Activate When enabled, the scanner is active while the input is held. When disabled, the input toggles scanner mode.
Scan Interval How often the scanner refreshes visible 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 state

Other systems can check whether scanner mode is currently active through:

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.