Quick Start

Overview

This guide gets you from a fresh Unity project to an interactive spinning globe in under 5 minutes.

Step 1 - Import the Asset

1. Open or create a Unity project (2022.3 LTS or newer).
2. Import World Map Globe Edition from the Unity Asset Store via Window > Package Manager.
3. Wait for the import to complete. The asset is installed under Assets/WorldPoliticalMapGlobeEdition/.

Step 2 - Open a Demo Scene

1. Navigate to Assets/WorldPoliticalMapGlobeEdition/Demos/ in the Project window.
2. Open any demo scene (e.g., 001 GeneralDemo).
3. Press Play.

You should see a rotating 3D globe. Use the mouse to:

• Left-click + drag - rotate the globe
• Scroll wheel - zoom in/out
• Hover over a country - see it highlight
• Click a country - select it

Step 3 - Add the Globe to Your Own Scene

1. Create a new scene or open your existing scene.
2. Drag the WorldMapGlobe prefab from Assets/WorldPoliticalMapGlobeEdition/Prefabs/ into your scene hierarchy.
3. The globe appears at the origin. Adjust its position and scale as needed.
4. Press Play - the globe is fully interactive.

Step 4 - Explore the Inspector

Select the WorldMapGlobe object in the hierarchy. The Inspector shows the main component with categorized sections:

• Earth Settings - globe style, texture, rotation
• Countries - frontiers, highlighting, coloring
• Provinces - state/province borders and detail level
• Cities - city markers, population filter, class filter
• Labels - country/city label appearance
• Interaction - zoom, rotation speed, drag behavior

Try changing the Earth Style dropdown to see different visual styles (Natural, Scenic, Alternate, etc.).

Step 5 - Basic Scripting

Create a new C# script and add this minimal example:

using UnityEngine;
using WPM;

public class GlobeQuickStart : MonoBehaviour
{
    void Start()
    {
        WorldMapGlobe map = WorldMapGlobe.instance;

        // Fly to Spain
        int spainIndex = map.GetCountryIndex("Spain");
        map.FlyToCountry(spainIndex);

        // Colorize France in blue
        int franceIndex = map.GetCountryIndex("France");
        map.ToggleCountrySurface(franceIndex, true, Color.blue);
    }
}

1. Attach this script to any GameObject in the scene.
2. Press Play - the globe flies to Spain, and France turns blue.

Included Demo Scenes

The asset includes numerous demo scenes in the Demos/ folder. Each demonstrates a specific feature:

• 001 GeneralDemo - basic interaction, highlighting, fly-to
• Navigation demos - path finding between countries
• Hex grid demos - hexagonal overlay with path finding
• Tile map demos - online tile integration
• VR demo - virtual reality setup

Each demo scene has a Demo GameObject with an attached script you can study to learn the API.

Next Steps

• How to Use the Asset - detailed configuration reference
• Scenic Styles - explore the 7 rendering styles
• Programming Guide - full scripting overview
• Earth Globe API - complete API reference