---

name: horde-wave-logic description: "Wave spawning system for Tower Defense and Survival games. Configurable waves, enemy types, intervals, and difficulty scaling." version: 1.0.0 tags: ["spawner", "horde", "waves", "enemies", "tower-defense"] argument-hint: "action='StartWave' config='Wave1' OR spawn='Zombie_Fast'" disable-model-invocation: false user-invocable: true allowed-tools:

• run_command
• list_dir
• write_to_file

---

Horde & Wave Logic

Overview

Manages the pacing and spawning of enemy units. Uses ScriptableObjects to define wave configurations, allowing designers to tweak difficulty without touching code.

When to Use

• Use for Tower Defense games
• Use for "Horde Mode" survival
• Use for timed enemy assaults
• Use for testing combat balance
• Use for creating "Boss Waves"

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    WAVE CONTROLLER                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  WAVE CONFIG (Asset)      SPAWNER (MonoBehaviour)           │
│  ┌────────────────┐      ┌───────────────────────────┐      │
│  │ Wave 1:        │      │ State: Waiting/Spawning   │      │
│  │ - 10 Zombies   │─────▶│ Timer: 30s                │      │
│  │ - Rate: 0.5s   │      │ Coroutine: SpawnLoop()    │      │
│  └────────────────┘      └─────────────┬─────────────┘      │
│                                        │                    │
│                                        ▼                    │
│    OBJECT POOL            ┌───────────────────────────┐     │
│  ┌────────────────┐       │ Instantiate / GetFromPool │     │
│  │ Zombie Prefab  │◀──────│ Set Position (SpawnPoint) │     │
│  └────────────────┘       └───────────────────────────┘     │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Best Practices

• ✅ Use Object Pooling for enemies (Critical for performance).
• ✅ Define Waves as ScriptableObjects (List of Waves).
• ✅ Include "Warmup" time between waves.
• ✅ Support multiple Spawn Points.
• ✅ Implement "Wave Cleared" logic (Track active enemy count).
• ❌ NEVER Instantiate enemies during the loop without pooling.
• ❌ NEVER use InvokeRepeating (hard to control); use Coroutines.

Few-Shot Examples

Example 1: Wave Config Data

User: "Create data for a wave."

Agent:

[CreateAssetMenu]
public class WaveData : ScriptableObject
{
    public GameObject EnemyPrefab;
    public int Count;
    public float SpawnRate;
}

Example 2: Spawner Logic

User: "Spawn the wave."

Agent:

IEnumerator SpawnWave(WaveData wave)
{
    for (int i = 0; i < wave.Count; i++)
    {
        SpawnEnemy(wave.EnemyPrefab);
        yield return new WaitForSeconds(wave.SpawnRate);
    }
}

Related Skills

• @object-pooling-system - Required for spawner
• @unit-population-ai - AI for spawned units
• @unity-events-messaging - "Wave Start/End" events