> For the complete documentation index, see [llms.txt](https://infinitypbr.gitbook.io/magic-pig-games/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitypbr.gitbook.io/magic-pig-games/northstar-nav-and-tracking/northstar-documentation/tracked-target-overlay.md).

# Tracked Target Overlay

Add the **Tracked Target Overlay** component to any object you'd like to track with the Navigation Bar, Screen Overlay or Edge Overlay.

<figure><img src="/files/WQYyc7yWZF545qifqGPi" alt=""><figcaption></figcaption></figure>

In the top section you can set specific values for each Tracked Target, including its [**type**](broken://pages/lpg9yssrNKQIwoZPMYpt). Lower in the Inspector (not seen in screenshot) you can set specific [**override values**](broken://pages/md72vzCzYfdZXMlE6TR9).

## Public Members

Once the TrackedTargetOverlay is active in the scene, you can access the icons.

{% hint style="success" %}
Check the [**Code Examples**](broken://pages/xQFZB6UFuzzd6LSmUz2M) page for some...code examples!
{% endhint %}

```csharp
public TrackedTargetOverlay trackedTargetOverlay;

// Get the Screen/Edge Icon, or the Navigation Bar Icon
OverlayIcon screenIcon = trackedTargetOverlay.ScreenIcon;
OVerlayIcon navigationBarIcon = trackedTargetOverlay.NavigationBarIcon;

// Access the overlay settings assigned to this TrackedTargetOverlay
NorthstarOverlaySettings overlaySettings = trackedTargetOverlay.overlaySettings;
```

## Options

### Layer Order

This determines which icons are on top. Negative values will be hidden by icons with higher values.

### Icon Position Offset

This will offset the icon from the position of the object it is attached to. In the demo scene, the berries object has an offset of `(0, 1, 0)` so the icon appears 1m above the position of the "Berries" object.

<figure><img src="/files/011bYz78dCtDWo0b3Cpq" alt=""><figcaption></figcaption></figure>

### Northstar Overlay Settings

Each Tracked Target will need to specify a [**Northstar Overlay Settings**](broken://pages/6PnVEoCS4SZqpE0HNtDP) object to use when overriding values. This should be a different settings object than the one attached to the Northstar Screen Overlay and Navigation Bar.

This Scriptable Object has all the settings for how an icon may appear in the Screen Overlay, Edge Overlay, and Navigation Bar. Each Tracked Target can select which, if any, aspects to override.

## Custom Icon Prefabs

You can choose to set custom icons to use for the various systems as well. The **Custom Screen Icon** will be used for the Screen Overlay, while the **Custom Navigation Bar Icon** will be used for the Navigation Bar.

{% hint style="info" %}
**Customize Icon Logic**

Check the demo scene to see how the Berries utilize a custom prefab for screen overlay, which shows a progress bar as the play collects the pickup.

Check the Demo Goal Target to see how the distance has been added to the icon for the goal target.
{% endhint %}

## Navigation Bar Options

You can select a fixed angle for objects when the appear on the Navigation Bar. Generally this is used for Evergreen Objects, such as tick marks and cardinal directions.

## Radar Options

If there is a [**Tracked Target Compass Radar**](broken://pages/jL3SgxAPl3ewkqFdOrZh) component also on the object, then you can opt to ignore the radar. When true, objects will not fade with the radar ping, and will continue to update their position, regardless of teh Radar settings.

## Override Values

Each Tracked Target can optionally choose to override specific values. Learn more below.

{% content-ref url="/pages/NzRWbyfnXUpfB4Gdtezd" %}
[Broken mention](broken://pages/NzRWbyfnXUpfB4Gdtezd)
{% endcontent-ref %}