Troubleshooting

Overview

This page covers common issues when working with World Map Globe Edition and their solutions. If your problem is not listed here, check the FAQ or visit the Kronnect support forum.

Globe Not Visible or Renders Black

Symptoms

The globe does not appear in the Game view, or it renders as a solid black sphere.

Solutions

• Check camera distance — ensure the camera is positioned to see the globe. The default prefab is at the origin; your camera should be at approximately (0, 0, -3) looking forward.
• URP Depth Priming — if using URP with Forward rendering, set Depth Priming Mode to Disabled in the Universal Renderer asset. This is the most common cause of rendering issues.
• HDRP Volume — ensure your HDRP Volume has proper sky and fog settings. The globe shaders need correct lighting.
• Shader errors — check the Console for pink/magenta materials or shader compilation errors. Re-import the asset if needed.

Countries Not Highlighting on Hover

Solutions

• EventSystem required — ensure your scene has an EventSystem GameObject (Unity creates one automatically with UI Canvas, or add one via GameObject > UI > Event System).
• Raycast check — the globe uses physics raycasting. Make sure no invisible colliders or UI elements are blocking the raycast.
• Enable interaction — in the Inspector, verify that Enable Country Highlight is checked under the Countries section.

Online Tile Maps Not Loading

Solutions

• HTTP permission — go to Project Settings > Player > Other Settings and set Allow Downloads Over HTTP to Always Allowed.
• Firewall/proxy — check that your machine can reach the tile server. Some corporate networks block tile requests.
• Server URL — verify the tile server URL format. Different providers use different URL patterns (e.g., {z}/{x}/{y} vs {z}/{y}/{x}).
• Rate limiting — some free tile servers impose request limits. If tiles appear intermittently, you may be hitting the rate limit.

Performance Issues / Low Frame Rate

Solutions

• Reduce frontier detail — use a lower-resolution frontier dataset if you do not need province-level detail at all times.
• Limit cities — filter cities by population to reduce the number of rendered city markers.
• Disable unused features — turn off provinces, hex grid, or fog of war if not needed.
• Bake textures — if colorizing many countries, use the Bake Texture command instead of runtime colorization.
• See the full Performance Tips page for detailed optimization strategies.

Build Size Too Large

Solutions

• Remove unused geodata — delete high-resolution frontier files you do not use from the Resources folder.
• Strip shaders — remove shader variants for styles you do not use. See the Shaders Reference for a list of which shaders map to which features.
• Compress textures — use platform-appropriate texture compression for Earth textures.
• See the full Build Size & Performance Tips page for more detail.

VR-Specific Issues

Solutions

• XR Plugin Management — ensure the correct XR plugin is installed and enabled for your target headset.
• Input system — World Map Globe Edition supports both the legacy Input Manager and the new Input System. Check that your VR controller input is correctly mapped.
• Stereo rendering — the globe shaders support single-pass instanced rendering. If you see visual artifacts, verify your XR settings use this mode.
• See the Virtual Reality guide for full setup instructions.

Provinces / States Not Appearing

Solutions

• Enable provinces — in the Inspector, check Show Provinces under the Provinces section.
• Province data file — ensure the province geodata file is present in the Resources folder. It may have been deleted to reduce build size.
• Zoom threshold — provinces may only appear when zoomed in past a certain threshold. Check the Provinces Zoom Level setting.

Labels Not Rendering or Look Wrong

Solutions

• Font asset — the asset ships with Lato and Colwella fonts. If the font reference is missing, re-assign it in the Inspector under Labels.
• Custom fonts — custom fonts must use Unicode character set and not be marked as Dynamic. See Custom Fonts for setup instructions.
• Label size — if labels are too small or too large, adjust the Label Size multiplier in the Inspector.

Unity Editor Crashes or Freezes

Solutions

• Large geodata in Inspector — avoid expanding very large arrays (countries, provinces) in the Inspector debug mode, as this can freeze the editor.
• Script compilation — if you have compiler errors in your project, the globe component may not initialize. Fix all errors first.
• Reimport — right-click the WorldPoliticalMapGlobeEdition folder and select Reimport.

Still Stuck?

If none of the above solutions work:

1. Check the FAQ for additional answers.
2. Search the Kronnect Support — your question may already be answered.
3. Post a new question with your Unity version, render pipeline, platform, and a description of the issue.