Troubleshooting

intermediate troubleshooting

Compass Navigator Pro 3 · Troubleshooting & FAQ

Common issues and their solutions when working with Compass Navigator Pro.

Symptom	Cause & Fix
Compass bar does not appear	Ensure the `CompassNavigatorPro` prefab is in the scene. Check that Alpha is greater than 0 and Show Compass Bar is enabled.
POIs not visible on the bar	Verify the POI's Visibility on Compass Bar is not set to Hidden. Check that the POI is within the Visible Max Distance configured on the compass.
Mini-map shows a black or empty view	Check the mini-map Layer Mask includes the layers your terrain and objects are on. Ensure the Camera Altitude is high enough.
Mini-map shows post-processing artifacts (HDRP)	Select the TopDownCamera child of CompassNavigatorPro and set its Volume Mask to Nothing.
Fog of war not clearing	Make sure Auto-Clear Fog is enabled and the follow transform is assigned. Verify the fog Center & Size covers the play area.
POI icons appear stretched or wrong size	Check the sprite Pixels Per Unit setting. Icons expect 128×128 base; compass bar expects 32 px height base. See Custom Art.
Beacons not appearing	Ensure you are calling `POIShowBeacon()` and that the POI is registered. Check that the beacon material at `Resources/Materials/Beacon` is not missing.
Multiple compass instances not working	Verify each instance has a unique Compass Group ID and that POIs have the correct Compass Group Mask. See Multiple Instances.
Scan effect not triggering	Make sure a Scan Profile is assigned in the inspector or passed via `Scan(profile)`.
Performance issues with many POIs	Enable the Area of Interest system and reduce Visible Max Distance. See Performance Tips.

If your issue is not listed here, visit the Kronnect Support.

Was this page helpful? |