Region & Progression Setup

In SlingshotSquad Template, maps are grouped into regions. Each MapRegion contains multiple MapData entries, and completing a map can unlock the next one or even unlock a new region.

Step 1 – Organize Maps into Regions

  1. In the Map Selection Scene, locate the UIMapSelection component.

  2. Add your MapRegion prefabs to the mapRegionPrefabs array.

  3. Each MapRegion prefab contains an array of MapRegionData, which defines:

    • MapData → The ScriptableObject with level info.

    • SpawnPoint → The transform where the map entry button appears.

Step 2 – Configure Map Unlocks

Inside each MapData you can define progression rules:

  • nextMap → The map that will be unlocked when this one is completed.

  • unlockCharacter → Optionally unlocks a CharacterData when this map is cleared.

  • rewardItems → Rewards (currencies, boosters) given the first time the map is completed.

  • xpReward → XP given when the map is cleared.

This allows you to chain levels together in a progression path.

Step 3 – Player Progress Tracking

The PlayerSave system automatically tracks:

  • Which maps are unlocked.

  • How many stars the player earned in each map.

  • The last region the player visited.

When a new map is cleared:

  • Rewards are granted.

  • Stars are stored.

  • nextMap is unlocked if defined.

Step 4 – Navigating Between Regions

  • The UIMapSelection provides Previous and Next buttons.

  • Regions can only be navigated if they are unlocked.

  • A fade transition is applied when moving between regions for smooth UX.

✅ Example Setup

  1. Region 1 – Forest

    • Map 1 (unlocked by default).

    • Map 2 (unlocked by completing Map 1).

    • Map 3 (boss map, unlocks Region 2 when cleared).

  2. Region 2 – Desert

    • Map 4 (unlocked after boss in Region 1).

    • Map 5 → Map 6 (progression continues).

Typical Flow

  1. First Map Unlocked → Automatically ensured by UIMapSelection.EnsureFirstMapUnlocked().

  2. Play a Map → Stars, rewards, and unlocks are saved in PlayerSave.

  3. Complete Boss Map → Unlocks the next region (new set of maps).

  4. Navigate Regions → Player uses UI arrows to switch between available regions.

With this setup, you can easily create linear or branching campaigns by connecting MapData with nextMap references and grouping them into MapRegions.

PreviousCreating New MapsNext🎮 Gameplay Setup (Overview)

Last updated