sbox-public/engine/Sandbox.Engine/Scene/Components/Clutter/ClutterTile.cs

namespace Sandbox.Clutter;

/// <summary>
/// Represents a single tile in the clutter spatial grid.
/// Tracks spawned objects for cleanup when the tile is no longer needed.
/// </summary>
class ClutterTile
{
	/// <summary>
	/// Grid coordinates of this tile.
	/// </summary>
	public Vector2Int Coordinates { get; set; }

	/// <summary>
	/// World-space bounds of this tile.
	/// </summary>
	public BBox Bounds { get; set; }

	/// <summary>
	/// Random seed offset for deterministic generation.
	/// </summary>
	public int SeedOffset { get; set; }

	/// <summary>
	/// Whether this tile has been populated with clutter instances.
	/// </summary>
	public bool IsPopulated { get; internal set; }

	/// <summary>
	/// GameObjects spawned from prefab entries.
	/// </summary>
	internal List<GameObject> SpawnedObjects { get; } = [];

	/// <summary>
	/// Static physics bodies spawned for model entries with physics data.
	/// </summary>
	internal List<PhysicsBody> SpawnedBodies { get; } = [];

	internal void AddObject( GameObject obj )
	{
		if ( obj.IsValid() )
			SpawnedObjects.Add( obj );
	}

	internal void AddBody( PhysicsBody body )
	{
		if ( body.IsValid() )
			SpawnedBodies.Add( body );
	}

	internal void Destroy()
	{
		foreach ( var obj in SpawnedObjects )
			if ( obj.IsValid() ) obj.Destroy();

		foreach ( var body in SpawnedBodies )
			if ( body.IsValid() ) body.Remove();

		SpawnedObjects.Clear();
		SpawnedBodies.Clear();
		IsPopulated = false;
	}
}