player: Add events for ball creation and destruction.

Author: freezy

VisualPinball.Unity/VisualPinball.Unity/Game/Player.cs

@@ -52,6 +52,9 @@ public class Player : MonoBehaviour
 
 		public event EventHandler OnUpdate;
 
+		public event EventHandler<BallEvent> OnBallCreated;
+		public event EventHandler<BallEvent> OnBallDestroyed;
+
 		[HideInInspector] [SerializeField] public string debugUiId;
 		[HideInInspector] [SerializeField] public string physicsEngineId;
 
@@ -485,6 +488,15 @@ public void OnEvent(in EventData eventData)
 			}
 		}
 
+		internal void BallCreated(Entity ballEntity, GameObject ball)
+		{
+			OnBallCreated?.Invoke(this, new BallEvent(ballEntity, ball));
+		}
+		internal void BallDestroyed(Entity ballEntity, GameObject ball)
+		{
+			OnBallDestroyed?.Invoke(this, new BallEvent(ballEntity, ball));
+		}
+
 		#endregion
 
 		#region API
@@ -579,4 +591,16 @@ private static void HandleInput(object obj, InputActionChange change)
 			}
 		}
 	}
+
+	public readonly struct BallEvent
+	{
+		public readonly Entity BallEntity;
+		public readonly GameObject Ball;
+
+		public BallEvent(Entity ballEntity, GameObject ball)
+		{
+			BallEntity = ballEntity;
+			Ball = ball;
+		}
+	}
 }

VisualPinball.Unity/VisualPinball.Unity/VPT/Ball/BallManager.cs

@@ -148,12 +148,17 @@ public void CreateEntity(GameObject ballGo, int id, in float3 worldPos, in float
 			}
 
 			NumBalls++;
+
+			_player.BallCreated(entity, ballGo);
 		}
 
 		public void DestroyEntity(Entity ballEntity)
 		{
+			var ballGo = _player.Balls[ballEntity];
+			_player.BallDestroyed(ballEntity, ballGo);
+
 			// destroy game object
-			Object.DestroyImmediate(_player.Balls[ballEntity]);
+			Object.DestroyImmediate(ballGo);
 			_player.Balls.Remove(ballEntity);
 
 			// destroy entity