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