Troubleshooting

Installation Issues

Map does not appear after import

• Ensure you added the map via GameObject > 3D Object > World Map Strategy Kit Map.
• Check that the camera can see the map — the default map is placed at the origin with a specific scale.
• If using URP, make sure you upgraded project materials (Edit > Rendering Pipeline > URP > Upgrade Project Materials).

Pink/magenta materials in URP

• Run Edit > Rendering Pipeline > Universal Rendering Pipeline > Upgrade Project Materials.
• Set Depth Priming Mode to Disabled in the Universal Renderer asset (required for forward rendering).

Terrain mode shaders not working in URP

Import the URP terrain shader package located in WMSK/Resources/WMSK/Shaders/LWRP/TerrainShaders. These native URP shaders are only compatible with the forward rendering path.

Runtime Issues

Country/province highlighting not working

• Verify that Enable Country Highlight is checked in the inspector under Countries Settings.
• Check that your EventSystem is present in the scene and that no UI element is blocking raycasts.
• If using the New Input System, set Active Input Handling to Both in Player Settings.

Online tiles not loading

• Go to Project Settings > Player > Other Settings and set Allow Downloads Over HTTP to Always Allowed.
• Check your internet connection and verify the tile server URL is correct.
• Some tile providers require an API key — make sure it is configured.

Pathfinding returns no path

• Ensure the start and end points are on the map (valid coordinates).
• Check that cells along the route have canCross = true.
• In hexagonal grid mode, verify the grid is enabled and properly configured.

Units not moving or disappearing

• Units must be added via the API (WMSK_MoveTo) to be tracked by the system.
• Check the GameObjectAnimator component on the unit for correct settings.
• Ensure the destination coordinates are within map bounds.

Performance Issues

Low frame rate with many countries highlighted

• Reduce the geodata resolution — use the low-definition frontier file if you do not need province-level detail.
• Disable province highlighting if not needed.
• Use enableCountryHighlight = false when running batch operations, then re-enable.

High memory usage with 16K textures

• The 16K Earth style uses multiple large textures. Use a lower resolution style for mobile or WebGL.
• Consider using the online tile system instead for high-zoom scenarios.

Editor Issues

Map Editor changes not saving

• Always click Save in the Map Editor toolbar after making changes.
• Determine whether you need the high-def or low-def file before editing — changes to one do not transfer to the other.
• Back up your geodata files before making extensive edits.

Still Need Help?

Visit the Kronnect Support for direct assistance from the development team and access to the latest beta releases.