From 81acd2584f107fc6fe941f5e7b33944aaaa5843a Mon Sep 17 00:00:00 2001
From: glowsoony <84847356+glowsoony@users.noreply.github.com>
Date: Sat, 13 Sep 2025 21:19:36 -0400
Subject: [PATCH 1/3] Update FlxSound.hx

---
 flixel/sound/FlxSound.hx | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/flixel/sound/FlxSound.hx b/flixel/sound/FlxSound.hx
index 168c52000a..6ce12168e8 100644
--- a/flixel/sound/FlxSound.hx
+++ b/flixel/sound/FlxSound.hx
@@ -126,6 +126,12 @@ class FlxSound extends FlxBasic
 	 * @since 4.1.0
 	 */
 	public var loopTime:Float = 0;
+
+	/**
+	 * In case of looping, the amount of times the sound can loop.
+	 * If not set / `null`, the sound loops normally if looped.
+	 */
+	public var loops:Null<Float>;
 	
 	/**
 	 * At which point to stop playing the sound, in milliseconds.
@@ -233,6 +239,7 @@ class FlxSound extends FlxBasic
 		_volumeAdjust = 1.0;
 		looped = false;
 		loopTime = 0.0;
+		loops = 0;
 		endTime = 0.0;
 		_target = null;
 		_radius = 0;
@@ -652,6 +659,16 @@ class FlxSound extends FlxBasic
 			
 		if (looped)
 		{
+			if (loops != null)
+			{
+				if (loops > 0)
+					loops--;
+			}
+			else
+			{
+				cleanup(autoDestroy);
+				return;
+			}
 			cleanup(false);
 			play(false, loopTime, endTime);
 		}

From 068e51f432409900aff2d33baa9981606031d585 Mon Sep 17 00:00:00 2001
From: glowsoony <84847356+glowsoony@users.noreply.github.com>
Date: Sat, 13 Sep 2025 21:21:55 -0400
Subject: [PATCH 2/3] Update FlxSound.hx

---
 flixel/sound/FlxSound.hx | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/flixel/sound/FlxSound.hx b/flixel/sound/FlxSound.hx
index 6ce12168e8..4683b4e0f2 100644
--- a/flixel/sound/FlxSound.hx
+++ b/flixel/sound/FlxSound.hx
@@ -663,11 +663,11 @@ class FlxSound extends FlxBasic
 			{
 				if (loops > 0)
 					loops--;
-			}
-			else
-			{
-				cleanup(autoDestroy);
-				return;
+				else
+				{
+					cleanup(autoDestroy);
+					return;
+				}
 			}
 			cleanup(false);
 			play(false, loopTime, endTime);

From b92d5c63b80f13c5ee8e332eb6ed81bc9fec1075 Mon Sep 17 00:00:00 2001
From: glowsoony <84847356+glowsoony@users.noreply.github.com>
Date: Sat, 13 Sep 2025 21:22:00 -0400
Subject: [PATCH 3/3] Update FlxSound.hx

---
 flixel/sound/FlxSound.hx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/flixel/sound/FlxSound.hx b/flixel/sound/FlxSound.hx
index 4683b4e0f2..885ad3f87c 100644
--- a/flixel/sound/FlxSound.hx
+++ b/flixel/sound/FlxSound.hx
@@ -669,6 +669,7 @@ class FlxSound extends FlxBasic
 					return;
 				}
 			}
+
 			cleanup(false);
 			play(false, loopTime, endTime);
 		}