ZionGames Docs

Home / Zion Modules / Zion XRay

🧩 Zion XRay

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

HUD & World Markers

Zion XRay can present target information both on the screen and in the world. This helps players understand what the current objective is, how far away it is and which direction to travel.

HUD responsibilities

  • Show scanner active/inactive state.
  • Show current objective name.
  • Show current objective distance.
  • Show optional compass heading.
  • Show keyboard or gamepad control hints.
  • Show scan reticle and scanner overlay effects.

HUD customisation

Version 1.1 includes HUD presentation options for scanner status text, objective title, distance display, control hints and optional compass heading. Generated UI Toolkit assets are placed under the generated UI folder when the Setup Wizard creates the HUD.

World markers

World markers can show target type, name, distance, optional icon and active-objective emphasis. They are useful for objectives that are far away, above the player, below the player or temporarily off-screen.

Marker presentation options

  • Target type colours for Objective, Enemy, Pickup, Interactable and Custom/Object targets.
  • Optional icons per target type.
  • Active objective marker scale and styling.
  • Marker size adjustment.
  • Marker opacity adjustment.
  • Distance fading.
  • Screen-edge indicators for off-screen targets.
  • Target-level flags for showing name, distance and marker information.

Recommended marker behaviour

  • Make the active objective visually stronger than other markers.
  • Use target-type colours consistently.
  • Use distance fade so far-away targets do not dominate the screen.
  • Clamp important off-screen markers toward the edge of the display where appropriate.
  • Avoid showing too many permanent markers at once.
  • Use scanner mode to reveal additional optional markers.
Usability tip: The GPS trail should be the primary guidance method for nearby navigation. World markers are most useful as a secondary orientation tool.