spawn-system

Spawn System

When to Use

Use this skill when:

• Spawning enemies or pickups
• Implementing wave-based gameplay
• Creating spawn points
• Managing entity pools
• Building procedural spawners
• Creating respawn systems

Core Principles

1. Pooling: Reuse entities instead of creating/destroying
2. Configurable: Data-driven spawn configuration
3. Wave Management: Support wave-based spawning
4. Spawn Points: Multiple spawn locations
5. Cooldowns: Limit spawn rates
6. Budget: Limit active entities

Spawn System Implementation

1. Spawn Components

// components/Spawner.ts
export interface SpawnConfig {
  prefabName: string;
  count?: number;
  interval?: number;
  maxActive?: number;
  spawnOnStart?: boolean;
}

export class Spawner {
  configs: SpawnConfig[] = [];
  timeSinceLastSpawn = 0;
  currentConfigIndex = 0;
  activeEntities: Entity[] = [];
  enabled = true;

  constructor(configs: SpawnConfig[]) {
    this.configs = configs;
  }

  addConfig(config: SpawnConfig): void {
    this.configs.push(config);
  }

  getCurrentConfig(): SpawnConfig | null {
    return this.configs[this.currentConfigIndex] ?? null;
  }

  nextConfig(): void {
    this.currentConfigIndex = (this.currentConfigIndex + 1) % this.configs.length;
    this.timeSinceLastSpawn = 0;
  }

  reset(): void {
    this.currentConfigIndex = 0;
    this.timeSinceLastSpawn = 0;
    this.activeEntities = [];
  }
}

// components/SpawnPoint.ts
export class SpawnPoint {
  radius: number = 0; // 0 = exact position, >0 = random within radius
  active: boolean = true;

  constructor(radius: number = 0) {
    this.radius = radius;
  }

  getRandomOffset(): Vector3 {
    if (this.radius === 0) {
      return new Vector3();
    }

    const angle = Math.random() * Math.PI * 2;
    const distance = Math.random() * this.radius;

    return new Vector3(
      Math.cos(angle) * distance,
      0,
      Math.sin(angle) * distance
    );
  }
}

2. Spawn System