Troubleshooting

intermediate troubleshooting

World Map 2D Edition · Troubleshooting & FAQ

Troubleshooting

Common issues and solutions for World Map 2D Edition.

Map Not Visible

Symptom	Solution
Map does not appear at all	Ensure the WorldMap2D prefab is in the scene. Check that the main camera can see the map (verify layer mask and distance).
Map appears but no frontiers	Check that Show Frontiers is enabled in the inspector.
Map is black or missing texture	Verify that Show Earth is enabled and an Earth Style is selected. Ensure the texture files exist in `Resources/Textures`.
Map appears in wrong position	Check the transform position and scale of the WorldMap2D GameObject. If using a viewport, verify the viewport assignment.

Interaction Issues

Symptom	Solution
Countries don't highlight on hover	Ensure Country Highlight Enabled is checked. Verify no UI Canvas is blocking raycasts.
Click events not firing	Verify you are subscribed to the correct event (`OnCountryClick`, `OnProvinceClick`, `OnCityClick`). Check that respectOtherUI is not blocking input.
Map panning or zoom not working	Check that Allow User Rotation and Allow User Zoom are enabled. Ensure no other script is consuming the mouse input.

Viewport Issues

Symptom	Solution
Map extends beyond viewport	Ensure the Viewport GameObject is properly assigned in the Render Viewport field.
Screen Overlay Mode not working	Screen Overlay Mode requires a Viewport to be assigned first. Check the normalized rectangle values.

Performance Issues

Symptom	Solution
Low frame rate	Switch Frontiers Detail to Low. Reduce the number of visible cities with Min Population. Disable province borders if not needed.
Large build size	See Reducing Build Size for tips on removing unused assets.
Map Editor is slow with large countries	The high-definition geodata file has many points. Large countries (Russia, Antarctica) may be slow to edit. Consider working with the low-definition file first.

Build & Platform Issues

Symptom	Solution
Missing textures on mobile	Ensure texture compression settings are appropriate for your target platform. Check that textures are included in the build (not stripped by Unity).
Compilation errors after import	Ensure you are using Unity 2022.3 or later. Delete the `Library` folder and reimport if issues persist.

Still Having Issues?

Visit the Kronnect Support for assistance. Include your Unity version, render pipeline, and a description of the issue.

Was this page helpful? |