object-pooling

name	object-pooling
description	Object pooling patterns — Unity ObjectPool<T>, custom ComponentPool, warm-up strategies, return-to-pool lifecycle. Eliminates runtime Instantiate/Destroy overhead.
alwaysApply	true

Object Pooling

Every Instantiate() allocates memory. Every Destroy() triggers GC. Pool objects you create and destroy frequently: projectiles, particles, enemies, pickups, audio sources.

Unity Built-In ObjectPool (2021+)

using UnityEngine.Pool;

public sealed class ProjectilePool : MonoBehaviour
{
    [SerializeField] private Projectile m_Prefab;
    [SerializeField] private int m_DefaultCapacity = 20;
    [SerializeField] private int m_MaxSize = 100;

    private ObjectPool<Projectile> m_Pool;

    private void Awake()
    {
        m_Pool = new ObjectPool<Projectile>(
            createFunc: CreateProjectile,
            actionOnGet: OnGetProjectile,
            actionOnRelease: OnReleaseProjectile,
            actionOnDestroy: OnDestroyProjectile,
            collectionCheck: false,
            defaultCapacity: m_DefaultCapacity,
            maxSize: m_MaxSize
        );
    }

    public Projectile Get() => m_Pool.Get();

    public void Release(Projectile projectile) => m_Pool.Release(projectile);

    private Projectile CreateProjectile()
    {
        Projectile projectile = Instantiate(m_Prefab);
        projectile.SetPool(this);
        return projectile;
    }

    private void OnGetProjectile(Projectile projectile)
    {
        projectile.gameObject.SetActive(true);
    }

    private void OnReleaseProjectile(Projectile projectile)
    {
        projectile.gameObject.SetActive(false);
    }

    private void OnDestroyProjectile(Projectile projectile)
    {
        Destroy(projectile.gameObject);
    }
}

// Projectile returns itself to pool
public sealed class Projectile : MonoBehaviour
{
    private ProjectilePool m_Pool;

    public void SetPool(ProjectilePool pool) => m_Pool = pool;

    public void ReturnToPool()
    {
        m_Pool.Release(this);
    }
}

Warm-Up (Pre-Spawn)

Pre-instantiate objects during loading to avoid runtime hitches:

private void Start()
{
    // Pre-warm the pool
    List<Projectile> temp = new List<Projectile>();
    for (int i = 0; i < m_DefaultCapacity; i++)
    {
        temp.Add(m_Pool.Get());
    }
    for (int i = 0; i < temp.Count; i++)
    {
        m_Pool.Release(temp[i]);
    }
    temp.Clear();
}

Return-to-Pool Lifecycle

The key contract: objects must reset their state when returned to pool.

private void OnReleaseProjectile(Projectile projectile)
{
    // Reset state
    projectile.transform.position = Vector3.zero;
    projectile.transform.rotation = Quaternion.identity;
    projectile.ResetState(); // Clear velocity, damage flags, timers

    // Deactivate
    projectile.gameObject.SetActive(false);
}

When to Pool

Pool these:

• Projectiles (bullets, arrows, spells)
• Particle effects
• Audio sources (one-shot sounds)
• Enemies in wave-based games
• Pickup items
• Damage numbers / floating text
• Trail renderers

Don't pool these:

• One-time objects (boss, unique NPCs)
• Tiny objects created once (data containers)
• Objects that live the entire scene

Pool Sizing

• Start small — 10-20 instances for most pools
• Monitor — if you see Instantiate in Profiler during gameplay, increase pool size
• Max cap — set maxSize to prevent unbounded growth (e.g., 100-200)
• Per-level tuning — different levels may need different pool sizes

Generic Pool Manager

public sealed class PoolManager : MonoBehaviour
{
    private readonly Dictionary<GameObject, ObjectPool<GameObject>> m_Pools = new();

    public GameObject Get(GameObject prefab, Vector3 position, Quaternion rotation)
    {
        if (!m_Pools.ContainsKey(prefab))
        {
            m_Pools[prefab] = new ObjectPool<GameObject>(
                () => Instantiate(prefab),
                obj => obj.SetActive(true),
                obj => obj.SetActive(false),
                obj => Destroy(obj),
                false, 10, 100
            );
        }

        GameObject obj = m_Pools[prefab].Get();
        obj.transform.SetPositionAndRotation(position, rotation);
        return obj;
    }

    public void Release(GameObject prefab, GameObject instance)
    {
        m_Pools[prefab].Release(instance);
    }
}

Cached WaitForSeconds

Don't forget to pool WaitForSeconds:

// BAD — allocates every time
yield return new WaitForSeconds(0.5f);

// GOOD — cache and reuse
private readonly WaitForSeconds m_HalfSecond = new WaitForSeconds(0.5f);
yield return m_HalfSecond;