ZionGames Docs

Home / Zion Modules / Zion XRay

🧩 Zion XRay

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

Overview Quick Start Setup Wizard Scanner Objectives & GPS XRay Highlights HUD & Markers Diagnostics Demo & Feature Test Integration Troubleshooting FAQ

What is Zion XRay?

Zion XRay is a controller-agnostic scanner and objective visualisation module for Unity 6. It combines scanner mode, a UI Toolkit HUD, world markers, active objective tracking, stable filled XRay highlighting and NavMesh GPS trails.

It is designed for third-person action, RPG, adventure, exploration, survival, stealth and mission-based games where the player needs help locating an objective without opening a map every few seconds.

Important: Zion XRay does not replace your player controller, camera controller, quest system, AI system, inventory system, combat system or interaction system. Your gameplay systems decide what the current objective is. Zion XRay visualises that objective for the player.

New in 1.1

  • Improved world-marker readability.
  • Stronger active objective marker styling.
  • Screen-edge indicators for off-screen targets.
  • Target type presets for Objective, Enemy, Pickup, Interactable and Custom/Object targets.
  • Optional marker icons and target-level display flags.
  • Marker size, opacity and distance fade presentation settings.
  • HUD presentation settings for scanner status, objective title, distance display and control hints.
  • Optional compass heading in the scanner HUD.
  • Diagnostics window for validating scene setup.
  • Diagnostics tab inside the Setup Wizard.
  • Optional feature-test layout tool for validating XRay systems away from your main demo scene.
  • Updated documentation, screenshots, setup video and store listing.

Core features

  • Scanner mode using the Unity Input System.
  • Hold-to-scan or toggle scanner activation.
  • Active objective name and distance display.
  • Stable filled XRay silhouette highlighting for the active objective.
  • Different target types for objectives, enemies, pickups, interactables and custom objects.
  • NavMesh GPS chevron trail leading the player toward the active objective.
  • World markers with target names, distances, colours, optional icons and active-objective emphasis.
  • Screen-edge marker behaviour for off-screen targets.
  • Sample objective switching for testing with keys 1–5 or D-Pad where configured.
  • Setup Wizard for creating a working player and demo configuration.
  • Diagnostics tools for checking common setup problems before Play Mode.

Target types

Target Type Typical Use Default Marker Meaning
Objective Main mission target, waypoint or destination Primary objective / cyan
Enemy Hostile character, threat or combat target Danger / red
Pickup Collectible, healing item, quest item or loot Collectible / green or yellow depending on presentation settings
Interactable Console, door, switch, terminal or mechanism Usable object / yellow or purple depending on presentation settings
Custom/Object Project-specific target or generic point of interest Custom project meaning / purple or configured colour

Recommended player experience

  1. The player activates scanner mode.
  2. The HUD indicates that XRay mode is active.
  3. The active objective becomes visually stronger than other targets.
  4. The active objective can receive a stable filled XRay highlight while scanner mode is active.
  5. A GPS trail appears on the ground and guides the player toward the target.
  6. World markers and edge indicators help the player keep orientation.
  7. Your gameplay system assigns the next objective and Zion XRay updates its visuals.
Recommended use: Use Zion XRay as optional player guidance, not as a replacement for level design. It works best when players can explore normally but have a clear scanner tool to use when they become lost.