---
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**:
```csharp
[CreateAssetMenu]
public class WaveData : ScriptableObject
{
    public GameObject EnemyPrefab;
    public int Count;
    public float SpawnRate;
}
```

### Example 2: Spawner Logic
**User**: "Spawn the wave."

**Agent**:
```csharp
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