Use this guide to add a new playable level and configure its reward/progression behavior.

How Level Loading Works

• Current level index is stored in GameModel as "Level".
• On load, the game picks prefab from GameConfig "LevelPrefabs" by index = model "Level".
• Source: GameLoadLevelState.

Important Level Limit Behavior

• If model "Level" is greater than or equal to "LevelPrefabs".Length, the game does not crash.
• It clamps level index to last available prefab:
  1. level = "LevelPrefabs".Length - 1
  2. model "Level" is overwritten with that clamped value and saved
• Result: the game keeps loading the last configured level index until you add more level prefabs.

How Win Progression and Reward Work

• Reward is configured per level in LevelView field "_reward".
• On win, WinHudMediator does:
  1. Reads reward from LevelView "Reward" ("_reward")
  2. Adds reward to model cash via "PlusResource"
  3. Increments model "Level" by 1
  4. Updates region progress using GameConfig "RegionProgressStep"
  5. Saves model
• Win screen shows this reward amount.

Mandatory Team Setup for Every Level

• You must have at least:
  1. Building with TeamIDType.Player
  2. Building with TeamIDType that is not Player (Neutral or enemy team)
• Why:
  1. Win is triggered when all buildings become Player team
  2. Lose is triggered when there are no Player-team buildings left
• If your level has only Player buildings or no Player building, level-end behavior can be invalid for normal gameplay flow.

Config Fields You Must Know

• GameConfig:
  1. "LevelPrefabs" - ordered list of all level prefabs
  2. "LevelEndHudDelay" - delay before win/lose HUD
  3. "RegionProgressStep" - percent progress added per completed level
  4. "DefaultLevel" - used for new/reset game model
• Level prefab (LevelView):
  1. "_reward" - cash reward for completing that level

Main Procedure: Add a New Level

Step 1: Create Level Prefab

1. Duplicate an existing level prefab from: Assets/GorodiskiGames/TowerClash/ResourcesStatic/Prefabs/Levels/

2. Rename it using project style, for example Level14.prefab.

3. Open prefab and edit layout, buildings, and props (trees, wooden box) to block path creation.

4. With Scene Gizmos enabled, each building uses BuildingView gizmos: a wire sphere at the building transform with radius "_radius" and wire color from "_teamID" (helps spacing and footprint checks).

5. Ensure root object has LevelView component.

6. Ensure level contains at least one Player building and at least one non-Player building.

Step 2: Set Reward on the Level Prefab

1. Select the root LevelView component.
2. Set "_reward" to desired cash amount.
3. Save prefab.

Step 3: Register Level in GameConfig

1. Open GameConfig asset: Assets/GorodiskiGames/TowerClash/Resources/GameConfig.asset
2. Find "LevelPrefabs".
3. Increase array size by 1.
4. Add your new level prefab at the end.