From 75b9d0fe6666eba914fc87f5428414d8003c3edf Mon Sep 17 00:00:00 2001
From: rushiiMachine <33725716+rushiiMachine@users.noreply.github.com>
Date: Wed, 27 Dec 2023 23:02:45 -0800
Subject: [PATCH 001/930] Make flashlight scale with playfield

When the playfield is shrunk with mods such as BarrelRoll, flashlight does not account for this, making it significantly easier to play. This makes it scale along with the playfield.
---
 .../Mods/TestSceneOsuModFlashlight.cs         | 26 +++++++++++++++++++
 osu.Game/Rulesets/Mods/ModFlashlight.cs       | 13 +++++++++-
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
index a353914cd5..2438038951 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
@@ -1,8 +1,13 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Utils;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Rulesets.Osu.Objects;
+using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Tests.Mods
 {
@@ -21,5 +26,26 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
 
         [Test]
         public void TestComboBasedSize([Values] bool comboBasedSize) => CreateModTest(new ModTestData { Mod = new OsuModFlashlight { ComboBasedSize = { Value = comboBasedSize } }, PassCondition = () => true });
+
+        [Test]
+        public void TestPlayfieldBasedSize()
+        {
+            ModFlashlight mod = new OsuModFlashlight();
+            CreateModTest(new ModTestData
+            {
+                Mod = mod,
+                PassCondition = () =>
+                {
+                    var flashlightOverlay = Player.DrawableRuleset.Overlays
+                                                  .OfType<ModFlashlight<OsuHitObject>.Flashlight>()
+                                                  .First();
+
+                    return Precision.AlmostEquals(mod.DefaultFlashlightSize * .5f, flashlightOverlay.GetSize());
+                }
+            });
+
+            AddStep("adjust playfield scale", () =>
+                Player.DrawableRuleset.Playfield.Scale = new Vector2(.5f));
+        }
     }
 }
diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index 95406cc9e6..d714cd3c85 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -86,6 +86,7 @@ namespace osu.Game.Rulesets.Mods
             flashlight.Depth = float.MinValue;
 
             flashlight.Combo.BindTo(Combo);
+            flashlight.GetPlayfieldScale = () => drawableRuleset.Playfield.Scale;
 
             drawableRuleset.Overlays.Add(flashlight);
         }
@@ -102,6 +103,8 @@ namespace osu.Game.Rulesets.Mods
 
             public override bool RemoveCompletedTransforms => false;
 
+            internal Func<Vector2>? GetPlayfieldScale;
+
             private readonly float defaultFlashlightSize;
             private readonly float sizeMultiplier;
             private readonly bool comboBasedSize;
@@ -141,10 +144,18 @@ namespace osu.Game.Rulesets.Mods
 
             protected abstract string FragmentShader { get; }
 
-            protected float GetSize()
+            public float GetSize()
             {
                 float size = defaultFlashlightSize * sizeMultiplier;
 
+                if (GetPlayfieldScale != null)
+                {
+                    Vector2 playfieldScale = GetPlayfieldScale();
+                    float rulesetScaleAvg = (playfieldScale.X + playfieldScale.Y) / 2f;
+
+                    size *= rulesetScaleAvg;
+                }
+
                 if (isBreakTime.Value)
                     size *= 2.5f;
                 else if (comboBasedSize)

From eea87090fb613538e670611bb9e2ad830f23fd83 Mon Sep 17 00:00:00 2001
From: B3nn1 <B3nn1@users.noreply.github.com>
Date: Sat, 6 Jan 2024 19:25:49 +0100
Subject: [PATCH 002/930] Make `changeHandler` save changes to `PathTypes`

---
 .../Blueprints/Sliders/Components/PathControlPointVisualiser.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index 24e2210b45..0cef93fbb5 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -410,8 +410,10 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             var item = new TernaryStateRadioMenuItem(type?.Description ?? "Inherit", MenuItemType.Standard, _ =>
             {
+                changeHandler?.BeginChange();
                 foreach (var p in Pieces.Where(p => p.IsSelected.Value))
                     updatePathType(p, type);
+                changeHandler?.EndChange();
             });
 
             if (countOfState == totalCount)

From 26c0d1077a7a4d00fb9ae22bcb16dde08365b987 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 00:22:53 +0100
Subject: [PATCH 003/930] Refactor scale handling in editor to facilitate reuse

---
 .../Edit/OsuSelectionHandler.cs               | 142 +-----------
 .../Edit/OsuSelectionScaleHandler.cs          | 205 ++++++++++++++++++
 .../Edit/Compose/Components/SelectionBox.cs   |   2 -
 .../Components/SelectionBoxScaleHandle.cs     |  94 +++++++-
 .../Compose/Components/SelectionHandler.cs    |  10 +-
 .../Components/SelectionScaleHandler.cs       |  88 ++++++++
 osu.Game/Utils/GeometryUtils.cs               |   9 +
 7 files changed, 402 insertions(+), 148 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
 create mode 100644 osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index cea2adc6e2..c36b535bfa 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -3,7 +3,6 @@
 
 using System.Collections.Generic;
 using System.Linq;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
@@ -25,15 +24,6 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public partial class OsuSelectionHandler : EditorSelectionHandler
     {
-        [Resolved(CanBeNull = true)]
-        private IDistanceSnapProvider? snapProvider { get; set; }
-
-        /// <summary>
-        /// During a transform, the initial path types of a single selected slider are stored so they
-        /// can be maintained throughout the operation.
-        /// </summary>
-        private List<PathType?>? referencePathTypes;
-
         protected override void OnSelectionChanged()
         {
             base.OnSelectionChanged();
@@ -46,12 +36,6 @@ namespace osu.Game.Rulesets.Osu.Edit
             SelectionBox.CanReverse = EditorBeatmap.SelectedHitObjects.Count > 1 || EditorBeatmap.SelectedHitObjects.Any(s => s is Slider);
         }
 
-        protected override void OnOperationEnded()
-        {
-            base.OnOperationEnded();
-            referencePathTypes = null;
-        }
-
         protected override bool OnKeyDown(KeyDownEvent e)
         {
             if (e.Key == Key.M && e.ControlPressed && e.ShiftPressed)
@@ -135,96 +119,9 @@ namespace osu.Game.Rulesets.Osu.Edit
             return didFlip;
         }
 
-        public override bool HandleScale(Vector2 scale, Anchor reference)
-        {
-            adjustScaleFromAnchor(ref scale, reference);
-
-            var hitObjects = selectedMovableObjects;
-
-            // for the time being, allow resizing of slider paths only if the slider is
-            // the only hit object selected. with a group selection, it's likely the user
-            // is not looking to change the duration of the slider but expand the whole pattern.
-            if (hitObjects.Length == 1 && hitObjects.First() is Slider slider)
-                scaleSlider(slider, scale);
-            else
-                scaleHitObjects(hitObjects, reference, scale);
-
-            moveSelectionInBounds();
-            return true;
-        }
-
-        private static void adjustScaleFromAnchor(ref Vector2 scale, Anchor reference)
-        {
-            // cancel out scale in axes we don't care about (based on which drag handle was used).
-            if ((reference & Anchor.x1) > 0) scale.X = 0;
-            if ((reference & Anchor.y1) > 0) scale.Y = 0;
-
-            // reverse the scale direction if dragging from top or left.
-            if ((reference & Anchor.x0) > 0) scale.X = -scale.X;
-            if ((reference & Anchor.y0) > 0) scale.Y = -scale.Y;
-        }
-
         public override SelectionRotationHandler CreateRotationHandler() => new OsuSelectionRotationHandler();
 
-        private void scaleSlider(Slider slider, Vector2 scale)
-        {
-            referencePathTypes ??= slider.Path.ControlPoints.Select(p => p.Type).ToList();
-
-            Quad sliderQuad = GeometryUtils.GetSurroundingQuad(slider.Path.ControlPoints.Select(p => p.Position));
-
-            // Limit minimum distance between control points after scaling to almost 0. Less than 0 causes the slider to flip, exactly 0 causes a crash through division by 0.
-            scale = Vector2.ComponentMax(new Vector2(Precision.FLOAT_EPSILON), sliderQuad.Size + scale) - sliderQuad.Size;
-
-            Vector2 pathRelativeDeltaScale = new Vector2(
-                sliderQuad.Width == 0 ? 0 : 1 + scale.X / sliderQuad.Width,
-                sliderQuad.Height == 0 ? 0 : 1 + scale.Y / sliderQuad.Height);
-
-            Queue<Vector2> oldControlPoints = new Queue<Vector2>();
-
-            foreach (var point in slider.Path.ControlPoints)
-            {
-                oldControlPoints.Enqueue(point.Position);
-                point.Position *= pathRelativeDeltaScale;
-            }
-
-            // Maintain the path types in case they were defaulted to bezier at some point during scaling
-            for (int i = 0; i < slider.Path.ControlPoints.Count; ++i)
-                slider.Path.ControlPoints[i].Type = referencePathTypes[i];
-
-            // Snap the slider's length to the current beat divisor
-            // to calculate the final resulting duration / bounding box before the final checks.
-            slider.SnapTo(snapProvider);
-
-            //if sliderhead or sliderend end up outside playfield, revert scaling.
-            Quad scaledQuad = GeometryUtils.GetSurroundingQuad(new OsuHitObject[] { slider });
-            (bool xInBounds, bool yInBounds) = isQuadInBounds(scaledQuad);
-
-            if (xInBounds && yInBounds && slider.Path.HasValidLength)
-                return;
-
-            foreach (var point in slider.Path.ControlPoints)
-                point.Position = oldControlPoints.Dequeue();
-
-            // Snap the slider's length again to undo the potentially-invalid length applied by the previous snap.
-            slider.SnapTo(snapProvider);
-        }
-
-        private void scaleHitObjects(OsuHitObject[] hitObjects, Anchor reference, Vector2 scale)
-        {
-            scale = getClampedScale(hitObjects, reference, scale);
-            Quad selectionQuad = GeometryUtils.GetSurroundingQuad(hitObjects);
-
-            foreach (var h in hitObjects)
-                h.Position = GeometryUtils.GetScaledPosition(reference, scale, selectionQuad, h.Position);
-        }
-
-        private (bool X, bool Y) isQuadInBounds(Quad quad)
-        {
-            bool xInBounds = (quad.TopLeft.X >= 0) && (quad.BottomRight.X <= DrawWidth);
-            bool yInBounds = (quad.TopLeft.Y >= 0) && (quad.BottomRight.Y <= DrawHeight);
-
-            return (xInBounds, yInBounds);
-        }
+        public override SelectionScaleHandler CreateScaleHandler() => new OsuSelectionScaleHandler();
 
         private void moveSelectionInBounds()
         {
@@ -248,43 +145,6 @@ namespace osu.Game.Rulesets.Osu.Edit
                 h.Position += delta;
         }
 
-        /// <summary>
-        /// Clamp scale for multi-object-scaling where selection does not exceed playfield bounds or flip.
-        /// </summary>
-        /// <param name="hitObjects">The hitobjects to be scaled</param>
-        /// <param name="reference">The anchor from which the scale operation is performed</param>
-        /// <param name="scale">The scale to be clamped</param>
-        /// <returns>The clamped scale vector</returns>
-        private Vector2 getClampedScale(OsuHitObject[] hitObjects, Anchor reference, Vector2 scale)
-        {
-            float xOffset = ((reference & Anchor.x0) > 0) ? -scale.X : 0;
-            float yOffset = ((reference & Anchor.y0) > 0) ? -scale.Y : 0;
-
-            Quad selectionQuad = GeometryUtils.GetSurroundingQuad(hitObjects);
-
-            //todo: this is not always correct for selections involving sliders. This approximation assumes each point is scaled independently, but sliderends move with the sliderhead.
-            Quad scaledQuad = new Quad(selectionQuad.TopLeft.X + xOffset, selectionQuad.TopLeft.Y + yOffset, selectionQuad.Width + scale.X, selectionQuad.Height + scale.Y);
-
-            //max Size -> playfield bounds
-            if (scaledQuad.TopLeft.X < 0)
-                scale.X += scaledQuad.TopLeft.X;
-            if (scaledQuad.TopLeft.Y < 0)
-                scale.Y += scaledQuad.TopLeft.Y;
-
-            if (scaledQuad.BottomRight.X > DrawWidth)
-                scale.X -= scaledQuad.BottomRight.X - DrawWidth;
-            if (scaledQuad.BottomRight.Y > DrawHeight)
-                scale.Y -= scaledQuad.BottomRight.Y - DrawHeight;
-
-            //min Size -> almost 0. Less than 0 causes the quad to flip, exactly 0 causes scaling to get stuck at minimum scale.
-            Vector2 scaledSize = selectionQuad.Size + scale;
-            Vector2 minSize = new Vector2(Precision.FLOAT_EPSILON);
-
-            scale = Vector2.ComponentMax(minSize, scaledSize) - selectionQuad.Size;
-
-            return scale;
-        }
-
         /// <summary>
         /// All osu! hitobjects which can be moved/rotated/scaled.
         /// </summary>
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
new file mode 100644
index 0000000000..8068c73131
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -0,0 +1,205 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics.Primitives;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.UI;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Compose.Components;
+using osu.Game.Utils;
+using osuTK;
+
+namespace osu.Game.Rulesets.Osu.Edit
+{
+    public partial class OsuSelectionScaleHandler : SelectionScaleHandler
+    {
+        [Resolved]
+        private IEditorChangeHandler? changeHandler { get; set; }
+
+        [Resolved(CanBeNull = true)]
+        private IDistanceSnapProvider? snapProvider { get; set; }
+
+        private BindableList<HitObject> selectedItems { get; } = new BindableList<HitObject>();
+
+        [BackgroundDependencyLoader]
+        private void load(EditorBeatmap editorBeatmap)
+        {
+            selectedItems.BindTo(editorBeatmap.SelectedHitObjects);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedItems.CollectionChanged += (_, __) => updateState();
+            updateState();
+        }
+
+        private void updateState()
+        {
+            var quad = GeometryUtils.GetSurroundingQuad(selectedMovableObjects);
+            CanScale.Value = quad.Width > 0 || quad.Height > 0;
+        }
+
+        private OsuHitObject[]? objectsInScale;
+
+        private Vector2? defaultOrigin;
+        private Dictionary<OsuHitObject, Vector2>? originalPositions;
+        private Dictionary<IHasPath, Vector2[]>? originalPathControlPointPositions;
+        private Dictionary<IHasPath, PathType?[]>? originalPathControlPointTypes;
+
+        public override void Begin()
+        {
+            if (objectsInScale != null)
+                throw new InvalidOperationException($"Cannot {nameof(Begin)} a scale operation while another is in progress!");
+
+            changeHandler?.BeginChange();
+
+            objectsInScale = selectedMovableObjects.ToArray();
+            OriginalSurroundingQuad = objectsInScale.Length == 1 && objectsInScale.First() is Slider slider
+                ? GeometryUtils.GetSurroundingQuad(slider.Path.ControlPoints.Select(p => p.Position))
+                : GeometryUtils.GetSurroundingQuad(objectsInScale);
+            defaultOrigin = OriginalSurroundingQuad.Value.Centre;
+            originalPositions = objectsInScale.ToDictionary(obj => obj, obj => obj.Position);
+            originalPathControlPointPositions = objectsInScale.OfType<IHasPath>().ToDictionary(
+                obj => obj,
+                obj => obj.Path.ControlPoints.Select(point => point.Position).ToArray());
+            originalPathControlPointTypes = objectsInScale.OfType<IHasPath>().ToDictionary(
+                obj => obj,
+                obj => obj.Path.ControlPoints.Select(p => p.Type).ToArray());
+        }
+
+        public override void Update(Vector2 scale, Vector2? origin = null)
+        {
+            if (objectsInScale == null)
+                throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
+
+            Debug.Assert(originalPositions != null && originalPathControlPointPositions != null && defaultOrigin != null && originalPathControlPointTypes != null && OriginalSurroundingQuad != null);
+
+            Vector2 actualOrigin = origin ?? defaultOrigin.Value;
+
+            // for the time being, allow resizing of slider paths only if the slider is
+            // the only hit object selected. with a group selection, it's likely the user
+            // is not looking to change the duration of the slider but expand the whole pattern.
+            if (objectsInScale.Length == 1 && objectsInScale.First() is Slider slider)
+                scaleSlider(slider, scale, originalPathControlPointPositions[slider], originalPathControlPointTypes[slider]);
+            else
+            {
+                scale = getClampedScale(OriginalSurroundingQuad.Value, actualOrigin, scale);
+
+                foreach (var ho in objectsInScale)
+                {
+                    ho.Position = GeometryUtils.GetScaledPositionMultiply(scale, actualOrigin, originalPositions[ho]);
+                }
+            }
+
+            moveSelectionInBounds();
+        }
+
+        public override void Commit()
+        {
+            if (objectsInScale == null)
+                throw new InvalidOperationException($"Cannot {nameof(Commit)} a rotate operation without calling {nameof(Begin)} first!");
+
+            changeHandler?.EndChange();
+
+            objectsInScale = null;
+            OriginalSurroundingQuad = null;
+            originalPositions = null;
+            originalPathControlPointPositions = null;
+            originalPathControlPointTypes = null;
+            defaultOrigin = null;
+        }
+
+        private IEnumerable<OsuHitObject> selectedMovableObjects => selectedItems.Cast<OsuHitObject>()
+                                                                                 .Where(h => h is not Spinner);
+
+        private void scaleSlider(Slider slider, Vector2 scale, Vector2[] originalPathPositions, PathType?[] originalPathTypes)
+        {
+            // Maintain the path types in case they were defaulted to bezier at some point during scaling
+            for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
+            {
+                slider.Path.ControlPoints[i].Position = originalPathPositions[i] * scale;
+                slider.Path.ControlPoints[i].Type = originalPathTypes[i];
+            }
+
+            // Snap the slider's length to the current beat divisor
+            // to calculate the final resulting duration / bounding box before the final checks.
+            slider.SnapTo(snapProvider);
+
+            //if sliderhead or sliderend end up outside playfield, revert scaling.
+            Quad scaledQuad = GeometryUtils.GetSurroundingQuad(new OsuHitObject[] { slider });
+            (bool xInBounds, bool yInBounds) = isQuadInBounds(scaledQuad);
+
+            if (xInBounds && yInBounds && slider.Path.HasValidLength)
+                return;
+
+            for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
+                slider.Path.ControlPoints[i].Position = originalPathPositions[i];
+
+            // Snap the slider's length again to undo the potentially-invalid length applied by the previous snap.
+            slider.SnapTo(snapProvider);
+        }
+
+        private (bool X, bool Y) isQuadInBounds(Quad quad)
+        {
+            bool xInBounds = (quad.TopLeft.X >= 0) && (quad.BottomRight.X <= OsuPlayfield.BASE_SIZE.X);
+            bool yInBounds = (quad.TopLeft.Y >= 0) && (quad.BottomRight.Y <= OsuPlayfield.BASE_SIZE.Y);
+
+            return (xInBounds, yInBounds);
+        }
+
+        /// <summary>
+        /// Clamp scale for multi-object-scaling where selection does not exceed playfield bounds or flip.
+        /// </summary>
+        /// <param name="selectionQuad">The quad surrounding the hitobjects</param>
+        /// <param name="origin">The origin from which the scale operation is performed</param>
+        /// <param name="scale">The scale to be clamped</param>
+        /// <returns>The clamped scale vector</returns>
+        private Vector2 getClampedScale(Quad selectionQuad, Vector2 origin, Vector2 scale)
+        {
+            //todo: this is not always correct for selections involving sliders. This approximation assumes each point is scaled independently, but sliderends move with the sliderhead.
+
+            var tl1 = Vector2.Divide(-origin, selectionQuad.TopLeft - origin);
+            var tl2 = Vector2.Divide(OsuPlayfield.BASE_SIZE - origin, selectionQuad.TopLeft - origin);
+            var br1 = Vector2.Divide(-origin, selectionQuad.BottomRight - origin);
+            var br2 = Vector2.Divide(OsuPlayfield.BASE_SIZE - origin, selectionQuad.BottomRight - origin);
+
+            scale.X = selectionQuad.TopLeft.X - origin.X < 0 ? MathHelper.Clamp(scale.X, tl2.X, tl1.X) : MathHelper.Clamp(scale.X, tl1.X, tl2.X);
+            scale.Y = selectionQuad.TopLeft.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, tl2.Y, tl1.Y) : MathHelper.Clamp(scale.Y, tl1.Y, tl2.Y);
+            scale.X = selectionQuad.BottomRight.X - origin.X < 0 ? MathHelper.Clamp(scale.X, br2.X, br1.X) : MathHelper.Clamp(scale.X, br1.X, br2.X);
+            scale.Y = selectionQuad.BottomRight.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, br2.Y, br1.Y) : MathHelper.Clamp(scale.Y, br1.Y, br2.Y);
+
+            return scale;
+        }
+
+        private void moveSelectionInBounds()
+        {
+            Quad quad = GeometryUtils.GetSurroundingQuad(objectsInScale!);
+
+            Vector2 delta = Vector2.Zero;
+
+            if (quad.TopLeft.X < 0)
+                delta.X -= quad.TopLeft.X;
+            if (quad.TopLeft.Y < 0)
+                delta.Y -= quad.TopLeft.Y;
+
+            if (quad.BottomRight.X > OsuPlayfield.BASE_SIZE.X)
+                delta.X -= quad.BottomRight.X - OsuPlayfield.BASE_SIZE.X;
+            if (quad.BottomRight.Y > OsuPlayfield.BASE_SIZE.Y)
+                delta.Y -= quad.BottomRight.Y - OsuPlayfield.BASE_SIZE.Y;
+
+            foreach (var h in objectsInScale!)
+                h.Position += delta;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index 0b16941bc4..e8b3e430eb 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -27,7 +27,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private SelectionRotationHandler? rotationHandler { get; set; }
 
-        public Func<Vector2, Anchor, bool>? OnScale;
         public Func<Direction, bool, bool>? OnFlip;
         public Func<bool>? OnReverse;
 
@@ -353,7 +352,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
             var handle = new SelectionBoxScaleHandle
             {
                 Anchor = anchor,
-                HandleScale = (delta, a) => OnScale?.Invoke(delta, a)
             };
 
             handle.OperationStarted += operationStarted;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 7943065c82..56c5585ae7 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -1,19 +1,22 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Screens.Edit.Compose.Components
 {
     public partial class SelectionBoxScaleHandle : SelectionBoxDragHandle
     {
-        public Action<Vector2, Anchor> HandleScale { get; set; }
+        [Resolved]
+        private SelectionBox selectionBox { get; set; } = null!;
+
+        [Resolved]
+        private SelectionScaleHandler? scaleHandler { get; set; }
 
         [BackgroundDependencyLoader]
         private void load()
@@ -21,10 +24,93 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Size = new Vector2(10);
         }
 
+        protected override bool OnDragStart(DragStartEvent e)
+        {
+            if (e.Button != MouseButton.Left)
+                return false;
+
+            if (scaleHandler == null) return false;
+
+            scaleHandler.Begin();
+            return true;
+        }
+
+        private Vector2 getOriginPosition()
+        {
+            var quad = scaleHandler!.OriginalSurroundingQuad!.Value;
+            Vector2 origin = quad.TopLeft;
+
+            if ((Anchor & Anchor.x0) > 0)
+                origin.X += quad.Width;
+
+            if ((Anchor & Anchor.y0) > 0)
+                origin.Y += quad.Height;
+
+            return origin;
+        }
+
+        private Vector2 rawScale;
+
         protected override void OnDrag(DragEvent e)
         {
-            HandleScale?.Invoke(e.Delta, Anchor);
             base.OnDrag(e);
+
+            if (scaleHandler == null) return;
+
+            rawScale = convertDragEventToScaleMultiplier(e);
+
+            applyScale(shouldKeepAspectRatio: e.ShiftPressed);
+        }
+
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
+            {
+                applyScale(shouldKeepAspectRatio: true);
+                return true;
+            }
+
+            return base.OnKeyDown(e);
+        }
+
+        protected override void OnKeyUp(KeyUpEvent e)
+        {
+            base.OnKeyUp(e);
+
+            if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
+                applyScale(shouldKeepAspectRatio: false);
+        }
+
+        protected override void OnDragEnd(DragEndEvent e)
+        {
+            scaleHandler?.Commit();
+        }
+
+        private Vector2 convertDragEventToScaleMultiplier(DragEvent e)
+        {
+            Vector2 scale = e.MousePosition - e.MouseDownPosition;
+            adjustScaleFromAnchor(ref scale);
+            return Vector2.Divide(scale, scaleHandler!.OriginalSurroundingQuad!.Value.Size) + Vector2.One;
+        }
+
+        private void adjustScaleFromAnchor(ref Vector2 scale)
+        {
+            // cancel out scale in axes we don't care about (based on which drag handle was used).
+            if ((Anchor & Anchor.x1) > 0) scale.X = 1;
+            if ((Anchor & Anchor.y1) > 0) scale.Y = 1;
+
+            // reverse the scale direction if dragging from top or left.
+            if ((Anchor & Anchor.x0) > 0) scale.X = -scale.X;
+            if ((Anchor & Anchor.y0) > 0) scale.Y = -scale.Y;
+        }
+
+        private void applyScale(bool shouldKeepAspectRatio)
+        {
+            var newScale = shouldKeepAspectRatio
+                ? new Vector2(MathF.Max(rawScale.X, rawScale.Y))
+                : rawScale;
+
+            scaleHandler!.Update(newScale, getOriginPosition());
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
index 3c859c65ff..dd6bd43f4d 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionHandler.cs
@@ -57,6 +57,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         public SelectionRotationHandler RotationHandler { get; private set; }
 
+        public SelectionScaleHandler ScaleHandler { get; private set; }
+
         protected SelectionHandler()
         {
             selectedBlueprints = new List<SelectionBlueprint<T>>();
@@ -69,6 +71,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             var dependencies = new DependencyContainer(base.CreateChildDependencies(parent));
             dependencies.CacheAs(RotationHandler = CreateRotationHandler());
+            dependencies.CacheAs(ScaleHandler = CreateScaleHandler());
             return dependencies;
         }
 
@@ -78,6 +81,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             AddRangeInternal(new Drawable[]
             {
                 RotationHandler,
+                ScaleHandler,
                 SelectionBox = CreateSelectionBox(),
             });
 
@@ -93,7 +97,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 OperationStarted = OnOperationBegan,
                 OperationEnded = OnOperationEnded,
 
-                OnScale = HandleScale,
                 OnFlip = HandleFlip,
                 OnReverse = HandleReverse,
             };
@@ -157,6 +160,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// <returns>Whether any items could be scaled.</returns>
         public virtual bool HandleScale(Vector2 scale, Anchor anchor) => false;
 
+        /// <summary>
+        /// Creates the handler to use for scale operations.
+        /// </summary>
+        public virtual SelectionScaleHandler CreateScaleHandler() => new SelectionScaleHandler();
+
         /// <summary>
         /// Handles the selected items being flipped.
         /// </summary>
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
new file mode 100644
index 0000000000..b7c8f16a02
--- /dev/null
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
@@ -0,0 +1,88 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
+using osuTK;
+
+namespace osu.Game.Screens.Edit.Compose.Components
+{
+    /// <summary>
+    /// Base handler for editor scale operations.
+    /// </summary>
+    public partial class SelectionScaleHandler : Component
+    {
+        /// <summary>
+        /// Whether the scale can currently be performed.
+        /// </summary>
+        public Bindable<bool> CanScale { get; private set; } = new BindableBool();
+
+        public Quad? OriginalSurroundingQuad { get; protected set; }
+
+        /// <summary>
+        /// Performs a single, instant, atomic scale operation.
+        /// </summary>
+        /// <remarks>
+        /// This method is intended to be used in atomic contexts (such as when pressing a single button).
+        /// For continuous operations, see the <see cref="Begin"/>-<see cref="Update"/>-<see cref="Commit"/> flow.
+        /// </remarks>
+        /// <param name="scale">The scale to apply, as multiplier.</param>
+        /// <param name="origin">
+        /// The origin point to scale from.
+        /// If the default <see langword="null"/> value is supplied, a sane implementation-defined default will be used.
+        /// </param>
+        public void ScaleSelection(Vector2 scale, Vector2? origin = null)
+        {
+            Begin();
+            Update(scale, origin);
+            Commit();
+        }
+
+        /// <summary>
+        /// Begins a continuous scale operation.
+        /// </summary>
+        /// <remarks>
+        /// This flow is intended to be used when a scale operation is made incrementally (such as when dragging a scale handle or slider).
+        /// For instantaneous, atomic operations, use the convenience <see cref="ScaleSelection"/> method.
+        /// </remarks>
+        public virtual void Begin()
+        {
+        }
+
+        /// <summary>
+        /// Updates a continuous scale operation.
+        /// Must be preceded by a <see cref="Begin"/> call.
+        /// </summary>
+        /// <remarks>
+        /// <para>
+        /// This flow is intended to be used when a scale operation is made incrementally (such as when dragging a scale handle or slider).
+        /// As such, the values of <paramref name="scale"/> and <paramref name="origin"/> supplied should be relative to the state of the objects being scaled
+        /// when <see cref="Begin"/> was called, rather than instantaneous deltas.
+        /// </para>
+        /// <para>
+        /// For instantaneous, atomic operations, use the convenience <see cref="ScaleSelection"/> method.
+        /// </para>
+        /// </remarks>
+        /// <param name="scale">The Scale to apply, as multiplier.</param>
+        /// <param name="origin">
+        /// The origin point to scale from.
+        /// If the default <see langword="null"/> value is supplied, a sane implementation-defined default will be used.
+        /// </param>
+        public virtual void Update(Vector2 scale, Vector2? origin = null)
+        {
+        }
+
+        /// <summary>
+        /// Ends a continuous scale operation.
+        /// Must be preceded by a <see cref="Begin"/> call.
+        /// </summary>
+        /// <remarks>
+        /// This flow is intended to be used when a scale operation is made incrementally (such as when dragging a scale handle or slider).
+        /// For instantaneous, atomic operations, use the convenience <see cref="ScaleSelection"/> method.
+        /// </remarks>
+        public virtual void Commit()
+        {
+        }
+    }
+}
diff --git a/osu.Game/Utils/GeometryUtils.cs b/osu.Game/Utils/GeometryUtils.cs
index 725e93d098..ef362d8223 100644
--- a/osu.Game/Utils/GeometryUtils.cs
+++ b/osu.Game/Utils/GeometryUtils.cs
@@ -79,6 +79,15 @@ namespace osu.Game.Utils
             return position;
         }
 
+        /// <summary>
+        /// Given a scale multiplier, an origin, and a position,
+        /// will return the scaled position in screen space coordinates.
+        /// </summary>
+        public static Vector2 GetScaledPositionMultiply(Vector2 scale, Vector2 origin, Vector2 position)
+        {
+            return origin + (position - origin) * scale;
+        }
+
         /// <summary>
         /// Returns a quad surrounding the provided points.
         /// </summary>

From a4f771ec089baff91ddea3d4714355e64a8237dd Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 01:13:01 +0100
Subject: [PATCH 004/930] refactor CanScale properties

---
 .../Edit/OsuSelectionHandler.cs               |  5 +-
 .../Edit/OsuSelectionScaleHandler.cs          |  7 +-
 .../SkinEditor/SkinSelectionHandler.cs        |  3 -
 .../Edit/Compose/Components/SelectionBox.cs   | 76 +++++--------------
 .../Components/SelectionScaleHandler.cs       | 18 ++++-
 osu.Game/Utils/GeometryUtils.cs               |  2 +-
 6 files changed, 44 insertions(+), 67 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index c36b535bfa..00c90cdbd6 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -30,9 +30,8 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             Quad quad = selectedMovableObjects.Length > 0 ? GeometryUtils.GetSurroundingQuad(selectedMovableObjects) : new Quad();
 
-            SelectionBox.CanFlipX = SelectionBox.CanScaleX = quad.Width > 0;
-            SelectionBox.CanFlipY = SelectionBox.CanScaleY = quad.Height > 0;
-            SelectionBox.CanScaleDiagonally = SelectionBox.CanScaleX && SelectionBox.CanScaleY;
+            SelectionBox.CanFlipX = quad.Width > 0;
+            SelectionBox.CanFlipY = quad.Height > 0;
             SelectionBox.CanReverse = EditorBeatmap.SelectedHitObjects.Count > 1 || EditorBeatmap.SelectedHitObjects.Any(s => s is Slider);
         }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 8068c73131..7b0ae947e7 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -47,7 +47,10 @@ namespace osu.Game.Rulesets.Osu.Edit
         private void updateState()
         {
             var quad = GeometryUtils.GetSurroundingQuad(selectedMovableObjects);
-            CanScale.Value = quad.Width > 0 || quad.Height > 0;
+
+            CanScaleX.Value = quad.Width > 0;
+            CanScaleY.Value = quad.Height > 0;
+            CanScaleDiagonally.Value = CanScaleX.Value && CanScaleY.Value;
         }
 
         private OsuHitObject[]? objectsInScale;
@@ -98,7 +101,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
                 foreach (var ho in objectsInScale)
                 {
-                    ho.Position = GeometryUtils.GetScaledPositionMultiply(scale, actualOrigin, originalPositions[ho]);
+                    ho.Position = GeometryUtils.GetScaledPosition(scale, actualOrigin, originalPositions[ho]);
                 }
             }
 
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index cf6fb60636..efca6f0080 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -218,9 +218,6 @@ namespace osu.Game.Overlays.SkinEditor
         {
             base.OnSelectionChanged();
 
-            SelectionBox.CanScaleX = allSelectedSupportManualSizing(Axes.X);
-            SelectionBox.CanScaleY = allSelectedSupportManualSizing(Axes.Y);
-            SelectionBox.CanScaleDiagonally = true;
             SelectionBox.CanFlipX = true;
             SelectionBox.CanFlipY = true;
             SelectionBox.CanReverse = false;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index e8b3e430eb..2329a466fe 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -27,6 +27,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
         [Resolved]
         private SelectionRotationHandler? rotationHandler { get; set; }
 
+        [Resolved]
+        private SelectionScaleHandler? scaleHandler { get; set; }
+
         public Func<Direction, bool, bool>? OnFlip;
         public Func<bool>? OnReverse;
 
@@ -56,60 +59,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         private readonly IBindable<bool> canRotate = new BindableBool();
 
-        private bool canScaleX;
+        private readonly IBindable<bool> canScaleX = new BindableBool();
 
-        /// <summary>
-        /// Whether horizontal scaling (from the left or right edge) support should be enabled.
-        /// </summary>
-        public bool CanScaleX
-        {
-            get => canScaleX;
-            set
-            {
-                if (canScaleX == value) return;
+        private readonly IBindable<bool> canScaleY = new BindableBool();
 
-                canScaleX = value;
-                recreate();
-            }
-        }
-
-        private bool canScaleY;
-
-        /// <summary>
-        /// Whether vertical scaling (from the top or bottom edge) support should be enabled.
-        /// </summary>
-        public bool CanScaleY
-        {
-            get => canScaleY;
-            set
-            {
-                if (canScaleY == value) return;
-
-                canScaleY = value;
-                recreate();
-            }
-        }
-
-        private bool canScaleDiagonally;
-
-        /// <summary>
-        /// Whether diagonal scaling (from a corner) support should be enabled.
-        /// </summary>
-        /// <remarks>
-        /// There are some cases where we only want to allow proportional resizing, and not allow
-        /// one or both explicit directions of scale.
-        /// </remarks>
-        public bool CanScaleDiagonally
-        {
-            get => canScaleDiagonally;
-            set
-            {
-                if (canScaleDiagonally == value) return;
-
-                canScaleDiagonally = value;
-                recreate();
-            }
-        }
+        private readonly IBindable<bool> canScaleDiagonally = new BindableBool();
 
         private bool canFlipX;
 
@@ -175,7 +129,17 @@ namespace osu.Game.Screens.Edit.Compose.Components
             if (rotationHandler != null)
                 canRotate.BindTo(rotationHandler.CanRotate);
 
-            canRotate.BindValueChanged(_ => recreate(), true);
+            if (scaleHandler != null)
+            {
+                canScaleX.BindTo(scaleHandler.CanScaleX);
+                canScaleY.BindTo(scaleHandler.CanScaleY);
+                canScaleDiagonally.BindTo(scaleHandler.CanScaleDiagonally);
+            }
+
+            canRotate.BindValueChanged(_ => recreate());
+            canScaleX.BindValueChanged(_ => recreate());
+            canScaleY.BindValueChanged(_ => recreate());
+            canScaleDiagonally.BindValueChanged(_ => recreate(), true);
         }
 
         protected override bool OnKeyDown(KeyDownEvent e)
@@ -264,9 +228,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 }
             };
 
-            if (CanScaleX) addXScaleComponents();
-            if (CanScaleDiagonally) addFullScaleComponents();
-            if (CanScaleY) addYScaleComponents();
+            if (canScaleX.Value) addXScaleComponents();
+            if (canScaleDiagonally.Value) addFullScaleComponents();
+            if (canScaleY.Value) addYScaleComponents();
             if (CanFlipX) addXFlipComponents();
             if (CanFlipY) addYFlipComponents();
             if (canRotate.Value) addRotationComponents();
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
index b7c8f16a02..59406b3184 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
@@ -14,9 +14,23 @@ namespace osu.Game.Screens.Edit.Compose.Components
     public partial class SelectionScaleHandler : Component
     {
         /// <summary>
-        /// Whether the scale can currently be performed.
+        /// Whether horizontal scaling (from the left or right edge) support should be enabled.
         /// </summary>
-        public Bindable<bool> CanScale { get; private set; } = new BindableBool();
+        public Bindable<bool> CanScaleX { get; private set; } = new BindableBool();
+
+        /// <summary>
+        /// Whether vertical scaling (from the top or bottom edge) support should be enabled.
+        /// </summary>
+        public Bindable<bool> CanScaleY { get; private set; } = new BindableBool();
+
+        /// <summary>
+        /// Whether diagonal scaling (from a corner) support should be enabled.
+        /// </summary>
+        /// <remarks>
+        /// There are some cases where we only want to allow proportional resizing, and not allow
+        /// one or both explicit directions of scale.
+        /// </remarks>
+        public Bindable<bool> CanScaleDiagonally { get; private set; } = new BindableBool();
 
         public Quad? OriginalSurroundingQuad { get; protected set; }
 
diff --git a/osu.Game/Utils/GeometryUtils.cs b/osu.Game/Utils/GeometryUtils.cs
index ef362d8223..6d8237ea34 100644
--- a/osu.Game/Utils/GeometryUtils.cs
+++ b/osu.Game/Utils/GeometryUtils.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Utils
         /// Given a scale multiplier, an origin, and a position,
         /// will return the scaled position in screen space coordinates.
         /// </summary>
-        public static Vector2 GetScaledPositionMultiply(Vector2 scale, Vector2 origin, Vector2 position)
+        public static Vector2 GetScaledPosition(Vector2 scale, Vector2 origin, Vector2 position)
         {
             return origin + (position - origin) * scale;
         }

From bc0e6baba70cd9c69dbf9f87180c24c8a47dcff9 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 01:13:05 +0100
Subject: [PATCH 005/930] fix test

---
 .../Editing/TestSceneComposeSelectBox.cs      | 77 ++++++++++++-------
 1 file changed, 51 insertions(+), 26 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
index f6637d0e80..680a76f9b8 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
@@ -10,9 +10,11 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Testing;
 using osu.Framework.Threading;
 using osu.Game.Screens.Edit.Compose.Components;
+using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
 
@@ -26,9 +28,13 @@ namespace osu.Game.Tests.Visual.Editing
         [Cached(typeof(SelectionRotationHandler))]
         private TestSelectionRotationHandler rotationHandler;
 
+        [Cached(typeof(SelectionScaleHandler))]
+        private TestSelectionScaleHandler scaleHandler;
+
         public TestSceneComposeSelectBox()
         {
             rotationHandler = new TestSelectionRotationHandler(() => selectionArea);
+            scaleHandler = new TestSelectionScaleHandler(() => selectionArea);
         }
 
         [SetUp]
@@ -45,13 +51,8 @@ namespace osu.Game.Tests.Visual.Editing
                     {
                         RelativeSizeAxes = Axes.Both,
 
-                        CanScaleX = true,
-                        CanScaleY = true,
-                        CanScaleDiagonally = true,
                         CanFlipX = true,
                         CanFlipY = true,
-
-                        OnScale = handleScale
                     }
                 }
             };
@@ -60,27 +61,6 @@ namespace osu.Game.Tests.Visual.Editing
             InputManager.ReleaseButton(MouseButton.Left);
         });
 
-        private bool handleScale(Vector2 amount, Anchor reference)
-        {
-            if ((reference & Anchor.y1) == 0)
-            {
-                int directionY = (reference & Anchor.y0) > 0 ? -1 : 1;
-                if (directionY < 0)
-                    selectionArea.Y += amount.Y;
-                selectionArea.Height += directionY * amount.Y;
-            }
-
-            if ((reference & Anchor.x1) == 0)
-            {
-                int directionX = (reference & Anchor.x0) > 0 ? -1 : 1;
-                if (directionX < 0)
-                    selectionArea.X += amount.X;
-                selectionArea.Width += directionX * amount.X;
-            }
-
-            return true;
-        }
-
         private partial class TestSelectionRotationHandler : SelectionRotationHandler
         {
             private readonly Func<Container> getTargetContainer;
@@ -125,6 +105,51 @@ namespace osu.Game.Tests.Visual.Editing
             }
         }
 
+        private partial class TestSelectionScaleHandler : SelectionScaleHandler
+        {
+            private readonly Func<Container> getTargetContainer;
+
+            public TestSelectionScaleHandler(Func<Container> getTargetContainer)
+            {
+                this.getTargetContainer = getTargetContainer;
+
+                CanScaleX.Value = true;
+                CanScaleY.Value = true;
+                CanScaleDiagonally.Value = true;
+            }
+
+            [CanBeNull]
+            private Container targetContainer;
+
+            public override void Begin()
+            {
+                if (targetContainer != null)
+                    throw new InvalidOperationException($"Cannot {nameof(Begin)} a scale operation while another is in progress!");
+
+                targetContainer = getTargetContainer();
+                OriginalSurroundingQuad = new Quad(targetContainer!.X, targetContainer.Y, targetContainer.Width, targetContainer.Height);
+            }
+
+            public override void Update(Vector2 scale, Vector2? origin = null)
+            {
+                if (targetContainer == null)
+                    throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
+
+                Vector2 actualOrigin = origin ?? Vector2.Zero;
+
+                targetContainer.Position = GeometryUtils.GetScaledPosition(scale, actualOrigin, OriginalSurroundingQuad!.Value.TopLeft);
+                targetContainer.Size = OriginalSurroundingQuad!.Value.Size * scale;
+            }
+
+            public override void Commit()
+            {
+                if (targetContainer == null)
+                    throw new InvalidOperationException($"Cannot {nameof(Commit)} a scale operation without calling {nameof(Begin)} first!");
+
+                targetContainer = null;
+            }
+        }
+
         [Test]
         public void TestRotationHandleShownOnHover()
         {

From ed430a3df4bbcacf5860db8f21ac625d2a176bbc Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 02:49:56 +0100
Subject: [PATCH 006/930] refactor skin editor scale

---
 .../SkinEditor/SkinSelectionHandler.cs        | 157 +-------------
 .../SkinEditor/SkinSelectionScaleHandler.cs   | 198 ++++++++++++++++++
 2 files changed, 204 insertions(+), 151 deletions(-)
 create mode 100644 osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index efca6f0080..2d8db61ee7 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -7,10 +7,8 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Utils;
 using osu.Game.Extensions;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets.Edit;
@@ -31,148 +29,16 @@ namespace osu.Game.Overlays.SkinEditor
             UpdatePosition = updateDrawablePosition
         };
 
-        private bool allSelectedSupportManualSizing(Axes axis) => SelectedItems.All(b => (b as CompositeDrawable)?.AutoSizeAxes.HasFlagFast(axis) == false);
-
-        public override bool HandleScale(Vector2 scale, Anchor anchor)
+        public override SelectionScaleHandler CreateScaleHandler()
         {
-            Axes adjustAxis;
-
-            switch (anchor)
+            var scaleHandler = new SkinSelectionScaleHandler
             {
-                // for corners, adjust scale.
-                case Anchor.TopLeft:
-                case Anchor.TopRight:
-                case Anchor.BottomLeft:
-                case Anchor.BottomRight:
-                    adjustAxis = Axes.Both;
-                    break;
+                UpdatePosition = updateDrawablePosition
+            };
 
-                // for edges, adjust size.
-                // autosize elements can't be easily handled so just disable sizing for now.
-                case Anchor.TopCentre:
-                case Anchor.BottomCentre:
-                    if (!allSelectedSupportManualSizing(Axes.Y))
-                        return false;
+            scaleHandler.PerformFlipFromScaleHandles += a => SelectionBox.PerformFlipFromScaleHandles(a);
 
-                    adjustAxis = Axes.Y;
-                    break;
-
-                case Anchor.CentreLeft:
-                case Anchor.CentreRight:
-                    if (!allSelectedSupportManualSizing(Axes.X))
-                        return false;
-
-                    adjustAxis = Axes.X;
-                    break;
-
-                default:
-                    throw new ArgumentOutOfRangeException(nameof(anchor), anchor, null);
-            }
-
-            // convert scale to screen space
-            scale = ToScreenSpace(scale) - ToScreenSpace(Vector2.Zero);
-
-            adjustScaleFromAnchor(ref scale, anchor);
-
-            // the selection quad is always upright, so use an AABB rect to make mutating the values easier.
-            var selectionRect = getSelectionQuad().AABBFloat;
-
-            // If the selection has no area we cannot scale it
-            if (selectionRect.Area == 0)
-                return false;
-
-            // copy to mutate, as we will need to compare to the original later on.
-            var adjustedRect = selectionRect;
-            bool isRotated = false;
-
-            // for now aspect lock scale adjustments that occur at corners..
-            if (!anchor.HasFlagFast(Anchor.x1) && !anchor.HasFlagFast(Anchor.y1))
-            {
-                // project scale vector along diagonal
-                Vector2 diag = (selectionRect.TopLeft - selectionRect.BottomRight).Normalized();
-                scale = Vector2.Dot(scale, diag) * diag;
-            }
-            // ..or if any of the selection have been rotated.
-            // this is to avoid requiring skew logic (which would likely not be the user's expected transform anyway).
-            else if (SelectedBlueprints.Any(b => !Precision.AlmostEquals(((Drawable)b.Item).Rotation % 90, 0)))
-            {
-                isRotated = true;
-                if (anchor.HasFlagFast(Anchor.x1))
-                    // if dragging from the horizontal centre, only a vertical component is available.
-                    scale.X = scale.Y / selectionRect.Height * selectionRect.Width;
-                else
-                    // in all other cases (arbitrarily) use the horizontal component for aspect lock.
-                    scale.Y = scale.X / selectionRect.Width * selectionRect.Height;
-            }
-
-            if (anchor.HasFlagFast(Anchor.x0)) adjustedRect.X -= scale.X;
-            if (anchor.HasFlagFast(Anchor.y0)) adjustedRect.Y -= scale.Y;
-
-            // Maintain the selection's centre position if dragging from the centre anchors and selection is rotated.
-            if (isRotated && anchor.HasFlagFast(Anchor.x1)) adjustedRect.X -= scale.X / 2;
-            if (isRotated && anchor.HasFlagFast(Anchor.y1)) adjustedRect.Y -= scale.Y / 2;
-
-            adjustedRect.Width += scale.X;
-            adjustedRect.Height += scale.Y;
-
-            if (adjustedRect.Width <= 0 || adjustedRect.Height <= 0)
-            {
-                Axes toFlip = Axes.None;
-
-                if (adjustedRect.Width <= 0) toFlip |= Axes.X;
-                if (adjustedRect.Height <= 0) toFlip |= Axes.Y;
-
-                SelectionBox.PerformFlipFromScaleHandles(toFlip);
-                return true;
-            }
-
-            // scale adjust applied to each individual item should match that of the quad itself.
-            var scaledDelta = new Vector2(
-                adjustedRect.Width / selectionRect.Width,
-                adjustedRect.Height / selectionRect.Height
-            );
-
-            foreach (var b in SelectedBlueprints)
-            {
-                var drawableItem = (Drawable)b.Item;
-
-                // each drawable's relative position should be maintained in the scaled quad.
-                var screenPosition = b.ScreenSpaceSelectionPoint;
-
-                var relativePositionInOriginal =
-                    new Vector2(
-                        (screenPosition.X - selectionRect.TopLeft.X) / selectionRect.Width,
-                        (screenPosition.Y - selectionRect.TopLeft.Y) / selectionRect.Height
-                    );
-
-                var newPositionInAdjusted = new Vector2(
-                    adjustedRect.TopLeft.X + adjustedRect.Width * relativePositionInOriginal.X,
-                    adjustedRect.TopLeft.Y + adjustedRect.Height * relativePositionInOriginal.Y
-                );
-
-                updateDrawablePosition(drawableItem, newPositionInAdjusted);
-
-                var currentScaledDelta = scaledDelta;
-                if (Precision.AlmostEquals(MathF.Abs(drawableItem.Rotation) % 180, 90))
-                    currentScaledDelta = new Vector2(scaledDelta.Y, scaledDelta.X);
-
-                switch (adjustAxis)
-                {
-                    case Axes.X:
-                        drawableItem.Width *= currentScaledDelta.X;
-                        break;
-
-                    case Axes.Y:
-                        drawableItem.Height *= currentScaledDelta.Y;
-                        break;
-
-                    case Axes.Both:
-                        drawableItem.Scale *= currentScaledDelta;
-                        break;
-                }
-            }
-
-            return true;
+            return scaleHandler;
         }
 
         public override bool HandleFlip(Direction direction, bool flipOverOrigin)
@@ -410,16 +276,5 @@ namespace osu.Game.Overlays.SkinEditor
             drawable.Anchor = anchor;
             drawable.Position -= drawable.AnchorPosition - previousAnchor;
         }
-
-        private static void adjustScaleFromAnchor(ref Vector2 scale, Anchor reference)
-        {
-            // cancel out scale in axes we don't care about (based on which drag handle was used).
-            if ((reference & Anchor.x1) > 0) scale.X = 0;
-            if ((reference & Anchor.y1) > 0) scale.Y = 0;
-
-            // reverse the scale direction if dragging from top or left.
-            if ((reference & Anchor.x0) > 0) scale.X = -scale.X;
-            if ((reference & Anchor.y0) > 0) scale.Y = -scale.Y;
-        }
     }
 }
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
new file mode 100644
index 0000000000..46b39645b2
--- /dev/null
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -0,0 +1,198 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.EnumExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Utils;
+using osu.Game.Screens.Edit;
+using osu.Game.Screens.Edit.Compose.Components;
+using osu.Game.Skinning;
+using osu.Game.Utils;
+using osuTK;
+
+namespace osu.Game.Overlays.SkinEditor
+{
+    public partial class SkinSelectionScaleHandler : SelectionScaleHandler
+    {
+        public Action<Drawable, Vector2> UpdatePosition { get; init; } = null!;
+
+        public event Action<Axes>? PerformFlipFromScaleHandles;
+
+        [Resolved]
+        private IEditorChangeHandler? changeHandler { get; set; }
+
+        private BindableList<ISerialisableDrawable> selectedItems { get; } = new BindableList<ISerialisableDrawable>();
+
+        [BackgroundDependencyLoader]
+        private void load(SkinEditor skinEditor)
+        {
+            selectedItems.BindTo(skinEditor.SelectedComponents);
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedItems.CollectionChanged += (_, __) => updateState();
+            updateState();
+        }
+
+        private void updateState()
+        {
+            CanScaleX.Value = allSelectedSupportManualSizing(Axes.X);
+            CanScaleY.Value = allSelectedSupportManualSizing(Axes.Y);
+            CanScaleDiagonally.Value = true;
+        }
+
+        private bool allSelectedSupportManualSizing(Axes axis) => selectedItems.All(b => (b as CompositeDrawable)?.AutoSizeAxes.HasFlagFast(axis) == false);
+
+        private Drawable[]? objectsInScale;
+
+        private Vector2? defaultOrigin;
+        private Dictionary<Drawable, float>? originalWidths;
+        private Dictionary<Drawable, float>? originalHeights;
+        private Dictionary<Drawable, Vector2>? originalScales;
+        private Dictionary<Drawable, Vector2>? originalPositions;
+
+        public override void Begin()
+        {
+            if (objectsInScale != null)
+                throw new InvalidOperationException($"Cannot {nameof(Begin)} a scale operation while another is in progress!");
+
+            changeHandler?.BeginChange();
+
+            objectsInScale = selectedItems.Cast<Drawable>().ToArray();
+            originalWidths = objectsInScale.ToDictionary(d => d, d => d.Width);
+            originalHeights = objectsInScale.ToDictionary(d => d, d => d.Height);
+            originalScales = objectsInScale.ToDictionary(d => d, d => d.Scale);
+            originalPositions = objectsInScale.ToDictionary(d => d, d => d.ToScreenSpace(d.OriginPosition));
+            OriginalSurroundingQuad = GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.ScreenSpaceDrawQuad.GetVertices().ToArray()));
+            defaultOrigin = OriginalSurroundingQuad.Value.Centre;
+        }
+
+        public override void Update(Vector2 scale, Vector2? origin = null)
+        {
+            if (objectsInScale == null)
+                throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
+
+            Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
+
+            var actualOrigin = origin ?? defaultOrigin.Value;
+
+            Axes adjustAxis = scale.X == 0 ? Axes.Y : scale.Y == 0 ? Axes.X : Axes.Both;
+
+            if ((adjustAxis == Axes.Y && !allSelectedSupportManualSizing(Axes.Y)) ||
+                (adjustAxis == Axes.X && !allSelectedSupportManualSizing(Axes.X)))
+                return;
+
+            // the selection quad is always upright, so use an AABB rect to make mutating the values easier.
+            var selectionRect = OriginalSurroundingQuad.Value.AABBFloat;
+
+            // If the selection has no area we cannot scale it
+            if (selectionRect.Area == 0)
+                return;
+
+            // copy to mutate, as we will need to compare to the original later on.
+            var adjustedRect = selectionRect;
+
+            // for now aspect lock scale adjustments that occur at corners..
+            if (adjustAxis == Axes.Both)
+            {
+                // project scale vector along diagonal
+                Vector2 diag = new Vector2(1, 1).Normalized();
+                scale = Vector2.Dot(scale, diag) * diag;
+            }
+            // ..or if any of the selection have been rotated.
+            // this is to avoid requiring skew logic (which would likely not be the user's expected transform anyway).
+            else if (objectsInScale.Any(b => !Precision.AlmostEquals(b.Rotation % 90, 0)))
+            {
+                if (adjustAxis == Axes.Y)
+                    // if dragging from the horizontal centre, only a vertical component is available.
+                    scale.X = scale.Y / selectionRect.Height * selectionRect.Width;
+                else
+                    // in all other cases (arbitrarily) use the horizontal component for aspect lock.
+                    scale.Y = scale.X / selectionRect.Width * selectionRect.Height;
+            }
+
+            adjustedRect.Location = GeometryUtils.GetScaledPosition(scale, actualOrigin, OriginalSurroundingQuad!.Value.TopLeft);
+            adjustedRect.Size = OriginalSurroundingQuad!.Value.Size * scale;
+
+            if (adjustedRect.Width <= 0 || adjustedRect.Height <= 0)
+            {
+                Axes toFlip = Axes.None;
+
+                if (adjustedRect.Width <= 0) toFlip |= Axes.X;
+                if (adjustedRect.Height <= 0) toFlip |= Axes.Y;
+
+                PerformFlipFromScaleHandles?.Invoke(toFlip);
+                return;
+            }
+
+            // scale adjust applied to each individual item should match that of the quad itself.
+            var scaledDelta = new Vector2(
+                adjustedRect.Width / selectionRect.Width,
+                adjustedRect.Height / selectionRect.Height
+            );
+
+            foreach (var b in objectsInScale)
+            {
+                // each drawable's relative position should be maintained in the scaled quad.
+                var screenPosition = originalPositions[b];
+
+                var relativePositionInOriginal =
+                    new Vector2(
+                        (screenPosition.X - selectionRect.TopLeft.X) / selectionRect.Width,
+                        (screenPosition.Y - selectionRect.TopLeft.Y) / selectionRect.Height
+                    );
+
+                var newPositionInAdjusted = new Vector2(
+                    adjustedRect.TopLeft.X + adjustedRect.Width * relativePositionInOriginal.X,
+                    adjustedRect.TopLeft.Y + adjustedRect.Height * relativePositionInOriginal.Y
+                );
+
+                UpdatePosition(b, newPositionInAdjusted);
+
+                var currentScaledDelta = scaledDelta;
+                if (Precision.AlmostEquals(MathF.Abs(b.Rotation) % 180, 90))
+                    currentScaledDelta = new Vector2(scaledDelta.Y, scaledDelta.X);
+
+                switch (adjustAxis)
+                {
+                    case Axes.X:
+                        b.Width = originalWidths[b] * currentScaledDelta.X;
+                        break;
+
+                    case Axes.Y:
+                        b.Height = originalHeights[b] * currentScaledDelta.Y;
+                        break;
+
+                    case Axes.Both:
+                        b.Scale = originalScales[b] * currentScaledDelta;
+                        break;
+                }
+            }
+        }
+
+        public override void Commit()
+        {
+            if (objectsInScale == null)
+                throw new InvalidOperationException($"Cannot {nameof(Commit)} a scale operation without calling {nameof(Begin)} first!");
+
+            changeHandler?.EndChange();
+
+            objectsInScale = null;
+            originalPositions = null;
+            originalWidths = null;
+            originalHeights = null;
+            originalScales = null;
+            defaultOrigin = null;
+        }
+    }
+}

From 6a57be0a50c8ddc20356f237dd80bc219226ba59 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 13:04:05 +0100
Subject: [PATCH 007/930] clean up code and fix flipping

---
 .../SkinEditor/SkinSelectionScaleHandler.cs   | 74 ++++++++-----------
 .../Components/SelectionBoxScaleHandle.cs     | 19 +++--
 2 files changed, 43 insertions(+), 50 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index 46b39645b2..c2f788a9e8 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -61,6 +61,9 @@ namespace osu.Game.Overlays.SkinEditor
         private Dictionary<Drawable, Vector2>? originalScales;
         private Dictionary<Drawable, Vector2>? originalPositions;
 
+        private bool isFlippedX;
+        private bool isFlippedY;
+
         public override void Begin()
         {
             if (objectsInScale != null)
@@ -75,6 +78,9 @@ namespace osu.Game.Overlays.SkinEditor
             originalPositions = objectsInScale.ToDictionary(d => d, d => d.ToScreenSpace(d.OriginPosition));
             OriginalSurroundingQuad = GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.ScreenSpaceDrawQuad.GetVertices().ToArray()));
             defaultOrigin = OriginalSurroundingQuad.Value.Centre;
+
+            isFlippedX = false;
+            isFlippedY = false;
         }
 
         public override void Update(Vector2 scale, Vector2? origin = null)
@@ -85,29 +91,21 @@ namespace osu.Game.Overlays.SkinEditor
             Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
 
             var actualOrigin = origin ?? defaultOrigin.Value;
-
             Axes adjustAxis = scale.X == 0 ? Axes.Y : scale.Y == 0 ? Axes.X : Axes.Both;
 
             if ((adjustAxis == Axes.Y && !allSelectedSupportManualSizing(Axes.Y)) ||
                 (adjustAxis == Axes.X && !allSelectedSupportManualSizing(Axes.X)))
                 return;
 
-            // the selection quad is always upright, so use an AABB rect to make mutating the values easier.
-            var selectionRect = OriginalSurroundingQuad.Value.AABBFloat;
-
             // If the selection has no area we cannot scale it
-            if (selectionRect.Area == 0)
+            if (OriginalSurroundingQuad.Value.Width == 0 || OriginalSurroundingQuad.Value.Height == 0)
                 return;
 
-            // copy to mutate, as we will need to compare to the original later on.
-            var adjustedRect = selectionRect;
-
             // for now aspect lock scale adjustments that occur at corners..
             if (adjustAxis == Axes.Both)
             {
                 // project scale vector along diagonal
-                Vector2 diag = new Vector2(1, 1).Normalized();
-                scale = Vector2.Dot(scale, diag) * diag;
+                scale = new Vector2((scale.X + scale.Y) * 0.5f);
             }
             // ..or if any of the selection have been rotated.
             // this is to avoid requiring skew logic (which would likely not be the user's expected transform anyway).
@@ -115,66 +113,54 @@ namespace osu.Game.Overlays.SkinEditor
             {
                 if (adjustAxis == Axes.Y)
                     // if dragging from the horizontal centre, only a vertical component is available.
-                    scale.X = scale.Y / selectionRect.Height * selectionRect.Width;
+                    scale.X = scale.Y;
                 else
                     // in all other cases (arbitrarily) use the horizontal component for aspect lock.
-                    scale.Y = scale.X / selectionRect.Width * selectionRect.Height;
+                    scale.Y = scale.X;
             }
 
-            adjustedRect.Location = GeometryUtils.GetScaledPosition(scale, actualOrigin, OriginalSurroundingQuad!.Value.TopLeft);
-            adjustedRect.Size = OriginalSurroundingQuad!.Value.Size * scale;
+            bool flippedX = scale.X < 0;
+            bool flippedY = scale.Y < 0;
+            Axes toFlip = Axes.None;
 
-            if (adjustedRect.Width <= 0 || adjustedRect.Height <= 0)
+            if (flippedX != isFlippedX)
             {
-                Axes toFlip = Axes.None;
+                isFlippedX = flippedX;
+                toFlip |= Axes.X;
+            }
 
-                if (adjustedRect.Width <= 0) toFlip |= Axes.X;
-                if (adjustedRect.Height <= 0) toFlip |= Axes.Y;
+            if (flippedY != isFlippedY)
+            {
+                isFlippedY = flippedY;
+                toFlip |= Axes.Y;
+            }
 
+            if (toFlip != Axes.None)
+            {
                 PerformFlipFromScaleHandles?.Invoke(toFlip);
                 return;
             }
 
-            // scale adjust applied to each individual item should match that of the quad itself.
-            var scaledDelta = new Vector2(
-                adjustedRect.Width / selectionRect.Width,
-                adjustedRect.Height / selectionRect.Height
-            );
-
             foreach (var b in objectsInScale)
             {
-                // each drawable's relative position should be maintained in the scaled quad.
-                var screenPosition = originalPositions[b];
+                UpdatePosition(b, GeometryUtils.GetScaledPosition(scale, actualOrigin, originalPositions[b]));
 
-                var relativePositionInOriginal =
-                    new Vector2(
-                        (screenPosition.X - selectionRect.TopLeft.X) / selectionRect.Width,
-                        (screenPosition.Y - selectionRect.TopLeft.Y) / selectionRect.Height
-                    );
-
-                var newPositionInAdjusted = new Vector2(
-                    adjustedRect.TopLeft.X + adjustedRect.Width * relativePositionInOriginal.X,
-                    adjustedRect.TopLeft.Y + adjustedRect.Height * relativePositionInOriginal.Y
-                );
-
-                UpdatePosition(b, newPositionInAdjusted);
-
-                var currentScaledDelta = scaledDelta;
+                var currentScale = scale;
                 if (Precision.AlmostEquals(MathF.Abs(b.Rotation) % 180, 90))
-                    currentScaledDelta = new Vector2(scaledDelta.Y, scaledDelta.X);
+                    currentScale = new Vector2(scale.Y, scale.X);
 
                 switch (adjustAxis)
                 {
                     case Axes.X:
-                        b.Width = originalWidths[b] * currentScaledDelta.X;
+                        b.Width = originalWidths[b] * currentScale.X;
                         break;
 
                     case Axes.Y:
-                        b.Height = originalHeights[b] * currentScaledDelta.Y;
+                        b.Height = originalHeights[b] * currentScale.Y;
                         break;
 
                     case Axes.Both:
-                        b.Scale = originalScales[b] * currentScaledDelta;
+                        b.Scale = originalScales[b] * currentScale;
                         break;
                 }
             }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 56c5585ae7..6179be1d4f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -5,6 +5,7 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
+using osu.Framework.Logging;
 using osuTK;
 using osuTK.Input;
 
@@ -24,6 +25,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
             Size = new Vector2(10);
         }
 
+        private Anchor originalAnchor;
+
         protected override bool OnDragStart(DragStartEvent e)
         {
             if (e.Button != MouseButton.Left)
@@ -31,6 +34,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             if (scaleHandler == null) return false;
 
+            originalAnchor = Anchor;
+
             scaleHandler.Begin();
             return true;
         }
@@ -40,10 +45,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
             var quad = scaleHandler!.OriginalSurroundingQuad!.Value;
             Vector2 origin = quad.TopLeft;
 
-            if ((Anchor & Anchor.x0) > 0)
+            if ((originalAnchor & Anchor.x0) > 0)
                 origin.X += quad.Width;
 
-            if ((Anchor & Anchor.y0) > 0)
+            if ((originalAnchor & Anchor.y0) > 0)
                 origin.Y += quad.Height;
 
             return origin;
@@ -89,6 +94,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private Vector2 convertDragEventToScaleMultiplier(DragEvent e)
         {
             Vector2 scale = e.MousePosition - e.MouseDownPosition;
+            Logger.Log($"Raw scale {scale}");
             adjustScaleFromAnchor(ref scale);
             return Vector2.Divide(scale, scaleHandler!.OriginalSurroundingQuad!.Value.Size) + Vector2.One;
         }
@@ -96,12 +102,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private void adjustScaleFromAnchor(ref Vector2 scale)
         {
             // cancel out scale in axes we don't care about (based on which drag handle was used).
-            if ((Anchor & Anchor.x1) > 0) scale.X = 1;
-            if ((Anchor & Anchor.y1) > 0) scale.Y = 1;
+            if ((originalAnchor & Anchor.x1) > 0) scale.X = 1;
+            if ((originalAnchor & Anchor.y1) > 0) scale.Y = 1;
 
             // reverse the scale direction if dragging from top or left.
-            if ((Anchor & Anchor.x0) > 0) scale.X = -scale.X;
-            if ((Anchor & Anchor.y0) > 0) scale.Y = -scale.Y;
+            if ((originalAnchor & Anchor.x0) > 0) scale.X = -scale.X;
+            if ((originalAnchor & Anchor.y0) > 0) scale.Y = -scale.Y;
         }
 
         private void applyScale(bool shouldKeepAspectRatio)
@@ -110,6 +116,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 ? new Vector2(MathF.Max(rawScale.X, rawScale.Y))
                 : rawScale;
 
+            Logger.Log($"Raw scale adjusted {newScale}, origin {getOriginPosition()}");
             scaleHandler!.Update(newScale, getOriginPosition());
         }
     }

From fcaa5ec20e3fe43948bb1bd9d898d45dcf9b50cf Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 13:26:08 +0100
Subject: [PATCH 008/930] remove debug logs

---
 .../Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 6179be1d4f..e0b41fd8e2 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -5,7 +5,6 @@ using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
-using osu.Framework.Logging;
 using osuTK;
 using osuTK.Input;
 
@@ -94,7 +93,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private Vector2 convertDragEventToScaleMultiplier(DragEvent e)
         {
             Vector2 scale = e.MousePosition - e.MouseDownPosition;
-            Logger.Log($"Raw scale {scale}");
             adjustScaleFromAnchor(ref scale);
             return Vector2.Divide(scale, scaleHandler!.OriginalSurroundingQuad!.Value.Size) + Vector2.One;
         }
@@ -116,7 +114,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 ? new Vector2(MathF.Max(rawScale.X, rawScale.Y))
                 : rawScale;
 
-            Logger.Log($"Raw scale adjusted {newScale}, origin {getOriginPosition()}");
             scaleHandler!.Update(newScale, getOriginPosition());
         }
     }

From e1f3f7d988194e2f48df3aba184f095f59d2623b Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 14:49:47 +0100
Subject: [PATCH 009/930] fix possible NaN in clamped scale

---
 .../Edit/OsuSelectionScaleHandler.cs                 | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 7b0ae947e7..3c4818a533 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -177,10 +177,14 @@ namespace osu.Game.Rulesets.Osu.Edit
             var br1 = Vector2.Divide(-origin, selectionQuad.BottomRight - origin);
             var br2 = Vector2.Divide(OsuPlayfield.BASE_SIZE - origin, selectionQuad.BottomRight - origin);
 
-            scale.X = selectionQuad.TopLeft.X - origin.X < 0 ? MathHelper.Clamp(scale.X, tl2.X, tl1.X) : MathHelper.Clamp(scale.X, tl1.X, tl2.X);
-            scale.Y = selectionQuad.TopLeft.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, tl2.Y, tl1.Y) : MathHelper.Clamp(scale.Y, tl1.Y, tl2.Y);
-            scale.X = selectionQuad.BottomRight.X - origin.X < 0 ? MathHelper.Clamp(scale.X, br2.X, br1.X) : MathHelper.Clamp(scale.X, br1.X, br2.X);
-            scale.Y = selectionQuad.BottomRight.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, br2.Y, br1.Y) : MathHelper.Clamp(scale.Y, br1.Y, br2.Y);
+            if (!Precision.AlmostEquals(selectionQuad.TopLeft.X - origin.X, 0))
+                scale.X = selectionQuad.TopLeft.X - origin.X < 0 ? MathHelper.Clamp(scale.X, tl2.X, tl1.X) : MathHelper.Clamp(scale.X, tl1.X, tl2.X);
+            if (!Precision.AlmostEquals(selectionQuad.TopLeft.Y - origin.Y, 0))
+                scale.Y = selectionQuad.TopLeft.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, tl2.Y, tl1.Y) : MathHelper.Clamp(scale.Y, tl1.Y, tl2.Y);
+            if (!Precision.AlmostEquals(selectionQuad.BottomRight.X - origin.X, 0))
+                scale.X = selectionQuad.BottomRight.X - origin.X < 0 ? MathHelper.Clamp(scale.X, br2.X, br1.X) : MathHelper.Clamp(scale.X, br1.X, br2.X);
+            if (!Precision.AlmostEquals(selectionQuad.BottomRight.Y - origin.Y, 0))
+                scale.Y = selectionQuad.BottomRight.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, br2.Y, br1.Y) : MathHelper.Clamp(scale.Y, br1.Y, br2.Y);
 
             return scale;
         }

From 6a4129dad880e839b033d77ac2bdb00f22dc1c0d Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:11:35 +0100
Subject: [PATCH 010/930] fix aspect ratio transform

---
 .../Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index e0b41fd8e2..ea98ac573c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -111,7 +111,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private void applyScale(bool shouldKeepAspectRatio)
         {
             var newScale = shouldKeepAspectRatio
-                ? new Vector2(MathF.Max(rawScale.X, rawScale.Y))
+                ? new Vector2((rawScale.X + rawScale.Y) * 0.5f)
                 : rawScale;
 
             scaleHandler!.Update(newScale, getOriginPosition());

From 0fc448f4f3a31643903017a9881b81749561e0eb Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:12:48 +0100
Subject: [PATCH 011/930] fix adjusting scale from anchor

---
 osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs     | 2 +-
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs        | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index c2f788a9e8..bf75469d7a 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -91,7 +91,7 @@ namespace osu.Game.Overlays.SkinEditor
             Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
 
             var actualOrigin = origin ?? defaultOrigin.Value;
-            Axes adjustAxis = scale.X == 0 ? Axes.Y : scale.Y == 0 ? Axes.X : Axes.Both;
+            Axes adjustAxis = scale.X == 1 ? Axes.Y : scale.Y == 1 ? Axes.X : Axes.Both;
 
             if ((adjustAxis == Axes.Y && !allSelectedSupportManualSizing(Axes.Y)) ||
                 (adjustAxis == Axes.X && !allSelectedSupportManualSizing(Axes.X)))
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index ea98ac573c..60fbeb9fff 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -100,8 +100,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private void adjustScaleFromAnchor(ref Vector2 scale)
         {
             // cancel out scale in axes we don't care about (based on which drag handle was used).
-            if ((originalAnchor & Anchor.x1) > 0) scale.X = 1;
-            if ((originalAnchor & Anchor.y1) > 0) scale.Y = 1;
+            if ((originalAnchor & Anchor.x1) > 0) scale.X = 0;
+            if ((originalAnchor & Anchor.y1) > 0) scale.Y = 0;
 
             // reverse the scale direction if dragging from top or left.
             if ((originalAnchor & Anchor.x0) > 0) scale.X = -scale.X;

From 1596776a81b91db1850bf3325b6d2992ed5eaf6c Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:15:49 +0100
Subject: [PATCH 012/930] fix imports

---
 osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs           | 1 +
 .../Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs   | 1 -
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 3c4818a533..1e3e22e34a 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 60fbeb9fff..3dde97657f 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;

From 9b9485f656807570afd91bd3b25923147a2075f2 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:39:38 +0100
Subject: [PATCH 013/930] fix adjust axes detection

---
 .../Edit/OsuSelectionScaleHandler.cs          |  3 +-
 .../SkinEditor/SkinSelectionScaleHandler.cs   |  3 +-
 .../Components/SelectionBoxScaleHandle.cs     | 47 +++++++++++++------
 .../Components/SelectionScaleHandler.cs       |  8 ++--
 4 files changed, 40 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 1e3e22e34a..7d5240fb69 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -7,6 +7,7 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
@@ -82,7 +83,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                 obj => obj.Path.ControlPoints.Select(p => p.Type).ToArray());
         }
 
-        public override void Update(Vector2 scale, Vector2? origin = null)
+        public override void Update(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
         {
             if (objectsInScale == null)
                 throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index bf75469d7a..0bd146a0a1 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -83,7 +83,7 @@ namespace osu.Game.Overlays.SkinEditor
             isFlippedY = false;
         }
 
-        public override void Update(Vector2 scale, Vector2? origin = null)
+        public override void Update(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
         {
             if (objectsInScale == null)
                 throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
@@ -91,7 +91,6 @@ namespace osu.Game.Overlays.SkinEditor
             Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
 
             var actualOrigin = origin ?? defaultOrigin.Value;
-            Axes adjustAxis = scale.X == 1 ? Axes.Y : scale.Y == 1 ? Axes.X : Axes.Both;
 
             if ((adjustAxis == Axes.Y && !allSelectedSupportManualSizing(Axes.Y)) ||
                 (adjustAxis == Axes.X && !allSelectedSupportManualSizing(Axes.X)))
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 3dde97657f..d433e4e860 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -38,20 +38,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
             return true;
         }
 
-        private Vector2 getOriginPosition()
-        {
-            var quad = scaleHandler!.OriginalSurroundingQuad!.Value;
-            Vector2 origin = quad.TopLeft;
-
-            if ((originalAnchor & Anchor.x0) > 0)
-                origin.X += quad.Width;
-
-            if ((originalAnchor & Anchor.y0) > 0)
-                origin.Y += quad.Height;
-
-            return origin;
-        }
-
         private Vector2 rawScale;
 
         protected override void OnDrag(DragEvent e)
@@ -113,7 +99,38 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 ? new Vector2((rawScale.X + rawScale.Y) * 0.5f)
                 : rawScale;
 
-            scaleHandler!.Update(newScale, getOriginPosition());
+            scaleHandler!.Update(newScale, getOriginPosition(), getAdjustAxis());
+        }
+
+        private Vector2 getOriginPosition()
+        {
+            var quad = scaleHandler!.OriginalSurroundingQuad!.Value;
+            Vector2 origin = quad.TopLeft;
+
+            if ((originalAnchor & Anchor.x0) > 0)
+                origin.X += quad.Width;
+
+            if ((originalAnchor & Anchor.y0) > 0)
+                origin.Y += quad.Height;
+
+            return origin;
+        }
+
+        private Axes getAdjustAxis()
+        {
+            switch (originalAnchor)
+            {
+                case Anchor.TopCentre:
+                case Anchor.BottomCentre:
+                    return Axes.Y;
+
+                case Anchor.CentreLeft:
+                case Anchor.CentreRight:
+                    return Axes.X;
+
+                default:
+                    return Axes.Both;
+            }
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
index 59406b3184..a96f627e56 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionScaleHandler.cs
@@ -46,10 +46,11 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// The origin point to scale from.
         /// If the default <see langword="null"/> value is supplied, a sane implementation-defined default will be used.
         /// </param>
-        public void ScaleSelection(Vector2 scale, Vector2? origin = null)
+        /// <param name="adjustAxis">The axes to adjust the scale in.</param>
+        public void ScaleSelection(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
         {
             Begin();
-            Update(scale, origin);
+            Update(scale, origin, adjustAxis);
             Commit();
         }
 
@@ -83,7 +84,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         /// The origin point to scale from.
         /// If the default <see langword="null"/> value is supplied, a sane implementation-defined default will be used.
         /// </param>
-        public virtual void Update(Vector2 scale, Vector2? origin = null)
+        /// <param name="adjustAxis">The axes to adjust the scale in.</param>
+        public virtual void Update(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
         {
         }
 

From ac76af5cc8f894dfb87ae4d4987172b9f5a85934 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:43:47 +0100
Subject: [PATCH 014/930] fix skin scale coordinate system

---
 osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index 0bd146a0a1..e87952efa0 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -76,7 +76,7 @@ namespace osu.Game.Overlays.SkinEditor
             originalHeights = objectsInScale.ToDictionary(d => d, d => d.Height);
             originalScales = objectsInScale.ToDictionary(d => d, d => d.Scale);
             originalPositions = objectsInScale.ToDictionary(d => d, d => d.ToScreenSpace(d.OriginPosition));
-            OriginalSurroundingQuad = GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.ScreenSpaceDrawQuad.GetVertices().ToArray()));
+            OriginalSurroundingQuad = ToLocalSpace(GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.ScreenSpaceDrawQuad.GetVertices().ToArray())));
             defaultOrigin = OriginalSurroundingQuad.Value.Centre;
 
             isFlippedX = false;
@@ -90,7 +90,7 @@ namespace osu.Game.Overlays.SkinEditor
 
             Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
 
-            var actualOrigin = origin ?? defaultOrigin.Value;
+            var actualOrigin = ToScreenSpace(origin ?? defaultOrigin.Value);
 
             if ((adjustAxis == Axes.Y && !allSelectedSupportManualSizing(Axes.Y)) ||
                 (adjustAxis == Axes.X && !allSelectedSupportManualSizing(Axes.X)))

From 9459c66981a022905283b603f9bfb0d7e3cf6e77 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 15:53:08 +0100
Subject: [PATCH 015/930] fix test

---
 osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
index 680a76f9b8..4c60ecf5db 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Tests.Visual.Editing
                 OriginalSurroundingQuad = new Quad(targetContainer!.X, targetContainer.Y, targetContainer.Width, targetContainer.Height);
             }
 
-            public override void Update(Vector2 scale, Vector2? origin = null)
+            public override void Update(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
             {
                 if (targetContainer == null)
                     throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");

From a155b315bf8ad9060ae214ccc8763e4deebdae6c Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 16:10:17 +0100
Subject: [PATCH 016/930] Fix negative width or height skin drawables

---
 osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index e87952efa0..8daf0043da 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -151,11 +151,11 @@ namespace osu.Game.Overlays.SkinEditor
                 switch (adjustAxis)
                 {
                     case Axes.X:
-                        b.Width = originalWidths[b] * currentScale.X;
+                        b.Width = MathF.Abs(originalWidths[b] * currentScale.X);
                         break;
 
                     case Axes.Y:
-                        b.Height = originalHeights[b] * currentScale.Y;
+                        b.Height = MathF.Abs(originalHeights[b] * currentScale.Y);
                         break;
 
                     case Axes.Both:

From 5f40d3aed9ca859535c75d8f9e927d5cc7ad1581 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 16:29:26 +0100
Subject: [PATCH 017/930] rename variable

---
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index d433e4e860..74629a5384 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -48,14 +48,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             rawScale = convertDragEventToScaleMultiplier(e);
 
-            applyScale(shouldKeepAspectRatio: e.ShiftPressed);
+            applyScale(shouldLockAspectRatio: e.ShiftPressed);
         }
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
             if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
             {
-                applyScale(shouldKeepAspectRatio: true);
+                applyScale(shouldLockAspectRatio: true);
                 return true;
             }
 
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             base.OnKeyUp(e);
 
             if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
-                applyScale(shouldKeepAspectRatio: false);
+                applyScale(shouldLockAspectRatio: false);
         }
 
         protected override void OnDragEnd(DragEndEvent e)
@@ -93,9 +93,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
             if ((originalAnchor & Anchor.y0) > 0) scale.Y = -scale.Y;
         }
 
-        private void applyScale(bool shouldKeepAspectRatio)
+        private void applyScale(bool shouldLockAspectRatio)
         {
-            var newScale = shouldKeepAspectRatio
+            var newScale = shouldLockAspectRatio
                 ? new Vector2((rawScale.X + rawScale.Y) * 0.5f)
                 : rawScale;
 

From 2f924b33686ff7d7cb3080c2cc16f891d27cbc2e Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 16:33:03 +0100
Subject: [PATCH 018/930] fix skewed single axis scale

---
 .../SkinEditor/SkinSelectionScaleHandler.cs      | 16 ++++------------
 1 file changed, 4 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index 8daf0043da..0c2ee6aae3 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -100,23 +100,15 @@ namespace osu.Game.Overlays.SkinEditor
             if (OriginalSurroundingQuad.Value.Width == 0 || OriginalSurroundingQuad.Value.Height == 0)
                 return;
 
-            // for now aspect lock scale adjustments that occur at corners..
+            // for now aspect lock scale adjustments that occur at corners.
             if (adjustAxis == Axes.Both)
             {
                 // project scale vector along diagonal
                 scale = new Vector2((scale.X + scale.Y) * 0.5f);
             }
-            // ..or if any of the selection have been rotated.
-            // this is to avoid requiring skew logic (which would likely not be the user's expected transform anyway).
-            else if (objectsInScale.Any(b => !Precision.AlmostEquals(b.Rotation % 90, 0)))
-            {
-                if (adjustAxis == Axes.Y)
-                    // if dragging from the horizontal centre, only a vertical component is available.
-                    scale.X = scale.Y;
-                else
-                    // in all other cases (arbitrarily) use the horizontal component for aspect lock.
-                    scale.Y = scale.X;
-            }
+            // If any of the selection have been rotated and the adjust axis is not both,
+            // we would require skew logic to achieve a correct image editor-like scale.
+            // For now we just ignore, because it would likely not be the user's expected transform anyway.
 
             bool flippedX = scale.X < 0;
             bool flippedY = scale.Y < 0;

From 78e87d379b760b9ebd5d567610423b607013b16d Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Sat, 20 Jan 2024 16:49:10 +0100
Subject: [PATCH 019/930] fix divide by zero

---
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs    | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 74629a5384..a1f6a1732a 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
+using osu.Framework.Utils;
 using osuTK;
 using osuTK.Input;
 
@@ -79,7 +80,12 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             Vector2 scale = e.MousePosition - e.MouseDownPosition;
             adjustScaleFromAnchor(ref scale);
-            return Vector2.Divide(scale, scaleHandler!.OriginalSurroundingQuad!.Value.Size) + Vector2.One;
+
+            var surroundingQuad = scaleHandler!.OriginalSurroundingQuad!.Value;
+            scale.X = Precision.AlmostEquals(surroundingQuad.Width, 0) ? 0 : scale.X / surroundingQuad.Width;
+            scale.Y = Precision.AlmostEquals(surroundingQuad.Height, 0) ? 0 : scale.Y / surroundingQuad.Height;
+
+            return scale + Vector2.One;
         }
 
         private void adjustScaleFromAnchor(ref Vector2 scale)

From e1f8bc96924b104665782aacfd223eb2ba9dafed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 12:09:39 +0700
Subject: [PATCH 020/930] Rename CanRotate property of SelectionRotationHandler
 to a more descriptive name

---
 osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs    | 4 +++-
 osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs          | 2 +-
 osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs   | 2 +-
 osu.Game/Overlays/SkinEditor/SkinSelectionRotationHandler.cs | 2 +-
 osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs     | 2 +-
 .../Edit/Compose/Components/SelectionRotationHandler.cs      | 5 +++--
 6 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
index 21fb8a67de..0ce78e4f61 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
@@ -19,6 +19,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public partial class OsuSelectionRotationHandler : SelectionRotationHandler
     {
+        public BindableBool CanRotatePlayfieldOrigin { get; private set; } = new();
         [Resolved]
         private IEditorChangeHandler? changeHandler { get; set; }
 
@@ -41,7 +42,8 @@ namespace osu.Game.Rulesets.Osu.Edit
         private void updateState()
         {
             var quad = GeometryUtils.GetSurroundingQuad(selectedMovableObjects);
-            CanRotate.Value = quad.Width > 0 || quad.Height > 0;
+            CanRotateSelectionOrigin.Value = quad.Width > 0 || quad.Height > 0;
+            CanRotatePlayfieldOrigin.Value = selectedItems.Any();
         }
 
         private OsuHitObject[]? objectsInRotation;
diff --git a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
index 3da9f5b69b..291c79e613 100644
--- a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
+++ b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             // bindings to `Enabled` on the buttons are decoupled on purpose
             // due to the weird `OsuButton` behaviour of resetting `Enabled` to `false` when `Action` is set.
-            canRotate.BindTo(RotationHandler.CanRotate);
+            canRotate.BindTo(RotationHandler.CanRotateSelectionOrigin);
             canRotate.BindValueChanged(_ => rotateButton.Enabled.Value = canRotate.Value, true);
         }
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
index f6637d0e80..8e4f4a1cfd 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneComposeSelectBox.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.Editing
             {
                 this.getTargetContainer = getTargetContainer;
 
-                CanRotate.Value = true;
+                CanRotateSelectionOrigin.Value = true;
             }
 
             [CanBeNull]
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionRotationHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionRotationHandler.cs
index 60f69000a2..7ecf116b68 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionRotationHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionRotationHandler.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Overlays.SkinEditor
 
         private void updateState()
         {
-            CanRotate.Value = selectedItems.Count > 0;
+            CanRotateSelectionOrigin.Value = selectedItems.Count > 0;
         }
 
         private Drawable[]? objectsInRotation;
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
index 0b16941bc4..85ea7364e8 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBox.cs
@@ -174,7 +174,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
         private void load()
         {
             if (rotationHandler != null)
-                canRotate.BindTo(rotationHandler.CanRotate);
+                canRotate.BindTo(rotationHandler.CanRotateSelectionOrigin);
 
             canRotate.BindValueChanged(_ => recreate(), true);
         }
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
index 5faa4a108d..749e1aab17 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
@@ -13,9 +13,10 @@ namespace osu.Game.Screens.Edit.Compose.Components
     public partial class SelectionRotationHandler : Component
     {
         /// <summary>
-        /// Whether the rotation can currently be performed.
+        /// Whether rotation anchored by the selection origin can currently be performed.
+        /// This is in constrast to rotation anchored by the entire field.
         /// </summary>
-        public Bindable<bool> CanRotate { get; private set; } = new BindableBool();
+        public Bindable<bool> CanRotateSelectionOrigin { get; private set; } = new BindableBool();
 
         /// <summary>
         /// Performs a single, instant, atomic rotation operation.

From 601ba9f194ee029714d85a73f4e0078a7401f910 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 12:16:35 +0700
Subject: [PATCH 021/930] Change rotate tool button to be enabled on single
 circle. Inject osu ruleset specific rotate handler instead of generic
 handler.

---
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs  | 5 ++++-
 osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs   | 2 +-
 osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs | 5 ++---
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index 448cfaf84c..a0fb0b06c3 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -101,7 +101,10 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             RightToolbox.AddRange(new EditorToolboxGroup[]
                 {
-                    new TransformToolboxGroup { RotationHandler = BlueprintContainer.SelectionHandler.RotationHandler, },
+                    new TransformToolboxGroup
+                    {
+                        RotationHandler = (OsuSelectionRotationHandler)BlueprintContainer.SelectionHandler.RotationHandler,
+                    },
                     FreehandlSliderToolboxGroup
                 }
             );
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index cea2adc6e2..7e645bc670 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             if ((reference & Anchor.y0) > 0) scale.Y = -scale.Y;
         }
 
-        public override SelectionRotationHandler CreateRotationHandler() => new OsuSelectionRotationHandler();
+        public override OsuSelectionRotationHandler CreateRotationHandler() => new OsuSelectionRotationHandler();
 
         private void scaleSlider(Slider slider, Vector2 scale)
         {
diff --git a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
index 291c79e613..c70f35c6fb 100644
--- a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
+++ b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
@@ -11,7 +11,6 @@ using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components;
-using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Edit
@@ -22,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private EditorToolButton rotateButton = null!;
 
-        public SelectionRotationHandler RotationHandler { get; init; } = null!;
+        public OsuSelectionRotationHandler RotationHandler { get; init; } = null!;
 
         public TransformToolboxGroup()
             : base("transform")
@@ -53,7 +52,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             // bindings to `Enabled` on the buttons are decoupled on purpose
             // due to the weird `OsuButton` behaviour of resetting `Enabled` to `false` when `Action` is set.
-            canRotate.BindTo(RotationHandler.CanRotateSelectionOrigin);
+            canRotate.BindTo(RotationHandler.CanRotatePlayfieldOrigin);
             canRotate.BindValueChanged(_ => rotateButton.Enabled.Value = canRotate.Value, true);
         }
 

From cc341b4119bd9a1aa8cb5aafe936088ff1e0f857 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Jan 2024 15:21:19 +0900
Subject: [PATCH 022/930] Adjust beatmap carousel padding to avoid scrollbar
 disappearing underneath logo

---
 osu.Game/Screens/Select/BeatmapCarousel.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Select/BeatmapCarousel.cs b/osu.Game/Screens/Select/BeatmapCarousel.cs
index 70ecde3858..32a1b5cb58 100644
--- a/osu.Game/Screens/Select/BeatmapCarousel.cs
+++ b/osu.Game/Screens/Select/BeatmapCarousel.cs
@@ -215,6 +215,12 @@ namespace osu.Game.Screens.Select
             InternalChild = new OsuContextMenuContainer
             {
                 RelativeSizeAxes = Axes.Both,
+                Padding = new MarginPadding
+                {
+                    // Avoid clash between scrollbar and osu! logo.
+                    Top = 10,
+                    Bottom = 100,
+                },
                 Children = new Drawable[]
                 {
                     setPool,

From 500bed01215f6b99eeb3a6a717563b243c18ccd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 14:24:35 +0700
Subject: [PATCH 023/930] Split editor toolbox radio button disabling logic
 from EditorRadioButton, then add disabling logic for rotate popover

---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs      | 8 +++++++-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs               | 8 ++++++++
 .../Edit/Components/RadioButtons/EditorRadioButton.cs     | 2 --
 3 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index f09d6b78e6..fdab84f38d 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -24,6 +24,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         private SliderWithTextBoxInput<float> angleInput = null!;
         private EditorRadioButtonCollection rotationOrigin = null!;
 
+        private RadioButton selectionCentreButton = null!;
         public PreciseRotationPopover(SelectionRotationHandler rotationHandler)
         {
             this.rotationHandler = rotationHandler;
@@ -59,7 +60,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                             new RadioButton("Playfield centre",
                                 () => rotationInfo.Value = rotationInfo.Value with { Origin = RotationOrigin.PlayfieldCentre },
                                 () => new SpriteIcon { Icon = FontAwesome.Regular.Square }),
-                            new RadioButton("Selection centre",
+                            selectionCentreButton = new RadioButton("Selection centre",
                                 () => rotationInfo.Value = rotationInfo.Value with { Origin = RotationOrigin.SelectionCentre },
                                 () => new SpriteIcon { Icon = FontAwesome.Solid.VectorSquare })
                         }
@@ -76,6 +77,11 @@ namespace osu.Game.Rulesets.Osu.Edit
             angleInput.Current.BindValueChanged(angle => rotationInfo.Value = rotationInfo.Value with { Degrees = angle.NewValue });
             rotationOrigin.Items.First().Select();
 
+            rotationHandler.CanRotateSelectionOrigin.BindValueChanged(e =>
+            {
+                selectionCentreButton.Selected.Disabled = !e.NewValue;
+            }, true);
+
             rotationInfo.BindValueChanged(rotation =>
             {
                 rotationHandler.Update(rotation.NewValue.Degrees, rotation.NewValue.Origin == RotationOrigin.PlayfieldCentre ? OsuPlayfield.BASE_SIZE / 2 : null);
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 50e6393895..6abc6cb95b 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -244,6 +244,14 @@ namespace osu.Game.Rulesets.Edit
                 if (!timing.NewValue)
                     setSelectTool();
             });
+
+            EditorBeatmap.HasTiming.BindValueChanged(hasTiming =>
+            {
+                foreach (var item in toolboxCollection.Items)
+                {
+                    item.Selected.Disabled = !hasTiming.NewValue;
+                }
+            }, true);
         }
 
         protected override void Update()
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
index 65f3e41c13..5549095639 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
@@ -76,8 +76,6 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
                     Selected?.Invoke(Button);
             };
 
-            editorBeatmap?.HasTiming.BindValueChanged(hasTiming => Button.Selected.Disabled = !hasTiming.NewValue, true);
-
             Button.Selected.BindDisabledChanged(disabled => Enabled.Value = !disabled, true);
             updateSelectionState();
         }

From 94ada87cbad0828fcb669d0e4133f850b12a07b3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 14:24:45 +0700
Subject: [PATCH 024/930] Un-hardcode tooltip from EditorRadioButton and add
 disabled tooltip for rotation popover

---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs  |  2 ++
 osu.Game/Rulesets/Edit/HitObjectComposer.cs           |  5 +++++
 .../Edit/Components/RadioButtons/EditorRadioButton.cs |  2 +-
 .../Edit/Components/RadioButtons/RadioButton.cs       | 11 +++++++++++
 4 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index fdab84f38d..2cf6799279 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         private EditorRadioButtonCollection rotationOrigin = null!;
 
         private RadioButton selectionCentreButton = null!;
+
         public PreciseRotationPopover(SelectionRotationHandler rotationHandler)
         {
             this.rotationHandler = rotationHandler;
@@ -67,6 +68,7 @@ namespace osu.Game.Rulesets.Osu.Edit
                     }
                 }
             };
+            selectionCentreButton.TooltipTextWhenDisabled = "We can't rotate a circle around itself! Can we?";
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 6abc6cb95b..bc8de7f4b2 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -212,6 +212,11 @@ namespace osu.Game.Rulesets.Edit
                                       .Select(t => new RadioButton(t.Name, () => toolSelected(t), t.CreateIcon))
                                       .ToList();
 
+            foreach (var item in toolboxCollection.Items)
+            {
+                item.TooltipTextWhenDisabled = "Add at least one timing point first!";
+            }
+
             TernaryStates = CreateTernaryButtons().ToArray();
             togglesCollection.AddRange(TernaryStates.Select(b => new DrawableTernaryButton(b)));
 
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
index 5549095639..601548fadd 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
@@ -97,6 +97,6 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
             X = 40f
         };
 
-        public LocalisableString TooltipText => Enabled.Value ? string.Empty : "Add at least one timing point first!";
+        public LocalisableString TooltipText => Enabled.Value ? Button.TooltipTextWhenEnabled : Button.TooltipTextWhenDisabled;
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
index 9dcd29bf83..1b47c028ab 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Localisation;
 
 namespace osu.Game.Screens.Edit.Components.RadioButtons
 {
@@ -11,9 +12,19 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
     {
         /// <summary>
         /// Whether this <see cref="RadioButton"/> is selected.
+        /// Disable this bindable to disable the button.
         /// </summary>
         public readonly BindableBool Selected;
 
+        /// <summary>
+        /// Tooltip text that will be shown on hover if button is enabled.
+        /// </summary>
+        public LocalisableString TooltipTextWhenEnabled { get; set; } = string.Empty;
+        /// <summary>
+        /// Tooltip text that will be shown on hover if button is disabled.
+        /// </summary>
+        public LocalisableString TooltipTextWhenDisabled { get; set; } = string.Empty;
+
         /// <summary>
         /// The item related to this button.
         /// </summary>

From b87ff4db0d5d69e7f8e787eb1135745c491c074e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 15:33:48 +0700
Subject: [PATCH 025/930] Edit test for precise rotation popover

---
 .../Editor/TestScenePreciseRotation.cs        | 41 +++++++++++++++++--
 1 file changed, 37 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
index d7dd30d608..67283f40da 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
@@ -24,14 +24,38 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Test]
         public void TestHotkeyHandling()
         {
-            AddStep("select single circle", () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.OfType<HitCircle>().First()));
+            AddStep("deselect everything", () => EditorBeatmap.SelectedHitObjects.Clear());
             AddStep("press rotate hotkey", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
                 InputManager.Key(Key.R);
                 InputManager.ReleaseKey(Key.ControlLeft);
             });
-            AddUntilStep("no popover present", () => this.ChildrenOfType<PreciseRotationPopover>().Count(), () => Is.Zero);
+            AddUntilStep("no popover present", getPopover, () => Is.Null);
+
+            AddStep("select single circle",
+                () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.OfType<HitCircle>().First()));
+            AddStep("press rotate hotkey", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.R);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            AddUntilStep("popover present", getPopover, () => Is.Not.Null);
+            AddAssert("only playfield centre origin rotation available", () =>
+            {
+                var popover = getPopover();
+                var buttons = popover.ChildrenOfType<EditorRadioButton>();
+                return buttons.Any(btn => btn.Text == "Selection centre" && btn.Enabled.Value is false) &&
+                    buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value is true);
+            });
+            AddStep("press rotate hotkey", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.R);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+            AddUntilStep("no popover present", getPopover, () => Is.Null);
 
             AddStep("select first three objects", () =>
             {
@@ -44,14 +68,23 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.Key(Key.R);
                 InputManager.ReleaseKey(Key.ControlLeft);
             });
-            AddUntilStep("popover present", () => this.ChildrenOfType<PreciseRotationPopover>().Count(), () => Is.EqualTo(1));
+            AddUntilStep("popover present", getPopover, () => Is.Not.Null);
+            AddAssert("both origin rotation available", () =>
+            {
+                var popover = getPopover();
+                var buttons = popover.ChildrenOfType<EditorRadioButton>();
+                return buttons.Any(btn => btn.Text == "Selection centre" && btn.Enabled.Value is true) &&
+                    buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value is true);
+            });
             AddStep("press rotate hotkey", () =>
             {
                 InputManager.PressKey(Key.ControlLeft);
                 InputManager.Key(Key.R);
                 InputManager.ReleaseKey(Key.ControlLeft);
             });
-            AddUntilStep("no popover present", () => this.ChildrenOfType<PreciseRotationPopover>().Count(), () => Is.Zero);
+            AddUntilStep("no popover present", getPopover, () => Is.Null);
+
+            PreciseRotationPopover? getPopover() => this.ChildrenOfType<PreciseRotationPopover>().SingleOrDefault();
         }
 
         [Test]

From 2fa52de87a07a7bbdbbde850ccd47d5722d1cc55 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 15:52:57 +0700
Subject: [PATCH 026/930] Fix formatting

---
 .../Editor/TestScenePreciseRotation.cs                    | 8 ++++----
 osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs | 3 ++-
 .../Edit/Components/RadioButtons/EditorRadioButton.cs     | 3 ---
 .../Screens/Edit/Components/RadioButtons/RadioButton.cs   | 1 +
 4 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
index 67283f40da..30e0dbbf2e 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePreciseRotation.cs
@@ -46,8 +46,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             {
                 var popover = getPopover();
                 var buttons = popover.ChildrenOfType<EditorRadioButton>();
-                return buttons.Any(btn => btn.Text == "Selection centre" && btn.Enabled.Value is false) &&
-                    buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value is true);
+                return buttons.Any(btn => btn.Text == "Selection centre" && !btn.Enabled.Value)
+                       && buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value);
             });
             AddStep("press rotate hotkey", () =>
             {
@@ -73,8 +73,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             {
                 var popover = getPopover();
                 var buttons = popover.ChildrenOfType<EditorRadioButton>();
-                return buttons.Any(btn => btn.Text == "Selection centre" && btn.Enabled.Value is true) &&
-                    buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value is true);
+                return buttons.Any(btn => btn.Text == "Selection centre" && btn.Enabled.Value)
+                       && buttons.Any(btn => btn.Text == "Playfield centre" && btn.Enabled.Value);
             });
             AddStep("press rotate hotkey", () =>
             {
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
index 0ce78e4f61..cd01fc9f4d 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
@@ -19,7 +19,8 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public partial class OsuSelectionRotationHandler : SelectionRotationHandler
     {
-        public BindableBool CanRotatePlayfieldOrigin { get; private set; } = new();
+        public BindableBool CanRotatePlayfieldOrigin { get; private set; } = new BindableBool();
+
         [Resolved]
         private IEditorChangeHandler? changeHandler { get; set; }
 
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
index 601548fadd..9d1f87e1e0 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
@@ -33,9 +33,6 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
 
         private Drawable icon = null!;
 
-        [Resolved]
-        private EditorBeatmap? editorBeatmap { get; set; }
-
         public EditorRadioButton(RadioButton button)
         {
             Button = button;
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
index 1b47c028ab..2d1416c9c6 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
@@ -20,6 +20,7 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
         /// Tooltip text that will be shown on hover if button is enabled.
         /// </summary>
         public LocalisableString TooltipTextWhenEnabled { get; set; } = string.Empty;
+
         /// <summary>
         /// Tooltip text that will be shown on hover if button is disabled.
         /// </summary>

From d5b70ed09a68c8c99484df97dd4fbd245c233e8e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Thu, 25 Jan 2024 16:56:59 +0700
Subject: [PATCH 027/930] Move CanRotatePlayfieldOrigin bindable to generic
 rotation handler

---
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs          | 5 +----
 osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs           | 2 +-
 osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs   | 2 --
 osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs         | 3 ++-
 .../Edit/Compose/Components/SelectionRotationHandler.cs     | 6 +++++-
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index a0fb0b06c3..448cfaf84c 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -101,10 +101,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             RightToolbox.AddRange(new EditorToolboxGroup[]
                 {
-                    new TransformToolboxGroup
-                    {
-                        RotationHandler = (OsuSelectionRotationHandler)BlueprintContainer.SelectionHandler.RotationHandler,
-                    },
+                    new TransformToolboxGroup { RotationHandler = BlueprintContainer.SelectionHandler.RotationHandler, },
                     FreehandlSliderToolboxGroup
                 }
             );
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index 7e645bc670..cea2adc6e2 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -164,7 +164,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             if ((reference & Anchor.y0) > 0) scale.Y = -scale.Y;
         }
 
-        public override OsuSelectionRotationHandler CreateRotationHandler() => new OsuSelectionRotationHandler();
+        public override SelectionRotationHandler CreateRotationHandler() => new OsuSelectionRotationHandler();
 
         private void scaleSlider(Slider slider, Vector2 scale)
         {
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
index cd01fc9f4d..1998e02a5c 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
@@ -19,8 +19,6 @@ namespace osu.Game.Rulesets.Osu.Edit
 {
     public partial class OsuSelectionRotationHandler : SelectionRotationHandler
     {
-        public BindableBool CanRotatePlayfieldOrigin { get; private set; } = new BindableBool();
-
         [Resolved]
         private IEditorChangeHandler? changeHandler { get; set; }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
index c70f35c6fb..19590e9b6e 100644
--- a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
+++ b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
@@ -11,6 +11,7 @@ using osu.Framework.Input.Events;
 using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Screens.Edit.Components;
+using osu.Game.Screens.Edit.Compose.Components;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Edit
@@ -21,7 +22,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private EditorToolButton rotateButton = null!;
 
-        public OsuSelectionRotationHandler RotationHandler { get; init; } = null!;
+        public SelectionRotationHandler RotationHandler { get; init; } = null!;
 
         public TransformToolboxGroup()
             : base("transform")
diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
index 749e1aab17..459e4b0c41 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionRotationHandler.cs
@@ -14,10 +14,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
     {
         /// <summary>
         /// Whether rotation anchored by the selection origin can currently be performed.
-        /// This is in constrast to rotation anchored by the entire field.
         /// </summary>
         public Bindable<bool> CanRotateSelectionOrigin { get; private set; } = new BindableBool();
 
+        /// <summary>
+        /// Whether rotation anchored by the center of the playfield can currently be performed.
+        /// </summary>
+        public Bindable<bool> CanRotatePlayfieldOrigin { get; private set; } = new BindableBool();
+
         /// <summary>
         /// Performs a single, instant, atomic rotation operation.
         /// </summary>

From 3f9c2b41f7080639d3f4d94097cfeb3238ee503a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Jan 2024 21:28:08 +0900
Subject: [PATCH 028/930] Adjust `BeatSyncContainer`'s early animate offset
 based on source's rate

---
 osu.Game/Graphics/Containers/BeatSyncedContainer.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index f911311a09..a14dfd4d64 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -91,7 +91,17 @@ namespace osu.Game.Graphics.Containers
 
             if (IsBeatSyncedWithTrack)
             {
-                currentTrackTime = BeatSyncSource.Clock.CurrentTime + EarlyActivationMilliseconds;
+                double early = EarlyActivationMilliseconds;
+
+                // In the case of gameplay, we are usually within a hierarchy with the correct rate applied to our `Drawable.Clock`.
+                // This means that the amount of early adjustment is adjusted in line with audio track rate changes.
+                // But other cases like the osu! logo at the main menu won't correctly have this rate information.
+                //
+                // So for cases where the rate of the source isn't in sync with our hierarchy, let's assume we need to account for it locally.
+                if (Clock.Rate == 1 && BeatSyncSource.Clock.Rate != Clock.Rate)
+                    early *= BeatSyncSource.Clock.Rate;
+
+                currentTrackTime = BeatSyncSource.Clock.CurrentTime + early;
 
                 timingPoint = BeatSyncSource.ControlPoints?.TimingPointAt(currentTrackTime) ?? TimingControlPoint.DEFAULT;
                 effectPoint = BeatSyncSource.ControlPoints?.EffectPointAt(currentTrackTime) ?? EffectControlPoint.DEFAULT;

From a77db5d837bb41f57b533c7dff1b893eaa5148a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Jan 2024 13:36:50 +0900
Subject: [PATCH 029/930] Add failing test coverage of editor metadata not
 saving

---
 .../Editing/TestSceneMetadataSection.cs       | 105 ++++++++++++++++--
 1 file changed, 94 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index a9f8e19e30..f767d9f7a3 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
@@ -3,17 +3,22 @@
 
 #nullable disable
 
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input;
+using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.Setup;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Editing
 {
-    public partial class TestSceneMetadataSection : OsuTestScene
+    public partial class TestSceneMetadataSection : OsuManualInputManagerTestScene
     {
         [Cached]
         private EditorBeatmap editorBeatmap = new EditorBeatmap(new Beatmap
@@ -26,6 +31,81 @@ namespace osu.Game.Tests.Visual.Editing
 
         private TestMetadataSection metadataSection;
 
+        [Test]
+        public void TestUpdateViaTextBoxOnFocusLoss()
+        {
+            AddStep("set metadata", () =>
+            {
+                editorBeatmap.Metadata.Artist = "Example Artist";
+                editorBeatmap.Metadata.ArtistUnicode = string.Empty;
+            });
+
+            createSection();
+
+            TextBox textbox = null!;
+
+            AddStep("focus first textbox", () =>
+            {
+                textbox = metadataSection.ChildrenOfType<TextBox>().First();
+                InputManager.MoveMouseTo(textbox);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("simulate changing textbox", () =>
+            {
+                // Can't simulate text input but this should work.
+                InputManager.Keys(PlatformAction.SelectAll);
+                InputManager.Keys(PlatformAction.Copy);
+                InputManager.Keys(PlatformAction.Paste);
+                InputManager.Keys(PlatformAction.Paste);
+            });
+
+            assertArtistMetadata("Example Artist");
+
+            // It's important values are committed immediately on focus loss so the editor exit sequence detects them.
+            AddAssert("value immediately changed on focus loss", () =>
+            {
+                InputManager.TriggerFocusContention(metadataSection);
+                return editorBeatmap.Metadata.Artist;
+            }, () => Is.EqualTo("Example ArtistExample Artist"));
+        }
+
+        [Test]
+        public void TestUpdateViaTextBoxOnCommit()
+        {
+            AddStep("set metadata", () =>
+            {
+                editorBeatmap.Metadata.Artist = "Example Artist";
+                editorBeatmap.Metadata.ArtistUnicode = string.Empty;
+            });
+
+            createSection();
+
+            TextBox textbox = null!;
+
+            AddStep("focus first textbox", () =>
+            {
+                textbox = metadataSection.ChildrenOfType<TextBox>().First();
+                InputManager.MoveMouseTo(textbox);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("simulate changing textbox", () =>
+            {
+                // Can't simulate text input but this should work.
+                InputManager.Keys(PlatformAction.SelectAll);
+                InputManager.Keys(PlatformAction.Copy);
+                InputManager.Keys(PlatformAction.Paste);
+                InputManager.Keys(PlatformAction.Paste);
+            });
+
+            assertArtistMetadata("Example Artist");
+
+            AddStep("commit", () => InputManager.Key(Key.Enter));
+
+            assertArtistMetadata("Example ArtistExample Artist");
+        }
+
         [Test]
         public void TestMinimalMetadata()
         {
@@ -40,7 +120,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             createSection();
 
-            assertArtist("Example Artist");
+            assertArtistTextBox("Example Artist");
             assertRomanisedArtist("Example Artist", false);
 
             assertTitle("Example Title");
@@ -61,7 +141,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             createSection();
 
-            assertArtist("＊なみりん");
+            assertArtistTextBox("＊なみりん");
             assertRomanisedArtist(string.Empty, true);
 
             assertTitle("コイシテイク・プラネット");
@@ -82,7 +162,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             createSection();
 
-            assertArtist("＊なみりん");
+            assertArtistTextBox("＊なみりん");
             assertRomanisedArtist("*namirin", true);
 
             assertTitle("コイシテイク・プラネット");
@@ -104,11 +184,11 @@ namespace osu.Game.Tests.Visual.Editing
             createSection();
 
             AddStep("set romanised artist name", () => metadataSection.ArtistTextBox.Current.Value = "*namirin");
-            assertArtist("*namirin");
+            assertArtistTextBox("*namirin");
             assertRomanisedArtist("*namirin", false);
 
             AddStep("set native artist name", () => metadataSection.ArtistTextBox.Current.Value = "＊なみりん");
-            assertArtist("＊なみりん");
+            assertArtistTextBox("＊なみりん");
             assertRomanisedArtist("*namirin", true);
 
             AddStep("set romanised title", () => metadataSection.TitleTextBox.Current.Value = "Hitokoto no kyori");
@@ -123,21 +203,24 @@ namespace osu.Game.Tests.Visual.Editing
         private void createSection()
             => AddStep("create metadata section", () => Child = metadataSection = new TestMetadataSection());
 
-        private void assertArtist(string expected)
-            => AddAssert($"artist is {expected}", () => metadataSection.ArtistTextBox.Current.Value == expected);
+        private void assertArtistMetadata(string expected)
+            => AddAssert($"artist metadata is {expected}", () => editorBeatmap.Metadata.Artist, () => Is.EqualTo(expected));
+
+        private void assertArtistTextBox(string expected)
+            => AddAssert($"artist textbox is {expected}", () => metadataSection.ArtistTextBox.Current.Value, () => Is.EqualTo(expected));
 
         private void assertRomanisedArtist(string expected, bool editable)
         {
-            AddAssert($"romanised artist is {expected}", () => metadataSection.RomanisedArtistTextBox.Current.Value == expected);
+            AddAssert($"romanised artist is {expected}", () => metadataSection.RomanisedArtistTextBox.Current.Value, () => Is.EqualTo(expected));
             AddAssert($"romanised artist is {(editable ? "" : "not ")}editable", () => metadataSection.RomanisedArtistTextBox.ReadOnly == !editable);
         }
 
         private void assertTitle(string expected)
-            => AddAssert($"title is {expected}", () => metadataSection.TitleTextBox.Current.Value == expected);
+            => AddAssert($"title is {expected}", () => metadataSection.TitleTextBox.Current.Value, () => Is.EqualTo(expected));
 
         private void assertRomanisedTitle(string expected, bool editable)
         {
-            AddAssert($"romanised title is {expected}", () => metadataSection.RomanisedTitleTextBox.Current.Value == expected);
+            AddAssert($"romanised title is {expected}", () => metadataSection.RomanisedTitleTextBox.Current.Value, () => Is.EqualTo(expected));
             AddAssert($"romanised title is {(editable ? "" : "not ")}editable", () => metadataSection.RomanisedTitleTextBox.ReadOnly == !editable);
         }
 

From e54502eef1bd0d99e3a3b5c29476b0addc7a5c13 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Jan 2024 13:59:28 +0900
Subject: [PATCH 030/930] Add full editor save test coverage

---
 .../TestSceneBeatmapEditorNavigation.cs       | 55 +++++++++++++++++++
 1 file changed, 55 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
index 9930349b1b..370c40222e 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
@@ -7,6 +7,7 @@ using osu.Framework.Extensions;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -17,6 +18,7 @@ using osu.Game.Rulesets.Mania;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Screens.Edit;
 using osu.Game.Screens.Edit.GameplayTest;
+using osu.Game.Screens.Edit.Setup;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
@@ -27,6 +29,59 @@ namespace osu.Game.Tests.Visual.Navigation
 {
     public partial class TestSceneBeatmapEditorNavigation : OsuGameTestScene
     {
+        [Test]
+        public void TestChangeMetadataExitWhileTextboxFocusedPromptsSave()
+        {
+            BeatmapSetInfo beatmapSet = null!;
+
+            AddStep("import test beatmap", () => Game.BeatmapManager.Import(TestResources.GetTestBeatmapForImport()).WaitSafely());
+            AddStep("retrieve beatmap", () => beatmapSet = Game.BeatmapManager.QueryBeatmapSet(set => !set.Protected).AsNonNull().Value.Detach());
+
+            AddStep("present beatmap", () => Game.PresentBeatmap(beatmapSet));
+            AddUntilStep("wait for song select",
+                () => Game.Beatmap.Value.BeatmapSetInfo.Equals(beatmapSet)
+                      && Game.ScreenStack.CurrentScreen is PlaySongSelect songSelect
+                      && songSelect.IsLoaded);
+            AddStep("switch ruleset", () => Game.Ruleset.Value = new ManiaRuleset().RulesetInfo);
+
+            AddStep("open editor", () => ((PlaySongSelect)Game.ScreenStack.CurrentScreen).Edit(beatmapSet.Beatmaps.First(beatmap => beatmap.Ruleset.OnlineID == 0)));
+            AddUntilStep("wait for editor open", () => Game.ScreenStack.CurrentScreen is Editor editor && editor.ReadyForUse);
+
+            AddStep("change to song setup", () => InputManager.Key(Key.F4));
+
+            TextBox textbox = null!;
+
+            AddUntilStep("wait for metadata section", () =>
+            {
+                var t = Game.ChildrenOfType<MetadataSection>().SingleOrDefault().ChildrenOfType<TextBox>().FirstOrDefault();
+
+                if (t == null)
+                    return false;
+
+                textbox = t;
+                return true;
+            });
+
+            AddStep("focus textbox", () =>
+            {
+                InputManager.MoveMouseTo(textbox);
+                InputManager.Click(MouseButton.Left);
+            });
+
+            AddStep("simulate changing textbox", () =>
+            {
+                // Can't simulate text input but this should work.
+                InputManager.Keys(PlatformAction.SelectAll);
+                InputManager.Keys(PlatformAction.Copy);
+                InputManager.Keys(PlatformAction.Paste);
+                InputManager.Keys(PlatformAction.Paste);
+            });
+
+            AddStep("exit", () => Game.ChildrenOfType<Editor>().Single().Exit());
+
+            AddAssert("save dialog displayed", () => Game.ChildrenOfType<DialogOverlay>().Single().CurrentDialog is PromptForSaveDialog);
+        }
+
         [Test]
         public void TestEditorGameplayTestAlwaysUsesOriginalRuleset()
         {

From 45f2980dc099ba8c421395dd4258cdf3df4a2e55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Jan 2024 13:23:02 +0900
Subject: [PATCH 031/930] Fix potential editor data loss if exiting while a
 textbox is focused

---
 osu.Game/Screens/Edit/Editor.cs                |  6 ++++++
 osu.Game/Screens/Edit/Setup/MetadataSection.cs | 10 +++++-----
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index c1f6c02301..bc376f6165 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -719,6 +719,12 @@ namespace osu.Game.Screens.Edit
 
         public override bool OnExiting(ScreenExitEvent e)
         {
+            // Before exiting, trigger a focus loss.
+            //
+            // This is important to ensure that if the user is still editing a textbox, it will commit
+            // (and potentially block the exit procedure for save).
+            GetContainingInputManager().TriggerFocusContention(this);
+
             if (!ExitConfirmed)
             {
                 // dialog overlay may not be available in visual tests.
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 752f590308..b51c03b796 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -53,9 +53,6 @@ namespace osu.Game.Screens.Edit.Setup
                 sourceTextBox = createTextBox<LabelledTextBox>(BeatmapsetsStrings.ShowInfoSource, metadata.Source),
                 tagsTextBox = createTextBox<LabelledTextBox>(BeatmapsetsStrings.ShowInfoTags, metadata.Tags)
             };
-
-            foreach (var item in Children.OfType<LabelledTextBox>())
-                item.OnCommit += onCommit;
         }
 
         private TTextBox createTextBox<TTextBox>(LocalisableString label, string initialValue)
@@ -77,6 +74,10 @@ namespace osu.Game.Screens.Edit.Setup
 
             ArtistTextBox.Current.BindValueChanged(artist => transferIfRomanised(artist.NewValue, RomanisedArtistTextBox));
             TitleTextBox.Current.BindValueChanged(title => transferIfRomanised(title.NewValue, RomanisedTitleTextBox));
+
+            foreach (var item in Children.OfType<LabelledTextBox>())
+                item.OnCommit += onCommit;
+
             updateReadOnlyState();
         }
 
@@ -86,7 +87,6 @@ namespace osu.Game.Screens.Edit.Setup
                 target.Current.Value = value;
 
             updateReadOnlyState();
-            Scheduler.AddOnce(updateMetadata);
         }
 
         private void updateReadOnlyState()
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Edit.Setup
 
             // for now, update on commit rather than making BeatmapMetadata bindables.
             // after switching database engines we can reconsider if switching to bindables is a good direction.
-            Scheduler.AddOnce(updateMetadata);
+            updateMetadata();
         }
 
         private void updateMetadata()

From 5a1b0004db37148191ccbc349b8bd6fe4ca9e502 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 2 Feb 2024 01:17:28 +0300
Subject: [PATCH 032/930] Add failing test case

---
 .../Visual/Gameplay/TestScenePlayerLoader.cs  | 44 ++++++++++++++++++-
 1 file changed, 43 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index f97372e9b6..b2e607d9a3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -24,9 +24,11 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Utils;
+using osuTK;
 using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -53,6 +55,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Cached]
         private readonly VolumeOverlay volumeOverlay;
 
+        [Cached]
+        private readonly OsuLogo logo;
+
         [Cached(typeof(BatteryInfo))]
         private readonly LocalBatteryInfo batteryInfo = new LocalBatteryInfo();
 
@@ -76,7 +81,14 @@ namespace osu.Game.Tests.Visual.Gameplay
                     Anchor = Anchor.TopLeft,
                     Origin = Anchor.TopLeft,
                 },
-                changelogOverlay = new ChangelogOverlay()
+                changelogOverlay = new ChangelogOverlay(),
+                logo = new OsuLogo
+                {
+                    Anchor = Anchor.BottomRight,
+                    Origin = Anchor.BottomRight,
+                    Scale = new Vector2(0.5f),
+                    Position = new Vector2(128f),
+                },
             });
         }
 
@@ -204,6 +216,36 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddUntilStep("loads after idle", () => !loader.IsCurrentScreen());
         }
 
+        [Test]
+        public void TestLoadNotBlockedOnOsuLogo()
+        {
+            AddStep("load dummy beatmap", () => resetPlayer(false));
+            AddUntilStep("wait for current", () => loader.IsCurrentScreen());
+
+            AddUntilStep("wait for load ready", () =>
+            {
+                moveMouse();
+                return player?.LoadState == LoadState.Ready;
+            });
+
+            // move mouse in logo while waiting for load to still proceed (it shouldn't be blocked when hovering logo).
+            AddUntilStep("move mouse in logo", () =>
+            {
+                moveMouse();
+                return !loader.IsCurrentScreen();
+            });
+
+            void moveMouse()
+            {
+                notificationOverlay.State.Value = Visibility.Hidden;
+
+                InputManager.MoveMouseTo(
+                    logo.ScreenSpaceDrawQuad.TopLeft
+                    + (logo.ScreenSpaceDrawQuad.BottomRight - logo.ScreenSpaceDrawQuad.TopLeft)
+                    * RNG.NextSingle(0.3f, 0.7f));
+            }
+        }
+
         [Test]
         public void TestLoadContinuation()
         {

From 0502997ae958e0697fcdbcad2555e80c52b6a22d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 2 Feb 2024 01:02:13 +0300
Subject: [PATCH 033/930] Stop blocking player loader when hovering over osu!
 logo

---
 osu.Game/Screens/Play/PlayerLoader.cs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 232de53ac3..201511529e 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -106,8 +106,8 @@ namespace osu.Game.Screens.Play
             && ReadyForGameplay;
 
         protected virtual bool ReadyForGameplay =>
-            // not ready if the user is hovering one of the panes, unless they are idle.
-            (IsHovered || idleTracker.IsIdle.Value)
+            // not ready if the user is hovering one of the panes (logo is excluded), unless they are idle.
+            (IsHovered || osuLogo?.IsHovered == true || idleTracker.IsIdle.Value)
             // not ready if the user is dragging a slider or otherwise.
             && inputManager.DraggedDrawable == null
             // not ready if a focused overlay is visible, like settings.
@@ -306,10 +306,14 @@ namespace osu.Game.Screens.Play
             return base.OnExiting(e);
         }
 
+        private OsuLogo? osuLogo;
+
         protected override void LogoArriving(OsuLogo logo, bool resuming)
         {
             base.LogoArriving(logo, resuming);
 
+            osuLogo = logo;
+
             const double duration = 300;
 
             if (!resuming) logo.MoveTo(new Vector2(0.5f), duration, Easing.OutQuint);
@@ -328,6 +332,7 @@ namespace osu.Game.Screens.Play
         {
             base.LogoExiting(logo);
             content.StopTracking();
+            osuLogo = null;
         }
 
         protected override void LogoSuspending(OsuLogo logo)
@@ -338,6 +343,8 @@ namespace osu.Game.Screens.Play
             logo
                 .FadeOut(CONTENT_OUT_DURATION / 2, Easing.OutQuint)
                 .ScaleTo(logo.Scale * 0.8f, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
+
+            osuLogo = null;
         }
 
         #endregion

From fe0433e6ecd1a69132fee41626562590c4b688ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 2 Feb 2024 13:24:59 +0100
Subject: [PATCH 034/930] Remove redundant default value assignments

---
 osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index f767d9f7a3..5930c077a4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             createSection();
 
-            TextBox textbox = null!;
+            TextBox textbox;
 
             AddStep("focus first textbox", () =>
             {
@@ -81,7 +81,7 @@ namespace osu.Game.Tests.Visual.Editing
 
             createSection();
 
-            TextBox textbox = null!;
+            TextBox textbox;
 
             AddStep("focus first textbox", () =>
             {

From dbd4397bef2419ea4d9b1b8fdc44068358d59159 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 2 Feb 2024 13:32:16 +0100
Subject: [PATCH 035/930] Attempt to salvage test by using until step

---
 .../Visual/Navigation/TestSceneBeatmapEditorNavigation.cs       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
index 370c40222e..e3a8e575f8 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneBeatmapEditorNavigation.cs
@@ -79,7 +79,7 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddStep("exit", () => Game.ChildrenOfType<Editor>().Single().Exit());
 
-            AddAssert("save dialog displayed", () => Game.ChildrenOfType<DialogOverlay>().Single().CurrentDialog is PromptForSaveDialog);
+            AddUntilStep("save dialog displayed", () => Game.ChildrenOfType<DialogOverlay>().SingleOrDefault()?.CurrentDialog is PromptForSaveDialog);
         }
 
         [Test]

From 498d93be614cfd9057ca9c3af0ff63f4c581b3f2 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 3 Feb 2024 16:59:48 +0100
Subject: [PATCH 036/930] Add way to associate with files and URIs on Windows

---
 .../TestSceneWindowsAssociationManager.cs     | 106 +++++++
 .../WindowsAssociationManagerStrings.cs       |  39 +++
 osu.Game/Updater/WindowsAssociationManager.cs | 268 ++++++++++++++++++
 osu.sln.DotSettings                           |   1 +
 4 files changed, 414 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
 create mode 100644 osu.Game/Localisation/WindowsAssociationManagerStrings.cs
 create mode 100644 osu.Game/Updater/WindowsAssociationManager.cs

diff --git a/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs b/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
new file mode 100644
index 0000000000..72256860fd
--- /dev/null
+++ b/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
@@ -0,0 +1,106 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Runtime.Versioning;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Platform;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Tests.Resources;
+using osu.Game.Updater;
+
+namespace osu.Game.Tests.Visual.Updater
+{
+    [SupportedOSPlatform("windows")]
+    [Ignore("These tests modify the windows registry and open programs")]
+    public partial class TestSceneWindowsAssociationManager : OsuTestScene
+    {
+        private static readonly string exe_path = Path.ChangeExtension(typeof(TestSceneWindowsAssociationManager).Assembly.Location, ".exe");
+
+        [Resolved]
+        private GameHost host { get; set; } = null!;
+
+        private readonly WindowsAssociationManager associationManager;
+
+        public TestSceneWindowsAssociationManager()
+        {
+            Children = new Drawable[]
+            {
+                new OsuSpriteText { Text = Environment.CommandLine },
+                associationManager = new WindowsAssociationManager(exe_path, "osu.Test"),
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            if (Environment.CommandLine.Contains(".osz", StringComparison.Ordinal))
+                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkOliveGreen));
+
+            if (Environment.CommandLine.Contains("osu://", StringComparison.Ordinal))
+                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkBlue));
+
+            if (Environment.CommandLine.Contains("osump://", StringComparison.Ordinal))
+                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkRed));
+        }
+
+        [Test]
+        public void TestInstall()
+        {
+            AddStep("install", () => associationManager.InstallAssociations());
+        }
+
+        [Test]
+        public void TestOpenBeatmap()
+        {
+            string beatmapPath = null!;
+            AddStep("create temp beatmap", () => beatmapPath = TestResources.GetTestBeatmapForImport());
+            AddAssert("beatmap path ends with .osz", () => beatmapPath, () => Does.EndWith(".osz"));
+            AddStep("open beatmap", () => host.OpenFileExternally(beatmapPath));
+            AddUntilStep("wait for focus", () => host.IsActive.Value);
+            AddStep("delete temp beatmap", () => File.Delete(beatmapPath));
+        }
+
+        /// <summary>
+        /// To check that the icon is correct
+        /// </summary>
+        [Test]
+        public void TestPresentBeatmap()
+        {
+            string beatmapPath = null!;
+            AddStep("create temp beatmap", () => beatmapPath = TestResources.GetTestBeatmapForImport());
+            AddAssert("beatmap path ends with .osz", () => beatmapPath, () => Does.EndWith(".osz"));
+            AddStep("show beatmap in explorer", () => host.PresentFileExternally(beatmapPath));
+            AddUntilStep("wait for focus", () => host.IsActive.Value);
+            AddStep("delete temp beatmap", () => File.Delete(beatmapPath));
+        }
+
+        [TestCase("osu://s/1")]
+        [TestCase("osump://123")]
+        public void TestUrl(string url)
+        {
+            AddStep($"open {url}", () => Process.Start(new ProcessStartInfo(url) { UseShellExecute = true }));
+        }
+
+        [Test]
+        public void TestUninstall()
+        {
+            AddStep("uninstall", () => associationManager.UninstallAssociations());
+        }
+
+        /// <summary>
+        /// Useful when testing things out and manually changing the registry.
+        /// </summary>
+        [Test]
+        public void TestNotifyShell()
+        {
+            AddStep("notify shell of changes", () => associationManager.NotifyShellUpdate());
+        }
+    }
+}
diff --git a/osu.Game/Localisation/WindowsAssociationManagerStrings.cs b/osu.Game/Localisation/WindowsAssociationManagerStrings.cs
new file mode 100644
index 0000000000..95a6decdd6
--- /dev/null
+++ b/osu.Game/Localisation/WindowsAssociationManagerStrings.cs
@@ -0,0 +1,39 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class WindowsAssociationManagerStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.WindowsAssociationManager";
+
+        /// <summary>
+        /// "osu! Beatmap"
+        /// </summary>
+        public static LocalisableString OsuBeatmap => new TranslatableString(getKey(@"osu_beatmap"), @"osu! Beatmap");
+
+        /// <summary>
+        /// "osu! Replay"
+        /// </summary>
+        public static LocalisableString OsuReplay => new TranslatableString(getKey(@"osu_replay"), @"osu! Replay");
+
+        /// <summary>
+        /// "osu! Skin"
+        /// </summary>
+        public static LocalisableString OsuSkin => new TranslatableString(getKey(@"osu_skin"), @"osu! Skin");
+
+        /// <summary>
+        /// "osu!"
+        /// </summary>
+        public static LocalisableString OsuProtocol => new TranslatableString(getKey(@"osu_protocol"), @"osu!");
+
+        /// <summary>
+        /// "osu! Multiplayer"
+        /// </summary>
+        public static LocalisableString OsuMultiplayer => new TranslatableString(getKey(@"osu_multiplayer"), @"osu! Multiplayer");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
\ No newline at end of file
diff --git a/osu.Game/Updater/WindowsAssociationManager.cs b/osu.Game/Updater/WindowsAssociationManager.cs
new file mode 100644
index 0000000000..8949d88362
--- /dev/null
+++ b/osu.Game/Updater/WindowsAssociationManager.cs
@@ -0,0 +1,268 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Runtime.InteropServices;
+using System.Runtime.Versioning;
+using Microsoft.Win32;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Framework.Logging;
+using osu.Game.Resources.Icons;
+using osu.Game.Localisation;
+
+namespace osu.Game.Updater
+{
+    [SupportedOSPlatform("windows")]
+    public partial class WindowsAssociationManager : Component
+    {
+        public const string SOFTWARE_CLASSES = @"Software\Classes";
+
+        /// <summary>
+        /// Sub key for setting the icon.
+        /// https://learn.microsoft.com/en-us/windows/win32/com/defaulticon
+        /// </summary>
+        public const string DEFAULT_ICON = @"DefaultIcon";
+
+        /// <summary>
+        /// Sub key for setting the command line that the shell invokes.
+        /// https://learn.microsoft.com/en-us/windows/win32/com/shell
+        /// </summary>
+        public const string SHELL_OPEN_COMMAND = @"Shell\Open\Command";
+
+        private static readonly FileAssociation[] file_associations =
+        {
+            new FileAssociation(@".osz", WindowsAssociationManagerStrings.OsuBeatmap, Icons.Lazer),
+            new FileAssociation(@".olz", WindowsAssociationManagerStrings.OsuBeatmap, Icons.Lazer),
+            new FileAssociation(@".osr", WindowsAssociationManagerStrings.OsuReplay, Icons.Lazer),
+            new FileAssociation(@".osk", WindowsAssociationManagerStrings.OsuSkin, Icons.Lazer),
+        };
+
+        private static readonly UriAssociation[] uri_associations =
+        {
+            new UriAssociation(@"osu", WindowsAssociationManagerStrings.OsuProtocol, Icons.Lazer),
+            new UriAssociation(@"osump", WindowsAssociationManagerStrings.OsuMultiplayer, Icons.Lazer),
+        };
+
+        [Resolved]
+        private LocalisationManager localisation { get; set; } = null!;
+
+        private IBindable<LocalisationParameters> localisationParameters = null!;
+
+        private readonly string exePath;
+        private readonly string programIdPrefix;
+
+        /// <param name="exePath">Path to the executable to register.</param>
+        /// <param name="programIdPrefix">
+        /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
+        /// see https://learn.microsoft.com/en-us/windows/win32/com/-progid--key.
+        /// </param>
+        public WindowsAssociationManager(string exePath, string programIdPrefix)
+        {
+            this.exePath = exePath;
+            this.programIdPrefix = programIdPrefix;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            localisationParameters = localisation.CurrentParameters.GetBoundCopy();
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            localisationParameters.ValueChanged += _ => updateDescriptions();
+        }
+
+        internal void InstallAssociations()
+        {
+            try
+            {
+                using (var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, writable: true))
+                {
+                    if (classes == null)
+                        return;
+
+                    foreach (var association in file_associations)
+                        association.Install(classes, exePath, programIdPrefix);
+
+                    foreach (var association in uri_associations)
+                        association.Install(classes, exePath);
+                }
+
+                updateDescriptions();
+            }
+            catch (Exception e)
+            {
+                Logger.Log(@$"Failed to install file and URI associations: {e.Message}");
+            }
+        }
+
+        private void updateDescriptions()
+        {
+            try
+            {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null)
+                    return;
+
+                foreach (var association in file_associations)
+                {
+                    var b = localisation.GetLocalisedBindableString(association.Description);
+                    association.UpdateDescription(classes, programIdPrefix, b.Value);
+                    b.UnbindAll();
+                }
+
+                foreach (var association in uri_associations)
+                {
+                    var b = localisation.GetLocalisedBindableString(association.Description);
+                    association.UpdateDescription(classes, b.Value);
+                    b.UnbindAll();
+                }
+
+                NotifyShellUpdate();
+            }
+            catch (Exception e)
+            {
+                Logger.Log($@"Failed to update file and URI associations: {e.Message}");
+            }
+        }
+
+        internal void UninstallAssociations()
+        {
+            try
+            {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null)
+                    return;
+
+                foreach (var association in file_associations)
+                    association.Uninstall(classes, programIdPrefix);
+
+                foreach (var association in uri_associations)
+                    association.Uninstall(classes);
+
+                NotifyShellUpdate();
+            }
+            catch (Exception e)
+            {
+                Logger.Log($@"Failed to uninstall file and URI associations: {e.Message}");
+            }
+        }
+
+        internal void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
+
+        #region Native interop
+
+        [DllImport("Shell32.dll")]
+        private static extern void SHChangeNotify(EventId wEventId, Flags uFlags, IntPtr dwItem1, IntPtr dwItem2);
+
+        private enum EventId
+        {
+            /// <summary>
+            /// A file type association has changed. <see cref="Flags.SHCNF_IDLIST"/> must be specified in the uFlags parameter.
+            /// dwItem1 and dwItem2 are not used and must be <see cref="IntPtr.Zero"/>. This event should also be sent for registered protocols.
+            /// </summary>
+            SHCNE_ASSOCCHANGED = 0x08000000
+        }
+
+        private enum Flags : uint
+        {
+            SHCNF_IDLIST = 0x0000
+        }
+
+        #endregion
+
+        private record FileAssociation(string Extension, LocalisableString Description, Win32Icon Icon)
+        {
+            private string getProgramId(string prefix) => $@"{prefix}.File{Extension}";
+
+            /// <summary>
+            /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
+            /// </summary>
+            public void Install(RegistryKey classes, string exePath, string programIdPrefix)
+            {
+                string programId = getProgramId(programIdPrefix);
+
+                // register a program id for the given extension
+                using (var programKey = classes.CreateSubKey(programId))
+                {
+                    using (var defaultIconKey = programKey.CreateSubKey(DEFAULT_ICON))
+                        defaultIconKey.SetValue(null, Icon.RegistryString);
+
+                    using (var openCommandKey = programKey.CreateSubKey(SHELL_OPEN_COMMAND))
+                        openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
+                }
+
+                using (var extensionKey = classes.CreateSubKey(Extension))
+                {
+                    // set ourselves as the default program
+                    extensionKey.SetValue(null, programId);
+
+                    // add to the open with dialog
+                    // https://learn.microsoft.com/en-us/windows/win32/shell/how-to-include-an-application-on-the-open-with-dialog-box
+                    using (var openWithKey = extensionKey.CreateSubKey(@"OpenWithProgIds"))
+                        openWithKey.SetValue(programId, string.Empty);
+                }
+            }
+
+            public void UpdateDescription(RegistryKey classes, string programIdPrefix, string description)
+            {
+                using (var programKey = classes.OpenSubKey(getProgramId(programIdPrefix), true))
+                    programKey?.SetValue(null, description);
+            }
+
+            public void Uninstall(RegistryKey classes, string programIdPrefix)
+            {
+                string programId = getProgramId(programIdPrefix);
+
+                // importantly, we don't delete the default program entry because some other program could have taken it.
+
+                using (var extensionKey = classes.OpenSubKey($@"{Extension}\OpenWithProgIds", true))
+                    extensionKey?.DeleteValue(programId, throwOnMissingValue: false);
+
+                classes.DeleteSubKeyTree(programId, throwOnMissingSubKey: false);
+            }
+        }
+
+        private record UriAssociation(string Protocol, LocalisableString Description, Win32Icon Icon)
+        {
+            /// <summary>
+            /// "The <c>URL Protocol</c> string value indicates that this key declares a custom pluggable protocol handler."
+            /// See https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85).
+            /// </summary>
+            public const string URL_PROTOCOL = @"URL Protocol";
+
+            /// <summary>
+            /// Registers an URI protocol handler in accordance with https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85).
+            /// </summary>
+            public void Install(RegistryKey classes, string exePath)
+            {
+                using (var protocolKey = classes.CreateSubKey(Protocol))
+                {
+                    protocolKey.SetValue(URL_PROTOCOL, string.Empty);
+
+                    using (var defaultIconKey = protocolKey.CreateSubKey(DEFAULT_ICON))
+                        defaultIconKey.SetValue(null, Icon.RegistryString);
+
+                    using (var openCommandKey = protocolKey.CreateSubKey(SHELL_OPEN_COMMAND))
+                        openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
+                }
+            }
+
+            public void UpdateDescription(RegistryKey classes, string description)
+            {
+                using (var protocolKey = classes.OpenSubKey(Protocol, true))
+                    protocolKey?.SetValue(null, $@"URL:{description}");
+            }
+
+            public void Uninstall(RegistryKey classes)
+            {
+                classes.DeleteSubKeyTree(Protocol, throwOnMissingSubKey: false);
+            }
+        }
+    }
+}
diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 1bf8aa7b0b..e2e28c38ec 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -1005,6 +1005,7 @@ private void load()
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Migratable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Nightcore/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Omni/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=osump/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Overlined/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pausable/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pippidon/@EntryIndexedValue">True</s:Boolean>

From 03578821c0c2c9fc4b4832208e7c10751f8b28af Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 3 Feb 2024 17:04:06 +0100
Subject: [PATCH 037/930] Associate on startup

---
 osu.Desktop/OsuGameDesktop.cs                 | 7 ++++++-
 osu.Game/Updater/WindowsAssociationManager.cs | 1 +
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index a0db896f46..a048deddb3 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -134,9 +134,14 @@ namespace osu.Desktop
 
             LoadComponentAsync(new DiscordRichPresence(), Add);
 
-            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows && OperatingSystem.IsWindows())
+            {
                 LoadComponentAsync(new GameplayWinKeyBlocker(), Add);
 
+                string? executableLocation = Path.GetDirectoryName(typeof(OsuGameDesktop).Assembly.Location);
+                LoadComponentAsync(new WindowsAssociationManager(Path.Join(executableLocation, @"osu!.exe"), "osu"), Add);
+            }
+
             LoadComponentAsync(new ElevatedPrivilegesChecker(), Add);
 
             osuSchemeLinkIPCChannel = new OsuSchemeLinkIPCChannel(Host, this);
diff --git a/osu.Game/Updater/WindowsAssociationManager.cs b/osu.Game/Updater/WindowsAssociationManager.cs
index 8949d88362..104406c81b 100644
--- a/osu.Game/Updater/WindowsAssociationManager.cs
+++ b/osu.Game/Updater/WindowsAssociationManager.cs
@@ -69,6 +69,7 @@ namespace osu.Game.Updater
         private void load()
         {
             localisationParameters = localisation.CurrentParameters.GetBoundCopy();
+            InstallAssociations();
         }
 
         protected override void LoadComplete()

From 2bac09ee00d1e809e38aca97350e4853b2ebf09f Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 3 Feb 2024 17:23:59 +0100
Subject: [PATCH 038/930] Only associate on a deployed build

Helps to reduce clutter when developing
---
 osu.Desktop/OsuGameDesktop.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index a048deddb3..c5175fd549 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -134,10 +134,11 @@ namespace osu.Desktop
 
             LoadComponentAsync(new DiscordRichPresence(), Add);
 
-            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows && OperatingSystem.IsWindows())
-            {
+            if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
                 LoadComponentAsync(new GameplayWinKeyBlocker(), Add);
 
+            if (OperatingSystem.IsWindows() && IsDeployedBuild)
+            {
                 string? executableLocation = Path.GetDirectoryName(typeof(OsuGameDesktop).Assembly.Location);
                 LoadComponentAsync(new WindowsAssociationManager(Path.Join(executableLocation, @"osu!.exe"), "osu"), Add);
             }

From cdcf5bddda5c15c518a810af6b68b06ab214ee52 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sat, 3 Feb 2024 17:56:14 +0100
Subject: [PATCH 039/930] Uninstall associations when uninstalling from
 squirrel

---
 osu.Desktop/Program.cs                                    | 2 ++
 .../Visual/Updater/TestSceneWindowsAssociationManager.cs  | 2 +-
 osu.Game/Updater/WindowsAssociationManager.cs             | 8 +++++---
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index a7453dc0e0..c9ce5ebf1b 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -12,6 +12,7 @@ using osu.Framework.Platform;
 using osu.Game;
 using osu.Game.IPC;
 using osu.Game.Tournament;
+using osu.Game.Updater;
 using SDL2;
 using Squirrel;
 
@@ -180,6 +181,7 @@ namespace osu.Desktop
             {
                 tools.RemoveShortcutForThisExe();
                 tools.RemoveUninstallerRegistryEntry();
+                WindowsAssociationManager.UninstallAssociations(@"osu");
             }, onEveryRun: (_, _, _) =>
             {
                 // While setting the `ProcessAppUserModelId` fixes duplicate icons/shortcuts on the taskbar, it currently
diff --git a/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs b/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
index 72256860fd..f3eb468334 100644
--- a/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
+++ b/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Visual.Updater
         [Test]
         public void TestNotifyShell()
         {
-            AddStep("notify shell of changes", () => associationManager.NotifyShellUpdate());
+            AddStep("notify shell of changes", WindowsAssociationManager.NotifyShellUpdate);
         }
     }
 }
diff --git a/osu.Game/Updater/WindowsAssociationManager.cs b/osu.Game/Updater/WindowsAssociationManager.cs
index 104406c81b..bb0e37a2f4 100644
--- a/osu.Game/Updater/WindowsAssociationManager.cs
+++ b/osu.Game/Updater/WindowsAssociationManager.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Updater
             localisationParameters.ValueChanged += _ => updateDescriptions();
         }
 
-        internal void InstallAssociations()
+        public void InstallAssociations()
         {
             try
             {
@@ -132,7 +132,9 @@ namespace osu.Game.Updater
             }
         }
 
-        internal void UninstallAssociations()
+        public void UninstallAssociations() => UninstallAssociations(programIdPrefix);
+
+        public static void UninstallAssociations(string programIdPrefix)
         {
             try
             {
@@ -154,7 +156,7 @@ namespace osu.Game.Updater
             }
         }
 
-        internal void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
+        internal static void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
 
         #region Native interop
 

From 2f4211249e0b3863d6058252ed55dc0e4f9d6c7f Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 13:12:03 +0100
Subject: [PATCH 040/930] Use cleaner way to specify .exe path

---
 osu.Desktop/OsuGameDesktop.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index c5175fd549..a6d9ff1653 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -138,10 +138,7 @@ namespace osu.Desktop
                 LoadComponentAsync(new GameplayWinKeyBlocker(), Add);
 
             if (OperatingSystem.IsWindows() && IsDeployedBuild)
-            {
-                string? executableLocation = Path.GetDirectoryName(typeof(OsuGameDesktop).Assembly.Location);
-                LoadComponentAsync(new WindowsAssociationManager(Path.Join(executableLocation, @"osu!.exe"), "osu"), Add);
-            }
+                LoadComponentAsync(new WindowsAssociationManager(Path.ChangeExtension(typeof(OsuGameDesktop).Assembly.Location, ".exe"), "osu"), Add);
 
             LoadComponentAsync(new ElevatedPrivilegesChecker(), Add);
 

From 01efd1b353f556795f5d30eb4fe6723b7fcd6200 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 13:34:03 +0100
Subject: [PATCH 041/930] Move `WindowsAssociationManager` to `osu.Desktop`

---
 osu.Desktop/Program.cs                                          | 2 +-
 .../Windows}/WindowsAssociationManager.cs                       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)
 rename {osu.Game/Updater => osu.Desktop/Windows}/WindowsAssociationManager.cs (99%)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index c9ce5ebf1b..edbf39a30a 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -5,6 +5,7 @@ using System;
 using System.IO;
 using System.Runtime.Versioning;
 using osu.Desktop.LegacyIpc;
+using osu.Desktop.Windows;
 using osu.Framework;
 using osu.Framework.Development;
 using osu.Framework.Logging;
@@ -12,7 +13,6 @@ using osu.Framework.Platform;
 using osu.Game;
 using osu.Game.IPC;
 using osu.Game.Tournament;
-using osu.Game.Updater;
 using SDL2;
 using Squirrel;
 
diff --git a/osu.Game/Updater/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
similarity index 99%
rename from osu.Game/Updater/WindowsAssociationManager.cs
rename to osu.Desktop/Windows/WindowsAssociationManager.cs
index bb0e37a2f4..038788f990 100644
--- a/osu.Game/Updater/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -13,7 +13,7 @@ using osu.Framework.Logging;
 using osu.Game.Resources.Icons;
 using osu.Game.Localisation;
 
-namespace osu.Game.Updater
+namespace osu.Desktop.Windows
 {
     [SupportedOSPlatform("windows")]
     public partial class WindowsAssociationManager : Component

From 7789cc01eb31733fa76147adecf73db186c12759 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 14:03:16 +0100
Subject: [PATCH 042/930] Copy .ico files when publishing

These icons should appear in end-user installation folder.
---
 osu.Desktop/Windows/Icons.cs                     | 10 ++++++++++
 osu.Desktop/Windows/Win32Icon.cs                 | 16 ++++++++++++++++
 osu.Desktop/Windows/WindowsAssociationManager.cs |  5 ++---
 osu.Desktop/osu.Desktop.csproj                   |  3 +++
 4 files changed, 31 insertions(+), 3 deletions(-)
 create mode 100644 osu.Desktop/Windows/Icons.cs
 create mode 100644 osu.Desktop/Windows/Win32Icon.cs

diff --git a/osu.Desktop/Windows/Icons.cs b/osu.Desktop/Windows/Icons.cs
new file mode 100644
index 0000000000..cc60f92810
--- /dev/null
+++ b/osu.Desktop/Windows/Icons.cs
@@ -0,0 +1,10 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+namespace osu.Desktop.Windows
+{
+    public static class Icons
+    {
+        public static Win32Icon Lazer => new Win32Icon(@"lazer.ico");
+    }
+}
diff --git a/osu.Desktop/Windows/Win32Icon.cs b/osu.Desktop/Windows/Win32Icon.cs
new file mode 100644
index 0000000000..9544846c55
--- /dev/null
+++ b/osu.Desktop/Windows/Win32Icon.cs
@@ -0,0 +1,16 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+namespace osu.Desktop.Windows
+{
+    public record Win32Icon
+    {
+        public readonly string Path;
+
+        internal Win32Icon(string name)
+        {
+            string dir = System.IO.Path.GetDirectoryName(typeof(Win32Icon).Assembly.Location)!;
+            Path = System.IO.Path.Join(dir, name);
+        }
+    }
+}
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 038788f990..a5f977d15d 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -10,7 +10,6 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
-using osu.Game.Resources.Icons;
 using osu.Game.Localisation;
 
 namespace osu.Desktop.Windows
@@ -194,7 +193,7 @@ namespace osu.Desktop.Windows
                 using (var programKey = classes.CreateSubKey(programId))
                 {
                     using (var defaultIconKey = programKey.CreateSubKey(DEFAULT_ICON))
-                        defaultIconKey.SetValue(null, Icon.RegistryString);
+                        defaultIconKey.SetValue(null, Icon.Path);
 
                     using (var openCommandKey = programKey.CreateSubKey(SHELL_OPEN_COMMAND))
                         openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
@@ -249,7 +248,7 @@ namespace osu.Desktop.Windows
                     protocolKey.SetValue(URL_PROTOCOL, string.Empty);
 
                     using (var defaultIconKey = protocolKey.CreateSubKey(DEFAULT_ICON))
-                        defaultIconKey.SetValue(null, Icon.RegistryString);
+                        defaultIconKey.SetValue(null, Icon.Path);
 
                     using (var openCommandKey = protocolKey.CreateSubKey(SHELL_OPEN_COMMAND))
                         openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index d6a11fa924..c6a95c1623 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -31,4 +31,7 @@
   <ItemGroup Label="Resources">
     <EmbeddedResource Include="lazer.ico" />
   </ItemGroup>
+  <ItemGroup Label="Windows Icons" Condition="$(RuntimeIdentifier.StartsWith('win'))">
+    <Content Include="*.ico" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
+  </ItemGroup>
 </Project>

From 4ec9d26657167bc7310984f093837ef183cef24f Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 14:16:35 +0100
Subject: [PATCH 043/930] Inline constants

---
 osu.Desktop/OsuGameDesktop.cs                 |  2 +-
 .../Windows/WindowsAssociationManager.cs      | 31 ++++++++-----------
 2 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index a6d9ff1653..2e1b34fb38 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -138,7 +138,7 @@ namespace osu.Desktop
                 LoadComponentAsync(new GameplayWinKeyBlocker(), Add);
 
             if (OperatingSystem.IsWindows() && IsDeployedBuild)
-                LoadComponentAsync(new WindowsAssociationManager(Path.ChangeExtension(typeof(OsuGameDesktop).Assembly.Location, ".exe"), "osu"), Add);
+                LoadComponentAsync(new WindowsAssociationManager(), Add);
 
             LoadComponentAsync(new ElevatedPrivilegesChecker(), Add);
 
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index a5f977d15d..7131067224 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.IO;
 using System.Runtime.InteropServices;
 using System.Runtime.Versioning;
 using Microsoft.Win32;
@@ -31,6 +32,14 @@ namespace osu.Desktop.Windows
         /// </summary>
         public const string SHELL_OPEN_COMMAND = @"Shell\Open\Command";
 
+        public static readonly string EXE_PATH = Path.ChangeExtension(typeof(WindowsAssociationManager).Assembly.Location, ".exe");
+
+        /// <summary>
+        /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
+        /// see https://learn.microsoft.com/en-us/windows/win32/com/-progid--key.
+        /// </summary>
+        public const string PROGRAM_ID_PREFIX = "osu";
+
         private static readonly FileAssociation[] file_associations =
         {
             new FileAssociation(@".osz", WindowsAssociationManagerStrings.OsuBeatmap, Icons.Lazer),
@@ -50,20 +59,6 @@ namespace osu.Desktop.Windows
 
         private IBindable<LocalisationParameters> localisationParameters = null!;
 
-        private readonly string exePath;
-        private readonly string programIdPrefix;
-
-        /// <param name="exePath">Path to the executable to register.</param>
-        /// <param name="programIdPrefix">
-        /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
-        /// see https://learn.microsoft.com/en-us/windows/win32/com/-progid--key.
-        /// </param>
-        public WindowsAssociationManager(string exePath, string programIdPrefix)
-        {
-            this.exePath = exePath;
-            this.programIdPrefix = programIdPrefix;
-        }
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -87,10 +82,10 @@ namespace osu.Desktop.Windows
                         return;
 
                     foreach (var association in file_associations)
-                        association.Install(classes, exePath, programIdPrefix);
+                        association.Install(classes, EXE_PATH, PROGRAM_ID_PREFIX);
 
                     foreach (var association in uri_associations)
-                        association.Install(classes, exePath);
+                        association.Install(classes, EXE_PATH);
                 }
 
                 updateDescriptions();
@@ -112,7 +107,7 @@ namespace osu.Desktop.Windows
                 foreach (var association in file_associations)
                 {
                     var b = localisation.GetLocalisedBindableString(association.Description);
-                    association.UpdateDescription(classes, programIdPrefix, b.Value);
+                    association.UpdateDescription(classes, PROGRAM_ID_PREFIX, b.Value);
                     b.UnbindAll();
                 }
 
@@ -131,7 +126,7 @@ namespace osu.Desktop.Windows
             }
         }
 
-        public void UninstallAssociations() => UninstallAssociations(programIdPrefix);
+        public void UninstallAssociations() => UninstallAssociations(PROGRAM_ID_PREFIX);
 
         public static void UninstallAssociations(string programIdPrefix)
         {

From 0168ade2e13f200f475081d54363b8b9ee835687 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 14:19:22 +0100
Subject: [PATCH 044/930] Remove tests

Can be tested with
```
dotnet publish -f net6.0 -r win-x64 osu.Desktop -o publish -c Debug
publish\osu!
```
---
 .../TestSceneWindowsAssociationManager.cs     | 106 ------------------
 1 file changed, 106 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs

diff --git a/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs b/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
deleted file mode 100644
index f3eb468334..0000000000
--- a/osu.Game.Tests/Visual/Updater/TestSceneWindowsAssociationManager.cs
+++ /dev/null
@@ -1,106 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-using System.Diagnostics;
-using System.IO;
-using System.Runtime.Versioning;
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
-using osu.Framework.Platform;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Tests.Resources;
-using osu.Game.Updater;
-
-namespace osu.Game.Tests.Visual.Updater
-{
-    [SupportedOSPlatform("windows")]
-    [Ignore("These tests modify the windows registry and open programs")]
-    public partial class TestSceneWindowsAssociationManager : OsuTestScene
-    {
-        private static readonly string exe_path = Path.ChangeExtension(typeof(TestSceneWindowsAssociationManager).Assembly.Location, ".exe");
-
-        [Resolved]
-        private GameHost host { get; set; } = null!;
-
-        private readonly WindowsAssociationManager associationManager;
-
-        public TestSceneWindowsAssociationManager()
-        {
-            Children = new Drawable[]
-            {
-                new OsuSpriteText { Text = Environment.CommandLine },
-                associationManager = new WindowsAssociationManager(exe_path, "osu.Test"),
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            if (Environment.CommandLine.Contains(".osz", StringComparison.Ordinal))
-                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkOliveGreen));
-
-            if (Environment.CommandLine.Contains("osu://", StringComparison.Ordinal))
-                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkBlue));
-
-            if (Environment.CommandLine.Contains("osump://", StringComparison.Ordinal))
-                ChangeBackgroundColour(ColourInfo.SingleColour(Colour4.DarkRed));
-        }
-
-        [Test]
-        public void TestInstall()
-        {
-            AddStep("install", () => associationManager.InstallAssociations());
-        }
-
-        [Test]
-        public void TestOpenBeatmap()
-        {
-            string beatmapPath = null!;
-            AddStep("create temp beatmap", () => beatmapPath = TestResources.GetTestBeatmapForImport());
-            AddAssert("beatmap path ends with .osz", () => beatmapPath, () => Does.EndWith(".osz"));
-            AddStep("open beatmap", () => host.OpenFileExternally(beatmapPath));
-            AddUntilStep("wait for focus", () => host.IsActive.Value);
-            AddStep("delete temp beatmap", () => File.Delete(beatmapPath));
-        }
-
-        /// <summary>
-        /// To check that the icon is correct
-        /// </summary>
-        [Test]
-        public void TestPresentBeatmap()
-        {
-            string beatmapPath = null!;
-            AddStep("create temp beatmap", () => beatmapPath = TestResources.GetTestBeatmapForImport());
-            AddAssert("beatmap path ends with .osz", () => beatmapPath, () => Does.EndWith(".osz"));
-            AddStep("show beatmap in explorer", () => host.PresentFileExternally(beatmapPath));
-            AddUntilStep("wait for focus", () => host.IsActive.Value);
-            AddStep("delete temp beatmap", () => File.Delete(beatmapPath));
-        }
-
-        [TestCase("osu://s/1")]
-        [TestCase("osump://123")]
-        public void TestUrl(string url)
-        {
-            AddStep($"open {url}", () => Process.Start(new ProcessStartInfo(url) { UseShellExecute = true }));
-        }
-
-        [Test]
-        public void TestUninstall()
-        {
-            AddStep("uninstall", () => associationManager.UninstallAssociations());
-        }
-
-        /// <summary>
-        /// Useful when testing things out and manually changing the registry.
-        /// </summary>
-        [Test]
-        public void TestNotifyShell()
-        {
-            AddStep("notify shell of changes", WindowsAssociationManager.NotifyShellUpdate);
-        }
-    }
-}

From 17033e09f679f1f2c7800bdb552545967c42fa18 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 5 Feb 2024 14:29:17 +0100
Subject: [PATCH 045/930] Change to class to satisfy CFS hopefully

---
 osu.Desktop/Windows/Win32Icon.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/Windows/Win32Icon.cs b/osu.Desktop/Windows/Win32Icon.cs
index 9544846c55..401e7a2be3 100644
--- a/osu.Desktop/Windows/Win32Icon.cs
+++ b/osu.Desktop/Windows/Win32Icon.cs
@@ -3,7 +3,7 @@
 
 namespace osu.Desktop.Windows
 {
-    public record Win32Icon
+    public class Win32Icon
     {
         public readonly string Path;
 

From 5850d6a57807aee271aae79532964bc85d345e1a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 6 Feb 2024 20:06:51 +0900
Subject: [PATCH 046/930] Show near-misses on the results-screen heatmap

---
 osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs   |  7 +-
 .../Objects/Drawables/DrawableHitCircle.cs    | 74 +++++++++++--------
 .../Statistics/AccuracyHeatmap.cs             | 60 +++++++++------
 3 files changed, 81 insertions(+), 60 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
index 10d7af5e58..0e3f972d41 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModClassic.cs
@@ -95,12 +95,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         /// </summary>
         private static void blockInputToObjectsUnderSliderHead(DrawableSliderHead slider)
         {
-            var oldHitAction = slider.HitArea.Hit;
-            slider.HitArea.Hit = () =>
-            {
-                oldHitAction?.Invoke();
-                return !slider.DrawableSlider.AllJudged;
-            };
+            slider.HitArea.CanBeHit = () => !slider.DrawableSlider.AllJudged;
         }
 
         private void applyEarlyFading(DrawableHitCircle circle)
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index b1c9bef6c4..3727e78d01 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
@@ -10,7 +10,6 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.Containers;
@@ -43,7 +42,6 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         Drawable IHasApproachCircle.ApproachCircle => ApproachCircle;
 
         private Container scaleContainer;
-        private InputManager inputManager;
 
         public DrawableHitCircle()
             : this(null)
@@ -73,14 +71,8 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                     {
                         HitArea = new HitReceptor
                         {
-                            Hit = () =>
-                            {
-                                if (AllJudged)
-                                    return false;
-
-                                UpdateResult(true);
-                                return true;
-                            },
+                            CanBeHit = () => !AllJudged,
+                            Hit = () => UpdateResult(true)
                         },
                         shakeContainer = new ShakeContainer
                         {
@@ -114,13 +106,6 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             ScaleBindable.BindValueChanged(scale => scaleContainer.Scale = new Vector2(scale.NewValue));
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            inputManager = GetContainingInputManager();
-        }
-
         public override double LifetimeStart
         {
             get => base.LifetimeStart;
@@ -155,7 +140,15 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             if (!userTriggered)
             {
                 if (!HitObject.HitWindows.CanBeHit(timeOffset))
-                    ApplyMinResult();
+                {
+                    ApplyResult((r, position) =>
+                    {
+                        var circleResult = (OsuHitCircleJudgementResult)r;
+
+                        circleResult.Type = r.Judgement.MinResult;
+                        circleResult.CursorPositionAtHit = position;
+                    }, computeHitPosition());
+                }
 
                 return;
             }
@@ -169,22 +162,21 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             if (result == HitResult.None || clickAction != ClickAction.Hit)
                 return;
 
-            Vector2? hitPosition = null;
-
-            // Todo: This should also consider misses, but they're a little more interesting to handle, since we don't necessarily know the position at the time of a miss.
-            if (result.IsHit())
-            {
-                var localMousePosition = ToLocalSpace(inputManager.CurrentState.Mouse.Position);
-                hitPosition = HitObject.StackedPosition + (localMousePosition - DrawSize / 2);
-            }
-
             ApplyResult<(HitResult result, Vector2? position)>((r, state) =>
             {
                 var circleResult = (OsuHitCircleJudgementResult)r;
 
                 circleResult.Type = state.result;
                 circleResult.CursorPositionAtHit = state.position;
-            }, (result, hitPosition));
+            }, (result, computeHitPosition()));
+        }
+
+        private Vector2? computeHitPosition()
+        {
+            if (HitArea.ClosestPressPosition is Vector2 screenSpaceHitPosition)
+                return HitObject.StackedPosition + (ToLocalSpace(screenSpaceHitPosition) - DrawSize / 2);
+
+            return null;
         }
 
         /// <summary>
@@ -227,6 +219,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                     break;
 
                 case ArmedState.Idle:
+                    HitArea.ClosestPressPosition = null;
                     HitArea.HitAction = null;
                     break;
 
@@ -247,9 +240,11 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             // IsHovered is used
             public override bool HandlePositionalInput => true;
 
-            public Func<bool> Hit;
+            public Func<bool> CanBeHit;
+            public Action Hit;
 
             public OsuAction? HitAction;
+            public Vector2? ClosestPressPosition;
 
             public HitReceptor()
             {
@@ -264,12 +259,31 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
             {
+                if (!(CanBeHit?.Invoke() ?? false))
+                    return false;
+
                 switch (e.Action)
                 {
                     case OsuAction.LeftButton:
                     case OsuAction.RightButton:
-                        if (IsHovered && (Hit?.Invoke() ?? false))
+                        // Only update closest press position while the object hasn't been hit yet.
+                        if (HitAction == null)
                         {
+                            if (ClosestPressPosition is Vector2 curClosest)
+                            {
+                                float oldDist = Vector2.DistanceSquared(curClosest, ScreenSpaceDrawQuad.Centre);
+                                float newDist = Vector2.DistanceSquared(e.ScreenSpaceMousePosition, ScreenSpaceDrawQuad.Centre);
+
+                                if (newDist < oldDist)
+                                    ClosestPressPosition = e.ScreenSpaceMousePosition;
+                            }
+                            else
+                                ClosestPressPosition = e.ScreenSpaceMousePosition;
+                        }
+
+                        if (IsHovered)
+                        {
+                            Hit?.Invoke();
                             HitAction ??= e.Action;
                             return true;
                         }
diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index f9d4a3b325..813f3b2e7a 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -197,7 +197,9 @@ namespace osu.Game.Rulesets.Osu.Statistics
 
                     var point = new HitPoint(pointType, this)
                     {
-                        BaseColour = pointType == HitPointType.Hit ? new Color4(102, 255, 204, 255) : new Color4(255, 102, 102, 255)
+                        BaseColour = pointType == HitPointType.Hit
+                            ? new Color4(102, 255, 204, 255)
+                            : new Color4(255, 102, 102, 255)
                     };
 
                     points[r][c] = point;
@@ -250,12 +252,15 @@ namespace osu.Game.Rulesets.Osu.Statistics
             var rotatedCoordinate = -1 * new Vector2((float)Math.Cos(rotatedAngle), (float)Math.Sin(rotatedAngle));
 
             Vector2 localCentre = new Vector2(points_per_dimension - 1) / 2;
-            float localRadius = localCentre.X * inner_portion * normalisedDistance; // The radius inside the inner portion which of the heatmap which the closest point lies.
+            float localRadius = localCentre.X * inner_portion * normalisedDistance;
             Vector2 localPoint = localCentre + localRadius * rotatedCoordinate;
 
             // Find the most relevant hit point.
-            int r = Math.Clamp((int)Math.Round(localPoint.Y), 0, points_per_dimension - 1);
-            int c = Math.Clamp((int)Math.Round(localPoint.X), 0, points_per_dimension - 1);
+            int r = (int)Math.Round(localPoint.Y);
+            int c = (int)Math.Round(localPoint.X);
+
+            if (r < 0 || r >= points_per_dimension || c < 0 || c >= points_per_dimension)
+                return;
 
             PeakValue = Math.Max(PeakValue, ((HitPoint)pointGrid.Content[r][c]).Increment());
 
@@ -298,28 +303,35 @@ namespace osu.Game.Rulesets.Osu.Statistics
             {
                 base.Update();
 
-                // the point at which alpha is saturated and we begin to adjust colour lightness.
-                const float lighten_cutoff = 0.95f;
-
-                // the amount of lightness to attribute regardless of relative value to peak point.
-                const float non_relative_portion = 0.2f;
-
-                float amount = 0;
-
-                // give some amount of alpha regardless of relative count
-                amount += non_relative_portion * Math.Min(1, count / 10f);
-
-                // add relative portion
-                amount += (1 - non_relative_portion) * (count / heatmap.PeakValue);
-
-                // apply easing
-                amount = (float)Interpolation.ApplyEasing(Easing.OutQuint, Math.Min(1, amount));
-
-                Debug.Assert(amount <= 1);
-
-                Alpha = Math.Min(amount / lighten_cutoff, 1);
                 if (pointType == HitPointType.Hit)
+                {
+                    // the point at which alpha is saturated and we begin to adjust colour lightness.
+                    const float lighten_cutoff = 0.95f;
+
+                    // the amount of lightness to attribute regardless of relative value to peak point.
+                    const float non_relative_portion = 0.2f;
+
+                    float amount = 0;
+
+                    // give some amount of alpha regardless of relative count
+                    amount += non_relative_portion * Math.Min(1, count / 10f);
+
+                    // add relative portion
+                    amount += (1 - non_relative_portion) * (count / heatmap.PeakValue);
+
+                    // apply easing
+                    amount = (float)Interpolation.ApplyEasing(Easing.OutQuint, Math.Min(1, amount));
+
+                    Debug.Assert(amount <= 1);
+
+                    Alpha = Math.Min(amount / lighten_cutoff, 1);
                     Colour = BaseColour.Lighten(Math.Max(0, amount - lighten_cutoff));
+                }
+                else
+                {
+                    Alpha = 0.8f;
+                    Colour = BaseColour;
+                }
             }
         }
 

From 99d716f8fc62aaaf09ca65fa7da6f8f876bd6b8a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 6 Feb 2024 22:23:30 +0900
Subject: [PATCH 047/930] Make miss points into crosses

---
 .../Statistics/AccuracyHeatmap.cs             | 123 ++++++++++--------
 1 file changed, 68 insertions(+), 55 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index 813f3b2e7a..2120b929a7 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -9,6 +9,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -191,18 +192,22 @@ namespace osu.Game.Rulesets.Osu.Statistics
 
                 for (int c = 0; c < points_per_dimension; c++)
                 {
-                    HitPointType pointType = Vector2.Distance(new Vector2(c + 0.5f, r + 0.5f), centre) <= innerRadius
-                        ? HitPointType.Hit
-                        : HitPointType.Miss;
+                    bool isHit = Vector2.Distance(new Vector2(c + 0.5f, r + 0.5f), centre) <= innerRadius;
 
-                    var point = new HitPoint(pointType, this)
+                    if (isHit)
                     {
-                        BaseColour = pointType == HitPointType.Hit
-                            ? new Color4(102, 255, 204, 255)
-                            : new Color4(255, 102, 102, 255)
-                    };
-
-                    points[r][c] = point;
+                        points[r][c] = new HitPoint(this)
+                        {
+                            BaseColour = new Color4(102, 255, 204, 255)
+                        };
+                    }
+                    else
+                    {
+                        points[r][c] = new MissPoint
+                        {
+                            BaseColour = new Color4(255, 102, 102, 255)
+                        };
+                    }
                 }
             }
 
@@ -262,33 +267,21 @@ namespace osu.Game.Rulesets.Osu.Statistics
             if (r < 0 || r >= points_per_dimension || c < 0 || c >= points_per_dimension)
                 return;
 
-            PeakValue = Math.Max(PeakValue, ((HitPoint)pointGrid.Content[r][c]).Increment());
+            PeakValue = Math.Max(PeakValue, ((GridPoint)pointGrid.Content[r][c]).Increment());
 
             bufferedGrid.ForceRedraw();
         }
 
-        private partial class HitPoint : Circle
+        private abstract partial class GridPoint : CompositeDrawable
         {
             /// <summary>
             /// The base colour which will be lightened/darkened depending on the value of this <see cref="HitPoint"/>.
             /// </summary>
             public Color4 BaseColour;
 
-            private readonly HitPointType pointType;
-            private readonly AccuracyHeatmap heatmap;
+            public override bool IsPresent => Count > 0;
 
-            public override bool IsPresent => count > 0;
-
-            public HitPoint(HitPointType pointType, AccuracyHeatmap heatmap)
-            {
-                this.pointType = pointType;
-                this.heatmap = heatmap;
-
-                RelativeSizeAxes = Axes.Both;
-                Alpha = 1;
-            }
-
-            private int count;
+            protected int Count { get; private set; }
 
             /// <summary>
             /// Increment the value of this point by one.
@@ -296,49 +289,69 @@ namespace osu.Game.Rulesets.Osu.Statistics
             /// <returns>The value after incrementing.</returns>
             public int Increment()
             {
-                return ++count;
+                return ++Count;
+            }
+        }
+
+        private partial class MissPoint : GridPoint
+        {
+            public MissPoint()
+            {
+                RelativeSizeAxes = Axes.Both;
+
+                InternalChild = new SpriteIcon
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Icon = FontAwesome.Solid.Times
+                };
+            }
+
+            protected override void Update()
+            {
+                Alpha = 0.8f;
+                Colour = BaseColour;
+            }
+        }
+
+        private partial class HitPoint : GridPoint
+        {
+            private readonly AccuracyHeatmap heatmap;
+
+            public HitPoint(AccuracyHeatmap heatmap)
+            {
+                this.heatmap = heatmap;
+
+                RelativeSizeAxes = Axes.Both;
+
+                InternalChild = new Circle { RelativeSizeAxes = Axes.Both };
             }
 
             protected override void Update()
             {
                 base.Update();
 
-                if (pointType == HitPointType.Hit)
-                {
-                    // the point at which alpha is saturated and we begin to adjust colour lightness.
-                    const float lighten_cutoff = 0.95f;
+                // the point at which alpha is saturated and we begin to adjust colour lightness.
+                const float lighten_cutoff = 0.95f;
 
-                    // the amount of lightness to attribute regardless of relative value to peak point.
-                    const float non_relative_portion = 0.2f;
+                // the amount of lightness to attribute regardless of relative value to peak point.
+                const float non_relative_portion = 0.2f;
 
-                    float amount = 0;
+                float amount = 0;
 
-                    // give some amount of alpha regardless of relative count
-                    amount += non_relative_portion * Math.Min(1, count / 10f);
+                // give some amount of alpha regardless of relative count
+                amount += non_relative_portion * Math.Min(1, Count / 10f);
 
-                    // add relative portion
-                    amount += (1 - non_relative_portion) * (count / heatmap.PeakValue);
+                // add relative portion
+                amount += (1 - non_relative_portion) * (Count / heatmap.PeakValue);
 
-                    // apply easing
-                    amount = (float)Interpolation.ApplyEasing(Easing.OutQuint, Math.Min(1, amount));
+                // apply easing
+                amount = (float)Interpolation.ApplyEasing(Easing.OutQuint, Math.Min(1, amount));
 
-                    Debug.Assert(amount <= 1);
+                Debug.Assert(amount <= 1);
 
-                    Alpha = Math.Min(amount / lighten_cutoff, 1);
-                    Colour = BaseColour.Lighten(Math.Max(0, amount - lighten_cutoff));
-                }
-                else
-                {
-                    Alpha = 0.8f;
-                    Colour = BaseColour;
-                }
+                Alpha = Math.Min(amount / lighten_cutoff, 1);
+                Colour = BaseColour.Lighten(Math.Max(0, amount - lighten_cutoff));
             }
         }
-
-        private enum HitPointType
-        {
-            Hit,
-            Miss
-        }
     }
 }

From 44b1515cc5395486963615d238f2f77c16b5888c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:28:40 +0900
Subject: [PATCH 048/930] Remove LangVersion redefintions

---
 osu.Game.Rulesets.Osu/osu.Game.Rulesets.Osu.csproj | 1 -
 osu.Game/osu.Game.csproj                           | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/osu.Game.Rulesets.Osu.csproj b/osu.Game.Rulesets.Osu/osu.Game.Rulesets.Osu.csproj
index 518ab362ca..7817d55f57 100644
--- a/osu.Game.Rulesets.Osu/osu.Game.Rulesets.Osu.csproj
+++ b/osu.Game.Rulesets.Osu/osu.Game.Rulesets.Osu.csproj
@@ -4,7 +4,6 @@
     <OutputType>Library</OutputType>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
     <Description>click the circles. to the beat.</Description>
-    <LangVersion>10</LangVersion>
   </PropertyGroup>
 
   <PropertyGroup Label="Nuget">
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 935b759e4d..9bcdebc347 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -3,7 +3,6 @@
     <TargetFramework>net8.0</TargetFramework>
     <OutputType>Library</OutputType>
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
-    <LangVersion>10</LangVersion>
   </PropertyGroup>
   <PropertyGroup Label="Nuget">
     <Title>osu!</Title>

From 9b8f2064867472009e3c5c621c1fbf5823ad7592 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:38:07 +0900
Subject: [PATCH 049/930] Enable NRT for DrawableHitCircle to clean up

---
 .../Objects/Drawables/DrawableHitCircle.cs    | 46 +++++++++----------
 1 file changed, 22 insertions(+), 24 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index 3727e78d01..b950ef4bbb 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
@@ -1,12 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -27,34 +24,30 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 {
     public partial class DrawableHitCircle : DrawableOsuHitObject, IHasApproachCircle
     {
-        public OsuAction? HitAction => HitArea?.HitAction;
+        public OsuAction? HitAction => HitArea.HitAction;
         protected virtual OsuSkinComponents CirclePieceComponent => OsuSkinComponents.HitCircle;
 
-        public SkinnableDrawable ApproachCircle { get; private set; }
-        public HitReceptor HitArea { get; private set; }
-        public SkinnableDrawable CirclePiece { get; private set; }
+        public SkinnableDrawable ApproachCircle { get; private set; } = null!;
+        public HitReceptor HitArea { get; private set; } = null!;
+        public SkinnableDrawable CirclePiece { get; private set; } = null!;
 
-        protected override IEnumerable<Drawable> DimmablePieces => new[]
-        {
-            CirclePiece,
-        };
+        protected override IEnumerable<Drawable> DimmablePieces => new[] { CirclePiece };
 
         Drawable IHasApproachCircle.ApproachCircle => ApproachCircle;
 
-        private Container scaleContainer;
+        private Container scaleContainer = null!;
+        private ShakeContainer shakeContainer = null!;
 
         public DrawableHitCircle()
             : this(null)
         {
         }
 
-        public DrawableHitCircle([CanBeNull] HitCircle h = null)
+        public DrawableHitCircle(HitCircle? h = null)
             : base(h)
         {
         }
 
-        private ShakeContainer shakeContainer;
-
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -219,8 +212,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                     break;
 
                 case ArmedState.Idle:
-                    HitArea.ClosestPressPosition = null;
-                    HitArea.HitAction = null;
+                    HitArea.Reset();
                     break;
 
                 case ArmedState.Miss:
@@ -240,11 +232,11 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             // IsHovered is used
             public override bool HandlePositionalInput => true;
 
-            public Func<bool> CanBeHit;
-            public Action Hit;
+            public required Func<bool> CanBeHit { get; set; }
+            public required Action Hit { get; set; }
 
-            public OsuAction? HitAction;
-            public Vector2? ClosestPressPosition;
+            public OsuAction? HitAction { get; private set; }
+            public Vector2? ClosestPressPosition { get; private set; }
 
             public HitReceptor()
             {
@@ -259,7 +251,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
             {
-                if (!(CanBeHit?.Invoke() ?? false))
+                if (CanBeHit())
                     return false;
 
                 switch (e.Action)
@@ -283,7 +275,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
                         if (IsHovered)
                         {
-                            Hit?.Invoke();
+                            Hit();
                             HitAction ??= e.Action;
                             return true;
                         }
@@ -297,13 +289,19 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             public void OnReleased(KeyBindingReleaseEvent<OsuAction> e)
             {
             }
+
+            public void Reset()
+            {
+                HitAction = null;
+                ClosestPressPosition = null;
+            }
         }
 
         private partial class ProxyableSkinnableDrawable : SkinnableDrawable
         {
             public override bool RemoveWhenNotAlive => false;
 
-            public ProxyableSkinnableDrawable(ISkinComponentLookup lookup, Func<ISkinComponentLookup, Drawable> defaultImplementation = null, ConfineMode confineMode = ConfineMode.NoScaling)
+            public ProxyableSkinnableDrawable(ISkinComponentLookup lookup, Func<ISkinComponentLookup, Drawable>? defaultImplementation = null, ConfineMode confineMode = ConfineMode.NoScaling)
                 : base(lookup, defaultImplementation, confineMode)
             {
             }

From 38f7913b31bbc64f99882668b7d8cb89de4d51fd Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:50:56 +0900
Subject: [PATCH 050/930] Fix inverted condition

---
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index b950ef4bbb..c9f2983b1e 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
@@ -251,7 +251,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             public bool OnPressed(KeyBindingPressEvent<OsuAction> e)
             {
-                if (CanBeHit())
+                if (!CanBeHit())
                     return false;
 
                 switch (e.Action)

From 2fc06f16b50c0112522b3c2f164de6aa2aa36608 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:51:28 +0900
Subject: [PATCH 051/930] Fix inspections

---
 osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs
index c624fbbe73..9d79cb0db4 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSkinFallbacks.cs
@@ -91,11 +91,11 @@ namespace osu.Game.Rulesets.Osu.Tests
 
                 var skinnable = firstObject.ApproachCircle;
 
-                if (skin == null && skinnable?.Drawable is DefaultApproachCircle)
+                if (skin == null && skinnable.Drawable is DefaultApproachCircle)
                     // check for default skin provider
                     return true;
 
-                var text = skinnable?.Drawable as SpriteText;
+                var text = skinnable.Drawable as SpriteText;
 
                 return text?.Text == skin;
             });

From e2867986c591f042b63c6da36e1f27d40cb89341 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:47:36 +0900
Subject: [PATCH 052/930] Add xmldocs

---
 .../Objects/Drawables/DrawableHitCircle.cs      | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index c9f2983b1e..f7237d4c03 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
@@ -232,10 +232,24 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             // IsHovered is used
             public override bool HandlePositionalInput => true;
 
+            /// <summary>
+            /// Whether the hitobject can still be hit at the current point in time.
+            /// </summary>
             public required Func<bool> CanBeHit { get; set; }
+
+            /// <summary>
+            /// An action that's invoked to perform the hit.
+            /// </summary>
             public required Action Hit { get; set; }
 
+            /// <summary>
+            /// The <see cref="OsuAction"/> with which the hit was attempted.
+            /// </summary>
             public OsuAction? HitAction { get; private set; }
+
+            /// <summary>
+            /// The closest position to the hit receptor at the point where the hit was attempted.
+            /// </summary>
             public Vector2? ClosestPressPosition { get; private set; }
 
             public HitReceptor()
@@ -290,6 +304,9 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             {
             }
 
+            /// <summary>
+            /// Resets to a fresh state.
+            /// </summary>
             public void Reset()
             {
                 HitAction = null;

From 1f13124b3834b846281c5d63acc65275c356258e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 7 Feb 2024 03:52:51 +0900
Subject: [PATCH 053/930] Always process position as long as it's hittable

For example... If a hitobject is pressed but the result is a shake, this
will stop processing hits.
---
 .../Objects/Drawables/DrawableHitCircle.cs       | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
index f7237d4c03..c3ce6acce9 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableHitCircle.cs
@@ -272,20 +272,16 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 {
                     case OsuAction.LeftButton:
                     case OsuAction.RightButton:
-                        // Only update closest press position while the object hasn't been hit yet.
-                        if (HitAction == null)
+                        if (ClosestPressPosition is Vector2 curClosest)
                         {
-                            if (ClosestPressPosition is Vector2 curClosest)
-                            {
-                                float oldDist = Vector2.DistanceSquared(curClosest, ScreenSpaceDrawQuad.Centre);
-                                float newDist = Vector2.DistanceSquared(e.ScreenSpaceMousePosition, ScreenSpaceDrawQuad.Centre);
+                            float oldDist = Vector2.DistanceSquared(curClosest, ScreenSpaceDrawQuad.Centre);
+                            float newDist = Vector2.DistanceSquared(e.ScreenSpaceMousePosition, ScreenSpaceDrawQuad.Centre);
 
-                                if (newDist < oldDist)
-                                    ClosestPressPosition = e.ScreenSpaceMousePosition;
-                            }
-                            else
+                            if (newDist < oldDist)
                                 ClosestPressPosition = e.ScreenSpaceMousePosition;
                         }
+                        else
+                            ClosestPressPosition = e.ScreenSpaceMousePosition;
 
                         if (IsHovered)
                         {

From dcb195f3c813c72d2bd694d1488e0c37c67f1764 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 8 Feb 2024 02:16:08 +0900
Subject: [PATCH 054/930] Add delayed resume for taiko/catch/mania

---
 .../UI/DrawableCatchRuleset.cs                |  3 ++
 .../UI/DrawableManiaRuleset.cs                |  3 ++
 .../UI/DrawableTaikoRuleset.cs                |  3 ++
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 32 +++++++++++++++++++
 4 files changed, 41 insertions(+)
 create mode 100644 osu.Game/Screens/Play/DelayedResumeOverlay.cs

diff --git a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
index f0a327d7ac..580c90bcb4 100644
--- a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
@@ -16,6 +16,7 @@ using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Scoring;
+using osu.Game.Screens.Play;
 
 namespace osu.Game.Rulesets.Catch.UI
 {
@@ -52,5 +53,7 @@ namespace osu.Game.Rulesets.Catch.UI
         protected override PassThroughInputManager CreateInputManager() => new CatchInputManager(Ruleset.RulesetInfo);
 
         public override DrawableHitObject<CatchHitObject>? CreateDrawableRepresentation(CatchHitObject h) => null;
+
+        protected override ResumeOverlay CreateResumeOverlay() => new DelayedResumeOverlay();
     }
 }
diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index decf670c5d..275b1311de 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
@@ -26,6 +26,7 @@ using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Scoring;
+using osu.Game.Screens.Play;
 using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Mania.UI
@@ -164,6 +165,8 @@ namespace osu.Game.Rulesets.Mania.UI
 
         protected override ReplayRecorder CreateReplayRecorder(Score score) => new ManiaReplayRecorder(score);
 
+        protected override ResumeOverlay CreateResumeOverlay() => new DelayedResumeOverlay();
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index 77b2b06c0e..cd9ed399e6 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -22,6 +22,7 @@ using osu.Game.Rulesets.Timing;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Scoring;
+using osu.Game.Screens.Play;
 using osu.Game.Skinning;
 using osuTK;
 
@@ -101,5 +102,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         protected override ReplayInputHandler CreateReplayInputHandler(Replay replay) => new TaikoFramedReplayInputHandler(replay);
 
         protected override ReplayRecorder CreateReplayRecorder(Score score) => new TaikoReplayRecorder(score);
+
+        protected override ResumeOverlay CreateResumeOverlay() => new DelayedResumeOverlay();
     }
 }
diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
new file mode 100644
index 0000000000..ef39c8eb76
--- /dev/null
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -0,0 +1,32 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+using osu.Framework.Threading;
+
+namespace osu.Game.Screens.Play
+{
+    /// <summary>
+    /// Simple <see cref="ResumeOverlay"/> that resumes after 800ms.
+    /// </summary>
+    public partial class DelayedResumeOverlay : ResumeOverlay
+    {
+        protected override LocalisableString Message => string.Empty;
+
+        private ScheduledDelegate? scheduledResume;
+
+        protected override void PopIn()
+        {
+            base.PopIn();
+
+            scheduledResume?.Cancel();
+            scheduledResume = Scheduler.AddDelayed(Resume, 800);
+        }
+
+        protected override void PopOut()
+        {
+            base.PopOut();
+            scheduledResume?.Cancel();
+        }
+    }
+}

From 57d5717e6a6d4fb4007e6f42aa7bca525ea176e6 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 21:33:23 +0100
Subject: [PATCH 055/930] Remove `Win32Icon` class and use plain strings
 instead

---
 osu.Desktop/Windows/Icons.cs                     |  9 ++++++++-
 osu.Desktop/Windows/Win32Icon.cs                 | 16 ----------------
 osu.Desktop/Windows/WindowsAssociationManager.cs |  8 ++++----
 3 files changed, 12 insertions(+), 21 deletions(-)
 delete mode 100644 osu.Desktop/Windows/Win32Icon.cs

diff --git a/osu.Desktop/Windows/Icons.cs b/osu.Desktop/Windows/Icons.cs
index cc60f92810..67915c101a 100644
--- a/osu.Desktop/Windows/Icons.cs
+++ b/osu.Desktop/Windows/Icons.cs
@@ -1,10 +1,17 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.IO;
+
 namespace osu.Desktop.Windows
 {
     public static class Icons
     {
-        public static Win32Icon Lazer => new Win32Icon(@"lazer.ico");
+        /// <summary>
+        /// Fully qualified path to the directory that contains icons (in the installation folder).
+        /// </summary>
+        private static readonly string icon_directory = Path.GetDirectoryName(typeof(Icons).Assembly.Location)!;
+
+        public static string Lazer => Path.Join(icon_directory, "lazer.ico");
     }
 }
diff --git a/osu.Desktop/Windows/Win32Icon.cs b/osu.Desktop/Windows/Win32Icon.cs
deleted file mode 100644
index 401e7a2be3..0000000000
--- a/osu.Desktop/Windows/Win32Icon.cs
+++ /dev/null
@@ -1,16 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-namespace osu.Desktop.Windows
-{
-    public class Win32Icon
-    {
-        public readonly string Path;
-
-        internal Win32Icon(string name)
-        {
-            string dir = System.IO.Path.GetDirectoryName(typeof(Win32Icon).Assembly.Location)!;
-            Path = System.IO.Path.Join(dir, name);
-        }
-    }
-}
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 7131067224..a93161ae47 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -173,7 +173,7 @@ namespace osu.Desktop.Windows
 
         #endregion
 
-        private record FileAssociation(string Extension, LocalisableString Description, Win32Icon Icon)
+        private record FileAssociation(string Extension, LocalisableString Description, string IconPath)
         {
             private string getProgramId(string prefix) => $@"{prefix}.File{Extension}";
 
@@ -188,7 +188,7 @@ namespace osu.Desktop.Windows
                 using (var programKey = classes.CreateSubKey(programId))
                 {
                     using (var defaultIconKey = programKey.CreateSubKey(DEFAULT_ICON))
-                        defaultIconKey.SetValue(null, Icon.Path);
+                        defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = programKey.CreateSubKey(SHELL_OPEN_COMMAND))
                         openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
@@ -225,7 +225,7 @@ namespace osu.Desktop.Windows
             }
         }
 
-        private record UriAssociation(string Protocol, LocalisableString Description, Win32Icon Icon)
+        private record UriAssociation(string Protocol, LocalisableString Description, string IconPath)
         {
             /// <summary>
             /// "The <c>URL Protocol</c> string value indicates that this key declares a custom pluggable protocol handler."
@@ -243,7 +243,7 @@ namespace osu.Desktop.Windows
                     protocolKey.SetValue(URL_PROTOCOL, string.Empty);
 
                     using (var defaultIconKey = protocolKey.CreateSubKey(DEFAULT_ICON))
-                        defaultIconKey.SetValue(null, Icon.Path);
+                        defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = protocolKey.CreateSubKey(SHELL_OPEN_COMMAND))
                         openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");

From eeba93768641b05a470aa1e8ebe18389596f5d49 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 21:45:36 +0100
Subject: [PATCH 056/930] Make `WindowsAssociationManager` `static`

Usages/localisation logic TBD
---
 osu.Desktop/Program.cs                        |  2 +-
 .../Windows/WindowsAssociationManager.cs      | 57 ++++++-------------
 2 files changed, 19 insertions(+), 40 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index edbf39a30a..38e4110f62 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -181,7 +181,7 @@ namespace osu.Desktop
             {
                 tools.RemoveShortcutForThisExe();
                 tools.RemoveUninstallerRegistryEntry();
-                WindowsAssociationManager.UninstallAssociations(@"osu");
+                WindowsAssociationManager.UninstallAssociations();
             }, onEveryRun: (_, _, _) =>
             {
                 // While setting the `ProcessAppUserModelId` fixes duplicate icons/shortcuts on the taskbar, it currently
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index a93161ae47..f1fc98090f 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -6,9 +6,6 @@ using System.IO;
 using System.Runtime.InteropServices;
 using System.Runtime.Versioning;
 using Microsoft.Win32;
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Game.Localisation;
@@ -16,7 +13,7 @@ using osu.Game.Localisation;
 namespace osu.Desktop.Windows
 {
     [SupportedOSPlatform("windows")]
-    public partial class WindowsAssociationManager : Component
+    public static class WindowsAssociationManager
     {
         public const string SOFTWARE_CLASSES = @"Software\Classes";
 
@@ -54,25 +51,7 @@ namespace osu.Desktop.Windows
             new UriAssociation(@"osump", WindowsAssociationManagerStrings.OsuMultiplayer, Icons.Lazer),
         };
 
-        [Resolved]
-        private LocalisationManager localisation { get; set; } = null!;
-
-        private IBindable<LocalisationParameters> localisationParameters = null!;
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            localisationParameters = localisation.CurrentParameters.GetBoundCopy();
-            InstallAssociations();
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            localisationParameters.ValueChanged += _ => updateDescriptions();
-        }
-
-        public void InstallAssociations()
+        public static void InstallAssociations(LocalisationManager? localisation)
         {
             try
             {
@@ -88,7 +67,7 @@ namespace osu.Desktop.Windows
                         association.Install(classes, EXE_PATH);
                 }
 
-                updateDescriptions();
+                updateDescriptions(localisation);
             }
             catch (Exception e)
             {
@@ -96,7 +75,7 @@ namespace osu.Desktop.Windows
             }
         }
 
-        private void updateDescriptions()
+        private static void updateDescriptions(LocalisationManager? localisation)
         {
             try
             {
@@ -105,18 +84,10 @@ namespace osu.Desktop.Windows
                     return;
 
                 foreach (var association in file_associations)
-                {
-                    var b = localisation.GetLocalisedBindableString(association.Description);
-                    association.UpdateDescription(classes, PROGRAM_ID_PREFIX, b.Value);
-                    b.UnbindAll();
-                }
+                    association.UpdateDescription(classes, PROGRAM_ID_PREFIX, getLocalisedString(association.Description));
 
                 foreach (var association in uri_associations)
-                {
-                    var b = localisation.GetLocalisedBindableString(association.Description);
-                    association.UpdateDescription(classes, b.Value);
-                    b.UnbindAll();
-                }
+                    association.UpdateDescription(classes, getLocalisedString(association.Description));
 
                 NotifyShellUpdate();
             }
@@ -124,11 +95,19 @@ namespace osu.Desktop.Windows
             {
                 Logger.Log($@"Failed to update file and URI associations: {e.Message}");
             }
+
+            string getLocalisedString(LocalisableString s)
+            {
+                if (localisation == null)
+                    return s.ToString();
+
+                var b = localisation.GetLocalisedBindableString(s);
+                b.UnbindAll();
+                return b.Value;
+            }
         }
 
-        public void UninstallAssociations() => UninstallAssociations(PROGRAM_ID_PREFIX);
-
-        public static void UninstallAssociations(string programIdPrefix)
+        public static void UninstallAssociations()
         {
             try
             {
@@ -137,7 +116,7 @@ namespace osu.Desktop.Windows
                     return;
 
                 foreach (var association in file_associations)
-                    association.Uninstall(classes, programIdPrefix);
+                    association.Uninstall(classes, PROGRAM_ID_PREFIX);
 
                 foreach (var association in uri_associations)
                     association.Uninstall(classes);

From f9d257b99ea176222671aa4594ec78c01f157db7 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 21:56:39 +0100
Subject: [PATCH 057/930] Install associations as part of initial squirrel
 install

---
 osu.Desktop/OsuGameDesktop.cs | 3 ---
 osu.Desktop/Program.cs        | 1 +
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 2e1b34fb38..a0db896f46 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -137,9 +137,6 @@ namespace osu.Desktop
             if (RuntimeInfo.OS == RuntimeInfo.Platform.Windows)
                 LoadComponentAsync(new GameplayWinKeyBlocker(), Add);
 
-            if (OperatingSystem.IsWindows() && IsDeployedBuild)
-                LoadComponentAsync(new WindowsAssociationManager(), Add);
-
             LoadComponentAsync(new ElevatedPrivilegesChecker(), Add);
 
             osuSchemeLinkIPCChannel = new OsuSchemeLinkIPCChannel(Host, this);
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 38e4110f62..65236940c6 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -174,6 +174,7 @@ namespace osu.Desktop
             {
                 tools.CreateShortcutForThisExe();
                 tools.CreateUninstallerRegistryEntry();
+                WindowsAssociationManager.InstallAssociations(null);
             }, onAppUpdate: (_, tools) =>
             {
                 tools.CreateUninstallerRegistryEntry();

From 0563507295dcf68c150cfc99949964d521f98b0e Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:03:16 +0100
Subject: [PATCH 058/930] Remove duplicate try-catch and move
 `NotifyShellUpdate()` to less hidden place

---
 .../Windows/WindowsAssociationManager.cs      | 24 +++++++------------
 1 file changed, 8 insertions(+), 16 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index f1fc98090f..c91ab459d6 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -68,6 +68,7 @@ namespace osu.Desktop.Windows
                 }
 
                 updateDescriptions(localisation);
+                NotifyShellUpdate();
             }
             catch (Exception e)
             {
@@ -77,24 +78,15 @@ namespace osu.Desktop.Windows
 
         private static void updateDescriptions(LocalisationManager? localisation)
         {
-            try
-            {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-                if (classes == null)
-                    return;
+            using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+            if (classes == null)
+                return;
 
-                foreach (var association in file_associations)
-                    association.UpdateDescription(classes, PROGRAM_ID_PREFIX, getLocalisedString(association.Description));
+            foreach (var association in file_associations)
+                association.UpdateDescription(classes, PROGRAM_ID_PREFIX, getLocalisedString(association.Description));
 
-                foreach (var association in uri_associations)
-                    association.UpdateDescription(classes, getLocalisedString(association.Description));
-
-                NotifyShellUpdate();
-            }
-            catch (Exception e)
-            {
-                Logger.Log($@"Failed to update file and URI associations: {e.Message}");
-            }
+            foreach (var association in uri_associations)
+                association.UpdateDescription(classes, getLocalisedString(association.Description));
 
             string getLocalisedString(LocalisableString s)
             {

From 6bdb07602794d7eb59e7356f9fa5a04188652ff2 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:06:09 +0100
Subject: [PATCH 059/930] Move update/install logic into helper

---
 .../Windows/WindowsAssociationManager.cs      | 31 ++++++++++++-------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index c91ab459d6..3d61ad534b 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -55,18 +55,7 @@ namespace osu.Desktop.Windows
         {
             try
             {
-                using (var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, writable: true))
-                {
-                    if (classes == null)
-                        return;
-
-                    foreach (var association in file_associations)
-                        association.Install(classes, EXE_PATH, PROGRAM_ID_PREFIX);
-
-                    foreach (var association in uri_associations)
-                        association.Install(classes, EXE_PATH);
-                }
-
+                updateAssociations();
                 updateDescriptions(localisation);
                 NotifyShellUpdate();
             }
@@ -76,6 +65,24 @@ namespace osu.Desktop.Windows
             }
         }
 
+        /// <summary>
+        /// Installs or updates associations.
+        /// </summary>
+        private static void updateAssociations()
+        {
+            using (var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, writable: true))
+            {
+                if (classes == null)
+                    return;
+
+                foreach (var association in file_associations)
+                    association.Install(classes, EXE_PATH, PROGRAM_ID_PREFIX);
+
+                foreach (var association in uri_associations)
+                    association.Install(classes, EXE_PATH);
+            }
+        }
+
         private static void updateDescriptions(LocalisationManager? localisation)
         {
             using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);

From 738c28755c53fd587d7ecee0cc6e8365c6aa8a44 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:17:13 +0100
Subject: [PATCH 060/930] Refactor public methods

---
 osu.Desktop/Program.cs                        |  3 +-
 .../Windows/WindowsAssociationManager.cs      | 42 ++++++++++++++++++-
 2 files changed, 42 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 65236940c6..494d0df3c6 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -174,10 +174,11 @@ namespace osu.Desktop
             {
                 tools.CreateShortcutForThisExe();
                 tools.CreateUninstallerRegistryEntry();
-                WindowsAssociationManager.InstallAssociations(null);
+                WindowsAssociationManager.InstallAssociations();
             }, onAppUpdate: (_, tools) =>
             {
                 tools.CreateUninstallerRegistryEntry();
+                WindowsAssociationManager.UpdateAssociations();
             }, onAppUninstall: (_, tools) =>
             {
                 tools.RemoveShortcutForThisExe();
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 3d61ad534b..18a3c2da3d 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -51,12 +51,18 @@ namespace osu.Desktop.Windows
             new UriAssociation(@"osump", WindowsAssociationManagerStrings.OsuMultiplayer, Icons.Lazer),
         };
 
-        public static void InstallAssociations(LocalisationManager? localisation)
+        /// <summary>
+        /// Installs file and URI associations.
+        /// </summary>
+        /// <remarks>
+        /// Call <see cref="UpdateDescriptions"/> in a timely fashion to keep descriptions up-to-date and localised.
+        /// </remarks>
+        public static void InstallAssociations()
         {
             try
             {
                 updateAssociations();
-                updateDescriptions(localisation);
+                updateDescriptions(null); // write default descriptions in case `UpdateDescriptions()` is not called.
                 NotifyShellUpdate();
             }
             catch (Exception e)
@@ -65,6 +71,38 @@ namespace osu.Desktop.Windows
             }
         }
 
+        /// <summary>
+        /// Updates associations with latest definitions.
+        /// </summary>
+        /// <remarks>
+        /// Call <see cref="UpdateDescriptions"/> in a timely fashion to keep descriptions up-to-date and localised.
+        /// </remarks>
+        public static void UpdateAssociations()
+        {
+            try
+            {
+                updateAssociations();
+                NotifyShellUpdate();
+            }
+            catch (Exception e)
+            {
+                Logger.Log(@$"Failed to update file and URI associations: {e.Message}");
+            }
+        }
+
+        public static void UpdateDescriptions(LocalisationManager localisationManager)
+        {
+            try
+            {
+                updateDescriptions(localisationManager);
+                NotifyShellUpdate();
+            }
+            catch (Exception e)
+            {
+                Logger.Log(@$"Failed to update file and URI association descriptions: {e.Message}");
+            }
+        }
+
         /// <summary>
         /// Installs or updates associations.
         /// </summary>

From ffdefbc742fa1948d1e9356b438adbf319221bd3 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:18:12 +0100
Subject: [PATCH 061/930] Move public methods closer together

---
 .../Windows/WindowsAssociationManager.cs      | 44 +++++++++----------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 18a3c2da3d..b7465e5ffc 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -103,6 +103,28 @@ namespace osu.Desktop.Windows
             }
         }
 
+        public static void UninstallAssociations()
+        {
+            try
+            {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null)
+                    return;
+
+                foreach (var association in file_associations)
+                    association.Uninstall(classes, PROGRAM_ID_PREFIX);
+
+                foreach (var association in uri_associations)
+                    association.Uninstall(classes);
+
+                NotifyShellUpdate();
+            }
+            catch (Exception e)
+            {
+                Logger.Log($@"Failed to uninstall file and URI associations: {e.Message}");
+            }
+        }
+
         /// <summary>
         /// Installs or updates associations.
         /// </summary>
@@ -144,28 +166,6 @@ namespace osu.Desktop.Windows
             }
         }
 
-        public static void UninstallAssociations()
-        {
-            try
-            {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-                if (classes == null)
-                    return;
-
-                foreach (var association in file_associations)
-                    association.Uninstall(classes, PROGRAM_ID_PREFIX);
-
-                foreach (var association in uri_associations)
-                    association.Uninstall(classes);
-
-                NotifyShellUpdate();
-            }
-            catch (Exception e)
-            {
-                Logger.Log($@"Failed to uninstall file and URI associations: {e.Message}");
-            }
-        }
-
         internal static void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
 
         #region Native interop

From da8c4541dbfe8c8c0690ca57d91b6d428e94870d Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:21:04 +0100
Subject: [PATCH 062/930] Use `Logger.Error`

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index b7465e5ffc..c978e46b5b 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -67,7 +67,7 @@ namespace osu.Desktop.Windows
             }
             catch (Exception e)
             {
-                Logger.Log(@$"Failed to install file and URI associations: {e.Message}");
+                Logger.Error(e, @$"Failed to install file and URI associations: {e.Message}");
             }
         }
 
@@ -86,7 +86,7 @@ namespace osu.Desktop.Windows
             }
             catch (Exception e)
             {
-                Logger.Log(@$"Failed to update file and URI associations: {e.Message}");
+                Logger.Error(e, @"Failed to update file and URI associations.");
             }
         }
 
@@ -99,7 +99,7 @@ namespace osu.Desktop.Windows
             }
             catch (Exception e)
             {
-                Logger.Log(@$"Failed to update file and URI association descriptions: {e.Message}");
+                Logger.Error(e, @"Failed to update file and URI association descriptions.");
             }
         }
 
@@ -121,7 +121,7 @@ namespace osu.Desktop.Windows
             }
             catch (Exception e)
             {
-                Logger.Log($@"Failed to uninstall file and URI associations: {e.Message}");
+                Logger.Error(e, @"Failed to uninstall file and URI associations.");
             }
         }
 

From 7f5dedc118059189e0d2bcb77e65ed39444de765 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:23:59 +0100
Subject: [PATCH 063/930] Refactor ProgID logic so it's more visible

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index c978e46b5b..aeda1e6283 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -35,7 +35,7 @@ namespace osu.Desktop.Windows
         /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
         /// see https://learn.microsoft.com/en-us/windows/win32/com/-progid--key.
         /// </summary>
-        public const string PROGRAM_ID_PREFIX = "osu";
+        public const string PROGRAM_ID_PREFIX = "osu.File";
 
         private static readonly FileAssociation[] file_associations =
         {
@@ -136,7 +136,7 @@ namespace osu.Desktop.Windows
                     return;
 
                 foreach (var association in file_associations)
-                    association.Install(classes, EXE_PATH, PROGRAM_ID_PREFIX);
+                    association.Install(classes, EXE_PATH);
 
                 foreach (var association in uri_associations)
                     association.Install(classes, EXE_PATH);
@@ -191,15 +191,13 @@ namespace osu.Desktop.Windows
 
         private record FileAssociation(string Extension, LocalisableString Description, string IconPath)
         {
-            private string getProgramId(string prefix) => $@"{prefix}.File{Extension}";
+            private string programId => $@"{PROGRAM_ID_PREFIX}{Extension}";
 
             /// <summary>
             /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
             /// </summary>
-            public void Install(RegistryKey classes, string exePath, string programIdPrefix)
+            public void Install(RegistryKey classes, string exePath)
             {
-                string programId = getProgramId(programIdPrefix);
-
                 // register a program id for the given extension
                 using (var programKey = classes.CreateSubKey(programId))
                 {
@@ -224,14 +222,12 @@ namespace osu.Desktop.Windows
 
             public void UpdateDescription(RegistryKey classes, string programIdPrefix, string description)
             {
-                using (var programKey = classes.OpenSubKey(getProgramId(programIdPrefix), true))
+                using (var programKey = classes.OpenSubKey(programId, true))
                     programKey?.SetValue(null, description);
             }
 
             public void Uninstall(RegistryKey classes, string programIdPrefix)
             {
-                string programId = getProgramId(programIdPrefix);
-
                 // importantly, we don't delete the default program entry because some other program could have taken it.
 
                 using (var extensionKey = classes.OpenSubKey($@"{Extension}\OpenWithProgIds", true))

From 3419b8ffa854b4b40daf26fe248e89a4e812e84a Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:26:21 +0100
Subject: [PATCH 064/930] Standardise using declaration

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index aeda1e6283..a786afde55 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -130,17 +130,15 @@ namespace osu.Desktop.Windows
         /// </summary>
         private static void updateAssociations()
         {
-            using (var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, writable: true))
-            {
-                if (classes == null)
-                    return;
+            using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+            if (classes == null)
+                return;
 
-                foreach (var association in file_associations)
-                    association.Install(classes, EXE_PATH);
+            foreach (var association in file_associations)
+                association.Install(classes, EXE_PATH);
 
-                foreach (var association in uri_associations)
-                    association.Install(classes, EXE_PATH);
-            }
+            foreach (var association in uri_associations)
+                association.Install(classes, EXE_PATH);
         }
 
         private static void updateDescriptions(LocalisationManager? localisation)

From 139072fa818a088f300fce9cfd38682c9c57dbcd Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:29:20 +0100
Subject: [PATCH 065/930] Standardise using declaration

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index a786afde55..2373cfa609 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.IO;
 using System.Runtime.InteropServices;
 using System.Runtime.Versioning;
@@ -108,8 +109,7 @@ namespace osu.Desktop.Windows
             try
             {
                 using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-                if (classes == null)
-                    return;
+                Debug.Assert(classes != null);
 
                 foreach (var association in file_associations)
                     association.Uninstall(classes, PROGRAM_ID_PREFIX);
@@ -131,8 +131,7 @@ namespace osu.Desktop.Windows
         private static void updateAssociations()
         {
             using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-            if (classes == null)
-                return;
+            Debug.Assert(classes != null);
 
             foreach (var association in file_associations)
                 association.Install(classes, EXE_PATH);
@@ -144,8 +143,7 @@ namespace osu.Desktop.Windows
         private static void updateDescriptions(LocalisationManager? localisation)
         {
             using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-            if (classes == null)
-                return;
+            Debug.Assert(classes != null);
 
             foreach (var association in file_associations)
                 association.UpdateDescription(classes, PROGRAM_ID_PREFIX, getLocalisedString(association.Description));

From bf47221594a805530cee18ab5e2ff802bd54f232 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:42:42 +0100
Subject: [PATCH 066/930] Make things testable via 'Run static method' in Rider

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 2 +-
 osu.Desktop/osu.Desktop.csproj                   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 2373cfa609..83fadfcae2 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -30,7 +30,7 @@ namespace osu.Desktop.Windows
         /// </summary>
         public const string SHELL_OPEN_COMMAND = @"Shell\Open\Command";
 
-        public static readonly string EXE_PATH = Path.ChangeExtension(typeof(WindowsAssociationManager).Assembly.Location, ".exe");
+        public static readonly string EXE_PATH = Path.ChangeExtension(typeof(WindowsAssociationManager).Assembly.Location, ".exe").Replace('/', '\\');
 
         /// <summary>
         /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
diff --git a/osu.Desktop/osu.Desktop.csproj b/osu.Desktop/osu.Desktop.csproj
index c6a95c1623..57752aa1f7 100644
--- a/osu.Desktop/osu.Desktop.csproj
+++ b/osu.Desktop/osu.Desktop.csproj
@@ -31,7 +31,7 @@
   <ItemGroup Label="Resources">
     <EmbeddedResource Include="lazer.ico" />
   </ItemGroup>
-  <ItemGroup Label="Windows Icons" Condition="$(RuntimeIdentifier.StartsWith('win'))">
+  <ItemGroup Label="Windows Icons">
     <Content Include="*.ico" CopyToOutputDirectory="PreserveNewest" CopyToPublishDirectory="PreserveNewest" />
   </ItemGroup>
 </Project>

From 8049270ad2e17447a5f80446a7e39e73dc5e52e2 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 7 Feb 2024 22:45:58 +0100
Subject: [PATCH 067/930] Remove unused param

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 83fadfcae2..83c2a97b56 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -112,7 +112,7 @@ namespace osu.Desktop.Windows
                 Debug.Assert(classes != null);
 
                 foreach (var association in file_associations)
-                    association.Uninstall(classes, PROGRAM_ID_PREFIX);
+                    association.Uninstall(classes);
 
                 foreach (var association in uri_associations)
                     association.Uninstall(classes);
@@ -146,7 +146,7 @@ namespace osu.Desktop.Windows
             Debug.Assert(classes != null);
 
             foreach (var association in file_associations)
-                association.UpdateDescription(classes, PROGRAM_ID_PREFIX, getLocalisedString(association.Description));
+                association.UpdateDescription(classes, getLocalisedString(association.Description));
 
             foreach (var association in uri_associations)
                 association.UpdateDescription(classes, getLocalisedString(association.Description));
@@ -216,13 +216,13 @@ namespace osu.Desktop.Windows
                 }
             }
 
-            public void UpdateDescription(RegistryKey classes, string programIdPrefix, string description)
+            public void UpdateDescription(RegistryKey classes, string description)
             {
                 using (var programKey = classes.OpenSubKey(programId, true))
                     programKey?.SetValue(null, description);
             }
 
-            public void Uninstall(RegistryKey classes, string programIdPrefix)
+            public void Uninstall(RegistryKey classes)
             {
                 // importantly, we don't delete the default program entry because some other program could have taken it.
 

From dfa0c51bc8b1067a08811f221da52109a6806c94 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 8 Feb 2024 00:23:46 +0100
Subject: [PATCH 068/930] Copy icons to nuget and install package

Don't ask me why this uses the folder for .NET Framework 4.5
---
 osu.Desktop/osu.nuspec | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Desktop/osu.nuspec b/osu.Desktop/osu.nuspec
index f85698680e..66b3970351 100644
--- a/osu.Desktop/osu.nuspec
+++ b/osu.Desktop/osu.nuspec
@@ -20,6 +20,7 @@
       <file src="**.dll" target="lib\net45\"/>
       <file src="**.config" target="lib\net45\"/>
       <file src="**.json" target="lib\net45\"/>
+      <file src="**.ico" target="lib\net45\"/>
       <file src="icon.png" target=""/>
     </files>
 </package>

From 1dc54d6f25d030db88936ecbfec7dd8f55c71d3e Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 8 Feb 2024 00:54:48 +0100
Subject: [PATCH 069/930] Fix stable install path lookup

`osu` is the `osu://` protocol handler, which gets overriden by lazer.
Instead, use `osu!` which is the stable file handler.
---
 osu.Desktop/OsuGameDesktop.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index a0db896f46..5ac6ac7322 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -86,8 +86,8 @@ namespace osu.Desktop
         [SupportedOSPlatform("windows")]
         private string? getStableInstallPathFromRegistry()
         {
-            using (RegistryKey? key = Registry.ClassesRoot.OpenSubKey("osu"))
-                return key?.OpenSubKey(@"shell\open\command")?.GetValue(string.Empty)?.ToString()?.Split('"')[1].Replace("osu!.exe", "");
+            using (RegistryKey? key = Registry.ClassesRoot.OpenSubKey("osu!"))
+                return key?.OpenSubKey(WindowsAssociationManager.SHELL_OPEN_COMMAND)?.GetValue(string.Empty)?.ToString()?.Split('"')[1].Replace("osu!.exe", "");
         }
 
         protected override UpdateManager CreateUpdateManager()

From 6ded79cf0728010aedfb367cf48f3fd3f84abe6c Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 8 Feb 2024 01:15:37 +0100
Subject: [PATCH 070/930] Make `NotifyShellUpdate()` `public` to ease testing

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 83c2a97b56..4bb8e57c9d 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -125,6 +125,8 @@ namespace osu.Desktop.Windows
             }
         }
 
+        public static void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
+
         /// <summary>
         /// Installs or updates associations.
         /// </summary>
@@ -162,8 +164,6 @@ namespace osu.Desktop.Windows
             }
         }
 
-        internal static void NotifyShellUpdate() => SHChangeNotify(EventId.SHCNE_ASSOCCHANGED, Flags.SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
-
         #region Native interop
 
         [DllImport("Shell32.dll")]

From 1944a12634817ea43888e8ffec7b6359e6499f44 Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Mon, 12 Feb 2024 21:18:31 +0900
Subject: [PATCH 071/930] allow `ModMuted` to ranked when setting adjusted

---
 osu.Game/Rulesets/Mods/ModMuted.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/ModMuted.cs b/osu.Game/Rulesets/Mods/ModMuted.cs
index 3ecd9aa6a1..7aefefc58d 100644
--- a/osu.Game/Rulesets/Mods/ModMuted.cs
+++ b/osu.Game/Rulesets/Mods/ModMuted.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mods
         public override LocalisableString Description => "Can you still feel the rhythm without music?";
         public override ModType Type => ModType.Fun;
         public override double ScoreMultiplier => 1;
-        public override bool Ranked => UsesDefaultConfiguration;
+        public override bool Ranked => true;
     }
 
     public abstract class ModMuted<TObject> : ModMuted, IApplicableToDrawableRuleset<TObject>, IApplicableToTrack, IApplicableToScoreProcessor

From 6402f23f0245ecac17f82f1a9e5f06b9bd7898b2 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Mon, 12 Feb 2024 21:00:15 +0200
Subject: [PATCH 072/930] Added Traceable support for pp

---
 .../Difficulty/OsuPerformanceCalculator.cs           | 12 ++++++++++++
 osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs        |  1 +
 2 files changed, 13 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index b31f4ff519..4771bce280 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -116,6 +116,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
                 aimValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
+            else if (score.Mods.Any(h => h is OsuModTraceable))
+            {
+                // Default 2% increase and another is scaled by AR
+                aimValue *= 1.02 + 0.02 * (12.0 - attributes.ApproachRate);
+            }
 
             // We assume 15% of sliders in a map are difficult since there's no way to tell from the performance calculator.
             double estimateDifficultSliders = attributes.SliderCount * 0.15;
@@ -167,6 +172,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
                 speedValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
+            else if (score.Mods.Any(h => h is OsuModTraceable))
+            {
+                // More reward for speed because speed on Traceable is annoying
+                speedValue *= 1.04 + 0.06 * (12.0 - attributes.ApproachRate);
+            }
 
             // Calculate accuracy assuming the worst case scenario
             double relevantTotalDiff = totalHits - attributes.SpeedNoteCount;
@@ -214,6 +224,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 accuracyValue *= 1.14;
             else if (score.Mods.Any(m => m is OsuModHidden))
                 accuracyValue *= 1.08;
+            else if (score.Mods.Any(m => m is OsuModTraceable))
+                accuracyValue *= 1.02 + 0.01 * (12.0 - attributes.ApproachRate);
 
             if (score.Mods.Any(m => m is OsuModFlashlight))
                 accuracyValue *= 1.02;
diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
index 9671f53bea..320c0a7040 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
@@ -19,6 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override LocalisableString Description => "Put your faith in the approach circles...";
         public override double ScoreMultiplier => 1;
+        public override bool Ranked => UsesDefaultConfiguration;
 
         public override Type[] IncompatibleMods => new[] { typeof(IHidesApproachCircles), typeof(OsuModDepth) };
 

From 56391550096a19486e06d98a20e1f5bb1421c090 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Mon, 12 Feb 2024 23:31:00 +0200
Subject: [PATCH 073/930] Update OsuModTraceable.cs

---
 osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
index 320c0a7040..9671f53bea 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
@@ -19,7 +19,6 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override LocalisableString Description => "Put your faith in the approach circles...";
         public override double ScoreMultiplier => 1;
-        public override bool Ranked => UsesDefaultConfiguration;
 
         public override Type[] IncompatibleMods => new[] { typeof(IHidesApproachCircles), typeof(OsuModDepth) };
 

From 1eb04c5190220e97b901ab989985709f1553fa22 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 13 Feb 2024 11:24:31 +0100
Subject: [PATCH 074/930] Add failing test coverage for catch

---
 .../CatchHealthProcessorTest.cs               | 58 +++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
new file mode 100644
index 0000000000..8c2d1a91ab
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
@@ -0,0 +1,58 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Game.Rulesets.Catch.Beatmaps;
+using osu.Game.Rulesets.Catch.Judgements;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Catch.Scoring;
+
+namespace osu.Game.Rulesets.Catch.Tests
+{
+    [TestFixture]
+    public class CatchHealthProcessorTest
+    {
+        private static readonly object[][] test_cases =
+        [
+            // hitobject, starting HP, fail expected after miss
+            [new Fruit(), 0.01, true],
+            [new Droplet(), 0.01, true],
+            [new TinyDroplet(), 0, true],
+            [new Banana(), 0, false],
+        ];
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestFailAfterMinResult(CatchHitObject hitObject, double startingHealth, bool failExpected)
+        {
+            var healthProcessor = new CatchHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new CatchBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new CatchJudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MinResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.EqualTo(failExpected));
+        }
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestNoFailAfterMaxResult(CatchHitObject hitObject, double startingHealth, bool _)
+        {
+            var healthProcessor = new CatchHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new CatchBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new CatchJudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MaxResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.False);
+        }
+    }
+}

From 86801aa51d9716228f24fb4728607f95f2ed8f7b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 13 Feb 2024 11:57:42 +0100
Subject: [PATCH 075/930] Add failing test coverage for osu!

---
 .../OsuHealthProcessorTest.cs                 | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu.Tests/OsuHealthProcessorTest.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/OsuHealthProcessorTest.cs b/osu.Game.Rulesets.Osu.Tests/OsuHealthProcessorTest.cs
new file mode 100644
index 0000000000..cf93e0ce7b
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/OsuHealthProcessorTest.cs
@@ -0,0 +1,66 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Game.Rulesets.Osu.Beatmaps;
+using osu.Game.Rulesets.Osu.Judgements;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Rulesets.Osu.Scoring;
+
+namespace osu.Game.Rulesets.Osu.Tests
+{
+    [TestFixture]
+    public class OsuHealthProcessorTest
+    {
+        private static readonly object[][] test_cases =
+        [
+            // hitobject, starting HP, fail expected after miss
+            [new HitCircle(), 0.01, true],
+            [new SliderHeadCircle(), 0.01, true],
+            [new SliderHeadCircle { ClassicSliderBehaviour = true }, 0.01, true],
+            [new SliderTick(), 0.01, true],
+            [new SliderRepeat(new Slider()), 0.01, true],
+            [new SliderTailCircle(new Slider()), 0, true],
+            [new SliderTailCircle(new Slider()) { ClassicSliderBehaviour = true }, 0.01, true],
+            [new Slider(), 0, true],
+            [new Slider { ClassicSliderBehaviour = true }, 0.01, true],
+            [new SpinnerTick(), 0, false],
+            [new SpinnerBonusTick(), 0, false],
+            [new Spinner(), 0.01, true],
+        ];
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestFailAfterMinResult(OsuHitObject hitObject, double startingHealth, bool failExpected)
+        {
+            var healthProcessor = new OsuHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new OsuBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new OsuJudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MinResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.EqualTo(failExpected));
+        }
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestNoFailAfterMaxResult(OsuHitObject hitObject, double startingHealth, bool _)
+        {
+            var healthProcessor = new OsuHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new OsuBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new OsuJudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MaxResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.False);
+        }
+    }
+}

From 441a7b3c2ff68fc13fefb439698e4605f9adacc8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 13 Feb 2024 12:07:40 +0100
Subject: [PATCH 076/930] Add precautionary taiko test coverage

---
 .../TaikoHealthProcessorTest.cs               | 82 ++++++++++++++++++-
 1 file changed, 81 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko.Tests/TaikoHealthProcessorTest.cs b/osu.Game.Rulesets.Taiko.Tests/TaikoHealthProcessorTest.cs
index f4a1e888c9..aba967cdd6 100644
--- a/osu.Game.Rulesets.Taiko.Tests/TaikoHealthProcessorTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/TaikoHealthProcessorTest.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Rulesets.Taiko.Tests
             {
                 HitObjects =
                 {
-                    new DrumRoll { Duration = 2000 }
+                    new Swell { Duration = 2000 }
                 }
             };
 
@@ -172,5 +172,85 @@ namespace osu.Game.Rulesets.Taiko.Tests
                 Assert.That(healthProcessor.HasFailed, Is.False);
             });
         }
+
+        [Test]
+        public void TestMissHitAndHitSwell()
+        {
+            var beatmap = new TaikoBeatmap
+            {
+                HitObjects =
+                {
+                    new Hit(),
+                    new Swell { Duration = 2000 }
+                }
+            };
+
+            foreach (var ho in beatmap.HitObjects)
+                ho.ApplyDefaults(beatmap.ControlPointInfo, beatmap.Difficulty);
+
+            var healthProcessor = new TaikoHealthProcessor();
+            healthProcessor.ApplyBeatmap(beatmap);
+
+            healthProcessor.ApplyResult(new JudgementResult(beatmap.HitObjects[0], new TaikoJudgement()) { Type = HitResult.Miss });
+
+            foreach (var nested in beatmap.HitObjects[1].NestedHitObjects)
+            {
+                var nestedJudgement = nested.CreateJudgement();
+                healthProcessor.ApplyResult(new JudgementResult(nested, nestedJudgement) { Type = nestedJudgement.MaxResult });
+            }
+
+            var judgement = beatmap.HitObjects[1].CreateJudgement();
+            healthProcessor.ApplyResult(new JudgementResult(beatmap.HitObjects[1], judgement) { Type = judgement.MaxResult });
+
+            Assert.Multiple(() =>
+            {
+                Assert.That(healthProcessor.Health.Value, Is.EqualTo(0));
+                Assert.That(healthProcessor.HasFailed, Is.True);
+            });
+        }
+
+        private static readonly object[][] test_cases =
+        [
+            // hitobject, fail expected after miss
+            [new Hit(), true],
+            [new Hit.StrongNestedHit(new Hit()), false],
+            [new DrumRollTick(new DrumRoll()), false],
+            [new DrumRollTick.StrongNestedHit(new DrumRollTick(new DrumRoll())), false],
+            [new DrumRoll(), false],
+            [new SwellTick(), false],
+            [new Swell(), false]
+        ];
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestFailAfterMinResult(TaikoHitObject hitObject, bool failExpected)
+        {
+            var healthProcessor = new TaikoHealthProcessor();
+            healthProcessor.ApplyBeatmap(new TaikoBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+
+            var result = new JudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MinResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.EqualTo(failExpected));
+        }
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestNoFailAfterMaxResult(TaikoHitObject hitObject, bool _)
+        {
+            var healthProcessor = new TaikoHealthProcessor();
+            healthProcessor.ApplyBeatmap(new TaikoBeatmap
+            {
+                HitObjects = { hitObject }
+            });
+
+            var result = new JudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MaxResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.False);
+        }
     }
 }

From d07ea8f5b12886883a60cf9c477fa9d632404ff5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 13 Feb 2024 12:17:38 +0100
Subject: [PATCH 077/930] Add failing test coverage for mania

---
 .../ManiaHealthProcessorTest.cs               | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/osu.Game.Rulesets.Mania.Tests/ManiaHealthProcessorTest.cs b/osu.Game.Rulesets.Mania.Tests/ManiaHealthProcessorTest.cs
index 315849f7de..a9771a46f3 100644
--- a/osu.Game.Rulesets.Mania.Tests/ManiaHealthProcessorTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/ManiaHealthProcessorTest.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using NUnit.Framework;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
 using osu.Game.Rulesets.Mania.Scoring;
@@ -27,5 +28,49 @@ namespace osu.Game.Rulesets.Mania.Tests
             // No matter what, mania doesn't have passive HP drain.
             Assert.That(processor.DrainRate, Is.Zero);
         }
+
+        private static readonly object[][] test_cases =
+        [
+            // hitobject, starting HP, fail expected after miss
+            [new Note(), 0.01, true],
+            [new HeadNote(), 0.01, true],
+            [new TailNote(), 0.01, true],
+            [new HoldNoteBody(), 0, true], // hold note break
+            [new HoldNote(), 0, true],
+        ];
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestFailAfterMinResult(ManiaHitObject hitObject, double startingHealth, bool failExpected)
+        {
+            var healthProcessor = new ManiaHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new ManiaBeatmap(new StageDefinition(4))
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new JudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MinResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.EqualTo(failExpected));
+        }
+
+        [TestCaseSource(nameof(test_cases))]
+        public void TestNoFailAfterMaxResult(ManiaHitObject hitObject, double startingHealth, bool _)
+        {
+            var healthProcessor = new ManiaHealthProcessor(0);
+            healthProcessor.ApplyBeatmap(new ManiaBeatmap(new StageDefinition(4))
+            {
+                HitObjects = { hitObject }
+            });
+            healthProcessor.Health.Value = startingHealth;
+
+            var result = new JudgementResult(hitObject, hitObject.CreateJudgement());
+            result.Type = result.Judgement.MaxResult;
+            healthProcessor.ApplyResult(result);
+
+            Assert.That(healthProcessor.HasFailed, Is.False);
+        }
     }
 }

From 16d893d40c10542a2502884df95d54773044ffb7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 13 Feb 2024 12:26:37 +0100
Subject: [PATCH 078/930] Fix draining processor failing gameplay on bonus
 misses and ignore hits

---
 osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs | 5 +++++
 osu.Game/Rulesets/Scoring/HealthProcessor.cs         | 9 ++++++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
index 629a84ea62..92a064385b 100644
--- a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
@@ -142,6 +142,11 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
+        protected override bool CanFailOn(JudgementResult result)
+        {
+            return !result.Judgement.MaxResult.IsBonus() && result.Type != HitResult.IgnoreHit;
+        }
+
         protected override void Reset(bool storeResults)
         {
             base.Reset(storeResults);
diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index b5eb755650..ccf53f075a 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Scoring
 
             Health.Value += GetHealthIncreaseFor(result);
 
-            if (meetsAnyFailCondition(result))
+            if (CanFailOn(result) && meetsAnyFailCondition(result))
                 TriggerFailure();
         }
 
@@ -68,6 +68,13 @@ namespace osu.Game.Rulesets.Scoring
         /// <returns>The health increase.</returns>
         protected virtual double GetHealthIncreaseFor(JudgementResult result) => result.HealthIncrease;
 
+        /// <summary>
+        /// Whether a failure can occur on a given <paramref name="result"/>.
+        /// If the return value of this method is <see langword="false"/>, neither <see cref="DefaultFailCondition"/> nor <see cref="FailConditions"/> will be checked
+        /// after this <paramref name="result"/>.
+        /// </summary>
+        protected virtual bool CanFailOn(JudgementResult result) => true;
+
         /// <summary>
         /// The default conditions for failing.
         /// </summary>

From 3d8d0f8430487c4c30e8964f11e52e1a6522f098 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 14 Feb 2024 08:37:20 +0100
Subject: [PATCH 079/930] Update test expectations for catch

---
 osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
index 8c2d1a91ab..d0a8ce4bbc 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             // hitobject, starting HP, fail expected after miss
             [new Fruit(), 0.01, true],
             [new Droplet(), 0.01, true],
-            [new TinyDroplet(), 0, true],
+            [new TinyDroplet(), 0, false],
             [new Banana(), 0, false],
         ];
 

From f53bce8ff785a1c52bcd1bffb365e43287ec8bd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 14 Feb 2024 08:38:39 +0100
Subject: [PATCH 080/930] Fix catch health processor allowing fail on tiny
 droplet

Closes https://github.com/ppy/osu/issues/27159.

In today's episode of "just stable things"...
---
 .../Scoring/CatchHealthProcessor.cs                | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
index c3cc488941..2e1aec0803 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 
@@ -21,6 +22,19 @@ namespace osu.Game.Rulesets.Catch.Scoring
 
         protected override IEnumerable<HitObject> EnumerateNestedHitObjects(HitObject hitObject) => Enumerable.Empty<HitObject>();
 
+        protected override bool CanFailOn(JudgementResult result)
+        {
+            // matches stable.
+            // see: https://github.com/peppy/osu-stable-reference/blob/46cd3a10af7cc6cc96f4eba92ef1812dc8c3a27e/osu!/GameModes/Play/Rulesets/Ruleset.cs#L967
+            // the above early-return skips the failure check at the end of the same method:
+            // https://github.com/peppy/osu-stable-reference/blob/46cd3a10af7cc6cc96f4eba92ef1812dc8c3a27e/osu!/GameModes/Play/Rulesets/Ruleset.cs#L1232
+            // making it impossible to fail on a tiny droplet regardless of result.
+            if (result.Type == HitResult.SmallTickMiss)
+                return false;
+
+            return base.CanFailOn(result);
+        }
+
         protected override double GetHealthIncreaseFor(HitObject hitObject, HitResult result)
         {
             double increase = 0;

From 2c0a5b7ef54169412c805ad4b05ea47cf131c012 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 14 Feb 2024 14:21:48 +0100
Subject: [PATCH 081/930] Fix missing tiny droplet not triggering fail with
 perfect on

Stable does this:

    https://github.com/peppy/osu-stable-reference/blob/46cd3a10af7cc6cc96f4eba92ef1812dc8c3a27e/osu!/GameplayElements/HitObjectManagerFruits.cs#L98-L102

I'd rather not say what I think about it doing that, since it's likely
to be unpublishable, but to approximate that, just make it so that
only the "default fail condition" is beholden to the weird ebbs
and flows of what the ruleset wants. This appears to fix the problem
case and I'm hoping it doesn't break something else but I'm like 50/50
on it happening anyway at this point. Just gotta add tests add nauseam.
---
 .../Scoring/CatchHealthProcessor.cs            |  4 ++--
 .../Scoring/AccumulatingHealthProcessor.cs     |  4 +++-
 .../Scoring/DrainingHealthProcessor.cs         |  7 +++++--
 osu.Game/Rulesets/Scoring/HealthProcessor.cs   | 18 ++++++------------
 4 files changed, 16 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
index 2e1aec0803..2f55f9a85f 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Catch.Scoring
 
         protected override IEnumerable<HitObject> EnumerateNestedHitObjects(HitObject hitObject) => Enumerable.Empty<HitObject>();
 
-        protected override bool CanFailOn(JudgementResult result)
+        protected override bool CheckDefaultFailCondition(JudgementResult result)
         {
             // matches stable.
             // see: https://github.com/peppy/osu-stable-reference/blob/46cd3a10af7cc6cc96f4eba92ef1812dc8c3a27e/osu!/GameModes/Play/Rulesets/Ruleset.cs#L967
@@ -32,7 +32,7 @@ namespace osu.Game.Rulesets.Catch.Scoring
             if (result.Type == HitResult.SmallTickMiss)
                 return false;
 
-            return base.CanFailOn(result);
+            return base.CheckDefaultFailCondition(result);
         }
 
         protected override double GetHealthIncreaseFor(HitObject hitObject, HitResult result)
diff --git a/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs
index 422bf8ea79..bb4c2463a7 100644
--- a/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/AccumulatingHealthProcessor.cs
@@ -1,6 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using osu.Game.Rulesets.Judgements;
+
 namespace osu.Game.Rulesets.Scoring
 {
     /// <summary>
@@ -9,7 +11,7 @@ namespace osu.Game.Rulesets.Scoring
     /// </summary>
     public partial class AccumulatingHealthProcessor : HealthProcessor
     {
-        protected override bool DefaultFailCondition => JudgedHits == MaxHits && Health.Value < requiredHealth;
+        protected override bool CheckDefaultFailCondition(JudgementResult _) => JudgedHits == MaxHits && Health.Value < requiredHealth;
 
         private readonly double requiredHealth;
 
diff --git a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
index 92a064385b..e72a8aaf67 100644
--- a/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/DrainingHealthProcessor.cs
@@ -142,9 +142,12 @@ namespace osu.Game.Rulesets.Scoring
             }
         }
 
-        protected override bool CanFailOn(JudgementResult result)
+        protected override bool CheckDefaultFailCondition(JudgementResult result)
         {
-            return !result.Judgement.MaxResult.IsBonus() && result.Type != HitResult.IgnoreHit;
+            if (result.Judgement.MaxResult.IsBonus() || result.Type == HitResult.IgnoreHit)
+                return false;
+
+            return base.CheckDefaultFailCondition(result);
         }
 
         protected override void Reset(bool storeResults)
diff --git a/osu.Game/Rulesets/Scoring/HealthProcessor.cs b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
index ccf53f075a..9e4c06b783 100644
--- a/osu.Game/Rulesets/Scoring/HealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/HealthProcessor.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Scoring
         public event Func<bool>? Failed;
 
         /// <summary>
-        /// Additional conditions on top of <see cref="DefaultFailCondition"/> that cause a failing state.
+        /// Additional conditions on top of <see cref="CheckDefaultFailCondition"/> that cause a failing state.
         /// </summary>
         public event Func<HealthProcessor, JudgementResult, bool>? FailConditions;
 
@@ -50,7 +50,7 @@ namespace osu.Game.Rulesets.Scoring
 
             Health.Value += GetHealthIncreaseFor(result);
 
-            if (CanFailOn(result) && meetsAnyFailCondition(result))
+            if (meetsAnyFailCondition(result))
                 TriggerFailure();
         }
 
@@ -69,16 +69,10 @@ namespace osu.Game.Rulesets.Scoring
         protected virtual double GetHealthIncreaseFor(JudgementResult result) => result.HealthIncrease;
 
         /// <summary>
-        /// Whether a failure can occur on a given <paramref name="result"/>.
-        /// If the return value of this method is <see langword="false"/>, neither <see cref="DefaultFailCondition"/> nor <see cref="FailConditions"/> will be checked
-        /// after this <paramref name="result"/>.
+        /// Checks whether the default conditions for failing are met.
         /// </summary>
-        protected virtual bool CanFailOn(JudgementResult result) => true;
-
-        /// <summary>
-        /// The default conditions for failing.
-        /// </summary>
-        protected virtual bool DefaultFailCondition => Precision.AlmostBigger(Health.MinValue, Health.Value);
+        /// <returns><see langword="true"/> if failure should be invoked.</returns>
+        protected virtual bool CheckDefaultFailCondition(JudgementResult result) => Precision.AlmostBigger(Health.MinValue, Health.Value);
 
         /// <summary>
         /// Whether the current state of <see cref="HealthProcessor"/> or the provided <paramref name="result"/> meets any fail condition.
@@ -86,7 +80,7 @@ namespace osu.Game.Rulesets.Scoring
         /// <param name="result">The judgement result.</param>
         private bool meetsAnyFailCondition(JudgementResult result)
         {
-            if (DefaultFailCondition)
+            if (CheckDefaultFailCondition(result))
                 return true;
 
             if (FailConditions != null)

From cd8ac6a722124e7827f2a8ee0ef39ef2ab41a932 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sat, 17 Feb 2024 22:12:15 +0200
Subject: [PATCH 082/930] Update BeatmapAttributesDisplay.cs

---
 .../Overlays/Mods/BeatmapAttributesDisplay.cs   | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index b9e4896b21..9312940001 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -19,6 +19,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Online.Rooms;
 using osuTK;
 
 namespace osu.Game.Overlays.Mods
@@ -42,6 +43,9 @@ namespace osu.Game.Overlays.Mods
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
 
+        [Resolved(CanBeNull = true)]
+        private IBindable<PlaylistItem>? selectedItem { get; set; }
+
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
         private ModSettingChangeTracker? modSettingChangeTracker;
@@ -108,6 +112,8 @@ namespace osu.Game.Overlays.Mods
                 updateValues();
             }, true);
 
+            selectedItem?.BindValueChanged(_ => mods.TriggerChange());
+
             BeatmapInfo.BindValueChanged(_ => updateValues(), true);
 
             Collapsed.BindValueChanged(_ =>
@@ -164,10 +170,20 @@ namespace osu.Game.Overlays.Mods
                     starRatingDisplay.FinishTransforms(true);
             });
 
+            Ruleset ruleset = gameRuleset.Value.CreateInstance();
+
             double rate = 1;
             foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                 rate = mod.ApplyToRate(0, rate);
 
+            if (selectedItem != null && selectedItem.Value != null)
+            {
+                var globalMods = selectedItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in globalMods.OfType<IApplicableToRate>())
+                    rate = mod.ApplyToRate(0, rate);
+            }
+
             bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
 
             BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value.Difficulty);
@@ -175,7 +191,6 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in mods.Value.OfType<IApplicableToDifficulty>())
                 mod.ApplyToDifficulty(originalDifficulty);
 
-            Ruleset ruleset = gameRuleset.Value.CreateInstance();
             BeatmapDifficulty adjustedDifficulty = ruleset.GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
 
             TooltipContent = new AdjustedAttributesTooltip.Data(originalDifficulty, adjustedDifficulty);

From ed819fde1589bc0cc6167b4610c5a115e49fc844 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sat, 17 Feb 2024 23:01:31 +0200
Subject: [PATCH 083/930] Fixed bugs and added ranked status update

---
 .../Overlays/Mods/BeatmapAttributesDisplay.cs | 32 ++++++++++++-------
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 32 +++++++++++++++++--
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  3 +-
 3 files changed, 52 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 9312940001..da14382175 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -40,11 +40,16 @@ namespace osu.Game.Overlays.Mods
 
         public Bindable<IBeatmapInfo?> BeatmapInfo { get; } = new Bindable<IBeatmapInfo?>();
 
+        /// <summary>
+        /// Should attribute display account for the multiplayer room global mods.
+        /// </summary>
+        public bool AccountForMultiplayerMods = false;
+
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
 
         [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? selectedItem { get; set; }
+        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
@@ -112,7 +117,7 @@ namespace osu.Game.Overlays.Mods
                 updateValues();
             }, true);
 
-            selectedItem?.BindValueChanged(_ => mods.TriggerChange());
+            multiplayerRoomItem?.BindValueChanged(_ => mods.TriggerChange());
 
             BeatmapInfo.BindValueChanged(_ => updateValues(), true);
 
@@ -176,23 +181,26 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                 rate = mod.ApplyToRate(0, rate);
 
-            if (selectedItem != null && selectedItem.Value != null)
-            {
-                var globalMods = selectedItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-
-                foreach (var mod in globalMods.OfType<IApplicableToRate>())
-                    rate = mod.ApplyToRate(0, rate);
-            }
-
-            bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
-
             BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value.Difficulty);
 
             foreach (var mod in mods.Value.OfType<IApplicableToDifficulty>())
                 mod.ApplyToDifficulty(originalDifficulty);
 
+            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            {
+                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
+                    rate = mod.ApplyToRate(0, rate);
+
+                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
+                    mod.ApplyToDifficulty(originalDifficulty);
+            }
+
             BeatmapDifficulty adjustedDifficulty = ruleset.GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
 
+            bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
+
             TooltipContent = new AdjustedAttributesTooltip.Data(originalDifficulty, adjustedDifficulty);
 
             approachRateDisplay.AdjustType.Value = VerticalAttributeDisplay.CalculateEffect(originalDifficulty.ApproachRate, adjustedDifficulty.ApproachRate);
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ddf96c1cb3..0804624ed8 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -25,7 +25,9 @@ using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Online.Rooms;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
@@ -42,6 +44,12 @@ namespace osu.Game.Overlays.Mods
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
+        [Resolved(CanBeNull = true)]
+        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+
+        [Resolved]
+        private OsuGameBase game { get; set; } = null!;
+
         /// <summary>
         /// Contains a dictionary with the current <see cref="ModState"/> of all mods applicable for the current ruleset.
         /// </summary>
@@ -92,6 +100,11 @@ namespace osu.Game.Overlays.Mods
         /// </summary>
         protected virtual bool ShowPresets => false;
 
+        /// <summary>
+        /// Should overlay account for the multiplayer room global mods.
+        /// </summary>
+        public bool AccountForMultiplayerMods = false;
+
         protected virtual ModColumn CreateModColumn(ModType modType) => new ModColumn(modType, false);
 
         protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
@@ -278,7 +291,8 @@ namespace osu.Game.Overlays.Mods
                         {
                             Anchor = Anchor.BottomRight,
                             Origin = Anchor.BottomRight,
-                            BeatmapInfo = { Value = beatmap?.BeatmapInfo }
+                            BeatmapInfo = { Value = beatmap?.BeatmapInfo },
+                            AccountForMultiplayerMods = AccountForMultiplayerMods
                         },
                     }
                 });
@@ -332,6 +346,8 @@ namespace osu.Game.Overlays.Mods
                 }
             }, true);
 
+            multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
+
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
             SearchTextBox.Current.BindValueChanged(query =>
@@ -460,8 +476,20 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in SelectedMods.Value)
                 multiplier *= mod.ScoreMultiplier;
 
-            rankingInformationDisplay.ModMultiplier.Value = multiplier;
             rankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
+
+            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            {
+                Ruleset ruleset = game.Ruleset.Value.CreateInstance();
+                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in multiplayerRoomMods)
+                    multiplier *= mod.ScoreMultiplier;
+
+                rankingInformationDisplay.Ranked.Value = rankingInformationDisplay.Ranked.Value && multiplayerRoomMods.All(m => m.Ranked);
+            }
+
+            rankingInformationDisplay.ModMultiplier.Value = multiplier;
         }
 
         private void updateCustomisation()
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 4c0219eff5..71f8bfa0f4 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -244,7 +244,8 @@ namespace osu.Game.Screens.OnlinePlay.Match
             LoadComponent(UserModsSelectOverlay = new UserModSelectOverlay(OverlayColourScheme.Plum)
             {
                 SelectedMods = { BindTarget = UserMods },
-                IsValidMod = _ => false
+                IsValidMod = _ => false,
+                AccountForMultiplayerMods = true
             });
         }
 

From 2df5787dc7e46ea573bbbd4c1608cf18564029d0 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:13:57 +0200
Subject: [PATCH 084/930] Packed changes into separate class

---
 .../Overlays/Mods/BeatmapAttributesDisplay.cs |  58 ++++-----
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    |  66 +++-------
 .../Mods/MultiplayerModSelectOverlay.cs       | 118 ++++++++++++++++++
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |   5 +-
 4 files changed, 166 insertions(+), 81 deletions(-)
 create mode 100644 osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index da14382175..93e7e0ae9c 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -46,10 +46,7 @@ namespace osu.Game.Overlays.Mods
         public bool AccountForMultiplayerMods = false;
 
         [Resolved]
-        private Bindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
-
-        [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+        protected Bindable<IReadOnlyList<Mod>> Mods { get; private set; } = null!;
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
@@ -61,7 +58,7 @@ namespace osu.Game.Overlays.Mods
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
-        private IBindable<RulesetInfo> gameRuleset = null!;
+        protected IBindable<RulesetInfo> GameRuleset = null!;
 
         private CancellationTokenSource? cancellationSource;
         private IBindable<StarDifficulty?> starDifficulty = null!;
@@ -109,16 +106,14 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            mods.BindValueChanged(_ =>
+            Mods.BindValueChanged(_ =>
             {
                 modSettingChangeTracker?.Dispose();
-                modSettingChangeTracker = new ModSettingChangeTracker(mods.Value);
+                modSettingChangeTracker = new ModSettingChangeTracker(Mods.Value);
                 modSettingChangeTracker.SettingChanged += _ => updateValues();
                 updateValues();
             }, true);
 
-            multiplayerRoomItem?.BindValueChanged(_ => mods.TriggerChange());
-
             BeatmapInfo.BindValueChanged(_ => updateValues(), true);
 
             Collapsed.BindValueChanged(_ =>
@@ -128,8 +123,8 @@ namespace osu.Game.Overlays.Mods
                 updateCollapsedState();
             });
 
-            gameRuleset = game.Ruleset.GetBoundCopy();
-            gameRuleset.BindValueChanged(_ => updateValues());
+            GameRuleset = game.Ruleset.GetBoundCopy();
+            GameRuleset.BindValueChanged(_ => updateValues());
 
             BeatmapInfo.BindValueChanged(_ => updateValues(), true);
 
@@ -159,6 +154,23 @@ namespace osu.Game.Overlays.Mods
             LeftContent.AutoSizeDuration = Content.AutoSizeDuration = transition_duration;
         }
 
+        protected virtual double GetRate()
+        {
+            double rate = 1;
+            foreach (var mod in Mods.Value.OfType<IApplicableToRate>())
+                rate = mod.ApplyToRate(0, rate);
+            return rate;
+        }
+
+        protected virtual BeatmapDifficulty GetDifficulty()
+        {
+            BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value!.Difficulty);
+
+            foreach (var mod in Mods.Value.OfType<IApplicableToDifficulty>())
+                mod.ApplyToDifficulty(originalDifficulty);
+
+            return originalDifficulty;
+        }
         private void updateValues() => Scheduler.AddOnce(() =>
         {
             if (BeatmapInfo.Value == null)
@@ -175,28 +187,10 @@ namespace osu.Game.Overlays.Mods
                     starRatingDisplay.FinishTransforms(true);
             });
 
-            Ruleset ruleset = gameRuleset.Value.CreateInstance();
-
-            double rate = 1;
-            foreach (var mod in mods.Value.OfType<IApplicableToRate>())
-                rate = mod.ApplyToRate(0, rate);
-
-            BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value.Difficulty);
-
-            foreach (var mod in mods.Value.OfType<IApplicableToDifficulty>())
-                mod.ApplyToDifficulty(originalDifficulty);
-
-            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
-            {
-                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-
-                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
-                    rate = mod.ApplyToRate(0, rate);
-
-                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
-                    mod.ApplyToDifficulty(originalDifficulty);
-            }
+            double rate = GetRate();
+            BeatmapDifficulty originalDifficulty = GetDifficulty();
 
+            Ruleset ruleset = GameRuleset.Value.CreateInstance();
             BeatmapDifficulty adjustedDifficulty = ruleset.GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
 
             bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 0804624ed8..12719475a8 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -25,9 +25,7 @@ using osu.Game.Graphics.Cursor;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Online.Rooms;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
@@ -44,11 +42,6 @@ namespace osu.Game.Overlays.Mods
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-        [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
-
-        [Resolved]
-        private OsuGameBase game { get; set; } = null!;
 
         /// <summary>
         /// Contains a dictionary with the current <see cref="ModState"/> of all mods applicable for the current ruleset.
@@ -100,11 +93,6 @@ namespace osu.Game.Overlays.Mods
         /// </summary>
         protected virtual bool ShowPresets => false;
 
-        /// <summary>
-        /// Should overlay account for the multiplayer room global mods.
-        /// </summary>
-        public bool AccountForMultiplayerMods = false;
-
         protected virtual ModColumn CreateModColumn(ModType modType) => new ModColumn(modType, false);
 
         protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
@@ -138,8 +126,14 @@ namespace osu.Game.Overlays.Mods
         private DeselectAllModsButton deselectAllModsButton = null!;
 
         private Container aboveColumnsContent = null!;
-        private RankingInformationDisplay? rankingInformationDisplay;
-        private BeatmapAttributesDisplay? beatmapAttributesDisplay;
+        protected RankingInformationDisplay? RankingInformationDisplay;
+        protected BeatmapAttributesDisplay? BeatmapAttributesDisplay;
+        protected virtual BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new BeatmapAttributesDisplay
+        {
+            Anchor = Anchor.BottomRight,
+            Origin = Anchor.BottomRight,
+            BeatmapInfo = { Value = Beatmap?.BeatmapInfo }
+        };
 
         protected ShearedButton BackButton { get; private set; } = null!;
         protected ShearedToggleButton? CustomisationButton { get; private set; }
@@ -159,8 +153,8 @@ namespace osu.Game.Overlays.Mods
                 if (beatmap == value) return;
 
                 beatmap = value;
-                if (IsLoaded && beatmapAttributesDisplay != null)
-                    beatmapAttributesDisplay.BeatmapInfo.Value = beatmap?.BeatmapInfo;
+                if (IsLoaded && BeatmapAttributesDisplay != null)
+                    BeatmapAttributesDisplay.BeatmapInfo.Value = beatmap?.BeatmapInfo;
             }
         }
 
@@ -282,18 +276,12 @@ namespace osu.Game.Overlays.Mods
                     },
                     Children = new Drawable[]
                     {
-                        rankingInformationDisplay = new RankingInformationDisplay
+                        RankingInformationDisplay = new RankingInformationDisplay
                         {
                             Anchor = Anchor.BottomRight,
                             Origin = Anchor.BottomRight
                         },
-                        beatmapAttributesDisplay = new BeatmapAttributesDisplay
-                        {
-                            Anchor = Anchor.BottomRight,
-                            Origin = Anchor.BottomRight,
-                            BeatmapInfo = { Value = beatmap?.BeatmapInfo },
-                            AccountForMultiplayerMods = AccountForMultiplayerMods
-                        },
+                        BeatmapAttributesDisplay = GetBeatmapAttributesDisplay
                     }
                 });
             }
@@ -329,7 +317,7 @@ namespace osu.Game.Overlays.Mods
 
             SelectedMods.BindValueChanged(_ =>
             {
-                updateRankingInformation();
+                UpdateRankingInformation();
                 updateFromExternalSelection();
                 updateCustomisation();
 
@@ -342,12 +330,10 @@ namespace osu.Game.Overlays.Mods
                     //
                     // See https://github.com/ppy/osu/pull/23284#issuecomment-1529056988
                     modSettingChangeTracker = new ModSettingChangeTracker(SelectedMods.Value);
-                    modSettingChangeTracker.SettingChanged += _ => updateRankingInformation();
+                    modSettingChangeTracker.SettingChanged += _ => UpdateRankingInformation();
                 }
             }, true);
 
-            multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
-
             customisationVisible.BindValueChanged(_ => updateCustomisationVisualState(), true);
 
             SearchTextBox.Current.BindValueChanged(query =>
@@ -371,7 +357,7 @@ namespace osu.Game.Overlays.Mods
 
             SearchTextBox.PlaceholderText = SearchTextBox.HasFocus ? Resources.Localisation.Web.CommonStrings.InputSearch : ModSelectOverlayStrings.TabToSearch;
 
-            if (beatmapAttributesDisplay != null)
+            if (BeatmapAttributesDisplay != null)
             {
                 float rightEdgeOfLastButton = footerButtonFlow.Last().ScreenSpaceDrawQuad.TopRight.X;
 
@@ -383,7 +369,7 @@ namespace osu.Game.Overlays.Mods
 
                 // only update preview panel's collapsed state after we are fully visible, to ensure all the buttons are where we expect them to be.
                 if (Alpha == 1)
-                    beatmapAttributesDisplay.Collapsed.Value = screenIsntWideEnough;
+                    BeatmapAttributesDisplay.Collapsed.Value = screenIsntWideEnough;
 
                 footerContentFlow.LayoutDuration = 200;
                 footerContentFlow.LayoutEasing = Easing.OutQuint;
@@ -466,9 +452,9 @@ namespace osu.Game.Overlays.Mods
                 modState.ValidForSelection.Value = modState.Mod.Type != ModType.System && modState.Mod.HasImplementation && IsValidMod.Invoke(modState.Mod);
         }
 
-        private void updateRankingInformation()
+        protected virtual void UpdateRankingInformation()
         {
-            if (rankingInformationDisplay == null)
+            if (RankingInformationDisplay == null)
                 return;
 
             double multiplier = 1.0;
@@ -476,20 +462,8 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in SelectedMods.Value)
                 multiplier *= mod.ScoreMultiplier;
 
-            rankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
-
-            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
-            {
-                Ruleset ruleset = game.Ruleset.Value.CreateInstance();
-                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-
-                foreach (var mod in multiplayerRoomMods)
-                    multiplier *= mod.ScoreMultiplier;
-
-                rankingInformationDisplay.Ranked.Value = rankingInformationDisplay.Ranked.Value && multiplayerRoomMods.All(m => m.Ranked);
-            }
-
-            rankingInformationDisplay.ModMultiplier.Value = multiplier;
+            RankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
+            RankingInformationDisplay.ModMultiplier.Value = multiplier;
         }
 
         private void updateCustomisation()
diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
new file mode 100644
index 0000000000..ca1df31271
--- /dev/null
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -0,0 +1,118 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Game.Rulesets;
+using osu.Game.Online.Rooms;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
+
+namespace osu.Game.Overlays.Mods
+{
+    public partial class MultiplayerModSelectOverlay : UserModSelectOverlay
+    {
+        public MultiplayerModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Plum)
+            : base(colourScheme)
+        {
+        }
+
+        [Resolved(CanBeNull = true)]
+        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+
+        [Resolved]
+        private OsuGameBase game { get; set; } = null!;
+
+        protected override BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new MultiplayerBeatmapAttributesDisplay
+        {
+            Anchor = Anchor.BottomRight,
+            Origin = Anchor.BottomRight,
+            BeatmapInfo = { Value = Beatmap?.BeatmapInfo },
+            AccountForMultiplayerMods = true
+        };
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
+        }
+
+        protected override void UpdateRankingInformation()
+        {
+            if (RankingInformationDisplay == null)
+                return;
+
+            double multiplier = 1.0;
+
+            foreach (var mod in SelectedMods.Value)
+                multiplier *= mod.ScoreMultiplier;
+
+            RankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
+
+            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            {
+                Ruleset ruleset = game.Ruleset.Value.CreateInstance();
+                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in multiplayerRoomMods)
+                    multiplier *= mod.ScoreMultiplier;
+
+                RankingInformationDisplay.Ranked.Value = RankingInformationDisplay.Ranked.Value && multiplayerRoomMods.All(m => m.Ranked);
+            }
+
+            RankingInformationDisplay.ModMultiplier.Value = multiplier;
+        }
+    }
+
+    public partial class MultiplayerBeatmapAttributesDisplay : BeatmapAttributesDisplay
+    {
+        public MultiplayerBeatmapAttributesDisplay()
+            : base()
+        {
+        }
+
+        [Resolved(CanBeNull = true)]
+        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            multiplayerRoomItem?.BindValueChanged(_ => Mods.TriggerChange());
+        }
+
+        protected override double GetRate()
+        {
+            double rate = base.GetRate();
+            Ruleset ruleset = GameRuleset.Value.CreateInstance();
+
+            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            {
+                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
+                    rate = mod.ApplyToRate(0, rate);
+            }
+
+            return rate;
+        }
+
+        protected override BeatmapDifficulty GetDifficulty()
+        {
+            BeatmapDifficulty originalDifficulty = base.GetDifficulty();
+            Ruleset ruleset = GameRuleset.Value.CreateInstance();
+
+            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            {
+                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+
+                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
+                    mod.ApplyToDifficulty(originalDifficulty);
+            }
+
+            return originalDifficulty;
+        }
+    }
+}
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index 71f8bfa0f4..fbc06cce9e 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -241,11 +241,10 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 }
             };
 
-            LoadComponent(UserModsSelectOverlay = new UserModSelectOverlay(OverlayColourScheme.Plum)
+            LoadComponent(UserModsSelectOverlay = new MultiplayerModSelectOverlay()
             {
                 SelectedMods = { BindTarget = UserMods },
-                IsValidMod = _ => false,
-                AccountForMultiplayerMods = true
+                IsValidMod = _ => false
             });
         }
 

From 6fb3192648f723af818322021ac5cd5cc5743ad7 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:14:36 +0200
Subject: [PATCH 085/930] Update BeatmapAttributesDisplay.cs

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 93e7e0ae9c..849444fa32 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -40,11 +40,6 @@ namespace osu.Game.Overlays.Mods
 
         public Bindable<IBeatmapInfo?> BeatmapInfo { get; } = new Bindable<IBeatmapInfo?>();
 
-        /// <summary>
-        /// Should attribute display account for the multiplayer room global mods.
-        /// </summary>
-        public bool AccountForMultiplayerMods = false;
-
         [Resolved]
         protected Bindable<IReadOnlyList<Mod>> Mods { get; private set; } = null!;
 

From 4aaf016ee0ad4ff8eaebbbd207d7617e3d60a14b Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:15:53 +0200
Subject: [PATCH 086/930] quality improvements

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs    |  2 --
 osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs | 11 ++---------
 2 files changed, 2 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 849444fa32..7517a502c7 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -160,10 +160,8 @@ namespace osu.Game.Overlays.Mods
         protected virtual BeatmapDifficulty GetDifficulty()
         {
             BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value!.Difficulty);
-
             foreach (var mod in Mods.Value.OfType<IApplicableToDifficulty>())
                 mod.ApplyToDifficulty(originalDifficulty);
-
             return originalDifficulty;
         }
         private void updateValues() => Scheduler.AddOnce(() =>
diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
index ca1df31271..ab20e9dc89 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -29,8 +29,7 @@ namespace osu.Game.Overlays.Mods
         {
             Anchor = Anchor.BottomRight,
             Origin = Anchor.BottomRight,
-            BeatmapInfo = { Value = Beatmap?.BeatmapInfo },
-            AccountForMultiplayerMods = true
+            BeatmapInfo = { Value = Beatmap?.BeatmapInfo }
         };
 
         protected override void LoadComplete()
@@ -87,15 +86,12 @@ namespace osu.Game.Overlays.Mods
         {
             double rate = base.GetRate();
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
-
-            if (AccountForMultiplayerMods && multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
             {
                 var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-
                 foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
                     rate = mod.ApplyToRate(0, rate);
             }
-
             return rate;
         }
 
@@ -103,15 +99,12 @@ namespace osu.Game.Overlays.Mods
         {
             BeatmapDifficulty originalDifficulty = base.GetDifficulty();
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
-
             if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
             {
                 var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-
                 foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
                     mod.ApplyToDifficulty(originalDifficulty);
             }
-
             return originalDifficulty;
         }
     }

From 9070e973d3bf7a54dae89a8acd14acf16cdfe69c Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:16:18 +0200
Subject: [PATCH 087/930] Update BeatmapAttributesDisplay.cs

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 7517a502c7..08e124d8ac 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -19,7 +19,6 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Online.Rooms;
 using osuTK;
 
 namespace osu.Game.Overlays.Mods

From a6b63efe7d695354e4ddddb6a7143667fe56e646 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:28:24 +0200
Subject: [PATCH 088/930] Fixed NVika code quality errors

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs    | 1 +
 osu.Game/Overlays/Mods/ModSelectOverlay.cs            | 2 +-
 osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs | 8 ++++++--
 osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs    | 2 +-
 4 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 08e124d8ac..f010725c8b 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -163,6 +163,7 @@ namespace osu.Game.Overlays.Mods
                 mod.ApplyToDifficulty(originalDifficulty);
             return originalDifficulty;
         }
+
         private void updateValues() => Scheduler.AddOnce(() =>
         {
             if (BeatmapInfo.Value == null)
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 12719475a8..e29e685ece 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -42,7 +42,6 @@ namespace osu.Game.Overlays.Mods
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
-
         /// <summary>
         /// Contains a dictionary with the current <see cref="ModState"/> of all mods applicable for the current ruleset.
         /// </summary>
@@ -128,6 +127,7 @@ namespace osu.Game.Overlays.Mods
         private Container aboveColumnsContent = null!;
         protected RankingInformationDisplay? RankingInformationDisplay;
         protected BeatmapAttributesDisplay? BeatmapAttributesDisplay;
+
         protected virtual BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new BeatmapAttributesDisplay
         {
             Anchor = Anchor.BottomRight,
diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
index ab20e9dc89..b399b6b878 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -86,12 +86,14 @@ namespace osu.Game.Overlays.Mods
         {
             double rate = base.GetRate();
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
-            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+
+            if (multiplayerRoomItem?.Value != null)
             {
                 var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
                 foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
                     rate = mod.ApplyToRate(0, rate);
             }
+
             return rate;
         }
 
@@ -99,12 +101,14 @@ namespace osu.Game.Overlays.Mods
         {
             BeatmapDifficulty originalDifficulty = base.GetDifficulty();
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
-            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+
+            if (multiplayerRoomItem?.Value != null)
             {
                 var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
                 foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
                     mod.ApplyToDifficulty(originalDifficulty);
             }
+
             return originalDifficulty;
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index fbc06cce9e..b20760b114 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 }
             };
 
-            LoadComponent(UserModsSelectOverlay = new MultiplayerModSelectOverlay()
+            LoadComponent(UserModsSelectOverlay = new MultiplayerModSelectOverlay
             {
                 SelectedMods = { BindTarget = UserMods },
                 IsValidMod = _ => false

From 24171bd02bf608fdee7b3c39dfecfba11968647e Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sun, 18 Feb 2024 03:34:02 +0200
Subject: [PATCH 089/930] Update MultiplayerModSelectOverlay.cs

---
 osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
index b399b6b878..78978e25e7 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Overlays.Mods
 
             RankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
 
-            if (multiplayerRoomItem != null && multiplayerRoomItem.Value != null)
+            if (multiplayerRoomItem?.Value != null)
             {
                 Ruleset ruleset = game.Ruleset.Value.CreateInstance();
                 var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
@@ -68,11 +68,6 @@ namespace osu.Game.Overlays.Mods
 
     public partial class MultiplayerBeatmapAttributesDisplay : BeatmapAttributesDisplay
     {
-        public MultiplayerBeatmapAttributesDisplay()
-            : base()
-        {
-        }
-
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
 

From c6ca812ea07eb9fdfc24038e05f4b485e9501775 Mon Sep 17 00:00:00 2001
From: Brandon <brandondong96@gmail.com>
Date: Sun, 18 Feb 2024 21:52:23 -0800
Subject: [PATCH 090/930] Add feedback to delete button even when no-op

---
 osu.Game/Beatmaps/BeatmapManager.cs | 11 +++++++++--
 osu.Game/Database/ModelManager.cs   | 14 ++++++++++++--
 2 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 1f551f1218..3aed15029d 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -361,13 +361,20 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public void DeleteVideos(List<BeatmapSetInfo> items, bool silent = false)
         {
-            if (items.Count == 0) return;
+            var noVideosMessage = "No videos found to delete!";
+
+            if (items.Count == 0)
+            {
+                if (!silent)
+                    PostNotification?.Invoke(new ProgressCompletionNotification { Text = noVideosMessage });
+                return;
+            }
 
             var notification = new ProgressNotification
             {
                 Progress = 0,
                 Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = "No videos found to delete!",
+                CompletionText = noVideosMessage,
                 State = ProgressNotificationState.Active,
             };
 
diff --git a/osu.Game/Database/ModelManager.cs b/osu.Game/Database/ModelManager.cs
index 39dae61d36..7a5fb5efbf 100644
--- a/osu.Game/Database/ModelManager.cs
+++ b/osu.Game/Database/ModelManager.cs
@@ -105,7 +105,12 @@ namespace osu.Game.Database
         /// </summary>
         public void Delete(List<TModel> items, bool silent = false)
         {
-            if (items.Count == 0) return;
+            if (items.Count == 0)
+            {
+                if (!silent)
+                    PostNotification?.Invoke(new ProgressCompletionNotification { Text = $"No {HumanisedModelName}s found to delete!" });
+                return;
+            }
 
             var notification = new ProgressNotification
             {
@@ -142,7 +147,12 @@ namespace osu.Game.Database
         /// </summary>
         public void Undelete(List<TModel> items, bool silent = false)
         {
-            if (!items.Any()) return;
+            if (!items.Any())
+            {
+                if (!silent)
+                    PostNotification?.Invoke(new ProgressCompletionNotification { Text = $"No {HumanisedModelName}s found to restore!" });
+                return;
+            }
 
             var notification = new ProgressNotification
             {

From 413b7aab602bcd6b4f60265fe893bc88c23b63e8 Mon Sep 17 00:00:00 2001
From: Brandon <brandondong96@gmail.com>
Date: Sun, 18 Feb 2024 22:12:03 -0800
Subject: [PATCH 091/930] Switch to const string

---
 osu.Game/Beatmaps/BeatmapManager.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/BeatmapManager.cs b/osu.Game/Beatmaps/BeatmapManager.cs
index 3aed15029d..0610f7f6fb 100644
--- a/osu.Game/Beatmaps/BeatmapManager.cs
+++ b/osu.Game/Beatmaps/BeatmapManager.cs
@@ -361,12 +361,12 @@ namespace osu.Game.Beatmaps
         /// </summary>
         public void DeleteVideos(List<BeatmapSetInfo> items, bool silent = false)
         {
-            var noVideosMessage = "No videos found to delete!";
+            const string no_videos_message = "No videos found to delete!";
 
             if (items.Count == 0)
             {
                 if (!silent)
-                    PostNotification?.Invoke(new ProgressCompletionNotification { Text = noVideosMessage });
+                    PostNotification?.Invoke(new ProgressCompletionNotification { Text = no_videos_message });
                 return;
             }
 
@@ -374,7 +374,7 @@ namespace osu.Game.Beatmaps
             {
                 Progress = 0,
                 Text = $"Preparing to delete all {HumanisedModelName} videos...",
-                CompletionText = noVideosMessage,
+                CompletionText = no_videos_message,
                 State = ProgressNotificationState.Active,
             };
 

From 24e3fe79a4554b45b9176411402928c35214e172 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 19 Feb 2024 17:02:53 +0100
Subject: [PATCH 092/930] Log `GlobalStatistics` when exporting logs from
 settings

---
 osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
index fe88413e6a..82cc952e53 100644
--- a/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/General/UpdateSettings.cs
@@ -10,6 +10,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Framework.Screens;
+using osu.Framework.Statistics;
 using osu.Game.Configuration;
 using osu.Game.Localisation;
 using osu.Game.Overlays.Notifications;
@@ -107,6 +108,9 @@ namespace osu.Game.Overlays.Settings.Sections.General
 
             try
             {
+                GlobalStatistics.OutputToLog();
+                Logger.Flush();
+
                 var logStorage = Logger.Storage;
 
                 using (var outStream = storage.CreateFileSafely(archive_filename))

From 54ef397d56c0499ceb568b2b867978a94b6b98bd Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Tue, 20 Feb 2024 12:57:28 +0200
Subject: [PATCH 093/930] Changed override method

now it overrides mods getter instead of calculate fuctions
---
 .../Overlays/Mods/BeatmapAttributesDisplay.cs | 31 +++------
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 12 ++--
 .../Mods/MultiplayerModSelectOverlay.cs       | 68 +++++++------------
 3 files changed, 41 insertions(+), 70 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index f010725c8b..21b3a7faa9 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Overlays.Mods
 
         [Resolved]
         protected Bindable<IReadOnlyList<Mod>> Mods { get; private set; } = null!;
+        protected virtual IEnumerable<Mod> SelectedMods => Mods.Value;
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
@@ -148,22 +149,6 @@ namespace osu.Game.Overlays.Mods
             LeftContent.AutoSizeDuration = Content.AutoSizeDuration = transition_duration;
         }
 
-        protected virtual double GetRate()
-        {
-            double rate = 1;
-            foreach (var mod in Mods.Value.OfType<IApplicableToRate>())
-                rate = mod.ApplyToRate(0, rate);
-            return rate;
-        }
-
-        protected virtual BeatmapDifficulty GetDifficulty()
-        {
-            BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value!.Difficulty);
-            foreach (var mod in Mods.Value.OfType<IApplicableToDifficulty>())
-                mod.ApplyToDifficulty(originalDifficulty);
-            return originalDifficulty;
-        }
-
         private void updateValues() => Scheduler.AddOnce(() =>
         {
             if (BeatmapInfo.Value == null)
@@ -180,14 +165,20 @@ namespace osu.Game.Overlays.Mods
                     starRatingDisplay.FinishTransforms(true);
             });
 
-            double rate = GetRate();
-            BeatmapDifficulty originalDifficulty = GetDifficulty();
+            double rate = 1;
+            foreach (var mod in SelectedMods.OfType<IApplicableToRate>())
+                rate = mod.ApplyToRate(0, rate);
+
+            bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
+
+            BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value.Difficulty);
+
+            foreach (var mod in SelectedMods.OfType<IApplicableToDifficulty>())
+                mod.ApplyToDifficulty(originalDifficulty);
 
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
             BeatmapDifficulty adjustedDifficulty = ruleset.GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
 
-            bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
-
             TooltipContent = new AdjustedAttributesTooltip.Data(originalDifficulty, adjustedDifficulty);
 
             approachRateDisplay.AdjustType.Value = VerticalAttributeDisplay.CalculateEffect(originalDifficulty.ApproachRate, adjustedDifficulty.ApproachRate);
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index e29e685ece..f374828a4a 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -114,6 +114,8 @@ namespace osu.Game.Overlays.Mods
 
         public IEnumerable<ModState> AllAvailableMods => AvailableMods.Value.SelectMany(pair => pair.Value);
 
+        protected virtual IEnumerable<Mod> AllSelectedMods => SelectedMods.Value;
+
         private readonly BindableBool customisationVisible = new BindableBool();
         private Bindable<bool> textSearchStartsActive = null!;
 
@@ -317,7 +319,7 @@ namespace osu.Game.Overlays.Mods
 
             SelectedMods.BindValueChanged(_ =>
             {
-                UpdateRankingInformation();
+                updateRankingInformation();
                 updateFromExternalSelection();
                 updateCustomisation();
 
@@ -330,7 +332,7 @@ namespace osu.Game.Overlays.Mods
                     //
                     // See https://github.com/ppy/osu/pull/23284#issuecomment-1529056988
                     modSettingChangeTracker = new ModSettingChangeTracker(SelectedMods.Value);
-                    modSettingChangeTracker.SettingChanged += _ => UpdateRankingInformation();
+                    modSettingChangeTracker.SettingChanged += _ => updateRankingInformation();
                 }
             }, true);
 
@@ -452,17 +454,17 @@ namespace osu.Game.Overlays.Mods
                 modState.ValidForSelection.Value = modState.Mod.Type != ModType.System && modState.Mod.HasImplementation && IsValidMod.Invoke(modState.Mod);
         }
 
-        protected virtual void UpdateRankingInformation()
+        private void updateRankingInformation()
         {
             if (RankingInformationDisplay == null)
                 return;
 
             double multiplier = 1.0;
 
-            foreach (var mod in SelectedMods.Value)
+            foreach (var mod in AllSelectedMods)
                 multiplier *= mod.ScoreMultiplier;
 
-            RankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
+            RankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
             RankingInformationDisplay.ModMultiplier.Value = multiplier;
         }
 
diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
index 78978e25e7..d546392650 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -1,13 +1,13 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets;
 using osu.Game.Online.Rooms;
-using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Overlays.Mods
@@ -39,30 +39,21 @@ namespace osu.Game.Overlays.Mods
             multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
         }
 
-        protected override void UpdateRankingInformation()
+        protected override IEnumerable<Mod> AllSelectedMods
         {
-            if (RankingInformationDisplay == null)
-                return;
-
-            double multiplier = 1.0;
-
-            foreach (var mod in SelectedMods.Value)
-                multiplier *= mod.ScoreMultiplier;
-
-            RankingInformationDisplay.Ranked.Value = SelectedMods.Value.All(m => m.Ranked);
-
-            if (multiplayerRoomItem?.Value != null)
+            get
             {
-                Ruleset ruleset = game.Ruleset.Value.CreateInstance();
-                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+                IEnumerable<Mod> allMods = SelectedMods.Value;
 
-                foreach (var mod in multiplayerRoomMods)
-                    multiplier *= mod.ScoreMultiplier;
+                if (multiplayerRoomItem?.Value != null)
+                {
+                    Ruleset ruleset = game.Ruleset.Value.CreateInstance();
+                    var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+                    allMods = allMods.Concat(multiplayerRoomMods);
+                }
 
-                RankingInformationDisplay.Ranked.Value = RankingInformationDisplay.Ranked.Value && multiplayerRoomMods.All(m => m.Ranked);
+                return allMods;
             }
-
-            RankingInformationDisplay.ModMultiplier.Value = multiplier;
         }
     }
 
@@ -77,34 +68,21 @@ namespace osu.Game.Overlays.Mods
             multiplayerRoomItem?.BindValueChanged(_ => Mods.TriggerChange());
         }
 
-        protected override double GetRate()
+        protected override IEnumerable<Mod> SelectedMods
         {
-            double rate = base.GetRate();
-            Ruleset ruleset = GameRuleset.Value.CreateInstance();
-
-            if (multiplayerRoomItem?.Value != null)
+            get
             {
-                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToRate>())
-                    rate = mod.ApplyToRate(0, rate);
+                IEnumerable<Mod> selectedMods = Mods.Value;
+
+                if (multiplayerRoomItem?.Value != null)
+                {
+                    Ruleset ruleset = GameRuleset.Value.CreateInstance();
+                    var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+                    selectedMods = selectedMods.Concat(multiplayerRoomMods);
+                }
+
+                return selectedMods;
             }
-
-            return rate;
-        }
-
-        protected override BeatmapDifficulty GetDifficulty()
-        {
-            BeatmapDifficulty originalDifficulty = base.GetDifficulty();
-            Ruleset ruleset = GameRuleset.Value.CreateInstance();
-
-            if (multiplayerRoomItem?.Value != null)
-            {
-                var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-                foreach (var mod in multiplayerRoomMods.OfType<IApplicableToDifficulty>())
-                    mod.ApplyToDifficulty(originalDifficulty);
-            }
-
-            return originalDifficulty;
         }
     }
 }

From a4288e7ecc8e3b631b8f8a2d43ddbc83c787f033 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Tue, 20 Feb 2024 13:00:59 +0200
Subject: [PATCH 094/930] removed unnecessary changes

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index f374828a4a..5b3bafae45 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -127,8 +127,8 @@ namespace osu.Game.Overlays.Mods
         private DeselectAllModsButton deselectAllModsButton = null!;
 
         private Container aboveColumnsContent = null!;
-        protected RankingInformationDisplay? RankingInformationDisplay;
-        protected BeatmapAttributesDisplay? BeatmapAttributesDisplay;
+        private RankingInformationDisplay? rankingInformationDisplay;
+        private BeatmapAttributesDisplay? beatmapAttributesDisplay;
 
         protected virtual BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new BeatmapAttributesDisplay
         {
@@ -155,8 +155,8 @@ namespace osu.Game.Overlays.Mods
                 if (beatmap == value) return;
 
                 beatmap = value;
-                if (IsLoaded && BeatmapAttributesDisplay != null)
-                    BeatmapAttributesDisplay.BeatmapInfo.Value = beatmap?.BeatmapInfo;
+                if (IsLoaded && beatmapAttributesDisplay != null)
+                    beatmapAttributesDisplay.BeatmapInfo.Value = beatmap?.BeatmapInfo;
             }
         }
 
@@ -278,12 +278,12 @@ namespace osu.Game.Overlays.Mods
                     },
                     Children = new Drawable[]
                     {
-                        RankingInformationDisplay = new RankingInformationDisplay
+                        rankingInformationDisplay = new RankingInformationDisplay
                         {
                             Anchor = Anchor.BottomRight,
                             Origin = Anchor.BottomRight
                         },
-                        BeatmapAttributesDisplay = GetBeatmapAttributesDisplay
+                        beatmapAttributesDisplay = GetBeatmapAttributesDisplay
                     }
                 });
             }
@@ -359,7 +359,7 @@ namespace osu.Game.Overlays.Mods
 
             SearchTextBox.PlaceholderText = SearchTextBox.HasFocus ? Resources.Localisation.Web.CommonStrings.InputSearch : ModSelectOverlayStrings.TabToSearch;
 
-            if (BeatmapAttributesDisplay != null)
+            if (beatmapAttributesDisplay != null)
             {
                 float rightEdgeOfLastButton = footerButtonFlow.Last().ScreenSpaceDrawQuad.TopRight.X;
 
@@ -371,7 +371,7 @@ namespace osu.Game.Overlays.Mods
 
                 // only update preview panel's collapsed state after we are fully visible, to ensure all the buttons are where we expect them to be.
                 if (Alpha == 1)
-                    BeatmapAttributesDisplay.Collapsed.Value = screenIsntWideEnough;
+                    beatmapAttributesDisplay.Collapsed.Value = screenIsntWideEnough;
 
                 footerContentFlow.LayoutDuration = 200;
                 footerContentFlow.LayoutEasing = Easing.OutQuint;
@@ -456,7 +456,7 @@ namespace osu.Game.Overlays.Mods
 
         private void updateRankingInformation()
         {
-            if (RankingInformationDisplay == null)
+            if (rankingInformationDisplay == null)
                 return;
 
             double multiplier = 1.0;
@@ -464,8 +464,8 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in AllSelectedMods)
                 multiplier *= mod.ScoreMultiplier;
 
-            RankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
-            RankingInformationDisplay.ModMultiplier.Value = multiplier;
+            rankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
+            rankingInformationDisplay.ModMultiplier.Value = multiplier;
         }
 
         private void updateCustomisation()

From 8199a49ee23f12e729a78658a6decd95df56fbc5 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Tue, 20 Feb 2024 13:11:19 +0200
Subject: [PATCH 095/930] minor look changes

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs | 1 +
 osu.Game/Overlays/Mods/ModSelectOverlay.cs         | 2 +-
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 21b3a7faa9..7c3c971d76 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -41,6 +41,7 @@ namespace osu.Game.Overlays.Mods
 
         [Resolved]
         protected Bindable<IReadOnlyList<Mod>> Mods { get; private set; } = null!;
+
         protected virtual IEnumerable<Mod> SelectedMods => Mods.Value;
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 5b3bafae45..8a3b1954ed 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -464,8 +464,8 @@ namespace osu.Game.Overlays.Mods
             foreach (var mod in AllSelectedMods)
                 multiplier *= mod.ScoreMultiplier;
 
-            rankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
             rankingInformationDisplay.ModMultiplier.Value = multiplier;
+            rankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
         }
 
         private void updateCustomisation()

From ed028e8d260854fc800a3331bef952682d5e811f Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Tue, 20 Feb 2024 13:13:13 +0200
Subject: [PATCH 096/930] Update MultiplayerModSelectOverlay.cs

---
 osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
index d546392650..ee087bb149 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
@@ -35,7 +35,6 @@ namespace osu.Game.Overlays.Mods
         protected override void LoadComplete()
         {
             base.LoadComplete();
-
             multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
         }
 

From 4a314a8e316273ff1f23b4003ea232d413b31ce9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 11:17:18 +0100
Subject: [PATCH 097/930] Namespacify data structures used in websocket
 communications

---
 osu.Game/Online/Chat/WebSocketChatClient.cs                     | 2 ++
 .../Notifications/WebSocket/{ => Events}/NewChatMessageData.cs  | 2 +-
 .../Notifications/WebSocket/{ => Requests}/EndChatRequest.cs    | 2 +-
 .../Notifications/WebSocket/{ => Requests}/StartChatRequest.cs  | 2 +-
 4 files changed, 5 insertions(+), 3 deletions(-)
 rename osu.Game/Online/Notifications/WebSocket/{ => Events}/NewChatMessageData.cs (94%)
 rename osu.Game/Online/Notifications/WebSocket/{ => Requests}/EndChatRequest.cs (89%)
 rename osu.Game/Online/Notifications/WebSocket/{ => Requests}/StartChatRequest.cs (89%)

diff --git a/osu.Game/Online/Chat/WebSocketChatClient.cs b/osu.Game/Online/Chat/WebSocketChatClient.cs
index 8e1b501b25..37774a1f5d 100644
--- a/osu.Game/Online/Chat/WebSocketChatClient.cs
+++ b/osu.Game/Online/Chat/WebSocketChatClient.cs
@@ -13,6 +13,8 @@ using osu.Framework.Logging;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.Notifications.WebSocket;
+using osu.Game.Online.Notifications.WebSocket.Events;
+using osu.Game.Online.Notifications.WebSocket.Requests;
 
 namespace osu.Game.Online.Chat
 {
diff --git a/osu.Game/Online/Notifications/WebSocket/NewChatMessageData.cs b/osu.Game/Online/Notifications/WebSocket/Events/NewChatMessageData.cs
similarity index 94%
rename from osu.Game/Online/Notifications/WebSocket/NewChatMessageData.cs
rename to osu.Game/Online/Notifications/WebSocket/Events/NewChatMessageData.cs
index 850fbd226b..ff9f5ee9f7 100644
--- a/osu.Game/Online/Notifications/WebSocket/NewChatMessageData.cs
+++ b/osu.Game/Online/Notifications/WebSocket/Events/NewChatMessageData.cs
@@ -8,7 +8,7 @@ using Newtonsoft.Json;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Chat;
 
-namespace osu.Game.Online.Notifications.WebSocket
+namespace osu.Game.Online.Notifications.WebSocket.Events
 {
     /// <summary>
     /// A websocket message sent from the server when new messages arrive.
diff --git a/osu.Game/Online/Notifications/WebSocket/EndChatRequest.cs b/osu.Game/Online/Notifications/WebSocket/Requests/EndChatRequest.cs
similarity index 89%
rename from osu.Game/Online/Notifications/WebSocket/EndChatRequest.cs
rename to osu.Game/Online/Notifications/WebSocket/Requests/EndChatRequest.cs
index 7f67587f5d..9058fea815 100644
--- a/osu.Game/Online/Notifications/WebSocket/EndChatRequest.cs
+++ b/osu.Game/Online/Notifications/WebSocket/Requests/EndChatRequest.cs
@@ -3,7 +3,7 @@
 
 using Newtonsoft.Json;
 
-namespace osu.Game.Online.Notifications.WebSocket
+namespace osu.Game.Online.Notifications.WebSocket.Requests
 {
     /// <summary>
     /// A websocket message notifying the server that the client no longer wants to receive chat messages.
diff --git a/osu.Game/Online/Notifications/WebSocket/StartChatRequest.cs b/osu.Game/Online/Notifications/WebSocket/Requests/StartChatRequest.cs
similarity index 89%
rename from osu.Game/Online/Notifications/WebSocket/StartChatRequest.cs
rename to osu.Game/Online/Notifications/WebSocket/Requests/StartChatRequest.cs
index 9dd69a7377..bc96415642 100644
--- a/osu.Game/Online/Notifications/WebSocket/StartChatRequest.cs
+++ b/osu.Game/Online/Notifications/WebSocket/Requests/StartChatRequest.cs
@@ -3,7 +3,7 @@
 
 using Newtonsoft.Json;
 
-namespace osu.Game.Online.Notifications.WebSocket
+namespace osu.Game.Online.Notifications.WebSocket.Requests
 {
     /// <summary>
     /// A websocket message notifying the server that the client wants to receive chat messages.

From 48bf9680e135d1ca528828d411047d338cc07c1e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 11:29:59 +0100
Subject: [PATCH 098/930] Add new structures for receiving new medal data

---
 .../Events/NewPrivateNotificationEvent.cs     | 39 +++++++++++++++++++
 .../WebSocket/Events/UserAchievementUnlock.cs | 34 ++++++++++++++++
 2 files changed, 73 insertions(+)
 create mode 100644 osu.Game/Online/Notifications/WebSocket/Events/NewPrivateNotificationEvent.cs
 create mode 100644 osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs

diff --git a/osu.Game/Online/Notifications/WebSocket/Events/NewPrivateNotificationEvent.cs b/osu.Game/Online/Notifications/WebSocket/Events/NewPrivateNotificationEvent.cs
new file mode 100644
index 0000000000..1fc9636136
--- /dev/null
+++ b/osu.Game/Online/Notifications/WebSocket/Events/NewPrivateNotificationEvent.cs
@@ -0,0 +1,39 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace osu.Game.Online.Notifications.WebSocket.Events
+{
+    /// <summary>
+    /// Reference: https://github.com/ppy/osu-web/blob/master/app/Events/NewPrivateNotificationEvent.php
+    /// </summary>
+    public class NewPrivateNotificationEvent
+    {
+        [JsonProperty("id")]
+        public ulong ID { get; set; }
+
+        [JsonProperty("name")]
+        public string Name { get; set; } = string.Empty;
+
+        [JsonProperty("created_at")]
+        public DateTimeOffset CreatedAt { get; set; }
+
+        [JsonProperty("object_type")]
+        public string ObjectType { get; set; } = string.Empty;
+
+        [JsonProperty("object_id")]
+        public ulong ObjectId { get; set; }
+
+        [JsonProperty("source_user_id")]
+        public uint SourceUserID { get; set; }
+
+        [JsonProperty("is_read")]
+        public bool IsRead { get; set; }
+
+        [JsonProperty("details")]
+        public JObject? Details { get; set; }
+    }
+}
diff --git a/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs b/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs
new file mode 100644
index 0000000000..6c7c8af4f4
--- /dev/null
+++ b/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs
@@ -0,0 +1,34 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.Notifications.WebSocket.Events
+{
+    /// <summary>
+    /// Reference: https://github.com/ppy/osu-web/blob/master/app/Jobs/Notifications/UserAchievementUnlock.php
+    /// </summary>
+    public class UserAchievementUnlock
+    {
+        [JsonProperty("achievement_id")]
+        public uint AchievementId { get; set; }
+
+        [JsonProperty("achievement_mode")]
+        public ushort? AchievementMode { get; set; }
+
+        [JsonProperty("cover_url")]
+        public string CoverUrl { get; set; } = string.Empty;
+
+        [JsonProperty("slug")]
+        public string Slug { get; set; } = string.Empty;
+
+        [JsonProperty("title")]
+        public string Title { get; set; } = string.Empty;
+
+        [JsonProperty("description")]
+        public string Description { get; set; } = string.Empty;
+
+        [JsonProperty("user_id")]
+        public uint UserId { get; set; }
+    }
+}

From 4911f5208b2ba6903aa3ec807ba246238bf501d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 12:03:12 +0100
Subject: [PATCH 099/930] Demote medal "overlay" to animation

I need the actual overlay to be doing way more things (receiving the
actual websocket events, queueing the medals for display, handling
activation mode), so the pre-existing API design of the overlay just
will not fly.
---
 osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs  | 2 +-
 osu.Game/Overlays/{MedalOverlay.cs => MedalAnimation.cs} | 4 ++--
 osu.Game/Overlays/MedalSplash/DrawableMedal.cs           | 6 +++---
 3 files changed, 6 insertions(+), 6 deletions(-)
 rename osu.Game/Overlays/{MedalOverlay.cs => MedalAnimation.cs} (99%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index 71ed0a14a2..afd4427629 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep(@"display", () =>
             {
-                LoadComponentAsync(new MedalOverlay(new Medal
+                LoadComponentAsync(new MedalAnimation(new Medal
                 {
                     Name = @"Animations",
                     InternalName = @"all-intro-doubletime",
diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalAnimation.cs
similarity index 99%
rename from osu.Game/Overlays/MedalOverlay.cs
rename to osu.Game/Overlays/MedalAnimation.cs
index eba35ec6f9..80c06be87c 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalAnimation.cs
@@ -27,7 +27,7 @@ using osu.Framework.Utils;
 
 namespace osu.Game.Overlays
 {
-    public partial class MedalOverlay : FocusedOverlayContainer
+    public partial class MedalAnimation : VisibilityContainer
     {
         public const float DISC_SIZE = 400;
 
@@ -45,7 +45,7 @@ namespace osu.Game.Overlays
 
         private readonly Container content;
 
-        public MedalOverlay(Medal medal)
+        public MedalAnimation(Medal medal)
         {
             this.medal = medal;
             RelativeSizeAxes = Axes.Both;
diff --git a/osu.Game/Overlays/MedalSplash/DrawableMedal.cs b/osu.Game/Overlays/MedalSplash/DrawableMedal.cs
index f4f6fd2bc1..2beed6645a 100644
--- a/osu.Game/Overlays/MedalSplash/DrawableMedal.cs
+++ b/osu.Game/Overlays/MedalSplash/DrawableMedal.cs
@@ -38,7 +38,7 @@ namespace osu.Game.Overlays.MedalSplash
         public DrawableMedal(Medal medal)
         {
             this.medal = medal;
-            Position = new Vector2(0f, MedalOverlay.DISC_SIZE / 2);
+            Position = new Vector2(0f, MedalAnimation.DISC_SIZE / 2);
 
             FillFlowContainer infoFlow;
             Children = new Drawable[]
@@ -174,7 +174,7 @@ namespace osu.Game.Overlays.MedalSplash
                         .ScaleTo(1);
 
                     this.ScaleTo(scale_when_unlocked, duration, Easing.OutExpo);
-                    this.MoveToY(MedalOverlay.DISC_SIZE / 2 - 30, duration, Easing.OutExpo);
+                    this.MoveToY(MedalAnimation.DISC_SIZE / 2 - 30, duration, Easing.OutExpo);
                     unlocked.FadeInFromZero(duration);
                     break;
 
@@ -184,7 +184,7 @@ namespace osu.Game.Overlays.MedalSplash
                         .ScaleTo(1);
 
                     this.ScaleTo(scale_when_full, duration, Easing.OutExpo);
-                    this.MoveToY(MedalOverlay.DISC_SIZE / 2 - 60, duration, Easing.OutExpo);
+                    this.MoveToY(MedalAnimation.DISC_SIZE / 2 - 60, duration, Easing.OutExpo);
                     unlocked.Show();
                     name.FadeInFromZero(duration + 100);
                     description.FadeInFromZero(duration * 2);

From 4f321e242bd7650c0bfe9afec4d3746188df3cf5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 12:05:25 +0100
Subject: [PATCH 100/930] Enable NRT in `OsuFocusedOverlayContainer`

---
 .../Containers/OsuFocusedOverlayContainer.cs  | 27 +++++++++----------
 1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 162c4b6a59..16539a812d 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -20,10 +18,10 @@ namespace osu.Game.Graphics.Containers
     [Cached(typeof(IPreviewTrackOwner))]
     public abstract partial class OsuFocusedOverlayContainer : FocusedOverlayContainer, IPreviewTrackOwner, IKeyBindingHandler<GlobalAction>
     {
-        private Sample samplePopIn;
-        private Sample samplePopOut;
-        protected virtual string PopInSampleName => "UI/overlay-pop-in";
-        protected virtual string PopOutSampleName => "UI/overlay-pop-out";
+        protected readonly IBindable<OverlayActivation> OverlayActivationMode = new Bindable<OverlayActivation>(OverlayActivation.All);
+
+        protected virtual string PopInSampleName => @"UI/overlay-pop-in";
+        protected virtual string PopOutSampleName => @"UI/overlay-pop-out";
         protected virtual double PopInOutSampleBalance => 0;
 
         protected override bool BlockNonPositionalInput => true;
@@ -34,19 +32,20 @@ namespace osu.Game.Graphics.Containers
         /// </summary>
         protected virtual bool DimMainContent => true;
 
-        [Resolved(CanBeNull = true)]
-        private IOverlayManager overlayManager { get; set; }
+        [Resolved]
+        private IOverlayManager? overlayManager { get; set; }
 
         [Resolved]
-        private PreviewTrackManager previewTrackManager { get; set; }
+        private PreviewTrackManager previewTrackManager { get; set; } = null!;
 
-        protected readonly IBindable<OverlayActivation> OverlayActivationMode = new Bindable<OverlayActivation>(OverlayActivation.All);
+        private Sample? samplePopIn;
+        private Sample? samplePopOut;
 
-        [BackgroundDependencyLoader(true)]
-        private void load(AudioManager audio)
+        [BackgroundDependencyLoader]
+        private void load(AudioManager? audio)
         {
-            samplePopIn = audio.Samples.Get(PopInSampleName);
-            samplePopOut = audio.Samples.Get(PopOutSampleName);
+            samplePopIn = audio?.Samples.Get(PopInSampleName);
+            samplePopOut = audio?.Samples.Get(PopOutSampleName);
         }
 
         protected override void LoadComplete()

From 2e5b61302ab2652b09ac8fe57e48d76315b0d85a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 12:53:46 +0100
Subject: [PATCH 101/930] Implement basic medal display flow

---
 .../Visual/Gameplay/TestSceneMedalOverlay.cs  |  45 +++++--
 .../Containers/OsuFocusedOverlayContainer.cs  |  11 +-
 osu.Game/Overlays/MedalAnimation.cs           |  15 +--
 osu.Game/Overlays/MedalOverlay.cs             | 112 ++++++++++++++++++
 4 files changed, 155 insertions(+), 28 deletions(-)
 create mode 100644 osu.Game/Overlays/MedalOverlay.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index afd4427629..ead5c5b418 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
@@ -1,26 +1,51 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using Newtonsoft.Json.Linq;
 using NUnit.Framework;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Online.API;
+using osu.Game.Online.Notifications.WebSocket;
+using osu.Game.Online.Notifications.WebSocket.Events;
 using osu.Game.Overlays;
-using osu.Game.Users;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
     [TestFixture]
-    public partial class TestSceneMedalOverlay : OsuTestScene
+    public partial class TestSceneMedalOverlay : OsuManualInputManagerTestScene
     {
-        public TestSceneMedalOverlay()
+        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
+
+        private MedalOverlay overlay = null!;
+
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            AddStep(@"display", () =>
+            AddStep("create overlay", () => Child = overlay = new MedalOverlay());
+        }
+
+        [Test]
+        public void TestBasicAward()
+        {
+            AddStep("award medal", () => dummyAPI.NotificationsClient.Receive(new SocketMessage
             {
-                LoadComponentAsync(new MedalAnimation(new Medal
+                Event = @"new",
+                Data = JObject.FromObject(new NewPrivateNotificationEvent
                 {
-                    Name = @"Animations",
-                    InternalName = @"all-intro-doubletime",
-                    Description = @"More complex than you think.",
-                }), Add);
-            });
+                    Name = @"user_achievement_unlock",
+                    Details = JObject.FromObject(new UserAchievementUnlock
+                    {
+                        Title = "Time And A Half",
+                        Description = "Having a right ol' time. One and a half of them, almost.",
+                        Slug = @"all-intro-doubletime"
+                    })
+                })
+            }));
+            AddUntilStep("overlay shown", () => overlay.State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddRepeatStep("dismiss", () => InputManager.Key(Key.Escape), 2);
+            AddUntilStep("overlay hidden", () => overlay.State.Value, () => Is.EqualTo(Visibility.Hidden));
         }
     }
 }
diff --git a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
index 16539a812d..1945b2f0dd 100644
--- a/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuFocusedOverlayContainer.cs
@@ -20,8 +20,8 @@ namespace osu.Game.Graphics.Containers
     {
         protected readonly IBindable<OverlayActivation> OverlayActivationMode = new Bindable<OverlayActivation>(OverlayActivation.All);
 
-        protected virtual string PopInSampleName => @"UI/overlay-pop-in";
-        protected virtual string PopOutSampleName => @"UI/overlay-pop-out";
+        protected virtual string? PopInSampleName => @"UI/overlay-pop-in";
+        protected virtual string? PopOutSampleName => @"UI/overlay-pop-out";
         protected virtual double PopInOutSampleBalance => 0;
 
         protected override bool BlockNonPositionalInput => true;
@@ -44,8 +44,11 @@ namespace osu.Game.Graphics.Containers
         [BackgroundDependencyLoader]
         private void load(AudioManager? audio)
         {
-            samplePopIn = audio?.Samples.Get(PopInSampleName);
-            samplePopOut = audio?.Samples.Get(PopOutSampleName);
+            if (!string.IsNullOrEmpty(PopInSampleName))
+                samplePopIn = audio?.Samples.Get(PopInSampleName);
+
+            if (!string.IsNullOrEmpty(PopOutSampleName))
+                samplePopOut = audio?.Samples.Get(PopOutSampleName);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Overlays/MedalAnimation.cs b/osu.Game/Overlays/MedalAnimation.cs
index 80c06be87c..041929be67 100644
--- a/osu.Game/Overlays/MedalAnimation.cs
+++ b/osu.Game/Overlays/MedalAnimation.cs
@@ -18,11 +18,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Audio;
 using osu.Framework.Graphics.Textures;
-using osuTK.Input;
 using osu.Framework.Graphics.Shapes;
 using System;
 using osu.Framework.Graphics.Effects;
-using osu.Framework.Input.Events;
 using osu.Framework.Utils;
 
 namespace osu.Game.Overlays
@@ -190,17 +188,6 @@ namespace osu.Game.Overlays
             particleContainer.Add(new MedalParticle(RNG.Next(0, 359)));
         }
 
-        protected override bool OnClick(ClickEvent e)
-        {
-            dismiss();
-            return true;
-        }
-
-        protected override void OnFocusLost(FocusLostEvent e)
-        {
-            if (e.CurrentState.Keyboard.Keys.IsPressed(Key.Escape)) dismiss();
-        }
-
         private const double initial_duration = 400;
         private const double step_duration = 900;
 
@@ -256,7 +243,7 @@ namespace osu.Game.Overlays
             this.FadeOut(200);
         }
 
-        private void dismiss()
+        public void Dismiss()
         {
             if (drawableMedal.State != DisplayState.Full)
             {
diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
new file mode 100644
index 0000000000..c3d7b4b9fc
--- /dev/null
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -0,0 +1,112 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Input.Events;
+using osu.Game.Graphics.Containers;
+using osu.Game.Input.Bindings;
+using osu.Game.Online.API;
+using osu.Game.Online.Notifications.WebSocket;
+using osu.Game.Online.Notifications.WebSocket.Events;
+using osu.Game.Users;
+
+namespace osu.Game.Overlays
+{
+    public partial class MedalOverlay : OsuFocusedOverlayContainer
+    {
+        protected override string? PopInSampleName => null;
+        protected override string? PopOutSampleName => null;
+
+        protected override void PopIn() => this.FadeIn();
+
+        protected override void PopOut()
+        {
+            showingMedals = false;
+            this.FadeOut();
+        }
+
+        [Resolved]
+        private IAPIProvider api { get; set; } = null!;
+
+        private Container<Drawable> medalContainer = null!;
+        private bool showingMedals;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            RelativeSizeAxes = Axes.Both;
+
+            api.NotificationsClient.MessageReceived += handleMedalMessages;
+
+            Add(medalContainer = new Container
+            {
+                RelativeSizeAxes = Axes.Both
+            });
+        }
+
+        private void handleMedalMessages(SocketMessage obj)
+        {
+            if (obj.Event != @"new")
+                return;
+
+            var data = obj.Data?.ToObject<NewPrivateNotificationEvent>();
+            if (data == null || data.Name != @"user_achievement_unlock")
+                return;
+
+            var details = data.Details?.ToObject<UserAchievementUnlock>();
+            if (details == null)
+                return;
+
+            var medal = new Medal
+            {
+                Name = details.Title,
+                InternalName = details.Slug,
+                Description = details.Description,
+            };
+
+            Show();
+            LoadComponentAsync(new MedalAnimation(medal), animation =>
+            {
+                medalContainer.Add(animation);
+                showingMedals = true;
+            });
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (showingMedals && !medalContainer.Any())
+                Hide();
+        }
+
+        protected override bool OnClick(ClickEvent e)
+        {
+            (medalContainer.FirstOrDefault(anim => anim.IsAlive) as MedalAnimation)?.Dismiss();
+            return true;
+        }
+
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Action == GlobalAction.Back)
+            {
+                (medalContainer.FirstOrDefault(anim => anim.IsAlive) as MedalAnimation)?.Dismiss();
+                return true;
+            }
+
+            return base.OnPressed(e);
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (api.IsNotNull())
+                api.NotificationsClient.MessageReceived -= handleMedalMessages;
+        }
+    }
+}

From e4971ae121cf6078cf7e1150cf5176e26d093250 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 13:08:02 +0100
Subject: [PATCH 102/930] Add display queueing when multiple medals are granted
 in quick succession

---
 .../Visual/Gameplay/TestSceneMedalOverlay.cs  | 51 ++++++++++++++-----
 osu.Game/Overlays/MedalOverlay.cs             | 12 ++++-
 2 files changed, 48 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index ead5c5b418..a33c7e662f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
@@ -29,23 +29,48 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestBasicAward()
         {
-            AddStep("award medal", () => dummyAPI.NotificationsClient.Receive(new SocketMessage
+            awardMedal(new UserAchievementUnlock
             {
-                Event = @"new",
-                Data = JObject.FromObject(new NewPrivateNotificationEvent
-                {
-                    Name = @"user_achievement_unlock",
-                    Details = JObject.FromObject(new UserAchievementUnlock
-                    {
-                        Title = "Time And A Half",
-                        Description = "Having a right ol' time. One and a half of them, almost.",
-                        Slug = @"all-intro-doubletime"
-                    })
-                })
-            }));
+                Title = "Time And A Half",
+                Description = "Having a right ol' time. One and a half of them, almost.",
+                Slug = @"all-intro-doubletime"
+            });
             AddUntilStep("overlay shown", () => overlay.State.Value, () => Is.EqualTo(Visibility.Visible));
             AddRepeatStep("dismiss", () => InputManager.Key(Key.Escape), 2);
             AddUntilStep("overlay hidden", () => overlay.State.Value, () => Is.EqualTo(Visibility.Hidden));
         }
+
+        [Test]
+        public void TestMultipleMedalsInQuickSuccession()
+        {
+            awardMedal(new UserAchievementUnlock
+            {
+                Title = "Time And A Half",
+                Description = "Having a right ol' time. One and a half of them, almost.",
+                Slug = @"all-intro-doubletime"
+            });
+            awardMedal(new UserAchievementUnlock
+            {
+                Title = "S-Ranker",
+                Description = "Accuracy is really underrated.",
+                Slug = @"all-secret-rank-s"
+            });
+            awardMedal(new UserAchievementUnlock
+            {
+                Title = "500 Combo",
+                Description = "500 big ones! You're moving up in the world!",
+                Slug = @"osu-combo-500"
+            });
+        }
+
+        private void awardMedal(UserAchievementUnlock unlock) => AddStep("award medal", () => dummyAPI.NotificationsClient.Receive(new SocketMessage
+        {
+            Event = @"new",
+            Data = JObject.FromObject(new NewPrivateNotificationEvent
+            {
+                Name = @"user_achievement_unlock",
+                Details = JObject.FromObject(unlock)
+            })
+        }));
     }
 }
diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index c3d7b4b9fc..70cde43924 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.ObjectExtensions;
@@ -29,6 +30,8 @@ namespace osu.Game.Overlays
             this.FadeOut();
         }
 
+        private readonly Queue<MedalAnimation> queuedMedals = new Queue<MedalAnimation>();
+
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
@@ -71,7 +74,7 @@ namespace osu.Game.Overlays
             Show();
             LoadComponentAsync(new MedalAnimation(medal), animation =>
             {
-                medalContainer.Add(animation);
+                queuedMedals.Enqueue(animation);
                 showingMedals = true;
             });
         }
@@ -80,7 +83,12 @@ namespace osu.Game.Overlays
         {
             base.Update();
 
-            if (showingMedals && !medalContainer.Any())
+            if (!showingMedals || medalContainer.Any())
+                return;
+
+            if (queuedMedals.TryDequeue(out var nextMedal))
+                medalContainer.Add(nextMedal);
+            else
                 Hide();
         }
 

From b334b78b636a7d4504f3509c88fbf2542d8f4f78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 13:44:25 +0100
Subject: [PATCH 103/930] Make medal overlay respect overlay disable via
 activation mode

---
 .../Visual/Gameplay/TestSceneMedalOverlay.cs  | 35 ++++++++++++++++--
 osu.Game/Overlays/MedalOverlay.cs             | 36 +++++++++++--------
 osu.Game/Properties/AssemblyInfo.cs           |  3 ++
 3 files changed, 57 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index a33c7e662f..fe9c524285 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
@@ -1,8 +1,11 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using Moq;
 using Newtonsoft.Json.Linq;
 using NUnit.Framework;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Online.API;
@@ -16,14 +19,26 @@ namespace osu.Game.Tests.Visual.Gameplay
     [TestFixture]
     public partial class TestSceneMedalOverlay : OsuManualInputManagerTestScene
     {
-        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
+        private readonly Bindable<OverlayActivation> overlayActivationMode = new Bindable<OverlayActivation>(OverlayActivation.All);
 
+        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
         private MedalOverlay overlay = null!;
 
         [SetUpSteps]
         public void SetUpSteps()
         {
-            AddStep("create overlay", () => Child = overlay = new MedalOverlay());
+            var overlayManagerMock = new Mock<IOverlayManager>();
+            overlayManagerMock.Setup(mock => mock.OverlayActivationMode).Returns(overlayActivationMode);
+
+            AddStep("create overlay", () => Child = new DependencyProvidingContainer
+            {
+                Child = overlay = new MedalOverlay(),
+                RelativeSizeAxes = Axes.Both,
+                CachedDependencies =
+                [
+                    (typeof(IOverlayManager), overlayManagerMock.Object)
+                ]
+            });
         }
 
         [Test]
@@ -63,6 +78,22 @@ namespace osu.Game.Tests.Visual.Gameplay
             });
         }
 
+        [Test]
+        public void TestDelayMedalDisplayUntilActivationModeAllowsIt()
+        {
+            AddStep("disable overlay activation", () => overlayActivationMode.Value = OverlayActivation.Disabled);
+            awardMedal(new UserAchievementUnlock
+            {
+                Title = "Time And A Half",
+                Description = "Having a right ol' time. One and a half of them, almost.",
+                Slug = @"all-intro-doubletime"
+            });
+            AddUntilStep("overlay hidden", () => overlay.State.Value, () => Is.EqualTo(Visibility.Hidden));
+
+            AddStep("re-enable overlay activation", () => overlayActivationMode.Value = OverlayActivation.All);
+            AddUntilStep("overlay shown", () => overlay.State.Value, () => Is.EqualTo(Visibility.Visible));
+        }
+
         private void awardMedal(UserAchievementUnlock unlock) => AddStep("award medal", () => dummyAPI.NotificationsClient.Receive(new SocketMessage
         {
             Event = @"new",
diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index 70cde43924..03beba2d3b 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -24,11 +24,7 @@ namespace osu.Game.Overlays
 
         protected override void PopIn() => this.FadeIn();
 
-        protected override void PopOut()
-        {
-            showingMedals = false;
-            this.FadeOut();
-        }
+        protected override void PopOut() => this.FadeOut();
 
         private readonly Queue<MedalAnimation> queuedMedals = new Queue<MedalAnimation>();
 
@@ -36,7 +32,6 @@ namespace osu.Game.Overlays
         private IAPIProvider api { get; set; } = null!;
 
         private Container<Drawable> medalContainer = null!;
-        private bool showingMedals;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -51,6 +46,17 @@ namespace osu.Game.Overlays
             });
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            OverlayActivationMode.BindValueChanged(val =>
+            {
+                if (val.NewValue != OverlayActivation.Disabled && queuedMedals.Any())
+                    Show();
+            }, true);
+        }
+
         private void handleMedalMessages(SocketMessage obj)
         {
             if (obj.Event != @"new")
@@ -71,25 +77,25 @@ namespace osu.Game.Overlays
                 Description = details.Description,
             };
 
+            var medalAnimation = new MedalAnimation(medal);
+            queuedMedals.Enqueue(medalAnimation);
             Show();
-            LoadComponentAsync(new MedalAnimation(medal), animation =>
-            {
-                queuedMedals.Enqueue(animation);
-                showingMedals = true;
-            });
         }
 
         protected override void Update()
         {
             base.Update();
 
-            if (!showingMedals || medalContainer.Any())
+            if (medalContainer.Any())
                 return;
 
-            if (queuedMedals.TryDequeue(out var nextMedal))
-                medalContainer.Add(nextMedal);
-            else
+            if (!queuedMedals.TryDequeue(out var medal))
+            {
                 Hide();
+                return;
+            }
+
+            LoadComponentAsync(medal, medalContainer.Add);
         }
 
         protected override bool OnClick(ClickEvent e)
diff --git a/osu.Game/Properties/AssemblyInfo.cs b/osu.Game/Properties/AssemblyInfo.cs
index 1b77e45891..be430a0fe4 100644
--- a/osu.Game/Properties/AssemblyInfo.cs
+++ b/osu.Game/Properties/AssemblyInfo.cs
@@ -11,3 +11,6 @@ using System.Runtime.CompilerServices;
 [assembly: InternalsVisibleTo("osu.Game.Tests.Dynamic")]
 [assembly: InternalsVisibleTo("osu.Game.Tests.iOS")]
 [assembly: InternalsVisibleTo("osu.Game.Tests.Android")]
+
+// intended for Moq usage
+[assembly: InternalsVisibleTo("DynamicProxyGenAssembly2")]

From 8abcc70b938c1ba6d23c1d61ac15cf7cad31b02f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 14:33:08 +0100
Subject: [PATCH 104/930] Add medal overlay to game

---
 .../Navigation/TestSceneScreenNavigation.cs   | 25 +++++++++++++++++++
 osu.Game/OsuGame.cs                           |  1 +
 2 files changed, 26 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
index 7e42d4781d..0fa2fd4b0b 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneScreenNavigation.cs
@@ -6,6 +6,7 @@
 using System;
 using System.IO;
 using System.Linq;
+using Newtonsoft.Json.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Configuration;
@@ -24,6 +25,8 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API;
 using osu.Game.Online.Leaderboards;
+using osu.Game.Online.Notifications.WebSocket;
+using osu.Game.Online.Notifications.WebSocket.Events;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Overlays.Mods;
@@ -340,6 +343,28 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("wait for results", () => Game.ScreenStack.CurrentScreen is ResultsScreen);
         }
 
+        [Test]
+        public void TestShowMedalAtResults()
+        {
+            playToResults();
+
+            AddStep("award medal", () => ((DummyAPIAccess)API).NotificationsClient.Receive(new SocketMessage
+            {
+                Event = @"new",
+                Data = JObject.FromObject(new NewPrivateNotificationEvent
+                {
+                    Name = @"user_achievement_unlock",
+                    Details = JObject.FromObject(new UserAchievementUnlock
+                    {
+                        Title = "Time And A Half",
+                        Description = "Having a right ol' time. One and a half of them, almost.",
+                        Slug = @"all-intro-doubletime"
+                    })
+                })
+            }));
+            AddUntilStep("medal overlay shown", () => Game.ChildrenOfType<MedalOverlay>().Single().State.Value, () => Is.EqualTo(Visibility.Visible));
+        }
+
         [Test]
         public void TestRetryFromResults()
         {
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9ffa88947b..a829758f0e 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1072,6 +1072,7 @@ namespace osu.Game
             loadComponentSingleFile(beatmapSetOverlay = new BeatmapSetOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(skinEditor = new SkinEditorOverlay(ScreenContainer), overlayContent.Add, true);
+            loadComponentSingleFile(new MedalOverlay(), overlayContent.Add);
 
             loadComponentSingleFile(new LoginOverlay
             {

From 96825915f73c558265f736472e95d7e6c68fa19c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 15:02:30 +0100
Subject: [PATCH 105/930] Fix threading failure

Implicitly showing the medal overlay fires off some transforms, and the
websocket listener runs on a TPL thread. That's a recipe for disaster,
so schedule the show call.
---
 osu.Game/Overlays/MedalOverlay.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index 03beba2d3b..76936e0f5a 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Overlays
         protected override string? PopInSampleName => null;
         protected override string? PopOutSampleName => null;
 
+        public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
+
         protected override void PopIn() => this.FadeIn();
 
         protected override void PopOut() => this.FadeOut();
@@ -52,7 +54,7 @@ namespace osu.Game.Overlays
 
             OverlayActivationMode.BindValueChanged(val =>
             {
-                if (val.NewValue != OverlayActivation.Disabled && queuedMedals.Any())
+                if (val.NewValue != OverlayActivation.Disabled && (queuedMedals.Any() || medalContainer.Any()))
                     Show();
             }, true);
         }
@@ -79,7 +81,7 @@ namespace osu.Game.Overlays
 
             var medalAnimation = new MedalAnimation(medal);
             queuedMedals.Enqueue(medalAnimation);
-            Show();
+            Scheduler.AddOnce(Show);
         }
 
         protected override void Update()

From 611e3fe76bd0930e0ef0320c57ba23658e9b2bc6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 15:52:15 +0100
Subject: [PATCH 106/930] Delay medal display when wanting to show results
 animation

---
 osu.Game/Overlays/MedalOverlay.cs                         | 5 +++--
 .../Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs   | 5 +++++
 osu.Game/Screens/Ranking/ResultsScreen.cs                 | 8 ++++++++
 3 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index 76936e0f5a..3601566dda 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Overlays
 
             OverlayActivationMode.BindValueChanged(val =>
             {
-                if (val.NewValue != OverlayActivation.Disabled && (queuedMedals.Any() || medalContainer.Any()))
+                if (val.NewValue == OverlayActivation.All && (queuedMedals.Any() || medalContainer.Any()))
                     Show();
             }, true);
         }
@@ -81,7 +81,8 @@ namespace osu.Game.Overlays
 
             var medalAnimation = new MedalAnimation(medal);
             queuedMedals.Enqueue(medalAnimation);
-            Scheduler.AddOnce(Show);
+            if (OverlayActivationMode.Value == OverlayActivation.All)
+                Scheduler.AddOnce(Show);
         }
 
         protected override void Update()
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index d209c305fa..f807126614 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -31,6 +31,11 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
     /// </summary>
     public partial class AccuracyCircle : CompositeDrawable
     {
+        /// <summary>
+        /// The total duration of the animation.
+        /// </summary>
+        public const double TOTAL_DURATION = APPEAR_DURATION + ACCURACY_TRANSFORM_DELAY + ACCURACY_TRANSFORM_DURATION;
+
         /// <summary>
         /// Duration for the transforms causing this component to appear.
         /// </summary>
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 69cfbed8f2..93114b1d18 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -25,8 +25,10 @@ using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
 using osu.Game.Online.Placeholders;
+using osu.Game.Overlays;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osu.Game.Screens.Ranking.Expanded.Accuracy;
 using osu.Game.Screens.Ranking.Statistics;
 using osuTK;
 
@@ -41,6 +43,8 @@ namespace osu.Game.Screens.Ranking
 
         public override bool? AllowGlobalTrackControl => true;
 
+        protected override OverlayActivation InitialOverlayActivationMode => OverlayActivation.UserTriggered;
+
         public readonly Bindable<ScoreInfo> SelectedScore = new Bindable<ScoreInfo>();
 
         [CanBeNull]
@@ -160,6 +164,10 @@ namespace osu.Game.Screens.Ranking
                 bool shouldFlair = player != null && !Score.User.IsBot;
 
                 ScorePanelList.AddScore(Score, shouldFlair);
+                // this is mostly for medal display.
+                // we don't want the medal animation to trample on the results screen animation, so we (ab)use `OverlayActivationMode`
+                // to give the results screen enough time to play the animation out before the medals can be shown.
+                Scheduler.AddDelayed(() => OverlayActivationMode.Value = OverlayActivation.All, shouldFlair ? AccuracyCircle.TOTAL_DURATION + 1000 : 0);
             }
 
             if (allowWatchingReplay)

From 1db5cd3abadcc5f24ceada0092fcf8e2d7ece869 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 16:16:30 +0100
Subject: [PATCH 107/930] Move medal overlay to topmost container

---
 osu.Game/OsuGame.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index a829758f0e..dbdc86e016 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1072,7 +1072,6 @@ namespace osu.Game
             loadComponentSingleFile(beatmapSetOverlay = new BeatmapSetOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(wikiOverlay = new WikiOverlay(), overlayContent.Add, true);
             loadComponentSingleFile(skinEditor = new SkinEditorOverlay(ScreenContainer), overlayContent.Add, true);
-            loadComponentSingleFile(new MedalOverlay(), overlayContent.Add);
 
             loadComponentSingleFile(new LoginOverlay
             {
@@ -1088,6 +1087,7 @@ namespace osu.Game
 
             loadComponentSingleFile(new AccountCreationOverlay(), topMostOverlayContent.Add, true);
             loadComponentSingleFile<IDialogOverlay>(new DialogOverlay(), topMostOverlayContent.Add, true);
+            loadComponentSingleFile(new MedalOverlay(), topMostOverlayContent.Add);
 
             loadComponentSingleFile(CreateHighPerformanceSession(), Add);
 

From 9b938f333de39b0d497cab545f4e0719e17c9b9a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 17:25:11 +0100
Subject: [PATCH 108/930] Fix test failures

---
 osu.Game/Overlays/MedalOverlay.cs | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/MedalOverlay.cs b/osu.Game/Overlays/MedalOverlay.cs
index 3601566dda..072d7db6c7 100644
--- a/osu.Game/Overlays/MedalOverlay.cs
+++ b/osu.Game/Overlays/MedalOverlay.cs
@@ -34,6 +34,7 @@ namespace osu.Game.Overlays
         private IAPIProvider api { get; set; } = null!;
 
         private Container<Drawable> medalContainer = null!;
+        private MedalAnimation? lastAnimation;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -54,7 +55,7 @@ namespace osu.Game.Overlays
 
             OverlayActivationMode.BindValueChanged(val =>
             {
-                if (val.NewValue == OverlayActivation.All && (queuedMedals.Any() || medalContainer.Any()))
+                if (val.NewValue == OverlayActivation.All && (queuedMedals.Any() || medalContainer.Any() || lastAnimation?.IsLoaded == false))
                     Show();
             }, true);
         }
@@ -89,21 +90,21 @@ namespace osu.Game.Overlays
         {
             base.Update();
 
-            if (medalContainer.Any())
+            if (medalContainer.Any() || lastAnimation?.IsLoaded == false)
                 return;
 
-            if (!queuedMedals.TryDequeue(out var medal))
+            if (!queuedMedals.TryDequeue(out lastAnimation))
             {
                 Hide();
                 return;
             }
 
-            LoadComponentAsync(medal, medalContainer.Add);
+            LoadComponentAsync(lastAnimation, medalContainer.Add);
         }
 
         protected override bool OnClick(ClickEvent e)
         {
-            (medalContainer.FirstOrDefault(anim => anim.IsAlive) as MedalAnimation)?.Dismiss();
+            lastAnimation?.Dismiss();
             return true;
         }
 
@@ -111,7 +112,7 @@ namespace osu.Game.Overlays
         {
             if (e.Action == GlobalAction.Back)
             {
-                (medalContainer.FirstOrDefault(anim => anim.IsAlive) as MedalAnimation)?.Dismiss();
+                lastAnimation?.Dismiss();
                 return true;
             }
 

From 33a0dcaf20fad0c79802367f81b9a370a9be035f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 17:59:21 +0100
Subject: [PATCH 109/930] NRT-annotate `MedalAnimation` and fix possible
 nullref

---
 osu.Game/Overlays/MedalAnimation.cs | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/MedalAnimation.cs b/osu.Game/Overlays/MedalAnimation.cs
index 041929be67..25776d50db 100644
--- a/osu.Game/Overlays/MedalAnimation.cs
+++ b/osu.Game/Overlays/MedalAnimation.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Extensions.Color4Extensions;
@@ -20,6 +18,7 @@ using osu.Framework.Audio;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Graphics.Shapes;
 using System;
+using System.Diagnostics;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Utils;
 
@@ -37,9 +36,9 @@ namespace osu.Game.Overlays
         private readonly BackgroundStrip leftStrip, rightStrip;
         private readonly CircularContainer disc;
         private readonly Sprite innerSpin, outerSpin;
-        private DrawableMedal drawableMedal;
 
-        private Sample getSample;
+        private DrawableMedal? drawableMedal;
+        private Sample? getSample;
 
         private readonly Container content;
 
@@ -197,7 +196,7 @@ namespace osu.Game.Overlays
 
             background.FlashColour(Color4.White.Opacity(0.25f), 400);
 
-            getSample.Play();
+            getSample?.Play();
 
             innerSpin.Spin(20000, RotationDirection.Clockwise);
             outerSpin.Spin(40000, RotationDirection.Clockwise);
@@ -216,6 +215,8 @@ namespace osu.Game.Overlays
                     leftStrip.ResizeWidthTo(1f, step_duration, Easing.OutQuint);
                     rightStrip.ResizeWidthTo(1f, step_duration, Easing.OutQuint);
 
+                    Debug.Assert(drawableMedal != null);
+
                     this.Animate().Schedule(() =>
                     {
                         if (drawableMedal.State != DisplayState.Full)
@@ -245,7 +246,7 @@ namespace osu.Game.Overlays
 
         public void Dismiss()
         {
-            if (drawableMedal.State != DisplayState.Full)
+            if (drawableMedal != null && drawableMedal.State != DisplayState.Full)
             {
                 // if we haven't yet, play out the animation fully
                 drawableMedal.State = DisplayState.Full;

From e5be8838e68e10cc11c14dc11f5ee1dbfb5a69eb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 20 Feb 2024 18:42:01 +0100
Subject: [PATCH 110/930] Fix yet another failure

---
 osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
index fe9c524285..5dc553b9df 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneMedalOverlay.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using Moq;
 using Newtonsoft.Json.Linq;
 using NUnit.Framework;
@@ -51,6 +52,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 Slug = @"all-intro-doubletime"
             });
             AddUntilStep("overlay shown", () => overlay.State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddUntilStep("wait for load", () => this.ChildrenOfType<MedalAnimation>().Any());
             AddRepeatStep("dismiss", () => InputManager.Key(Key.Escape), 2);
             AddUntilStep("overlay hidden", () => overlay.State.Value, () => Is.EqualTo(Visibility.Hidden));
         }

From 0074bdc5a17be66df7dd656106973829e0909bc8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 22 Feb 2024 19:15:02 +0100
Subject: [PATCH 111/930] Change `ResultsScreen` constructor boolean params to
 init-only properties

---
 .../Background/TestSceneUserDimBackgrounds.cs |  3 ++-
 .../TestScenePlaylistsResultsScreen.cs        |  5 +++--
 .../Visual/Ranking/TestSceneResultsScreen.cs  |  6 ++++--
 osu.Game/OsuGame.cs                           |  2 +-
 .../Multiplayer/MultiplayerResultsScreen.cs   |  2 +-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |  5 ++++-
 .../Playlists/PlaylistsResultsScreen.cs       |  4 ++--
 .../Playlists/PlaylistsRoomSubScreen.cs       |  2 +-
 osu.Game/Screens/Play/Player.cs               |  5 +++--
 osu.Game/Screens/Play/ReplayPlayer.cs         |  2 +-
 .../Screens/Play/SpectatorResultsScreen.cs    |  2 +-
 osu.Game/Screens/Ranking/ResultsScreen.cs     | 19 ++++++++++++-------
 osu.Game/Screens/Ranking/SoloResultsScreen.cs |  4 ++--
 osu.Game/Screens/Select/PlaySongSelect.cs     |  2 +-
 14 files changed, 38 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 566ccd6bd5..204dea39b2 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -349,8 +349,9 @@ namespace osu.Game.Tests.Visual.Background
         private partial class FadeAccessibleResults : ResultsScreen
         {
             public FadeAccessibleResults(ScoreInfo score)
-                : base(score, true)
+                : base(score)
             {
+                AllowRetry = true;
             }
 
             protected override BackgroundScreen CreateBackground() => new FadeAccessibleBackground(Beatmap.Value);
diff --git a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
index 25ee20b089..fca965052f 100644
--- a/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Playlists/TestScenePlaylistsResultsScreen.cs
@@ -420,9 +420,10 @@ namespace osu.Game.Tests.Visual.Playlists
             public new LoadingSpinner RightSpinner => base.RightSpinner;
             public new ScorePanelList ScorePanelList => base.ScorePanelList;
 
-            public TestResultsScreen([CanBeNull] ScoreInfo score, int roomId, PlaylistItem playlistItem, bool allowRetry = true)
-                : base(score, roomId, playlistItem, allowRetry)
+            public TestResultsScreen([CanBeNull] ScoreInfo score, int roomId, PlaylistItem playlistItem)
+                : base(score, roomId, playlistItem)
             {
+                AllowRetry = true;
             }
         }
     }
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index cf4bec54ff..ffc5dbc8fb 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -399,8 +399,9 @@ namespace osu.Game.Tests.Visual.Ranking
             public HotkeyRetryOverlay RetryOverlay;
 
             public TestResultsScreen(ScoreInfo score)
-                : base(score, true)
+                : base(score)
             {
+                AllowRetry = true;
                 ShowUserStatistics = true;
             }
 
@@ -470,8 +471,9 @@ namespace osu.Game.Tests.Visual.Ranking
             public HotkeyRetryOverlay RetryOverlay;
 
             public UnrankedSoloResultsScreen(ScoreInfo score)
-                : base(score, true)
+                : base(score)
             {
+                AllowRetry = true;
                 Score!.BeatmapInfo!.OnlineID = 0;
                 Score.BeatmapInfo.Status = BeatmapOnlineStatus.Pending;
             }
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9ffa88947b..ec44076520 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -768,7 +768,7 @@ namespace osu.Game
                         break;
 
                     case ScorePresentType.Results:
-                        screen.Push(new SoloResultsScreen(databasedScore.ScoreInfo, false));
+                        screen.Push(new SoloResultsScreen(databasedScore.ScoreInfo));
                         break;
                 }
             }, validScreens: validScreens);
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs
index f665ed2d41..6ed75508dc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerResultsScreen.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
     public partial class MultiplayerResultsScreen : PlaylistsResultsScreen
     {
         public MultiplayerResultsScreen(ScoreInfo score, long roomId, PlaylistItem playlistItem)
-            : base(score, roomId, playlistItem, false)
+            : base(score, roomId, playlistItem)
         {
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index b0e4585986..74454959a1 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -58,7 +58,10 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         protected override ResultsScreen CreateResults(ScoreInfo score)
         {
             Debug.Assert(Room.RoomID.Value != null);
-            return new PlaylistsResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem, true);
+            return new PlaylistsResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem)
+            {
+                AllowRetry = true,
+            };
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index 6a1924dea2..add7aee8cd 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -41,8 +41,8 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         [Resolved]
         private RulesetStore rulesets { get; set; }
 
-        public PlaylistsResultsScreen([CanBeNull] ScoreInfo score, long roomId, PlaylistItem playlistItem, bool allowRetry, bool allowWatchingReplay = true)
-            : base(score, allowRetry, allowWatchingReplay)
+        public PlaylistsResultsScreen([CanBeNull] ScoreInfo score, long roomId, PlaylistItem playlistItem)
+            : base(score)
         {
             this.roomId = roomId;
             this.playlistItem = playlistItem;
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
index 2460f78c96..3fb9de428a 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsRoomSubScreen.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
                                             RequestResults = item =>
                                             {
                                                 Debug.Assert(RoomId.Value != null);
-                                                ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item, false));
+                                                ParentScreen?.Push(new PlaylistsResultsScreen(null, RoomId.Value.Value, item));
                                             }
                                         }
                                     },
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 11ff5fdbef..8383936f7c 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1224,9 +1224,10 @@ namespace osu.Game.Screens.Play
         /// </summary>
         /// <param name="score">The <see cref="ScoreInfo"/> to be displayed in the results screen.</param>
         /// <returns>The <see cref="ResultsScreen"/>.</returns>
-        protected virtual ResultsScreen CreateResults(ScoreInfo score) => new SoloResultsScreen(score, true)
+        protected virtual ResultsScreen CreateResults(ScoreInfo score) => new SoloResultsScreen(score)
         {
-            ShowUserStatistics = true
+            AllowRetry = true,
+            ShowUserStatistics = true,
         };
 
         private void fadeOut(bool instant = false)
diff --git a/osu.Game/Screens/Play/ReplayPlayer.cs b/osu.Game/Screens/Play/ReplayPlayer.cs
index 3c5b85662a..ff60dbc0d0 100644
--- a/osu.Game/Screens/Play/ReplayPlayer.cs
+++ b/osu.Game/Screens/Play/ReplayPlayer.cs
@@ -92,7 +92,7 @@ namespace osu.Game.Screens.Play
                 Scores = { BindTarget = LeaderboardScores }
             };
 
-        protected override ResultsScreen CreateResults(ScoreInfo score) => new SoloResultsScreen(score, false);
+        protected override ResultsScreen CreateResults(ScoreInfo score) => new SoloResultsScreen(score);
 
         public bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
diff --git a/osu.Game/Screens/Play/SpectatorResultsScreen.cs b/osu.Game/Screens/Play/SpectatorResultsScreen.cs
index 393cbddb34..5ee2a5ce0e 100644
--- a/osu.Game/Screens/Play/SpectatorResultsScreen.cs
+++ b/osu.Game/Screens/Play/SpectatorResultsScreen.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Screens.Play
     public partial class SpectatorResultsScreen : SoloResultsScreen
     {
         public SpectatorResultsScreen(ScoreInfo score)
-            : base(score, false)
+            : base(score)
         {
         }
 
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 69cfbed8f2..6beb4d7401 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -63,16 +63,21 @@ namespace osu.Game.Screens.Ranking
 
         private bool lastFetchCompleted;
 
-        private readonly bool allowRetry;
-        private readonly bool allowWatchingReplay;
+        /// <summary>
+        /// Whether the user can retry the beatmap from the results screen.
+        /// </summary>
+        public bool AllowRetry { get; init; }
+
+        /// <summary>
+        /// Whether the user can watch the replay of the completed play from the results screen.
+        /// </summary>
+        public bool AllowWatchingReplay { get; init; } = true;
 
         private Sample popInSample;
 
-        protected ResultsScreen([CanBeNull] ScoreInfo score, bool allowRetry, bool allowWatchingReplay = true)
+        protected ResultsScreen([CanBeNull] ScoreInfo score)
         {
             Score = score;
-            this.allowRetry = allowRetry;
-            this.allowWatchingReplay = allowWatchingReplay;
 
             SelectedScore.Value = score;
         }
@@ -162,7 +167,7 @@ namespace osu.Game.Screens.Ranking
                 ScorePanelList.AddScore(Score, shouldFlair);
             }
 
-            if (allowWatchingReplay)
+            if (AllowWatchingReplay)
             {
                 buttons.Add(new ReplayDownloadButton(SelectedScore.Value)
                 {
@@ -171,7 +176,7 @@ namespace osu.Game.Screens.Ranking
                 });
             }
 
-            if (player != null && allowRetry)
+            if (player != null && AllowRetry)
             {
                 buttons.Add(new RetryButton { Width = 300 });
 
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 866440bbd6..38bc13ffb9 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -34,8 +34,8 @@ namespace osu.Game.Screens.Ranking
         private IBindable<SoloStatisticsUpdate?> latestUpdate = null!;
         private readonly Bindable<SoloStatisticsUpdate?> statisticsUpdate = new Bindable<SoloStatisticsUpdate?>();
 
-        public SoloResultsScreen(ScoreInfo score, bool allowRetry)
-            : base(score, allowRetry)
+        public SoloResultsScreen(ScoreInfo score)
+            : base(score)
         {
         }
 
diff --git a/osu.Game/Screens/Select/PlaySongSelect.cs b/osu.Game/Screens/Select/PlaySongSelect.cs
index 7b7b8857f3..52f49ba56a 100644
--- a/osu.Game/Screens/Select/PlaySongSelect.cs
+++ b/osu.Game/Screens/Select/PlaySongSelect.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Screens.Select
         }
 
         protected void PresentScore(ScoreInfo score) =>
-            FinaliseSelection(score.BeatmapInfo, score.Ruleset, () => this.Push(new SoloResultsScreen(score, false)));
+            FinaliseSelection(score.BeatmapInfo, score.Ruleset, () => this.Push(new SoloResultsScreen(score)));
 
         protected override BeatmapDetailArea CreateBeatmapDetailArea()
         {

From 1e53503608aa683a97e3f7f3ca1e9855929c9f94 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 22 Feb 2024 19:49:14 +0100
Subject: [PATCH 112/930] Show user statistics after completing a playlists /
 multiplayer score

---
 .../Ranking/TestSceneStatisticsPanel.cs       |  4 +-
 .../Multiplayer/MultiplayerPlayer.cs          |  8 +++-
 .../OnlinePlay/Playlists/PlaylistsPlayer.cs   |  1 +
 osu.Game/Screens/Ranking/ResultsScreen.cs     | 16 ++++++-
 osu.Game/Screens/Ranking/SoloResultsScreen.cs | 43 -------------------
 ...tisticsPanel.cs => UserStatisticsPanel.cs} | 26 +++++++++--
 6 files changed, 46 insertions(+), 52 deletions(-)
 rename osu.Game/Screens/Ranking/Statistics/{SoloStatisticsPanel.cs => UserStatisticsPanel.cs} (55%)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index d0a45856b2..c7bd52ce8e 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -82,12 +82,12 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private void loadPanel(ScoreInfo score) => AddStep("load panel", () =>
         {
-            Child = new SoloStatisticsPanel(score)
+            Child = new UserStatisticsPanel(score)
             {
                 RelativeSizeAxes = Axes.Both,
                 State = { Value = Visibility.Visible },
                 Score = { Value = score },
-                StatisticsUpdate =
+                DisplayedUserStatisticsUpdate =
                 {
                     Value = new SoloStatisticsUpdate(score, new UserStatistics
                     {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
index c5c536eae6..e560c5ca5d 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerPlayer.cs
@@ -200,7 +200,13 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
 
             return multiplayerLeaderboard.TeamScores.Count == 2
                 ? new MultiplayerTeamResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem, multiplayerLeaderboard.TeamScores)
-                : new MultiplayerResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem);
+                {
+                    ShowUserStatistics = true,
+                }
+                : new MultiplayerResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem)
+                {
+                    ShowUserStatistics = true
+                };
         }
 
         protected override void Dispose(bool isDisposing)
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
index 74454959a1..48f63731e1 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsPlayer.cs
@@ -61,6 +61,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             return new PlaylistsResultsScreen(score, Room.RoomID.Value.Value, PlaylistItem)
             {
                 AllowRetry = true,
+                ShowUserStatistics = true,
             };
         }
 
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 6beb4d7401..b63c753721 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -73,6 +73,13 @@ namespace osu.Game.Screens.Ranking
         /// </summary>
         public bool AllowWatchingReplay { get; init; } = true;
 
+        /// <summary>
+        /// Whether the user's personal statistics should be shown on the extended statistics panel
+        /// after clicking the score panel associated with the <see cref="ResultsScreen.Score"/> being presented.
+        /// Requires <see cref="Score"/> to be present.
+        /// </summary>
+        public bool ShowUserStatistics { get; init; }
+
         private Sample popInSample;
 
         protected ResultsScreen([CanBeNull] ScoreInfo score)
@@ -105,7 +112,7 @@ namespace osu.Game.Screens.Ranking
                                 RelativeSizeAxes = Axes.Both,
                                 Children = new Drawable[]
                                 {
-                                    StatisticsPanel = CreateStatisticsPanel().With(panel =>
+                                    StatisticsPanel = createStatisticsPanel().With(panel =>
                                     {
                                         panel.RelativeSizeAxes = Axes.Both;
                                         panel.Score.BindTarget = SelectedScore;
@@ -243,7 +250,12 @@ namespace osu.Game.Screens.Ranking
         /// <summary>
         /// Creates the <see cref="Statistics.StatisticsPanel"/> to be used to display extended information about scores.
         /// </summary>
-        protected virtual StatisticsPanel CreateStatisticsPanel() => new StatisticsPanel();
+        private StatisticsPanel createStatisticsPanel()
+        {
+            return ShowUserStatistics && Score != null
+                ? new UserStatisticsPanel(Score)
+                : new StatisticsPanel();
+        }
 
         private void fetchScoresCallback(IEnumerable<ScoreInfo> scores) => Schedule(() =>
         {
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index 38bc13ffb9..ee0251b5ac 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -6,70 +6,27 @@ using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
-using osu.Game.Online.Solo;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
-using osu.Game.Screens.Ranking.Statistics;
 
 namespace osu.Game.Screens.Ranking
 {
     public partial class SoloResultsScreen : ResultsScreen
     {
-        /// <summary>
-        /// Whether the user's personal statistics should be shown on the extended statistics panel
-        /// after clicking the score panel associated with the <see cref="ResultsScreen.Score"/> being presented.
-        /// </summary>
-        public bool ShowUserStatistics { get; init; }
-
         private GetScoresRequest? getScoreRequest;
 
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
-        private IBindable<SoloStatisticsUpdate?> latestUpdate = null!;
-        private readonly Bindable<SoloStatisticsUpdate?> statisticsUpdate = new Bindable<SoloStatisticsUpdate?>();
-
         public SoloResultsScreen(ScoreInfo score)
             : base(score)
         {
         }
 
-        [BackgroundDependencyLoader]
-        private void load(SoloStatisticsWatcher? soloStatisticsWatcher)
-        {
-            if (ShowUserStatistics && soloStatisticsWatcher != null)
-            {
-                Debug.Assert(Score != null);
-
-                latestUpdate = soloStatisticsWatcher.LatestUpdate.GetBoundCopy();
-                latestUpdate.BindValueChanged(update =>
-                {
-                    if (update.NewValue?.Score.MatchesOnlineID(Score) == true)
-                        statisticsUpdate.Value = update.NewValue;
-                });
-            }
-        }
-
-        protected override StatisticsPanel CreateStatisticsPanel()
-        {
-            Debug.Assert(Score != null);
-
-            if (ShowUserStatistics)
-            {
-                return new SoloStatisticsPanel(Score)
-                {
-                    StatisticsUpdate = { BindTarget = statisticsUpdate }
-                };
-            }
-
-            return base.CreateStatisticsPanel();
-        }
-
         protected override APIRequest? FetchScores(Action<IEnumerable<ScoreInfo>>? scoresCallback)
         {
             Debug.Assert(Score != null);
diff --git a/osu.Game/Screens/Ranking/Statistics/SoloStatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
similarity index 55%
rename from osu.Game/Screens/Ranking/Statistics/SoloStatisticsPanel.cs
rename to osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
index 762be61853..280e5ec90f 100644
--- a/osu.Game/Screens/Ranking/Statistics/SoloStatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
@@ -3,25 +3,43 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
+using osu.Game.Extensions;
 using osu.Game.Online.Solo;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics.User;
 
 namespace osu.Game.Screens.Ranking.Statistics
 {
-    public partial class SoloStatisticsPanel : StatisticsPanel
+    public partial class UserStatisticsPanel : StatisticsPanel
     {
         private readonly ScoreInfo achievedScore;
 
-        public SoloStatisticsPanel(ScoreInfo achievedScore)
+        internal readonly Bindable<SoloStatisticsUpdate?> DisplayedUserStatisticsUpdate = new Bindable<SoloStatisticsUpdate?>();
+
+        private IBindable<SoloStatisticsUpdate?> latestGlobalStatisticsUpdate = null!;
+
+        public UserStatisticsPanel(ScoreInfo achievedScore)
         {
             this.achievedScore = achievedScore;
         }
 
-        public Bindable<SoloStatisticsUpdate?> StatisticsUpdate { get; } = new Bindable<SoloStatisticsUpdate?>();
+        [BackgroundDependencyLoader]
+        private void load(SoloStatisticsWatcher? soloStatisticsWatcher)
+        {
+            if (soloStatisticsWatcher != null)
+            {
+                latestGlobalStatisticsUpdate = soloStatisticsWatcher.LatestUpdate.GetBoundCopy();
+                latestGlobalStatisticsUpdate.BindValueChanged(update =>
+                {
+                    if (update.NewValue?.Score.MatchesOnlineID(achievedScore) == true)
+                        DisplayedUserStatisticsUpdate.Value = update.NewValue;
+                });
+            }
+        }
 
         protected override ICollection<StatisticItem> CreateStatisticItems(ScoreInfo newScore, IBeatmap playableBeatmap)
         {
@@ -37,7 +55,7 @@ namespace osu.Game.Screens.Ranking.Statistics
                     RelativeSizeAxes = Axes.X,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    StatisticsUpdate = { BindTarget = StatisticsUpdate }
+                    StatisticsUpdate = { BindTarget = DisplayedUserStatisticsUpdate }
                 })).ToArray();
             }
 

From eac4c5f69d6a201ced50c19fd826d8d618c9b7ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 22 Feb 2024 19:50:46 +0100
Subject: [PATCH 113/930] Rename `{Solo -> User}StatisticsWatcher` et al.

The "solo" prefix is a bit unbecoming now. The updates are not only
for solo.
---
 .../Menus/TestSceneToolbarUserButton.cs       | 10 +++++-----
 .../Online/TestSceneSoloStatisticsWatcher.cs  | 20 +++++++++----------
 .../Visual/Ranking/TestSceneOverallRanking.cs |  2 +-
 .../Ranking/TestSceneStatisticsPanel.cs       |  2 +-
 ...sticsUpdate.cs => UserStatisticsUpdate.cs} |  6 +++---
 ...icsWatcher.cs => UserStatisticsWatcher.cs} |  8 ++++----
 osu.Game/OsuGame.cs                           |  2 +-
 .../TransientUserStatisticsUpdateDisplay.cs   |  6 +++---
 osu.Game/Screens/Play/SubmittingPlayer.cs     |  4 ++--
 .../Ranking/Statistics/User/OverallRanking.cs |  4 ++--
 .../Statistics/User/RankingChangeRow.cs       |  4 ++--
 .../Ranking/Statistics/UserStatisticsPanel.cs |  6 +++---
 12 files changed, 37 insertions(+), 37 deletions(-)
 rename osu.Game/Online/Solo/{SoloStatisticsUpdate.cs => UserStatisticsUpdate.cs} (88%)
 rename osu.Game/Online/Solo/{SoloStatisticsWatcher.cs => UserStatisticsWatcher.cs} (93%)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
index 69fedf4a3a..41ce739c2f 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Gain", () =>
             {
                 var transientUpdateDisplay = this.ChildrenOfType<TransientUserStatisticsUpdateDisplay>().Single();
-                transientUpdateDisplay.LatestUpdate.Value = new SoloStatisticsUpdate(
+                transientUpdateDisplay.LatestUpdate.Value = new UserStatisticsUpdate(
                     new ScoreInfo(),
                     new UserStatistics
                     {
@@ -116,7 +116,7 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Loss", () =>
             {
                 var transientUpdateDisplay = this.ChildrenOfType<TransientUserStatisticsUpdateDisplay>().Single();
-                transientUpdateDisplay.LatestUpdate.Value = new SoloStatisticsUpdate(
+                transientUpdateDisplay.LatestUpdate.Value = new UserStatisticsUpdate(
                     new ScoreInfo(),
                     new UserStatistics
                     {
@@ -132,7 +132,7 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("No change", () =>
             {
                 var transientUpdateDisplay = this.ChildrenOfType<TransientUserStatisticsUpdateDisplay>().Single();
-                transientUpdateDisplay.LatestUpdate.Value = new SoloStatisticsUpdate(
+                transientUpdateDisplay.LatestUpdate.Value = new UserStatisticsUpdate(
                     new ScoreInfo(),
                     new UserStatistics
                     {
@@ -148,7 +148,7 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Was null", () =>
             {
                 var transientUpdateDisplay = this.ChildrenOfType<TransientUserStatisticsUpdateDisplay>().Single();
-                transientUpdateDisplay.LatestUpdate.Value = new SoloStatisticsUpdate(
+                transientUpdateDisplay.LatestUpdate.Value = new UserStatisticsUpdate(
                     new ScoreInfo(),
                     new UserStatistics
                     {
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Visual.Menus
             AddStep("Became null", () =>
             {
                 var transientUpdateDisplay = this.ChildrenOfType<TransientUserStatisticsUpdateDisplay>().Single();
-                transientUpdateDisplay.LatestUpdate.Value = new SoloStatisticsUpdate(
+                transientUpdateDisplay.LatestUpdate.Value = new UserStatisticsUpdate(
                     new ScoreInfo(),
                     new UserStatistics
                     {
diff --git a/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs b/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs
index 19121b7f58..733769b9f3 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Tests.Visual.Online
     {
         protected override bool UseOnlineAPI => false;
 
-        private SoloStatisticsWatcher watcher = null!;
+        private UserStatisticsWatcher watcher = null!;
 
         [Resolved]
         private SpectatorClient spectatorClient { get; set; } = null!;
@@ -107,7 +107,7 @@ namespace osu.Game.Tests.Visual.Online
 
             AddStep("create watcher", () =>
             {
-                Child = watcher = new SoloStatisticsWatcher();
+                Child = watcher = new UserStatisticsWatcher();
             });
         }
 
@@ -123,7 +123,7 @@ namespace osu.Game.Tests.Visual.Online
 
             var ruleset = new OsuRuleset().RulesetInfo;
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             feignScoreProcessing(userId, ruleset, 5_000_000);
@@ -146,7 +146,7 @@ namespace osu.Game.Tests.Visual.Online
             // note ordering - in this test processing completes *before* the registration is added.
             feignScoreProcessing(userId, ruleset, 5_000_000);
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             AddStep("signal score processed", () => ((ISpectatorClient)spectatorClient).UserScoreProcessed(userId, scoreId));
@@ -164,7 +164,7 @@ namespace osu.Game.Tests.Visual.Online
             long scoreId = getScoreId();
             var ruleset = new OsuRuleset().RulesetInfo;
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             feignScoreProcessing(userId, ruleset, 5_000_000);
@@ -191,7 +191,7 @@ namespace osu.Game.Tests.Visual.Online
             long scoreId = getScoreId();
             var ruleset = new OsuRuleset().RulesetInfo;
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             feignScoreProcessing(userId, ruleset, 5_000_000);
@@ -212,7 +212,7 @@ namespace osu.Game.Tests.Visual.Online
             long scoreId = getScoreId();
             var ruleset = new OsuRuleset().RulesetInfo;
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             feignScoreProcessing(userId, ruleset, 5_000_000);
@@ -241,7 +241,7 @@ namespace osu.Game.Tests.Visual.Online
 
             feignScoreProcessing(userId, ruleset, 6_000_000);
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(secondScoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             AddStep("signal score processed", () => ((ISpectatorClient)spectatorClient).UserScoreProcessed(userId, secondScoreId));
@@ -259,7 +259,7 @@ namespace osu.Game.Tests.Visual.Online
 
             var ruleset = new OsuRuleset().RulesetInfo;
 
-            SoloStatisticsUpdate? update = null;
+            UserStatisticsUpdate? update = null;
             registerForUpdates(scoreId, ruleset, receivedUpdate => update = receivedUpdate);
 
             feignScoreProcessing(userId, ruleset, 5_000_000);
@@ -289,7 +289,7 @@ namespace osu.Game.Tests.Visual.Online
             });
         }
 
-        private void registerForUpdates(long scoreId, RulesetInfo rulesetInfo, Action<SoloStatisticsUpdate> onUpdateReady) =>
+        private void registerForUpdates(long scoreId, RulesetInfo rulesetInfo, Action<UserStatisticsUpdate> onUpdateReady) =>
             AddStep("register for updates", () =>
             {
                 watcher.RegisterForStatisticsUpdateAfter(
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs b/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
index 355a572f95..ee0ab0c880 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
@@ -112,6 +112,6 @@ namespace osu.Game.Tests.Visual.Ranking
         });
 
         private void displayUpdate(UserStatistics before, UserStatistics after) =>
-            AddStep("display update", () => overallRanking.StatisticsUpdate.Value = new SoloStatisticsUpdate(new ScoreInfo(), before, after));
+            AddStep("display update", () => overallRanking.StatisticsUpdate.Value = new UserStatisticsUpdate(new ScoreInfo(), before, after));
     }
 }
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index c7bd52ce8e..ecb8073a88 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Tests.Visual.Ranking
                 Score = { Value = score },
                 DisplayedUserStatisticsUpdate =
                 {
-                    Value = new SoloStatisticsUpdate(score, new UserStatistics
+                    Value = new UserStatisticsUpdate(score, new UserStatistics
                     {
                         Level = new UserStatistics.LevelInfo
                         {
diff --git a/osu.Game/Online/Solo/SoloStatisticsUpdate.cs b/osu.Game/Online/Solo/UserStatisticsUpdate.cs
similarity index 88%
rename from osu.Game/Online/Solo/SoloStatisticsUpdate.cs
rename to osu.Game/Online/Solo/UserStatisticsUpdate.cs
index cb9dac97c7..03f3abbb66 100644
--- a/osu.Game/Online/Solo/SoloStatisticsUpdate.cs
+++ b/osu.Game/Online/Solo/UserStatisticsUpdate.cs
@@ -9,7 +9,7 @@ namespace osu.Game.Online.Solo
     /// <summary>
     /// Contains data about the change in a user's profile statistics after completing a score.
     /// </summary>
-    public class SoloStatisticsUpdate
+    public class UserStatisticsUpdate
     {
         /// <summary>
         /// The score set by the user that triggered the update.
@@ -27,12 +27,12 @@ namespace osu.Game.Online.Solo
         public UserStatistics After { get; }
 
         /// <summary>
-        /// Creates a new <see cref="SoloStatisticsUpdate"/>.
+        /// Creates a new <see cref="UserStatisticsUpdate"/>.
         /// </summary>
         /// <param name="score">The score set by the user that triggered the update.</param>
         /// <param name="before">The user's profile statistics prior to the score being set.</param>
         /// <param name="after">The user's profile statistics after the score was set.</param>
-        public SoloStatisticsUpdate(ScoreInfo score, UserStatistics before, UserStatistics after)
+        public UserStatisticsUpdate(ScoreInfo score, UserStatistics before, UserStatistics after)
         {
             Score = score;
             Before = before;
diff --git a/osu.Game/Online/Solo/SoloStatisticsWatcher.cs b/osu.Game/Online/Solo/UserStatisticsWatcher.cs
similarity index 93%
rename from osu.Game/Online/Solo/SoloStatisticsWatcher.cs
rename to osu.Game/Online/Solo/UserStatisticsWatcher.cs
index 2072e8633f..2fff92fe0f 100644
--- a/osu.Game/Online/Solo/SoloStatisticsWatcher.cs
+++ b/osu.Game/Online/Solo/UserStatisticsWatcher.cs
@@ -20,10 +20,10 @@ namespace osu.Game.Online.Solo
     /// <summary>
     /// A persistent component that binds to the spectator server and API in order to deliver updates about the logged in user's gameplay statistics.
     /// </summary>
-    public partial class SoloStatisticsWatcher : Component
+    public partial class UserStatisticsWatcher : Component
     {
-        public IBindable<SoloStatisticsUpdate?> LatestUpdate => latestUpdate;
-        private readonly Bindable<SoloStatisticsUpdate?> latestUpdate = new Bindable<SoloStatisticsUpdate?>();
+        public IBindable<UserStatisticsUpdate?> LatestUpdate => latestUpdate;
+        private readonly Bindable<UserStatisticsUpdate?> latestUpdate = new Bindable<UserStatisticsUpdate?>();
 
         [Resolved]
         private SpectatorClient spectatorClient { get; set; } = null!;
@@ -120,7 +120,7 @@ namespace osu.Game.Online.Solo
             latestStatistics.TryGetValue(rulesetName, out UserStatistics? latestRulesetStatistics);
             latestRulesetStatistics ??= new UserStatistics();
 
-            latestUpdate.Value = new SoloStatisticsUpdate(scoreInfo, latestRulesetStatistics, updatedStatistics);
+            latestUpdate.Value = new UserStatisticsUpdate(scoreInfo, latestRulesetStatistics, updatedStatistics);
             latestStatistics[rulesetName] = updatedStatistics;
         }
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ec44076520..419e31bacd 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1022,7 +1022,7 @@ namespace osu.Game
                 ScreenStack.Push(CreateLoader().With(l => l.RelativeSizeAxes = Axes.Both));
             });
 
-            loadComponentSingleFile(new SoloStatisticsWatcher(), Add, true);
+            loadComponentSingleFile(new UserStatisticsWatcher(), Add, true);
             loadComponentSingleFile(Toolbar = new Toolbar
             {
                 OnHome = delegate
diff --git a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
index f56a1a3dd2..e7a78f8b80 100644
--- a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
@@ -21,13 +21,13 @@ namespace osu.Game.Overlays.Toolbar
 {
     public partial class TransientUserStatisticsUpdateDisplay : CompositeDrawable
     {
-        public Bindable<SoloStatisticsUpdate?> LatestUpdate { get; } = new Bindable<SoloStatisticsUpdate?>();
+        public Bindable<UserStatisticsUpdate?> LatestUpdate { get; } = new Bindable<UserStatisticsUpdate?>();
 
         private Statistic<int> globalRank = null!;
         private Statistic<decimal> pp = null!;
 
         [BackgroundDependencyLoader]
-        private void load(SoloStatisticsWatcher? soloStatisticsWatcher)
+        private void load(UserStatisticsWatcher? soloStatisticsWatcher)
         {
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
@@ -48,7 +48,7 @@ namespace osu.Game.Overlays.Toolbar
             };
 
             if (soloStatisticsWatcher != null)
-                ((IBindable<SoloStatisticsUpdate?>)LatestUpdate).BindTo(soloStatisticsWatcher.LatestUpdate);
+                ((IBindable<UserStatisticsUpdate?>)LatestUpdate).BindTo(soloStatisticsWatcher.LatestUpdate);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index ecb507f382..ee88171789 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Play
 
         [Resolved(canBeNull: true)]
         [CanBeNull]
-        private SoloStatisticsWatcher soloStatisticsWatcher { get; set; }
+        private UserStatisticsWatcher userStatisticsWatcher { get; set; }
 
         private readonly object scoreSubmissionLock = new object();
         private TaskCompletionSource<bool> scoreSubmissionSource;
@@ -189,7 +189,7 @@ namespace osu.Game.Screens.Play
 
             await submitScore(score).ConfigureAwait(false);
             spectatorClient.EndPlaying(GameplayState);
-            soloStatisticsWatcher?.RegisterForStatisticsUpdateAfter(score.ScoreInfo);
+            userStatisticsWatcher?.RegisterForStatisticsUpdateAfter(score.ScoreInfo);
         }
 
         [Resolved]
diff --git a/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs b/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
index d08a654e99..5c96a2b6c3 100644
--- a/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
+++ b/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Screens.Ranking.Statistics.User
     {
         private const float transition_duration = 300;
 
-        public Bindable<SoloStatisticsUpdate?> StatisticsUpdate { get; } = new Bindable<SoloStatisticsUpdate?>();
+        public Bindable<UserStatisticsUpdate?> StatisticsUpdate { get; } = new Bindable<UserStatisticsUpdate?>();
 
         private LoadingLayer loadingLayer = null!;
         private GridContainer content = null!;
@@ -86,7 +86,7 @@ namespace osu.Game.Screens.Ranking.Statistics.User
             FinishTransforms(true);
         }
 
-        private void onUpdateReceived(ValueChangedEvent<SoloStatisticsUpdate?> update)
+        private void onUpdateReceived(ValueChangedEvent<UserStatisticsUpdate?> update)
         {
             if (update.NewValue == null)
             {
diff --git a/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs b/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
index 906bf8d5ca..a477f38cd1 100644
--- a/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
+++ b/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Screens.Ranking.Statistics.User
 {
     public abstract partial class RankingChangeRow<T> : CompositeDrawable
     {
-        public Bindable<SoloStatisticsUpdate?> StatisticsUpdate { get; } = new Bindable<SoloStatisticsUpdate?>();
+        public Bindable<UserStatisticsUpdate?> StatisticsUpdate { get; } = new Bindable<UserStatisticsUpdate?>();
 
         private readonly Func<UserStatistics, T> accessor;
 
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Ranking.Statistics.User
             StatisticsUpdate.BindValueChanged(onStatisticsUpdate, true);
         }
 
-        private void onStatisticsUpdate(ValueChangedEvent<SoloStatisticsUpdate?> statisticsUpdate)
+        private void onStatisticsUpdate(ValueChangedEvent<UserStatisticsUpdate?> statisticsUpdate)
         {
             var update = statisticsUpdate.NewValue;
 
diff --git a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
index 280e5ec90f..7f8c12ddab 100644
--- a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
@@ -18,9 +18,9 @@ namespace osu.Game.Screens.Ranking.Statistics
     {
         private readonly ScoreInfo achievedScore;
 
-        internal readonly Bindable<SoloStatisticsUpdate?> DisplayedUserStatisticsUpdate = new Bindable<SoloStatisticsUpdate?>();
+        internal readonly Bindable<UserStatisticsUpdate?> DisplayedUserStatisticsUpdate = new Bindable<UserStatisticsUpdate?>();
 
-        private IBindable<SoloStatisticsUpdate?> latestGlobalStatisticsUpdate = null!;
+        private IBindable<UserStatisticsUpdate?> latestGlobalStatisticsUpdate = null!;
 
         public UserStatisticsPanel(ScoreInfo achievedScore)
         {
@@ -28,7 +28,7 @@ namespace osu.Game.Screens.Ranking.Statistics
         }
 
         [BackgroundDependencyLoader]
-        private void load(SoloStatisticsWatcher? soloStatisticsWatcher)
+        private void load(UserStatisticsWatcher? soloStatisticsWatcher)
         {
             if (soloStatisticsWatcher != null)
             {

From d6beae2ce1d34d0efb17eaf9ccc531a72a757ecf Mon Sep 17 00:00:00 2001
From: Brandon <brandondong96@gmail.com>
Date: Thu, 22 Feb 2024 19:10:15 -0800
Subject: [PATCH 114/930] Update delete/restore mod presets message when none

---
 .../MaintenanceSettingsStrings.cs             | 10 +++++++
 .../Sections/Maintenance/ModPresetSettings.cs | 27 ++++++++++++++-----
 2 files changed, 31 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Localisation/MaintenanceSettingsStrings.cs b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
index 469f565f1e..2511e7aecc 100644
--- a/osu.Game/Localisation/MaintenanceSettingsStrings.cs
+++ b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
@@ -109,11 +109,21 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString DeletedAllModPresets => new TranslatableString(getKey(@"deleted_all_mod_presets"), @"Deleted all mod presets!");
 
+        /// <summary>
+        /// "No mod presets found to delete!"
+        /// </summary>
+        public static LocalisableString NoModPresetsFoundToDelete => new TranslatableString(getKey(@"no_mod_presets_found_to_delete"), @"No mod presets found to delete!");
+
         /// <summary>
         /// "Restored all deleted mod presets!"
         /// </summary>
         public static LocalisableString RestoredAllDeletedModPresets => new TranslatableString(getKey(@"restored_all_deleted_mod_presets"), @"Restored all deleted mod presets!");
 
+        /// <summary>
+        /// "No mod presets found to restore!"
+        /// </summary>
+        public static LocalisableString NoModPresetsFoundToRestore => new TranslatableString(getKey(@"no_mod_presets_found_to_restore"), @"No mod presets found to restore!");
+
         /// <summary>
         /// "Please select your osu!stable install location"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
index ba45d9c896..f0d6d10e51 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
@@ -4,6 +4,7 @@
 using System.Linq;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Framework.Logging;
@@ -52,36 +53,50 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
             });
         }
 
-        private void deleteAllModPresets() =>
+        private bool deleteAllModPresets() =>
             realm.Write(r =>
             {
+                bool anyDeleted = false;
+
                 foreach (var preset in r.All<ModPreset>())
+                {
+                    anyDeleted |= !preset.DeletePending;
                     preset.DeletePending = true;
+                }
+
+                return anyDeleted;
             });
 
-        private void onAllModPresetsDeleted(Task deletionTask)
+        private void onAllModPresetsDeleted(Task<bool> deletionTask)
         {
             deleteAllButton.Enabled.Value = true;
 
             if (deletionTask.IsCompletedSuccessfully)
-                notificationOverlay?.Post(new ProgressCompletionNotification { Text = MaintenanceSettingsStrings.DeletedAllModPresets });
+                notificationOverlay?.Post(new ProgressCompletionNotification { Text = deletionTask.GetResultSafely() ? MaintenanceSettingsStrings.DeletedAllModPresets : MaintenanceSettingsStrings.NoModPresetsFoundToDelete });
             else if (deletionTask.IsFaulted)
                 Logger.Error(deletionTask.Exception, "Failed to delete all mod presets");
         }
 
-        private void undeleteModPresets() =>
+        private bool undeleteModPresets() =>
             realm.Write(r =>
             {
+                bool anyRestored = false;
+
                 foreach (var preset in r.All<ModPreset>().Where(preset => preset.DeletePending))
+                {
+                    anyRestored |= preset.DeletePending;
                     preset.DeletePending = false;
+                }
+
+                return anyRestored;
             });
 
-        private void onModPresetsUndeleted(Task undeletionTask)
+        private void onModPresetsUndeleted(Task<bool> undeletionTask)
         {
             undeleteButton.Enabled.Value = true;
 
             if (undeletionTask.IsCompletedSuccessfully)
-                notificationOverlay?.Post(new ProgressCompletionNotification { Text = MaintenanceSettingsStrings.RestoredAllDeletedModPresets });
+                notificationOverlay?.Post(new ProgressCompletionNotification { Text = undeletionTask.GetResultSafely() ? MaintenanceSettingsStrings.RestoredAllDeletedModPresets : MaintenanceSettingsStrings.NoModPresetsFoundToRestore });
             else if (undeletionTask.IsFaulted)
                 Logger.Error(undeletionTask.Exception, "Failed to restore mod presets");
         }

From 6c8204f9a35cfcc11b4a6fc9003b50dd30e37960 Mon Sep 17 00:00:00 2001
From: Brandon <brandondong96@gmail.com>
Date: Thu, 22 Feb 2024 19:40:02 -0800
Subject: [PATCH 115/930] Update delete collections message when none

---
 .../Localisation/MaintenanceSettingsStrings.cs  |  5 +++++
 .../Sections/Maintenance/CollectionsSettings.cs | 17 +++++++++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Localisation/MaintenanceSettingsStrings.cs b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
index 2511e7aecc..2e5f1d29df 100644
--- a/osu.Game/Localisation/MaintenanceSettingsStrings.cs
+++ b/osu.Game/Localisation/MaintenanceSettingsStrings.cs
@@ -104,6 +104,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString DeletedAllCollections => new TranslatableString(getKey(@"deleted_all_collections"), @"Deleted all collections!");
 
+        /// <summary>
+        /// "No collections found to delete!"
+        /// </summary>
+        public static LocalisableString NoCollectionsFoundToDelete => new TranslatableString(getKey(@"no_collections_found_to_delete"), @"No collections found to delete!");
+
         /// <summary>
         /// "Deleted all mod presets!"
         /// </summary>
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
index 09acc22c25..b373535a8b 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Localisation;
 using osu.Game.Collections;
@@ -35,8 +36,20 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
 
         private void deleteAllCollections()
         {
-            realm.Write(r => r.RemoveAll<BeatmapCollection>());
-            notificationOverlay?.Post(new ProgressCompletionNotification { Text = MaintenanceSettingsStrings.DeletedAllCollections });
+            bool anyDeleted = realm.Write(r =>
+            {
+                if (r.All<BeatmapCollection>().Any())
+                {
+                    r.RemoveAll<BeatmapCollection>();
+                    return true;
+                }
+                else
+                {
+                    return false;
+                }
+            });
+
+            notificationOverlay?.Post(new ProgressCompletionNotification { Text = anyDeleted ? MaintenanceSettingsStrings.DeletedAllCollections : MaintenanceSettingsStrings.NoCollectionsFoundToDelete });
         }
     }
 }

From 157819c19931b581abf36cbcf3538f70637d970c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 23 Feb 2024 11:23:11 +0800
Subject: [PATCH 116/930] Materialise realm collection hashes during song
 select search process

Without this, there's a large overhead to do a realm-live `Contains`
search when a collection is selected.

This may also help considerably alleviate
https://github.com/ppy/osu/discussions/27298#discussioncomment-8552508
as we will be performing the native realm search much less.
---
 osu.Game/Screens/Select/FilterControl.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 1827eb58ca..6fd22364f6 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -4,6 +4,7 @@
 #nullable disable
 
 using System;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -64,7 +65,7 @@ namespace osu.Game.Screens.Select
                 Sort = sortMode.Value,
                 AllowConvertedBeatmaps = showConverted.Value,
                 Ruleset = ruleset.Value,
-                CollectionBeatmapMD5Hashes = collectionDropdown.Current.Value?.Collection?.PerformRead(c => c.BeatmapMD5Hashes)
+                CollectionBeatmapMD5Hashes = collectionDropdown.Current.Value?.Collection?.PerformRead(c => c.BeatmapMD5Hashes).ToList()
             };
 
             if (!minimumStars.IsDefault)

From 0113fce02f5888dd775402ed4c15550826a5e999 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 11:27:12 +0100
Subject: [PATCH 117/930] Add osu!taiko `Constant Speed` mod

---
 .../Mods/TaikoModConstantSpeed.cs             | 31 +++++++++++++++++++
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       |  1 +
 2 files changed, 32 insertions(+)
 create mode 100644 osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
new file mode 100644
index 0000000000..28de360eee
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
@@ -0,0 +1,31 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Taiko.Beatmaps;
+
+namespace osu.Game.Rulesets.Taiko.Mods
+{
+    public class TaikoModConstantSpeed : Mod, IApplicableToBeatmap
+    {
+        public override string Name => "Constant Speed";
+        public override string Acronym => "CS";
+        public override double ScoreMultiplier => 0.8;
+        public override LocalisableString Description => "No more tricky speed changes!";
+        public override IconUsage? Icon => FontAwesome.Solid.Equals;
+        public override ModType Type => ModType.Conversion;
+
+        public void ApplyToBeatmap(IBeatmap beatmap)
+        {
+            var taikoBeatmap = (TaikoBeatmap)beatmap;
+
+            foreach (var effectControlPoint in taikoBeatmap.ControlPointInfo.EffectPoints)
+            {
+                effectControlPoint.ScrollSpeed = 1;
+            }
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 24b0ec5d57..b701d3c25a 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -150,6 +150,7 @@ namespace osu.Game.Rulesets.Taiko
                         new TaikoModClassic(),
                         new TaikoModSwap(),
                         new TaikoModSingleTap(),
+                        new TaikoModConstantSpeed(),
                     };
 
                 case ModType.Automation:

From 1cbc2f07ab039c54d3788063e5028ab34577937a Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 14:01:12 +0100
Subject: [PATCH 118/930] use more correct implementation

---
 .../Mods/TaikoModConstantSpeed.cs             | 20 +++++++++----------
 .../UI/DrawableTaikoRuleset.cs                |  7 ++++++-
 2 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
index 28de360eee..4ecb94467e 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
@@ -1,15 +1,17 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Localisation;
 using osu.Framework.Graphics.Sprites;
-using osu.Game.Beatmaps;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Rulesets.Taiko.Objects;
+using osu.Game.Rulesets.Taiko.UI;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Taiko.Beatmaps;
+using osu.Game.Rulesets.UI;
 
 namespace osu.Game.Rulesets.Taiko.Mods
 {
-    public class TaikoModConstantSpeed : Mod, IApplicableToBeatmap
+    public class TaikoModConstantSpeed : Mod, IApplicableToDrawableRuleset<TaikoHitObject>
     {
         public override string Name => "Constant Speed";
         public override string Acronym => "CS";
@@ -18,14 +20,10 @@ namespace osu.Game.Rulesets.Taiko.Mods
         public override IconUsage? Icon => FontAwesome.Solid.Equals;
         public override ModType Type => ModType.Conversion;
 
-        public void ApplyToBeatmap(IBeatmap beatmap)
+        public void ApplyToDrawableRuleset(DrawableRuleset<TaikoHitObject> drawableRuleset)
         {
-            var taikoBeatmap = (TaikoBeatmap)beatmap;
-
-            foreach (var effectControlPoint in taikoBeatmap.ControlPointInfo.EffectPoints)
-            {
-                effectControlPoint.ScrollSpeed = 1;
-            }
+            var taikoRuleset = (DrawableTaikoRuleset)drawableRuleset;
+            taikoRuleset.VisualisationMethod = ScrollVisualisationMethod.Constant;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index 77b2b06c0e..a476634fb8 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -69,7 +69,12 @@ namespace osu.Game.Rulesets.Taiko.UI
             TimeRange.Value = ComputeTimeRange();
         }
 
-        protected virtual double ComputeTimeRange() => PlayfieldAdjustmentContainer.ComputeTimeRange();
+        protected virtual double ComputeTimeRange()
+        {
+            // Adjust when we're using constant algorithm to not be sluggish.
+            double multiplier = VisualisationMethod == ScrollVisualisationMethod.Overlapping ? 1 : 4;
+            return PlayfieldAdjustmentContainer.ComputeTimeRange() / multiplier;
+        }
 
         protected override void UpdateAfterChildren()
         {

From 14b0c41937f39906ddaf86d4919baadf2d5c2174 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 14:22:56 +0100
Subject: [PATCH 119/930] remove unnecessary `ComputeTimeRange` override

---
 osu.Game.Rulesets.Taiko/Edit/DrawableTaikoEditorRuleset.cs | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Edit/DrawableTaikoEditorRuleset.cs b/osu.Game.Rulesets.Taiko/Edit/DrawableTaikoEditorRuleset.cs
index 3c7a97c864..217bb8139c 100644
--- a/osu.Game.Rulesets.Taiko/Edit/DrawableTaikoEditorRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/DrawableTaikoEditorRuleset.cs
@@ -26,12 +26,5 @@ namespace osu.Game.Rulesets.Taiko.Edit
 
             ShowSpeedChanges.BindValueChanged(showChanges => VisualisationMethod = showChanges.NewValue ? ScrollVisualisationMethod.Overlapping : ScrollVisualisationMethod.Constant, true);
         }
-
-        protected override double ComputeTimeRange()
-        {
-            // Adjust when we're using constant algorithm to not be sluggish.
-            double multiplier = ShowSpeedChanges.Value ? 1 : 4;
-            return base.ComputeTimeRange() / multiplier;
-        }
     }
 }

From 7762d2469b59c4a349d5a05119f0c7a007cd0c5e Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 14:24:26 +0100
Subject: [PATCH 120/930] exclude EZ/HR for now

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
index 4ecb94467e..117dc0ebd2 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
@@ -1,6 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Linq;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
@@ -19,6 +21,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
         public override LocalisableString Description => "No more tricky speed changes!";
         public override IconUsage? Icon => FontAwesome.Solid.Equals;
         public override ModType Type => ModType.Conversion;
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModEasy), typeof(TaikoModHardRock) }).ToArray();
 
         public void ApplyToDrawableRuleset(DrawableRuleset<TaikoHitObject> drawableRuleset)
         {

From d1d32fc16cf6474ec8661c83dbd6bd282cff172b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 23 Feb 2024 14:49:46 +0100
Subject: [PATCH 121/930] Fix editor displaying combo colours in effectively
 incorrect order

Addresses https://github.com/ppy/osu/discussions/27316.

Stable lies about the first combo colour being first; in the `.osu`
file it is actually second. It does a thing in editor itself to correct
for this.

    https://github.com/peppy/osu-stable-reference/blob/master/osu!/GameModes/Edit/Forms/SongSetup.cs#L233-L234
---
 osu.Game/Screens/Edit/EditorBeatmapSkin.cs | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
index 80239504d8..71530ee5bc 100644
--- a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
@@ -4,7 +4,7 @@
 #nullable disable
 
 using System;
-using System.Linq;
+using System.Collections.Generic;
 using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -38,8 +38,17 @@ namespace osu.Game.Screens.Edit
             Skin = skin;
 
             ComboColours = new BindableList<Colour4>();
-            if (Skin.Configuration.ComboColours != null)
-                ComboColours.AddRange(Skin.Configuration.ComboColours.Select(c => (Colour4)c));
+
+            if (Skin.Configuration.ComboColours is IReadOnlyList<Color4> comboColours)
+            {
+                // due to the foibles of how `IHasComboInformation` / `ComboIndexWithOffsets` work,
+                // the actual effective first combo colour that will be used on the beatmap is the one with index 1, not 0.
+                // see also: `IHasComboInformation.UpdateComboInformation`,
+                // https://github.com/peppy/osu-stable-reference/blob/46cd3a10af7cc6cc96f4eba92ef1812dc8c3a27e/osu!/GameModes/Edit/Forms/SongSetup.cs#L233-L234.
+                for (int i = 0; i < comboColours.Count; ++i)
+                    ComboColours.Add(comboColours[(i + 1) % comboColours.Count]);
+            }
+
             ComboColours.BindCollectionChanged((_, _) => updateColours());
         }
 
@@ -47,7 +56,10 @@ namespace osu.Game.Screens.Edit
 
         private void updateColours()
         {
-            Skin.Configuration.CustomComboColours = ComboColours.Select(c => (Color4)c).ToList();
+            // performs the inverse of the index rotation operation described in the ctor.
+            Skin.Configuration.CustomComboColours.Clear();
+            for (int i = 0; i < ComboColours.Count; ++i)
+                Skin.Configuration.CustomComboColours.Add(ComboColours[(ComboColours.Count + i - 1) % ComboColours.Count]);
             invokeSkinChanged();
         }
 

From ae9c58be3030cb5c0b3c0148446afbf8edf452ac Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 16:42:58 +0300
Subject: [PATCH 122/930] Remove "multiplayer" references from subclass and
 move to appropriate place

---
 .../OnlinePlay/Match/RoomModSelectOverlay.cs} | 24 ++++++++++---------
 .../Screens/OnlinePlay/Match/RoomSubScreen.cs |  2 +-
 2 files changed, 14 insertions(+), 12 deletions(-)
 rename osu.Game/{Overlays/Mods/MultiplayerModSelectOverlay.cs => Screens/OnlinePlay/Match/RoomModSelectOverlay.cs} (72%)

diff --git a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
similarity index 72%
rename from osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
rename to osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index ee087bb149..00704b7ec7 100644
--- a/osu.Game/Overlays/Mods/MultiplayerModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -1,4 +1,4 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
@@ -6,26 +6,28 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
-using osu.Game.Rulesets;
 using osu.Game.Online.Rooms;
+using osu.Game.Overlays;
+using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 
-namespace osu.Game.Overlays.Mods
+namespace osu.Game.Screens.OnlinePlay.Match
 {
-    public partial class MultiplayerModSelectOverlay : UserModSelectOverlay
+    public partial class RoomModSelectOverlay : UserModSelectOverlay
     {
-        public MultiplayerModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Plum)
+        public RoomModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Plum)
             : base(colourScheme)
         {
         }
 
         [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+        private IBindable<PlaylistItem>? selectedItem { get; set; }
 
         [Resolved]
         private OsuGameBase game { get; set; } = null!;
 
-        protected override BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new MultiplayerBeatmapAttributesDisplay
+        protected override BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new RoomBeatmapAttributesDisplay
         {
             Anchor = Anchor.BottomRight,
             Origin = Anchor.BottomRight,
@@ -35,7 +37,7 @@ namespace osu.Game.Overlays.Mods
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            multiplayerRoomItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
+            selectedItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
         }
 
         protected override IEnumerable<Mod> AllSelectedMods
@@ -44,10 +46,10 @@ namespace osu.Game.Overlays.Mods
             {
                 IEnumerable<Mod> allMods = SelectedMods.Value;
 
-                if (multiplayerRoomItem?.Value != null)
+                if (selectedItem?.Value != null)
                 {
                     Ruleset ruleset = game.Ruleset.Value.CreateInstance();
-                    var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
+                    var multiplayerRoomMods = selectedItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
                     allMods = allMods.Concat(multiplayerRoomMods);
                 }
 
@@ -56,7 +58,7 @@ namespace osu.Game.Overlays.Mods
         }
     }
 
-    public partial class MultiplayerBeatmapAttributesDisplay : BeatmapAttributesDisplay
+    public partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
     {
         [Resolved(CanBeNull = true)]
         private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
index b20760b114..97fbb83992 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomSubScreen.cs
@@ -241,7 +241,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
                 }
             };
 
-            LoadComponent(UserModsSelectOverlay = new MultiplayerModSelectOverlay
+            LoadComponent(UserModsSelectOverlay = new RoomModSelectOverlay
             {
                 SelectedMods = { BindTarget = UserMods },
                 IsValidMod = _ => false

From f94cd4483cb4f4b0a4b8cd189975ccca92f54720 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 16:47:37 +0300
Subject: [PATCH 123/930] Avoid relying on game-wide ruleset bindable

---
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 24 +++++++++++--------
 1 file changed, 14 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index 00704b7ec7..e6ff2260e9 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -25,7 +26,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
         private IBindable<PlaylistItem>? selectedItem { get; set; }
 
         [Resolved]
-        private OsuGameBase game { get; set; } = null!;
+        private RulesetStore rulesets { get; set; } = null!;
 
         protected override BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new RoomBeatmapAttributesDisplay
         {
@@ -48,9 +49,9 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
                 if (selectedItem?.Value != null)
                 {
-                    Ruleset ruleset = game.Ruleset.Value.CreateInstance();
-                    var multiplayerRoomMods = selectedItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-                    allMods = allMods.Concat(multiplayerRoomMods);
+                    var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
+                    Debug.Assert(rulesetInstance != null);
+                    allMods = allMods.Concat(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
 
                 return allMods;
@@ -61,12 +62,15 @@ namespace osu.Game.Screens.OnlinePlay.Match
     public partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
     {
         [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? multiplayerRoomItem { get; set; }
+        private IBindable<PlaylistItem>? selectedItem { get; set; }
+
+        [Resolved]
+        private RulesetStore rulesets { get; set; } = null!;
 
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            multiplayerRoomItem?.BindValueChanged(_ => Mods.TriggerChange());
+            selectedItem?.BindValueChanged(_ => Mods.TriggerChange());
         }
 
         protected override IEnumerable<Mod> SelectedMods
@@ -75,11 +79,11 @@ namespace osu.Game.Screens.OnlinePlay.Match
             {
                 IEnumerable<Mod> selectedMods = Mods.Value;
 
-                if (multiplayerRoomItem?.Value != null)
+                if (selectedItem?.Value != null)
                 {
-                    Ruleset ruleset = GameRuleset.Value.CreateInstance();
-                    var multiplayerRoomMods = multiplayerRoomItem.Value.RequiredMods.Select(m => m.ToMod(ruleset));
-                    selectedMods = selectedMods.Concat(multiplayerRoomMods);
+                    var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
+                    Debug.Assert(rulesetInstance != null);
+                    selectedMods = selectedMods.Concat(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
 
                 return selectedMods;

From f86b7f0702790bd21522f86501ca9a19e771d018 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 23 Feb 2024 14:52:44 +0100
Subject: [PATCH 124/930] Enable NRT in `EditorBeatmapSkin`

---
 osu.Game/Screens/Edit/EditorBeatmapSkin.cs | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
index 71530ee5bc..07fa1cb49c 100644
--- a/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmapSkin.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using osu.Framework.Audio.Sample;
@@ -20,7 +18,7 @@ namespace osu.Game.Screens.Edit
     /// </summary>
     public class EditorBeatmapSkin : ISkin
     {
-        public event Action BeatmapSkinChanged;
+        public event Action? BeatmapSkinChanged;
 
         /// <summary>
         /// The underlying beatmap skin.
@@ -65,10 +63,14 @@ namespace osu.Game.Screens.Edit
 
         #region Delegated ISkin implementation
 
-        public Drawable GetDrawableComponent(ISkinComponentLookup lookup) => Skin.GetDrawableComponent(lookup);
-        public Texture GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => Skin.GetTexture(componentName, wrapModeS, wrapModeT);
-        public ISample GetSample(ISampleInfo sampleInfo) => Skin.GetSample(sampleInfo);
-        public IBindable<TValue> GetConfig<TLookup, TValue>(TLookup lookup) => Skin.GetConfig<TLookup, TValue>(lookup);
+        public Drawable? GetDrawableComponent(ISkinComponentLookup lookup) => Skin.GetDrawableComponent(lookup);
+        public Texture? GetTexture(string componentName, WrapMode wrapModeS, WrapMode wrapModeT) => Skin.GetTexture(componentName, wrapModeS, wrapModeT);
+        public ISample? GetSample(ISampleInfo sampleInfo) => Skin.GetSample(sampleInfo);
+
+        public IBindable<TValue>? GetConfig<TLookup, TValue>(TLookup lookup)
+            where TLookup : notnull
+            where TValue : notnull
+            => Skin.GetConfig<TLookup, TValue>(lookup);
 
         #endregion
     }

From 918577d530c0fa27fc58f2677a731df23b20d230 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 16:51:52 +0300
Subject: [PATCH 125/930] Compute required mods list once per update

---
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 36 +++++++++----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index e6ff2260e9..5406912f49 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -35,28 +35,28 @@ namespace osu.Game.Screens.OnlinePlay.Match
             BeatmapInfo = { Value = Beatmap?.BeatmapInfo }
         };
 
+        private readonly List<Mod> roomMods = new List<Mod>();
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            selectedItem?.BindValueChanged(_ => SelectedMods.TriggerChange());
-        }
 
-        protected override IEnumerable<Mod> AllSelectedMods
-        {
-            get
+            selectedItem?.BindValueChanged(_ =>
             {
-                IEnumerable<Mod> allMods = SelectedMods.Value;
+                roomMods.Clear();
 
                 if (selectedItem?.Value != null)
                 {
                     var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
                     Debug.Assert(rulesetInstance != null);
-                    allMods = allMods.Concat(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                    roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
 
-                return allMods;
-            }
+                SelectedMods.TriggerChange();
+            });
         }
+
+        protected override IEnumerable<Mod> AllSelectedMods => roomMods.Concat(base.AllSelectedMods);
     }
 
     public partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
@@ -67,27 +67,27 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
+        private readonly List<Mod> roomMods = new List<Mod>();
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
-            selectedItem?.BindValueChanged(_ => Mods.TriggerChange());
-        }
 
-        protected override IEnumerable<Mod> SelectedMods
-        {
-            get
+            selectedItem?.BindValueChanged(_ =>
             {
-                IEnumerable<Mod> selectedMods = Mods.Value;
+                roomMods.Clear();
 
                 if (selectedItem?.Value != null)
                 {
                     var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
                     Debug.Assert(rulesetInstance != null);
-                    selectedMods = selectedMods.Concat(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                    roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
 
-                return selectedMods;
-            }
+                Mods.TriggerChange();
+            });
         }
+
+        protected override IEnumerable<Mod> SelectedMods => roomMods.Concat(base.SelectedMods);
     }
 }

From 323d7f8e2dabbd090c29b51926338cece1a94f64 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 16:59:08 +0300
Subject: [PATCH 126/930] Change `BeatmapAttributesDisplay` retrieval to proper
 method

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 16 +++---
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 56 +++++++++----------
 2 files changed, 33 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 8a3b1954ed..99981c28d5 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -130,13 +130,6 @@ namespace osu.Game.Overlays.Mods
         private RankingInformationDisplay? rankingInformationDisplay;
         private BeatmapAttributesDisplay? beatmapAttributesDisplay;
 
-        protected virtual BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new BeatmapAttributesDisplay
-        {
-            Anchor = Anchor.BottomRight,
-            Origin = Anchor.BottomRight,
-            BeatmapInfo = { Value = Beatmap?.BeatmapInfo }
-        };
-
         protected ShearedButton BackButton { get; private set; } = null!;
         protected ShearedToggleButton? CustomisationButton { get; private set; }
         protected SelectAllModsButton? SelectAllModsButton { get; set; }
@@ -283,7 +276,12 @@ namespace osu.Game.Overlays.Mods
                             Anchor = Anchor.BottomRight,
                             Origin = Anchor.BottomRight
                         },
-                        beatmapAttributesDisplay = GetBeatmapAttributesDisplay
+                        beatmapAttributesDisplay = CreateBeatmapAttributesDisplay().With(b =>
+                        {
+                            b.Anchor = Anchor.BottomRight;
+                            b.Origin = Anchor.BottomRight;
+                            b.BeatmapInfo.Value = Beatmap?.BeatmapInfo;
+                        }),
                     }
                 });
             }
@@ -293,6 +291,8 @@ namespace osu.Game.Overlays.Mods
             textSearchStartsActive = configManager.GetBindable<bool>(OsuSetting.ModSelectTextSearchStartsActive);
         }
 
+        protected virtual BeatmapAttributesDisplay CreateBeatmapAttributesDisplay() => new BeatmapAttributesDisplay();
+
         public override void Hide()
         {
             base.Hide();
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index 5406912f49..4bf8e22d4e 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -6,7 +6,6 @@ using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Graphics;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
@@ -28,13 +27,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
-        protected override BeatmapAttributesDisplay GetBeatmapAttributesDisplay => new RoomBeatmapAttributesDisplay
-        {
-            Anchor = Anchor.BottomRight,
-            Origin = Anchor.BottomRight,
-            BeatmapInfo = { Value = Beatmap?.BeatmapInfo }
-        };
-
         private readonly List<Mod> roomMods = new List<Mod>();
 
         protected override void LoadComplete()
@@ -57,37 +49,39 @@ namespace osu.Game.Screens.OnlinePlay.Match
         }
 
         protected override IEnumerable<Mod> AllSelectedMods => roomMods.Concat(base.AllSelectedMods);
-    }
 
-    public partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
-    {
-        [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? selectedItem { get; set; }
+        protected override BeatmapAttributesDisplay CreateBeatmapAttributesDisplay() => new RoomBeatmapAttributesDisplay();
 
-        [Resolved]
-        private RulesetStore rulesets { get; set; } = null!;
-
-        private readonly List<Mod> roomMods = new List<Mod>();
-
-        protected override void LoadComplete()
+        private partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
         {
-            base.LoadComplete();
+            [Resolved(CanBeNull = true)]
+            private IBindable<PlaylistItem>? selectedItem { get; set; }
 
-            selectedItem?.BindValueChanged(_ =>
+            [Resolved]
+            private RulesetStore rulesets { get; set; } = null!;
+
+            private readonly List<Mod> roomMods = new List<Mod>();
+
+            protected override void LoadComplete()
             {
-                roomMods.Clear();
+                base.LoadComplete();
 
-                if (selectedItem?.Value != null)
+                selectedItem?.BindValueChanged(_ =>
                 {
-                    var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
-                    Debug.Assert(rulesetInstance != null);
-                    roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
-                }
+                    roomMods.Clear();
 
-                Mods.TriggerChange();
-            });
+                    if (selectedItem?.Value != null)
+                    {
+                        var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
+                        Debug.Assert(rulesetInstance != null);
+                        roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                    }
+
+                    Mods.TriggerChange();
+                });
+            }
+
+            protected override IEnumerable<Mod> SelectedMods => roomMods.Concat(base.SelectedMods);
         }
-
-        protected override IEnumerable<Mod> SelectedMods => roomMods.Concat(base.SelectedMods);
     }
 }

From 9ce07a96b2f98358050eacb4d72767fc1dede2cc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 17:28:54 +0300
Subject: [PATCH 127/930] Rewrite mods flow and remove
 `RoomBeatmapAttributesDisplay`

---
 .../Overlays/Mods/BeatmapAttributesDisplay.cs | 26 ++++---------
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 34 +++++++++++------
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 37 +------------------
 3 files changed, 31 insertions(+), 66 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 7c3c971d76..8f84b51127 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -13,7 +13,6 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
-using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -39,15 +38,10 @@ namespace osu.Game.Overlays.Mods
 
         public Bindable<IBeatmapInfo?> BeatmapInfo { get; } = new Bindable<IBeatmapInfo?>();
 
-        [Resolved]
-        protected Bindable<IReadOnlyList<Mod>> Mods { get; private set; } = null!;
-
-        protected virtual IEnumerable<Mod> SelectedMods => Mods.Value;
+        public Bindable<IReadOnlyList<Mod>> Mods { get; } = new Bindable<IReadOnlyList<Mod>>();
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
-        private ModSettingChangeTracker? modSettingChangeTracker;
-
         [Resolved]
         private BeatmapDifficultyCache difficultyCache { get; set; } = null!;
 
@@ -102,15 +96,8 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            Mods.BindValueChanged(_ =>
-            {
-                modSettingChangeTracker?.Dispose();
-                modSettingChangeTracker = new ModSettingChangeTracker(Mods.Value);
-                modSettingChangeTracker.SettingChanged += _ => updateValues();
-                updateValues();
-            }, true);
-
-            BeatmapInfo.BindValueChanged(_ => updateValues(), true);
+            Mods.BindValueChanged(_ => updateValues());
+            BeatmapInfo.BindValueChanged(_ => updateValues());
 
             Collapsed.BindValueChanged(_ =>
             {
@@ -122,8 +109,9 @@ namespace osu.Game.Overlays.Mods
             GameRuleset = game.Ruleset.GetBoundCopy();
             GameRuleset.BindValueChanged(_ => updateValues());
 
-            BeatmapInfo.BindValueChanged(_ => updateValues(), true);
+            BeatmapInfo.BindValueChanged(_ => updateValues());
 
+            updateValues();
             updateCollapsedState();
         }
 
@@ -167,14 +155,14 @@ namespace osu.Game.Overlays.Mods
             });
 
             double rate = 1;
-            foreach (var mod in SelectedMods.OfType<IApplicableToRate>())
+            foreach (var mod in Mods.Value.OfType<IApplicableToRate>())
                 rate = mod.ApplyToRate(0, rate);
 
             bpmDisplay.Current.Value = BeatmapInfo.Value.BPM * rate;
 
             BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(BeatmapInfo.Value.Difficulty);
 
-            foreach (var mod in SelectedMods.OfType<IApplicableToDifficulty>())
+            foreach (var mod in Mods.Value.OfType<IApplicableToDifficulty>())
                 mod.ApplyToDifficulty(originalDifficulty);
 
             Ruleset ruleset = GameRuleset.Value.CreateInstance();
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 99981c28d5..fa87b0aa0d 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -114,8 +114,6 @@ namespace osu.Game.Overlays.Mods
 
         public IEnumerable<ModState> AllAvailableMods => AvailableMods.Value.SelectMany(pair => pair.Value);
 
-        protected virtual IEnumerable<Mod> AllSelectedMods => SelectedMods.Value;
-
         private readonly BindableBool customisationVisible = new BindableBool();
         private Bindable<bool> textSearchStartsActive = null!;
 
@@ -319,7 +317,7 @@ namespace osu.Game.Overlays.Mods
 
             SelectedMods.BindValueChanged(_ =>
             {
-                updateRankingInformation();
+                UpdateOverlayInformation(SelectedMods.Value);
                 updateFromExternalSelection();
                 updateCustomisation();
 
@@ -332,7 +330,7 @@ namespace osu.Game.Overlays.Mods
                     //
                     // See https://github.com/ppy/osu/pull/23284#issuecomment-1529056988
                     modSettingChangeTracker = new ModSettingChangeTracker(SelectedMods.Value);
-                    modSettingChangeTracker.SettingChanged += _ => updateRankingInformation();
+                    modSettingChangeTracker.SettingChanged += _ => UpdateOverlayInformation(SelectedMods.Value);
                 }
             }, true);
 
@@ -454,18 +452,30 @@ namespace osu.Game.Overlays.Mods
                 modState.ValidForSelection.Value = modState.Mod.Type != ModType.System && modState.Mod.HasImplementation && IsValidMod.Invoke(modState.Mod);
         }
 
-        private void updateRankingInformation()
+        /// <summary>
+        /// Updates any information displayed on the overlay regarding the effects of the selected mods.
+        /// </summary>
+        /// <param name="mods">The list of mods to show effect from. This can be overriden to include effect of mods that are not part of the <see cref="SelectedMods"/> bindable (e.g. room mods in multiplayer/playlists).</param>
+        protected virtual void UpdateOverlayInformation(IReadOnlyList<Mod> mods)
         {
-            if (rankingInformationDisplay == null)
-                return;
+            if (rankingInformationDisplay != null)
+            {
+                double multiplier = 1.0;
 
-            double multiplier = 1.0;
+                foreach (var mod in mods)
+                    multiplier *= mod.ScoreMultiplier;
 
-            foreach (var mod in AllSelectedMods)
-                multiplier *= mod.ScoreMultiplier;
+                rankingInformationDisplay.ModMultiplier.Value = multiplier;
+                rankingInformationDisplay.Ranked.Value = mods.All(m => m.Ranked);
+            }
 
-            rankingInformationDisplay.ModMultiplier.Value = multiplier;
-            rankingInformationDisplay.Ranked.Value = AllSelectedMods.All(m => m.Ranked);
+            if (beatmapAttributesDisplay != null)
+            {
+                if (!ReferenceEquals(beatmapAttributesDisplay.Mods.Value, mods))
+                    beatmapAttributesDisplay.Mods.Value = mods;
+                else
+                    beatmapAttributesDisplay.Mods.TriggerChange(); // mods list may be same but a mod setting has changed, trigger change in that case.
+            }
         }
 
         private void updateCustomisation()
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index 4bf8e22d4e..dd0ecbad90 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -48,40 +48,7 @@ namespace osu.Game.Screens.OnlinePlay.Match
             });
         }
 
-        protected override IEnumerable<Mod> AllSelectedMods => roomMods.Concat(base.AllSelectedMods);
-
-        protected override BeatmapAttributesDisplay CreateBeatmapAttributesDisplay() => new RoomBeatmapAttributesDisplay();
-
-        private partial class RoomBeatmapAttributesDisplay : BeatmapAttributesDisplay
-        {
-            [Resolved(CanBeNull = true)]
-            private IBindable<PlaylistItem>? selectedItem { get; set; }
-
-            [Resolved]
-            private RulesetStore rulesets { get; set; } = null!;
-
-            private readonly List<Mod> roomMods = new List<Mod>();
-
-            protected override void LoadComplete()
-            {
-                base.LoadComplete();
-
-                selectedItem?.BindValueChanged(_ =>
-                {
-                    roomMods.Clear();
-
-                    if (selectedItem?.Value != null)
-                    {
-                        var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
-                        Debug.Assert(rulesetInstance != null);
-                        roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
-                    }
-
-                    Mods.TriggerChange();
-                });
-            }
-
-            protected override IEnumerable<Mod> SelectedMods => roomMods.Concat(base.SelectedMods);
-        }
+        protected override void UpdateOverlayInformation(IReadOnlyList<Mod> mods)
+            => base.UpdateOverlayInformation(roomMods.Concat(mods).ToList());
     }
 }

From fdc0636554ca83daf3762c229feee047f34966b5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 17:30:31 +0300
Subject: [PATCH 128/930] General code cleanup

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 12 +++++-----
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 22 +++++++++----------
 2 files changed, 16 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index fa87b0aa0d..bf43dc3d9c 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -274,12 +274,12 @@ namespace osu.Game.Overlays.Mods
                             Anchor = Anchor.BottomRight,
                             Origin = Anchor.BottomRight
                         },
-                        beatmapAttributesDisplay = CreateBeatmapAttributesDisplay().With(b =>
+                        beatmapAttributesDisplay = new BeatmapAttributesDisplay
                         {
-                            b.Anchor = Anchor.BottomRight;
-                            b.Origin = Anchor.BottomRight;
-                            b.BeatmapInfo.Value = Beatmap?.BeatmapInfo;
-                        }),
+                            Anchor = Anchor.BottomRight,
+                            Origin = Anchor.BottomRight,
+                            BeatmapInfo = { Value = Beatmap?.BeatmapInfo },
+                        },
                     }
                 });
             }
@@ -289,8 +289,6 @@ namespace osu.Game.Overlays.Mods
             textSearchStartsActive = configManager.GetBindable<bool>(OsuSetting.ModSelectTextSearchStartsActive);
         }
 
-        protected virtual BeatmapAttributesDisplay CreateBeatmapAttributesDisplay() => new BeatmapAttributesDisplay();
-
         public override void Hide()
         {
             base.Hide();
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index dd0ecbad90..db7cfe980c 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -16,32 +16,32 @@ namespace osu.Game.Screens.OnlinePlay.Match
 {
     public partial class RoomModSelectOverlay : UserModSelectOverlay
     {
-        public RoomModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Plum)
-            : base(colourScheme)
-        {
-        }
-
-        [Resolved(CanBeNull = true)]
-        private IBindable<PlaylistItem>? selectedItem { get; set; }
+        [Resolved]
+        private IBindable<PlaylistItem> selectedItem { get; set; } = null!;
 
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
         private readonly List<Mod> roomMods = new List<Mod>();
 
+        public RoomModSelectOverlay()
+            : base(OverlayColourScheme.Plum)
+        {
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            selectedItem?.BindValueChanged(_ =>
+            selectedItem.BindValueChanged(_ =>
             {
                 roomMods.Clear();
 
-                if (selectedItem?.Value != null)
+                if (selectedItem.Value is PlaylistItem item)
                 {
-                    var rulesetInstance = rulesets.GetRuleset(selectedItem.Value.RulesetID)?.CreateInstance();
+                    var rulesetInstance = rulesets.GetRuleset(item.RulesetID)?.CreateInstance();
                     Debug.Assert(rulesetInstance != null);
-                    roomMods.AddRange(selectedItem.Value.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                    roomMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
 
                 SelectedMods.TriggerChange();

From 869f0a82de4272806eda4350944c7fd989f52e62 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 23 Feb 2024 15:38:52 +0100
Subject: [PATCH 129/930] Use hashset for faster lookup

---
 osu.Game/Screens/Select/FilterControl.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 6fd22364f6..17297c9ebf 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -4,7 +4,7 @@
 #nullable disable
 
 using System;
-using System.Linq;
+using System.Collections.Immutable;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -65,7 +65,7 @@ namespace osu.Game.Screens.Select
                 Sort = sortMode.Value,
                 AllowConvertedBeatmaps = showConverted.Value,
                 Ruleset = ruleset.Value,
-                CollectionBeatmapMD5Hashes = collectionDropdown.Current.Value?.Collection?.PerformRead(c => c.BeatmapMD5Hashes).ToList()
+                CollectionBeatmapMD5Hashes = collectionDropdown.Current.Value?.Collection?.PerformRead(c => c.BeatmapMD5Hashes).ToImmutableHashSet()
             };
 
             if (!minimumStars.IsDefault)

From c1db9d7819496e52db88223134d642d6cba6f0d3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 18:16:35 +0300
Subject: [PATCH 130/930] Add test coverage

---
 .../TestSceneMultiplayerMatchSubScreen.cs     | 30 +++++++++++++++++++
 .../Overlays/Mods/BeatmapAttributesDisplay.cs |  2 +-
 2 files changed, 31 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index a41eff067b..4bedc31f38 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -286,6 +286,36 @@ namespace osu.Game.Tests.Visual.Multiplayer
             });
         }
 
+        [Test]
+        [FlakyTest] // See above
+        public void TestModSelectOverlay()
+        {
+            AddStep("add playlist item", () =>
+            {
+                SelectedRoom.Value.Playlist.Add(new PlaylistItem(new TestBeatmap(new OsuRuleset().RulesetInfo).BeatmapInfo)
+                {
+                    RulesetID = new OsuRuleset().RulesetInfo.OnlineID,
+                    RequiredMods = new[]
+                    {
+                        new APIMod(new OsuModDoubleTime { SpeedChange = { Value = 2.0 } }),
+                        new APIMod(new OsuModStrictTracking()),
+                    },
+                    AllowedMods = new[]
+                    {
+                        new APIMod(new OsuModFlashlight()),
+                        new APIMod(new OsuModHardRock()),
+                    }
+                });
+            });
+            ClickButtonWhenEnabled<MultiplayerMatchSettingsOverlay.CreateOrUpdateButton>();
+
+            AddUntilStep("wait for join", () => RoomJoined);
+
+            ClickButtonWhenEnabled<RoomSubScreen.UserModSelectButton>();
+            AddAssert("mod select shows unranked", () => this.ChildrenOfType<RankingInformationDisplay>().Single().Ranked.Value == false);
+            AddAssert("mod select shows different multiplier", () => !this.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.IsDefault);
+        }
+
         private partial class TestMultiplayerMatchSubScreen : MultiplayerMatchSubScreen
         {
             [Resolved(canBeNull: true)]
diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 8f84b51127..472fe6f476 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -184,7 +184,7 @@ namespace osu.Game.Overlays.Mods
             RightContent.FadeTo(Collapsed.Value && !IsHovered ? 0 : 1, transition_duration, Easing.OutQuint);
         }
 
-        private partial class BPMDisplay : RollingCounter<double>
+        public partial class BPMDisplay : RollingCounter<double>
         {
             protected override double RollingDuration => 250;
 

From 31dabaefaa95dfb04cebe69a25b3965ae549201d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Fri, 23 Feb 2024 18:21:11 +0300
Subject: [PATCH 131/930] Reduce smoke allocations

---
 osu.Game.Rulesets.Osu/Skinning/SmokeSegment.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/SmokeSegment.cs b/osu.Game.Rulesets.Osu/Skinning/SmokeSegment.cs
index 9838cb2c37..f4fe42b8de 100644
--- a/osu.Game.Rulesets.Osu/Skinning/SmokeSegment.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/SmokeSegment.cs
@@ -4,7 +4,6 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -228,7 +227,9 @@ namespace osu.Game.Rulesets.Osu.Skinning
                 int futurePointIndex = ~Source.SmokePoints.BinarySearch(new SmokePoint { Time = CurrentTime }, new SmokePoint.UpperBoundComparer());
 
                 points.Clear();
-                points.AddRange(Source.SmokePoints.Skip(firstVisiblePointIndex).Take(futurePointIndex - firstVisiblePointIndex));
+
+                for (int i = firstVisiblePointIndex; i < futurePointIndex; i++)
+                    points.Add(Source.SmokePoints[i]);
             }
 
             protected sealed override void Draw(IRenderer renderer)

From 771cdf9cd6eb12de88691ec9cddfecd52e586c88 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 18:30:14 +0300
Subject: [PATCH 132/930] Fix `TestSceneModEffectPreviewPanel`

---
 .../Visual/UserInterface/TestSceneModEffectPreviewPanel.cs       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModEffectPreviewPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModEffectPreviewPanel.cs
index b3ad5a499e..cdb6900f06 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModEffectPreviewPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModEffectPreviewPanel.cs
@@ -57,6 +57,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
+                Mods = { BindTarget = SelectedMods },
             });
 
             AddStep("set beatmap", () =>

From d4bc3090e7fd680f0f3452a1e242fa29b09f0178 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 23 Feb 2024 18:42:07 +0300
Subject: [PATCH 133/930] Fix incorrect conflict resolution

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 3432529976..7035af1594 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -185,7 +185,7 @@ namespace osu.Game.Overlays.Mods
             RightContent.FadeTo(Collapsed.Value && !IsHovered ? 0 : 1, transition_duration, Easing.OutQuint);
         }
 
-        public partial class BPMDisplay : RollingCounter<double>
+        public partial class BPMDisplay : RollingCounter<int>
         {
             protected override double RollingDuration => 250;
 

From 65c0b73dd5c0b8a74deeab5aa737fb5d90dce82f Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 17:55:49 +0100
Subject: [PATCH 134/930] mark `TaikoModConstantSpeed` as incompatible with
 EZ/HR

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs     | 3 +++
 osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
index 009f2854f8..59d0563f1f 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
@@ -1,6 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Linq;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
@@ -10,6 +12,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     public class TaikoModEasy : ModEasy
     {
         public override LocalisableString Description => @"Beats move slower, and less accuracy required!";
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModConstantSpeed) }).ToArray();
 
         /// <summary>
         /// Multiplier factor added to the scrolling speed.
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
index ba41175461..fa948507c8 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
@@ -1,6 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 
@@ -8,6 +10,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
 {
     public class TaikoModHardRock : ModHardRock
     {
+        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModConstantSpeed) }).ToArray();
         public override double ScoreMultiplier => UsesDefaultConfiguration ? 1.06 : 1;
 
         /// <summary>

From 46a1f5267f40f03b566c4feb713de3a08a135ee8 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 21:15:18 +0100
Subject: [PATCH 135/930] account for beatmap base scroll speed in constant
 visualisation method

---
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index a476634fb8..c88bbec9bc 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         protected virtual double ComputeTimeRange()
         {
             // Adjust when we're using constant algorithm to not be sluggish.
-            double multiplier = VisualisationMethod == ScrollVisualisationMethod.Overlapping ? 1 : 4;
+            double multiplier = VisualisationMethod == ScrollVisualisationMethod.Overlapping ? 1 : 4 * Beatmap.Difficulty.SliderMultiplier;
             return PlayfieldAdjustmentContainer.ComputeTimeRange() / multiplier;
         }
 

From 4ea9519db839762a088b2ef15fc8f770b0c87905 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 23 Feb 2024 21:15:52 +0100
Subject: [PATCH 136/930] revert changes to `IncompatibleMods`

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs | 3 ---
 osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs          | 3 ---
 osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs      | 3 ---
 3 files changed, 9 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
index 117dc0ebd2..4ecb94467e 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
-using System.Linq;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Configuration;
@@ -21,7 +19,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
         public override LocalisableString Description => "No more tricky speed changes!";
         public override IconUsage? Icon => FontAwesome.Solid.Equals;
         public override ModType Type => ModType.Conversion;
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModEasy), typeof(TaikoModHardRock) }).ToArray();
 
         public void ApplyToDrawableRuleset(DrawableRuleset<TaikoHitObject> drawableRuleset)
         {
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
index 59d0563f1f..009f2854f8 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModEasy.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
-using System.Linq;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
@@ -12,7 +10,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
     public class TaikoModEasy : ModEasy
     {
         public override LocalisableString Description => @"Beats move slower, and less accuracy required!";
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModConstantSpeed) }).ToArray();
 
         /// <summary>
         /// Multiplier factor added to the scrolling speed.
diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
index fa948507c8..ba41175461 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModHardRock.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
-using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
 
@@ -10,7 +8,6 @@ namespace osu.Game.Rulesets.Taiko.Mods
 {
     public class TaikoModHardRock : ModHardRock
     {
-        public override Type[] IncompatibleMods => base.IncompatibleMods.Concat(new[] { typeof(TaikoModConstantSpeed) }).ToArray();
         public override double ScoreMultiplier => UsesDefaultConfiguration ? 1.06 : 1;
 
         /// <summary>

From 8934cf33f069d211511097861696c8af3019bb3d Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Fri, 23 Feb 2024 22:07:47 -0500
Subject: [PATCH 137/930] Apply Discord RPC changes regardless of user's status

---
 osu.Desktop/DiscordRichPresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index f990fd55fc..1944a73c0a 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -92,7 +92,7 @@ namespace osu.Desktop
                 return;
             }
 
-            if (status.Value == UserStatus.Online && activity.Value != null)
+            if (activity.Value != null)
             {
                 bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited;
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));

From e80b08c46fe45da19ffa6fba4862329333a6f112 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 24 Feb 2024 09:55:51 +0100
Subject: [PATCH 138/930] Fix incorrect standardised score estimation on
 selected beatmaps

---
 osu.Game/Database/StandardisedScoreMigrationTools.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Database/StandardisedScoreMigrationTools.cs b/osu.Game/Database/StandardisedScoreMigrationTools.cs
index 403e73ab77..0594c80390 100644
--- a/osu.Game/Database/StandardisedScoreMigrationTools.cs
+++ b/osu.Game/Database/StandardisedScoreMigrationTools.cs
@@ -365,6 +365,17 @@ namespace osu.Game.Database
                             + bonusProportion) * modMultiplier);
                     }
 
+                    // see similar check above.
+                    // if there is no legacy combo score, all combo conversion operations below
+                    // are either pointless or wildly wrong.
+                    if (maximumLegacyComboScore + maximumLegacyBonusScore == 0)
+                    {
+                        return (long)Math.Round((
+                            500000 * comboProportion // as above, zero if mods result in zero multiplier, one otherwise
+                            + 500000 * Math.Pow(score.Accuracy, 5)
+                            + bonusProportion) * modMultiplier);
+                    }
+
                     // Assumptions:
                     // - sliders and slider ticks are uniformly distributed in the beatmap, and thus can be ignored without losing much precision.
                     //   We thus consider a map of hit-circles only, which gives objectCount == maximumCombo.

From e7d8ca3292e4213b248914c7a0416b48b84b2f18 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 14:22:34 +0300
Subject: [PATCH 139/930] Fix Argon and Trianles spinner stutter

---
 osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs     | 2 +-
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
index ee9f228137..7ed6d2dce7 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
         {
             base.Update();
 
-            if (!spmContainer.IsPresent && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha != 0 && drawableSpinner.Result?.TimeStarted != null)
                 fadeCounterOnTimeStart();
         }
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index 4a76a1aec4..a5973ad444 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
         {
             base.Update();
 
-            if (!spmContainer.IsPresent && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha != 0 && drawableSpinner.Result?.TimeStarted != null)
                 fadeCounterOnTimeStart();
         }
 

From 4bc92a263f9c95eece33fe97dadc40eeddc897d7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 24 Feb 2024 13:20:42 +0100
Subject: [PATCH 140/930] Bump score version

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index c74980abb6..775d87f3f2 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -44,9 +44,10 @@ namespace osu.Game.Scoring.Legacy
         /// <see cref="LegacyRulesetExtensions.CalculateDifficultyPeppyStars"/> method. Reconvert all scores.
         /// </description></item>
         /// <item><description>30000013: All local scores will use lazer definitions of ranks for consistency. Recalculates the rank of all scores.</description></item>
+        /// <item><description>30000014: Fix edge cases in conversion for osu! scores on selected beatmaps. Reconvert all scores.</description></item>
         /// </list>
         /// </remarks>
-        public const int LATEST_VERSION = 30000013;
+        public const int LATEST_VERSION = 30000014;
 
         /// <summary>
         /// The first stable-compatible YYYYMMDD format version given to lazer usage of replays.

From f6ceedc7a6dfd727c4ea29c14bca6c63575c6dc8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sat, 24 Feb 2024 13:55:44 +0100
Subject: [PATCH 141/930] Inline last version which touched ranks when checking
 for upgrade

---
 osu.Game/Database/BackgroundDataStoreProcessor.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Database/BackgroundDataStoreProcessor.cs b/osu.Game/Database/BackgroundDataStoreProcessor.cs
index be0c83bdb3..872194aa1d 100644
--- a/osu.Game/Database/BackgroundDataStoreProcessor.cs
+++ b/osu.Game/Database/BackgroundDataStoreProcessor.cs
@@ -382,7 +382,7 @@ namespace osu.Game.Database
 
             HashSet<Guid> scoreIds = realmAccess.Run(r => new HashSet<Guid>(
                 r.All<ScoreInfo>()
-                 .Where(s => s.TotalScoreVersion < LegacyScoreEncoder.LATEST_VERSION)
+                 .Where(s => s.TotalScoreVersion < 30000013) // last total score version with a significant change to ranks
                  .AsEnumerable()
                  // must be done after materialisation, as realm doesn't support
                  // filtering on nested property predicates or projection via `.Select()`

From 9b526912e9f58f9b9250ca4df8f104a988a9644b Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 16:41:53 +0300
Subject: [PATCH 142/930] Fix incorrect operator

---
 osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs     | 2 +-
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
index 7ed6d2dce7..e168e14858 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
         {
             base.Update();
 
-            if (spmContainer.Alpha != 0 && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha == 0 && drawableSpinner.Result?.TimeStarted != null)
                 fadeCounterOnTimeStart();
         }
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index a5973ad444..2088839e82 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
         {
             base.Update();
 
-            if (spmContainer.Alpha != 0 && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha == 0 && drawableSpinner.Result?.TimeStarted != null)
                 fadeCounterOnTimeStart();
         }
 

From 4bba0eaf4b5b996ff6b053e1b88cb2b86bcd477c Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 16:42:44 +0300
Subject: [PATCH 143/930] Remove repeated TimeStarted check

---
 osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs     | 2 +-
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
index e168e14858..25ce92d1c5 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
@@ -120,7 +120,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
         {
             base.Update();
 
-            if (spmContainer.Alpha == 0 && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha == 0)
                 fadeCounterOnTimeStart();
         }
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index 2088839e82..5c4d7ae47b 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
         {
             base.Update();
 
-            if (spmContainer.Alpha == 0 && drawableSpinner.Result?.TimeStarted != null)
+            if (spmContainer.Alpha == 0)
                 fadeCounterOnTimeStart();
         }
 

From 2696620d12078432f749f02103c7a7774740f90a Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 17:09:21 +0300
Subject: [PATCH 144/930] Completely remove transform flow for spm counter

---
 .../Skinning/Argon/ArgonSpinner.cs            | 33 +++++--------------
 .../Skinning/Default/DefaultSpinner.cs        | 33 +++++--------------
 2 files changed, 16 insertions(+), 50 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
index 25ce92d1c5..f2bbd7373e 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
@@ -5,7 +5,6 @@ using System;
 using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
@@ -111,42 +110,26 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
             {
                 spmCounter.Text = Math.Truncate(spm.NewValue).ToString(@"#0");
             }, true);
-
-            drawableSpinner.ApplyCustomUpdateState += updateStateTransforms;
-            updateStateTransforms(drawableSpinner, drawableSpinner.State.Value);
         }
 
         protected override void Update()
         {
             base.Update();
 
-            if (spmContainer.Alpha == 0)
-                fadeCounterOnTimeStart();
+            updateSpmAlpha();
         }
 
-        private void updateStateTransforms(DrawableHitObject drawableHitObject, ArmedState state)
-        {
-            if (!(drawableHitObject is DrawableSpinner))
-                return;
-
-            fadeCounterOnTimeStart();
-        }
-
-        private void fadeCounterOnTimeStart()
+        private void updateSpmAlpha()
         {
             if (drawableSpinner.Result?.TimeStarted is double startTime)
             {
-                using (BeginAbsoluteSequence(startTime))
-                    spmContainer.FadeIn(drawableSpinner.HitObject.TimeFadeIn);
+                double timeOffset = Math.Clamp(Clock.CurrentTime, startTime, startTime + drawableSpinner.HitObject.TimeFadeIn) - startTime;
+                spmContainer.Alpha = (float)(timeOffset / drawableSpinner.HitObject.TimeFadeIn);
+            }
+            else
+            {
+                spmContainer.Alpha = 0;
             }
-        }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            if (drawableSpinner.IsNotNull())
-                drawableSpinner.ApplyCustomUpdateState -= updateStateTransforms;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index 5c4d7ae47b..0bd877b902 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
@@ -5,7 +5,6 @@ using System;
 using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
@@ -117,42 +116,26 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
             {
                 spmCounter.Text = Math.Truncate(spm.NewValue).ToString(@"#0");
             }, true);
-
-            drawableSpinner.ApplyCustomUpdateState += updateStateTransforms;
-            updateStateTransforms(drawableSpinner, drawableSpinner.State.Value);
         }
 
         protected override void Update()
         {
             base.Update();
 
-            if (spmContainer.Alpha == 0)
-                fadeCounterOnTimeStart();
+            updateSpmAlpha();
         }
 
-        private void updateStateTransforms(DrawableHitObject drawableHitObject, ArmedState state)
-        {
-            if (!(drawableHitObject is DrawableSpinner))
-                return;
-
-            fadeCounterOnTimeStart();
-        }
-
-        private void fadeCounterOnTimeStart()
+        private void updateSpmAlpha()
         {
             if (drawableSpinner.Result?.TimeStarted is double startTime)
             {
-                using (BeginAbsoluteSequence(startTime))
-                    spmContainer.FadeIn(drawableSpinner.HitObject.TimeFadeIn);
+                double timeOffset = Math.Clamp(Clock.CurrentTime, startTime, startTime + drawableSpinner.HitObject.TimeFadeIn) - startTime;
+                spmContainer.Alpha = (float)(timeOffset / drawableSpinner.HitObject.TimeFadeIn);
+            }
+            else
+            {
+                spmContainer.Alpha = 0;
             }
-        }
-
-        protected override void Dispose(bool isDisposing)
-        {
-            base.Dispose(isDisposing);
-
-            if (drawableSpinner.IsNotNull())
-                drawableSpinner.ApplyCustomUpdateState -= updateStateTransforms;
         }
     }
 }

From 824d671cce71eded91dee5ade2868da18a5f8e4b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 25 Feb 2024 00:12:20 +0800
Subject: [PATCH 145/930] Simplify implementation

---
 osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs     | 7 +------
 osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs | 7 +------
 2 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
index f2bbd7373e..3b48d36bb5 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinner.cs
@@ -122,14 +122,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
         private void updateSpmAlpha()
         {
             if (drawableSpinner.Result?.TimeStarted is double startTime)
-            {
-                double timeOffset = Math.Clamp(Clock.CurrentTime, startTime, startTime + drawableSpinner.HitObject.TimeFadeIn) - startTime;
-                spmContainer.Alpha = (float)(timeOffset / drawableSpinner.HitObject.TimeFadeIn);
-            }
+                spmContainer.Alpha = (float)Math.Clamp((Clock.CurrentTime - startTime) / drawableSpinner.HitObject.TimeFadeIn, 0, 1);
             else
-            {
                 spmContainer.Alpha = 0;
-            }
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
index 0bd877b902..ac56b45b69 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/DefaultSpinner.cs
@@ -128,14 +128,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
         private void updateSpmAlpha()
         {
             if (drawableSpinner.Result?.TimeStarted is double startTime)
-            {
-                double timeOffset = Math.Clamp(Clock.CurrentTime, startTime, startTime + drawableSpinner.HitObject.TimeFadeIn) - startTime;
-                spmContainer.Alpha = (float)(timeOffset / drawableSpinner.HitObject.TimeFadeIn);
-            }
+                spmContainer.Alpha = (float)Math.Clamp((Clock.CurrentTime - startTime) / drawableSpinner.HitObject.TimeFadeIn, 0, 1);
             else
-            {
                 spmContainer.Alpha = 0;
-            }
         }
     }
 }

From 1fb19e712922871adca31db706afd27ebb0a247f Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 20:18:30 +0300
Subject: [PATCH 146/930] Reduce allocations in DrawableSpinner

---
 .../Objects/Drawables/DrawableSpinner.cs      | 32 ++++++++++++++++---
 .../Objects/Drawables/DrawableHitObject.cs    |  4 ++-
 2 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
index 11120e49b5..8c21e6a6bc 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSpinner.cs
@@ -279,10 +279,9 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             if (HandleUserInput)
             {
                 bool isValidSpinningTime = Time.Current >= HitObject.StartTime && Time.Current <= HitObject.EndTime;
-                bool correctButtonPressed = (OsuActionInputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false);
 
                 RotationTracker.Tracking = !Result.HasResult
-                                           && correctButtonPressed
+                                           && correctButtonPressed()
                                            && isValidSpinningTime;
             }
 
@@ -292,11 +291,34 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             // Ticks can theoretically be judged at any point in the spinner's duration.
             // A tick must be alive to correctly play back samples,
             // but for performance reasons, we only want to keep the next tick alive.
-            var next = NestedHitObjects.FirstOrDefault(h => !h.Judged);
+            DrawableHitObject nextTick = null;
+
+            foreach (var nested in NestedHitObjects)
+            {
+                if (!nested.Judged)
+                {
+                    nextTick = nested;
+                    break;
+                }
+            }
 
             // See default `LifetimeStart` as set in `DrawableSpinnerTick`.
-            if (next?.LifetimeStart == double.MaxValue)
-                next.LifetimeStart = HitObject.StartTime;
+            if (nextTick?.LifetimeStart == double.MaxValue)
+                nextTick.LifetimeStart = HitObject.StartTime;
+        }
+
+        private bool correctButtonPressed()
+        {
+            if (OsuActionInputManager == null)
+                return false;
+
+            foreach (var action in OsuActionInputManager.PressedActions)
+            {
+                if (action == OsuAction.LeftButton || action == OsuAction.RightButton)
+                    return true;
+            }
+
+            return false;
         }
 
         protected override void UpdateAfterChildren()
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 16bd4b565c..de05219212 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -11,10 +11,12 @@ using System.Linq;
 using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Audio;
@@ -65,7 +67,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
         public virtual IEnumerable<HitSampleInfo> GetSamples() => HitObject.Samples;
 
         private readonly List<DrawableHitObject> nestedHitObjects = new List<DrawableHitObject>();
-        public IReadOnlyList<DrawableHitObject> NestedHitObjects => nestedHitObjects;
+        public SlimReadOnlyListWrapper<DrawableHitObject> NestedHitObjects => nestedHitObjects.AsSlimReadOnly();
 
         /// <summary>
         /// Whether this object should handle any user input events.

From 9e90f7fb0d731e06d36bce8e5bc269f362f307cd Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 20:36:06 +0300
Subject: [PATCH 147/930] Store last enqueued RotationRecord in
 SpinnerSpmCalculator

---
 .../Skinning/Default/SpinnerSpmCalculator.cs             | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
index 44962c8548..7986108fbd 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
@@ -33,14 +32,16 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
             drawableSpinner.HitObjectApplied += resetState;
         }
 
+        private RotationRecord lastRecord;
+
         public void SetRotation(float currentRotation)
         {
             // If we've gone back in time, it's fine to work with a fresh set of records for now
-            if (records.Count > 0 && Time.Current < records.Last().Time)
+            if (records.Count > 0 && Time.Current < lastRecord.Time)
                 records.Clear();
 
             // Never calculate SPM by same time of record to avoid 0 / 0 = NaN or X / 0 = Infinity result.
-            if (records.Count > 0 && Precision.AlmostEquals(Time.Current, records.Last().Time))
+            if (records.Count > 0 && Precision.AlmostEquals(Time.Current, lastRecord.Time))
                 return;
 
             if (records.Count > 0)
@@ -52,7 +53,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
                 result.Value = (currentRotation - record.Rotation) / (Time.Current - record.Time) * 1000 * 60 / 360;
             }
 
-            records.Enqueue(new RotationRecord { Rotation = currentRotation, Time = Time.Current });
+            records.Enqueue(lastRecord = new RotationRecord { Rotation = currentRotation, Time = Time.Current });
         }
 
         private void resetState(DrawableHitObject hitObject)

From 3b53ed3c3aae40476d7f061a2796186a9f70c8b7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 22:44:58 +0300
Subject: [PATCH 148/930] Reduce allocations in ModColumn

---
 osu.Game/Overlays/Mods/ModColumn.cs | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index d65c94d14d..df33c78ea4 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -67,8 +67,25 @@ namespace osu.Game.Overlays.Mods
         private IModHotkeyHandler hotkeyHandler = null!;
 
         private Task? latestLoadTask;
-        private ICollection<ModPanel>? latestLoadedPanels;
-        internal bool ItemsLoaded => latestLoadTask?.IsCompleted == true && latestLoadedPanels?.All(panel => panel.Parent != null) == true;
+        private ModPanel[]? latestLoadedPanels;
+        internal bool ItemsLoaded => latestLoadTask?.IsCompleted == true && allPanelsLoaded;
+
+        private bool allPanelsLoaded
+        {
+            get
+            {
+                if (latestLoadedPanels == null)
+                    return false;
+
+                foreach (var panel in latestLoadedPanels)
+                {
+                    if (panel.Parent == null)
+                        return false;
+                }
+
+                return true;
+            }
+        }
 
         public override bool IsPresent => base.IsPresent || Scheduler.HasPendingTasks;
 

From 6d2187e079c278d36ca628b128223bafc31e5e4d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 24 Feb 2024 22:58:23 +0300
Subject: [PATCH 149/930] Reduce allocations in ModSelectOverlay

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ddf96c1cb3..3009297741 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -15,6 +15,7 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Localisation;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
@@ -349,15 +350,23 @@ namespace osu.Game.Overlays.Mods
             });
         }
 
+        private static readonly LocalisableString input_search_placeholder = Resources.Localisation.Web.CommonStrings.InputSearch;
+        private static readonly LocalisableString tab_to_search_placeholder = ModSelectOverlayStrings.TabToSearch;
+
         protected override void Update()
         {
             base.Update();
 
-            SearchTextBox.PlaceholderText = SearchTextBox.HasFocus ? Resources.Localisation.Web.CommonStrings.InputSearch : ModSelectOverlayStrings.TabToSearch;
+            SearchTextBox.PlaceholderText = SearchTextBox.HasFocus ? input_search_placeholder : tab_to_search_placeholder;
 
             if (beatmapAttributesDisplay != null)
             {
-                float rightEdgeOfLastButton = footerButtonFlow.Last().ScreenSpaceDrawQuad.TopRight.X;
+                ShearedButton lastFooterButton = null!;
+
+                foreach (var b in footerButtonFlow)
+                    lastFooterButton = b;
+
+                float rightEdgeOfLastButton = lastFooterButton.ScreenSpaceDrawQuad.TopRight.X;
 
                 // this is cheating a bit; the 640 value is hardcoded based on how wide the expanded panel _generally_ is.
                 // due to the transition applied, the raw screenspace quad of the panel cannot be used, as it will trigger an ugly feedback cycle of expanding and collapsing.

From 91d7bd10265a806946ba0e528da8aa6c07cdcd8e Mon Sep 17 00:00:00 2001
From: Detze <92268414+Detze@users.noreply.github.com>
Date: Sat, 24 Feb 2024 21:56:44 +0100
Subject: [PATCH 150/930] Don't dim slider head in `DrawableSlider`

---
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
index 6d492e7b08..b7ce712e2c 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
         protected override IEnumerable<Drawable> DimmablePieces => new Drawable[]
         {
-            HeadCircle,
+            // HeadCircle should not be added to this list, as it handles dimming itself
             TailCircle,
             repeatContainer,
             Body,

From e12f8c03eef09478b8c8f3823b60632d37713192 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 25 Feb 2024 08:18:19 +0800
Subject: [PATCH 151/930] Reset `lastRecord` on `resetState` for good measure

---
 osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
index 7986108fbd..3383989367 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerSpmCalculator.cs
@@ -58,6 +58,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
 
         private void resetState(DrawableHitObject hitObject)
         {
+            lastRecord = default;
             result.Value = 0;
             records.Clear();
         }

From 081aa84718233618bd1d9fc81468e99023dbc705 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 25 Feb 2024 10:36:15 +0300
Subject: [PATCH 152/930] Simplify last footer button selection

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 3009297741..ce1d0d27a3 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -361,12 +361,7 @@ namespace osu.Game.Overlays.Mods
 
             if (beatmapAttributesDisplay != null)
             {
-                ShearedButton lastFooterButton = null!;
-
-                foreach (var b in footerButtonFlow)
-                    lastFooterButton = b;
-
-                float rightEdgeOfLastButton = lastFooterButton.ScreenSpaceDrawQuad.TopRight.X;
+                float rightEdgeOfLastButton = footerButtonFlow[^1].ScreenSpaceDrawQuad.TopRight.X;
 
                 // this is cheating a bit; the 640 value is hardcoded based on how wide the expanded panel _generally_ is.
                 // due to the transition applied, the raw screenspace quad of the panel cannot be used, as it will trigger an ugly feedback cycle of expanding and collapsing.

From f948f8ee5c49498ea58fe2a2e5817ef7fbb027c7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 25 Feb 2024 17:59:20 +0300
Subject: [PATCH 153/930] Fix HUDOverlay allocations

---
 osu.Game/Screens/Play/HUDOverlay.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 32ebb82f15..f965d3392a 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -258,13 +258,13 @@ namespace osu.Game.Screens.Play
 
             Vector2? highestBottomScreenSpace = null;
 
-            foreach (var element in mainComponents.Components)
-                processDrawable(element);
+            for (int i = 0; i < mainComponents.Components.Count; i++)
+                processDrawable(mainComponents.Components[i]);
 
             if (rulesetComponents != null)
             {
-                foreach (var element in rulesetComponents.Components)
-                    processDrawable(element);
+                for (int i = 0; i < rulesetComponents.Components.Count; i++)
+                    processDrawable(rulesetComponents.Components[i]);
             }
 
             if (lowestTopScreenSpaceRight.HasValue)

From c3fa97d062c370c4d5c60b2cee66e7b8298a79b7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 25 Feb 2024 18:02:42 +0300
Subject: [PATCH 154/930] Reduce allocations in HitObjectLifetimeEntry

---
 .../Rulesets/Objects/HitObjectLifetimeEntry.cs  | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
index 4450f026b4..9f2720b7ca 100644
--- a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
+++ b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
@@ -41,7 +41,22 @@ namespace osu.Game.Rulesets.Objects
         /// <summary>
         /// Whether <see cref="HitObject"/> and all of its nested objects have been judged.
         /// </summary>
-        public bool AllJudged => Judged && NestedEntries.All(h => h.AllJudged);
+        public bool AllJudged
+        {
+            get
+            {
+                if (!Judged)
+                    return false;
+
+                foreach (var entry in NestedEntries)
+                {
+                    if (!entry.AllJudged)
+                        return false;
+                }
+
+                return true;
+            }
+        }
 
         private readonly IBindable<double> startTimeBindable = new BindableDouble();
 

From 9e3defebda1d446f815cb0cae6618f822ba482d2 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 25 Feb 2024 19:05:40 +0300
Subject: [PATCH 155/930] Remove unused using

---
 osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
index 9f2720b7ca..4962ac13b5 100644
--- a/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
+++ b/osu.Game/Rulesets/Objects/HitObjectLifetimeEntry.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Performance;
 using osu.Game.Rulesets.Judgements;

From 5c049feca1e855daca7499b2e6bfb6482c99fe8a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 25 Feb 2024 21:18:15 +0300
Subject: [PATCH 156/930] Fix advanced stats in beatmap info overlay showing
 "key count" on non-mania beatmaps

---
 osu.Game/Overlays/BeatmapSet/Details.cs       | 30 ++++++++++++-------
 .../Screens/Select/Details/AdvancedStats.cs   | 29 ++++++------------
 osu.Game/Screens/Select/SongSelect.cs         |  7 ++++-
 3 files changed, 34 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Details.cs b/osu.Game/Overlays/BeatmapSet/Details.cs
index cf78f605aa..d656a6b14b 100644
--- a/osu.Game/Overlays/BeatmapSet/Details.cs
+++ b/osu.Game/Overlays/BeatmapSet/Details.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.BeatmapSet.Buttons;
+using osu.Game.Rulesets;
 using osu.Game.Screens.Select.Details;
 using osuTK;
 
@@ -33,10 +34,10 @@ namespace osu.Game.Overlays.BeatmapSet
             {
                 if (value == beatmapSet) return;
 
-                beatmapSet = value;
+                basic.BeatmapSet = preview.BeatmapSet = beatmapSet = value;
 
-                basic.BeatmapSet = preview.BeatmapSet = BeatmapSet;
-                updateDisplay();
+                if (IsLoaded)
+                    updateDisplay();
             }
         }
 
@@ -50,13 +51,10 @@ namespace osu.Game.Overlays.BeatmapSet
                 if (value == beatmapInfo) return;
 
                 basic.BeatmapInfo = advanced.BeatmapInfo = beatmapInfo = value;
-            }
-        }
 
-        private void updateDisplay()
-        {
-            Ratings.Ratings = BeatmapSet?.Ratings;
-            ratingBox.Alpha = BeatmapSet?.Status > 0 ? 1 : 0;
+                if (IsLoaded)
+                    updateDisplay();
+            }
         }
 
         public Details()
@@ -101,12 +99,22 @@ namespace osu.Game.Overlays.BeatmapSet
             };
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        [Resolved]
+        private RulesetStore rulesets { get; set; }
+
+        protected override void LoadComplete()
         {
+            base.LoadComplete();
             updateDisplay();
         }
 
+        private void updateDisplay()
+        {
+            Ratings.Ratings = BeatmapSet?.Ratings;
+            ratingBox.Alpha = BeatmapSet?.Status > 0 ? 1 : 0;
+            advanced.Ruleset.Value = rulesets.GetRuleset(beatmapInfo?.Ruleset.OnlineID ?? 0);
+        }
+
         private partial class DetailBox : Container
         {
             private readonly Container content;
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 0d68a0ec3c..74276795d2 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -38,11 +38,6 @@ namespace osu.Game.Screens.Select.Details
         [Resolved]
         private IBindable<IReadOnlyList<Mod>> mods { get; set; }
 
-        [Resolved]
-        private OsuGameBase game { get; set; }
-
-        private IBindable<RulesetInfo> gameRuleset;
-
         protected readonly StatisticRow FirstValue, HpDrain, Accuracy, ApproachRate;
         private readonly StatisticRow starDifficulty;
 
@@ -64,6 +59,8 @@ namespace osu.Game.Screens.Select.Details
             }
         }
 
+        public Bindable<RulesetInfo> Ruleset { get; } = new Bindable<RulesetInfo>();
+
         public AdvancedStats(int columns = 1)
         {
             switch (columns)
@@ -137,12 +134,7 @@ namespace osu.Game.Screens.Select.Details
         {
             base.LoadComplete();
 
-            // the cached ruleset bindable might be a decoupled bindable provided by SongSelect,
-            // which we can't rely on in combination with the game-wide selected mods list,
-            // since mods could be updated to the new ruleset instances while the decoupled bindable is held behind,
-            // therefore resulting in performing difficulty calculation with invalid states.
-            gameRuleset = game.Ruleset.GetBoundCopy();
-            gameRuleset.BindValueChanged(_ => updateStatistics());
+            Ruleset.BindValueChanged(_ => updateStatistics());
 
             mods.BindValueChanged(modsChanged, true);
         }
@@ -169,8 +161,6 @@ namespace osu.Game.Screens.Select.Details
             IBeatmapDifficultyInfo baseDifficulty = BeatmapInfo?.Difficulty;
             BeatmapDifficulty adjustedDifficulty = null;
 
-            IRulesetInfo ruleset = gameRuleset?.Value ?? beatmapInfo.Ruleset;
-
             if (baseDifficulty != null)
             {
                 BeatmapDifficulty originalDifficulty = new BeatmapDifficulty(baseDifficulty);
@@ -180,24 +170,24 @@ namespace osu.Game.Screens.Select.Details
 
                 adjustedDifficulty = originalDifficulty;
 
-                if (gameRuleset != null)
+                if (Ruleset.Value != null)
                 {
                     double rate = 1;
                     foreach (var mod in mods.Value.OfType<IApplicableToRate>())
                         rate = mod.ApplyToRate(0, rate);
 
-                    adjustedDifficulty = ruleset.CreateInstance().GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
+                    adjustedDifficulty = Ruleset.Value.CreateInstance().GetRateAdjustedDisplayDifficulty(originalDifficulty, rate);
 
                     TooltipContent = new AdjustedAttributesTooltip.Data(originalDifficulty, adjustedDifficulty);
                 }
             }
 
-            switch (ruleset.OnlineID)
+            switch (Ruleset.Value?.OnlineID)
             {
                 case 3:
                     // Account for mania differences locally for now.
                     // Eventually this should be handled in a more modular way, allowing rulesets to return arbitrary difficulty attributes.
-                    ILegacyRuleset legacyRuleset = (ILegacyRuleset)ruleset.CreateInstance();
+                    ILegacyRuleset legacyRuleset = (ILegacyRuleset)Ruleset.Value.CreateInstance();
 
                     // For the time being, the key count is static no matter what, because:
                     // a) The method doesn't have knowledge of the active keymods. Doing so may require considerations for filtering.
@@ -206,7 +196,6 @@ namespace osu.Game.Screens.Select.Details
 
                     FirstValue.Title = BeatmapsetsStrings.ShowStatsCsMania;
                     FirstValue.Value = (keyCount, keyCount);
-
                     break;
 
                 default:
@@ -240,8 +229,8 @@ namespace osu.Game.Screens.Select.Details
 
             starDifficultyCancellationSource = new CancellationTokenSource();
 
-            var normalStarDifficultyTask = difficultyCache.GetDifficultyAsync(BeatmapInfo, gameRuleset.Value, null, starDifficultyCancellationSource.Token);
-            var moddedStarDifficultyTask = difficultyCache.GetDifficultyAsync(BeatmapInfo, gameRuleset.Value, mods.Value, starDifficultyCancellationSource.Token);
+            var normalStarDifficultyTask = difficultyCache.GetDifficultyAsync(BeatmapInfo, Ruleset.Value, null, starDifficultyCancellationSource.Token);
+            var moddedStarDifficultyTask = difficultyCache.GetDifficultyAsync(BeatmapInfo, Ruleset.Value, mods.Value, starDifficultyCancellationSource.Token);
 
             Task.WhenAll(normalStarDifficultyTask, moddedStarDifficultyTask).ContinueWith(_ => Schedule(() =>
             {
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index a603934a9d..15469fad5b 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -286,7 +286,7 @@ namespace osu.Game.Screens.Select
                                                                 AutoSizeAxes = Axes.Y,
                                                                 Anchor = Anchor.Centre,
                                                                 Origin = Anchor.Centre,
-                                                                Padding = new MarginPadding(10)
+                                                                Padding = new MarginPadding(10),
                                                             },
                                                         }
                                                     },
@@ -585,6 +585,11 @@ namespace osu.Game.Screens.Select
                 beatmapInfoPrevious = beatmap;
             }
 
+            // we can't run this in the debounced run due to the selected mods bindable not being debounced,
+            // since mods could be updated to the new ruleset instances while the decoupled bindable is held behind,
+            // therefore resulting in performing difficulty calculation with invalid states.
+            advancedStats.Ruleset.Value = ruleset;
+
             void run()
             {
                 // clear pending task immediately to track any potential nested debounce operation.

From b30a6d522462331e20043f0bada10186a3315196 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 25 Feb 2024 21:23:09 +0300
Subject: [PATCH 157/930] Adjust existing test coverage

---
 .../SongSelect/TestSceneAdvancedStats.cs      | 49 ++-----------------
 1 file changed, 5 insertions(+), 44 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
index 4bb2b557ff..3b89c70a63 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneAdvancedStats.cs
@@ -37,15 +37,9 @@ namespace osu.Game.Tests.Visual.SongSelect
         [SetUp]
         public void Setup() => Schedule(() => Child = advancedStats = new TestAdvancedStats
         {
-            Width = 500
+            Width = 500,
         });
 
-        [SetUpSteps]
-        public void SetUpSteps()
-        {
-            AddStep("reset game ruleset", () => Ruleset.Value = new OsuRuleset().RulesetInfo);
-        }
-
         private BeatmapInfo exampleBeatmapInfo => new BeatmapInfo
         {
             Ruleset = rulesets.AvailableRulesets.First(),
@@ -74,45 +68,12 @@ namespace osu.Game.Tests.Visual.SongSelect
         }
 
         [Test]
-        public void TestManiaFirstBarTextManiaBeatmap()
+        public void TestFirstBarText()
         {
-            AddStep("set game ruleset to mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
-
-            AddStep("set beatmap", () => advancedStats.BeatmapInfo = new BeatmapInfo
-            {
-                Ruleset = rulesets.GetRuleset(3) ?? throw new InvalidOperationException("osu!mania ruleset not found"),
-                Difficulty = new BeatmapDifficulty
-                {
-                    CircleSize = 5,
-                    DrainRate = 4.3f,
-                    OverallDifficulty = 4.5f,
-                    ApproachRate = 3.1f
-                },
-                StarRating = 8
-            });
-
-            AddAssert("first bar text is correct", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == BeatmapsetsStrings.ShowStatsCsMania);
-        }
-
-        [Test]
-        public void TestManiaFirstBarTextConvert()
-        {
-            AddStep("set game ruleset to mania", () => Ruleset.Value = new ManiaRuleset().RulesetInfo);
-
-            AddStep("set beatmap", () => advancedStats.BeatmapInfo = new BeatmapInfo
-            {
-                Ruleset = new OsuRuleset().RulesetInfo,
-                Difficulty = new BeatmapDifficulty
-                {
-                    CircleSize = 5,
-                    DrainRate = 4.3f,
-                    OverallDifficulty = 4.5f,
-                    ApproachRate = 3.1f
-                },
-                StarRating = 8
-            });
-
+            AddStep("set ruleset to mania", () => advancedStats.Ruleset.Value = new ManiaRuleset().RulesetInfo);
             AddAssert("first bar text is correct", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == BeatmapsetsStrings.ShowStatsCsMania);
+            AddStep("set ruleset to osu", () => advancedStats.Ruleset.Value = new OsuRuleset().RulesetInfo);
+            AddAssert("first bar text is correct", () => advancedStats.ChildrenOfType<SpriteText>().First().Text == BeatmapsetsStrings.ShowStatsCs);
         }
 
         [Test]

From 4421ff975b330e832ee0405b9171dfeed2255577 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 09:04:39 +0800
Subject: [PATCH 158/930] Add local function to perform iteration to better
 explain the "why"

---
 osu.Game/Screens/Play/HUDOverlay.cs | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index f965d3392a..2ec2a011a6 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -258,14 +258,10 @@ namespace osu.Game.Screens.Play
 
             Vector2? highestBottomScreenSpace = null;
 
-            for (int i = 0; i < mainComponents.Components.Count; i++)
-                processDrawable(mainComponents.Components[i]);
+            processDrawables(mainComponents);
 
             if (rulesetComponents != null)
-            {
-                for (int i = 0; i < rulesetComponents.Components.Count; i++)
-                    processDrawable(rulesetComponents.Components[i]);
-            }
+                processDrawables(rulesetComponents);
 
             if (lowestTopScreenSpaceRight.HasValue)
                 topRightElements.Y = MathHelper.Clamp(ToLocalSpace(new Vector2(0, lowestTopScreenSpaceRight.Value)).Y, 0, DrawHeight - topRightElements.DrawHeight);
@@ -282,6 +278,14 @@ namespace osu.Game.Screens.Play
             else
                 bottomRightElements.Y = 0;
 
+            void processDrawables(SkinComponentsContainer components)
+            {
+                // Avoid using foreach due to missing GetEnumerator implementation.
+                // See https://github.com/ppy/osu-framework/blob/e10051e6643731e393b09de40a3a3d209a545031/osu.Framework/Bindables/IBindableList.cs#L41-L44.
+                for (int i = 0; i < components.Components.Count; i++)
+                    processDrawable(components.Components[i]);
+            }
+
             void processDrawable(ISerialisableDrawable element)
             {
                 // Cast can be removed when IDrawable interface includes Anchor / RelativeSizeAxes.

From 3502ec456d0131f4f6c1c9faabf01e6197a16ee1 Mon Sep 17 00:00:00 2001
From: Detze <92268414+Detze@users.noreply.github.com>
Date: Mon, 26 Feb 2024 04:36:09 +0100
Subject: [PATCH 159/930] Match stable's slider border thickness more closely

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index b39092a467..6bf6776617 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             protected new float CalculatedBorderPortion
                 // Roughly matches osu!stable's slider border portions.
-                => base.CalculatedBorderPortion * 0.77f;
+                => base.CalculatedBorderPortion * 0.84f;
 
             protected override Color4 ColourAt(float position)
             {

From 4c744ccb698e9f41cc350fcde45159a30ec52944 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 14:11:54 +0800
Subject: [PATCH 160/930] Fix "Use current" snap not working

Regressed with https://github.com/ppy/osu/pull/27249.

I was suspicious of this specific operation at the time but didn't test properly.
---
 osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
index b2f38662cc..8bff5fe6ac 100644
--- a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Rulesets.Edit
                 if (objTime >= editorClock.CurrentTime)
                     continue;
 
-                if (objTime > lastBefore?.StartTime)
+                if (lastBefore == null || objTime > lastBefore?.StartTime)
                     lastBefore = entry.Value.HitObject;
             }
 
@@ -148,7 +148,7 @@ namespace osu.Game.Rulesets.Edit
                 if (objTime < editorClock.CurrentTime)
                     continue;
 
-                if (objTime < firstAfter?.StartTime)
+                if (firstAfter == null || objTime < firstAfter?.StartTime)
                     firstAfter = entry.Value.HitObject;
             }
 

From 9a46e738bdf86cb0f8495e6ef69f5cc8a6d5456c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 15:45:29 +0800
Subject: [PATCH 161/930] Fix inspections

---
 osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
index 8bff5fe6ac..62ad2ce7e9 100644
--- a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Rulesets.Edit
                 if (objTime >= editorClock.CurrentTime)
                     continue;
 
-                if (lastBefore == null || objTime > lastBefore?.StartTime)
+                if (lastBefore == null || objTime > lastBefore.StartTime)
                     lastBefore = entry.Value.HitObject;
             }
 
@@ -148,7 +148,7 @@ namespace osu.Game.Rulesets.Edit
                 if (objTime < editorClock.CurrentTime)
                     continue;
 
-                if (firstAfter == null || objTime < firstAfter?.StartTime)
+                if (firstAfter == null || objTime < firstAfter.StartTime)
                     firstAfter = entry.Value.HitObject;
             }
 

From 8962be2ed54f8431d29d6558aa8eacf28e467707 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 17:24:04 +0800
Subject: [PATCH 162/930] Allow better menu navigation using same hotkey to
 progress to destination As touched on in
 https://github.com/ppy/osu/discussions/27102.

You can now use:

- `L L L` to get to playlists
- `M M M` to get to multiplayer
- `S` to get to settings
---
 osu.Game/Screens/Menu/ButtonSystem.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index d742d2377f..15a2740160 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -102,7 +102,7 @@ namespace osu.Game.Screens.Menu
 
             buttonArea.AddRange(new Drawable[]
             {
-                new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, OsuIcon.Settings, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O),
+                new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, OsuIcon.Settings, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O, Key.S),
                 backButton = new MainMenuButton(ButtonSystemStrings.Back, @"back-to-top", OsuIcon.PrevCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel,
                     -WEDGE_WIDTH)
                 {
@@ -132,11 +132,11 @@ namespace osu.Game.Screens.Menu
             buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Playlists, @"button-default-select", OsuIcon.Tournament, new Color4(94, 63, 186, 255), onPlaylists, 0, Key.L));
             buttonsPlay.ForEach(b => b.VisibleState = ButtonSystemState.Play);
 
-            buttonsEdit.Add(new MainMenuButton(EditorStrings.BeatmapEditor.ToLower(), @"button-default-select", OsuIcon.Beatmap, new Color4(238, 170, 0, 255), () => OnEditBeatmap?.Invoke(), WEDGE_WIDTH, Key.B));
+            buttonsEdit.Add(new MainMenuButton(EditorStrings.BeatmapEditor.ToLower(), @"button-default-select", OsuIcon.Beatmap, new Color4(238, 170, 0, 255), () => OnEditBeatmap?.Invoke(), WEDGE_WIDTH, Key.B, Key.E));
             buttonsEdit.Add(new MainMenuButton(SkinEditorStrings.SkinEditor.ToLower(), @"button-default-select", OsuIcon.SkinB, new Color4(220, 160, 0, 255), () => OnEditSkin?.Invoke(), 0, Key.S));
             buttonsEdit.ForEach(b => b.VisibleState = ButtonSystemState.Edit);
 
-            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Play, @"button-play-select", OsuIcon.Logo, new Color4(102, 68, 204, 255), () => State = ButtonSystemState.Play, WEDGE_WIDTH, Key.P));
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Play, @"button-play-select", OsuIcon.Logo, new Color4(102, 68, 204, 255), () => State = ButtonSystemState.Play, WEDGE_WIDTH, Key.P, Key.M, Key.L));
             buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Edit, @"button-play-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), () => State = ButtonSystemState.Edit, 0, Key.E));
             buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-default-select", OsuIcon.Beatmap, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0, Key.B, Key.D));
 

From 115d82664bb0a3271e7593dacce987557a2ff098 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 26 Feb 2024 10:37:03 +0100
Subject: [PATCH 163/930] Assert proportional scaling rather than assume
 average

Because if scaling is ever actually non-proportional then this should be
somewhat loud.

Also use the absolute value to prevent funny things happening if/when
someone does negative scale.
---
 osu.Game/Rulesets/Mods/ModFlashlight.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index d714cd3c85..144842def0 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Runtime.InteropServices;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -13,6 +14,7 @@ using osu.Framework.Graphics.Shaders;
 using osu.Framework.Graphics.Shaders.Types;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
+using osu.Framework.Utils;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.OpenGL.Vertices;
@@ -151,9 +153,10 @@ namespace osu.Game.Rulesets.Mods
                 if (GetPlayfieldScale != null)
                 {
                     Vector2 playfieldScale = GetPlayfieldScale();
-                    float rulesetScaleAvg = (playfieldScale.X + playfieldScale.Y) / 2f;
 
-                    size *= rulesetScaleAvg;
+                    Debug.Assert(Precision.AlmostEquals(Math.Abs(playfieldScale.X), Math.Abs(playfieldScale.Y)),
+                        @"Playfield has non-proportional scaling. Flashlight implementations should be revisited with regard to balance.");
+                    size *= Math.Abs(playfieldScale.X);
                 }
 
                 if (isBreakTime.Value)

From 8e336610d090b2d1f94239620c336a7e0854fc34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 18:31:36 +0800
Subject: [PATCH 164/930] Add xmldoc explaining `Ruleset` bindable's usage

---
 osu.Game/Screens/Select/Details/AdvancedStats.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 74276795d2..1aba977f44 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -59,6 +59,13 @@ namespace osu.Game.Screens.Select.Details
             }
         }
 
+        /// <summary>
+        /// Ruleset to be used for certain elements of display.
+        /// When set, this will override the set <see cref="Beatmap"/>'s own ruleset.
+        /// </summary>
+        /// <remarks>
+        /// No checks are done as to whether the ruleset specified is valid for the currently <see cref="BeatmapInfo"/>.
+        /// </remarks>
         public Bindable<RulesetInfo> Ruleset { get; } = new Bindable<RulesetInfo>();
 
         public AdvancedStats(int columns = 1)

From 8966ea2fa3a81cd567aeacbbee60e857af7d9520 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 26 Feb 2024 11:59:57 +0100
Subject: [PATCH 165/930] Add test coverage

---
 ...tSceneHitObjectComposerDistanceSnapping.cs | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
index 463287fb35..12b7dbbf12 100644
--- a/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
+++ b/osu.Game.Tests/Editing/TestSceneHitObjectComposerDistanceSnapping.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -17,6 +18,7 @@ using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Screens.Edit;
 using osu.Game.Tests.Visual;
+using osuTK;
 
 namespace osu.Game.Tests.Editing
 {
@@ -228,6 +230,28 @@ namespace osu.Game.Tests.Editing
             assertSnappedDistance(400, 400);
         }
 
+        [Test]
+        public void TestUseCurrentSnap()
+        {
+            AddStep("add objects to beatmap", () =>
+            {
+                editorBeatmap.Add(new HitCircle { StartTime = 1000 });
+                editorBeatmap.Add(new HitCircle { Position = new Vector2(100), StartTime = 2000 });
+            });
+
+            AddStep("hover use current snap button", () => InputManager.MoveMouseTo(composer.ChildrenOfType<ExpandableButton>().Single()));
+            AddUntilStep("use current snap expanded", () => composer.ChildrenOfType<ExpandableButton>().Single().Expanded.Value, () => Is.True);
+
+            AddStep("seek before first object", () => EditorClock.Seek(0));
+            AddUntilStep("use current snap not available", () => composer.ChildrenOfType<ExpandableButton>().Single().Enabled.Value, () => Is.False);
+
+            AddStep("seek to between objects", () => EditorClock.Seek(1500));
+            AddUntilStep("use current snap available", () => composer.ChildrenOfType<ExpandableButton>().Single().Enabled.Value, () => Is.True);
+
+            AddStep("seek after last object", () => EditorClock.Seek(2500));
+            AddUntilStep("use current snap not available", () => composer.ChildrenOfType<ExpandableButton>().Single().Enabled.Value, () => Is.False);
+        }
+
         private void assertSnapDistance(float expectedDistance, HitObject? referenceObject, bool includeSliderVelocity)
             => AddAssert($"distance is {expectedDistance}", () => composer.DistanceSnapProvider.GetBeatSnapDistanceAt(referenceObject ?? new HitObject(), includeSliderVelocity), () => Is.EqualTo(expectedDistance).Within(Precision.FLOAT_EPSILON));
 

From 6dbba705b3127757dbb36f16911790d776934527 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 26 Feb 2024 12:27:02 +0100
Subject: [PATCH 166/930] Refine uninstall logic to account for legacy windows
 features

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 4bb8e57c9d..490faab632 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -222,12 +222,21 @@ namespace osu.Desktop.Windows
                     programKey?.SetValue(null, description);
             }
 
+            /// <summary>
+            /// Uninstalls the file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/shell/fa-file-types#deleting-registry-information-during-uninstallation
+            /// </summary>
             public void Uninstall(RegistryKey classes)
             {
-                // importantly, we don't delete the default program entry because some other program could have taken it.
+                using (var extensionKey = classes.OpenSubKey(Extension, true))
+                {
+                    // clear our default association so that Explorer doesn't show the raw programId to users
+                    // the null/(Default) entry is used for both ProdID association and as a fallback friendly name, for legacy reasons
+                    if (extensionKey?.GetValue(null) is string s && s == programId)
+                        extensionKey.SetValue(null, string.Empty);
 
-                using (var extensionKey = classes.OpenSubKey($@"{Extension}\OpenWithProgIds", true))
-                    extensionKey?.DeleteValue(programId, throwOnMissingValue: false);
+                    using (var openWithKey = extensionKey?.CreateSubKey(@"OpenWithProgIds"))
+                        openWithKey?.DeleteValue(programId, throwOnMissingValue: false);
+                }
 
                 classes.DeleteSubKeyTree(programId, throwOnMissingSubKey: false);
             }

From f2807470efc66a560dbd09da75be2ff70bf83b1d Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 26 Feb 2024 13:03:23 +0100
Subject: [PATCH 167/930] Inline `EXE_PATH` usage

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 490faab632..3fd566edab 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -136,10 +136,10 @@ namespace osu.Desktop.Windows
             Debug.Assert(classes != null);
 
             foreach (var association in file_associations)
-                association.Install(classes, EXE_PATH);
+                association.Install(classes);
 
             foreach (var association in uri_associations)
-                association.Install(classes, EXE_PATH);
+                association.Install(classes);
         }
 
         private static void updateDescriptions(LocalisationManager? localisation)
@@ -192,7 +192,7 @@ namespace osu.Desktop.Windows
             /// <summary>
             /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
             /// </summary>
-            public void Install(RegistryKey classes, string exePath)
+            public void Install(RegistryKey classes)
             {
                 // register a program id for the given extension
                 using (var programKey = classes.CreateSubKey(programId))
@@ -201,7 +201,7 @@ namespace osu.Desktop.Windows
                         defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = programKey.CreateSubKey(SHELL_OPEN_COMMAND))
-                        openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
+                        openCommandKey.SetValue(null, $@"""{EXE_PATH}"" ""%1""");
                 }
 
                 using (var extensionKey = classes.CreateSubKey(Extension))
@@ -253,7 +253,7 @@ namespace osu.Desktop.Windows
             /// <summary>
             /// Registers an URI protocol handler in accordance with https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85).
             /// </summary>
-            public void Install(RegistryKey classes, string exePath)
+            public void Install(RegistryKey classes)
             {
                 using (var protocolKey = classes.CreateSubKey(Protocol))
                 {
@@ -263,7 +263,7 @@ namespace osu.Desktop.Windows
                         defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = protocolKey.CreateSubKey(SHELL_OPEN_COMMAND))
-                        openCommandKey.SetValue(null, $@"""{exePath}"" ""%1""");
+                        openCommandKey.SetValue(null, $@"""{EXE_PATH}"" ""%1""");
                 }
             }
 

From 9b3ec64f411b234391ac653fb319cbb07d1d6fea Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 26 Feb 2024 13:10:37 +0100
Subject: [PATCH 168/930] Inline `HKCU\Software\Classes` usage

---
 .../Windows/WindowsAssociationManager.cs      | 52 +++++++++++--------
 1 file changed, 29 insertions(+), 23 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 3fd566edab..2a1aeba7e0 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using System.IO;
 using System.Runtime.InteropServices;
 using System.Runtime.Versioning;
@@ -108,14 +107,11 @@ namespace osu.Desktop.Windows
         {
             try
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-                Debug.Assert(classes != null);
-
                 foreach (var association in file_associations)
-                    association.Uninstall(classes);
+                    association.Uninstall();
 
                 foreach (var association in uri_associations)
-                    association.Uninstall(classes);
+                    association.Uninstall();
 
                 NotifyShellUpdate();
             }
@@ -132,26 +128,20 @@ namespace osu.Desktop.Windows
         /// </summary>
         private static void updateAssociations()
         {
-            using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-            Debug.Assert(classes != null);
-
             foreach (var association in file_associations)
-                association.Install(classes);
+                association.Install();
 
             foreach (var association in uri_associations)
-                association.Install(classes);
+                association.Install();
         }
 
         private static void updateDescriptions(LocalisationManager? localisation)
         {
-            using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
-            Debug.Assert(classes != null);
-
             foreach (var association in file_associations)
-                association.UpdateDescription(classes, getLocalisedString(association.Description));
+                association.UpdateDescription(getLocalisedString(association.Description));
 
             foreach (var association in uri_associations)
-                association.UpdateDescription(classes, getLocalisedString(association.Description));
+                association.UpdateDescription(getLocalisedString(association.Description));
 
             string getLocalisedString(LocalisableString s)
             {
@@ -192,8 +182,11 @@ namespace osu.Desktop.Windows
             /// <summary>
             /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
             /// </summary>
-            public void Install(RegistryKey classes)
+            public void Install()
             {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null) return;
+
                 // register a program id for the given extension
                 using (var programKey = classes.CreateSubKey(programId))
                 {
@@ -216,8 +209,11 @@ namespace osu.Desktop.Windows
                 }
             }
 
-            public void UpdateDescription(RegistryKey classes, string description)
+            public void UpdateDescription(string description)
             {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null) return;
+
                 using (var programKey = classes.OpenSubKey(programId, true))
                     programKey?.SetValue(null, description);
             }
@@ -225,8 +221,11 @@ namespace osu.Desktop.Windows
             /// <summary>
             /// Uninstalls the file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/shell/fa-file-types#deleting-registry-information-during-uninstallation
             /// </summary>
-            public void Uninstall(RegistryKey classes)
+            public void Uninstall()
             {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null) return;
+
                 using (var extensionKey = classes.OpenSubKey(Extension, true))
                 {
                     // clear our default association so that Explorer doesn't show the raw programId to users
@@ -253,8 +252,11 @@ namespace osu.Desktop.Windows
             /// <summary>
             /// Registers an URI protocol handler in accordance with https://learn.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/platform-apis/aa767914(v=vs.85).
             /// </summary>
-            public void Install(RegistryKey classes)
+            public void Install()
             {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null) return;
+
                 using (var protocolKey = classes.CreateSubKey(Protocol))
                 {
                     protocolKey.SetValue(URL_PROTOCOL, string.Empty);
@@ -267,15 +269,19 @@ namespace osu.Desktop.Windows
                 }
             }
 
-            public void UpdateDescription(RegistryKey classes, string description)
+            public void UpdateDescription(string description)
             {
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                if (classes == null) return;
+
                 using (var protocolKey = classes.OpenSubKey(Protocol, true))
                     protocolKey?.SetValue(null, $@"URL:{description}");
             }
 
-            public void Uninstall(RegistryKey classes)
+            public void Uninstall()
             {
-                classes.DeleteSubKeyTree(Protocol, throwOnMissingSubKey: false);
+                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                classes?.DeleteSubKeyTree(Protocol, throwOnMissingSubKey: false);
             }
         }
     }

From 3e9425fdf2d57dbeff8819bca208a63cb947eda9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 26 Feb 2024 22:12:04 +0900
Subject: [PATCH 169/930] Adjust API of HighPerformanceSession + rename

---
 osu.Game/OsuGame.cs                           |  4 +-
 .../Performance/HighPerformanceSession.cs     | 42 -------------------
 .../HighPerformanceSessionManager.cs          | 34 +++++++++++++++
 3 files changed, 36 insertions(+), 44 deletions(-)
 delete mode 100644 osu.Game/Performance/HighPerformanceSession.cs
 create mode 100644 osu.Game/Performance/HighPerformanceSessionManager.cs

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 9ffa88947b..f23a78d2dc 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -792,7 +792,7 @@ namespace osu.Game
 
         protected virtual UpdateManager CreateUpdateManager() => new UpdateManager();
 
-        protected virtual HighPerformanceSession CreateHighPerformanceSession() => new HighPerformanceSession();
+        protected virtual HighPerformanceSessionManager CreateHighPerformanceSessionManager() => new HighPerformanceSessionManager();
 
         protected override Container CreateScalingContainer() => new ScalingContainer(ScalingMode.Everything);
 
@@ -1088,7 +1088,7 @@ namespace osu.Game
             loadComponentSingleFile(new AccountCreationOverlay(), topMostOverlayContent.Add, true);
             loadComponentSingleFile<IDialogOverlay>(new DialogOverlay(), topMostOverlayContent.Add, true);
 
-            loadComponentSingleFile(CreateHighPerformanceSession(), Add);
+            loadComponentSingleFile(CreateHighPerformanceSessionManager(), Add, true);
 
             loadComponentSingleFile(new BackgroundDataStoreProcessor(), Add);
 
diff --git a/osu.Game/Performance/HighPerformanceSession.cs b/osu.Game/Performance/HighPerformanceSession.cs
deleted file mode 100644
index 07b5e7da98..0000000000
--- a/osu.Game/Performance/HighPerformanceSession.cs
+++ /dev/null
@@ -1,42 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Allocation;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Game.Screens.Play;
-
-namespace osu.Game.Performance
-{
-    public partial class HighPerformanceSession : Component
-    {
-        private readonly IBindable<bool> localUserPlaying = new Bindable<bool>();
-
-        [BackgroundDependencyLoader]
-        private void load(ILocalUserPlayInfo localUserInfo)
-        {
-            localUserPlaying.BindTo(localUserInfo.IsPlaying);
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            localUserPlaying.BindValueChanged(playing =>
-            {
-                if (playing.NewValue)
-                    EnableHighPerformanceSession();
-                else
-                    DisableHighPerformanceSession();
-            }, true);
-        }
-
-        protected virtual void EnableHighPerformanceSession()
-        {
-        }
-
-        protected virtual void DisableHighPerformanceSession()
-        {
-        }
-    }
-}
diff --git a/osu.Game/Performance/HighPerformanceSessionManager.cs b/osu.Game/Performance/HighPerformanceSessionManager.cs
new file mode 100644
index 0000000000..8a49ba0dac
--- /dev/null
+++ b/osu.Game/Performance/HighPerformanceSessionManager.cs
@@ -0,0 +1,34 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Runtime;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+
+namespace osu.Game.Performance
+{
+    public partial class HighPerformanceSessionManager : Component
+    {
+        private GCLatencyMode originalGCMode;
+
+        public IDisposable BeginSession()
+        {
+            EnableHighPerformanceSession();
+            return new InvokeOnDisposal<HighPerformanceSessionManager>(this, static m => m.DisableHighPerformanceSession());
+        }
+
+        protected virtual void EnableHighPerformanceSession()
+        {
+            originalGCMode = GCSettings.LatencyMode;
+            GCSettings.LatencyMode = GCLatencyMode.LowLatency;
+            GC.Collect(0);
+        }
+
+        protected virtual void DisableHighPerformanceSession()
+        {
+            if (GCSettings.LatencyMode == GCLatencyMode.LowLatency)
+                GCSettings.LatencyMode = originalGCMode;
+        }
+    }
+}

From 7a96cf12893c3e5d5d6ec2b679a07230e70efe29 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 21:15:44 +0800
Subject: [PATCH 170/930] Expose `AudioFilter.IsAttached` publicly

---
 osu.Game/Audio/Effects/AudioFilter.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Audio/Effects/AudioFilter.cs b/osu.Game/Audio/Effects/AudioFilter.cs
index c8673372d7..bfa9b31242 100644
--- a/osu.Game/Audio/Effects/AudioFilter.cs
+++ b/osu.Game/Audio/Effects/AudioFilter.cs
@@ -17,12 +17,15 @@ namespace osu.Game.Audio.Effects
         /// </summary>
         public const int MAX_LOWPASS_CUTOFF = 22049; // nyquist - 1hz
 
+        /// <summary>
+        /// Whether this filter is currently attached to the audio track and thus applying an adjustment.
+        /// </summary>
+        public bool IsAttached { get; private set; }
+
         private readonly AudioMixer mixer;
         private readonly BQFParameters filter;
         private readonly BQFType type;
 
-        private bool isAttached;
-
         private readonly Cached filterApplication = new Cached();
 
         private int cutoff;
@@ -132,22 +135,22 @@ namespace osu.Game.Audio.Effects
 
         private void ensureAttached()
         {
-            if (isAttached)
+            if (IsAttached)
                 return;
 
             Debug.Assert(!mixer.Effects.Contains(filter));
             mixer.Effects.Add(filter);
-            isAttached = true;
+            IsAttached = true;
         }
 
         private void ensureDetached()
         {
-            if (!isAttached)
+            if (!IsAttached)
                 return;
 
             Debug.Assert(mixer.Effects.Contains(filter));
             mixer.Effects.Remove(filter);
-            isAttached = false;
+            IsAttached = false;
         }
 
         protected override void Dispose(bool isDisposing)

From c686dfd36164f6eb980f0d96e64700dad95cf8f2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 21:16:15 +0800
Subject: [PATCH 171/930] Apply safeties for `AudioFilter` usage around
 drawables which go non-present

---
 .../Collections/ManageCollectionsDialog.cs    |  5 +++
 osu.Game/Overlays/DialogOverlay.cs            |  8 +++--
 osu.Game/Screens/Play/PlayerLoader.cs         | 35 +++++++++++++------
 3 files changed, 36 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Collections/ManageCollectionsDialog.cs b/osu.Game/Collections/ManageCollectionsDialog.cs
index cc0f23d030..16645d6796 100644
--- a/osu.Game/Collections/ManageCollectionsDialog.cs
+++ b/osu.Game/Collections/ManageCollectionsDialog.cs
@@ -115,6 +115,11 @@ namespace osu.Game.Collections
             };
         }
 
+        public override bool IsPresent => base.IsPresent
+                                          // Safety for low pass filter potentially getting stuck in applied state due to
+                                          // transforms on `this` causing children to no longer be updated.
+                                          || lowPassFilter.IsAttached;
+
         protected override void PopIn()
         {
             lowPassFilter.CutoffTo(300, 100, Easing.OutCubic);
diff --git a/osu.Game/Overlays/DialogOverlay.cs b/osu.Game/Overlays/DialogOverlay.cs
index a85f1ecbcd..9ad532ae50 100644
--- a/osu.Game/Overlays/DialogOverlay.cs
+++ b/osu.Game/Overlays/DialogOverlay.cs
@@ -27,6 +27,12 @@ namespace osu.Game.Overlays
 
         public PopupDialog CurrentDialog { get; private set; }
 
+        public override bool IsPresent => Scheduler.HasPendingTasks
+                                          || dialogContainer.Children.Count > 0
+                                          // Safety for low pass filter potentially getting stuck in applied state due to
+                                          // transforms on `this` causing children to no longer be updated.
+                                          || lowPassFilter.IsAttached;
+
         public DialogOverlay()
         {
             AutoSizeAxes = Axes.Y;
@@ -95,8 +101,6 @@ namespace osu.Game.Overlays
             }
         }
 
-        public override bool IsPresent => Scheduler.HasPendingTasks || dialogContainer.Children.Count > 0;
-
         protected override bool BlockNonPositionalInput => true;
 
         protected override void PopIn()
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index aa62256348..aef7a0739e 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -78,8 +78,8 @@ namespace osu.Game.Screens.Play
 
         private readonly BindableDouble volumeAdjustment = new BindableDouble(1);
 
-        private AudioFilter lowPassFilter = null!;
-        private AudioFilter highPassFilter = null!;
+        private AudioFilter? lowPassFilter;
+        private AudioFilter? highPassFilter;
 
         private SkinnableSound sampleRestart = null!;
 
@@ -158,7 +158,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load(SessionStatics sessionStatics, AudioManager audio, OsuConfigManager config)
+        private void load(SessionStatics sessionStatics, OsuConfigManager config)
         {
             muteWarningShownOnce = sessionStatics.GetBindable<bool>(Static.MutedAudioNotificationShownOnce);
             batteryWarningShownOnce = sessionStatics.GetBindable<bool>(Static.LowBatteryNotificationShownOnce);
@@ -205,8 +205,6 @@ namespace osu.Game.Screens.Play
                     },
                 },
                 idleTracker = new IdleTracker(750),
-                lowPassFilter = new AudioFilter(audio.TrackMixer),
-                highPassFilter = new AudioFilter(audio.TrackMixer, BQFType.HighPass),
                 sampleRestart = new SkinnableSound(new SampleInfo(@"Gameplay/restart", @"pause-retry-click"))
             };
 
@@ -284,8 +282,9 @@ namespace osu.Game.Screens.Play
             // stop the track before removing adjustment to avoid a volume spike.
             Beatmap.Value.Track.Stop();
             Beatmap.Value.Track.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
-            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF);
-            highPassFilter.CutoffTo(0);
+
+            lowPassFilter?.RemoveAndDisposeImmediately();
+            highPassFilter?.RemoveAndDisposeImmediately();
         }
 
         public override bool OnExiting(ScreenExitEvent e)
@@ -425,6 +424,12 @@ namespace osu.Game.Screens.Play
             settingsScroll.FadeInFromZero(500, Easing.Out)
                           .MoveToX(0, 500, Easing.OutQuint);
 
+            AddRangeInternal(new[]
+            {
+                lowPassFilter = new AudioFilter(audioManager.TrackMixer),
+                highPassFilter = new AudioFilter(audioManager.TrackMixer, BQFType.HighPass),
+            });
+
             lowPassFilter.CutoffTo(1000, 650, Easing.OutQuint);
             highPassFilter.CutoffTo(300).Then().CutoffTo(0, 1250); // 1250 is to line up with the appearance of MetadataInfo (750 delay + 500 fade-in)
 
@@ -437,13 +442,23 @@ namespace osu.Game.Screens.Play
             content.StopTracking();
 
             content.ScaleTo(0.7f, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
-            content.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint);
+            content.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint)
+                   // Safety for filter potentially getting stuck in applied state due to
+                   // transforms on `this` causing children to no longer be updated.
+                   .OnComplete(_ =>
+                   {
+                       highPassFilter?.RemoveAndDisposeImmediately();
+                       highPassFilter = null;
+
+                       lowPassFilter?.RemoveAndDisposeImmediately();
+                       lowPassFilter = null;
+                   });
 
             settingsScroll.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint)
                           .MoveToX(settingsScroll.DrawWidth, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
 
-            lowPassFilter.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, CONTENT_OUT_DURATION);
-            highPassFilter.CutoffTo(0, CONTENT_OUT_DURATION);
+            lowPassFilter?.CutoffTo(AudioFilter.MAX_LOWPASS_CUTOFF, CONTENT_OUT_DURATION);
+            highPassFilter?.CutoffTo(0, CONTENT_OUT_DURATION);
         }
 
         private void pushWhenLoaded()

From bfb5098238b451fc768ae855854ac9b925b57816 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 26 Feb 2024 22:13:15 +0900
Subject: [PATCH 172/930] Use high performance session during gameplay

---
 .../Performance/HighPerformanceSessionManager.cs |  4 ++++
 osu.Game/Screens/Play/PlayerLoader.cs            | 16 ++++++++++++++++
 2 files changed, 20 insertions(+)

diff --git a/osu.Game/Performance/HighPerformanceSessionManager.cs b/osu.Game/Performance/HighPerformanceSessionManager.cs
index 8a49ba0dac..c5146933b7 100644
--- a/osu.Game/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Game/Performance/HighPerformanceSessionManager.cs
@@ -22,6 +22,8 @@ namespace osu.Game.Performance
         {
             originalGCMode = GCSettings.LatencyMode;
             GCSettings.LatencyMode = GCLatencyMode.LowLatency;
+
+            // Without doing this, the new GC mode won't kick in until the next GC, which could be at a more noticeable point in time.
             GC.Collect(0);
         }
 
@@ -29,6 +31,8 @@ namespace osu.Game.Performance
         {
             if (GCSettings.LatencyMode == GCLatencyMode.LowLatency)
                 GCSettings.LatencyMode = originalGCMode;
+
+            // No GC.Collect() as we were already collecting at a higher frequency in the old mode.
         }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index aa62256348..fe235dd56d 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -25,6 +25,7 @@ using osu.Game.Input;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Performance;
 using osu.Game.Screens.Menu;
 using osu.Game.Screens.Play.PlayerSettings;
 using osu.Game.Skinning;
@@ -140,6 +141,8 @@ namespace osu.Game.Screens.Play
 
         private bool quickRestart;
 
+        private IDisposable? highPerformanceSession;
+
         [Resolved]
         private INotificationOverlay? notificationOverlay { get; set; }
 
@@ -152,6 +155,9 @@ namespace osu.Game.Screens.Play
         [Resolved]
         private BatteryInfo? batteryInfo { get; set; }
 
+        [Resolved]
+        private HighPerformanceSessionManager? highPerformanceSessionManager { get; set; }
+
         public PlayerLoader(Func<Player> createPlayer)
         {
             this.createPlayer = createPlayer;
@@ -264,6 +270,9 @@ namespace osu.Game.Screens.Play
 
             Debug.Assert(CurrentPlayer != null);
 
+            highPerformanceSession?.Dispose();
+            highPerformanceSession = null;
+
             // prepare for a retry.
             CurrentPlayer = null;
             playerConsumed = false;
@@ -304,6 +313,9 @@ namespace osu.Game.Screens.Play
             BackgroundBrightnessReduction = false;
             Beatmap.Value.Track.RemoveAdjustment(AdjustableProperty.Volume, volumeAdjustment);
 
+            highPerformanceSession?.Dispose();
+            highPerformanceSession = null;
+
             return base.OnExiting(e);
         }
 
@@ -463,6 +475,10 @@ namespace osu.Game.Screens.Play
             if (scheduledPushPlayer != null)
                 return;
 
+            // Now that everything's been loaded, we can safely switch to a higher performance session without incurring too much overhead.
+            // Doing this prior to the game being pushed gives us a bit of time to stabilise into the high performance mode before gameplay starts.
+            highPerformanceSession ??= highPerformanceSessionManager?.BeginSession();
+
             scheduledPushPlayer = Scheduler.AddDelayed(() =>
             {
                 // ensure that once we have reached this "point of no return", readyForPush will be false for all future checks (until a new player instance is prepared).

From d6622c1756c57569f85a1b1df25f7042e7515a8a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 22:24:35 +0800
Subject: [PATCH 173/930] Add test coverage of fast menu keypresses failing to
 register

---
 .../Navigation/TestSceneButtonSystemNavigation.cs | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
index c6d67f2bc6..43b160250c 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneButtonSystemNavigation.cs
@@ -28,6 +28,21 @@ namespace osu.Game.Tests.Visual.Navigation
             AddAssert("state is top level", () => buttons.State == ButtonSystemState.TopLevel);
         }
 
+        [Test]
+        public void TestFastShortcutKeys()
+        {
+            AddAssert("state is initial", () => buttons.State == ButtonSystemState.Initial);
+
+            AddStep("press P three times", () =>
+            {
+                InputManager.Key(Key.P);
+                InputManager.Key(Key.P);
+                InputManager.Key(Key.P);
+            });
+
+            AddAssert("entered song select", () => Game.ScreenStack.CurrentScreen is PlaySongSelect);
+        }
+
         [Test]
         public void TestShortcutKeys()
         {

From 4c6e8a606fbb669c5949910bc2026435180e3eb8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 26 Feb 2024 22:22:43 +0800
Subject: [PATCH 174/930] Fix main menu eating keys if user presses too fast

---
 osu.Game/Screens/Menu/MainMenuButton.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index 422599a4a8..1dc79e9b1a 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -64,6 +64,10 @@ namespace osu.Game.Screens.Menu
         private Sample? sampleHover;
         private SampleChannel? sampleChannel;
 
+        public override bool IsPresent => base.IsPresent
+                                          // Allow keyboard interaction based on state rather than waiting for delayed animations.
+                                          || state == ButtonState.Expanded;
+
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => box.ReceivePositionalInputAt(screenSpacePos);
 
         public MainMenuButton(LocalisableString text, string sampleName, IconUsage symbol, Color4 colour, Action? clickAction = null, float extraWidth = 0, params Key[] triggerKeys)

From 8032ce9225950f5fc5d6dba911833e9b3f8afa93 Mon Sep 17 00:00:00 2001
From: Detze <92268414+Detze@users.noreply.github.com>
Date: Mon, 26 Feb 2024 18:37:27 +0100
Subject: [PATCH 175/930] Match stable's slider border thickness perfectly

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index 6bf6776617..af82a81e08 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -26,8 +26,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             private const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
 
             protected new float CalculatedBorderPortion
-                // Roughly matches osu!stable's slider border portions.
-                => base.CalculatedBorderPortion * 0.84f;
+                // Matches osu!stable's slider border portions.
+                => 0.109375f;
 
             protected override Color4 ColourAt(float position)
             {

From 2b73d816a70fab655cdf7a9f716d6630b333ed54 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 26 Feb 2024 21:26:35 +0300
Subject: [PATCH 176/930] Bring back mod setting tracker in
 `BeatmapAttributesDisplay`

---
 osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs | 12 +++++++++++-
 osu.Game/Overlays/Mods/ModSelectOverlay.cs         |  7 +------
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
index 7035af1594..c58cf710bd 100644
--- a/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
+++ b/osu.Game/Overlays/Mods/BeatmapAttributesDisplay.cs
@@ -13,6 +13,7 @@ using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
@@ -43,6 +44,8 @@ namespace osu.Game.Overlays.Mods
 
         public BindableBool Collapsed { get; } = new BindableBool(true);
 
+        private ModSettingChangeTracker? modSettingChangeTracker;
+
         [Resolved]
         private BeatmapDifficultyCache difficultyCache { get; set; } = null!;
 
@@ -97,7 +100,14 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            Mods.BindValueChanged(_ => updateValues());
+            Mods.BindValueChanged(_ =>
+            {
+                modSettingChangeTracker?.Dispose();
+                modSettingChangeTracker = new ModSettingChangeTracker(Mods.Value);
+                modSettingChangeTracker.SettingChanged += _ => updateValues();
+                updateValues();
+            }, true);
+
             BeatmapInfo.BindValueChanged(_ => updateValues());
 
             Collapsed.BindValueChanged(_ =>
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index bf43dc3d9c..b7e2f744fa 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -468,12 +468,7 @@ namespace osu.Game.Overlays.Mods
             }
 
             if (beatmapAttributesDisplay != null)
-            {
-                if (!ReferenceEquals(beatmapAttributesDisplay.Mods.Value, mods))
-                    beatmapAttributesDisplay.Mods.Value = mods;
-                else
-                    beatmapAttributesDisplay.Mods.TriggerChange(); // mods list may be same but a mod setting has changed, trigger change in that case.
-            }
+                beatmapAttributesDisplay.Mods.Value = mods;
         }
 
         private void updateCustomisation()

From 3f9fbb931849a5f6276de638e621a1e341149cc3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 26 Feb 2024 22:25:04 +0300
Subject: [PATCH 177/930] Introduce the concept of `ActiveMods` in mod select
 overlay and rewrite once more

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 37 +++++++++++++------
 .../OnlinePlay/Match/RoomModSelectOverlay.cs  | 21 +++--------
 2 files changed, 32 insertions(+), 26 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index b7e2f744fa..6b80ff6e44 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -42,6 +42,14 @@ namespace osu.Game.Overlays.Mods
         [Cached]
         public Bindable<IReadOnlyList<Mod>> SelectedMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
+        /// <summary>
+        /// Contains a list of mods which <see cref="ModSelectOverlay"/> should read from to display effects on the selected beatmap.
+        /// </summary>
+        /// <remarks>
+        /// This is different from <see cref="SelectedMods"/> in screens like online-play rooms, where there are required mods activated from the playlist.
+        /// </remarks>
+        public Bindable<IReadOnlyList<Mod>> ActiveMods { get; private set; } = new Bindable<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+
         /// <summary>
         /// Contains a dictionary with the current <see cref="ModState"/> of all mods applicable for the current ruleset.
         /// </summary>
@@ -313,22 +321,29 @@ namespace osu.Game.Overlays.Mods
             if (AllowCustomisation)
                 ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 
-            SelectedMods.BindValueChanged(_ =>
+            SelectedMods.BindValueChanged(mods =>
             {
-                UpdateOverlayInformation(SelectedMods.Value);
+                var newMods = ActiveMods.Value.Except(mods.OldValue).Concat(mods.NewValue).ToList();
+                ActiveMods.Value = newMods;
+
                 updateFromExternalSelection();
                 updateCustomisation();
+            }, true);
+
+            ActiveMods.BindValueChanged(_ =>
+            {
+                updateOverlayInformation();
 
                 modSettingChangeTracker?.Dispose();
 
                 if (AllowCustomisation)
                 {
-                    // Importantly, use SelectedMods.Value here (and not the ValueChanged NewValue) as the latter can
+                    // Importantly, use ActiveMods.Value here (and not the ValueChanged NewValue) as the latter can
                     // potentially be stale, due to complexities in the way change trackers work.
                     //
                     // See https://github.com/ppy/osu/pull/23284#issuecomment-1529056988
-                    modSettingChangeTracker = new ModSettingChangeTracker(SelectedMods.Value);
-                    modSettingChangeTracker.SettingChanged += _ => UpdateOverlayInformation(SelectedMods.Value);
+                    modSettingChangeTracker = new ModSettingChangeTracker(ActiveMods.Value);
+                    modSettingChangeTracker.SettingChanged += _ => updateOverlayInformation();
                 }
             }, true);
 
@@ -451,24 +466,24 @@ namespace osu.Game.Overlays.Mods
         }
 
         /// <summary>
-        /// Updates any information displayed on the overlay regarding the effects of the selected mods.
+        /// Updates any information displayed on the overlay regarding the effects of the active mods.
+        /// This reads from <see cref="ActiveMods"/> instead of <see cref="SelectedMods"/>.
         /// </summary>
-        /// <param name="mods">The list of mods to show effect from. This can be overriden to include effect of mods that are not part of the <see cref="SelectedMods"/> bindable (e.g. room mods in multiplayer/playlists).</param>
-        protected virtual void UpdateOverlayInformation(IReadOnlyList<Mod> mods)
+        private void updateOverlayInformation()
         {
             if (rankingInformationDisplay != null)
             {
                 double multiplier = 1.0;
 
-                foreach (var mod in mods)
+                foreach (var mod in ActiveMods.Value)
                     multiplier *= mod.ScoreMultiplier;
 
                 rankingInformationDisplay.ModMultiplier.Value = multiplier;
-                rankingInformationDisplay.Ranked.Value = mods.All(m => m.Ranked);
+                rankingInformationDisplay.Ranked.Value = ActiveMods.Value.All(m => m.Ranked);
             }
 
             if (beatmapAttributesDisplay != null)
-                beatmapAttributesDisplay.Mods.Value = mods;
+                beatmapAttributesDisplay.Mods.Value = ActiveMods.Value;
         }
 
         private void updateCustomisation()
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index db7cfe980c..d3fd6de911 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
@@ -10,7 +9,6 @@ using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Screens.OnlinePlay.Match
 {
@@ -22,8 +20,6 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
-        private readonly List<Mod> roomMods = new List<Mod>();
-
         public RoomModSelectOverlay()
             : base(OverlayColourScheme.Plum)
         {
@@ -33,22 +29,17 @@ namespace osu.Game.Screens.OnlinePlay.Match
         {
             base.LoadComplete();
 
-            selectedItem.BindValueChanged(_ =>
+            selectedItem.BindValueChanged(v =>
             {
-                roomMods.Clear();
-
-                if (selectedItem.Value is PlaylistItem item)
+                if (v.NewValue is PlaylistItem item)
                 {
                     var rulesetInstance = rulesets.GetRuleset(item.RulesetID)?.CreateInstance();
                     Debug.Assert(rulesetInstance != null);
-                    roomMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
+                    ActiveMods.Value = item.RequiredMods.Select(m => m.ToMod(rulesetInstance)).Concat(SelectedMods.Value).ToList();
                 }
-
-                SelectedMods.TriggerChange();
-            });
+                else
+                    ActiveMods.Value = SelectedMods.Value;
+            }, true);
         }
-
-        protected override void UpdateOverlayInformation(IReadOnlyList<Mod> mods)
-            => base.UpdateOverlayInformation(roomMods.Concat(mods).ToList());
     }
 }

From 2151e0a2947e4c2cc4b5b071c2af1fce852359b5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 26 Feb 2024 22:25:20 +0300
Subject: [PATCH 178/930] Improve test coverage

---
 .../TestSceneMultiplayerMatchSubScreen.cs            | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
index 4bedc31f38..bdfe01ba09 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiplayerMatchSubScreen.cs
@@ -22,6 +22,7 @@ using osu.Game.Overlays;
 using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Rulesets.Taiko;
@@ -303,7 +304,6 @@ namespace osu.Game.Tests.Visual.Multiplayer
                     AllowedMods = new[]
                     {
                         new APIMod(new OsuModFlashlight()),
-                        new APIMod(new OsuModHardRock()),
                     }
                 });
             });
@@ -312,8 +312,14 @@ namespace osu.Game.Tests.Visual.Multiplayer
             AddUntilStep("wait for join", () => RoomJoined);
 
             ClickButtonWhenEnabled<RoomSubScreen.UserModSelectButton>();
-            AddAssert("mod select shows unranked", () => this.ChildrenOfType<RankingInformationDisplay>().Single().Ranked.Value == false);
-            AddAssert("mod select shows different multiplier", () => !this.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.IsDefault);
+            AddAssert("mod select shows unranked", () => screen.UserModsSelectOverlay.ChildrenOfType<RankingInformationDisplay>().Single().Ranked.Value == false);
+            AddAssert("score multiplier = 1.20", () => screen.UserModsSelectOverlay.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.Value, () => Is.EqualTo(1.2).Within(0.01));
+
+            AddStep("select flashlight", () => screen.UserModsSelectOverlay.ChildrenOfType<ModPanel>().Single(m => m.Mod is ModFlashlight).TriggerClick());
+            AddAssert("score multiplier = 1.35", () => screen.UserModsSelectOverlay.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.Value, () => Is.EqualTo(1.35).Within(0.01));
+
+            AddStep("change flashlight setting", () => ((OsuModFlashlight)screen.UserModsSelectOverlay.SelectedMods.Value.Single()).FollowDelay.Value = 1200);
+            AddAssert("score multiplier = 1.20", () => screen.UserModsSelectOverlay.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.Value, () => Is.EqualTo(1.2).Within(0.01));
         }
 
         private partial class TestMultiplayerMatchSubScreen : MultiplayerMatchSubScreen

From 8363c39da86b4dde7f700ebf3c3a908a4dca945e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 01:30:20 +0300
Subject: [PATCH 179/930] Revert "Match stable's slider border thickness
 perfectly"

This reverts commit 8032ce9225950f5fc5d6dba911833e9b3f8afa93.
---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index af82a81e08..6bf6776617 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -26,8 +26,8 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             private const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
 
             protected new float CalculatedBorderPortion
-                // Matches osu!stable's slider border portions.
-                => 0.109375f;
+                // Roughly matches osu!stable's slider border portions.
+                => base.CalculatedBorderPortion * 0.84f;
 
             protected override Color4 ColourAt(float position)
             {

From e01722a266e887b6032b520ca3f0fcd0011df51e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 01:30:20 +0300
Subject: [PATCH 180/930] Revert "Match stable's slider border thickness more
 closely"

This reverts commit 3502ec456d0131f4f6c1c9faabf01e6197a16ee1.
---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index 6bf6776617..b39092a467 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             protected new float CalculatedBorderPortion
                 // Roughly matches osu!stable's slider border portions.
-                => base.CalculatedBorderPortion * 0.84f;
+                => base.CalculatedBorderPortion * 0.77f;
 
             protected override Color4 ColourAt(float position)
             {

From 81e6a6d96a0f62f0ce015e232217ee8b207ea76f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 02:11:32 +0300
Subject: [PATCH 181/930] Rewrite `LegacySliderBody` rendering to perfectly
 match stable

---
 .../Skinning/Legacy/LegacySliderBody.cs       | 34 +++++++++----------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index b39092a467..264bb3145d 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -23,29 +23,29 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
         private partial class LegacyDrawableSliderPath : DrawableSliderPath
         {
-            private const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
-
-            protected new float CalculatedBorderPortion
-                // Roughly matches osu!stable's slider border portions.
-                => base.CalculatedBorderPortion * 0.77f;
-
             protected override Color4 ColourAt(float position)
             {
-                float realBorderPortion = shadow_portion + CalculatedBorderPortion;
-                float realGradientPortion = 1 - realBorderPortion;
-
-                if (position <= shadow_portion)
-                    return new Color4(0f, 0f, 0f, 0.25f * position / shadow_portion);
-
-                if (position <= realBorderPortion)
-                    return BorderColour;
-
-                position -= realBorderPortion;
+                const float aa_width = 0.5f / 64f;
+                const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
+                const float border_portion = 0.1875f;
 
+                Color4 shadow = new Color4(0, 0, 0, 0.25f);
                 Color4 outerColour = AccentColour.Darken(0.1f);
                 Color4 innerColour = lighten(AccentColour, 0.5f);
 
-                return LegacyUtils.InterpolateNonLinear(position / realGradientPortion, outerColour, innerColour, 0, 1);
+                if (position <= shadow_portion - aa_width)
+                    return LegacyUtils.InterpolateNonLinear(position, Color4.Black.Opacity(0f), shadow, 0, shadow_portion - aa_width);
+
+                if (position <= shadow_portion + aa_width)
+                    return LegacyUtils.InterpolateNonLinear(position, shadow, BorderColour, shadow_portion - aa_width, shadow_portion + aa_width);
+
+                if (position <= border_portion - aa_width)
+                    return BorderColour;
+
+                if (position <= border_portion + aa_width)
+                    return LegacyUtils.InterpolateNonLinear(position, BorderColour, outerColour, border_portion - aa_width, border_portion + aa_width);
+
+                return LegacyUtils.InterpolateNonLinear(position, outerColour, innerColour, border_portion + aa_width, 1);
             }
 
             /// <summary>

From 2f547751826c391b765b9f0096f7f18b5649a5d8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 02:16:16 +0300
Subject: [PATCH 182/930] Add stable code references

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index 264bb3145d..fa2b7863db 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -25,14 +25,17 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         {
             protected override Color4 ColourAt(float position)
             {
+                // https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/Graphics/Renderers/MmSliderRendererGL.cs#L99
                 const float aa_width = 0.5f / 64f;
-                const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
-                const float border_portion = 0.1875f;
 
                 Color4 shadow = new Color4(0, 0, 0, 0.25f);
                 Color4 outerColour = AccentColour.Darken(0.1f);
                 Color4 innerColour = lighten(AccentColour, 0.5f);
 
+                // https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/Graphics/Renderers/MmSliderRendererGL.cs#L59-L70
+                const float shadow_portion = 1 - (OsuLegacySkinTransformer.LEGACY_CIRCLE_RADIUS / OsuHitObject.OBJECT_RADIUS);
+                const float border_portion = 0.1875f;
+
                 if (position <= shadow_portion - aa_width)
                     return LegacyUtils.InterpolateNonLinear(position, Color4.Black.Opacity(0f), shadow, 0, shadow_portion - aa_width);
 

From 18e26e39feb2fb386b433595724a4970ac841617 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 02:20:34 +0300
Subject: [PATCH 183/930] Remove `SliderBorderSize` for simplicity

---
 osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs | 1 -
 osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs   | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs
index fb31f88d3c..bda1e6cf41 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/PlaySliderBody.cs
@@ -44,7 +44,6 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
 
             SnakingOut.BindTo(configSnakingOut);
 
-            BorderSize = skin.GetConfig<OsuSkinConfiguration, float>(OsuSkinConfiguration.SliderBorderSize)?.Value ?? 1;
             BorderColour = skin.GetConfig<OsuSkinColour, Color4>(OsuSkinColour.SliderBorder)?.Value ?? Color4.White;
         }
 
diff --git a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
index 77fea9d8f7..9685ab685d 100644
--- a/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/OsuSkinConfiguration.cs
@@ -5,7 +5,6 @@ namespace osu.Game.Rulesets.Osu.Skinning
 {
     public enum OsuSkinConfiguration
     {
-        SliderBorderSize,
         SliderPathRadius,
         CursorCentre,
         CursorExpand,

From 83af9dfb39d222a02fa45c726f1e50d43b27867f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 02:43:02 +0300
Subject: [PATCH 184/930] Fix `aa_width` being incorrect

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index fa2b7863db..a00014ab88 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             protected override Color4 ColourAt(float position)
             {
                 // https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/Graphics/Renderers/MmSliderRendererGL.cs#L99
-                const float aa_width = 0.5f / 64f;
+                const float aa_width = 3f / 256f;
 
                 Color4 shadow = new Color4(0, 0, 0, 0.25f);
                 Color4 outerColour = AccentColour.Darken(0.1f);

From f2d52fbaa2656b1a334d32b8142b56ff44c5bbb1 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 27 Feb 2024 17:33:24 +0900
Subject: [PATCH 185/930] Make class not overrideable

---
 osu.Game/OsuGame.cs                                   | 4 +---
 osu.Game/Performance/HighPerformanceSessionManager.cs | 8 ++++----
 2 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index f23a78d2dc..13e80e0707 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -792,8 +792,6 @@ namespace osu.Game
 
         protected virtual UpdateManager CreateUpdateManager() => new UpdateManager();
 
-        protected virtual HighPerformanceSessionManager CreateHighPerformanceSessionManager() => new HighPerformanceSessionManager();
-
         protected override Container CreateScalingContainer() => new ScalingContainer(ScalingMode.Everything);
 
         #region Beatmap progression
@@ -1088,7 +1086,7 @@ namespace osu.Game
             loadComponentSingleFile(new AccountCreationOverlay(), topMostOverlayContent.Add, true);
             loadComponentSingleFile<IDialogOverlay>(new DialogOverlay(), topMostOverlayContent.Add, true);
 
-            loadComponentSingleFile(CreateHighPerformanceSessionManager(), Add, true);
+            loadComponentSingleFile(new HighPerformanceSessionManager(), Add, true);
 
             loadComponentSingleFile(new BackgroundDataStoreProcessor(), Add);
 
diff --git a/osu.Game/Performance/HighPerformanceSessionManager.cs b/osu.Game/Performance/HighPerformanceSessionManager.cs
index c5146933b7..22c929083c 100644
--- a/osu.Game/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Game/Performance/HighPerformanceSessionManager.cs
@@ -14,11 +14,11 @@ namespace osu.Game.Performance
 
         public IDisposable BeginSession()
         {
-            EnableHighPerformanceSession();
-            return new InvokeOnDisposal<HighPerformanceSessionManager>(this, static m => m.DisableHighPerformanceSession());
+            enableHighPerformanceSession();
+            return new InvokeOnDisposal<HighPerformanceSessionManager>(this, static m => m.disableHighPerformanceSession());
         }
 
-        protected virtual void EnableHighPerformanceSession()
+        private void enableHighPerformanceSession()
         {
             originalGCMode = GCSettings.LatencyMode;
             GCSettings.LatencyMode = GCLatencyMode.LowLatency;
@@ -27,7 +27,7 @@ namespace osu.Game.Performance
             GC.Collect(0);
         }
 
-        protected virtual void DisableHighPerformanceSession()
+        private void disableHighPerformanceSession()
         {
             if (GCSettings.LatencyMode == GCLatencyMode.LowLatency)
                 GCSettings.LatencyMode = originalGCMode;

From dc3b41865cbf8ebb0b31f5d6d9ae042a93a14356 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 27 Feb 2024 19:17:34 +0900
Subject: [PATCH 186/930] Add logging

---
 osu.Game/Performance/HighPerformanceSessionManager.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Performance/HighPerformanceSessionManager.cs b/osu.Game/Performance/HighPerformanceSessionManager.cs
index 22c929083c..304ab44975 100644
--- a/osu.Game/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Game/Performance/HighPerformanceSessionManager.cs
@@ -5,6 +5,7 @@ using System;
 using System.Runtime;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Framework.Logging;
 
 namespace osu.Game.Performance
 {
@@ -20,6 +21,8 @@ namespace osu.Game.Performance
 
         private void enableHighPerformanceSession()
         {
+            Logger.Log("Starting high performance session");
+
             originalGCMode = GCSettings.LatencyMode;
             GCSettings.LatencyMode = GCLatencyMode.LowLatency;
 
@@ -29,6 +32,8 @@ namespace osu.Game.Performance
 
         private void disableHighPerformanceSession()
         {
+            Logger.Log("Ending high performance session");
+
             if (GCSettings.LatencyMode == GCLatencyMode.LowLatency)
                 GCSettings.LatencyMode = originalGCMode;
 

From 069b400dd08e21ce8e52369e5708721680b2c1f4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 27 Feb 2024 19:36:03 +0900
Subject: [PATCH 187/930] Move manager to desktop game

---
 osu.Desktop/OsuGameDesktop.cs                        |  6 ++++++
 .../Performance/HighPerformanceSessionManager.cs     |  6 +++---
 osu.Game/OsuGame.cs                                  |  3 ---
 .../Performance/IHighPerformanceSessionManager.cs    | 12 ++++++++++++
 osu.Game/Screens/Play/PlayerLoader.cs                |  2 +-
 5 files changed, 22 insertions(+), 7 deletions(-)
 rename {osu.Game => osu.Desktop}/Performance/HighPerformanceSessionManager.cs (90%)
 create mode 100644 osu.Game/Performance/IHighPerformanceSessionManager.cs

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index a0db896f46..5b5f5c2167 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -7,6 +7,7 @@ using System.IO;
 using System.Reflection;
 using System.Runtime.Versioning;
 using Microsoft.Win32;
+using osu.Desktop.Performance;
 using osu.Desktop.Security;
 using osu.Framework.Platform;
 using osu.Game;
@@ -15,9 +16,11 @@ using osu.Framework;
 using osu.Framework.Logging;
 using osu.Game.Updater;
 using osu.Desktop.Windows;
+using osu.Framework.Allocation;
 using osu.Game.IO;
 using osu.Game.IPC;
 using osu.Game.Online.Multiplayer;
+using osu.Game.Performance;
 using osu.Game.Utils;
 using SDL2;
 
@@ -28,6 +31,9 @@ namespace osu.Desktop
         private OsuSchemeLinkIPCChannel? osuSchemeLinkIPCChannel;
         private ArchiveImportIPCChannel? archiveImportIPCChannel;
 
+        [Cached(typeof(IHighPerformanceSessionManager))]
+        private readonly HighPerformanceSessionManager highPerformanceSessionManager = new HighPerformanceSessionManager();
+
         public OsuGameDesktop(string[]? args = null)
             : base(args)
         {
diff --git a/osu.Game/Performance/HighPerformanceSessionManager.cs b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
similarity index 90%
rename from osu.Game/Performance/HighPerformanceSessionManager.cs
rename to osu.Desktop/Performance/HighPerformanceSessionManager.cs
index 304ab44975..eb2b3be5b9 100644
--- a/osu.Game/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
@@ -4,12 +4,12 @@
 using System;
 using System.Runtime;
 using osu.Framework.Allocation;
-using osu.Framework.Graphics;
 using osu.Framework.Logging;
+using osu.Game.Performance;
 
-namespace osu.Game.Performance
+namespace osu.Desktop.Performance
 {
-    public partial class HighPerformanceSessionManager : Component
+    public class HighPerformanceSessionManager : IHighPerformanceSessionManager
     {
         private GCLatencyMode originalGCMode;
 
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 13e80e0707..f65557c6bb 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -55,7 +55,6 @@ using osu.Game.Overlays.Notifications;
 using osu.Game.Overlays.SkinEditor;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Overlays.Volume;
-using osu.Game.Performance;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens;
@@ -1086,8 +1085,6 @@ namespace osu.Game
             loadComponentSingleFile(new AccountCreationOverlay(), topMostOverlayContent.Add, true);
             loadComponentSingleFile<IDialogOverlay>(new DialogOverlay(), topMostOverlayContent.Add, true);
 
-            loadComponentSingleFile(new HighPerformanceSessionManager(), Add, true);
-
             loadComponentSingleFile(new BackgroundDataStoreProcessor(), Add);
 
             Add(difficultyRecommender);
diff --git a/osu.Game/Performance/IHighPerformanceSessionManager.cs b/osu.Game/Performance/IHighPerformanceSessionManager.cs
new file mode 100644
index 0000000000..826a0a04f5
--- /dev/null
+++ b/osu.Game/Performance/IHighPerformanceSessionManager.cs
@@ -0,0 +1,12 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+
+namespace osu.Game.Performance
+{
+    public interface IHighPerformanceSessionManager
+    {
+        IDisposable BeginSession();
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index fe235dd56d..00a4a86c71 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -156,7 +156,7 @@ namespace osu.Game.Screens.Play
         private BatteryInfo? batteryInfo { get; set; }
 
         [Resolved]
-        private HighPerformanceSessionManager? highPerformanceSessionManager { get; set; }
+        private IHighPerformanceSessionManager? highPerformanceSessionManager { get; set; }
 
         public PlayerLoader(Func<Player> createPlayer)
         {

From bbdd85020cc755ee75d8227468bc27c06bb67505 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 27 Feb 2024 11:45:03 +0100
Subject: [PATCH 188/930] Fix slider tails sometimes not dimming correctly

Originally noticed during review of another change:
https://github.com/ppy/osu/pull/27369#issuecomment-1966140198.

`DrawableOsuHitObject` tries to solve the initial dimming of objects
by applying transform to a list of dimmable parts. For plain drawables
this is safe, but if one of the parts is a DHO, it is not safe,
because drawable transforms can be cleared at will.

In particular, on first use of a drawable slider,
`UpdateInitialTransforms()` would fire via `LoadComplete()` on the
`DrawableSlider`, but *then*, also via `LoadComplete()`,
the `DrawableSliderTail` would update its own state and by doing so
inadvertently clear the dim transform just added by the slider.

To fix, ensure dim transforms are applied to DHOs
via `ApplyCustomUpdateState`.
---
 .../Objects/Drawables/DrawableOsuHitObject.cs         | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index 5271c03e08..35cab6459b 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
@@ -80,6 +80,17 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             base.UpdateInitialTransforms();
 
             foreach (var piece in DimmablePieces)
+            {
+                // if the specified dimmable piece is a DHO, it is generally not safe to tack transforms onto it directly
+                // as they may be cleared via the `updateState()` DHO flow,
+                // so use `ApplyCustomUpdateState` instead. which does not have this pitfall.
+                if (piece is DrawableHitObject drawableObjectPiece)
+                    drawableObjectPiece.ApplyCustomUpdateState += (dho, _) => applyDim(dho);
+                else
+                    applyDim(piece);
+            }
+
+            void applyDim(Drawable piece)
             {
                 piece.FadeColour(new Color4(195, 195, 195, 255));
                 using (piece.BeginDelayedSequence(InitialLifetimeOffset - OsuHitWindows.MISS_WINDOW))

From 189c680555e82222bf7115305b5156cb12d3adc8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 27 Feb 2024 20:46:25 +0800
Subject: [PATCH 189/930] Add basic xmldoc on interface type

---
 .../Performance/IHighPerformanceSessionManager.cs     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Performance/IHighPerformanceSessionManager.cs b/osu.Game/Performance/IHighPerformanceSessionManager.cs
index 826a0a04f5..d3d1fda8fc 100644
--- a/osu.Game/Performance/IHighPerformanceSessionManager.cs
+++ b/osu.Game/Performance/IHighPerformanceSessionManager.cs
@@ -5,8 +5,19 @@ using System;
 
 namespace osu.Game.Performance
 {
+    /// <summary>
+    /// Allows creating a temporary "high performance" session, with the goal of optimising runtime
+    /// performance for gameplay purposes.
+    ///
+    /// On desktop platforms, this will set a low latency GC mode which collects more frequently to avoid
+    /// GC spikes.
+    /// </summary>
     public interface IHighPerformanceSessionManager
     {
+        /// <summary>
+        /// Start a new high performance session.
+        /// </summary>
+        /// <returns>An <see cref="IDisposable"/> which will end the session when disposed.</returns>
         IDisposable BeginSession();
     }
 }

From 87509fbf6efc9e14979a97fdb14b5fc6b56bdf16 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 27 Feb 2024 13:47:19 +0100
Subject: [PATCH 190/930] Privatise registry-related constants

Don't see any reason for them to be public.
---
 .../Windows/WindowsAssociationManager.cs      | 32 +++++++++----------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 2a1aeba7e0..c784d52a4f 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -15,27 +15,27 @@ namespace osu.Desktop.Windows
     [SupportedOSPlatform("windows")]
     public static class WindowsAssociationManager
     {
-        public const string SOFTWARE_CLASSES = @"Software\Classes";
+        private const string software_classes = @"Software\Classes";
 
         /// <summary>
         /// Sub key for setting the icon.
         /// https://learn.microsoft.com/en-us/windows/win32/com/defaulticon
         /// </summary>
-        public const string DEFAULT_ICON = @"DefaultIcon";
+        private const string default_icon = @"DefaultIcon";
 
         /// <summary>
         /// Sub key for setting the command line that the shell invokes.
         /// https://learn.microsoft.com/en-us/windows/win32/com/shell
         /// </summary>
-        public const string SHELL_OPEN_COMMAND = @"Shell\Open\Command";
+        internal const string SHELL_OPEN_COMMAND = @"Shell\Open\Command";
 
-        public static readonly string EXE_PATH = Path.ChangeExtension(typeof(WindowsAssociationManager).Assembly.Location, ".exe").Replace('/', '\\');
+        private static readonly string exe_path = Path.ChangeExtension(typeof(WindowsAssociationManager).Assembly.Location, ".exe").Replace('/', '\\');
 
         /// <summary>
         /// Program ID prefix used for file associations. Should be relatively short since the full program ID has a 39 character limit,
         /// see https://learn.microsoft.com/en-us/windows/win32/com/-progid--key.
         /// </summary>
-        public const string PROGRAM_ID_PREFIX = "osu.File";
+        private const string program_id_prefix = "osu.File";
 
         private static readonly FileAssociation[] file_associations =
         {
@@ -177,24 +177,24 @@ namespace osu.Desktop.Windows
 
         private record FileAssociation(string Extension, LocalisableString Description, string IconPath)
         {
-            private string programId => $@"{PROGRAM_ID_PREFIX}{Extension}";
+            private string programId => $@"{program_id_prefix}{Extension}";
 
             /// <summary>
             /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
             /// </summary>
             public void Install()
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 if (classes == null) return;
 
                 // register a program id for the given extension
                 using (var programKey = classes.CreateSubKey(programId))
                 {
-                    using (var defaultIconKey = programKey.CreateSubKey(DEFAULT_ICON))
+                    using (var defaultIconKey = programKey.CreateSubKey(default_icon))
                         defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = programKey.CreateSubKey(SHELL_OPEN_COMMAND))
-                        openCommandKey.SetValue(null, $@"""{EXE_PATH}"" ""%1""");
+                        openCommandKey.SetValue(null, $@"""{exe_path}"" ""%1""");
                 }
 
                 using (var extensionKey = classes.CreateSubKey(Extension))
@@ -211,7 +211,7 @@ namespace osu.Desktop.Windows
 
             public void UpdateDescription(string description)
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 if (classes == null) return;
 
                 using (var programKey = classes.OpenSubKey(programId, true))
@@ -223,7 +223,7 @@ namespace osu.Desktop.Windows
             /// </summary>
             public void Uninstall()
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 if (classes == null) return;
 
                 using (var extensionKey = classes.OpenSubKey(Extension, true))
@@ -254,24 +254,24 @@ namespace osu.Desktop.Windows
             /// </summary>
             public void Install()
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 if (classes == null) return;
 
                 using (var protocolKey = classes.CreateSubKey(Protocol))
                 {
                     protocolKey.SetValue(URL_PROTOCOL, string.Empty);
 
-                    using (var defaultIconKey = protocolKey.CreateSubKey(DEFAULT_ICON))
+                    using (var defaultIconKey = protocolKey.CreateSubKey(default_icon))
                         defaultIconKey.SetValue(null, IconPath);
 
                     using (var openCommandKey = protocolKey.CreateSubKey(SHELL_OPEN_COMMAND))
-                        openCommandKey.SetValue(null, $@"""{EXE_PATH}"" ""%1""");
+                        openCommandKey.SetValue(null, $@"""{exe_path}"" ""%1""");
                 }
             }
 
             public void UpdateDescription(string description)
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 if (classes == null) return;
 
                 using (var protocolKey = classes.OpenSubKey(Protocol, true))
@@ -280,7 +280,7 @@ namespace osu.Desktop.Windows
 
             public void Uninstall()
             {
-                using var classes = Registry.CurrentUser.OpenSubKey(SOFTWARE_CLASSES, true);
+                using var classes = Registry.CurrentUser.OpenSubKey(software_classes, true);
                 classes?.DeleteSubKeyTree(Protocol, throwOnMissingSubKey: false);
             }
         }

From 09dee50372f85c38a9432edd76ef3e4f7c5ad1fa Mon Sep 17 00:00:00 2001
From: Gabriel Del Nero <43073074+Gabixel@users.noreply.github.com>
Date: Tue, 27 Feb 2024 15:35:51 +0100
Subject: [PATCH 191/930] Change initial scroll animation to mod columns

Starting from the end (which should be fine with the current number of columns, even on different/wider screen resolutions), and with a custom decay value when it reaches zero offset.
---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ce1d0d27a3..a5fc75aea3 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -341,12 +341,12 @@ namespace osu.Game.Overlays.Mods
                     column.SearchTerm = query.NewValue;
             }, true);
 
-            // Start scrolled slightly to the right to give the user a sense that
+            // Start scrolling from the end, to give the user a sense that
             // there is more horizontal content available.
             ScheduleAfterChildren(() =>
             {
-                columnScroll.ScrollTo(200, false);
-                columnScroll.ScrollToStart();
+                columnScroll.ScrollToEnd(false);
+                columnScroll.ScrollTo(0, true, 0.0055);
             });
         }
 

From b3aa9e25d2f3ca99eda2f3e0ac6d7a3dedbd1f61 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 27 Feb 2024 23:18:11 +0300
Subject: [PATCH 192/930] Disable legacy slider AA for now

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
index a00014ab88..b54bb44f94 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacySliderBody.cs
@@ -26,7 +26,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             protected override Color4 ColourAt(float position)
             {
                 // https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/Graphics/Renderers/MmSliderRendererGL.cs#L99
-                const float aa_width = 3f / 256f;
+                // float aaWidth = Math.Min(Math.Max(0.5f / PathRadius, 3.0f / 256.0f), 1.0f / 16.0f);
+                // applying the aa_width constant from stable makes sliders blurry, especially on CS>5. set to zero for now.
+                // this might be related to SmoothPath applying AA internally, but disabling that does not seem to have much of an effect.
+                const float aa_width = 0f;
 
                 Color4 shadow = new Color4(0, 0, 0, 0.25f);
                 Color4 outerColour = AccentColour.Darken(0.1f);

From e053c08f6b137dcf5b62850ad5c17052780c4f71 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 27 Feb 2024 16:23:36 -0500
Subject: [PATCH 193/930] Hide social interactions while in Do Not Disturb

---
 osu.Desktop/DiscordRichPresence.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 1944a73c0a..e118b3d6c0 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -95,8 +95,10 @@ namespace osu.Desktop
             if (activity.Value != null)
             {
                 bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited;
+                bool hideInteractions = status.Value == UserStatus.DoNotDisturb && activity.Value is UserActivity.InLobby;
+
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
-                presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation) ?? string.Empty);
+                presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation || hideInteractions) ?? string.Empty);
 
                 if (getBeatmapID(activity.Value) is int beatmapId && beatmapId > 0)
                 {

From d83aeb73e4186219e1143ba7a289b02efff1c59a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 28 Feb 2024 01:02:34 +0300
Subject: [PATCH 194/930] Fix menu cursor tracing rotation while override by
 gameplay cursor

---
 osu.Game/Graphics/Cursor/MenuCursorContainer.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs b/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
index 8cf47006ab..7e42d45191 100644
--- a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
@@ -220,12 +220,16 @@ namespace osu.Game.Graphics.Cursor
         {
             activeCursor.FadeTo(1, 250, Easing.OutQuint);
             activeCursor.ScaleTo(1, 400, Easing.OutQuint);
+            activeCursor.RotateTo(0, 400, Easing.OutQuint);
+            dragRotationState = DragRotationState.NotDragging;
         }
 
         protected override void PopOut()
         {
             activeCursor.FadeTo(0, 250, Easing.OutQuint);
             activeCursor.ScaleTo(0.6f, 250, Easing.In);
+            activeCursor.RotateTo(0, 400, Easing.OutQuint);
+            dragRotationState = DragRotationState.NotDragging;
         }
 
         private void playTapSample(double baseFrequency = 1f)

From c69c881cd373175859d97ce5a536a8827e6a0ddb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 28 Feb 2024 07:58:02 +0300
Subject: [PATCH 195/930] Combine conditionals and remove "InLobby" check

---
 osu.Desktop/DiscordRichPresence.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index e118b3d6c0..f0da708766 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -94,11 +94,10 @@ namespace osu.Desktop
 
             if (activity.Value != null)
             {
-                bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited;
-                bool hideInteractions = status.Value == UserStatus.DoNotDisturb && activity.Value is UserActivity.InLobby;
+                bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
 
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
-                presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation || hideInteractions) ?? string.Empty);
+                presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation) ?? string.Empty);
 
                 if (getBeatmapID(activity.Value) is int beatmapId && beatmapId > 0)
                 {

From 351160f94e34712103cc7d16d2ee21ee007660a6 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 27 Feb 2024 22:41:49 -0800
Subject: [PATCH 196/930] Move back/quit button from bottom left to fail
 overlay when spectating

---
 osu.Game/Screens/Play/FailOverlay.cs         | 17 +----------------
 osu.Game/Screens/Play/GameplayMenuOverlay.cs | 10 ++++++++++
 osu.Game/Screens/Play/PauseOverlay.cs        | 10 +---------
 osu.Game/Screens/Play/Player.cs              |  4 ++--
 osu.Game/Screens/Play/SpectatorPlayer.cs     |  2 --
 5 files changed, 14 insertions(+), 29 deletions(-)

diff --git a/osu.Game/Screens/Play/FailOverlay.cs b/osu.Game/Screens/Play/FailOverlay.cs
index 210ae5ceb6..f14cdfc213 100644
--- a/osu.Game/Screens/Play/FailOverlay.cs
+++ b/osu.Game/Screens/Play/FailOverlay.cs
@@ -6,10 +6,8 @@
 using System;
 using System.Threading.Tasks;
 using osu.Game.Scoring;
-using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osuTK;
-using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -26,22 +24,9 @@ namespace osu.Game.Screens.Play
 
         public override LocalisableString Header => GameplayMenuOverlayStrings.FailedHeader;
 
-        private readonly bool showButtons;
-
-        public FailOverlay(bool showButtons = true)
-        {
-            this.showButtons = showButtons;
-        }
-
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
-            if (showButtons)
-            {
-                AddButton(GameplayMenuOverlayStrings.Retry, colours.YellowDark, () => OnRetry?.Invoke());
-                AddButton(GameplayMenuOverlayStrings.Quit, new Color4(170, 27, 39, 255), () => OnQuit?.Invoke());
-            }
-
             // from #10339 maybe this is a better visual effect
             Add(new Container
             {
diff --git a/osu.Game/Screens/Play/GameplayMenuOverlay.cs b/osu.Game/Screens/Play/GameplayMenuOverlay.cs
index 440b8d37b9..be4b8ff9fe 100644
--- a/osu.Game/Screens/Play/GameplayMenuOverlay.cs
+++ b/osu.Game/Screens/Play/GameplayMenuOverlay.cs
@@ -38,6 +38,7 @@ namespace osu.Game.Screens.Play
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
+        public Action? OnResume;
         public Action? OnRetry;
         public Action? OnQuit;
 
@@ -129,6 +130,15 @@ namespace osu.Game.Screens.Play
                 },
             };
 
+            if (OnResume != null)
+                AddButton(GameplayMenuOverlayStrings.Continue, colours.Green, () => OnResume.Invoke());
+
+            if (OnRetry != null)
+                AddButton(GameplayMenuOverlayStrings.Retry, colours.YellowDark, () => OnRetry.Invoke());
+
+            if (OnQuit != null)
+                AddButton(GameplayMenuOverlayStrings.Quit, new Color4(170, 27, 39, 255), () => OnQuit.Invoke());
+
             State.ValueChanged += _ => InternalButtons.Deselect();
 
             updateInfoText();
diff --git a/osu.Game/Screens/Play/PauseOverlay.cs b/osu.Game/Screens/Play/PauseOverlay.cs
index 2aa2793fd4..c8e8275641 100644
--- a/osu.Game/Screens/Play/PauseOverlay.cs
+++ b/osu.Game/Screens/Play/PauseOverlay.cs
@@ -11,18 +11,14 @@ using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Audio;
-using osu.Game.Graphics;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Skinning;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play
 {
     public partial class PauseOverlay : GameplayMenuOverlay
     {
-        public Action OnResume;
-
         public override bool IsPresent => base.IsPresent || pauseLoop.IsPlaying;
 
         public override LocalisableString Header => GameplayMenuOverlayStrings.PausedHeader;
@@ -38,12 +34,8 @@ namespace osu.Game.Screens.Play
         };
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load()
         {
-            AddButton(GameplayMenuOverlayStrings.Continue, colours.Green, () => OnResume?.Invoke());
-            AddButton(GameplayMenuOverlayStrings.Retry, colours.YellowDark, () => OnRetry?.Invoke());
-            AddButton(GameplayMenuOverlayStrings.Quit, new Color4(170, 27, 39, 255), () => OnQuit?.Invoke());
-
             AddInternal(pauseLoop = new SkinnableSound(new SampleInfo("Gameplay/pause-loop"))
             {
                 Looping = true,
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 11ff5fdbef..88f6ae9e71 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -278,10 +278,10 @@ namespace osu.Game.Screens.Play
                         createGameplayComponents(Beatmap.Value)
                     }
                 },
-                FailOverlay = new FailOverlay(Configuration.AllowUserInteraction)
+                FailOverlay = new FailOverlay
                 {
                     SaveReplay = async () => await prepareAndImportScoreAsync(true).ConfigureAwait(false),
-                    OnRetry = () => Restart(),
+                    OnRetry = Configuration.AllowUserInteraction ? () => Restart() : null,
                     OnQuit = () => PerformExit(true),
                 },
                 new HotkeyExitOverlay
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index 2faead0ee1..d1404ac184 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -25,8 +25,6 @@ namespace osu.Game.Screens.Play
 
         private readonly Score score;
 
-        public override bool AllowBackButton => true;
-
         protected override bool CheckModsAllowFailure()
         {
             if (!allowFail)

From dee57c7e72275fb87fabacbbc802775418e95185 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 27 Feb 2024 22:42:36 -0800
Subject: [PATCH 197/930] Refactor test to only allow init of actions

---
 .../Gameplay/TestSceneGameplayMenuOverlay.cs  | 43 ++++++-------------
 osu.Game/Screens/Play/GameplayMenuOverlay.cs  |  6 +--
 2 files changed, 16 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
index aa5e5985c3..73028e6df9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
@@ -3,7 +3,6 @@
 
 #nullable disable
 
-using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -26,6 +25,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private GlobalActionContainer globalActionContainer;
 
+        private bool triggeredRetryButton;
+
         [BackgroundDependencyLoader]
         private void load(OsuGameBase game)
         {
@@ -35,12 +36,18 @@ namespace osu.Game.Tests.Visual.Gameplay
         [SetUp]
         public void SetUp() => Schedule(() =>
         {
+            triggeredRetryButton = false;
+
             globalActionContainer.Children = new Drawable[]
             {
                 pauseOverlay = new PauseOverlay
                 {
                     OnResume = () => Logger.Log(@"Resume"),
-                    OnRetry = () => Logger.Log(@"Retry"),
+                    OnRetry = () =>
+                    {
+                        Logger.Log(@"Retry");
+                        triggeredRetryButton = true;
+                    },
                     OnQuit = () => Logger.Log(@"Quit"),
                 },
                 failOverlay = new FailOverlay
@@ -224,17 +231,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             showOverlay();
 
-            bool triggered = false;
-            AddStep("Click retry button", () =>
-            {
-                var lastAction = pauseOverlay.OnRetry;
-                pauseOverlay.OnRetry = () => triggered = true;
+            AddStep("Click retry button", () => getButton(1).TriggerClick());
 
-                getButton(1).TriggerClick();
-                pauseOverlay.OnRetry = lastAction;
-            });
-
-            AddAssert("Action was triggered", () => triggered);
+            AddAssert("Retry was triggered", () => triggeredRetryButton);
             AddAssert("Overlay is closed", () => pauseOverlay.State.Value == Visibility.Hidden);
         }
 
@@ -252,25 +251,9 @@ namespace osu.Game.Tests.Visual.Gameplay
                 InputManager.Key(Key.Down);
             });
 
-            bool triggered = false;
-            Action lastAction = null;
-            AddStep("Press enter", () =>
-            {
-                lastAction = pauseOverlay.OnRetry;
-                pauseOverlay.OnRetry = () => triggered = true;
-                InputManager.Key(Key.Enter);
-            });
+            AddStep("Press enter", () => InputManager.Key(Key.Enter));
 
-            AddAssert("Action was triggered", () =>
-            {
-                if (lastAction != null)
-                {
-                    pauseOverlay.OnRetry = lastAction;
-                    lastAction = null;
-                }
-
-                return triggered;
-            });
+            AddAssert("Retry was triggered", () => triggeredRetryButton);
             AddAssert("Overlay is closed", () => pauseOverlay.State.Value == Visibility.Hidden);
         }
 
diff --git a/osu.Game/Screens/Play/GameplayMenuOverlay.cs b/osu.Game/Screens/Play/GameplayMenuOverlay.cs
index be4b8ff9fe..da239d585e 100644
--- a/osu.Game/Screens/Play/GameplayMenuOverlay.cs
+++ b/osu.Game/Screens/Play/GameplayMenuOverlay.cs
@@ -38,9 +38,9 @@ namespace osu.Game.Screens.Play
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true;
 
-        public Action? OnResume;
-        public Action? OnRetry;
-        public Action? OnQuit;
+        public Action? OnResume { get; init; }
+        public Action? OnRetry { get; init; }
+        public Action? OnQuit { get; init; }
 
         /// <summary>
         /// Action that is invoked when <see cref="GlobalAction.Back"/> is triggered.

From e8a106177771cc23112f8f42e6cc9adb725736cc Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 27 Feb 2024 23:16:20 -0800
Subject: [PATCH 198/930] Add test for spectator player exit

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index 1c7ede2b19..caf3a05518 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -25,6 +25,7 @@ using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -214,6 +215,9 @@ namespace osu.Game.Tests.Visual.Gameplay
             checkPaused(false); // Should continue playing until out of frames
             checkPaused(true); // And eventually stop after running out of frames and fail.
             // Todo: Should check for + display a failed message.
+
+            AddStep("exit player", () => InputManager.Key(Key.Escape));
+            AddAssert("player exited", () => Stack.CurrentScreen is SoloSpectatorScreen);
         }
 
         [Test]

From 8e462fbb38e4ffb41f3cf7cf9e7775978d03464b Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 27 Feb 2024 23:24:04 -0800
Subject: [PATCH 199/930] Apply NRT to touched files

---
 .../Gameplay/TestSceneGameplayMenuOverlay.cs  |  8 +++-----
 .../Visual/Gameplay/TestSceneSpectator.cs     | 20 +++++++++----------
 osu.Game/Screens/Play/FailOverlay.cs          |  4 +---
 osu.Game/Screens/Play/PauseOverlay.cs         |  4 +---
 .../Screens/Play/SaveFailedScoreButton.cs     | 17 ++++++++++------
 osu.Game/Screens/Play/SoloSpectatorPlayer.cs  |  3 +--
 osu.Game/Screens/Play/SpectatorPlayer.cs      | 11 ++++------
 7 files changed, 30 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
index 73028e6df9..3501c1a521 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplayMenuOverlay.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -20,10 +18,10 @@ namespace osu.Game.Tests.Visual.Gameplay
     [Description("player pause/fail screens")]
     public partial class TestSceneGameplayMenuOverlay : OsuManualInputManagerTestScene
     {
-        private FailOverlay failOverlay;
-        private PauseOverlay pauseOverlay;
+        private FailOverlay failOverlay = null!;
+        private PauseOverlay pauseOverlay = null!;
 
-        private GlobalActionContainer globalActionContainer;
+        private GlobalActionContainer globalActionContainer = null!;
 
         private bool triggeredRetryButton;
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index caf3a05518..c8356cd191 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -40,13 +38,13 @@ namespace osu.Game.Tests.Visual.Gameplay
         protected override bool UseOnlineAPI => true;
 
         [Resolved]
-        private OsuGameBase game { get; set; }
+        private OsuGameBase game { get; set; } = null!;
 
         private TestSpectatorClient spectatorClient => dependenciesScreen.SpectatorClient;
-        private DependenciesScreen dependenciesScreen;
-        private SoloSpectatorScreen spectatorScreen;
+        private DependenciesScreen dependenciesScreen = null!;
+        private SoloSpectatorScreen spectatorScreen = null!;
 
-        private BeatmapSetInfo importedBeatmap;
+        private BeatmapSetInfo importedBeatmap = null!;
         private int importedBeatmapId;
 
         [SetUpSteps]
@@ -189,7 +187,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             waitForPlayerCurrent();
 
-            Player lastPlayer = null;
+            Player lastPlayer = null!;
             AddStep("store first player", () => lastPlayer = player);
 
             start();
@@ -282,7 +280,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         [Test]
         public void TestFinalFrameInBundleHasHeader()
         {
-            FrameDataBundle lastBundle = null;
+            FrameDataBundle? lastBundle = null;
 
             AddStep("bind to client", () => spectatorClient.OnNewFrames += (_, bundle) => lastBundle = bundle);
 
@@ -291,8 +289,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             finish();
 
             AddUntilStep("bundle received", () => lastBundle != null);
-            AddAssert("first frame does not have header", () => lastBundle.Frames[0].Header == null);
-            AddAssert("last frame has header", () => lastBundle.Frames[^1].Header != null);
+            AddAssert("first frame does not have header", () => lastBundle?.Frames[0].Header == null);
+            AddAssert("last frame has header", () => lastBundle?.Frames[^1].Header != null);
         }
 
         [Test]
@@ -387,7 +385,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         private OsuFramedReplayInputHandler replayHandler =>
-            (OsuFramedReplayInputHandler)Stack.ChildrenOfType<OsuInputManager>().First().ReplayInputHandler;
+            (OsuFramedReplayInputHandler)Stack.ChildrenOfType<OsuInputManager>().First().ReplayInputHandler!;
 
         private Player player => this.ChildrenOfType<Player>().Single();
 
diff --git a/osu.Game/Screens/Play/FailOverlay.cs b/osu.Game/Screens/Play/FailOverlay.cs
index f14cdfc213..4a0a6f573c 100644
--- a/osu.Game/Screens/Play/FailOverlay.cs
+++ b/osu.Game/Screens/Play/FailOverlay.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Threading.Tasks;
 using osu.Game.Scoring;
@@ -20,7 +18,7 @@ namespace osu.Game.Screens.Play
 {
     public partial class FailOverlay : GameplayMenuOverlay
     {
-        public Func<Task<ScoreInfo>> SaveReplay;
+        public Func<Task<ScoreInfo>>? SaveReplay;
 
         public override LocalisableString Header => GameplayMenuOverlayStrings.FailedHeader;
 
diff --git a/osu.Game/Screens/Play/PauseOverlay.cs b/osu.Game/Screens/Play/PauseOverlay.cs
index c8e8275641..3a471acba4 100644
--- a/osu.Game/Screens/Play/PauseOverlay.cs
+++ b/osu.Game/Screens/Play/PauseOverlay.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Linq;
 using osu.Framework.Allocation;
@@ -23,7 +21,7 @@ namespace osu.Game.Screens.Play
 
         public override LocalisableString Header => GameplayMenuOverlayStrings.PausedHeader;
 
-        private SkinnableSound pauseLoop;
+        private SkinnableSound pauseLoop = null!;
 
         protected override Action BackAction => () =>
         {
diff --git a/osu.Game/Screens/Play/SaveFailedScoreButton.cs b/osu.Game/Screens/Play/SaveFailedScoreButton.cs
index b97c140250..ef27aac1b9 100644
--- a/osu.Game/Screens/Play/SaveFailedScoreButton.cs
+++ b/osu.Game/Screens/Play/SaveFailedScoreButton.cs
@@ -30,13 +30,13 @@ namespace osu.Game.Screens.Play
 
         private readonly Bindable<DownloadState> state = new Bindable<DownloadState>();
 
-        private readonly Func<Task<ScoreInfo>> importFailedScore;
+        private readonly Func<Task<ScoreInfo>>? importFailedScore;
 
         private ScoreInfo? importedScore;
 
         private DownloadButton button = null!;
 
-        public SaveFailedScoreButton(Func<Task<ScoreInfo>> importFailedScore)
+        public SaveFailedScoreButton(Func<Task<ScoreInfo>>? importFailedScore)
         {
             Size = new Vector2(50, 30);
 
@@ -60,11 +60,16 @@ namespace osu.Game.Screens.Play
 
                         case DownloadState.NotDownloaded:
                             state.Value = DownloadState.Importing;
-                            Task.Run(importFailedScore).ContinueWith(t =>
+
+                            if (importFailedScore != null)
                             {
-                                importedScore = realm.Run(r => r.Find<ScoreInfo>(t.GetResultSafely().ID)?.Detach());
-                                Schedule(() => state.Value = importedScore != null ? DownloadState.LocallyAvailable : DownloadState.NotDownloaded);
-                            }).FireAndForget();
+                                Task.Run(importFailedScore).ContinueWith(t =>
+                                {
+                                    importedScore = realm.Run(r => r.Find<ScoreInfo>(t.GetResultSafely().ID)?.Detach());
+                                    Schedule(() => state.Value = importedScore != null ? DownloadState.LocallyAvailable : DownloadState.NotDownloaded);
+                                }).FireAndForget();
+                            }
+
                             break;
                     }
                 }
diff --git a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
index 8d25a0148d..3dafd5f752 100644
--- a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
@@ -50,8 +50,7 @@ namespace osu.Game.Screens.Play
         {
             base.Dispose(isDisposing);
 
-            if (SpectatorClient != null)
-                SpectatorClient.OnUserBeganPlaying -= userBeganPlaying;
+            SpectatorClient.OnUserBeganPlaying -= userBeganPlaying;
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index d1404ac184..520fb43445 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -21,7 +19,7 @@ namespace osu.Game.Screens.Play
     public abstract partial class SpectatorPlayer : Player
     {
         [Resolved]
-        protected SpectatorClient SpectatorClient { get; private set; }
+        protected SpectatorClient SpectatorClient { get; private set; } = null!;
 
         private readonly Score score;
 
@@ -35,7 +33,7 @@ namespace osu.Game.Screens.Play
 
         private bool allowFail;
 
-        protected SpectatorPlayer(Score score, PlayerConfiguration configuration = null)
+        protected SpectatorPlayer(Score score, PlayerConfiguration? configuration = null)
             : base(configuration)
         {
             this.score = score;
@@ -98,7 +96,7 @@ namespace osu.Game.Screens.Play
 
             foreach (var frame in bundle.Frames)
             {
-                IConvertibleReplayFrame convertibleFrame = GameplayState.Ruleset.CreateConvertibleReplayFrame();
+                IConvertibleReplayFrame convertibleFrame = GameplayState.Ruleset.CreateConvertibleReplayFrame()!;
                 Debug.Assert(convertibleFrame != null);
                 convertibleFrame.FromLegacy(frame, GameplayState.Beatmap);
 
@@ -134,8 +132,7 @@ namespace osu.Game.Screens.Play
         {
             base.Dispose(isDisposing);
 
-            if (SpectatorClient != null)
-                SpectatorClient.OnNewFrames -= userSentFrames;
+            SpectatorClient.OnNewFrames -= userSentFrames;
         }
     }
 }

From 6e03384c6bffba55b403c20cb566bf88c7252b12 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 28 Feb 2024 00:01:16 -0800
Subject: [PATCH 200/930] Apply NRT to `SoloSpectatorPlayer`

---
 osu.Game/Screens/Play/SoloSpectatorPlayer.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
index 3dafd5f752..2cc1c4a368 100644
--- a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Screens;
 using osu.Game.Online.Spectator;

From 3fb2662d74a16bf7258d0b38777e599558d214a1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 28 Feb 2024 12:05:33 +0100
Subject: [PATCH 201/930] Update framework

Mainly for the sake of https://github.com/ppy/osu-framework/pull/6196.
---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 30037c868c..1b395a7c83 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.221.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.223.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 0782922f5a..6854b820ee 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.221.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.223.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.207.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 463a726856..747d6059da 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.221.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.223.0" />
   </ItemGroup>
 </Project>

From b5ce2642aacc33cd47879d72a18e51714936e11b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 28 Feb 2024 13:20:41 +0100
Subject: [PATCH 202/930] Fix subscribing to `ApplyCustomUpdateState` too much

---
 .../Objects/Drawables/DrawableOsuHitObject.cs            | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
index 35cab6459b..5f5deca1ba 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableOsuHitObject.cs
@@ -85,7 +85,12 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 // as they may be cleared via the `updateState()` DHO flow,
                 // so use `ApplyCustomUpdateState` instead. which does not have this pitfall.
                 if (piece is DrawableHitObject drawableObjectPiece)
-                    drawableObjectPiece.ApplyCustomUpdateState += (dho, _) => applyDim(dho);
+                {
+                    // this method can be called multiple times, and we don't want to subscribe to the event more than once,
+                    // so this is what it is going to have to be...
+                    drawableObjectPiece.ApplyCustomUpdateState -= applyDimToDrawableHitObject;
+                    drawableObjectPiece.ApplyCustomUpdateState += applyDimToDrawableHitObject;
+                }
                 else
                     applyDim(piece);
             }
@@ -96,6 +101,8 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 using (piece.BeginDelayedSequence(InitialLifetimeOffset - OsuHitWindows.MISS_WINDOW))
                     piece.FadeColour(Color4.White, 100);
             }
+
+            void applyDimToDrawableHitObject(DrawableHitObject dho, ArmedState _) => applyDim(dho);
         }
 
         protected sealed override double InitialLifetimeOffset => HitObject.TimePreempt;

From ce994a7a733eacd1bd5b1c30aacda217b071e8b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 28 Feb 2024 13:31:06 +0100
Subject: [PATCH 203/930] Fix wireframe misalignment in argon accuracy counter

- Closes https://github.com/ppy/osu/issues/27385.
- Supersedes / closes https://github.com/ppy/osu/pull/27392.
---
 osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs |  6 +++---
 osu.Game/Screens/Play/HUD/ArgonComboCounter.cs    |  5 ++++-
 .../Screens/Play/HUD/ArgonCounterTextComponent.cs | 15 ++++++++++++---
 osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs    |  6 ++++--
 4 files changed, 23 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs b/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
index ca00ab12c7..4cc04e1485 100644
--- a/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
@@ -75,21 +75,21 @@ namespace osu.Game.Screens.Play.HUD
                             AutoSizeAxes = Axes.Both,
                             Child = wholePart = new ArgonCounterTextComponent(Anchor.TopRight, BeatmapsetsStrings.ShowScoreboardHeadersAccuracy.ToUpper())
                             {
-                                RequiredDisplayDigits = { Value = 3 },
                                 WireframeOpacity = { BindTarget = WireframeOpacity },
+                                WireframeTemplate = @"###",
                                 ShowLabel = { BindTarget = ShowLabel },
                             }
                         },
                         fractionPart = new ArgonCounterTextComponent(Anchor.TopLeft)
                         {
-                            RequiredDisplayDigits = { Value = 2 },
                             WireframeOpacity = { BindTarget = WireframeOpacity },
+                            WireframeTemplate = @".##",
                             Scale = new Vector2(0.5f),
                         },
                         percentText = new ArgonCounterTextComponent(Anchor.TopLeft)
                         {
                             Text = @"%",
-                            RequiredDisplayDigits = { Value = 1 },
+                            WireframeTemplate = @"#",
                             WireframeOpacity = { BindTarget = WireframeOpacity }
                         },
                     }
diff --git a/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs b/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
index 369c753cb0..3f187650b2 100644
--- a/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
@@ -68,7 +68,10 @@ namespace osu.Game.Screens.Play.HUD
 
         private void updateWireframe()
         {
-            text.RequiredDisplayDigits.Value = getDigitsRequiredForDisplayCount();
+            int digitsRequiredForDisplayCount = getDigitsRequiredForDisplayCount();
+
+            if (digitsRequiredForDisplayCount != text.WireframeTemplate.Length)
+                text.WireframeTemplate = new string('#', digitsRequiredForDisplayCount);
         }
 
         private int getDigitsRequiredForDisplayCount()
diff --git a/osu.Game/Screens/Play/HUD/ArgonCounterTextComponent.cs b/osu.Game/Screens/Play/HUD/ArgonCounterTextComponent.cs
index f8c82feddd..efb4d2108e 100644
--- a/osu.Game/Screens/Play/HUD/ArgonCounterTextComponent.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonCounterTextComponent.cs
@@ -25,7 +25,6 @@ namespace osu.Game.Screens.Play.HUD
         private readonly OsuSpriteText labelText;
 
         public IBindable<float> WireframeOpacity { get; } = new BindableFloat();
-        public Bindable<int> RequiredDisplayDigits { get; } = new BindableInt();
         public Bindable<bool> ShowLabel { get; } = new BindableBool();
 
         public Container NumberContainer { get; private set; }
@@ -36,6 +35,18 @@ namespace osu.Game.Screens.Play.HUD
             set => textPart.Text = value;
         }
 
+        /// <summary>
+        /// The template for the wireframe displayed behind the <see cref="Text"/>.
+        /// Any character other than a dot is interpreted to mean a full segmented display "wireframe".
+        /// </summary>
+        public string WireframeTemplate
+        {
+            get => wireframeTemplate;
+            set => wireframesPart.Text = wireframeTemplate = value;
+        }
+
+        private string wireframeTemplate = string.Empty;
+
         public ArgonCounterTextComponent(Anchor anchor, LocalisableString? label = null)
         {
             Anchor = anchor;
@@ -69,8 +80,6 @@ namespace osu.Game.Screens.Play.HUD
                     }
                 }
             };
-
-            RequiredDisplayDigits.BindValueChanged(digits => wireframesPart.Text = new string('#', digits.NewValue));
         }
 
         private string textLookup(char c)
diff --git a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
index 44b9fb3123..7e0dd161dc 100644
--- a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
@@ -58,8 +58,10 @@ namespace osu.Game.Screens.Play.HUD
 
         private void updateWireframe()
         {
-            scoreText.RequiredDisplayDigits.Value =
-                Math.Max(RequiredDisplayDigits.Value, getDigitsRequiredForDisplayCount());
+            int digitsRequiredForDisplayCount = Math.Max(RequiredDisplayDigits.Value, getDigitsRequiredForDisplayCount());
+
+            if (digitsRequiredForDisplayCount != scoreText.WireframeTemplate.Length)
+                scoreText.WireframeTemplate = new string('#', Math.Max(RequiredDisplayDigits.Value, digitsRequiredForDisplayCount));
         }
 
         private int getDigitsRequiredForDisplayCount()

From f49aa4d8157eb6368263f919c662dd0afdaca1d0 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 28 Feb 2024 22:01:39 +0800
Subject: [PATCH 204/930] Parse points and segments for path string

---
 .../Objects/Legacy/ConvertHitObjectParser.cs  | 57 ++++++++++++-------
 1 file changed, 38 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index f9e32fe26f..30e4101a84 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -266,30 +266,49 @@ namespace osu.Game.Rulesets.Objects.Legacy
             // This code takes on the responsibility of handling explicit segments of the path ("X" & "Y" from above). Implicit segments are handled by calls to convertPoints().
             string[] pointSplit = pointString.Split('|');
 
-            var controlPoints = new List<Memory<PathControlPoint>>();
-            int startIndex = 0;
-            int endIndex = 0;
-            bool first = true;
+            Span<Vector2> points = stackalloc Vector2[pointSplit.Length];
+            Span<(PathType Type, int StartIndex)> segments = stackalloc (PathType Type, int StartIndex)[pointSplit.Length];
+            int pointsCount = 0;
+            int segmentsCount = 0;
 
-            while (++endIndex < pointSplit.Length)
+            foreach (string s in pointSplit)
             {
-                // Keep incrementing endIndex while it's not the start of a new segment (indicated by having an alpha character at position 0).
-                if (!char.IsLetter(pointSplit[endIndex][0]))
-                    continue;
-
-                // Multi-segmented sliders DON'T contain the end point as part of the current segment as it's assumed to be the start of the next segment.
-                // The start of the next segment is the index after the type descriptor.
-                string endPoint = endIndex < pointSplit.Length - 1 ? pointSplit[endIndex + 1] : null;
-
-                controlPoints.AddRange(convertPoints(pointSplit.AsMemory().Slice(startIndex, endIndex - startIndex), endPoint, first, offset));
-                startIndex = endIndex;
-                first = false;
+                if (char.IsLetter(s[0]))
+                {
+                    // The start of a new segment(indicated by having an alpha character at position 0).
+                    var pathType = convertPathType(s);
+                    segments[segmentsCount++] = (pathType, pointsCount);
+                }
+                else
+                {
+                    points[pointsCount++] = readPoint(s, offset);
+                }
             }
 
-            if (endIndex > startIndex)
-                controlPoints.AddRange(convertPoints(pointSplit.AsMemory().Slice(startIndex, endIndex - startIndex), null, first, offset));
+            var controlPoints = new List<PathControlPoint>(pointsCount);
 
-            return mergePointsLists(controlPoints);
+            for (int i = 0; i < segmentsCount; i++)
+            {
+                int startIndex = segments[i].StartIndex;
+                int endIndex = i < segmentsCount - 1 ? segments[i + 1].StartIndex : pointsCount;
+                Vector2? endPoint = i < segmentsCount - 1 ? points[endIndex] : null;
+                controlPoints.AddRange(convertPoints(segments[i].Type, points[startIndex..endIndex], endPoint));
+            }
+
+            return controlPoints.ToArray();
+
+            static Vector2 readPoint(string value, Vector2 startPos)
+            {
+                string[] vertexSplit = value.Split(':');
+
+                Vector2 pos = new Vector2((int)Parsing.ParseDouble(vertexSplit[0], Parsing.MAX_COORDINATE_VALUE), (int)Parsing.ParseDouble(vertexSplit[1], Parsing.MAX_COORDINATE_VALUE)) - startPos;
+                return pos;
+            }
+        }
+
+        private IEnumerable<PathControlPoint> convertPoints(PathType type, ReadOnlySpan<Vector2> points, Vector2? endPoint)
+        {
+            throw new NotImplementedException();
         }
 
         /// <summary>

From 4bff54d35dbd60aab7cd8a255977fe95e5c3bde7 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 28 Feb 2024 22:37:14 +0800
Subject: [PATCH 205/930] Add ToString on PathControlPoint for debugging

---
 osu.Game/Rulesets/Objects/PathControlPoint.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Rulesets/Objects/PathControlPoint.cs b/osu.Game/Rulesets/Objects/PathControlPoint.cs
index ae9fa08085..1f8e63b269 100644
--- a/osu.Game/Rulesets/Objects/PathControlPoint.cs
+++ b/osu.Game/Rulesets/Objects/PathControlPoint.cs
@@ -76,5 +76,9 @@ namespace osu.Game.Rulesets.Objects
         }
 
         public bool Equals(PathControlPoint other) => Position == other?.Position && Type == other.Type;
+
+        public override string ToString() => type is null
+            ? $"Position={Position}"
+            : $"Position={Position}, Type={type}";
     }
 }

From fe34577ee2938c45d295800405a309ad3d55ac3e Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 28 Feb 2024 22:42:08 +0800
Subject: [PATCH 206/930] Update parsing.

---
 .../Objects/Legacy/ConvertHitObjectParser.cs  | 86 ++++++-------------
 1 file changed, 24 insertions(+), 62 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 30e4101a84..2d4d2865e6 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -278,6 +278,10 @@ namespace osu.Game.Rulesets.Objects.Legacy
                     // The start of a new segment(indicated by having an alpha character at position 0).
                     var pathType = convertPathType(s);
                     segments[segmentsCount++] = (pathType, pointsCount);
+
+                    // First segment is prepended by an extra zero point
+                    if (pointsCount == 0)
+                        points[pointsCount++] = Vector2.Zero;
                 }
                 else
                 {
@@ -306,47 +310,30 @@ namespace osu.Game.Rulesets.Objects.Legacy
             }
         }
 
-        private IEnumerable<PathControlPoint> convertPoints(PathType type, ReadOnlySpan<Vector2> points, Vector2? endPoint)
-        {
-            throw new NotImplementedException();
-        }
-
         /// <summary>
         /// Converts a given point list into a set of path segments.
         /// </summary>
+        /// <param name="type">The path type of the point list.</param>
         /// <param name="points">The point list.</param>
         /// <param name="endPoint">Any extra endpoint to consider as part of the points. This will NOT be returned.</param>
-        /// <param name="first">Whether this is the first segment in the set. If <c>true</c> the first of the returned segments will contain a zero point.</param>
-        /// <param name="offset">The positional offset to apply to the control points.</param>
-        /// <returns>The set of points contained by <paramref name="points"/> as one or more segments of the path, prepended by an extra zero point if <paramref name="first"/> is <c>true</c>.</returns>
-        private IEnumerable<Memory<PathControlPoint>> convertPoints(ReadOnlyMemory<string> points, string endPoint, bool first, Vector2 offset)
+        /// <returns>The set of points contained by <paramref name="points"/> as one or more segments of the path.</returns>
+        private IEnumerable<PathControlPoint> convertPoints(PathType type, ReadOnlySpan<Vector2> points, Vector2? endPoint)
         {
-            PathType type = convertPathType(points.Span[0]);
-
-            int readOffset = first ? 1 : 0; // First control point is zero for the first segment.
-            int readablePoints = points.Length - 1; // Total points readable from the base point span.
-            int endPointLength = endPoint != null ? 1 : 0; // Extra length if an endpoint is given that lies outside the base point span.
-
-            var vertices = new PathControlPoint[readOffset + readablePoints + endPointLength];
-
-            // Fill any non-read points.
-            for (int i = 0; i < readOffset; i++)
-                vertices[i] = new PathControlPoint();
+            var vertices = new PathControlPoint[points.Length];
+            var result = new List<PathControlPoint>();
 
             // Parse into control points.
-            for (int i = 1; i < points.Length; i++)
-                readPoint(points.Span[i], offset, out vertices[readOffset + i - 1]);
-
-            // If an endpoint is given, add it to the end.
-            if (endPoint != null)
-                readPoint(endPoint, offset, out vertices[^1]);
+            for (int i = 0; i < points.Length; i++)
+                vertices[i] = new PathControlPoint { Position = points[i] };
 
             // Edge-case rules (to match stable).
             if (type == PathType.PERFECT_CURVE)
             {
-                if (vertices.Length != 3)
+                int endPointLength = endPoint is null ? 0 : 1;
+
+                if (vertices.Length + endPointLength != 3)
                     type = PathType.BEZIER;
-                else if (isLinear(vertices))
+                else if (isLinear(stackalloc[] { points[0], points[1], endPoint ?? points[2] }))
                 {
                     // osu-stable special-cased colinear perfect curves to a linear path
                     type = PathType.LINEAR;
@@ -365,7 +352,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             int startIndex = 0;
             int endIndex = 0;
 
-            while (++endIndex < vertices.Length - endPointLength)
+            while (++endIndex < vertices.Length)
             {
                 // Keep incrementing while an implicit segment doesn't need to be started.
                 if (vertices[endIndex].Position != vertices[endIndex - 1].Position)
@@ -378,50 +365,25 @@ namespace osu.Game.Rulesets.Objects.Legacy
                     continue;
 
                 // The last control point of each segment is not allowed to start a new implicit segment.
-                if (endIndex == vertices.Length - endPointLength - 1)
+                if (endIndex == vertices.Length - 1)
                     continue;
 
                 // Force a type on the last point, and return the current control point set as a segment.
                 vertices[endIndex - 1].Type = type;
-                yield return vertices.AsMemory().Slice(startIndex, endIndex - startIndex);
+                for (int i = startIndex; i < endIndex; i++)
+                    result.Add(vertices[i]);
 
                 // Skip the current control point - as it's the same as the one that's just been returned.
                 startIndex = endIndex + 1;
             }
 
-            if (endIndex > startIndex)
-                yield return vertices.AsMemory().Slice(startIndex, endIndex - startIndex);
+            for (int i = startIndex; i < endIndex; i++)
+                result.Add(vertices[i]);
 
-            static void readPoint(string value, Vector2 startPos, out PathControlPoint point)
-            {
-                string[] vertexSplit = value.Split(':');
+            return result;
 
-                Vector2 pos = new Vector2((int)Parsing.ParseDouble(vertexSplit[0], Parsing.MAX_COORDINATE_VALUE), (int)Parsing.ParseDouble(vertexSplit[1], Parsing.MAX_COORDINATE_VALUE)) - startPos;
-                point = new PathControlPoint { Position = pos };
-            }
-
-            static bool isLinear(PathControlPoint[] p) => Precision.AlmostEquals(0, (p[1].Position.Y - p[0].Position.Y) * (p[2].Position.X - p[0].Position.X)
-                                                                                    - (p[1].Position.X - p[0].Position.X) * (p[2].Position.Y - p[0].Position.Y));
-        }
-
-        private PathControlPoint[] mergePointsLists(List<Memory<PathControlPoint>> controlPointList)
-        {
-            int totalCount = 0;
-
-            foreach (var arr in controlPointList)
-                totalCount += arr.Length;
-
-            var mergedArray = new PathControlPoint[totalCount];
-            var mergedArrayMemory = mergedArray.AsMemory();
-            int copyIndex = 0;
-
-            foreach (var arr in controlPointList)
-            {
-                arr.CopyTo(mergedArrayMemory.Slice(copyIndex));
-                copyIndex += arr.Length;
-            }
-
-            return mergedArray;
+            static bool isLinear(ReadOnlySpan<Vector2> p) => Precision.AlmostEquals(0, (p[1].Y - p[0].Y) * (p[2].X - p[0].X)
+                                                                                    - (p[1].X - p[0].X) * (p[2].Y - p[0].Y));
         }
 
         /// <summary>

From bcb91f348d746bd4470240c23c72ec812fc54113 Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Wed, 28 Feb 2024 22:51:36 +0800
Subject: [PATCH 207/930] Use ArrayPool instead of stackalloc

---
 .../Objects/Legacy/ConvertHitObjectParser.cs  | 82 ++++++++++---------
 1 file changed, 44 insertions(+), 38 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 2d4d2865e6..a3ca719ff9 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -18,6 +18,7 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.Skinning;
 using osu.Game.Utils;
+using System.Buffers;
 
 namespace osu.Game.Rulesets.Objects.Legacy
 {
@@ -266,41 +267,49 @@ namespace osu.Game.Rulesets.Objects.Legacy
             // This code takes on the responsibility of handling explicit segments of the path ("X" & "Y" from above). Implicit segments are handled by calls to convertPoints().
             string[] pointSplit = pointString.Split('|');
 
-            Span<Vector2> points = stackalloc Vector2[pointSplit.Length];
-            Span<(PathType Type, int StartIndex)> segments = stackalloc (PathType Type, int StartIndex)[pointSplit.Length];
+            var points = ArrayPool<Vector2>.Shared.Rent(pointSplit.Length);
+            var segments = ArrayPool<(PathType Type, int StartIndex)>.Shared.Rent(pointSplit.Length);
             int pointsCount = 0;
             int segmentsCount = 0;
-
-            foreach (string s in pointSplit)
+            try
             {
-                if (char.IsLetter(s[0]))
-                {
-                    // The start of a new segment(indicated by having an alpha character at position 0).
-                    var pathType = convertPathType(s);
-                    segments[segmentsCount++] = (pathType, pointsCount);
 
-                    // First segment is prepended by an extra zero point
-                    if (pointsCount == 0)
-                        points[pointsCount++] = Vector2.Zero;
-                }
-                else
+                foreach (string s in pointSplit)
                 {
-                    points[pointsCount++] = readPoint(s, offset);
+                    if (char.IsLetter(s[0]))
+                    {
+                        // The start of a new segment(indicated by having an alpha character at position 0).
+                        var pathType = convertPathType(s);
+                        segments[segmentsCount++] = (pathType, pointsCount);
+
+                        // First segment is prepended by an extra zero point
+                        if (pointsCount == 0)
+                            points[pointsCount++] = Vector2.Zero;
+                    }
+                    else
+                    {
+                        points[pointsCount++] = readPoint(s, offset);
+                    }
                 }
+
+                var controlPoints = new List<ArraySegment<PathControlPoint>>(pointsCount);
+
+                for (int i = 0; i < segmentsCount; i++)
+                {
+                    int startIndex = segments[i].StartIndex;
+                    int endIndex = i < segmentsCount - 1 ? segments[i + 1].StartIndex : pointsCount;
+                    Vector2? endPoint = i < segmentsCount - 1 ? points[endIndex] : null;
+                    controlPoints.AddRange(convertPoints(segments[i].Type, new ArraySegment<Vector2>(points, startIndex, endIndex - startIndex), endPoint));
+                }
+
+                return controlPoints.SelectMany(s => s).ToArray();
             }
-
-            var controlPoints = new List<PathControlPoint>(pointsCount);
-
-            for (int i = 0; i < segmentsCount; i++)
+            finally
             {
-                int startIndex = segments[i].StartIndex;
-                int endIndex = i < segmentsCount - 1 ? segments[i + 1].StartIndex : pointsCount;
-                Vector2? endPoint = i < segmentsCount - 1 ? points[endIndex] : null;
-                controlPoints.AddRange(convertPoints(segments[i].Type, points[startIndex..endIndex], endPoint));
+                ArrayPool<Vector2>.Shared.Return(points);
+                ArrayPool<(PathType Type, int StartIndex)>.Shared.Return(segments);
             }
 
-            return controlPoints.ToArray();
-
             static Vector2 readPoint(string value, Vector2 startPos)
             {
                 string[] vertexSplit = value.Split(':');
@@ -317,13 +326,12 @@ namespace osu.Game.Rulesets.Objects.Legacy
         /// <param name="points">The point list.</param>
         /// <param name="endPoint">Any extra endpoint to consider as part of the points. This will NOT be returned.</param>
         /// <returns>The set of points contained by <paramref name="points"/> as one or more segments of the path.</returns>
-        private IEnumerable<PathControlPoint> convertPoints(PathType type, ReadOnlySpan<Vector2> points, Vector2? endPoint)
+        private IEnumerable<ArraySegment<PathControlPoint>> convertPoints(PathType type, ArraySegment<Vector2> points, Vector2? endPoint)
         {
-            var vertices = new PathControlPoint[points.Length];
-            var result = new List<PathControlPoint>();
+            var vertices = new PathControlPoint[points.Count];
 
             // Parse into control points.
-            for (int i = 0; i < points.Length; i++)
+            for (int i = 0; i < points.Count; i++)
                 vertices[i] = new PathControlPoint { Position = points[i] };
 
             // Edge-case rules (to match stable).
@@ -333,7 +341,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
                 if (vertices.Length + endPointLength != 3)
                     type = PathType.BEZIER;
-                else if (isLinear(stackalloc[] { points[0], points[1], endPoint ?? points[2] }))
+                else if (isLinear(points[0], points[1], endPoint ?? points[2]))
                 {
                     // osu-stable special-cased colinear perfect curves to a linear path
                     type = PathType.LINEAR;
@@ -370,20 +378,18 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
                 // Force a type on the last point, and return the current control point set as a segment.
                 vertices[endIndex - 1].Type = type;
-                for (int i = startIndex; i < endIndex; i++)
-                    result.Add(vertices[i]);
+                yield return new ArraySegment<PathControlPoint>(vertices, startIndex, endIndex - startIndex);
 
                 // Skip the current control point - as it's the same as the one that's just been returned.
                 startIndex = endIndex + 1;
             }
 
-            for (int i = startIndex; i < endIndex; i++)
-                result.Add(vertices[i]);
+            if (startIndex < endIndex)
+                yield return new ArraySegment<PathControlPoint>(vertices, startIndex, endIndex - startIndex);
 
-            return result;
-
-            static bool isLinear(ReadOnlySpan<Vector2> p) => Precision.AlmostEquals(0, (p[1].Y - p[0].Y) * (p[2].X - p[0].X)
-                                                                                    - (p[1].X - p[0].X) * (p[2].Y - p[0].Y));
+            static bool isLinear(Vector2 p0, Vector2 p1, Vector2 p2)
+                => Precision.AlmostEquals(0, (p1.Y - p0.Y) * (p2.X - p0.X)
+                                          - (p1.X - p0.X) * (p2.Y - p0.Y));
         }
 
         /// <summary>

From c10ba6ece9aea6d4325482563ae64fbc8261a65e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 28 Feb 2024 15:59:22 +0100
Subject: [PATCH 208/930] Fix right mouse scroll clamping not going along well
 with padding

Co-authored-by: Joseph Madamba <madamba.joehu@outlook.com>
---
 osu.Game/Graphics/Containers/OsuScrollContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/OsuScrollContainer.cs b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
index 124becc35a..ffd28957ef 100644
--- a/osu.Game/Graphics/Containers/OsuScrollContainer.cs
+++ b/osu.Game/Graphics/Containers/OsuScrollContainer.cs
@@ -127,7 +127,7 @@ namespace osu.Game.Graphics.Containers
         }
 
         protected virtual void ScrollFromMouseEvent(MouseEvent e) =>
-            ScrollTo(Clamp(ToLocalSpace(e.ScreenSpaceMousePosition)[ScrollDim] / DrawSize[ScrollDim]) * Content.DrawSize[ScrollDim], true, DistanceDecayOnRightMouseScrollbar);
+            ScrollTo(Clamp(ToLocalSpace(e.ScreenSpaceMousePosition)[ScrollDim] / DrawSize[ScrollDim] * Content.DrawSize[ScrollDim]), true, DistanceDecayOnRightMouseScrollbar);
 
         protected override ScrollbarContainer CreateScrollbar(Direction direction) => new OsuScrollbar(direction);
 

From 470d2be2e1b4043953e067ef91e4c997138cc0ef Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Thu, 29 Feb 2024 00:07:00 +0800
Subject: [PATCH 209/930] The overhead of LINQ is not ignorable

---
 .../Objects/Legacy/ConvertHitObjectParser.cs  | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index a3ca719ff9..72053648a0 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -302,7 +302,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
                     controlPoints.AddRange(convertPoints(segments[i].Type, new ArraySegment<Vector2>(points, startIndex, endIndex - startIndex), endPoint));
                 }
 
-                return controlPoints.SelectMany(s => s).ToArray();
+                return mergePointsLists(controlPoints);
             }
             finally
             {
@@ -392,6 +392,25 @@ namespace osu.Game.Rulesets.Objects.Legacy
                                           - (p1.X - p0.X) * (p2.Y - p0.Y));
         }
 
+        private PathControlPoint[] mergePointsLists(List<ArraySegment<PathControlPoint>> controlPointList)
+        {
+            int totalCount = 0;
+
+            foreach (var arr in controlPointList)
+                totalCount += arr.Count;
+
+            var mergedArray = new PathControlPoint[totalCount];
+            int copyIndex = 0;
+
+            foreach (var arr in controlPointList)
+            {
+                arr.AsSpan().CopyTo(mergedArray.AsSpan(copyIndex));
+                copyIndex += arr.Count;
+            }
+
+            return mergedArray;
+        }
+
         /// <summary>
         /// Creates a legacy Hit-type hit object.
         /// </summary>

From e86ebd6cdba85e506a771aeab0fdeb0a71d74fab Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Thu, 29 Feb 2024 00:24:24 +0800
Subject: [PATCH 210/930] Fix formatting

---
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 72053648a0..f042e6ba26 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -271,9 +271,9 @@ namespace osu.Game.Rulesets.Objects.Legacy
             var segments = ArrayPool<(PathType Type, int StartIndex)>.Shared.Rent(pointSplit.Length);
             int pointsCount = 0;
             int segmentsCount = 0;
+
             try
             {
-
                 foreach (string s in pointSplit)
                 {
                     if (char.IsLetter(s[0]))

From 5ca6e8c68a54c0341fc1e0debac5c6e3ebb9739e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 28 Feb 2024 11:03:09 -0800
Subject: [PATCH 211/930] Fix some NRT changes

---
 osu.Game/Screens/Play/SoloSpectatorPlayer.cs | 4 +++-
 osu.Game/Screens/Play/SpectatorPlayer.cs     | 6 +++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
index 2cc1c4a368..be83a4c6b5 100644
--- a/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorPlayer.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Screens;
 using osu.Game.Online.Spectator;
 using osu.Game.Scoring;
@@ -48,7 +49,8 @@ namespace osu.Game.Screens.Play
         {
             base.Dispose(isDisposing);
 
-            SpectatorClient.OnUserBeganPlaying -= userBeganPlaying;
+            if (SpectatorClient.IsNotNull())
+                SpectatorClient.OnUserBeganPlaying -= userBeganPlaying;
         }
     }
 }
diff --git a/osu.Game/Screens/Play/SpectatorPlayer.cs b/osu.Game/Screens/Play/SpectatorPlayer.cs
index 520fb43445..b2ac946642 100644
--- a/osu.Game/Screens/Play/SpectatorPlayer.cs
+++ b/osu.Game/Screens/Play/SpectatorPlayer.cs
@@ -1,8 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Diagnostics;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Screens;
 using osu.Game.Beatmaps;
@@ -97,7 +97,6 @@ namespace osu.Game.Screens.Play
             foreach (var frame in bundle.Frames)
             {
                 IConvertibleReplayFrame convertibleFrame = GameplayState.Ruleset.CreateConvertibleReplayFrame()!;
-                Debug.Assert(convertibleFrame != null);
                 convertibleFrame.FromLegacy(frame, GameplayState.Beatmap);
 
                 var convertedFrame = (ReplayFrame)convertibleFrame;
@@ -132,7 +131,8 @@ namespace osu.Game.Screens.Play
         {
             base.Dispose(isDisposing);
 
-            SpectatorClient.OnNewFrames -= userSentFrames;
+            if (SpectatorClient.IsNotNull())
+                SpectatorClient.OnNewFrames -= userSentFrames;
         }
     }
 }

From 232ca5778fc7fb86144f7bb74ee93ee2ac462549 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 00:09:48 +0300
Subject: [PATCH 212/930] Improve spectator fail test

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
index c8356cd191..0de2b6a980 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSpectator.cs
@@ -10,6 +10,7 @@ using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
+using osu.Game.Localisation;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Osu;
@@ -23,7 +24,6 @@ using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Visual.Multiplayer;
 using osu.Game.Tests.Visual.Spectator;
 using osuTK;
-using osuTK.Input;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
@@ -214,7 +214,9 @@ namespace osu.Game.Tests.Visual.Gameplay
             checkPaused(true); // And eventually stop after running out of frames and fail.
             // Todo: Should check for + display a failed message.
 
-            AddStep("exit player", () => InputManager.Key(Key.Escape));
+            AddAssert("fail overlay present", () => player.ChildrenOfType<FailOverlay>().Single().IsPresent);
+            AddAssert("overlay can only quit", () => player.ChildrenOfType<FailOverlay>().Single().Buttons.Single().Text == GameplayMenuOverlayStrings.Quit);
+            AddStep("press quit button", () => player.ChildrenOfType<FailOverlay>().Single().Buttons.Single().TriggerClick());
             AddAssert("player exited", () => Stack.CurrentScreen is SoloSpectatorScreen);
         }
 

From 4a4ef91bc96c9cab11102156c429a778237cdcbf Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 00:42:52 +0300
Subject: [PATCH 213/930] Simplify active mods computation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs         |  9 +++++----
 .../OnlinePlay/Match/RoomModSelectOverlay.cs       | 14 +++++++++++---
 2 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 6b80ff6e44..9605c0b2fe 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -104,6 +104,8 @@ namespace osu.Game.Overlays.Mods
 
         protected virtual IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection) => newSelection;
 
+        protected virtual IReadOnlyList<Mod> ComputeActiveMods() => SelectedMods.Value;
+
         protected virtual IEnumerable<ShearedButton> CreateFooterButtons()
         {
             if (AllowCustomisation)
@@ -321,13 +323,12 @@ namespace osu.Game.Overlays.Mods
             if (AllowCustomisation)
                 ((IBindable<IReadOnlyList<Mod>>)modSettingsArea.SelectedMods).BindTo(SelectedMods);
 
-            SelectedMods.BindValueChanged(mods =>
+            SelectedMods.BindValueChanged(_ =>
             {
-                var newMods = ActiveMods.Value.Except(mods.OldValue).Concat(mods.NewValue).ToList();
-                ActiveMods.Value = newMods;
-
                 updateFromExternalSelection();
                 updateCustomisation();
+
+                ActiveMods.Value = ComputeActiveMods();
             }, true);
 
             ActiveMods.BindValueChanged(_ =>
diff --git a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
index d3fd6de911..55e077df0f 100644
--- a/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/RoomModSelectOverlay.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
@@ -9,6 +10,7 @@ using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Screens.OnlinePlay.Match
 {
@@ -20,6 +22,8 @@ namespace osu.Game.Screens.OnlinePlay.Match
         [Resolved]
         private RulesetStore rulesets { get; set; } = null!;
 
+        private readonly List<Mod> roomRequiredMods = new List<Mod>();
+
         public RoomModSelectOverlay()
             : base(OverlayColourScheme.Plum)
         {
@@ -31,15 +35,19 @@ namespace osu.Game.Screens.OnlinePlay.Match
 
             selectedItem.BindValueChanged(v =>
             {
+                roomRequiredMods.Clear();
+
                 if (v.NewValue is PlaylistItem item)
                 {
                     var rulesetInstance = rulesets.GetRuleset(item.RulesetID)?.CreateInstance();
                     Debug.Assert(rulesetInstance != null);
-                    ActiveMods.Value = item.RequiredMods.Select(m => m.ToMod(rulesetInstance)).Concat(SelectedMods.Value).ToList();
+                    roomRequiredMods.AddRange(item.RequiredMods.Select(m => m.ToMod(rulesetInstance)));
                 }
-                else
-                    ActiveMods.Value = SelectedMods.Value;
+
+                ActiveMods.Value = ComputeActiveMods();
             }, true);
         }
+
+        protected override IReadOnlyList<Mod> ComputeActiveMods() => roomRequiredMods.Concat(base.ComputeActiveMods()).ToList();
     }
 }

From c3a7e998497b136e5ca97b6729de4661cc28c2d5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 01:01:55 +0300
Subject: [PATCH 214/930] Remove unnecessary max operation

---
 osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
index 7e0dd161dc..a14ab3cbcd 100644
--- a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Screens.Play.HUD
             int digitsRequiredForDisplayCount = Math.Max(RequiredDisplayDigits.Value, getDigitsRequiredForDisplayCount());
 
             if (digitsRequiredForDisplayCount != scoreText.WireframeTemplate.Length)
-                scoreText.WireframeTemplate = new string('#', Math.Max(RequiredDisplayDigits.Value, digitsRequiredForDisplayCount));
+                scoreText.WireframeTemplate = new string('#', digitsRequiredForDisplayCount);
         }
 
         private int getDigitsRequiredForDisplayCount()

From de48c51715c072adb1ed75d7717a93e7af334e56 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 01:11:01 +0300
Subject: [PATCH 215/930] Apply renaming in remaining usages

---
 ...atisticsWatcher.cs => TestSceneUserStatisticsWatcher.cs} | 2 +-
 .../Toolbar/TransientUserStatisticsUpdateDisplay.cs         | 6 +++---
 osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs  | 6 +++---
 osu.Game/Users/UserRankPanel.cs                             | 2 +-
 4 files changed, 8 insertions(+), 8 deletions(-)
 rename osu.Game.Tests/Visual/Online/{TestSceneSoloStatisticsWatcher.cs => TestSceneUserStatisticsWatcher.cs} (99%)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs b/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
similarity index 99%
rename from osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs
rename to osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
index 733769b9f3..0b1f50b66f 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneSoloStatisticsWatcher.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
@@ -21,7 +21,7 @@ using osu.Game.Users;
 namespace osu.Game.Tests.Visual.Online
 {
     [HeadlessTest]
-    public partial class TestSceneSoloStatisticsWatcher : OsuTestScene
+    public partial class TestSceneUserStatisticsWatcher : OsuTestScene
     {
         protected override bool UseOnlineAPI => false;
 
diff --git a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
index e7a78f8b80..21d91ef53f 100644
--- a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Toolbar
         private Statistic<decimal> pp = null!;
 
         [BackgroundDependencyLoader]
-        private void load(UserStatisticsWatcher? soloStatisticsWatcher)
+        private void load(UserStatisticsWatcher? userStatisticsWatcher)
         {
             RelativeSizeAxes = Axes.Y;
             AutoSizeAxes = Axes.X;
@@ -47,8 +47,8 @@ namespace osu.Game.Overlays.Toolbar
                 }
             };
 
-            if (soloStatisticsWatcher != null)
-                ((IBindable<UserStatisticsUpdate?>)LatestUpdate).BindTo(soloStatisticsWatcher.LatestUpdate);
+            if (userStatisticsWatcher != null)
+                ((IBindable<UserStatisticsUpdate?>)LatestUpdate).BindTo(userStatisticsWatcher.LatestUpdate);
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
index 7f8c12ddab..c37eb1914b 100644
--- a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
@@ -28,11 +28,11 @@ namespace osu.Game.Screens.Ranking.Statistics
         }
 
         [BackgroundDependencyLoader]
-        private void load(UserStatisticsWatcher? soloStatisticsWatcher)
+        private void load(UserStatisticsWatcher? userStatisticsWatcher)
         {
-            if (soloStatisticsWatcher != null)
+            if (userStatisticsWatcher != null)
             {
-                latestGlobalStatisticsUpdate = soloStatisticsWatcher.LatestUpdate.GetBoundCopy();
+                latestGlobalStatisticsUpdate = userStatisticsWatcher.LatestUpdate.GetBoundCopy();
                 latestGlobalStatisticsUpdate.BindValueChanged(update =>
                 {
                     if (update.NewValue?.Score.MatchesOnlineID(achievedScore) == true)
diff --git a/osu.Game/Users/UserRankPanel.cs b/osu.Game/Users/UserRankPanel.cs
index b440261a4c..0d57b7bb7d 100644
--- a/osu.Game/Users/UserRankPanel.cs
+++ b/osu.Game/Users/UserRankPanel.cs
@@ -168,7 +168,7 @@ namespace osu.Game.Users
                                     Title = UsersStrings.ShowRankGlobalSimple,
                                     // TODO: implement highest rank tooltip
                                     // `RankHighest` resides in `APIUser`, but `api.LocalUser` doesn't update
-                                    // maybe move to `UserStatistics` in api, so `SoloStatisticsWatcher` can update the value
+                                    // maybe move to `UserStatistics` in api, so `UserStatisticsWatcher` can update the value
                                 },
                                 countryRankDisplay = new ProfileValueDisplay(true)
                                 {

From 8f97f0503f1107d06576390eb014cb5dfaed4b0b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 01:13:31 +0300
Subject: [PATCH 216/930] Move away from `Solo` namespace

---
 osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs       | 2 +-
 osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs  | 2 +-
 osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs        | 2 +-
 osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs       | 2 +-
 osu.Game/Online/{Solo => }/UserStatisticsUpdate.cs              | 2 +-
 osu.Game/Online/{Solo => }/UserStatisticsWatcher.cs             | 2 +-
 osu.Game/OsuGame.cs                                             | 1 -
 .../Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs    | 2 +-
 osu.Game/Screens/Play/SubmittingPlayer.cs                       | 2 +-
 osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs      | 2 +-
 osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs    | 2 +-
 osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs      | 2 +-
 12 files changed, 11 insertions(+), 12 deletions(-)
 rename osu.Game/Online/{Solo => }/UserStatisticsUpdate.cs (97%)
 rename osu.Game/Online/{Solo => }/UserStatisticsWatcher.cs (99%)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs b/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
index 41ce739c2f..1a4ca65975 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneToolbarUserButton.cs
@@ -8,8 +8,8 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
+using osu.Game.Online;
 using osu.Game.Online.API;
-using osu.Game.Online.Solo;
 using osu.Game.Overlays.Toolbar;
 using osu.Game.Scoring;
 using osu.Game.Users;
diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs b/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
index 0b1f50b66f..e7ad07041c 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserStatisticsWatcher.cs
@@ -8,10 +8,10 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Testing;
 using osu.Game.Models;
+using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
-using osu.Game.Online.Solo;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs b/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
index ee0ab0c880..ffc7d88a34 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneOverallRanking.cs
@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Graphics;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics.User;
 using osu.Game.Users;
diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
index ecb8073a88..acfa519c81 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneStatisticsPanel.cs
@@ -13,7 +13,7 @@ using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
diff --git a/osu.Game/Online/Solo/UserStatisticsUpdate.cs b/osu.Game/Online/UserStatisticsUpdate.cs
similarity index 97%
rename from osu.Game/Online/Solo/UserStatisticsUpdate.cs
rename to osu.Game/Online/UserStatisticsUpdate.cs
index 03f3abbb66..f85b219ef0 100644
--- a/osu.Game/Online/Solo/UserStatisticsUpdate.cs
+++ b/osu.Game/Online/UserStatisticsUpdate.cs
@@ -4,7 +4,7 @@
 using osu.Game.Scoring;
 using osu.Game.Users;
 
-namespace osu.Game.Online.Solo
+namespace osu.Game.Online
 {
     /// <summary>
     /// Contains data about the change in a user's profile statistics after completing a score.
diff --git a/osu.Game/Online/Solo/UserStatisticsWatcher.cs b/osu.Game/Online/UserStatisticsWatcher.cs
similarity index 99%
rename from osu.Game/Online/Solo/UserStatisticsWatcher.cs
rename to osu.Game/Online/UserStatisticsWatcher.cs
index 2fff92fe0f..af32e86ae4 100644
--- a/osu.Game/Online/Solo/UserStatisticsWatcher.cs
+++ b/osu.Game/Online/UserStatisticsWatcher.cs
@@ -15,7 +15,7 @@ using osu.Game.Online.Spectator;
 using osu.Game.Scoring;
 using osu.Game.Users;
 
-namespace osu.Game.Online.Solo
+namespace osu.Game.Online
 {
     /// <summary>
     /// A persistent component that binds to the spectator server and API in order to deliver updates about the logged in user's gameplay statistics.
diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 419e31bacd..44d1e7fad6 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -47,7 +47,6 @@ using osu.Game.Localisation;
 using osu.Game.Online;
 using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
-using osu.Game.Online.Solo;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapListing;
 using osu.Game.Overlays.Music;
diff --git a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
index 21d91ef53f..c6f373d55f 100644
--- a/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
+++ b/osu.Game/Overlays/Toolbar/TransientUserStatisticsUpdateDisplay.cs
@@ -13,7 +13,7 @@ using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 
diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index ee88171789..62226c46dd 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -14,10 +14,10 @@ using osu.Framework.Screens;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Database;
+using osu.Game.Online;
 using osu.Game.Online.API;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
-using osu.Game.Online.Solo;
 using osu.Game.Online.Spectator;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
diff --git a/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs b/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
index 5c96a2b6c3..1e60e09486 100644
--- a/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
+++ b/osu.Game/Screens/Ranking/Statistics/User/OverallRanking.cs
@@ -6,7 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 
 namespace osu.Game.Screens.Ranking.Statistics.User
 {
diff --git a/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs b/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
index a477f38cd1..e5f07d9891 100644
--- a/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
+++ b/osu.Game/Screens/Ranking/Statistics/User/RankingChangeRow.cs
@@ -11,7 +11,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 using osu.Game.Users;
 using osuTK;
 
diff --git a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
index c37eb1914b..fa3bb1a375 100644
--- a/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/UserStatisticsPanel.cs
@@ -8,7 +8,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Extensions;
-using osu.Game.Online.Solo;
+using osu.Game.Online;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking.Statistics.User;
 

From 7f5f3804f1695e130a2ab41d5e4fda092a32ed1d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 05:39:36 +0300
Subject: [PATCH 217/930] Expose beatmap storyboard as part of `GameplayState`

---
 osu.Game/Screens/Play/GameplayState.cs | 9 ++++++++-
 osu.Game/Screens/Play/Player.cs        | 8 ++++----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/GameplayState.cs b/osu.Game/Screens/Play/GameplayState.cs
index cc399a0fbe..8b0207a340 100644
--- a/osu.Game/Screens/Play/GameplayState.cs
+++ b/osu.Game/Screens/Play/GameplayState.cs
@@ -10,6 +10,7 @@ using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Storyboards;
 
 namespace osu.Game.Screens.Play
 {
@@ -40,6 +41,11 @@ namespace osu.Game.Screens.Play
 
         public readonly ScoreProcessor ScoreProcessor;
 
+        /// <summary>
+        /// The storyboard associated with the beatmap.
+        /// </summary>
+        public readonly Storyboard Storyboard;
+
         /// <summary>
         /// Whether gameplay completed without the user failing.
         /// </summary>
@@ -62,7 +68,7 @@ namespace osu.Game.Screens.Play
 
         private readonly Bindable<JudgementResult> lastJudgementResult = new Bindable<JudgementResult>();
 
-        public GameplayState(IBeatmap beatmap, Ruleset ruleset, IReadOnlyList<Mod>? mods = null, Score? score = null, ScoreProcessor? scoreProcessor = null)
+        public GameplayState(IBeatmap beatmap, Ruleset ruleset, IReadOnlyList<Mod>? mods = null, Score? score = null, ScoreProcessor? scoreProcessor = null, Storyboard? storyboard = null)
         {
             Beatmap = beatmap;
             Ruleset = ruleset;
@@ -76,6 +82,7 @@ namespace osu.Game.Screens.Play
             };
             Mods = mods ?? Array.Empty<Mod>();
             ScoreProcessor = scoreProcessor ?? ruleset.CreateScoreProcessor();
+            Storyboard = storyboard ?? new Storyboard();
         }
 
         /// <summary>
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 88f6ae9e71..10ada09be7 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -255,7 +255,7 @@ namespace osu.Game.Screens.Play
             Score.ScoreInfo.Ruleset = ruleset.RulesetInfo;
             Score.ScoreInfo.Mods = gameplayMods;
 
-            dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score, ScoreProcessor));
+            dependencies.CacheAs(GameplayState = new GameplayState(playableBeatmap, ruleset, gameplayMods, Score, ScoreProcessor, Beatmap.Value.Storyboard));
 
             var rulesetSkinProvider = new RulesetSkinProvidingContainer(ruleset, playableBeatmap, Beatmap.Value.Skin);
 
@@ -397,7 +397,7 @@ namespace osu.Game.Screens.Play
         protected virtual GameplayClockContainer CreateGameplayClockContainer(WorkingBeatmap beatmap, double gameplayStart) => new MasterGameplayClockContainer(beatmap, gameplayStart);
 
         private Drawable createUnderlayComponents() =>
-            DimmableStoryboard = new DimmableStoryboard(Beatmap.Value.Storyboard, GameplayState.Mods) { RelativeSizeAxes = Axes.Both };
+            DimmableStoryboard = new DimmableStoryboard(GameplayState.Storyboard, GameplayState.Mods) { RelativeSizeAxes = Axes.Both };
 
         private Drawable createGameplayComponents(IWorkingBeatmap working) => new ScalingContainer(ScalingMode.Gameplay)
         {
@@ -456,7 +456,7 @@ namespace osu.Game.Screens.Play
                     {
                         RequestSkip = performUserRequestedSkip
                     },
-                    skipOutroOverlay = new SkipOverlay(Beatmap.Value.Storyboard.LatestEventTime ?? 0)
+                    skipOutroOverlay = new SkipOverlay(GameplayState.Storyboard.LatestEventTime ?? 0)
                     {
                         RequestSkip = () => progressToResults(false),
                         Alpha = 0
@@ -1088,7 +1088,7 @@ namespace osu.Game.Screens.Play
 
             DimmableStoryboard.IsBreakTime.BindTo(breakTracker.IsBreakTime);
 
-            storyboardReplacesBackground.Value = Beatmap.Value.Storyboard.ReplacesBackground && Beatmap.Value.Storyboard.HasDrawable;
+            storyboardReplacesBackground.Value = GameplayState.Storyboard.ReplacesBackground && GameplayState.Storyboard.HasDrawable;
 
             foreach (var mod in GameplayState.Mods.OfType<IApplicableToPlayer>())
                 mod.ApplyToPlayer(this);

From 847a8ead4fbdd86149b10fad884ed664a94e5352 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 05:39:59 +0300
Subject: [PATCH 218/930] Hide taiko scroller when beatmap has storyboard

---
 .../UI/DrawableTaikoRuleset.cs                | 29 ++++++++++++++-----
 1 file changed, 22 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index 77b2b06c0e..ff969c3f74 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -5,6 +5,8 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -22,7 +24,9 @@ using osu.Game.Rulesets.Timing;
 using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Scoring;
+using osu.Game.Screens.Play;
 using osu.Game.Skinning;
+using osu.Game.Storyboards;
 using osuTK;
 
 namespace osu.Game.Rulesets.Taiko.UI
@@ -39,6 +43,7 @@ namespace osu.Game.Rulesets.Taiko.UI
 
         protected override bool UserScrollSpeedAdjustment => false;
 
+        [CanBeNull]
         private SkinnableDrawable scroller;
 
         public DrawableTaikoRuleset(Ruleset ruleset, IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
@@ -48,16 +53,24 @@ namespace osu.Game.Rulesets.Taiko.UI
             VisualisationMethod = ScrollVisualisationMethod.Overlapping;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
+        [BackgroundDependencyLoader(true)]
+        private void load(GameplayState gameplayState)
         {
             new BarLineGenerator<BarLine>(Beatmap).BarLines.ForEach(bar => Playfield.Add(bar));
 
-            FrameStableComponents.Add(scroller = new SkinnableDrawable(new TaikoSkinComponentLookup(TaikoSkinComponents.Scroller), _ => Empty())
+            var spriteElements = gameplayState.Storyboard.Layers.Where(l => l.Name != @"Overlay")
+                                              .SelectMany(l => l.Elements)
+                                              .OfType<StoryboardSprite>()
+                                              .DistinctBy(e => e.Path);
+
+            if (spriteElements.Count() < 10)
             {
-                RelativeSizeAxes = Axes.X,
-                Depth = float.MaxValue
-            });
+                FrameStableComponents.Add(scroller = new SkinnableDrawable(new TaikoSkinComponentLookup(TaikoSkinComponents.Scroller), _ => Empty())
+                {
+                    RelativeSizeAxes = Axes.X,
+                    Depth = float.MaxValue,
+                });
+            }
 
             KeyBindingInputManager.Add(new DrumTouchInputArea());
         }
@@ -76,7 +89,9 @@ namespace osu.Game.Rulesets.Taiko.UI
             base.UpdateAfterChildren();
 
             var playfieldScreen = Playfield.ScreenSpaceDrawQuad;
-            scroller.Height = ToLocalSpace(playfieldScreen.TopLeft + new Vector2(0, playfieldScreen.Height / 20)).Y;
+
+            if (scroller != null)
+                scroller.Height = ToLocalSpace(playfieldScreen.TopLeft + new Vector2(0, playfieldScreen.Height / 20)).Y;
         }
 
         public MultiplierControlPoint ControlPointAt(double time)

From f28f19ed7eeee1ecacc909f0f4f35edb07c7b8cb Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Thu, 29 Feb 2024 10:47:16 +0800
Subject: [PATCH 219/930] Fix method indent size

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index f042e6ba26..db1fbe3fa4 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -389,7 +389,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
 
             static bool isLinear(Vector2 p0, Vector2 p1, Vector2 p2)
                 => Precision.AlmostEquals(0, (p1.Y - p0.Y) * (p2.X - p0.X)
-                                          - (p1.X - p0.X) * (p2.Y - p0.Y));
+                                             - (p1.X - p0.X) * (p2.Y - p0.Y));
         }
 
         private PathControlPoint[] mergePointsLists(List<ArraySegment<PathControlPoint>> controlPointList)

From 4b0b0735a81aec44fe0725eac3be8ece7b733854 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 06:03:57 +0300
Subject: [PATCH 220/930] Add test coverage

---
 .../TestSceneTaikoPlayerScroller.cs           | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayerScroller.cs

diff --git a/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayerScroller.cs b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayerScroller.cs
new file mode 100644
index 0000000000..c2aa819c3a
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko.Tests/TestSceneTaikoPlayerScroller.cs
@@ -0,0 +1,57 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Taiko.Skinning.Legacy;
+using osu.Game.Storyboards;
+using osu.Game.Tests.Visual;
+using osuTK;
+
+namespace osu.Game.Rulesets.Taiko.Tests
+{
+    public partial class TestSceneTaikoPlayerScroller : LegacySkinPlayerTestScene
+    {
+        private Storyboard? currentStoryboard;
+
+        protected override bool HasCustomSteps => true;
+
+        [Test]
+        public void TestForegroundSpritesHidesScroller()
+        {
+            AddStep("load storyboard", () =>
+            {
+                currentStoryboard = new Storyboard();
+
+                for (int i = 0; i < 10; i++)
+                    currentStoryboard.GetLayer("Foreground").Add(new StoryboardSprite($"test{i}", Anchor.Centre, Vector2.Zero));
+            });
+
+            CreateTest();
+            AddAssert("taiko scroller not present", () => !this.ChildrenOfType<LegacyTaikoScroller>().Any());
+        }
+
+        [Test]
+        public void TestOverlaySpritesKeepsScroller()
+        {
+            AddStep("load storyboard", () =>
+            {
+                currentStoryboard = new Storyboard();
+
+                for (int i = 0; i < 10; i++)
+                    currentStoryboard.GetLayer("Overlay").Add(new StoryboardSprite($"test{i}", Anchor.Centre, Vector2.Zero));
+            });
+
+            CreateTest();
+            AddAssert("taiko scroller present", () => this.ChildrenOfType<LegacyTaikoScroller>().Single().IsPresent);
+        }
+
+        protected override Ruleset CreatePlayerRuleset() => new TaikoRuleset();
+
+        protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard? storyboard = null)
+            => base.CreateWorkingBeatmap(beatmap, currentStoryboard ?? storyboard);
+    }
+}

From dac8f98ea6b7d6f039d5fbe9b86b17a4303969cb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 29 Feb 2024 07:13:32 +0300
Subject: [PATCH 221/930] Fix `GameplayState` not handled as nullable

---
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index ff969c3f74..b8e76be89e 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -54,14 +54,14 @@ namespace osu.Game.Rulesets.Taiko.UI
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(GameplayState gameplayState)
+        private void load([CanBeNull] GameplayState gameplayState)
         {
             new BarLineGenerator<BarLine>(Beatmap).BarLines.ForEach(bar => Playfield.Add(bar));
 
-            var spriteElements = gameplayState.Storyboard.Layers.Where(l => l.Name != @"Overlay")
+            var spriteElements = gameplayState?.Storyboard.Layers.Where(l => l.Name != @"Overlay")
                                               .SelectMany(l => l.Elements)
                                               .OfType<StoryboardSprite>()
-                                              .DistinctBy(e => e.Path);
+                                              .DistinctBy(e => e.Path) ?? Enumerable.Empty<StoryboardSprite>();
 
             if (spriteElements.Count() < 10)
             {

From 5495c2090a76bfd6f6a5efd0fd61530395cc6a68 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 14:15:29 +0800
Subject: [PATCH 222/930] Add test coverage of gameplay only running forwards

---
 .../Visual/Gameplay/TestScenePause.cs         | 66 ++++++++++++-------
 1 file changed, 43 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
index 73aa3be73d..030f2592ed 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePause.cs
@@ -16,6 +16,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play;
 using osu.Game.Skinning;
 using osuTK;
@@ -31,6 +32,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override Container<Drawable> Content => content;
 
+        private bool gameplayClockAlwaysGoingForward = true;
+        private double lastForwardCheckTime;
+
         public TestScenePause()
         {
             base.Content.Add(content = new GlobalCursorDisplay { RelativeSizeAxes = Axes.Both });
@@ -67,12 +71,20 @@ namespace osu.Game.Tests.Visual.Gameplay
             confirmPausedWithNoOverlay();
         }
 
+        [Test]
+        public void TestForwardPlaybackGuarantee()
+        {
+            hookForwardPlaybackCheck();
+
+            AddUntilStep("wait for forward playback", () => Player.GameplayClockContainer.CurrentTime > 1000);
+            AddStep("seek before gameplay", () => Player.GameplayClockContainer.Seek(-5000));
+
+            checkForwardPlayback();
+        }
+
         [Test]
         public void TestPauseWithLargeOffset()
         {
-            double lastStopTime;
-            bool alwaysGoingForward = true;
-
             AddStep("force large offset", () =>
             {
                 var offset = (BindableDouble)LocalConfig.GetBindable<double>(OsuSetting.AudioOffset);
@@ -82,25 +94,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 offset.Value = -5000;
             });
 
-            AddStep("add time forward check hook", () =>
-            {
-                lastStopTime = double.MinValue;
-                alwaysGoingForward = true;
-
-                Player.OnUpdate += _ =>
-                {
-                    var masterClock = (MasterGameplayClockContainer)Player.GameplayClockContainer;
-
-                    double currentTime = masterClock.CurrentTime;
-
-                    bool goingForward = currentTime >= lastStopTime;
-
-                    alwaysGoingForward &= goingForward;
-
-                    if (!goingForward)
-                        Logger.Log($"Went too far backwards (last stop: {lastStopTime:N1} current: {currentTime:N1})");
-                };
-            });
+            hookForwardPlaybackCheck();
 
             AddStep("move cursor outside", () => InputManager.MoveMouseTo(Player.ScreenSpaceDrawQuad.TopLeft - new Vector2(10)));
 
@@ -108,11 +102,37 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             resumeAndConfirm();
 
-            AddAssert("time didn't go too far backwards", () => alwaysGoingForward);
+            checkForwardPlayback();
 
             AddStep("reset offset", () => LocalConfig.SetValue(OsuSetting.AudioOffset, 0.0));
         }
 
+        private void checkForwardPlayback() => AddAssert("time didn't go too far backwards", () => gameplayClockAlwaysGoingForward);
+
+        private void hookForwardPlaybackCheck()
+        {
+            AddStep("add time forward check hook", () =>
+            {
+                lastForwardCheckTime = double.MinValue;
+                gameplayClockAlwaysGoingForward = true;
+
+                Player.OnUpdate += _ =>
+                {
+                    var frameStableClock = Player.ChildrenOfType<FrameStabilityContainer>().Single().Clock;
+
+                    double currentTime = frameStableClock.CurrentTime;
+
+                    bool goingForward = currentTime >= lastForwardCheckTime;
+                    lastForwardCheckTime = currentTime;
+
+                    gameplayClockAlwaysGoingForward &= goingForward;
+
+                    if (!goingForward)
+                        Logger.Log($"Went too far backwards (last stop: {lastForwardCheckTime:N1} current: {currentTime:N1})");
+                };
+            });
+        }
+
         [Test]
         public void TestPauseResume()
         {

From 76e8aee9ccc13637691918de7c98d0cfaa8d1a7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 13:45:46 +0800
Subject: [PATCH 223/930] Disallow backwards seeks during frame stable
 operation when a replay is not attached

---
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index 8c9cb262af..4011034396 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -150,6 +150,17 @@ namespace osu.Game.Rulesets.UI
                     state = PlaybackState.NotValid;
             }
 
+            // This is a hotfix for https://github.com/ppy/osu/issues/26879 while we figure how the hell time is seeking
+            // backwards by 11,850 ms for some users during gameplay.
+            //
+            // It basically says that "while we're running in frame stable mode, and don't have a replay attached,
+            // time should never go backwards". If it does, we stop running gameplay until it returns to normal.
+            if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime)
+            {
+                state = PlaybackState.NotValid;
+                return;
+            }
+
             // if the proposed time is the same as the current time, assume that the clock will continue progressing in the same direction as previously.
             // this avoids spurious flips in direction from -1 to 1 during rewinds.
             if (state == PlaybackState.Valid && proposedTime != manualClock.CurrentTime)

From caad89a4ddd6b773df83e46d2da9c3ac4a81f0f8 Mon Sep 17 00:00:00 2001
From: Detze <92268414+Detze@users.noreply.github.com>
Date: Thu, 29 Feb 2024 07:36:35 +0100
Subject: [PATCH 224/930] Fix test failure on leap years

---
 .../NonVisual/Filtering/FilterQueryParserTest.cs     |  2 +-
 osu.Game/Screens/Select/FilterQueryParser.cs         | 12 ++++++------
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index 12d6060351..bf888348ee 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -538,7 +538,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             Assert.That(filterCriteria.LastPlayed.Max, Is.Not.Null);
             // the parser internally references `DateTimeOffset.Now`, so to not make things too annoying for tests, just assume some tolerance
             // (irrelevant in proportion to the actual filter proscribed).
-            Assert.That(filterCriteria.LastPlayed.Min, Is.EqualTo(DateTimeOffset.Now.AddYears(-1).AddMonths(-6)).Within(TimeSpan.FromSeconds(5)));
+            Assert.That(filterCriteria.LastPlayed.Min, Is.EqualTo(DateTimeOffset.Now.AddMonths(-6).AddYears(-1)).Within(TimeSpan.FromSeconds(5)));
             Assert.That(filterCriteria.LastPlayed.Max, Is.EqualTo(DateTimeOffset.Now.AddMonths(-3)).Within(TimeSpan.FromSeconds(5)));
         }
 
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 2c4077dacf..1ee8b9bc05 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -402,19 +402,19 @@ namespace osu.Game.Screens.Select
                 // we'll want to flip the operator, such that `>5d` means "more than five days ago", as in "*before* five days ago",
                 // as intended by the user.
                 case Operator.Less:
-                    op = Operator.Greater;
-                    break;
-
-                case Operator.LessOrEqual:
                     op = Operator.GreaterOrEqual;
                     break;
 
+                case Operator.LessOrEqual:
+                    op = Operator.Greater;
+                    break;
+
                 case Operator.Greater:
-                    op = Operator.Less;
+                    op = Operator.LessOrEqual;
                     break;
 
                 case Operator.GreaterOrEqual:
-                    op = Operator.LessOrEqual;
+                    op = Operator.Less;
                     break;
             }
 

From 9f2ea1e936e84d092cf9d2f5733b72abb43f3553 Mon Sep 17 00:00:00 2001
From: Detze <92268414+Detze@users.noreply.github.com>
Date: Thu, 29 Feb 2024 08:15:49 +0100
Subject: [PATCH 225/930] Revert incorrect change (I deserve to be shot)

---
 osu.Game/Screens/Select/FilterQueryParser.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 1ee8b9bc05..2c4077dacf 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -402,19 +402,19 @@ namespace osu.Game.Screens.Select
                 // we'll want to flip the operator, such that `>5d` means "more than five days ago", as in "*before* five days ago",
                 // as intended by the user.
                 case Operator.Less:
-                    op = Operator.GreaterOrEqual;
-                    break;
-
-                case Operator.LessOrEqual:
                     op = Operator.Greater;
                     break;
 
+                case Operator.LessOrEqual:
+                    op = Operator.GreaterOrEqual;
+                    break;
+
                 case Operator.Greater:
-                    op = Operator.LessOrEqual;
+                    op = Operator.Less;
                     break;
 
                 case Operator.GreaterOrEqual:
-                    op = Operator.Less;
+                    op = Operator.LessOrEqual;
                     break;
             }
 

From 7b28a66fc074a869d3af3f86ca2cf5c1d5e463d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 29 Feb 2024 11:11:30 +0100
Subject: [PATCH 226/930] Add failing test case

---
 .../TestSceneSliderInput.cs                   | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
index 12be74c4cc..286e4bd775 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneSliderInput.cs
@@ -457,6 +457,33 @@ namespace osu.Game.Rulesets.Osu.Tests
             assertMidSliderJudgementFail();
         }
 
+        [Test]
+        public void TestRewindHandling()
+        {
+            performTest(new List<ReplayFrame>
+            {
+                new OsuReplayFrame { Position = new Vector2(0), Actions = { OsuAction.LeftButton }, Time = time_slider_start },
+                new OsuReplayFrame { Position = new Vector2(175, 0), Actions = { OsuAction.LeftButton }, Time = 3250 },
+                new OsuReplayFrame { Position = new Vector2(175, 0), Actions = { OsuAction.LeftButton }, Time = time_slider_end },
+            }, new Slider
+            {
+                StartTime = time_slider_start,
+                Position = new Vector2(0, 0),
+                Path = new SliderPath(PathType.PERFECT_CURVE, new[]
+                {
+                    Vector2.Zero,
+                    new Vector2(250, 0),
+                }, 250),
+            });
+
+            AddUntilStep("wait for completion", () => currentPlayer.ScoreProcessor.HasCompleted.Value);
+            AddAssert("no miss judgements recorded", () => judgementResults.All(r => r.Type.IsHit()));
+
+            AddStep("rewind to middle of slider", () => currentPlayer.Seek(time_during_slide_4));
+            AddUntilStep("wait for completion", () => currentPlayer.ScoreProcessor.HasCompleted.Value);
+            AddAssert("no miss judgements recorded", () => judgementResults.All(r => r.Type.IsHit()));
+        }
+
         private void assertAllMaxJudgements()
         {
             AddAssert("All judgements max", () =>

From 3355764a68535facc627433f7c58d1040f3928e2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 18:21:44 +0800
Subject: [PATCH 227/930] "Fix" tests

---
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index 4011034396..487c12830f 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -6,6 +6,7 @@ using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Timing;
@@ -155,7 +156,7 @@ namespace osu.Game.Rulesets.UI
             //
             // It basically says that "while we're running in frame stable mode, and don't have a replay attached,
             // time should never go backwards". If it does, we stop running gameplay until it returns to normal.
-            if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime)
+            if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !DebugUtils.IsNUnitRunning)
             {
                 state = PlaybackState.NotValid;
                 return;

From 3a780e2b676eee99f0b0e845c12348977df22695 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 18:27:28 +0800
Subject: [PATCH 228/930] Add logging when workaround is hit

---
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index 487c12830f..03f3b8788f 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -9,6 +9,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Logging;
 using osu.Framework.Timing;
 using osu.Game.Input.Handlers;
 using osu.Game.Screens.Play;
@@ -158,6 +159,7 @@ namespace osu.Game.Rulesets.UI
             // time should never go backwards". If it does, we stop running gameplay until it returns to normal.
             if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !DebugUtils.IsNUnitRunning)
             {
+                Logger.Log($"Denying backwards seek during gameplay (reference: {referenceClock.CurrentTime:N2} stable: {proposedTime:N2})");
                 state = PlaybackState.NotValid;
                 return;
             }

From d05b31933fabb30da23e90cad95f3ea91ac40e48 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 29 Feb 2024 11:44:14 +0100
Subject: [PATCH 229/930] Fix slider tracking state not restoring correctly in
 all cases on rewind

---
 .../Objects/Drawables/SliderInputManager.cs   | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
index 148cf79337..58fa04bb4c 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
@@ -5,11 +5,13 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
+using osu.Game.Screens.Play;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Objects.Drawables
@@ -21,6 +23,11 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         /// </summary>
         public bool Tracking { get; private set; }
 
+        [Resolved]
+        private IGameplayClock? gameplayClock { get; set; }
+
+        private readonly Stack<(double time, bool tracking)> trackingHistory = new Stack<(double, bool)>();
+
         /// <summary>
         /// The point in time after which we can accept any key for tracking. Before this time, we may need to restrict tracking to the key used to hit the head circle.
         ///
@@ -208,6 +215,19 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         /// <param name="isValidTrackingPosition">Whether the current mouse position is valid to begin tracking.</param>
         private void updateTracking(bool isValidTrackingPosition)
         {
+            if (gameplayClock?.IsRewinding == true)
+            {
+                while (trackingHistory.TryPeek(out var historyEntry) && Time.Current < historyEntry.time)
+                    trackingHistory.Pop();
+
+                Debug.Assert(trackingHistory.Count > 0);
+
+                Tracking = trackingHistory.Peek().tracking;
+                return;
+            }
+
+            bool wasTracking = Tracking;
+
             // from the point at which the head circle is hit, this will be non-null.
             // it may be null if the head circle was missed.
             OsuAction? headCircleHitAction = getInitialHitAction();
@@ -247,6 +267,9 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 && isValidTrackingPosition
                 // valid action
                 && validTrackingAction;
+
+            if (wasTracking != Tracking)
+                trackingHistory.Push((Time.Current, Tracking));
         }
 
         private OsuAction? getInitialHitAction() => slider.HeadCircle?.HitAction;

From 1d1db951f08731604676bcca3c470a8416e23dce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 29 Feb 2024 11:54:42 +0100
Subject: [PATCH 230/930] Reset slider input manager state completely on new
 object application

Kind of scary this wasn't happening already.

Mirrors `SpinnerRotationTracker`.
---
 .../Objects/Drawables/SliderInputManager.cs   | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
index 58fa04bb4c..5daf8ed972 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
@@ -10,6 +10,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Screens.Play;
 using osuTK;
@@ -56,6 +57,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         public SliderInputManager(DrawableSlider slider)
         {
             this.slider = slider;
+            this.slider.HitObjectApplied += resetState;
         }
 
         /// <summary>
@@ -287,5 +289,22 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
 
             return action == OsuAction.LeftButton || action == OsuAction.RightButton;
         }
+
+        private void resetState(DrawableHitObject obj)
+        {
+            Tracking = false;
+            trackingHistory.Clear();
+            trackingHistory.Push((double.NegativeInfinity, false));
+            timeToAcceptAnyKeyAfter = null;
+            lastPressedActions.Clear();
+            screenSpaceMousePosition = null;
+        }
+
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            slider.HitObjectApplied -= resetState;
+        }
     }
 }

From 876b80642357996f90e8469cc25eb1e490f1f224 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 29 Feb 2024 12:11:50 +0100
Subject: [PATCH 231/930] Store tracking history to slider judgement result
 instead

---
 .../Judgements/OsuSliderJudgementResult.cs    | 20 +++++++++++++++++++
 .../Objects/Drawables/DrawableSlider.cs       |  6 ++++++
 .../Objects/Drawables/SliderInputManager.cs   |  7 ++-----
 3 files changed, 28 insertions(+), 5 deletions(-)
 create mode 100644 osu.Game.Rulesets.Osu/Judgements/OsuSliderJudgementResult.cs

diff --git a/osu.Game.Rulesets.Osu/Judgements/OsuSliderJudgementResult.cs b/osu.Game.Rulesets.Osu/Judgements/OsuSliderJudgementResult.cs
new file mode 100644
index 0000000000..f52294cdd7
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Judgements/OsuSliderJudgementResult.cs
@@ -0,0 +1,20 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Judgements;
+using osu.Game.Rulesets.Objects;
+
+namespace osu.Game.Rulesets.Osu.Judgements
+{
+    public class OsuSliderJudgementResult : OsuJudgementResult
+    {
+        public readonly Stack<(double time, bool tracking)> TrackingHistory = new Stack<(double, bool)>();
+
+        public OsuSliderJudgementResult(HitObject hitObject, Judgement judgement)
+            : base(hitObject, judgement)
+        {
+            TrackingHistory.Push((double.NegativeInfinity, false));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
index b7ce712e2c..e519e51562 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSlider.cs
@@ -14,8 +14,10 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Layout;
 using osu.Game.Audio;
 using osu.Game.Graphics.Containers;
+using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
+using osu.Game.Rulesets.Osu.Judgements;
 using osu.Game.Rulesets.Osu.Skinning.Default;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Skinning;
@@ -27,6 +29,8 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
     {
         public new Slider HitObject => (Slider)base.HitObject;
 
+        public new OsuSliderJudgementResult Result => (OsuSliderJudgementResult)base.Result;
+
         public DrawableSliderHead HeadCircle => headContainer.Child;
         public DrawableSliderTail TailCircle => tailContainer.Child;
 
@@ -134,6 +138,8 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             }, true);
         }
 
+        protected override JudgementResult CreateResult(Judgement judgement) => new OsuSliderJudgementResult(HitObject, judgement);
+
         protected override void OnApply()
         {
             base.OnApply();
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
index 5daf8ed972..c75ae35a1a 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/SliderInputManager.cs
@@ -27,8 +27,6 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         [Resolved]
         private IGameplayClock? gameplayClock { get; set; }
 
-        private readonly Stack<(double time, bool tracking)> trackingHistory = new Stack<(double, bool)>();
-
         /// <summary>
         /// The point in time after which we can accept any key for tracking. Before this time, we may need to restrict tracking to the key used to hit the head circle.
         ///
@@ -219,6 +217,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         {
             if (gameplayClock?.IsRewinding == true)
             {
+                var trackingHistory = slider.Result.TrackingHistory;
                 while (trackingHistory.TryPeek(out var historyEntry) && Time.Current < historyEntry.time)
                     trackingHistory.Pop();
 
@@ -271,7 +270,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 && validTrackingAction;
 
             if (wasTracking != Tracking)
-                trackingHistory.Push((Time.Current, Tracking));
+                slider.Result.TrackingHistory.Push((Time.Current, Tracking));
         }
 
         private OsuAction? getInitialHitAction() => slider.HeadCircle?.HitAction;
@@ -293,8 +292,6 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
         private void resetState(DrawableHitObject obj)
         {
             Tracking = false;
-            trackingHistory.Clear();
-            trackingHistory.Push((double.NegativeInfinity, false));
             timeToAcceptAnyKeyAfter = null;
             lastPressedActions.Clear();
             screenSpaceMousePosition = null;

From a11e63b184acc5030e3d167f13d85a3691f0b7dc Mon Sep 17 00:00:00 2001
From: Huo Yaoyuan <huoyaoyuan@hotmail.com>
Date: Thu, 29 Feb 2024 20:02:04 +0800
Subject: [PATCH 232/930] Make the code more clear

---
 .../Objects/Legacy/ConvertHitObjectParser.cs  | 42 ++++++++++++-------
 1 file changed, 26 insertions(+), 16 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index db1fbe3fa4..2b058d5e1f 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -265,49 +265,59 @@ namespace osu.Game.Rulesets.Objects.Legacy
         private PathControlPoint[] convertPathString(string pointString, Vector2 offset)
         {
             // This code takes on the responsibility of handling explicit segments of the path ("X" & "Y" from above). Implicit segments are handled by calls to convertPoints().
-            string[] pointSplit = pointString.Split('|');
+            string[] pointStringSplit = pointString.Split('|');
 
-            var points = ArrayPool<Vector2>.Shared.Rent(pointSplit.Length);
-            var segments = ArrayPool<(PathType Type, int StartIndex)>.Shared.Rent(pointSplit.Length);
-            int pointsCount = 0;
-            int segmentsCount = 0;
+            var pointsBuffer = ArrayPool<Vector2>.Shared.Rent(pointStringSplit.Length);
+            var segmentsBuffer = ArrayPool<(PathType Type, int StartIndex)>.Shared.Rent(pointStringSplit.Length);
+            int currentPointsIndex = 0;
+            int currentSegmentsIndex = 0;
 
             try
             {
-                foreach (string s in pointSplit)
+                foreach (string s in pointStringSplit)
                 {
                     if (char.IsLetter(s[0]))
                     {
                         // The start of a new segment(indicated by having an alpha character at position 0).
                         var pathType = convertPathType(s);
-                        segments[segmentsCount++] = (pathType, pointsCount);
+                        segmentsBuffer[currentSegmentsIndex++] = (pathType, currentPointsIndex);
 
                         // First segment is prepended by an extra zero point
-                        if (pointsCount == 0)
-                            points[pointsCount++] = Vector2.Zero;
+                        if (currentPointsIndex == 0)
+                            pointsBuffer[currentPointsIndex++] = Vector2.Zero;
                     }
                     else
                     {
-                        points[pointsCount++] = readPoint(s, offset);
+                        pointsBuffer[currentPointsIndex++] = readPoint(s, offset);
                     }
                 }
 
+                int pointsCount = currentPointsIndex;
+                int segmentsCount = currentSegmentsIndex;
                 var controlPoints = new List<ArraySegment<PathControlPoint>>(pointsCount);
+                var allPoints = new ArraySegment<Vector2>(pointsBuffer, 0, pointsCount);
 
                 for (int i = 0; i < segmentsCount; i++)
                 {
-                    int startIndex = segments[i].StartIndex;
-                    int endIndex = i < segmentsCount - 1 ? segments[i + 1].StartIndex : pointsCount;
-                    Vector2? endPoint = i < segmentsCount - 1 ? points[endIndex] : null;
-                    controlPoints.AddRange(convertPoints(segments[i].Type, new ArraySegment<Vector2>(points, startIndex, endIndex - startIndex), endPoint));
+                    if (i < segmentsCount - 1)
+                    {
+                        int startIndex = segmentsBuffer[i].StartIndex;
+                        int endIndex = segmentsBuffer[i + 1].StartIndex;
+                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints[startIndex..endIndex], pointsBuffer[endIndex]));
+                    }
+                    else
+                    {
+                        int startIndex = segmentsBuffer[i].StartIndex;
+                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints[startIndex..], null));
+                    }
                 }
 
                 return mergePointsLists(controlPoints);
             }
             finally
             {
-                ArrayPool<Vector2>.Shared.Return(points);
-                ArrayPool<(PathType Type, int StartIndex)>.Shared.Return(segments);
+                ArrayPool<Vector2>.Shared.Return(pointsBuffer);
+                ArrayPool<(PathType, int)>.Shared.Return(segmentsBuffer);
             }
 
             static Vector2 readPoint(string value, Vector2 startPos)

From 4184a5c1ef380318dae27492c0f68c4ba211aa0e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 20:34:38 +0800
Subject: [PATCH 233/930] Add flag to allow backwards seeks in tests

---
 .../TestSceneTimingBasedNoteColouring.cs      | 21 ++++++++++++-------
 .../NonVisual/FirstAvailableHitWindowsTest.cs |  1 +
 .../TestSceneCompletionCancellation.cs        |  2 ++
 .../TestSceneFrameStabilityContainer.cs       |  3 +++
 .../TestSceneGameplaySamplePlayback.cs        |  2 ++
 .../TestSceneGameplaySampleTriggerSource.cs   |  2 ++
 .../Visual/Gameplay/TestSceneHitErrorMeter.cs |  1 +
 .../Gameplay/TestScenePoolingRuleset.cs       |  1 +
 .../Gameplay/TestSceneStoryboardWithOutro.cs  |  2 ++
 osu.Game/Rulesets/UI/DrawableRuleset.cs       | 20 ++++++++++++++++++
 .../Rulesets/UI/FrameStabilityContainer.cs    |  5 +++--
 osu.Game/Tests/Visual/PlayerTestScene.cs      | 12 ++++++++++-
 12 files changed, 61 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
index 81557c198d..b5b265792b 100644
--- a/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneTimingBasedNoteColouring.cs
@@ -34,16 +34,21 @@ namespace osu.Game.Rulesets.Mania.Tests
         [SetUpSteps]
         public void SetUpSteps()
         {
-            AddStep("setup hierarchy", () => Child = new Container
+            AddStep("setup hierarchy", () =>
             {
-                Clock = new FramedClock(clock = new ManualClock()),
-                RelativeSizeAxes = Axes.Both,
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Children = new[]
+                Child = new Container
                 {
-                    drawableRuleset = (DrawableManiaRuleset)Ruleset.Value.CreateInstance().CreateDrawableRulesetWith(createTestBeatmap())
-                }
+                    Clock = new FramedClock(clock = new ManualClock()),
+                    RelativeSizeAxes = Axes.Both,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Children = new[]
+                    {
+                        drawableRuleset = (DrawableManiaRuleset)Ruleset.Value.CreateInstance().CreateDrawableRulesetWith(createTestBeatmap())
+                    }
+                };
+
+                drawableRuleset.AllowBackwardsSeeks = true;
             });
             AddStep("retrieve config bindable", () =>
             {
diff --git a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
index 0bdd0ceae6..d4b69c1be2 100644
--- a/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
+++ b/osu.Game.Tests/NonVisual/FirstAvailableHitWindowsTest.cs
@@ -100,6 +100,7 @@ namespace osu.Game.Tests.NonVisual
             public override Container FrameStableComponents { get; }
             public override IFrameStableClock FrameStableClock { get; }
             internal override bool FrameStablePlayback { get; set; }
+            public override bool AllowBackwardsSeeks { get; set; }
             public override IReadOnlyList<Mod> Mods { get; }
 
             public override double GameplayStartTime { get; }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs
index 434d853992..f19f4b6690 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneCompletionCancellation.cs
@@ -29,6 +29,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         protected override bool AllowFail => false;
 
+        protected override bool AllowBackwardsSeeks => true;
+
         [SetUpSteps]
         public override void SetUpSteps()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
index 98a97e1d23..0cff675b28 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
@@ -131,6 +131,9 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private void createStabilityContainer(double gameplayStartTime = double.MinValue) => AddStep("create container", () =>
             mainContainer.Child = new FrameStabilityContainer(gameplayStartTime)
+                {
+                    AllowBackwardsSeeks = true,
+                }
                 .WithChild(consumer = new ClockConsumingChild()));
 
         private void seekManualTo(double time) => AddStep($"seek manual clock to {time}", () => manualClock.CurrentTime = time);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
index 3d35860fef..057197e819 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
@@ -16,6 +16,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public partial class TestSceneGameplaySamplePlayback : PlayerTestScene
     {
+        protected override bool AllowBackwardsSeeks => true;
+
         [Test]
         public void TestAllSamplesStopDuringSeek()
         {
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
index 3cbd5eefac..6981591193 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySampleTriggerSource.cs
@@ -28,6 +28,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 {
     public partial class TestSceneGameplaySampleTriggerSource : PlayerTestScene
     {
+        protected override bool AllowBackwardsSeeks => true;
+
         private TestGameplaySampleTriggerSource sampleTriggerSource = null!;
         protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
index 56900a0549..e57177498d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneHitErrorMeter.cs
@@ -288,6 +288,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             public override Container FrameStableComponents { get; }
             public override IFrameStableClock FrameStableClock { get; }
             internal override bool FrameStablePlayback { get; set; }
+            public override bool AllowBackwardsSeeks { get; set; }
             public override IReadOnlyList<Mod> Mods { get; }
 
             public override double GameplayStartTime { get; }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
index b567e8de8d..88effb4a7b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePoolingRuleset.cs
@@ -269,6 +269,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
                 drawableRuleset = (TestDrawablePoolingRuleset)ruleset.CreateDrawableRulesetWith(CreateWorkingBeatmap(beatmap).GetPlayableBeatmap(ruleset.RulesetInfo));
                 drawableRuleset.FrameStablePlayback = true;
+                drawableRuleset.AllowBackwardsSeeks = true;
                 drawableRuleset.PoolSize = poolSize;
 
                 Child = new Container
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 98825b27d4..f532921d63 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -31,6 +31,8 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         protected override bool HasCustomSteps => true;
 
+        protected override bool AllowBackwardsSeeks => true;
+
         protected new OutroPlayer Player => (OutroPlayer)base.Player;
 
         private double currentBeatmapDuration;
diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 4aeb3d4862..13e28279e6 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -81,6 +81,19 @@ namespace osu.Game.Rulesets.UI
 
         public override IFrameStableClock FrameStableClock => frameStabilityContainer;
 
+        private bool allowBackwardsSeeks;
+
+        public override bool AllowBackwardsSeeks
+        {
+            get => allowBackwardsSeeks;
+            set
+            {
+                allowBackwardsSeeks = value;
+                if (frameStabilityContainer != null)
+                    frameStabilityContainer.AllowBackwardsSeeks = value;
+            }
+        }
+
         private bool frameStablePlayback = true;
 
         internal override bool FrameStablePlayback
@@ -178,6 +191,7 @@ namespace osu.Game.Rulesets.UI
             InternalChild = frameStabilityContainer = new FrameStabilityContainer(GameplayStartTime)
             {
                 FrameStablePlayback = FrameStablePlayback,
+                AllowBackwardsSeeks = AllowBackwardsSeeks,
                 Children = new Drawable[]
                 {
                     FrameStableComponents,
@@ -463,6 +477,12 @@ namespace osu.Game.Rulesets.UI
         /// </summary>
         internal abstract bool FrameStablePlayback { get; set; }
 
+        /// <summary>
+        /// When a replay is not attached, we usually block any backwards seeks.
+        /// This will bypass the check. Should only be used for tests.
+        /// </summary>
+        public abstract bool AllowBackwardsSeeks { get; set; }
+
         /// <summary>
         /// The mods which are to be applied.
         /// </summary>
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index 03f3b8788f..ab48711955 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -6,7 +6,6 @@ using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
-using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
@@ -26,6 +25,8 @@ namespace osu.Game.Rulesets.UI
     {
         public ReplayInputHandler? ReplayInputHandler { get; set; }
 
+        public bool AllowBackwardsSeeks { get; set; }
+
         /// <summary>
         /// The number of CPU milliseconds to spend at most during seek catch-up.
         /// </summary>
@@ -157,7 +158,7 @@ namespace osu.Game.Rulesets.UI
             //
             // It basically says that "while we're running in frame stable mode, and don't have a replay attached,
             // time should never go backwards". If it does, we stop running gameplay until it returns to normal.
-            if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !DebugUtils.IsNUnitRunning)
+            if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !AllowBackwardsSeeks)
             {
                 Logger.Log($"Denying backwards seek during gameplay (reference: {referenceClock.CurrentTime:N2} stable: {proposedTime:N2})");
                 state = PlaybackState.NotValid;
diff --git a/osu.Game/Tests/Visual/PlayerTestScene.cs b/osu.Game/Tests/Visual/PlayerTestScene.cs
index ee184c1f35..43d779261c 100644
--- a/osu.Game/Tests/Visual/PlayerTestScene.cs
+++ b/osu.Game/Tests/Visual/PlayerTestScene.cs
@@ -70,10 +70,20 @@ namespace osu.Game.Tests.Visual
 
             AddStep($"Load player for {CreatePlayerRuleset().Description}", LoadPlayer);
             AddUntilStep("player loaded", () => Player.IsLoaded && Player.Alpha == 1);
+
+            if (AllowBackwardsSeeks)
+            {
+                AddStep("allow backwards seeking", () =>
+                {
+                    Player.DrawableRuleset.AllowBackwardsSeeks = AllowBackwardsSeeks;
+                });
+            }
         }
 
         protected virtual bool AllowFail => false;
 
+        protected virtual bool AllowBackwardsSeeks => false;
+
         protected virtual bool Autoplay => false;
 
         protected void LoadPlayer() => LoadPlayer(Array.Empty<Mod>());
@@ -126,6 +136,6 @@ namespace osu.Game.Tests.Visual
 
         protected sealed override Ruleset CreateRuleset() => CreatePlayerRuleset();
 
-        protected virtual TestPlayer CreatePlayer(Ruleset ruleset) => new TestPlayer(false, false);
+        protected virtual TestPlayer CreatePlayer(Ruleset ruleset) => new TestPlayer(false, false, AllowBackwardsSeeks);
     }
 }

From cc8b838bd45d5df2be723b6cb1ddd82bec5622b8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 23:03:27 +0800
Subject: [PATCH 234/930] Add comprehensive log output to help figure out
 problematic clocks

---
 osu.Game/Beatmaps/FramedBeatmapClock.cs       | 26 ++++++++++++++++++-
 .../Rulesets/UI/FrameStabilityContainer.cs    |  7 +++++
 2 files changed, 32 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/FramedBeatmapClock.cs b/osu.Game/Beatmaps/FramedBeatmapClock.cs
index 49dff96ff1..af7be235fc 100644
--- a/osu.Game/Beatmaps/FramedBeatmapClock.cs
+++ b/osu.Game/Beatmaps/FramedBeatmapClock.cs
@@ -38,6 +38,7 @@ namespace osu.Game.Beatmaps
         private IDisposable? beatmapOffsetSubscription;
 
         private readonly DecouplingFramedClock decoupledTrack;
+        private readonly InterpolatingFramedClock interpolatedTrack;
 
         [Resolved]
         private OsuConfigManager config { get; set; } = null!;
@@ -58,7 +59,7 @@ namespace osu.Game.Beatmaps
 
             // An interpolating clock is used to ensure precise time values even when the host audio subsystem is not reporting
             // high precision times (on windows there's generally only 5-10ms reporting intervals, as an example).
-            var interpolatedTrack = new InterpolatingFramedClock(decoupledTrack);
+            interpolatedTrack = new InterpolatingFramedClock(decoupledTrack);
 
             if (applyOffsets)
             {
@@ -190,5 +191,28 @@ namespace osu.Game.Beatmaps
             base.Dispose(isDisposing);
             beatmapOffsetSubscription?.Dispose();
         }
+
+        public string GetSnapshot()
+        {
+            return
+                $"originalSource: {output(Source)}\n" +
+                $"userGlobalOffsetClock: {output(userGlobalOffsetClock)}\n" +
+                $"platformOffsetClock: {output(platformOffsetClock)}\n" +
+                $"userBeatmapOffsetClock: {output(userBeatmapOffsetClock)}\n" +
+                $"interpolatedTrack: {output(interpolatedTrack)}\n" +
+                $"decoupledTrack: {output(decoupledTrack)}\n" +
+                $"finalClockSource: {output(finalClockSource)}\n";
+
+            string output(IClock? clock)
+            {
+                if (clock == null)
+                    return "null";
+
+                if (clock is IFrameBasedClock framed)
+                    return $"current: {clock.CurrentTime:N2} running: {clock.IsRunning} rate: {clock.Rate} elapsed: {framed.ElapsedFrameTime:N2}";
+
+                return $"current: {clock.CurrentTime:N2} running: {clock.IsRunning} rate: {clock.Rate}";
+            }
+        }
     }
 }
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index ab48711955..c09018e8ca 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -3,13 +3,16 @@
 
 using System;
 using System.Diagnostics;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Logging;
+using osu.Framework.Testing;
 using osu.Framework.Timing;
+using osu.Game.Beatmaps;
 using osu.Game.Input.Handlers;
 using osu.Game.Screens.Play;
 
@@ -161,6 +164,10 @@ namespace osu.Game.Rulesets.UI
             if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !AllowBackwardsSeeks)
             {
                 Logger.Log($"Denying backwards seek during gameplay (reference: {referenceClock.CurrentTime:N2} stable: {proposedTime:N2})");
+
+                if (parentGameplayClock is GameplayClockContainer gcc)
+                    Logger.Log($"{gcc.ChildrenOfType<FramedBeatmapClock>().Single().GetSnapshot()}");
+
                 state = PlaybackState.NotValid;
                 return;
             }

From 59b9d29a79c2520cda4b1fca7d2b8373e501c71d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 29 Feb 2024 23:29:50 +0800
Subject: [PATCH 235/930] Fix formatting?

---
 .../Visual/Gameplay/TestSceneFrameStabilityContainer.cs  | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
index 0cff675b28..c2999e3f5a 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneFrameStabilityContainer.cs
@@ -130,11 +130,12 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         private void createStabilityContainer(double gameplayStartTime = double.MinValue) => AddStep("create container", () =>
+        {
             mainContainer.Child = new FrameStabilityContainer(gameplayStartTime)
-                {
-                    AllowBackwardsSeeks = true,
-                }
-                .WithChild(consumer = new ClockConsumingChild()));
+            {
+                AllowBackwardsSeeks = true,
+            }.WithChild(consumer = new ClockConsumingChild());
+        });
 
         private void seekManualTo(double time) => AddStep($"seek manual clock to {time}", () => manualClock.CurrentTime = time);
 

From eb0933c3a5aa2de47820d020d34cabaf7552e7e6 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Thu, 29 Feb 2024 20:35:20 +0300
Subject: [PATCH 236/930] Fix allocations in EffectPointVisualisation

---
 .../Summary/Parts/EffectPointVisualisation.cs      | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
index d92beba38a..bf87470e01 100644
--- a/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
+++ b/osu.Game/Screens/Edit/Components/Timelines/Summary/Parts/EffectPointVisualisation.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
@@ -53,7 +52,18 @@ namespace osu.Game.Screens.Edit.Components.Timelines.Summary.Parts
             // for changes. ControlPointInfo needs a refactor to make this flow better, but it should do for now.
             Scheduler.AddDelayed(() =>
             {
-                var next = beatmap.ControlPointInfo.EffectPoints.FirstOrDefault(c => c.Time > effect.Time);
+                EffectControlPoint? next = null;
+
+                for (int i = 0; i < beatmap.ControlPointInfo.EffectPoints.Count; i++)
+                {
+                    var point = beatmap.ControlPointInfo.EffectPoints[i];
+
+                    if (point.Time > effect.Time)
+                    {
+                        next = point;
+                        break;
+                    }
+                }
 
                 if (!ReferenceEquals(nextControlPoint, next))
                 {

From 61cc5d6f29606c3513f6c5b699849ef155be2f1f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Mar 2024 11:24:12 +0800
Subject: [PATCH 237/930] Fix typos in xmldoc

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index c784d52a4f..181403d287 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -180,7 +180,7 @@ namespace osu.Desktop.Windows
             private string programId => $@"{program_id_prefix}{Extension}";
 
             /// <summary>
-            /// Installs a file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
+            /// Installs a file extension association in accordance with https://learn.microsoft.com/en-us/windows/win32/com/-progid--key
             /// </summary>
             public void Install()
             {
@@ -219,7 +219,7 @@ namespace osu.Desktop.Windows
             }
 
             /// <summary>
-            /// Uninstalls the file extenstion association in accordance with https://learn.microsoft.com/en-us/windows/win32/shell/fa-file-types#deleting-registry-information-during-uninstallation
+            /// Uninstalls the file extension association in accordance with https://learn.microsoft.com/en-us/windows/win32/shell/fa-file-types#deleting-registry-information-during-uninstallation
             /// </summary>
             public void Uninstall()
             {

From 00527da27d97ceba51f6d8bd46f4ec94542916a5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Mar 2024 11:42:35 +0800
Subject: [PATCH 238/930] When discord is set to privacy mode, don't show
 beatmap being edited

---
 osu.Game/Users/UserActivity.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 1b09666df6..404ed141b9 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -151,7 +151,11 @@ namespace osu.Game.Users
             public EditingBeatmap() { }
 
             public override string GetStatus(bool hideIdentifiableInformation = false) => @"Editing a beatmap";
-            public override string GetDetails(bool hideIdentifiableInformation = false) => BeatmapDisplayTitle;
+
+            public override string GetDetails(bool hideIdentifiableInformation = false) => hideIdentifiableInformation
+                // For now let's assume that showing the beatmap a user is editing could reveal unwanted information.
+                ? string.Empty
+                : BeatmapDisplayTitle;
         }
 
         [MessagePackObject]

From 4ad8bbb9e2d17c6c35fb26f37004c077af87dddf Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Fri, 1 Mar 2024 13:20:37 +0900
Subject: [PATCH 239/930] remove useless DrawablePool

---
 osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
index 0f2f9dc323..8bb5ee3617 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/ColourHitErrorMeter.cs
@@ -107,8 +107,6 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                 JudgementSpacing.BindValueChanged(_ => updateMetrics(), true);
             }
 
-            private readonly DrawablePool<HitErrorShape> judgementLinePool = new DrawablePool<HitErrorShape>(50);
-
             public void Push(HitErrorShape shape)
             {
                 Add(shape);

From 19ed78eef57828c1da4210e5796bd5e7b7fcdb48 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Mar 2024 12:34:21 +0800
Subject: [PATCH 240/930] Log backwards seeks to sentry

---
 osu.Game/OsuGame.cs                           |  3 +++
 .../Rulesets/UI/FrameStabilityContainer.cs    | 15 ++++++++++---
 .../Utils/SentryOnlyDiagnosticsException.cs   | 21 +++++++++++++++++++
 3 files changed, 36 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Utils/SentryOnlyDiagnosticsException.cs

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 7d128a808a..eb1219f183 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -1190,6 +1190,9 @@ namespace osu.Game
             {
                 if (entry.Level < LogLevel.Important || entry.Target > LoggingTarget.Database || entry.Target == null) return;
 
+                if (entry.Exception is SentryOnlyDiagnosticsException)
+                    return;
+
                 const int short_term_display_limit = 3;
 
                 if (recentLogCount < short_term_display_limit)
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index c09018e8ca..884310e44c 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -15,6 +15,7 @@ using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Input.Handlers;
 using osu.Game.Screens.Play;
+using osu.Game.Utils;
 
 namespace osu.Game.Rulesets.UI
 {
@@ -29,6 +30,7 @@ namespace osu.Game.Rulesets.UI
         public ReplayInputHandler? ReplayInputHandler { get; set; }
 
         public bool AllowBackwardsSeeks { get; set; }
+        private double? lastBackwardsSeekLogTime;
 
         /// <summary>
         /// The number of CPU milliseconds to spend at most during seek catch-up.
@@ -163,10 +165,17 @@ namespace osu.Game.Rulesets.UI
             // time should never go backwards". If it does, we stop running gameplay until it returns to normal.
             if (!hasReplayAttached && FrameStablePlayback && proposedTime > referenceClock.CurrentTime && !AllowBackwardsSeeks)
             {
-                Logger.Log($"Denying backwards seek during gameplay (reference: {referenceClock.CurrentTime:N2} stable: {proposedTime:N2})");
+                if (lastBackwardsSeekLogTime == null || Math.Abs(Clock.CurrentTime - lastBackwardsSeekLogTime.Value) > 1000)
+                {
+                    lastBackwardsSeekLogTime = Clock.CurrentTime;
 
-                if (parentGameplayClock is GameplayClockContainer gcc)
-                    Logger.Log($"{gcc.ChildrenOfType<FramedBeatmapClock>().Single().GetSnapshot()}");
+                    string loggableContent = $"Denying backwards seek during gameplay (reference: {referenceClock.CurrentTime:N2} stable: {proposedTime:N2})";
+
+                    if (parentGameplayClock is GameplayClockContainer gcc)
+                        loggableContent += $"\n{gcc.ChildrenOfType<FramedBeatmapClock>().Single().GetSnapshot()}";
+
+                    Logger.Error(new SentryOnlyDiagnosticsException("backwards seek"), loggableContent);
+                }
 
                 state = PlaybackState.NotValid;
                 return;
diff --git a/osu.Game/Utils/SentryOnlyDiagnosticsException.cs b/osu.Game/Utils/SentryOnlyDiagnosticsException.cs
new file mode 100644
index 0000000000..1659b8a213
--- /dev/null
+++ b/osu.Game/Utils/SentryOnlyDiagnosticsException.cs
@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+
+namespace osu.Game.Utils
+{
+    /// <summary>
+    /// Log to sentry without showing an error notification to the user.
+    /// </summary>
+    /// <remarks>
+    /// This can be used to convey important diagnostics to us developers without
+    /// getting in the user's way. Should be used sparingly.</remarks>
+    internal class SentryOnlyDiagnosticsException : Exception
+    {
+        public SentryOnlyDiagnosticsException(string message)
+            : base(message)
+        {
+        }
+    }
+}

From 060e17e9898256128632ab1a524ab33c87d0b9c2 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Thu, 29 Feb 2024 19:57:32 -0500
Subject: [PATCH 241/930] Support Discord game invites in multiplayer lobbies

---
 osu.Desktop/DiscordRichPresence.cs | 83 +++++++++++++++++++++++++++++-
 1 file changed, 81 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index f0da708766..b85abdb4fe 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -9,10 +9,13 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
+using osu.Game;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Multiplayer;
+using osu.Game.Online.Rooms;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using LogLevel = osu.Framework.Logging.LogLevel;
@@ -22,6 +25,7 @@ namespace osu.Desktop
     internal partial class DiscordRichPresence : Component
     {
         private const string client_id = "367827983903490050";
+        public const string DISCORD_PROTOCOL = $"discord-{client_id}://";
 
         private DiscordRpcClient client = null!;
 
@@ -33,6 +37,12 @@ namespace osu.Desktop
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
+        [Resolved]
+        private OsuGame game { get; set; } = null!;
+
+        [Resolved]
+        private MultiplayerClient multiplayerClient { get; set; } = null!;
+
         private readonly IBindable<UserStatus?> status = new Bindable<UserStatus?>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
 
@@ -40,7 +50,12 @@ namespace osu.Desktop
 
         private readonly RichPresence presence = new RichPresence
         {
-            Assets = new Assets { LargeImageKey = "osu_logo_lazer", }
+            Assets = new Assets { LargeImageKey = "osu_logo_lazer" },
+            Secrets = new Secrets
+            {
+                JoinSecret = null,
+                SpectateSecret = null,
+            },
         };
 
         [BackgroundDependencyLoader]
@@ -52,8 +67,14 @@ namespace osu.Desktop
             };
 
             client.OnReady += onReady;
+            client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Code} {e.Message}", LoggingTarget.Network, LogLevel.Error);
 
-            client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Code} {e.Message}", LoggingTarget.Network);
+            // set up stuff for spectate/join
+            // first, we register a uri scheme for when osu! isn't running and a user clicks join/spectate
+            // the rpc library we use also happens to _require_ that we do this
+            client.RegisterUriScheme();
+            client.Subscribe(EventType.Join); // we have to explicitly tell discord to send us join events.
+            client.OnJoin += onJoin;
 
             config.BindWith(OsuSetting.DiscordRichPresence, privacyMode);
 
@@ -114,6 +135,28 @@ namespace osu.Desktop
                 {
                     presence.Buttons = null;
                 }
+
+                if (!hideIdentifiableInformation && multiplayerClient.Room != null)
+                {
+                    MultiplayerRoom room = multiplayerClient.Room;
+                    presence.Party = new Party
+                    {
+                        Privacy = string.IsNullOrEmpty(room.Settings.Password) ? Party.PrivacySetting.Public : Party.PrivacySetting.Private,
+                        ID = room.RoomID.ToString(),
+                        // technically lobbies can have infinite users, but Discord needs this to be set to something.
+                        // 1024 just happens to look nice.
+                        // https://discord.com/channels/188630481301012481/188630652340404224/1212967974793642034
+                        Max = 1024,
+                        Size = room.Users.Count,
+                    };
+
+                    presence.Secrets.JoinSecret = $"{room.RoomID}:{room.Settings.Password}";
+                }
+                else
+                {
+                    presence.Party = null;
+                    presence.Secrets.JoinSecret = null;
+                }
             }
             else
             {
@@ -139,6 +182,22 @@ namespace osu.Desktop
             client.SetPresence(presence);
         }
 
+        private void onJoin(object sender, JoinMessage args)
+        {
+            game.Window?.Raise(); // users will expect to be brought back to osu! when joining a lobby from discord
+
+            if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
+                Logger.Log("Failed to parse the room secret Discord gave us", LoggingTarget.Network, LogLevel.Error);
+
+            var request = new GetRoomRequest(roomId);
+            request.Success += room => Schedule(() =>
+            {
+                game.PresentMultiplayerMatch(room, password);
+            });
+            request.Failure += _ => Logger.Log("Couldn't find the room Discord gave us", LoggingTarget.Network, LogLevel.Error);
+            api.Queue(request);
+        }
+
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
         private string truncate(string str)
@@ -160,6 +219,26 @@ namespace osu.Desktop
             });
         }
 
+        private static bool tryParseRoomSecret(ReadOnlySpan<char> secret, out long roomId, out string? password)
+        {
+            roomId = 0;
+            password = null;
+
+            int roomSecretSplitIndex = secret.IndexOf(':');
+
+            if (roomSecretSplitIndex == -1)
+                return false;
+
+            if (!long.TryParse(secret[..roomSecretSplitIndex], out roomId))
+                return false;
+
+            // just convert to string here, we're going to have to alloc it later anyways
+            password = secret[(roomSecretSplitIndex + 1)..].ToString();
+            if (password.Length == 0) password = null;
+
+            return true;
+        }
+
         private int? getBeatmapID(UserActivity activity)
         {
             switch (activity)

From 92235e7789271da1080f6f8f635e52f5f8490002 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Fri, 1 Mar 2024 00:02:20 -0500
Subject: [PATCH 242/930] Make truncate and getBeatmapID static

Code quality was complaining about hidden variables so I opted for this solution.
---
 osu.Desktop/DiscordRichPresence.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index b85abdb4fe..91f7f6e1da 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -200,7 +200,7 @@ namespace osu.Desktop
 
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
-        private string truncate(string str)
+        private static string truncate(string str)
         {
             if (Encoding.UTF8.GetByteCount(str) <= 128)
                 return str;
@@ -239,7 +239,7 @@ namespace osu.Desktop
             return true;
         }
 
-        private int? getBeatmapID(UserActivity activity)
+        private static int? getBeatmapID(UserActivity activity)
         {
             switch (activity)
             {

From 963c0af8143654e20910ed4f6b48ebce5845ad4e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Mar 2024 16:43:47 +0800
Subject: [PATCH 243/930] Fix beatmap information still showing when testing a
 beatmap

---
 osu.Game/Users/UserActivity.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index 404ed141b9..a5dd2cb37c 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -119,10 +119,10 @@ namespace osu.Game.Users
         }
 
         [MessagePackObject]
-        public class TestingBeatmap : InGame
+        public class TestingBeatmap : EditingBeatmap
         {
             public TestingBeatmap(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
-                : base(beatmapInfo, ruleset)
+                : base(beatmapInfo)
             {
             }
 

From c6201ea5de4bc0ad9943fd5e5f83783e6172205d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 1 Mar 2024 20:28:52 +0800
Subject: [PATCH 244/930] Remove unused ruleset parameter when testing beatmap
 in editor

---
 osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs | 3 +--
 osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs | 2 +-
 osu.Game/Users/UserActivity.cs                     | 2 +-
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
index 4df34e6244..91942c391a 100644
--- a/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
+++ b/osu.Game.Tests/Visual/Online/TestSceneUserPanel.cs
@@ -14,7 +14,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Game.Rulesets;
-using osu.Game.Rulesets.Osu;
 using osu.Game.Scoring;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Users;
@@ -142,7 +141,7 @@ namespace osu.Game.Tests.Visual.Online
             AddStep("choosing", () => activity.Value = new UserActivity.ChoosingBeatmap());
             AddStep("editing beatmap", () => activity.Value = new UserActivity.EditingBeatmap(new BeatmapInfo()));
             AddStep("modding beatmap", () => activity.Value = new UserActivity.ModdingBeatmap(new BeatmapInfo()));
-            AddStep("testing beatmap", () => activity.Value = new UserActivity.TestingBeatmap(new BeatmapInfo(), new OsuRuleset().RulesetInfo));
+            AddStep("testing beatmap", () => activity.Value = new UserActivity.TestingBeatmap(new BeatmapInfo()));
         }
 
         [Test]
diff --git a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
index 7dff05667d..55607cbb7c 100644
--- a/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
+++ b/osu.Game/Screens/Edit/GameplayTest/EditorPlayer.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Screens.Edit.GameplayTest
         private readonly Editor editor;
         private readonly EditorState editorState;
 
-        protected override UserActivity InitialActivity => new UserActivity.TestingBeatmap(Beatmap.Value.BeatmapInfo, Ruleset.Value);
+        protected override UserActivity InitialActivity => new UserActivity.TestingBeatmap(Beatmap.Value.BeatmapInfo);
 
         [Resolved]
         private MusicController musicController { get; set; } = null!;
diff --git a/osu.Game/Users/UserActivity.cs b/osu.Game/Users/UserActivity.cs
index a5dd2cb37c..a431b204bc 100644
--- a/osu.Game/Users/UserActivity.cs
+++ b/osu.Game/Users/UserActivity.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Users
         [MessagePackObject]
         public class TestingBeatmap : EditingBeatmap
         {
-            public TestingBeatmap(IBeatmapInfo beatmapInfo, IRulesetInfo ruleset)
+            public TestingBeatmap(IBeatmapInfo beatmapInfo)
                 : base(beatmapInfo)
             {
             }

From 3df32638c2235029625d929c41ce6237c646e75c Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Fri, 1 Mar 2024 16:06:30 +0100
Subject: [PATCH 245/930] Fix association descriptions never being written on
 update

---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 181403d287..11b5c19ca1 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -82,6 +82,10 @@ namespace osu.Desktop.Windows
             try
             {
                 updateAssociations();
+
+                // TODO: Remove once UpdateDescriptions() is called as specified in the xmldoc.
+                updateDescriptions(null); // always write default descriptions, in case of updating from an older version in which file associations were not implemented/installed
+
                 NotifyShellUpdate();
             }
             catch (Exception e)

From 77b3055978bdd3b872d4297f1b70ba05f6164c05 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Thu, 29 Feb 2024 23:23:57 +0300
Subject: [PATCH 246/930] Improve sb sprite end time guessing

---
 osu.Game/Storyboards/CommandTimelineGroup.cs | 41 ++--------------
 osu.Game/Storyboards/StoryboardSprite.cs     | 50 ++++++++++++++++++--
 2 files changed, 50 insertions(+), 41 deletions(-)

diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index 0b96db6861..c899cf77d3 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Graphics;
@@ -46,32 +45,10 @@ namespace osu.Game.Storyboards
         }
 
         [JsonIgnore]
-        public double CommandsStartTime
-        {
-            get
-            {
-                double min = double.MaxValue;
-
-                for (int i = 0; i < timelines.Length; i++)
-                    min = Math.Min(min, timelines[i].StartTime);
-
-                return min;
-            }
-        }
+        public double CommandsStartTime => timelines.Min(static t => t.StartTime);
 
         [JsonIgnore]
-        public double CommandsEndTime
-        {
-            get
-            {
-                double max = double.MinValue;
-
-                for (int i = 0; i < timelines.Length; i++)
-                    max = Math.Max(max, timelines[i].EndTime);
-
-                return max;
-            }
-        }
+        public double CommandsEndTime => timelines.Max(static t => t.EndTime);
 
         [JsonIgnore]
         public double CommandsDuration => CommandsEndTime - CommandsStartTime;
@@ -83,19 +60,7 @@ namespace osu.Game.Storyboards
         public virtual double EndTime => CommandsEndTime;
 
         [JsonIgnore]
-        public bool HasCommands
-        {
-            get
-            {
-                for (int i = 0; i < timelines.Length; i++)
-                {
-                    if (timelines[i].HasCommands)
-                        return true;
-                }
-
-                return false;
-            }
-        }
+        public bool HasCommands => timelines.Any(static t => t.HasCommands);
 
         public virtual IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
         {
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 982185d51b..350438942e 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -85,12 +85,56 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                double latestEndTime = TimelineGroup.EndTime;
+                double latestEndTime = double.MaxValue;
+
+                // Ignore the whole setup if there are loops. In theory they can be handled here too, however the logic will be overly complex.
+                if (loops.Count == 0)
+                {
+                    // Here we are starting from maximum value and trying to minimise the end time on each step.
+                    // There are few solid guesses we can make using which sprite's end time can be minimised: alpha = 0, scale = 0, colour.a = 0.
+                    double[] deathTimes =
+                    {
+                        double.MaxValue, // alpha
+                        double.MaxValue, // colour alpha
+                        double.MaxValue, // scale
+                        double.MaxValue, // scale x
+                        double.MaxValue, // scale y
+                    };
+
+                    // The loops below are following the same pattern.
+                    // We could be using TimelineGroup.EndValue here, however it's possible to have multiple commands with 0 value in a row
+                    // so we are saving the earliest of them.
+                    foreach (var alphaCommand in TimelineGroup.Alpha.Commands)
+                    {
+                        deathTimes[0] = alphaCommand.EndValue == 0
+                            ? Math.Min(alphaCommand.EndTime, deathTimes[0]) // commands are ordered by the start time, however end time may vary. Save the earliest.
+                            : double.MaxValue; // If value isn't 0 (sprite becomes visible again), revert the saved state.
+                    }
+
+                    foreach (var colourCommand in TimelineGroup.Colour.Commands)
+                        deathTimes[1] = colourCommand.EndValue.A == 0 ? Math.Min(colourCommand.EndTime, deathTimes[1]) : double.MaxValue;
+
+                    foreach (var scaleCommand in TimelineGroup.Scale.Commands)
+                        deathTimes[2] = scaleCommand.EndValue == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[2]) : double.MaxValue;
+
+                    foreach (var scaleCommand in TimelineGroup.VectorScale.Commands)
+                    {
+                        deathTimes[3] = scaleCommand.EndValue.X == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[3]) : double.MaxValue;
+                        deathTimes[4] = scaleCommand.EndValue.Y == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[4]) : double.MaxValue;
+                    }
+
+                    // Take the minimum time of all the potential "death" reasons.
+                    latestEndTime = deathTimes.Min();
+                }
+
+                // If the logic above fails to find anything or discarded by the fact that there are loops present, latestEndTime will be double.MaxValue
+                // and thus conservativeEndTime will be used.
+                double conservativeEndTime = TimelineGroup.EndTime;
 
                 foreach (var l in loops)
-                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
+                    conservativeEndTime = Math.Max(conservativeEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
 
-                return latestEndTime;
+                return Math.Min(latestEndTime, conservativeEndTime);
             }
         }
 

From 37e7a4dea7f957231a4eb2aaf9e95654ab4d711e Mon Sep 17 00:00:00 2001
From: Jayden <jvyden@jvyden.xyz>
Date: Fri, 1 Mar 2024 14:32:44 -0500
Subject: [PATCH 247/930] Fix yapping

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Desktop/DiscordRichPresence.cs | 10 +++-------
 1 file changed, 3 insertions(+), 7 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 91f7f6e1da..035add8044 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -25,7 +25,6 @@ namespace osu.Desktop
     internal partial class DiscordRichPresence : Component
     {
         private const string client_id = "367827983903490050";
-        public const string DISCORD_PROTOCOL = $"discord-{client_id}://";
 
         private DiscordRpcClient client = null!;
 
@@ -69,11 +68,9 @@ namespace osu.Desktop
             client.OnReady += onReady;
             client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Code} {e.Message}", LoggingTarget.Network, LogLevel.Error);
 
-            // set up stuff for spectate/join
-            // first, we register a uri scheme for when osu! isn't running and a user clicks join/spectate
-            // the rpc library we use also happens to _require_ that we do this
+            // A URI scheme is required to support game invitations, as well as informing Discord of the game executable path to support launching the game when a user clicks on join/spectate.
             client.RegisterUriScheme();
-            client.Subscribe(EventType.Join); // we have to explicitly tell discord to send us join events.
+            client.Subscribe(EventType.Join);
             client.OnJoin += onJoin;
 
             config.BindWith(OsuSetting.DiscordRichPresence, privacyMode);
@@ -184,7 +181,7 @@ namespace osu.Desktop
 
         private void onJoin(object sender, JoinMessage args)
         {
-            game.Window?.Raise(); // users will expect to be brought back to osu! when joining a lobby from discord
+            game.Window?.Raise();
 
             if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
                 Logger.Log("Failed to parse the room secret Discord gave us", LoggingTarget.Network, LogLevel.Error);
@@ -232,7 +229,6 @@ namespace osu.Desktop
             if (!long.TryParse(secret[..roomSecretSplitIndex], out roomId))
                 return false;
 
-            // just convert to string here, we're going to have to alloc it later anyways
             password = secret[(roomSecretSplitIndex + 1)..].ToString();
             if (password.Length == 0) password = null;
 

From e0c73eb36225b1e7e058b3af5cc553f791ae28b6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 1 Mar 2024 22:49:12 +0300
Subject: [PATCH 248/930] Fix osu!mania key images potentially showing gaps
 between columns

---
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
index 48b92a8486..9fd33b9963 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Game.Rulesets.Mania.UI;
@@ -49,14 +50,14 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                     upSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
-                        Texture = skin.GetTexture(upImage),
+                        Texture = skin.GetTexture(upImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
                         RelativeSizeAxes = Axes.X,
                         Width = 1
                     },
                     downSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
-                        Texture = skin.GetTexture(downImage),
+                        Texture = skin.GetTexture(downImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
                         RelativeSizeAxes = Axes.X,
                         Width = 1,
                         Alpha = 0

From f1b66da469ead2105e6b3f1d83e95e04b7f4ec45 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 1 Mar 2024 22:57:13 +0300
Subject: [PATCH 249/930] Add comments

---
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
index 9fd33b9963..6ba91fbbd5 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                     upSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
+                        // ClampToEdge is used to avoid gaps between keys, see: https://github.com/ppy/osu/issues/27431
                         Texture = skin.GetTexture(upImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
                         RelativeSizeAxes = Axes.X,
                         Width = 1
@@ -57,6 +58,7 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                     downSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
+                        // ClampToEdge is used to avoid gaps between keys, see: https://github.com/ppy/osu/issues/27431
                         Texture = skin.GetTexture(downImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
                         RelativeSizeAxes = Axes.X,
                         Width = 1,

From 82373ff752ab9c1d961a8c5673499ddb913bec05 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Mar 2024 03:18:42 +0300
Subject: [PATCH 250/930] Add failing catch beatmap

---
 .../CatchBeatmapConversionTest.cs             |   1 +
 .../Beatmaps/1041052-expected-conversion.json |   1 +
 .../Resources/Testing/Beatmaps/1041052.osu    | 210 ++++++++++++++++++
 3 files changed, 212 insertions(+)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052-expected-conversion.json
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052.osu

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
index d0ecb828df..81e0675aaa 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchBeatmapConversionTest.cs
@@ -53,6 +53,7 @@ namespace osu.Game.Rulesets.Catch.Tests
         [TestCase("3689906", new[] { typeof(CatchModDoubleTime), typeof(CatchModEasy) })]
         [TestCase("3949367", new[] { typeof(CatchModDoubleTime), typeof(CatchModEasy) })]
         [TestCase("112643")]
+        [TestCase("1041052", new[] { typeof(CatchModHardRock) })]
         public new void Test(string name, params Type[] mods) => base.Test(name, mods);
 
         protected override IEnumerable<ConvertValue> CreateConvertValue(HitObject hitObject)
diff --git a/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052-expected-conversion.json b/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052-expected-conversion.json
new file mode 100644
index 0000000000..01150e701d
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052-expected-conversion.json
@@ -0,0 +1 @@
+{"Mappings":[{"StartTime":1155.0,"Objects":[{"StartTime":1155.0,"Position":208.0,"HyperDash":false},{"StartTime":1251.0,"Position":167.675858,"HyperDash":false},{"StartTime":1348.0,"Position":157.087921,"HyperDash":false},{"StartTime":1445.0,"Position":128.5,"HyperDash":false},{"StartTime":1542.0,"Position":105.912064,"HyperDash":false},{"StartTime":1620.0,"Position":102.336205,"HyperDash":false},{"StartTime":1735.0,"Position":55.0,"HyperDash":false}]},{"StartTime":2122.0,"Objects":[{"StartTime":2122.0,"Position":275.0,"HyperDash":false}]},{"StartTime":2509.0,"Objects":[{"StartTime":2509.0,"Position":269.0,"HyperDash":false}]},{"StartTime":3284.0,"Objects":[{"StartTime":3284.0,"Position":448.0,"HyperDash":false},{"StartTime":3380.0,"Position":466.562317,"HyperDash":false},{"StartTime":3477.0,"Position":477.575867,"HyperDash":false},{"StartTime":3556.0,"Position":467.440033,"HyperDash":false},{"StartTime":3671.0,"Position":481.146881,"HyperDash":false}]},{"StartTime":4058.0,"Objects":[{"StartTime":4058.0,"Position":288.0,"HyperDash":false}]},{"StartTime":5025.0,"Objects":[{"StartTime":5025.0,"Position":128.0,"HyperDash":false},{"StartTime":5121.0,"Position":94.67586,"HyperDash":false},{"StartTime":5218.0,"Position":77.08793,"HyperDash":false},{"StartTime":5315.0,"Position":51.5,"HyperDash":false},{"StartTime":5412.0,"Position":77.08794,"HyperDash":false},{"StartTime":5490.0,"Position":111.663795,"HyperDash":false},{"StartTime":5605.0,"Position":128.0,"HyperDash":false}]},{"StartTime":5800.0,"Objects":[{"StartTime":5800.0,"Position":352.0,"HyperDash":false}]},{"StartTime":5993.0,"Objects":[{"StartTime":5993.0,"Position":240.0,"HyperDash":false}]},{"StartTime":6187.0,"Objects":[{"StartTime":6187.0,"Position":336.0,"HyperDash":false}]},{"StartTime":6574.0,"Objects":[{"StartTime":6574.0,"Position":416.0,"HyperDash":false},{"StartTime":6670.0,"Position":394.697662,"HyperDash":false},{"StartTime":6767.0,"Position":365.131775,"HyperDash":false},{"StartTime":6864.0,"Position":344.5659,"HyperDash":false},{"StartTime":6961.0,"Position":314.0,"HyperDash":false},{"StartTime":7057.0,"Position":279.6977,"HyperDash":false},{"StartTime":7154.0,"Position":263.131775,"HyperDash":false},{"StartTime":7233.0,"Position":259.310059,"HyperDash":false},{"StartTime":7348.0,"Position":212.0,"HyperDash":false}]},{"StartTime":8122.0,"Objects":[{"StartTime":8122.0,"Position":488.0,"HyperDash":false},{"StartTime":8218.0,"Position":475.697662,"HyperDash":false},{"StartTime":8315.0,"Position":437.131775,"HyperDash":false},{"StartTime":8394.0,"Position":399.3101,"HyperDash":false},{"StartTime":8509.0,"Position":386.0,"HyperDash":false}]},{"StartTime":8896.0,"Objects":[{"StartTime":8896.0,"Position":457.0,"HyperDash":false},{"StartTime":8992.0,"Position":444.675873,"HyperDash":false},{"StartTime":9089.0,"Position":406.087921,"HyperDash":false},{"StartTime":9186.0,"Position":384.5,"HyperDash":false},{"StartTime":9283.0,"Position":354.912048,"HyperDash":false},{"StartTime":9361.0,"Position":330.3362,"HyperDash":false},{"StartTime":9476.0,"Position":304.0,"HyperDash":false}]},{"StartTime":10058.0,"Objects":[{"StartTime":10058.0,"Position":400.0,"HyperDash":false}]},{"StartTime":10445.0,"Objects":[{"StartTime":10445.0,"Position":304.0,"HyperDash":false},{"StartTime":10541.0,"Position":277.697662,"HyperDash":false},{"StartTime":10638.0,"Position":253.131775,"HyperDash":false},{"StartTime":10735.0,"Position":212.565887,"HyperDash":false},{"StartTime":10832.0,"Position":202.0,"HyperDash":false},{"StartTime":10928.0,"Position":208.302322,"HyperDash":false},{"StartTime":11025.0,"Position":252.868225,"HyperDash":false},{"StartTime":11104.0,"Position":286.6899,"HyperDash":false},{"StartTime":11219.0,"Position":304.0,"HyperDash":false}]},{"StartTime":11606.0,"Objects":[{"StartTime":11606.0,"Position":400.0,"HyperDash":false}]},{"StartTime":11993.0,"Objects":[{"StartTime":11993.0,"Position":240.0,"HyperDash":false},{"StartTime":12089.0,"Position":231.675858,"HyperDash":false},{"StartTime":12186.0,"Position":189.087921,"HyperDash":false},{"StartTime":12283.0,"Position":156.5,"HyperDash":false},{"StartTime":12380.0,"Position":137.912064,"HyperDash":false},{"StartTime":12458.0,"Position":136.336212,"HyperDash":false},{"StartTime":12573.0,"Position":87.0,"HyperDash":false}]},{"StartTime":13154.0,"Objects":[{"StartTime":13154.0,"Position":0.0,"HyperDash":false}]},{"StartTime":13542.0,"Objects":[{"StartTime":13542.0,"Position":112.0,"HyperDash":false},{"StartTime":13638.0,"Position":119.913734,"HyperDash":false},{"StartTime":13735.0,"Position":144.5726,"HyperDash":false},{"StartTime":13832.0,"Position":179.8026,"HyperDash":false},{"StartTime":13929.0,"Position":191.357681,"HyperDash":false},{"StartTime":14007.0,"Position":228.85704,"HyperDash":false},{"StartTime":14122.0,"Position":241.622177,"HyperDash":false}]},{"StartTime":14316.0,"Objects":[{"StartTime":14316.0,"Position":288.0,"HyperDash":false},{"StartTime":14412.0,"Position":328.324127,"HyperDash":false},{"StartTime":14509.0,"Position":338.912079,"HyperDash":false},{"StartTime":14606.0,"Position":364.5,"HyperDash":false},{"StartTime":14703.0,"Position":338.912079,"HyperDash":false},{"StartTime":14781.0,"Position":301.3362,"HyperDash":false},{"StartTime":14896.0,"Position":288.0,"HyperDash":false}]},{"StartTime":15284.0,"Objects":[{"StartTime":15284.0,"Position":192.0,"HyperDash":false},{"StartTime":15362.0,"Position":187.7823,"HyperDash":false},{"StartTime":15477.0,"Position":169.192108,"HyperDash":false}]},{"StartTime":15864.0,"Objects":[{"StartTime":15864.0,"Position":464.0,"HyperDash":false}]},{"StartTime":16638.0,"Objects":[{"StartTime":16638.0,"Position":128.0,"HyperDash":false},{"StartTime":16734.0,"Position":90.86488,"HyperDash":false},{"StartTime":16831.0,"Position":78.3134155,"HyperDash":false},{"StartTime":16928.0,"Position":73.3517761,"HyperDash":false},{"StartTime":17025.0,"Position":34.6746674,"HyperDash":false},{"StartTime":17121.0,"Position":33.0714569,"HyperDash":false},{"StartTime":17218.0,"Position":2.65127468,"HyperDash":false},{"StartTime":17315.0,"Position":19.907608,"HyperDash":false},{"StartTime":17412.0,"Position":34.674675,"HyperDash":false},{"StartTime":17508.0,"Position":56.12827,"HyperDash":false},{"StartTime":17605.0,"Position":78.0694351,"HyperDash":false},{"StartTime":17684.0,"Position":97.97488,"HyperDash":false},{"StartTime":17799.0,"Position":128.0,"HyperDash":false}]},{"StartTime":18187.0,"Objects":[{"StartTime":18187.0,"Position":224.0,"HyperDash":false},{"StartTime":18283.0,"Position":231.165024,"HyperDash":false},{"StartTime":18380.0,"Position":273.681732,"HyperDash":false},{"StartTime":18477.0,"Position":304.374176,"HyperDash":false},{"StartTime":18574.0,"Position":316.397827,"HyperDash":false},{"StartTime":18670.0,"Position":312.8548,"HyperDash":false},{"StartTime":18767.0,"Position":345.5291,"HyperDash":false},{"StartTime":18864.0,"Position":328.007355,"HyperDash":false},{"StartTime":18961.0,"Position":316.397827,"HyperDash":false},{"StartTime":19057.0,"Position":304.594452,"HyperDash":false},{"StartTime":19154.0,"Position":273.924957,"HyperDash":false},{"StartTime":19233.0,"Position":271.063354,"HyperDash":false},{"StartTime":19348.0,"Position":224.0,"HyperDash":false}]},{"StartTime":19735.0,"Objects":[{"StartTime":19735.0,"Position":128.0,"HyperDash":false},{"StartTime":19831.0,"Position":136.324142,"HyperDash":false},{"StartTime":19928.0,"Position":178.912079,"HyperDash":false},{"StartTime":20025.0,"Position":223.5,"HyperDash":false},{"StartTime":20122.0,"Position":230.087936,"HyperDash":false},{"StartTime":20200.0,"Position":260.6638,"HyperDash":false},{"StartTime":20315.0,"Position":281.0,"HyperDash":false}]},{"StartTime":20896.0,"Objects":[{"StartTime":20896.0,"Position":432.0,"HyperDash":false}]},{"StartTime":21284.0,"Objects":[{"StartTime":21284.0,"Position":328.0,"HyperDash":false},{"StartTime":21380.0,"Position":357.324127,"HyperDash":false},{"StartTime":21477.0,"Position":378.912079,"HyperDash":false},{"StartTime":21574.0,"Position":420.5,"HyperDash":false},{"StartTime":21671.0,"Position":430.087952,"HyperDash":false},{"StartTime":21749.0,"Position":447.6638,"HyperDash":false},{"StartTime":21864.0,"Position":481.0,"HyperDash":false}]},{"StartTime":22445.0,"Objects":[{"StartTime":22445.0,"Position":328.0,"HyperDash":false}]},{"StartTime":22832.0,"Objects":[{"StartTime":22832.0,"Position":224.0,"HyperDash":false},{"StartTime":22928.0,"Position":188.675858,"HyperDash":false},{"StartTime":23025.0,"Position":173.087921,"HyperDash":false},{"StartTime":23122.0,"Position":156.5,"HyperDash":false},{"StartTime":23219.0,"Position":121.912064,"HyperDash":false},{"StartTime":23297.0,"Position":91.3362045,"HyperDash":false},{"StartTime":23412.0,"Position":71.0,"HyperDash":false}]},{"StartTime":23993.0,"Objects":[{"StartTime":23993.0,"Position":224.0,"HyperDash":false}]},{"StartTime":24380.0,"Objects":[{"StartTime":24380.0,"Position":112.0,"HyperDash":false},{"StartTime":24476.0,"Position":127.324142,"HyperDash":false},{"StartTime":24573.0,"Position":162.912079,"HyperDash":false},{"StartTime":24670.0,"Position":202.5,"HyperDash":false},{"StartTime":24767.0,"Position":214.087936,"HyperDash":false},{"StartTime":24845.0,"Position":246.663788,"HyperDash":false},{"StartTime":24960.0,"Position":265.0,"HyperDash":false}]},{"StartTime":25541.0,"Objects":[{"StartTime":25541.0,"Position":416.0,"HyperDash":false}]},{"StartTime":25929.0,"Objects":[{"StartTime":25929.0,"Position":304.0,"HyperDash":false},{"StartTime":26025.0,"Position":287.9714,"HyperDash":false},{"StartTime":26122.0,"Position":274.232758,"HyperDash":false},{"StartTime":26219.0,"Position":253.164063,"HyperDash":false},{"StartTime":26316.0,"Position":274.1704,"HyperDash":false},{"StartTime":26394.0,"Position":290.949921,"HyperDash":false},{"StartTime":26509.0,"Position":303.819763,"HyperDash":false}]},{"StartTime":27090.0,"Objects":[{"StartTime":27090.0,"Position":480.0,"HyperDash":false}]},{"StartTime":27477.0,"Objects":[{"StartTime":27477.0,"Position":384.0,"HyperDash":false},{"StartTime":27573.0,"Position":351.697662,"HyperDash":false},{"StartTime":27670.0,"Position":333.0,"HyperDash":false},{"StartTime":27749.0,"Position":356.6899,"HyperDash":false},{"StartTime":27864.0,"Position":384.0,"HyperDash":false}]},{"StartTime":28058.0,"Objects":[{"StartTime":28058.0,"Position":432.0,"HyperDash":false}]},{"StartTime":28445.0,"Objects":[{"StartTime":28445.0,"Position":333.0,"HyperDash":false},{"StartTime":28541.0,"Position":305.697662,"HyperDash":false},{"StartTime":28638.0,"Position":282.0,"HyperDash":false},{"StartTime":28717.0,"Position":319.6899,"HyperDash":false},{"StartTime":28832.0,"Position":333.0,"HyperDash":false}]},{"StartTime":29025.0,"Objects":[{"StartTime":29025.0,"Position":384.0,"HyperDash":false},{"StartTime":29121.0,"Position":341.697662,"HyperDash":false},{"StartTime":29218.0,"Position":333.131775,"HyperDash":false},{"StartTime":29297.0,"Position":293.3101,"HyperDash":false},{"StartTime":29412.0,"Position":282.0,"HyperDash":false}]},{"StartTime":29606.0,"Objects":[{"StartTime":29606.0,"Position":224.0,"HyperDash":false},{"StartTime":29702.0,"Position":206.103424,"HyperDash":false},{"StartTime":29799.0,"Position":176.49205,"HyperDash":false},{"StartTime":29896.0,"Position":149.701324,"HyperDash":false},{"StartTime":29993.0,"Position":147.519775,"HyperDash":false},{"StartTime":30071.0,"Position":144.128265,"HyperDash":false},{"StartTime":30186.0,"Position":148.650436,"HyperDash":false}]},{"StartTime":30574.0,"Objects":[{"StartTime":30574.0,"Position":272.0,"HyperDash":false},{"StartTime":30670.0,"Position":303.302338,"HyperDash":false},{"StartTime":30767.0,"Position":322.868225,"HyperDash":false},{"StartTime":30846.0,"Position":351.6899,"HyperDash":false},{"StartTime":30961.0,"Position":374.0,"HyperDash":false}]},{"StartTime":31154.0,"Objects":[{"StartTime":31154.0,"Position":424.0,"HyperDash":false},{"StartTime":31250.0,"Position":439.371674,"HyperDash":false},{"StartTime":31347.0,"Position":424.705872,"HyperDash":false},{"StartTime":31444.0,"Position":417.305573,"HyperDash":false},{"StartTime":31541.0,"Position":395.3253,"HyperDash":false},{"StartTime":31619.0,"Position":372.2993,"HyperDash":false},{"StartTime":31734.0,"Position":347.633759,"HyperDash":false}]},{"StartTime":32122.0,"Objects":[{"StartTime":32122.0,"Position":224.0,"HyperDash":false},{"StartTime":32218.0,"Position":200.129822,"HyperDash":false},{"StartTime":32315.0,"Position":176.418152,"HyperDash":false},{"StartTime":32394.0,"Position":164.275757,"HyperDash":false},{"StartTime":32509.0,"Position":146.329926,"HyperDash":false}]},{"StartTime":32703.0,"Objects":[{"StartTime":32703.0,"Position":256.0,"HyperDash":false}]},{"StartTime":33284.0,"Objects":[{"StartTime":33284.0,"Position":496.0,"HyperDash":false}]},{"StartTime":33671.0,"Objects":[{"StartTime":33671.0,"Position":304.0,"HyperDash":false},{"StartTime":33767.0,"Position":297.697662,"HyperDash":false},{"StartTime":33864.0,"Position":253.0,"HyperDash":false},{"StartTime":33943.0,"Position":270.6899,"HyperDash":false},{"StartTime":34058.0,"Position":304.0,"HyperDash":false}]},{"StartTime":34251.0,"Objects":[{"StartTime":34251.0,"Position":352.0,"HyperDash":false},{"StartTime":34347.0,"Position":374.083679,"HyperDash":false},{"StartTime":34444.0,"Position":391.360016,"HyperDash":false},{"StartTime":34541.0,"Position":387.812561,"HyperDash":false},{"StartTime":34638.0,"Position":404.369629,"HyperDash":false},{"StartTime":34716.0,"Position":417.578369,"HyperDash":false},{"StartTime":34831.0,"Position":385.75708,"HyperDash":false}]},{"StartTime":35219.0,"Objects":[{"StartTime":35219.0,"Position":280.0,"HyperDash":false},{"StartTime":35315.0,"Position":277.964783,"HyperDash":false},{"StartTime":35412.0,"Position":251.783386,"HyperDash":false},{"StartTime":35491.0,"Position":238.233582,"HyperDash":false},{"StartTime":35606.0,"Position":223.420578,"HyperDash":false}]},{"StartTime":35800.0,"Objects":[{"StartTime":35800.0,"Position":272.0,"HyperDash":false},{"StartTime":35896.0,"Position":303.035217,"HyperDash":false},{"StartTime":35993.0,"Position":300.2166,"HyperDash":false},{"StartTime":36072.0,"Position":326.766418,"HyperDash":false},{"StartTime":36187.0,"Position":328.5794,"HyperDash":false}]},{"StartTime":36380.0,"Objects":[{"StartTime":36380.0,"Position":224.0,"HyperDash":false}]},{"StartTime":36767.0,"Objects":[{"StartTime":36767.0,"Position":176.0,"HyperDash":false},{"StartTime":36863.0,"Position":148.9648,"HyperDash":false},{"StartTime":36960.0,"Position":147.783386,"HyperDash":false},{"StartTime":37039.0,"Position":140.233582,"HyperDash":false},{"StartTime":37154.0,"Position":119.420578,"HyperDash":false}]},{"StartTime":37348.0,"Objects":[{"StartTime":37348.0,"Position":168.0,"HyperDash":false},{"StartTime":37444.0,"Position":170.0352,"HyperDash":false},{"StartTime":37541.0,"Position":196.216614,"HyperDash":false},{"StartTime":37620.0,"Position":195.766418,"HyperDash":false},{"StartTime":37735.0,"Position":224.579422,"HyperDash":false}]},{"StartTime":37928.0,"Objects":[{"StartTime":37928.0,"Position":120.0,"HyperDash":false}]},{"StartTime":38316.0,"Objects":[{"StartTime":38316.0,"Position":304.0,"HyperDash":false},{"StartTime":38412.0,"Position":277.697662,"HyperDash":false},{"StartTime":38509.0,"Position":253.131775,"HyperDash":false},{"StartTime":38588.0,"Position":226.310089,"HyperDash":false},{"StartTime":38703.0,"Position":202.0,"HyperDash":false}]},{"StartTime":38896.0,"Objects":[{"StartTime":38896.0,"Position":88.0,"HyperDash":false}]},{"StartTime":39477.0,"Objects":[{"StartTime":39477.0,"Position":280.0,"HyperDash":false},{"StartTime":39555.0,"Position":292.6114,"HyperDash":false},{"StartTime":39670.0,"Position":331.0,"HyperDash":false}]},{"StartTime":39864.0,"Objects":[{"StartTime":39864.0,"Position":424.0,"HyperDash":false},{"StartTime":39960.0,"Position":428.059753,"HyperDash":false},{"StartTime":40057.0,"Position":441.062134,"HyperDash":false},{"StartTime":40136.0,"Position":432.009247,"HyperDash":false},{"StartTime":40251.0,"Position":420.508881,"HyperDash":false}]},{"StartTime":40445.0,"Objects":[{"StartTime":40445.0,"Position":288.0,"HyperDash":false}]},{"StartTime":41025.0,"Objects":[{"StartTime":41025.0,"Position":32.0,"HyperDash":false}]},{"StartTime":41413.0,"Objects":[{"StartTime":41413.0,"Position":256.0,"HyperDash":false},{"StartTime":41509.0,"Position":291.8391,"HyperDash":false},{"StartTime":41606.0,"Position":302.265045,"HyperDash":false},{"StartTime":41685.0,"Position":310.9909,"HyperDash":false},{"StartTime":41800.0,"Position":352.8495,"HyperDash":false}]},{"StartTime":41993.0,"Objects":[{"StartTime":41993.0,"Position":447.0,"HyperDash":false}]},{"StartTime":42187.0,"Objects":[{"StartTime":42187.0,"Position":440.0,"HyperDash":false},{"StartTime":42283.0,"Position":403.2554,"HyperDash":false},{"StartTime":42380.0,"Position":389.7651,"HyperDash":false},{"StartTime":42459.0,"Position":365.6506,"HyperDash":false},{"StartTime":42574.0,"Position":342.9871,"HyperDash":false}]},{"StartTime":42961.0,"Objects":[{"StartTime":42961.0,"Position":248.0,"HyperDash":false},{"StartTime":43057.0,"Position":264.94986,"HyperDash":false},{"StartTime":43154.0,"Position":281.6838,"HyperDash":false},{"StartTime":43251.0,"Position":305.2995,"HyperDash":false},{"StartTime":43348.0,"Position":330.6694,"HyperDash":false},{"StartTime":43444.0,"Position":352.264221,"HyperDash":false},{"StartTime":43541.0,"Position":377.479736,"HyperDash":false},{"StartTime":43638.0,"Position":371.509277,"HyperDash":false},{"StartTime":43735.0,"Position":330.6694,"HyperDash":false},{"StartTime":43831.0,"Position":294.557373,"HyperDash":false},{"StartTime":43928.0,"Position":281.915039,"HyperDash":false},{"StartTime":44007.0,"Position":283.462677,"HyperDash":false},{"StartTime":44122.0,"Position":248.0,"HyperDash":false}]},{"StartTime":44509.0,"Objects":[{"StartTime":44509.0,"Position":144.0,"HyperDash":false},{"StartTime":44605.0,"Position":140.034851,"HyperDash":false},{"StartTime":44702.0,"Position":110.27771,"HyperDash":false},{"StartTime":44799.0,"Position":69.63604,"HyperDash":false},{"StartTime":44896.0,"Position":61.2429733,"HyperDash":false},{"StartTime":44974.0,"Position":47.09105,"HyperDash":false},{"StartTime":45089.0,"Position":14.520277,"HyperDash":false}]},{"StartTime":45284.0,"Objects":[{"StartTime":45284.0,"Position":56.0,"HyperDash":false}]},{"StartTime":45671.0,"Objects":[{"StartTime":45671.0,"Position":264.0,"HyperDash":false}]},{"StartTime":46058.0,"Objects":[{"StartTime":46058.0,"Position":264.0,"HyperDash":false},{"StartTime":46154.0,"Position":301.302338,"HyperDash":false},{"StartTime":46251.0,"Position":314.868225,"HyperDash":false},{"StartTime":46330.0,"Position":321.6899,"HyperDash":false},{"StartTime":46445.0,"Position":366.0,"HyperDash":false}]},{"StartTime":46638.0,"Objects":[{"StartTime":46638.0,"Position":416.0,"HyperDash":false},{"StartTime":46734.0,"Position":371.675873,"HyperDash":false},{"StartTime":46831.0,"Position":365.087921,"HyperDash":false},{"StartTime":46928.0,"Position":325.5,"HyperDash":false},{"StartTime":47025.0,"Position":313.912048,"HyperDash":false},{"StartTime":47103.0,"Position":306.3362,"HyperDash":false},{"StartTime":47218.0,"Position":263.0,"HyperDash":false}]},{"StartTime":47606.0,"Objects":[{"StartTime":47606.0,"Position":360.0,"HyperDash":false},{"StartTime":47702.0,"Position":324.675873,"HyperDash":false},{"StartTime":47799.0,"Position":309.087921,"HyperDash":false},{"StartTime":47896.0,"Position":293.5,"HyperDash":false},{"StartTime":47993.0,"Position":257.912048,"HyperDash":false},{"StartTime":48071.0,"Position":244.336212,"HyperDash":false},{"StartTime":48186.0,"Position":207.0,"HyperDash":false}]},{"StartTime":48380.0,"Objects":[{"StartTime":48380.0,"Position":160.0,"HyperDash":false},{"StartTime":48476.0,"Position":166.997681,"HyperDash":false},{"StartTime":48573.0,"Position":187.484192,"HyperDash":false},{"StartTime":48652.0,"Position":200.988281,"HyperDash":false},{"StartTime":48767.0,"Position":236.72261,"HyperDash":false}]},{"StartTime":49154.0,"Objects":[{"StartTime":49154.0,"Position":32.0,"HyperDash":false}]},{"StartTime":49542.0,"Objects":[{"StartTime":49542.0,"Position":248.0,"HyperDash":false},{"StartTime":49638.0,"Position":266.302338,"HyperDash":false},{"StartTime":49735.0,"Position":298.868225,"HyperDash":false},{"StartTime":49814.0,"Position":314.6899,"HyperDash":false},{"StartTime":49929.0,"Position":350.0,"HyperDash":false}]},{"StartTime":50316.0,"Objects":[{"StartTime":50316.0,"Position":256.0,"HyperDash":false},{"StartTime":50394.0,"Position":235.3886,"HyperDash":false},{"StartTime":50509.0,"Position":205.0,"HyperDash":false}]},{"StartTime":50703.0,"Objects":[{"StartTime":50703.0,"Position":256.0,"HyperDash":false},{"StartTime":50799.0,"Position":296.302338,"HyperDash":false},{"StartTime":50896.0,"Position":306.868225,"HyperDash":false},{"StartTime":50975.0,"Position":344.6899,"HyperDash":false},{"StartTime":51090.0,"Position":358.0,"HyperDash":false}]},{"StartTime":51284.0,"Objects":[{"StartTime":51284.0,"Position":440.0,"HyperDash":false}]},{"StartTime":51477.0,"Objects":[{"StartTime":51477.0,"Position":352.0,"HyperDash":false},{"StartTime":51573.0,"Position":329.697662,"HyperDash":false},{"StartTime":51670.0,"Position":301.131775,"HyperDash":false},{"StartTime":51749.0,"Position":288.3101,"HyperDash":false},{"StartTime":51864.0,"Position":250.0,"HyperDash":false}]},{"StartTime":52251.0,"Objects":[{"StartTime":52251.0,"Position":128.0,"HyperDash":false},{"StartTime":52347.0,"Position":102.275604,"HyperDash":false},{"StartTime":52444.0,"Position":77.8078156,"HyperDash":false},{"StartTime":52541.0,"Position":41.6188354,"HyperDash":false},{"StartTime":52638.0,"Position":32.3890381,"HyperDash":false},{"StartTime":52716.0,"Position":11.4332657,"HyperDash":false},{"StartTime":52831.0,"Position":4.4833107,"HyperDash":false}]},{"StartTime":53025.0,"Objects":[{"StartTime":53025.0,"Position":88.0,"HyperDash":false}]},{"StartTime":53413.0,"Objects":[{"StartTime":53413.0,"Position":168.0,"HyperDash":false},{"StartTime":53491.0,"Position":145.000992,"HyperDash":false},{"StartTime":53606.0,"Position":155.630676,"HyperDash":false}]},{"StartTime":53800.0,"Objects":[{"StartTime":53800.0,"Position":248.0,"HyperDash":false},{"StartTime":53896.0,"Position":263.12973,"HyperDash":false},{"StartTime":53993.0,"Position":290.128967,"HyperDash":false},{"StartTime":54090.0,"Position":316.20874,"HyperDash":false},{"StartTime":54187.0,"Position":340.6195,"HyperDash":false},{"StartTime":54265.0,"Position":376.1075,"HyperDash":false},{"StartTime":54380.0,"Position":385.246277,"HyperDash":false}]},{"StartTime":54574.0,"Objects":[{"StartTime":54574.0,"Position":472.0,"HyperDash":false}]},{"StartTime":54961.0,"Objects":[{"StartTime":54961.0,"Position":328.0,"HyperDash":false}]},{"StartTime":55348.0,"Objects":[{"StartTime":55348.0,"Position":224.0,"HyperDash":false},{"StartTime":55444.0,"Position":195.951981,"HyperDash":false},{"StartTime":55541.0,"Position":173.643036,"HyperDash":false},{"StartTime":55620.0,"Position":140.030609,"HyperDash":false},{"StartTime":55735.0,"Position":123.025146,"HyperDash":false}]},{"StartTime":55929.0,"Objects":[{"StartTime":55929.0,"Position":72.0,"HyperDash":false},{"StartTime":56025.0,"Position":95.8109741,"HyperDash":false},{"StartTime":56122.0,"Position":121.880394,"HyperDash":false},{"StartTime":56201.0,"Position":145.29776,"HyperDash":false},{"StartTime":56316.0,"Position":172.019226,"HyperDash":false}]},{"StartTime":56509.0,"Objects":[{"StartTime":56509.0,"Position":256.0,"HyperDash":false}]},{"StartTime":56896.0,"Objects":[{"StartTime":56896.0,"Position":328.0,"HyperDash":false},{"StartTime":56992.0,"Position":356.5922,"HyperDash":false},{"StartTime":57089.0,"Position":368.955872,"HyperDash":false},{"StartTime":57186.0,"Position":373.612579,"HyperDash":false},{"StartTime":57283.0,"Position":419.1303,"HyperDash":false},{"StartTime":57361.0,"Position":444.262817,"HyperDash":false},{"StartTime":57476.0,"Position":466.641,"HyperDash":false}]},{"StartTime":57671.0,"Objects":[{"StartTime":57671.0,"Position":416.0,"HyperDash":false},{"StartTime":57767.0,"Position":391.6712,"HyperDash":false},{"StartTime":57864.0,"Position":367.089,"HyperDash":false},{"StartTime":57943.0,"Position":328.06842,"HyperDash":false},{"StartTime":58058.0,"Position":317.924561,"HyperDash":false}]},{"StartTime":58445.0,"Objects":[{"StartTime":58445.0,"Position":144.0,"HyperDash":false}]},{"StartTime":58832.0,"Objects":[{"StartTime":58832.0,"Position":320.0,"HyperDash":false}]},{"StartTime":59219.0,"Objects":[{"StartTime":59219.0,"Position":128.0,"HyperDash":false}]},{"StartTime":59606.0,"Objects":[{"StartTime":59606.0,"Position":112.0,"HyperDash":false}]},{"StartTime":59993.0,"Objects":[{"StartTime":59993.0,"Position":224.0,"HyperDash":false},{"StartTime":60089.0,"Position":217.725632,"HyperDash":false},{"StartTime":60186.0,"Position":227.34639,"HyperDash":false},{"StartTime":60265.0,"Position":214.703522,"HyperDash":false},{"StartTime":60380.0,"Position":206.754791,"HyperDash":false}]},{"StartTime":60767.0,"Objects":[{"StartTime":60767.0,"Position":80.0,"HyperDash":false},{"StartTime":60863.0,"Position":90.79409,"HyperDash":false},{"StartTime":60960.0,"Position":75.87808,"HyperDash":false},{"StartTime":61039.0,"Position":74.4997559,"HyperDash":false},{"StartTime":61154.0,"Position":96.53038,"HyperDash":false}]},{"StartTime":61542.0,"Objects":[{"StartTime":61542.0,"Position":200.0,"HyperDash":false},{"StartTime":61638.0,"Position":196.089508,"HyperDash":false},{"StartTime":61735.0,"Position":236.445679,"HyperDash":false},{"StartTime":61814.0,"Position":270.5239,"HyperDash":false},{"StartTime":61929.0,"Position":286.4193,"HyperDash":false}]},{"StartTime":62316.0,"Objects":[{"StartTime":62316.0,"Position":376.0,"HyperDash":false},{"StartTime":62412.0,"Position":361.9105,"HyperDash":false},{"StartTime":62509.0,"Position":339.554321,"HyperDash":false},{"StartTime":62588.0,"Position":316.4761,"HyperDash":false},{"StartTime":62703.0,"Position":289.5807,"HyperDash":false}]},{"StartTime":63090.0,"Objects":[{"StartTime":63090.0,"Position":184.0,"HyperDash":false},{"StartTime":63186.0,"Position":174.5783,"HyperDash":false},{"StartTime":63283.0,"Position":191.193848,"HyperDash":false},{"StartTime":63362.0,"Position":204.138489,"HyperDash":false},{"StartTime":63477.0,"Position":198.424973,"HyperDash":false}]},{"StartTime":63864.0,"Objects":[{"StartTime":63864.0,"Position":88.0,"HyperDash":false},{"StartTime":63960.0,"Position":45.16764,"HyperDash":false},{"StartTime":64057.0,"Position":38.0766068,"HyperDash":false},{"StartTime":64154.0,"Position":12.98558,"HyperDash":false},{"StartTime":64251.0,"Position":38.0766144,"HyperDash":false},{"StartTime":64329.0,"Position":69.2529,"HyperDash":false},{"StartTime":64444.0,"Position":88.0,"HyperDash":false}]},{"StartTime":64638.0,"Objects":[{"StartTime":64638.0,"Position":312.0,"HyperDash":false}]},{"StartTime":64832.0,"Objects":[{"StartTime":64832.0,"Position":208.0,"HyperDash":false}]},{"StartTime":65025.0,"Objects":[{"StartTime":65025.0,"Position":304.0,"HyperDash":false}]},{"StartTime":65413.0,"Objects":[{"StartTime":65413.0,"Position":360.0,"HyperDash":false},{"StartTime":65491.0,"Position":361.6114,"HyperDash":false},{"StartTime":65606.0,"Position":411.0,"HyperDash":false}]},{"StartTime":65800.0,"Objects":[{"StartTime":65800.0,"Position":462.0,"HyperDash":false},{"StartTime":65878.0,"Position":458.3886,"HyperDash":false},{"StartTime":65993.0,"Position":411.0,"HyperDash":false}]},{"StartTime":66187.0,"Objects":[{"StartTime":66187.0,"Position":344.0,"HyperDash":false},{"StartTime":66283.0,"Position":327.697662,"HyperDash":false},{"StartTime":66380.0,"Position":293.131775,"HyperDash":false},{"StartTime":66459.0,"Position":271.3101,"HyperDash":false},{"StartTime":66574.0,"Position":242.0,"HyperDash":false}]},{"StartTime":66961.0,"Objects":[{"StartTime":66961.0,"Position":152.0,"HyperDash":false},{"StartTime":67057.0,"Position":167.659241,"HyperDash":false},{"StartTime":67154.0,"Position":147.9835,"HyperDash":false},{"StartTime":67233.0,"Position":135.201309,"HyperDash":false},{"StartTime":67348.0,"Position":106.616547,"HyperDash":false}]},{"StartTime":67735.0,"Objects":[{"StartTime":67735.0,"Position":32.0,"HyperDash":false},{"StartTime":67831.0,"Position":42.2565079,"HyperDash":false},{"StartTime":67928.0,"Position":78.75527,"HyperDash":false},{"StartTime":68007.0,"Position":85.89344,"HyperDash":false},{"StartTime":68122.0,"Position":125.752792,"HyperDash":false}]},{"StartTime":68316.0,"Objects":[{"StartTime":68316.0,"Position":208.0,"HyperDash":false}]},{"StartTime":68509.0,"Objects":[{"StartTime":68509.0,"Position":224.0,"HyperDash":false},{"StartTime":68605.0,"Position":240.243561,"HyperDash":false},{"StartTime":68702.0,"Position":270.729248,"HyperDash":false},{"StartTime":68781.0,"Position":291.85675,"HyperDash":false},{"StartTime":68896.0,"Position":317.7006,"HyperDash":false}]},{"StartTime":69284.0,"Objects":[{"StartTime":69284.0,"Position":216.0,"HyperDash":false},{"StartTime":69380.0,"Position":191.846649,"HyperDash":false},{"StartTime":69477.0,"Position":185.704849,"HyperDash":false},{"StartTime":69556.0,"Position":168.950912,"HyperDash":false},{"StartTime":69671.0,"Position":193.879364,"HyperDash":false}]},{"StartTime":70058.0,"Objects":[{"StartTime":70058.0,"Position":360.0,"HyperDash":false},{"StartTime":70154.0,"Position":374.986725,"HyperDash":false},{"StartTime":70251.0,"Position":367.9918,"HyperDash":false},{"StartTime":70330.0,"Position":353.6845,"HyperDash":false},{"StartTime":70445.0,"Position":337.885529,"HyperDash":false}]},{"StartTime":70832.0,"Objects":[{"StartTime":70832.0,"Position":264.0,"HyperDash":false},{"StartTime":70928.0,"Position":225.951981,"HyperDash":false},{"StartTime":71025.0,"Position":213.643036,"HyperDash":false},{"StartTime":71104.0,"Position":187.030609,"HyperDash":false},{"StartTime":71219.0,"Position":163.025146,"HyperDash":false}]},{"StartTime":71413.0,"Objects":[{"StartTime":71413.0,"Position":112.0,"HyperDash":false},{"StartTime":71509.0,"Position":75.97218,"HyperDash":false},{"StartTime":71606.0,"Position":61.6836624,"HyperDash":false},{"StartTime":71685.0,"Position":27.0878525,"HyperDash":false},{"StartTime":71800.0,"Position":11.1066208,"HyperDash":false}]},{"StartTime":71993.0,"Objects":[{"StartTime":71993.0,"Position":40.0,"HyperDash":false},{"StartTime":72071.0,"Position":52.4331474,"HyperDash":false},{"StartTime":72186.0,"Position":68.28971,"HyperDash":false}]},{"StartTime":72380.0,"Objects":[{"StartTime":72380.0,"Position":176.0,"HyperDash":false},{"StartTime":72476.0,"Position":187.970581,"HyperDash":false},{"StartTime":72573.0,"Position":161.344147,"HyperDash":false},{"StartTime":72670.0,"Position":136.575012,"HyperDash":false},{"StartTime":72767.0,"Position":119.0057,"HyperDash":false},{"StartTime":72845.0,"Position":79.55367,"HyperDash":false},{"StartTime":72960.0,"Position":69.6823959,"HyperDash":false}]},{"StartTime":73154.0,"Objects":[{"StartTime":73154.0,"Position":120.0,"HyperDash":false},{"StartTime":73250.0,"Position":160.2306,"HyperDash":false},{"StartTime":73347.0,"Position":169.814178,"HyperDash":false},{"StartTime":73426.0,"Position":170.964127,"HyperDash":false},{"StartTime":73541.0,"Position":209.453659,"HyperDash":false}]},{"StartTime":73929.0,"Objects":[{"StartTime":73929.0,"Position":312.0,"HyperDash":false},{"StartTime":74025.0,"Position":321.048035,"HyperDash":false},{"StartTime":74122.0,"Position":362.356964,"HyperDash":false},{"StartTime":74201.0,"Position":394.9694,"HyperDash":false},{"StartTime":74316.0,"Position":412.974854,"HyperDash":false}]},{"StartTime":74703.0,"Objects":[{"StartTime":74703.0,"Position":336.0,"HyperDash":false},{"StartTime":74781.0,"Position":342.880768,"HyperDash":false},{"StartTime":74896.0,"Position":315.910126,"HyperDash":false}]},{"StartTime":75090.0,"Objects":[{"StartTime":75090.0,"Position":400.0,"HyperDash":false},{"StartTime":75168.0,"Position":399.237152,"HyperDash":false},{"StartTime":75283.0,"Position":417.9073,"HyperDash":false}]},{"StartTime":75477.0,"Objects":[{"StartTime":75477.0,"Position":328.0,"HyperDash":false},{"StartTime":75573.0,"Position":296.892883,"HyperDash":false},{"StartTime":75670.0,"Position":288.19165,"HyperDash":false},{"StartTime":75767.0,"Position":275.9188,"HyperDash":false},{"StartTime":75864.0,"Position":238.263733,"HyperDash":false},{"StartTime":75942.0,"Position":221.022842,"HyperDash":false},{"StartTime":76057.0,"Position":202.919159,"HyperDash":false}]},{"StartTime":76251.0,"Objects":[{"StartTime":76251.0,"Position":296.0,"HyperDash":false},{"StartTime":76347.0,"Position":313.798157,"HyperDash":false},{"StartTime":76444.0,"Position":346.261322,"HyperDash":false},{"StartTime":76523.0,"Position":375.263733,"HyperDash":false},{"StartTime":76638.0,"Position":392.493958,"HyperDash":false}]},{"StartTime":77219.0,"Objects":[{"StartTime":77219.0,"Position":152.0,"HyperDash":false},{"StartTime":77315.0,"Position":119.697678,"HyperDash":false},{"StartTime":77412.0,"Position":101.0,"HyperDash":false},{"StartTime":77491.0,"Position":137.689911,"HyperDash":false},{"StartTime":77606.0,"Position":152.0,"HyperDash":false}]},{"StartTime":77800.0,"Objects":[{"StartTime":77800.0,"Position":320.0,"HyperDash":false}]},{"StartTime":78187.0,"Objects":[{"StartTime":78187.0,"Position":320.0,"HyperDash":false},{"StartTime":78265.0,"Position":323.92218,"HyperDash":false},{"StartTime":78380.0,"Position":369.294647,"HyperDash":false}]},{"StartTime":78574.0,"Objects":[{"StartTime":78574.0,"Position":456.0,"HyperDash":false},{"StartTime":78670.0,"Position":443.684448,"HyperDash":false},{"StartTime":78767.0,"Position":433.251038,"HyperDash":false},{"StartTime":78846.0,"Position":411.9393,"HyperDash":false},{"StartTime":78961.0,"Position":410.384216,"HyperDash":false}]},{"StartTime":79348.0,"Objects":[{"StartTime":79348.0,"Position":288.0,"HyperDash":false},{"StartTime":79444.0,"Position":287.315552,"HyperDash":false},{"StartTime":79541.0,"Position":310.748962,"HyperDash":false},{"StartTime":79620.0,"Position":322.0607,"HyperDash":false},{"StartTime":79735.0,"Position":333.615784,"HyperDash":false}]},{"StartTime":80122.0,"Objects":[{"StartTime":80122.0,"Position":240.0,"HyperDash":false},{"StartTime":80218.0,"Position":206.699463,"HyperDash":false},{"StartTime":80315.0,"Position":192.5893,"HyperDash":false},{"StartTime":80394.0,"Position":180.9993,"HyperDash":false},{"StartTime":80509.0,"Position":144.773514,"HyperDash":false}]},{"StartTime":80703.0,"Objects":[{"StartTime":80703.0,"Position":64.0,"HyperDash":false}]},{"StartTime":80896.0,"Objects":[{"StartTime":80896.0,"Position":40.0,"HyperDash":false},{"StartTime":80992.0,"Position":52.30054,"HyperDash":false},{"StartTime":81089.0,"Position":87.4107056,"HyperDash":false},{"StartTime":81168.0,"Position":99.0006943,"HyperDash":false},{"StartTime":81283.0,"Position":135.226486,"HyperDash":false}]},{"StartTime":81671.0,"Objects":[{"StartTime":81671.0,"Position":248.0,"HyperDash":false},{"StartTime":81767.0,"Position":248.315552,"HyperDash":false},{"StartTime":81864.0,"Position":270.748962,"HyperDash":false},{"StartTime":81943.0,"Position":270.0607,"HyperDash":false},{"StartTime":82058.0,"Position":293.615784,"HyperDash":false}]},{"StartTime":82445.0,"Objects":[{"StartTime":82445.0,"Position":120.0,"HyperDash":false}]},{"StartTime":82832.0,"Objects":[{"StartTime":82832.0,"Position":312.0,"HyperDash":false}]},{"StartTime":83219.0,"Objects":[{"StartTime":83219.0,"Position":400.0,"HyperDash":false},{"StartTime":83297.0,"Position":406.999,"HyperDash":false},{"StartTime":83412.0,"Position":412.369324,"HyperDash":false}]},{"StartTime":83606.0,"Objects":[{"StartTime":83606.0,"Position":360.0,"HyperDash":false},{"StartTime":83684.0,"Position":344.762848,"HyperDash":false},{"StartTime":83799.0,"Position":342.0927,"HyperDash":false}]},{"StartTime":83993.0,"Objects":[{"StartTime":83993.0,"Position":272.0,"HyperDash":false},{"StartTime":84089.0,"Position":267.17865,"HyperDash":false},{"StartTime":84186.0,"Position":223.813,"HyperDash":false},{"StartTime":84265.0,"Position":218.85318,"HyperDash":false},{"StartTime":84380.0,"Position":179.797424,"HyperDash":false}]},{"StartTime":84767.0,"Objects":[{"StartTime":84767.0,"Position":80.0,"HyperDash":false},{"StartTime":84845.0,"Position":91.5179,"HyperDash":false},{"StartTime":84960.0,"Position":96.12762,"HyperDash":false}]},{"StartTime":85154.0,"Objects":[{"StartTime":85154.0,"Position":16.0,"HyperDash":false},{"StartTime":85232.0,"Position":0.0,"HyperDash":false},{"StartTime":85347.0,"Position":16.0,"HyperDash":false}]},{"StartTime":85542.0,"Objects":[{"StartTime":85542.0,"Position":104.0,"HyperDash":false},{"StartTime":85638.0,"Position":112.302322,"HyperDash":false},{"StartTime":85735.0,"Position":154.868225,"HyperDash":false},{"StartTime":85814.0,"Position":182.689911,"HyperDash":false},{"StartTime":85929.0,"Position":206.0,"HyperDash":false}]},{"StartTime":86316.0,"Objects":[{"StartTime":86316.0,"Position":376.0,"HyperDash":false},{"StartTime":86412.0,"Position":382.0039,"HyperDash":false},{"StartTime":86509.0,"Position":424.2578,"HyperDash":false},{"StartTime":86588.0,"Position":445.011047,"HyperDash":false},{"StartTime":86703.0,"Position":472.7657,"HyperDash":false}]},{"StartTime":87090.0,"Objects":[{"StartTime":87090.0,"Position":296.0,"HyperDash":false},{"StartTime":87186.0,"Position":311.353729,"HyperDash":false},{"StartTime":87283.0,"Position":308.602417,"HyperDash":false},{"StartTime":87362.0,"Position":307.240021,"HyperDash":false},{"StartTime":87477.0,"Position":312.385956,"HyperDash":false}]},{"StartTime":87864.0,"Objects":[{"StartTime":87864.0,"Position":24.0,"HyperDash":false}]},{"StartTime":88251.0,"Objects":[{"StartTime":88251.0,"Position":249.0,"HyperDash":false},{"StartTime":88347.0,"Position":233.0,"HyperDash":false},{"StartTime":88444.0,"Position":449.0,"HyperDash":false},{"StartTime":88541.0,"Position":411.0,"HyperDash":false},{"StartTime":88638.0,"Position":75.0,"HyperDash":false},{"StartTime":88735.0,"Position":474.0,"HyperDash":false},{"StartTime":88831.0,"Position":176.0,"HyperDash":false},{"StartTime":88928.0,"Position":1.0,"HyperDash":false},{"StartTime":89025.0,"Position":37.0,"HyperDash":false},{"StartTime":89122.0,"Position":481.0,"HyperDash":false},{"StartTime":89219.0,"Position":375.0,"HyperDash":false},{"StartTime":89315.0,"Position":407.0,"HyperDash":false},{"StartTime":89412.0,"Position":231.0,"HyperDash":false},{"StartTime":89509.0,"Position":338.0,"HyperDash":false},{"StartTime":89606.0,"Position":322.0,"HyperDash":false},{"StartTime":89703.0,"Position":347.0,"HyperDash":false},{"StartTime":89800.0,"Position":365.0,"HyperDash":false}]}]}
\ No newline at end of file
diff --git a/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052.osu b/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052.osu
new file mode 100644
index 0000000000..a0cecc1b18
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Resources/Testing/Beatmaps/1041052.osu
@@ -0,0 +1,210 @@
+osu file format v14
+
+[General]
+AudioFilename: audio.mp3
+AudioLeadIn: 0
+PreviewTime: 65316
+Countdown: 0
+SampleSet: Soft
+StackLeniency: 0.7
+Mode: 2
+LetterboxInBreaks: 0
+WidescreenStoryboard: 0
+
+[Editor]
+DistanceSpacing: 1.4
+BeatDivisor: 4
+GridSize: 8
+TimelineZoom: 1.4
+
+[Metadata]
+Title:Nanairo Symphony -TV Size-
+TitleUnicode:七色シンフォニー -TV Size-
+Artist:Coalamode.
+ArtistUnicode:コアラモード．
+Creator:Ascendance
+Version:Aru's Cup
+Source:四月は君の嘘
+Tags:shigatsu wa kimi no uso your lie in april opening arusamour tenshichan [superstar]
+BeatmapID:1041052
+BeatmapSetID:488149
+
+[Difficulty]
+HPDrainRate:3
+CircleSize:2.5
+OverallDifficulty:6
+ApproachRate:6
+SliderMultiplier:1.02
+SliderTickRate:2
+
+[Events]
+//Background and Video events
+Video,500,"forty.avi"
+0,0,"cropped-1366-768-647733.jpg",0,0
+//Break Periods
+//Storyboard Layer 0 (Background)
+//Storyboard Layer 1 (Fail)
+//Storyboard Layer 2 (Pass)
+//Storyboard Layer 3 (Foreground)
+//Storyboard Sound Samples
+
+[TimingPoints]
+1155,387.096774193548,4,2,1,50,1,0
+15284,-100,4,2,1,60,0,0
+16638,-100,4,2,1,50,0,0
+41413,-100,4,2,1,60,0,0
+59993,-100,4,2,1,65,0,0
+66187,-100,4,2,1,70,0,1
+87284,-100,4,2,1,60,0,1
+87864,-100,4,2,1,70,0,0
+87961,-100,4,2,1,50,0,0
+88638,-100,4,2,1,30,0,0
+89413,-100,4,2,1,10,0,0
+89800,-100,4,2,1,5,0,0
+
+
+[Colours]
+Combo1 : 255,128,64
+Combo2 : 0,128,255
+Combo3 : 255,128,192
+Combo4 : 0,128,192
+
+[HitObjects]
+208,160,1155,6,0,L|45:160,1,153,2|2,0:0|0:0,0:0:0:0:
+160,160,2122,1,0,0:0:0:0:
+272,160,2509,1,2,0:0:0:0:
+448,288,3284,6,0,P|480:240|480:192,1,102,2|0,0:0|0:0,0:0:0:0:
+384,96,4058,1,2,0:0:0:0:
+128,64,5025,6,0,L|32:64,2,76.5,2|0|0,0:0|0:0|0:0,0:0:0:0:
+192,64,5800,1,2,0:0:0:0:
+240,64,5993,1,2,0:0:0:0:
+288,64,6187,1,2,0:0:0:0:
+416,80,6574,6,0,L|192:80,1,204,0|2,0:0|0:0,0:0:0:0:
+488,160,8122,2,0,L|376:160,1,102
+457,288,8896,2,0,L|297:288,1,153,2|2,0:0|0:0,0:0:0:0:
+400,288,10058,1,0,0:0:0:0:
+304,288,10445,6,0,L|192:288,2,102,2|0|2,0:0|0:0|0:0,0:0:0:0:
+400,288,11606,1,0,0:0:0:0:
+240,288,11993,2,0,L|80:288,1,153,2|0,0:0|0:0,0:0:0:0:
+0,288,13154,1,0,0:0:0:0:
+112,240,13542,6,0,P|160:288|256:288,1,153,6|2,0:0|0:0,0:0:0:0:
+288,288,14316,2,0,L|368:288,2,76.5,2|0|0,0:0|0:0|0:0,0:0:0:0:
+192,288,15284,2,0,L|160:224,1,51,0|12,0:0|0:0,0:0:0:0:
+312,208,15864,1,6,0:0:0:0:
+128,176,16638,6,0,P|64:160|0:96,2,153,6|2|0,0:0|0:0|0:0,0:0:0:0:
+224,176,18187,2,0,P|288:192|352:272,2,153,2|2|0,0:0|0:0|0:0,0:0:0:0:
+128,176,19735,6,0,L|288:176,1,153,2|2,0:0|0:0,0:0:0:0:
+432,176,20896,1,0,0:0:0:0:
+328,176,21284,2,0,L|488:176,1,153,2|2,0:0|0:0,0:0:0:0:
+328,176,22445,1,0,0:0:0:0:
+224,176,22832,6,0,L|64:176,1,153,2|2,0:0|0:0,0:0:0:0:
+224,176,23993,1,0,0:0:0:0:
+112,176,24380,2,0,L|272:176,1,153,2|2,0:0|0:0,0:0:0:0:
+416,176,25541,1,0,0:0:0:0:
+304,256,25929,6,0,P|272:208|312:120,1,153,2|2,0:0|0:0,0:0:0:0:
+480,112,27090,1,0,0:0:0:0:
+384,112,27477,6,0,L|320:112,2,51,2|2|0,0:0|0:0|0:0,0:0:0:0:
+432,112,28058,1,2,0:0:0:0:
+333,112,28445,2,0,L|282:112,2,51,0|0|0,0:0|0:0|0:0,0:0:0:0:
+384,112,29025,6,0,L|272:112,1,102,6|0,0:0|0:0,0:0:0:0:
+224,112,29606,2,0,P|160:144|160:240,1,153,2|2,0:0|0:0,0:0:0:0:
+272,272,30574,2,0,L|374:272,1,102
+424,272,31154,2,0,P|414:344|348:378,1,153,0|0,0:0|0:0,0:0:0:0:
+224,304,32122,6,0,P|176:320|144:368,1,102,2|0,0:0|0:0,0:0:0:0:
+200,368,32703,1,2,0:0:0:0:
+376,368,33284,1,0,0:0:0:0:
+304,296,33671,2,0,L|240:296,2,51,2|2|0,0:0|0:0|0:0,0:0:0:0:
+352,296,34251,2,0,P|400:248|384:168,1,153,2|0,0:0|0:0,0:0:0:0:
+280,176,35219,6,0,L|216:80,1,102,2|0,0:0|0:0,0:0:0:0:
+272,104,35800,2,0,L|336:8,1,102,2|0,0:0|0:0,0:0:0:0:
+280,16,36380,1,2,0:0:0:0:
+176,32,36767,6,0,L|112:128,1,102,2|0,0:0|0:0,0:0:0:0:
+168,128,37348,2,0,L|232:224,1,102,2|0,0:0|0:0,0:0:0:0:
+176,224,37928,1,2,0:0:0:0:
+304,264,38316,6,0,L|200:264,1,102,2|0,0:0|0:0,0:0:0:0:
+144,264,38896,1,2,0:0:0:0:
+280,336,39477,2,0,L|336:336,1,51
+424,336,39864,2,0,P|440:304|416:240,1,102,8|0,0:3|0:3,0:3:0:0:
+352,232,40445,1,4,0:1:0:0:
+160,224,41025,1,8,0:3:0:0:
+256,48,41413,6,0,P|302:28|353:31,1,102,6|0,0:0|0:0,0:0:0:0:
+400,40,41993,1,0,0:0:0:0:
+440,80,42187,2,0,P|389:76|342:96,1,102,2|8,0:0|0:0,0:0:0:0:
+248,128,42961,2,0,P|312:176|392:144,2,153,2|2|8,0:0|0:0|0:3,0:0:0:0:
+144,136,44509,6,0,P|80:88|0:120,1,153,2|0,0:0|0:0,0:0:0:0:
+56,136,45284,1,2,0:0:0:0:
+160,144,45671,1,8,0:0:0:0:
+264,144,46058,2,0,L|384:144,1,102,2|0,0:0|0:0,0:0:0:0:
+416,152,46638,2,0,L|264:152,1,153,2|8,0:0|0:3,0:0:0:0:
+360,120,47606,6,0,L|192:120,1,153,2|0,0:0|0:0,0:0:0:0:
+160,128,48380,2,0,P|208:80|256:96,1,102,2|8,0:0|0:0,0:0:0:0:
+144,136,49154,1,2,0:0:0:0:
+248,144,49542,2,0,L|368:144,1,102,0|2,0:0|0:0,0:0:0:0:
+256,192,50316,2,0,L|200:192,1,51,10|0,0:0|0:0,0:0:0:0:
+256,184,50703,6,0,L|360:184,1,102,2|0,0:0|0:0,0:0:0:0:
+400,208,51284,1,0,0:0:0:0:
+352,240,51477,2,0,L|240:240,1,102
+128,336,52251,6,0,P|64:336|0:256,1,153,2|2,0:0|0:0,0:0:0:0:
+88,264,53025,1,2,0:0:0:0:
+168,208,53413,2,0,L|152:144,1,51,8|8,0:0|0:3,0:0:0:0:
+248,120,53800,6,0,P|328:152|392:120,1,153,6|0,0:0|0:0,0:0:0:0:
+432,120,54574,1,2,0:0:0:0:
+328,128,54961,1,8,0:0:0:0:
+224,128,55348,6,0,L|112:144,1,102,2|0,0:0|0:0,0:0:0:0:
+72,152,55929,2,0,L|192:176,1,102,2|0,0:0|0:0,0:0:0:0:
+224,184,56509,1,8,0:3:0:0:
+328,176,56896,6,0,P|376:208|472:192,1,153,2|0,0:0|0:0,0:0:0:0:
+416,208,57671,2,0,L|304:240,1,102,2|8,0:0|0:0,0:0:0:0:
+224,272,58445,5,2,0:0:0:0:
+320,296,58832,1,0,0:0:0:0:
+224,328,59219,1,2,0:0:0:0:
+120,328,59606,1,8,0:3:0:0:
+224,264,59993,6,0,P|224:200|192:152,1,102,6|0,0:0|0:0,0:0:0:0:
+80,184,60767,2,0,P|76:133|97:87,1,102,2|8,0:0|0:0,0:0:0:0:
+200,80,61542,2,0,P|232:112|296:112,1,102,2|0,0:0|0:0,0:0:0:0:
+376,160,62316,2,0,P|344:192|280:192,1,102,2|8,0:0|0:0,0:0:0:0:
+184,240,63090,6,0,L|200:128,1,102,2|8,0:0|0:0,0:0:0:0:
+88,136,63864,2,0,L|8:152,2,76.5,6|2|2,0:0|0:0|0:0,0:0:0:0:
+160,112,64638,1,8,0:0:0:0:
+208,128,64832,1,8,0:0:0:0:
+256,144,65025,1,8,0:0:0:0:
+360,152,65413,6,0,L|424:152,1,51,8|0,0:0|0:0,0:0:0:0:
+462,152,65800,2,0,L|398:152,1,51,8|8,0:0|0:3,0:0:0:0:
+344,144,66187,6,0,L|232:144,1,102,12|8,0:0|0:0,0:0:0:0:
+152,120,66961,2,0,P|148:169|107:196,1,102,8|8,0:0|0:0,0:0:0:0:
+32,264,67735,6,0,L|144:216,1,102,8|8,0:0|0:0,0:0:0:0:
+176,208,68316,1,0,0:0:0:0:
+224,200,68509,2,0,L|317:240,1,102,8|8,0:0|0:0,0:0:0:0:
+216,256,69284,6,0,P|184:304|200:352,1,102,8|8,0:0|0:0,0:0:0:0:
+360,256,70058,2,0,P|368:207|337:167,1,102,8|8,0:0|0:0,0:0:0:0:
+264,80,70832,6,0,L|152:96,1,102,8|8,0:0|0:0,0:0:0:0:
+112,104,71413,2,0,L|11:89,1,102,8|0,0:0|0:0,0:0:0:0:
+40,128,71993,2,0,L|72:176,1,51,8|8,0:0|0:3,0:0:0:0:
+176,216,72380,6,0,P|144:280|64:280,1,153,12|0,0:0|0:0,0:0:0:0:
+120,280,73154,2,0,P|191:299|216:328,1,102,8|8,0:0|0:0,0:0:0:0:
+312,320,73929,6,0,L|424:304,1,102,8|8,0:0|0:0,0:0:0:0:
+336,272,74703,2,0,L|312:216,1,51,8|0,0:0|0:0,0:0:0:0:
+400,200,75090,2,0,L|424:136,1,51,8|0,0:0|0:0,0:0:0:0:
+328,152,75477,6,0,P|280:184|200:136,1,153,12|0,0:0|0:0,0:0:0:0:
+296,136,76251,2,0,P|360:136|408:168,1,102,8|8,0:0|0:0,0:0:0:0:
+152,248,77219,6,0,L|96:248,2,51,0|12|0,0:0|0:0|0:0,0:0:0:0:
+208,248,77800,1,8,0:0:0:0:
+320,256,78187,2,0,L|369:243,1,51,8|8,0:0|0:3,0:0:0:0:
+456,232,78574,6,0,L|408:136,1,102,12|8,0:0|0:0,0:0:0:0:
+288,136,79348,2,0,L|336:40,1,102,8|8,0:0|0:0,0:0:0:0:
+240,80,80122,6,0,P|144:80|128:64,1,102,8|8,0:0|0:0,0:0:0:0:
+96,72,80703,1,0,0:0:0:0:
+40,104,80896,2,0,P|136:104|152:88,1,102,8|8,0:0|0:0,0:0:0:0:
+248,128,81671,6,0,L|296:224,1,102,12|8,0:0|0:0,0:0:0:0:
+208,272,82445,1,10,0:0:0:0:
+312,272,82832,1,8,0:0:0:0:
+400,224,83219,6,0,L|416:160,1,51,8|2,0:0|0:0,0:0:0:0:
+360,56,83606,2,0,L|336:120,1,51,8|0,0:0|0:0,0:0:0:0:
+272,152,83993,2,0,P|192:152|176:136,1,102,0|8,0:0|0:0,0:0:0:0:
+80,160,84767,6,0,L|96:208,1,51,8|0,0:0|0:0,0:0:0:0:
+16,272,85154,2,0,L|16:328,1,51,8|0,0:0|0:0,0:0:0:0:
+104,304,85542,2,0,L|208:304,1,102,2|8,0:0|0:0,0:0:0:0:
+376,336,86316,6,0,L|472:304,1,102,4|0,0:0|0:0,0:0:0:0:
+296,248,87090,2,0,P|312:168|312:136,1,102,2|8,0:0|0:3,0:0:0:0:
+168,96,87864,1,4,0:0:0:0:
+256,192,88251,12,0,89800,0:0:0:0:

From 285adcb00e65abbcaad8d6a7cffedcc416949ab5 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Mar 2024 00:19:45 +0300
Subject: [PATCH 251/930] Fix catch hit object position getting randomised when
 last object has pos=0

---
 osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
index 200018f28b..198f8f59c6 100644
--- a/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Beatmaps/CatchBeatmapProcessor.cs
@@ -118,7 +118,11 @@ namespace osu.Game.Rulesets.Catch.Beatmaps
             float offsetPosition = hitObject.OriginalX;
             double startTime = hitObject.StartTime;
 
-            if (lastPosition == null)
+            if (lastPosition == null ||
+                // some objects can get assigned position zero, making stable incorrectly go inside this if branch on the next object. to maintain behaviour and compatibility, do the same here.
+                // reference: https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/GameplayElements/HitObjects/Fruits/HitFactoryFruits.cs#L45-L50
+                // todo: should be revisited and corrected later probably.
+                lastPosition == 0)
             {
                 lastPosition = offsetPosition;
                 lastStartTime = startTime;

From 85f131d2f87f7da733c542a38ae8cd6804a43f89 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 2 Mar 2024 22:45:15 +0300
Subject: [PATCH 252/930] Fix "unranked explaination" tooltip text using
 incorrect translation key

---
 osu.Game/Localisation/ModSelectOverlayStrings.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Localisation/ModSelectOverlayStrings.cs b/osu.Game/Localisation/ModSelectOverlayStrings.cs
index 9513eacf02..7a9bb698d8 100644
--- a/osu.Game/Localisation/ModSelectOverlayStrings.cs
+++ b/osu.Game/Localisation/ModSelectOverlayStrings.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Performance points will not be granted due to active mods."
         /// </summary>
-        public static LocalisableString UnrankedExplanation => new TranslatableString(getKey(@"ranked_explanation"), @"Performance points will not be granted due to active mods.");
+        public static LocalisableString UnrankedExplanation => new TranslatableString(getKey(@"unranked_explanation"), @"Performance points will not be granted due to active mods.");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }

From c05007804fb715b5d542535bcb224d5bd67b8b58 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 3 Mar 2024 20:46:58 +0300
Subject: [PATCH 253/930] Use more direct way to apply transforms

---
 .../Formats/LegacyStoryboardDecoder.cs        |  2 +-
 osu.Game/Storyboards/CommandTimeline.cs       | 10 ++-
 osu.Game/Storyboards/CommandTimelineGroup.cs  | 23 +++---
 osu.Game/Storyboards/StoryboardSprite.cs      | 77 +++++++++++++------
 4 files changed, 75 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index cf4700bf85..a9a4d9cc49 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -212,7 +212,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Scale.Add(easing, startTime, endTime, startValue, endValue);
+                                timelineGroup?.Scale.Add(easing, startTime, endTime, new Vector2(startValue), new Vector2(endValue));
                                 break;
                             }
 
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
index 0650c97165..2bb606d2bb 100644
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ b/osu.Game/Storyboards/CommandTimeline.cs
@@ -24,6 +24,13 @@ namespace osu.Game.Storyboards
         public T StartValue { get; private set; }
         public T EndValue { get; private set; }
 
+        public string PropertyName { get; }
+
+        public CommandTimeline(string propertyName)
+        {
+            PropertyName = propertyName;
+        }
+
         public void Add(Easing easing, double startTime, double endTime, T startValue, T endValue)
         {
             if (endTime < startTime)
@@ -31,7 +38,7 @@ namespace osu.Game.Storyboards
                 endTime = startTime;
             }
 
-            commands.Add(new TypedCommand { Easing = easing, StartTime = startTime, EndTime = endTime, StartValue = startValue, EndValue = endValue });
+            commands.Add(new TypedCommand { Easing = easing, StartTime = startTime, EndTime = endTime, StartValue = startValue, EndValue = endValue, PropertyName = PropertyName });
 
             if (startTime < StartTime)
             {
@@ -55,6 +62,7 @@ namespace osu.Game.Storyboards
             public double StartTime { get; set; }
             public double EndTime { get; set; }
             public double Duration => EndTime - StartTime;
+            public string PropertyName { get; set; }
 
             public T StartValue;
             public T EndValue;
diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index 0b96db6861..cb795e0ffe 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.cs
@@ -3,11 +3,11 @@
 
 using System;
 using osuTK;
-using osuTK.Graphics;
 using osu.Framework.Graphics;
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
+using osu.Framework.Graphics.Colour;
 
 namespace osu.Game.Storyboards
 {
@@ -15,16 +15,16 @@ namespace osu.Game.Storyboards
 
     public class CommandTimelineGroup
     {
-        public CommandTimeline<float> X = new CommandTimeline<float>();
-        public CommandTimeline<float> Y = new CommandTimeline<float>();
-        public CommandTimeline<float> Scale = new CommandTimeline<float>();
-        public CommandTimeline<Vector2> VectorScale = new CommandTimeline<Vector2>();
-        public CommandTimeline<float> Rotation = new CommandTimeline<float>();
-        public CommandTimeline<Color4> Colour = new CommandTimeline<Color4>();
-        public CommandTimeline<float> Alpha = new CommandTimeline<float>();
-        public CommandTimeline<BlendingParameters> BlendingParameters = new CommandTimeline<BlendingParameters>();
-        public CommandTimeline<bool> FlipH = new CommandTimeline<bool>();
-        public CommandTimeline<bool> FlipV = new CommandTimeline<bool>();
+        public CommandTimeline<float> X = new CommandTimeline<float>("X");
+        public CommandTimeline<float> Y = new CommandTimeline<float>("Y");
+        public CommandTimeline<Vector2> Scale = new CommandTimeline<Vector2>("Scale");
+        public CommandTimeline<Vector2> VectorScale = new CommandTimeline<Vector2>("VectorScale");
+        public CommandTimeline<float> Rotation = new CommandTimeline<float>("Rotation");
+        public CommandTimeline<ColourInfo> Colour = new CommandTimeline<ColourInfo>("Colour");
+        public CommandTimeline<float> Alpha = new CommandTimeline<float>("Alpha");
+        public CommandTimeline<BlendingParameters> BlendingParameters = new CommandTimeline<BlendingParameters>("Blending");
+        public CommandTimeline<bool> FlipH = new CommandTimeline<bool>("FlipH");
+        public CommandTimeline<bool> FlipV = new CommandTimeline<bool>("FlipV");
 
         private readonly ICommandTimeline[] timelines;
 
@@ -109,6 +109,7 @@ namespace osu.Game.Storyboards
                         EndTime = offset + command.EndTime,
                         StartValue = command.StartValue,
                         EndValue = command.EndValue,
+                        PropertyName = command.PropertyName
                     });
             }
 
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 982185d51b..4d3f1c158f 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -98,8 +98,6 @@ namespace osu.Game.Storyboards
 
         private delegate void DrawablePropertyInitializer<in T>(Drawable drawable, T value);
 
-        private delegate void DrawableTransformer<in T>(Drawable drawable, T value, double duration, Easing easing);
-
         public StoryboardSprite(string path, Anchor origin, Vector2 initialPosition)
         {
             Path = path;
@@ -132,27 +130,23 @@ namespace osu.Game.Storyboards
 
             List<IGeneratedCommand> generated = new List<IGeneratedCommand>();
 
-            generateCommands(generated, getCommands(g => g.X, triggeredGroups), (d, value) => d.X = value, (d, value, duration, easing) => d.MoveToX(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.Y, triggeredGroups), (d, value) => d.Y = value, (d, value, duration, easing) => d.MoveToY(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.Scale, triggeredGroups), (d, value) => d.Scale = new Vector2(value), (d, value, duration, easing) => d.ScaleTo(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.Rotation, triggeredGroups), (d, value) => d.Rotation = value, (d, value, duration, easing) => d.RotateTo(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.Colour, triggeredGroups), (d, value) => d.Colour = value, (d, value, duration, easing) => d.FadeColour(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.Alpha, triggeredGroups), (d, value) => d.Alpha = value, (d, value, duration, easing) => d.FadeTo(value, duration, easing));
-            generateCommands(generated, getCommands(g => g.BlendingParameters, triggeredGroups), (d, value) => d.Blending = value, (d, value, duration, _) => d.TransformBlendingMode(value, duration),
-                false);
+            generateCommands(generated, getCommands(g => g.X, triggeredGroups), (d, value) => d.X = value);
+            generateCommands(generated, getCommands(g => g.Y, triggeredGroups), (d, value) => d.Y = value);
+            generateCommands(generated, getCommands(g => g.Scale, triggeredGroups), (d, value) => d.Scale = value);
+            generateCommands(generated, getCommands(g => g.Rotation, triggeredGroups), (d, value) => d.Rotation = value);
+            generateCommands(generated, getCommands(g => g.Colour, triggeredGroups), (d, value) => d.Colour = value);
+            generateCommands(generated, getCommands(g => g.Alpha, triggeredGroups), (d, value) => d.Alpha = value);
+            generateCommands(generated, getCommands(g => g.BlendingParameters, triggeredGroups), (d, value) => d.Blending = value, false);
 
             if (drawable is IVectorScalable vectorScalable)
             {
-                generateCommands(generated, getCommands(g => g.VectorScale, triggeredGroups), (_, value) => vectorScalable.VectorScale = value,
-                    (_, value, duration, easing) => vectorScalable.VectorScaleTo(value, duration, easing));
+                generateCommands(generated, getCommands(g => g.VectorScale, triggeredGroups), (_, value) => vectorScalable.VectorScale = value);
             }
 
             if (drawable is IFlippable flippable)
             {
-                generateCommands(generated, getCommands(g => g.FlipH, triggeredGroups), (_, value) => flippable.FlipH = value, (_, value, duration, _) => flippable.TransformFlipH(value, duration),
-                    false);
-                generateCommands(generated, getCommands(g => g.FlipV, triggeredGroups), (_, value) => flippable.FlipV = value, (_, value, duration, _) => flippable.TransformFlipV(value, duration),
-                    false);
+                generateCommands(generated, getCommands(g => g.FlipH, triggeredGroups), (_, value) => flippable.FlipH = value, false);
+                generateCommands(generated, getCommands(g => g.FlipV, triggeredGroups), (_, value) => flippable.FlipV = value, false);
             }
 
             foreach (var command in generated.OrderBy(g => g.StartTime))
@@ -160,7 +154,7 @@ namespace osu.Game.Storyboards
         }
 
         private void generateCommands<T>(List<IGeneratedCommand> resultList, IEnumerable<CommandTimeline<T>.TypedCommand> commands,
-                                         DrawablePropertyInitializer<T> initializeProperty, DrawableTransformer<T> transform, bool alwaysInitialize = true)
+                                         DrawablePropertyInitializer<T> initializeProperty, bool alwaysInitialize = true)
         {
             bool initialized = false;
 
@@ -175,7 +169,7 @@ namespace osu.Game.Storyboards
                     initialized = true;
                 }
 
-                resultList.Add(new GeneratedCommand<T>(command, initFunc, transform));
+                resultList.Add(new GeneratedCommand<T>(command, initFunc));
             }
         }
 
@@ -209,24 +203,59 @@ namespace osu.Game.Storyboards
             public double StartTime => command.StartTime;
 
             private readonly DrawablePropertyInitializer<T>? initializeProperty;
-            private readonly DrawableTransformer<T> transform;
             private readonly CommandTimeline<T>.TypedCommand command;
 
-            public GeneratedCommand(CommandTimeline<T>.TypedCommand command, DrawablePropertyInitializer<T>? initializeProperty, DrawableTransformer<T> transform)
+            public GeneratedCommand(CommandTimeline<T>.TypedCommand command, DrawablePropertyInitializer<T>? initializeProperty)
             {
                 this.command = command;
                 this.initializeProperty = initializeProperty;
-                this.transform = transform;
             }
 
             public void ApplyTo(Drawable drawable)
             {
                 initializeProperty?.Invoke(drawable, command.StartValue);
 
-                using (drawable.BeginAbsoluteSequence(command.StartTime))
+                switch (command.PropertyName)
                 {
-                    transform(drawable, command.StartValue, 0, Easing.None);
-                    transform(drawable, command.EndValue, command.Duration, command.Easing);
+                    case "VectorScale":
+                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        {
+                            ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                        }
+
+                        break;
+
+                    case "FlipH":
+                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        {
+                            ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
+                        }
+
+                        break;
+
+                    case "FlipV":
+                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        {
+                            ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
+                        }
+
+                        break;
+
+                    case "Blending":
+                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        {
+                            drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
+                        }
+
+                        break;
+
+                    default:
+                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        {
+                            drawable.TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                        }
+
+                        break;
                 }
             }
         }

From 7193ec66a4dee4abe516bd8984d3ed50559df35d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 3 Mar 2024 21:30:46 +0300
Subject: [PATCH 254/930] Make use of framework's transform loops

---
 osu.Game/Storyboards/CommandLoop.cs      | 18 ++++--
 osu.Game/Storyboards/CommandTimeline.cs  |  2 +
 osu.Game/Storyboards/StoryboardSprite.cs | 75 +++++++++++++++++++-----
 3 files changed, 76 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Storyboards/CommandLoop.cs b/osu.Game/Storyboards/CommandLoop.cs
index 480d69c12f..a912daea44 100644
--- a/osu.Game/Storyboards/CommandLoop.cs
+++ b/osu.Game/Storyboards/CommandLoop.cs
@@ -38,11 +38,21 @@ namespace osu.Game.Storyboards
 
         public override IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
         {
-            for (int loop = 0; loop < TotalIterations; loop++)
+            double fullLoopDuration = CommandsEndTime - CommandsStartTime;
+
+            foreach (var command in timelineSelector(this).Commands)
             {
-                double loopOffset = LoopStartTime + loop * CommandsDuration;
-                foreach (var command in base.GetCommands(timelineSelector, offset + loopOffset))
-                    yield return command;
+                yield return new CommandTimeline<T>.TypedCommand
+                {
+                    Easing = command.Easing,
+                    StartTime = offset + LoopStartTime + command.StartTime,
+                    EndTime = offset + LoopStartTime + command.EndTime,
+                    StartValue = command.StartValue,
+                    EndValue = command.EndValue,
+                    PropertyName = command.PropertyName,
+                    LoopCount = TotalIterations,
+                    Delay = fullLoopDuration - command.EndTime + command.StartTime
+                };
             }
         }
 
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
index 2bb606d2bb..ce25bfe25b 100644
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ b/osu.Game/Storyboards/CommandTimeline.cs
@@ -63,6 +63,8 @@ namespace osu.Game.Storyboards
             public double EndTime { get; set; }
             public double Duration => EndTime - StartTime;
             public string PropertyName { get; set; }
+            public int LoopCount { get; set; }
+            public double Delay { get; set; }
 
             public T StartValue;
             public T EndValue;
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 4d3f1c158f..2c04e4c983 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -218,41 +218,86 @@ namespace osu.Game.Storyboards
                 switch (command.PropertyName)
                 {
                     case "VectorScale":
-                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        if (command.LoopCount == 0)
                         {
-                            ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then()
+                                                           .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                            }
+                        }
+                        else
+                        {
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then()
+                                                           .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
+                                                           .Loop(command.Delay, command.LoopCount);
+                            }
                         }
 
                         break;
 
                     case "FlipH":
-                        using (drawable.BeginAbsoluteSequence(command.StartTime))
-                        {
-                            ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
-                        }
-
-                        break;
-
                     case "FlipV":
-                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        if (command.LoopCount == 0)
                         {
-                            ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                                      .TransformTo(command.PropertyName, command.EndValue);
+                            }
+                        }
+                        else
+                        {
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                                      .TransformTo(command.PropertyName, command.EndValue)
+                                                      .Loop(command.Delay, command.LoopCount);
+                            }
                         }
 
                         break;
 
                     case "Blending":
-                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        if (command.LoopCount == 0)
                         {
-                            drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue);
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                        .TransformTo(command.PropertyName, command.EndValue);
+                            }
+                        }
+                        else
+                        {
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                        .TransformTo(command.PropertyName, command.EndValue)
+                                        .Loop(command.Delay, command.LoopCount);
+                            }
                         }
 
                         break;
 
                     default:
-                        using (drawable.BeginAbsoluteSequence(command.StartTime))
+                        if (command.LoopCount == 0)
                         {
-                            drawable.TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                drawable.TransformTo(command.PropertyName, command.StartValue).Then()
+                                        .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                            }
+                        }
+                        else
+                        {
+                            using (drawable.BeginAbsoluteSequence(command.StartTime))
+                            {
+                                drawable.TransformTo(command.PropertyName, command.StartValue).Then()
+                                        .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
+                                        .Loop(command.Delay, command.LoopCount);
+                            }
                         }
 
                         break;

From f5d24e6804e64ffa720adc57116323cd682107e3 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 3 Mar 2024 21:54:37 +0300
Subject: [PATCH 255/930] Remove unused transform extensions

---
 .../Drawables/DrawablesExtensions.cs          | 30 -------------
 osu.Game/Storyboards/Drawables/IFlippable.cs  | 42 -------------------
 .../Storyboards/Drawables/IVectorScalable.cs  |  8 ----
 3 files changed, 80 deletions(-)
 delete mode 100644 osu.Game/Storyboards/Drawables/DrawablesExtensions.cs

diff --git a/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs b/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs
deleted file mode 100644
index bbc55a336d..0000000000
--- a/osu.Game/Storyboards/Drawables/DrawablesExtensions.cs
+++ /dev/null
@@ -1,30 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Transforms;
-
-namespace osu.Game.Storyboards.Drawables
-{
-    public static class DrawablesExtensions
-    {
-        /// <summary>
-        /// Adjusts <see cref="Drawable.Blending"/> after a delay.
-        /// </summary>
-        /// <returns>A <see cref="TransformSequence{T}"/> to which further transforms can be added.</returns>
-        public static TransformSequence<T> TransformBlendingMode<T>(this T drawable, BlendingParameters newValue, double delay = 0)
-            where T : Drawable
-            => drawable.TransformTo(drawable.PopulateTransform(new TransformBlendingParameters(), newValue, delay));
-    }
-
-    public class TransformBlendingParameters : Transform<BlendingParameters, Drawable>
-    {
-        private BlendingParameters valueAt(double time)
-            => time < EndTime ? StartValue : EndValue;
-
-        public override string TargetMember => nameof(Drawable.Blending);
-
-        protected override void Apply(Drawable d, double time) => d.Blending = valueAt(time);
-        protected override void ReadIntoStartValue(Drawable d) => StartValue = d.Blending;
-    }
-}
diff --git a/osu.Game/Storyboards/Drawables/IFlippable.cs b/osu.Game/Storyboards/Drawables/IFlippable.cs
index 165b3d97cc..2a931875ea 100644
--- a/osu.Game/Storyboards/Drawables/IFlippable.cs
+++ b/osu.Game/Storyboards/Drawables/IFlippable.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
 namespace osu.Game.Storyboards.Drawables
@@ -11,45 +10,4 @@ namespace osu.Game.Storyboards.Drawables
         bool FlipH { get; set; }
         bool FlipV { get; set; }
     }
-
-    internal class TransformFlipH : Transform<bool, IFlippable>
-    {
-        private bool valueAt(double time)
-            => time < EndTime ? StartValue : EndValue;
-
-        public override string TargetMember => nameof(IFlippable.FlipH);
-
-        protected override void Apply(IFlippable d, double time) => d.FlipH = valueAt(time);
-        protected override void ReadIntoStartValue(IFlippable d) => StartValue = d.FlipH;
-    }
-
-    internal class TransformFlipV : Transform<bool, IFlippable>
-    {
-        private bool valueAt(double time)
-            => time < EndTime ? StartValue : EndValue;
-
-        public override string TargetMember => nameof(IFlippable.FlipV);
-
-        protected override void Apply(IFlippable d, double time) => d.FlipV = valueAt(time);
-        protected override void ReadIntoStartValue(IFlippable d) => StartValue = d.FlipV;
-    }
-
-    internal static class FlippableExtensions
-    {
-        /// <summary>
-        /// Adjusts <see cref="IFlippable.FlipH"/> after a delay.
-        /// </summary>
-        /// <returns>A <see cref="TransformSequence{T}"/> to which further transforms can be added.</returns>
-        public static TransformSequence<T> TransformFlipH<T>(this T flippable, bool newValue, double delay = 0)
-            where T : class, IFlippable
-            => flippable.TransformTo(flippable.PopulateTransform(new TransformFlipH(), newValue, delay));
-
-        /// <summary>
-        /// Adjusts <see cref="IFlippable.FlipV"/> after a delay.
-        /// </summary>
-        /// <returns>A <see cref="TransformSequence{T}"/> to which further transforms can be added.</returns>
-        public static TransformSequence<T> TransformFlipV<T>(this T flippable, bool newValue, double delay = 0)
-            where T : class, IFlippable
-            => flippable.TransformTo(flippable.PopulateTransform(new TransformFlipV(), newValue, delay));
-    }
 }
diff --git a/osu.Game/Storyboards/Drawables/IVectorScalable.cs b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
index 60a297e126..ab0452df80 100644
--- a/osu.Game/Storyboards/Drawables/IVectorScalable.cs
+++ b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 using osuTK;
 
@@ -11,11 +10,4 @@ namespace osu.Game.Storyboards.Drawables
     {
         Vector2 VectorScale { get; set; }
     }
-
-    internal static class VectorScalableExtensions
-    {
-        public static TransformSequence<T> VectorScaleTo<T>(this T target, Vector2 newVectorScale, double duration = 0, Easing easing = Easing.None)
-            where T : class, IVectorScalable
-            => target.TransformTo(nameof(IVectorScalable.VectorScale), newVectorScale, duration, easing);
-    }
 }

From 4a7635e488169bf09dbcdfc7bf4da489a82d2b1c Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 3 Mar 2024 23:04:06 +0300
Subject: [PATCH 256/930] Fix broken tests

---
 osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index dadf3ca65f..dae3119ea4 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -73,9 +73,9 @@ namespace osu.Game.Tests.Visual.Gameplay
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
             // these should be ignored as we have an alpha visibility blocker proceeding this command.
-            sprite.TimelineGroup.Scale.Add(Easing.None, loop_start_time, -18000, 0, 1);
+            sprite.TimelineGroup.Scale.Add(Easing.None, loop_start_time, -18000, Vector2.Zero, Vector2.One);
             var loopGroup = sprite.AddLoop(loop_start_time, 50);
-            loopGroup.Scale.Add(Easing.None, loop_start_time, -18000, 0, 1);
+            loopGroup.Scale.Add(Easing.None, loop_start_time, -18000, Vector2.Zero, Vector2.One);
 
             var target = addEventToLoop ? loopGroup : sprite.TimelineGroup;
             double loopRelativeOffset = addEventToLoop ? -loop_start_time : 0;

From bce3bd55e5a863e52f41598c306a248a79638843 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 4 Mar 2024 16:08:17 +0900
Subject: [PATCH 257/930] Fix catch by moving cursor-specific handling local

---
 .../TestSceneResumeOverlay.cs                    | 16 +++++++++++++---
 osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs     |  7 +++++++
 osu.Game/Rulesets/UI/DrawableRuleset.cs          |  2 +-
 osu.Game/Screens/Play/ResumeOverlay.cs           |  3 ++-
 4 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs
index 25d0b0a3d3..b35984a2fc 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneResumeOverlay.cs
@@ -6,11 +6,11 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Cursor;
 using osu.Framework.Testing;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Rulesets.Osu.UI.Cursor;
+using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play;
 using osu.Game.Tests.Gameplay;
 using osu.Game.Tests.Visual;
@@ -21,7 +21,7 @@ namespace osu.Game.Rulesets.Osu.Tests
     public partial class TestSceneResumeOverlay : OsuManualInputManagerTestScene
     {
         private ManualOsuInputManager osuInputManager = null!;
-        private CursorContainer cursor = null!;
+        private GameplayCursorContainer cursor = null!;
         private ResumeOverlay resume = null!;
 
         private bool resumeFired;
@@ -99,7 +99,17 @@ namespace osu.Game.Rulesets.Osu.Tests
 
         private void loadContent()
         {
-            Child = osuInputManager = new ManualOsuInputManager(new OsuRuleset().RulesetInfo) { Children = new Drawable[] { cursor = new CursorContainer(), resume = new OsuResumeOverlay { GameplayCursor = cursor }, } };
+            Child = osuInputManager = new ManualOsuInputManager(new OsuRuleset().RulesetInfo)
+            {
+                Children = new Drawable[]
+                {
+                    cursor = new GameplayCursorContainer(),
+                    resume = new OsuResumeOverlay
+                    {
+                        GameplayCursor = cursor
+                    },
+                }
+            };
 
             resumeFired = false;
             resume.ResumeAction = () => resumeFired = true;
diff --git a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
index 8a84fe14e5..adc7bd97ff 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
@@ -39,6 +39,13 @@ namespace osu.Game.Rulesets.Osu.UI
 
         protected override void PopIn()
         {
+            // Can't display if the cursor is outside the window.
+            if (GameplayCursor.LastFrameState == Visibility.Hidden || !Contains(GameplayCursor.ActiveCursor.ScreenSpaceDrawQuad.Centre))
+            {
+                Resume();
+                return;
+            }
+
             base.PopIn();
 
             GameplayCursor.ActiveCursor.Hide();
diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 4aeb3d4862..218fdf5b86 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -227,7 +227,7 @@ namespace osu.Game.Rulesets.UI
 
         public override void RequestResume(Action continueResume)
         {
-            if (ResumeOverlay != null && UseResumeOverlay && (Cursor == null || (Cursor.LastFrameState == Visibility.Visible && Contains(Cursor.ActiveCursor.ScreenSpaceDrawQuad.Centre))))
+            if (ResumeOverlay != null && UseResumeOverlay)
             {
                 ResumeOverlay.GameplayCursor = Cursor;
                 ResumeOverlay.ResumeAction = continueResume;
diff --git a/osu.Game/Screens/Play/ResumeOverlay.cs b/osu.Game/Screens/Play/ResumeOverlay.cs
index fae406bd6b..a33dd79888 100644
--- a/osu.Game/Screens/Play/ResumeOverlay.cs
+++ b/osu.Game/Screens/Play/ResumeOverlay.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.UI;
 using osuTK;
 using osuTK.Graphics;
 
@@ -21,7 +22,7 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public abstract partial class ResumeOverlay : VisibilityContainer
     {
-        public CursorContainer GameplayCursor { get; set; }
+        public GameplayCursorContainer GameplayCursor { get; set; }
 
         /// <summary>
         /// The action to be performed to complete resuming.

From 6635d9be04952b43b41ff8e3f2596999a069ff74 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 4 Mar 2024 16:08:25 +0900
Subject: [PATCH 258/930] Add countdown display

---
 .../UI/DrawableCatchRuleset.cs                |   3 +-
 .../Gameplay/TestSceneDelayedResumeOverlay.cs |  44 ++++++
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 135 +++++++++++++++++-
 3 files changed, 178 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneDelayedResumeOverlay.cs

diff --git a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
index 580c90bcb4..32ebdc1159 100644
--- a/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
+++ b/osu.Game.Rulesets.Catch/UI/DrawableCatchRuleset.cs
@@ -17,6 +17,7 @@ using osu.Game.Rulesets.UI;
 using osu.Game.Rulesets.UI.Scrolling;
 using osu.Game.Scoring;
 using osu.Game.Screens.Play;
+using osuTK;
 
 namespace osu.Game.Rulesets.Catch.UI
 {
@@ -54,6 +55,6 @@ namespace osu.Game.Rulesets.Catch.UI
 
         public override DrawableHitObject<CatchHitObject>? CreateDrawableRepresentation(CatchHitObject h) => null;
 
-        protected override ResumeOverlay CreateResumeOverlay() => new DelayedResumeOverlay();
+        protected override ResumeOverlay CreateResumeOverlay() => new DelayedResumeOverlay { Scale = new Vector2(0.65f) };
     }
 }
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDelayedResumeOverlay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDelayedResumeOverlay.cs
new file mode 100644
index 0000000000..241a78b6b8
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDelayedResumeOverlay.cs
@@ -0,0 +1,44 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Play;
+using osu.Game.Tests.Gameplay;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public partial class TestSceneDelayedResumeOverlay : OsuTestScene
+    {
+        private ResumeOverlay resume = null!;
+        private bool resumeFired;
+
+        [Cached]
+        private GameplayState gameplayState;
+
+        public TestSceneDelayedResumeOverlay()
+        {
+            gameplayState = TestGameplayState.Create(new OsuRuleset());
+        }
+
+        [SetUp]
+        public void SetUp() => Schedule(loadContent);
+
+        [Test]
+        public void TestResume()
+        {
+            AddStep("show", () => resume.Show());
+            AddUntilStep("dismissed", () => resumeFired && resume.State.Value == Visibility.Hidden);
+        }
+
+        private void loadContent()
+        {
+            Child = resume = new DelayedResumeOverlay();
+
+            resumeFired = false;
+            resume.ResumeAction = () => resumeFired = true;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index ef39c8eb76..6f70a914f0 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -1,8 +1,18 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play
 {
@@ -11,21 +21,140 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public partial class DelayedResumeOverlay : ResumeOverlay
     {
+        private const double countdown_time = 800;
+
         protected override LocalisableString Message => string.Empty;
 
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
         private ScheduledDelegate? scheduledResume;
+        private int countdownCount = 3;
+        private double countdownStartTime;
+
+        private Drawable content = null!;
+        private Drawable background = null!;
+        private SpriteText countdown = null!;
+
+        public DelayedResumeOverlay()
+        {
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Add(content = new CircularContainer
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                AutoSizeAxes = Axes.Both,
+                Masking = true,
+                BorderColour = colours.Yellow,
+                BorderThickness = 1,
+                Children = new[]
+                {
+                    background = new Box
+                    {
+                        Size = new Vector2(250, 40),
+                        Colour = Color4.Black,
+                        Alpha = 0.8f
+                    },
+                    new Container
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        AutoSizeAxes = Axes.Both,
+                        Children = new Drawable[]
+                        {
+                            new FillFlowContainer
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                AutoSizeAxes = Axes.Both,
+                                Spacing = new Vector2(5),
+                                Colour = colours.Yellow,
+                                Children = new Drawable[]
+                                {
+                                    // new Box
+                                    // {
+                                    //     Anchor = Anchor.Centre,
+                                    //     Origin = Anchor.Centre,
+                                    //     Size = new Vector2(40, 3)
+                                    // },
+                                    countdown = new OsuSpriteText
+                                    {
+                                        Anchor = Anchor.Centre,
+                                        Origin = Anchor.Centre,
+                                        UseFullGlyphHeight = false,
+                                        AlwaysPresent = true,
+                                        Font = OsuFont.Numeric.With(size: 20, fixedWidth: true)
+                                    },
+                                    // new Box
+                                    // {
+                                    //     Anchor = Anchor.Centre,
+                                    //     Origin = Anchor.Centre,
+                                    //     Size = new Vector2(40, 3)
+                                    // }
+                                }
+                            }
+                        }
+                    }
+                }
+            });
+        }
 
         protected override void PopIn()
         {
-            base.PopIn();
+            this.FadeIn();
+
+            content.FadeInFromZero(150, Easing.OutQuint);
+            content.ScaleTo(new Vector2(1.5f, 1)).Then().ScaleTo(1, 150, Easing.OutElasticQuarter);
+
+            countdownCount = 3;
+            countdownStartTime = Time.Current;
 
             scheduledResume?.Cancel();
-            scheduledResume = Scheduler.AddDelayed(Resume, 800);
+            scheduledResume = Scheduler.AddDelayed(Resume, countdown_time);
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+            updateCountdown();
+        }
+
+        private void updateCountdown()
+        {
+            double amountTimePassed = Math.Min(countdown_time, Time.Current - countdownStartTime) / countdown_time;
+            int newCount = 3 - (int)Math.Floor(amountTimePassed * 3);
+
+            if (newCount > 0)
+            {
+                countdown.Alpha = 1;
+                countdown.Text = newCount.ToString();
+            }
+            else
+                countdown.Alpha = 0;
+
+            if (newCount != countdownCount)
+            {
+                if (newCount == 0)
+                    content.ScaleTo(new Vector2(1.5f, 1), 150, Easing.OutQuint);
+                else
+                    content.ScaleTo(new Vector2(1.05f, 1), 50, Easing.OutQuint).Then().ScaleTo(1, 50, Easing.Out);
+            }
+
+            countdownCount = newCount;
         }
 
         protected override void PopOut()
         {
-            base.PopOut();
+            this.Delay(150).FadeOut();
+
+            content.FadeOut(150, Easing.OutQuint);
+
             scheduledResume?.Cancel();
         }
     }

From af2b80e0304e9541378fa9fa68caad0ca347a37c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Mar 2024 11:28:34 +0100
Subject: [PATCH 259/930] Add failing encode test

---
 .../Formats/LegacyScoreDecoderTest.cs         |  2 +-
 .../Formats/LegacyScoreEncoderTest.cs         | 55 +++++++++++++++++++
 2 files changed, 56 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 7e3967dc95..43e471320e 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -432,7 +432,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             CultureInfo.CurrentCulture = originalCulture;
         }
 
-        private class TestLegacyScoreDecoder : LegacyScoreDecoder
+        public class TestLegacyScoreDecoder : LegacyScoreDecoder
         {
             private readonly int beatmapVersion;
 
diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
new file mode 100644
index 0000000000..c0a7285f39
--- /dev/null
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
@@ -0,0 +1,55 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.IO;
+using NUnit.Framework;
+using osu.Game.Beatmaps.Formats;
+using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Scoring;
+using osu.Game.Scoring;
+using osu.Game.Scoring.Legacy;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Beatmaps.Formats
+{
+    public class LegacyScoreEncoderTest
+    {
+        [TestCase(1, 3)]
+        [TestCase(1, 0)]
+        [TestCase(0, 3)]
+        public void CatchMergesFruitAndDropletMisses(int missCount, int largeTickMissCount)
+        {
+            var ruleset = new CatchRuleset().RulesetInfo;
+
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
+            var beatmap = new TestBeatmap(ruleset);
+            scoreInfo.Statistics = new Dictionary<HitResult, int>
+            {
+                [HitResult.Great] = 50,
+                [HitResult.LargeTickHit] = 5,
+                [HitResult.Miss] = missCount,
+                [HitResult.LargeTickMiss] = largeTickMissCount
+            };
+            var score = new Score { ScoreInfo = scoreInfo };
+
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
+
+            Assert.That(decodedAfterEncode.ScoreInfo.GetCountMiss(), Is.EqualTo(missCount + largeTickMissCount));
+        }
+
+        private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap)
+        {
+            var encodeStream = new MemoryStream();
+
+            var encoder = new LegacyScoreEncoder(score, beatmap);
+            encoder.Encode(encodeStream);
+
+            var decodeStream = new MemoryStream(encodeStream.GetBuffer());
+
+            var decoder = new LegacyScoreDecoderTest.TestLegacyScoreDecoder(beatmapVersion);
+            var decodedAfterEncode = decoder.Parse(decodeStream);
+            return decodedAfterEncode;
+        }
+    }
+}

From dcd6b028090a97ea1b2c43a374bb9210417b0adc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Mar 2024 11:35:31 +0100
Subject: [PATCH 260/930] Fix incorrect implementation of `GetCountMiss()` for
 catch

---
 .../Scoring/Legacy/ScoreInfoExtensions.cs     | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
index 07c35a334f..23624401e2 100644
--- a/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
+++ b/osu.Game/Scoring/Legacy/ScoreInfoExtensions.cs
@@ -198,10 +198,25 @@ namespace osu.Game.Scoring.Legacy
             }
         }
 
-        public static int? GetCountMiss(this ScoreInfo scoreInfo) =>
-            getCount(scoreInfo, HitResult.Miss);
+        public static int? GetCountMiss(this ScoreInfo scoreInfo)
+        {
+            switch (scoreInfo.Ruleset.OnlineID)
+            {
+                case 0:
+                case 1:
+                case 3:
+                    return getCount(scoreInfo, HitResult.Miss);
+
+                case 2:
+                    return (getCount(scoreInfo, HitResult.Miss) ?? 0) + (getCount(scoreInfo, HitResult.LargeTickMiss) ?? 0);
+            }
+
+            return null;
+        }
 
         public static void SetCountMiss(this ScoreInfo scoreInfo, int value) =>
+            // this does not match the implementation of `GetCountMiss()` for catch,
+            // but we physically cannot recover that data anymore at this point.
             scoreInfo.Statistics[HitResult.Miss] = value;
 
         private static int? getCount(ScoreInfo scoreInfo, HitResult result)

From b896d97a4f844498e0c1c914a0b70c4fdf70449f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Mar 2024 11:45:44 +0100
Subject: [PATCH 261/930] Fix catch pp calculator not matching live with
 respect to miss handling

---
 .../Difficulty/CatchPerformanceCalculator.cs  | 31 +++++++++----------
 1 file changed, 15 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
index b30b85be2d..d07f25ba90 100644
--- a/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Catch/Difficulty/CatchPerformanceCalculator.cs
@@ -2,22 +2,21 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
+using osu.Game.Scoring.Legacy;
 
 namespace osu.Game.Rulesets.Catch.Difficulty
 {
     public class CatchPerformanceCalculator : PerformanceCalculator
     {
-        private int fruitsHit;
-        private int ticksHit;
-        private int tinyTicksHit;
-        private int tinyTicksMissed;
-        private int misses;
+        private int num300;
+        private int num100;
+        private int num50;
+        private int numKatu;
+        private int numMiss;
 
         public CatchPerformanceCalculator()
             : base(new CatchRuleset())
@@ -28,11 +27,11 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         {
             var catchAttributes = (CatchDifficultyAttributes)attributes;
 
-            fruitsHit = score.Statistics.GetValueOrDefault(HitResult.Great);
-            ticksHit = score.Statistics.GetValueOrDefault(HitResult.LargeTickHit);
-            tinyTicksHit = score.Statistics.GetValueOrDefault(HitResult.SmallTickHit);
-            tinyTicksMissed = score.Statistics.GetValueOrDefault(HitResult.SmallTickMiss);
-            misses = score.Statistics.GetValueOrDefault(HitResult.Miss);
+            num300 = score.GetCount300() ?? 0; // HitResult.Great
+            num100 = score.GetCount100() ?? 0; // HitResult.LargeTickHit
+            num50 = score.GetCount50() ?? 0; // HitResult.SmallTickHit
+            numKatu = score.GetCountKatu() ?? 0; // HitResult.SmallTickMiss
+            numMiss = score.GetCountMiss() ?? 0; // HitResult.Miss PLUS HitResult.LargeTickMiss
 
             // We are heavily relying on aim in catch the beat
             double value = Math.Pow(5.0 * Math.Max(1.0, catchAttributes.StarRating / 0.0049) - 4.0, 2.0) / 100000.0;
@@ -45,7 +44,7 @@ namespace osu.Game.Rulesets.Catch.Difficulty
                 (numTotalHits > 2500 ? Math.Log10(numTotalHits / 2500.0) * 0.475 : 0.0);
             value *= lengthBonus;
 
-            value *= Math.Pow(0.97, misses);
+            value *= Math.Pow(0.97, numMiss);
 
             // Combo scaling
             if (catchAttributes.MaxCombo > 0)
@@ -86,8 +85,8 @@ namespace osu.Game.Rulesets.Catch.Difficulty
         }
 
         private double accuracy() => totalHits() == 0 ? 0 : Math.Clamp((double)totalSuccessfulHits() / totalHits(), 0, 1);
-        private int totalHits() => tinyTicksHit + ticksHit + fruitsHit + misses + tinyTicksMissed;
-        private int totalSuccessfulHits() => tinyTicksHit + ticksHit + fruitsHit;
-        private int totalComboHits() => misses + ticksHit + fruitsHit;
+        private int totalHits() => num50 + num100 + num300 + numMiss + numKatu;
+        private int totalSuccessfulHits() => num50 + num100 + num300;
+        private int totalComboHits() => numMiss + num100 + num300;
     }
 }

From 405958f73c560b5c3eae381255d5141e37c819c1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Mar 2024 14:43:53 +0100
Subject: [PATCH 262/930] Add test scene for drawable ranks

---
 .../Visual/Ranking/TestSceneDrawableRank.cs   | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Ranking/TestSceneDrawableRank.cs

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneDrawableRank.cs b/osu.Game.Tests/Visual/Ranking/TestSceneDrawableRank.cs
new file mode 100644
index 0000000000..804c8dfc44
--- /dev/null
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneDrawableRank.cs
@@ -0,0 +1,39 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Online.Leaderboards;
+using osu.Game.Scoring;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Ranking
+{
+    public partial class TestSceneDrawableRank : OsuTestScene
+    {
+        [Test]
+        public void TestAllRanks()
+        {
+            AddStep("create content", () => Child = new FillFlowContainer<DrawableRank>
+            {
+                AutoSizeAxes = Axes.X,
+                RelativeSizeAxes = Axes.Y,
+                Origin = Anchor.Centre,
+                Anchor = Anchor.Centre,
+                Direction = FillDirection.Vertical,
+                Padding = new MarginPadding(20),
+                Spacing = new Vector2(10),
+                ChildrenEnumerable = Enum.GetValues<ScoreRank>().OrderBy(v => v).Select(rank => new DrawableRank(rank)
+                {
+                    RelativeSizeAxes = Axes.None,
+                    Size = new Vector2(50, 25),
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre
+                })
+            });
+        }
+    }
+}

From 6080c14dd5b589c982b09365aa1b5eb74ccd14ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 4 Mar 2024 14:47:49 +0100
Subject: [PATCH 263/930] Update F rank badge colours to match latest designs

---
 osu.Game/Graphics/OsuColour.cs               | 6 +++++-
 osu.Game/Online/Leaderboards/DrawableRank.cs | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/OsuColour.cs b/osu.Game/Graphics/OsuColour.cs
index 985898958c..c479d0cfe4 100644
--- a/osu.Game/Graphics/OsuColour.cs
+++ b/osu.Game/Graphics/OsuColour.cs
@@ -63,8 +63,12 @@ namespace osu.Game.Graphics
                 case ScoreRank.C:
                     return Color4Extensions.FromHex(@"ff8e5d");
 
-                default:
+                case ScoreRank.D:
                     return Color4Extensions.FromHex(@"ff5a5a");
+
+                case ScoreRank.F:
+                default:
+                    return Color4Extensions.FromHex(@"3f3f3f");
             }
         }
 
diff --git a/osu.Game/Online/Leaderboards/DrawableRank.cs b/osu.Game/Online/Leaderboards/DrawableRank.cs
index 5177f35478..0b0ab11410 100644
--- a/osu.Game/Online/Leaderboards/DrawableRank.cs
+++ b/osu.Game/Online/Leaderboards/DrawableRank.cs
@@ -95,8 +95,12 @@ namespace osu.Game.Online.Leaderboards
                 case ScoreRank.C:
                     return Color4Extensions.FromHex(@"473625");
 
-                default:
+                case ScoreRank.D:
                     return Color4Extensions.FromHex(@"512525");
+
+                case ScoreRank.F:
+                default:
+                    return Color4Extensions.FromHex(@"CC3333");
             }
         }
     }

From 9543908c7ab23cc397522ccaa1cfdc97c9d791b1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 4 Mar 2024 23:36:45 +0300
Subject: [PATCH 264/930] Fix mod select overlay settings order not always
 matching panels order

---
 .../TestSceneModSelectOverlay.cs              | 24 +++++++++++++++++++
 osu.Game/Overlays/Mods/ModSettingsArea.cs     | 11 +++++++--
 2 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index b26e126249..6c75530a6e 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -859,6 +859,30 @@ namespace osu.Game.Tests.Visual.UserInterface
                 () => modSelectOverlay.ChildrenOfType<RankingInformationDisplay>().Single().ModMultiplier.Value, () => Is.EqualTo(0.3).Within(Precision.DOUBLE_EPSILON));
         }
 
+        [Test]
+        public void TestModSettingsOrder()
+        {
+            createScreen();
+
+            AddStep("select DT + HD + DF", () => SelectedMods.Value = new Mod[] { new OsuModDoubleTime(), new OsuModHidden(), new OsuModDeflate() });
+            AddAssert("mod settings order: DT, HD, DF", () =>
+            {
+                var columns = this.ChildrenOfType<ModSettingsArea>().Single().ChildrenOfType<ModSettingsArea.ModSettingsColumn>();
+                return columns.ElementAt(0).Mod is OsuModDoubleTime &&
+                       columns.ElementAt(1).Mod is OsuModHidden &&
+                       columns.ElementAt(2).Mod is OsuModDeflate;
+            });
+
+            AddStep("replace DT with NC", () => SelectedMods.Value = SelectedMods.Value.Where(m => m is not ModDoubleTime).Append(new OsuModNightcore()).ToList());
+            AddAssert("mod settings order: NC, HD, DF", () =>
+            {
+                var columns = this.ChildrenOfType<ModSettingsArea>().Single().ChildrenOfType<ModSettingsArea.ModSettingsColumn>();
+                return columns.ElementAt(0).Mod is OsuModNightcore &&
+                       columns.ElementAt(1).Mod is OsuModHidden &&
+                       columns.ElementAt(2).Mod is OsuModDeflate;
+            });
+        }
+
         private void waitForColumnLoad() => AddUntilStep("all column content loaded", () =>
             modSelectOverlay.ChildrenOfType<ModColumn>().Any()
             && modSelectOverlay.ChildrenOfType<ModColumn>().All(column => column.IsLoaded && column.ItemsLoaded)
diff --git a/osu.Game/Overlays/Mods/ModSettingsArea.cs b/osu.Game/Overlays/Mods/ModSettingsArea.cs
index 54bfcc7199..d0e0f7e648 100644
--- a/osu.Game/Overlays/Mods/ModSettingsArea.cs
+++ b/osu.Game/Overlays/Mods/ModSettingsArea.cs
@@ -86,7 +86,10 @@ namespace osu.Game.Overlays.Mods
         {
             modSettingsFlow.Clear();
 
-            foreach (var mod in SelectedMods.Value.AsOrdered())
+            // Importantly, the selected mods bindable is already ordered by the mod select overlay (following the order of mod columns and panels).
+            // Using AsOrdered produces a slightly different order (e.g. DT and NC no longer becoming adjacent),
+            // which breaks user expectations when interacting with the overlay.
+            foreach (var mod in SelectedMods.Value)
             {
                 var settings = mod.CreateSettingsControls().ToList();
 
@@ -110,10 +113,14 @@ namespace osu.Game.Overlays.Mods
         protected override bool OnMouseDown(MouseDownEvent e) => true;
         protected override bool OnHover(HoverEvent e) => true;
 
-        private partial class ModSettingsColumn : CompositeDrawable
+        public partial class ModSettingsColumn : CompositeDrawable
         {
+            public readonly Mod Mod;
+
             public ModSettingsColumn(Mod mod, IEnumerable<Drawable> settingsControls)
             {
+                Mod = mod;
+
                 Width = 250;
                 RelativeSizeAxes = Axes.Y;
                 Padding = new MarginPadding { Bottom = 7 };

From 92f455f1995d32d380380b4a06adf34b21bfdc63 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 03:01:01 +0300
Subject: [PATCH 265/930] Abstractify performance points calculation to a base
 class

---
 .../HUD/DefaultPerformancePointsCounter.cs    | 91 +++++++++++++++++++
 .../Play/HUD/PerformancePointsCounter.cs      | 83 +----------------
 2 files changed, 93 insertions(+), 81 deletions(-)
 create mode 100644 osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs

diff --git a/osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs
new file mode 100644
index 0000000000..3c4e58e575
--- /dev/null
+++ b/osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs
@@ -0,0 +1,91 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+#nullable disable
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Resources.Localisation.Web;
+using osuTK;
+
+namespace osu.Game.Screens.Play.HUD
+{
+    public partial class DefaultPerformancePointsCounter : PerformancePointsCounter
+    {
+        protected override bool IsRollingProportional => true;
+
+        protected override double RollingDuration => 500;
+
+        private const float alpha_when_invalid = 0.3f;
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            Colour = colours.BlueLighter;
+        }
+
+        public override bool IsValid
+        {
+            get => base.IsValid;
+            set
+            {
+                if (value == IsValid)
+                    return;
+
+                base.IsValid = value;
+                DrawableCount.FadeTo(value ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
+            }
+        }
+
+        protected override LocalisableString FormatCount(int count) => count.ToString(@"D");
+
+        protected override IHasText CreateText() => new TextComponent
+        {
+            Alpha = alpha_when_invalid
+        };
+
+        private partial class TextComponent : CompositeDrawable, IHasText
+        {
+            public LocalisableString Text
+            {
+                get => text.Text;
+                set => text.Text = value;
+            }
+
+            private readonly OsuSpriteText text;
+
+            public TextComponent()
+            {
+                AutoSizeAxes = Axes.Both;
+
+                InternalChild = new FillFlowContainer
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Spacing = new Vector2(2),
+                    Children = new Drawable[]
+                    {
+                        text = new OsuSpriteText
+                        {
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
+                        },
+                        new OsuSpriteText
+                        {
+                            Anchor = Anchor.BottomLeft,
+                            Origin = Anchor.BottomLeft,
+                            Text = BeatmapsetsStrings.ShowScoreboardHeaderspp,
+                            Font = OsuFont.Numeric.With(size: 8),
+                            Padding = new MarginPadding { Bottom = 1.5f }, // align baseline better
+                        }
+                    }
+                };
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index f041e120f6..4b07e7da36 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -13,16 +13,9 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
 using osu.Framework.Extensions;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
-using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
-using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Difficulty;
 using osu.Game.Rulesets.Judgements;
@@ -31,7 +24,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Skinning;
-using osuTK;
 
 namespace osu.Game.Screens.Play.HUD
 {
@@ -39,12 +31,6 @@ namespace osu.Game.Screens.Play.HUD
     {
         public bool UsesFixedAnchor { get; set; }
 
-        protected override bool IsRollingProportional => true;
-
-        protected override double RollingDuration => 500;
-
-        private const float alpha_when_invalid = 0.3f;
-
         [Resolved]
         private ScoreProcessor scoreProcessor { get; set; }
 
@@ -60,18 +46,11 @@ namespace osu.Game.Screens.Play.HUD
         private PerformanceCalculator performanceCalculator;
         private ScoreInfo scoreInfo;
 
-        public PerformancePointsCounter()
-        {
-            Current.Value = DisplayedCount = 0;
-        }
-
         private Mod[] clonedMods;
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours, BeatmapDifficultyCache difficultyCache)
+        private void load(BeatmapDifficultyCache difficultyCache)
         {
-            Colour = colours.BlueLighter;
-
             if (gameplayState != null)
             {
                 performanceCalculator = gameplayState.Ruleset.CreatePerformanceCalculator();
@@ -107,19 +86,7 @@ namespace osu.Game.Screens.Play.HUD
                 onJudgementChanged(gameplayState.LastJudgementResult.Value);
         }
 
-        private bool isValid;
-
-        protected bool IsValid
-        {
-            set
-            {
-                if (value == isValid)
-                    return;
-
-                isValid = value;
-                DrawableCount.FadeTo(isValid ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
-            }
-        }
+        public virtual bool IsValid { get; set; }
 
         private void onJudgementChanged(JudgementResult judgement)
         {
@@ -151,13 +118,6 @@ namespace osu.Game.Screens.Play.HUD
             return timedAttributes[Math.Clamp(attribIndex, 0, timedAttributes.Count - 1)].Attributes;
         }
 
-        protected override LocalisableString FormatCount(int count) => count.ToString(@"D");
-
-        protected override IHasText CreateText() => new TextComponent
-        {
-            Alpha = alpha_when_invalid
-        };
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -171,45 +131,6 @@ namespace osu.Game.Screens.Play.HUD
             loadCancellationSource?.Cancel();
         }
 
-        private partial class TextComponent : CompositeDrawable, IHasText
-        {
-            public LocalisableString Text
-            {
-                get => text.Text;
-                set => text.Text = value;
-            }
-
-            private readonly OsuSpriteText text;
-
-            public TextComponent()
-            {
-                AutoSizeAxes = Axes.Both;
-
-                InternalChild = new FillFlowContainer
-                {
-                    AutoSizeAxes = Axes.Both,
-                    Spacing = new Vector2(2),
-                    Children = new Drawable[]
-                    {
-                        text = new OsuSpriteText
-                        {
-                            Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
-                            Font = OsuFont.Numeric.With(size: 16, fixedWidth: true)
-                        },
-                        new OsuSpriteText
-                        {
-                            Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
-                            Text = BeatmapsetsStrings.ShowScoreboardHeaderspp,
-                            Font = OsuFont.Numeric.With(size: 8),
-                            Padding = new MarginPadding { Bottom = 1.5f }, // align baseline better
-                        }
-                    }
-                };
-            }
-        }
-
         // TODO: This class shouldn't exist, but requires breaking changes to allow DifficultyCalculator to receive an IBeatmap.
         private class GameplayWorkingBeatmap : WorkingBeatmap
         {

From 3ee57cdfba7c932dc4dbfb0351d644e1ce46c6d3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 03:01:46 +0300
Subject: [PATCH 266/930] Refactor performance points test scene to support
 skinning

---
 .../SkinnableHUDComponentTestScene.cs         | 13 ++-
 .../TestScenePerformancePointsCounter.cs      | 96 ++++++++-----------
 .../TestSceneSkinnableAccuracyCounter.cs      |  6 +-
 .../TestSceneSkinnableHealthDisplay.cs        |  6 +-
 .../Play/HUD/ArgonPerformancePointsCounter.cs |  9 ++
 5 files changed, 65 insertions(+), 65 deletions(-)
 create mode 100644 osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs b/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs
index f54f50795e..7933647dd2 100644
--- a/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs
+++ b/osu.Game.Tests/Visual/Gameplay/SkinnableHUDComponentTestScene.cs
@@ -1,8 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Testing;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Skinning;
@@ -13,8 +13,13 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         protected override Ruleset CreateRulesetForSkinProvider() => new OsuRuleset();
 
-        [SetUp]
-        public void SetUp() => Schedule(() =>
+        [SetUpSteps]
+        public virtual void SetUpSteps()
+        {
+            AddStep("setup components", SetUpComponents);
+        }
+
+        public void SetUpComponents()
         {
             SetContents(skin =>
             {
@@ -28,7 +33,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 implementation.Origin = Anchor.Centre;
                 return implementation;
             });
-        });
+        }
 
         protected abstract Drawable CreateDefaultImplementation();
         protected virtual Drawable CreateArgonImplementation() => CreateDefaultImplementation();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
index 9622caabf5..986167279c 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
@@ -3,102 +3,88 @@
 
 #nullable disable
 
-using System;
-using System.Diagnostics;
+using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Testing;
-using osu.Game.Rulesets;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Judgements;
+using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
-using osuTK;
+using osu.Game.Tests.Gameplay;
 
 namespace osu.Game.Tests.Visual.Gameplay
 {
-    public partial class TestScenePerformancePointsCounter : OsuTestScene
+    public partial class TestScenePerformancePointsCounter : SkinnableHUDComponentTestScene
     {
-        private DependencyProvidingContainer dependencyContainer;
+        [Cached(typeof(ScoreProcessor))]
+        private readonly ScoreProcessor scoreProcessor = new OsuScoreProcessor();
 
-        private GameplayState gameplayState;
-        private ScoreProcessor scoreProcessor;
+        [Cached]
+        private readonly GameplayState gameplayState = TestGameplayState.Create(new OsuRuleset());
 
         private int iteration;
-        private Bindable<JudgementResult> lastJudgementResult = new Bindable<JudgementResult>();
-        private PerformancePointsCounter counter;
 
-        [SetUpSteps]
-        public void SetUpSteps() => AddStep("create components", () =>
+        protected override Drawable CreateDefaultImplementation() => new DefaultPerformancePointsCounter();
+        protected override Drawable CreateArgonImplementation() => new ArgonPerformancePointsCounter();
+        protected override Drawable CreateLegacyImplementation() => Empty();
+
+        private Bindable<JudgementResult> lastJudgementResult => (Bindable<JudgementResult>)gameplayState.LastJudgementResult;
+
+        public override void SetUpSteps()
         {
-            var ruleset = CreateRuleset();
-
-            Debug.Assert(ruleset != null);
-
-            var beatmap = CreateWorkingBeatmap(ruleset.RulesetInfo)
-                .GetPlayableBeatmap(ruleset.RulesetInfo);
-
-            lastJudgementResult = new Bindable<JudgementResult>();
-
-            gameplayState = new GameplayState(beatmap, ruleset);
-            gameplayState.LastJudgementResult.BindTo(lastJudgementResult);
-
-            scoreProcessor = new ScoreProcessor(ruleset);
-
-            Child = dependencyContainer = new DependencyProvidingContainer
+            AddStep("reset", () =>
             {
-                RelativeSizeAxes = Axes.Both,
-                CachedDependencies = new (Type, object)[]
-                {
-                    (typeof(GameplayState), gameplayState),
-                    (typeof(ScoreProcessor), scoreProcessor)
-                }
-            };
+                var ruleset = new OsuRuleset();
+                var beatmap = CreateWorkingBeatmap(ruleset.RulesetInfo)
+                    .GetPlayableBeatmap(ruleset.RulesetInfo);
 
-            iteration = 0;
-        });
+                iteration = 0;
+                scoreProcessor.ApplyBeatmap(beatmap);
+                lastJudgementResult.SetDefault();
+            });
 
-        protected override Ruleset CreateRuleset() => new OsuRuleset();
+            base.SetUpSteps();
+        }
 
-        private void createCounter() => AddStep("Create counter", () =>
+        [Test]
+        public void TestDisplay()
         {
-            dependencyContainer.Child = counter = new PerformancePointsCounter
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Scale = new Vector2(5),
-            };
-        });
+            AddSliderStep("pp", 0, 2000, 0, v => this.ChildrenOfType<PerformancePointsCounter>().ForEach(c => c.Current.Value = v));
+            AddToggleStep("toggle validity", v => this.ChildrenOfType<PerformancePointsCounter>().ForEach(c => c.IsValid = v));
+        }
 
         [Test]
         public void TestBasicCounting()
         {
             int previousValue = 0;
-            createCounter();
 
-            AddAssert("counter displaying zero", () => counter.Current.Value == 0);
+            AddAssert("counter displaying zero", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.Current.Value == 0));
 
             AddRepeatStep("Add judgement", applyOneJudgement, 10);
 
-            AddUntilStep("counter non-zero", () => counter.Current.Value > 0);
-            AddUntilStep("counter opaque", () => counter.Child.Alpha == 1);
+            AddUntilStep("counter non-zero", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.Current.Value > 0));
+            AddUntilStep("counter valid", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.IsValid));
 
             AddStep("Revert judgement", () =>
             {
-                previousValue = counter.Current.Value;
+                previousValue = this.ChildrenOfType<PerformancePointsCounter>().First().Current.Value;
 
                 scoreProcessor.RevertResult(new JudgementResult(new HitObject(), new OsuJudgement()));
             });
 
-            AddUntilStep("counter decreased", () => counter.Current.Value < previousValue);
+            AddUntilStep("counter decreased", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.Current.Value < previousValue));
 
             AddStep("Add judgement", applyOneJudgement);
 
-            AddUntilStep("counter non-zero", () => counter.Current.Value > 0);
+            AddUntilStep("counter non-zero", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.Current.Value > 0));
         }
 
         [Test]
@@ -106,10 +92,10 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddRepeatStep("Add judgement", applyOneJudgement, 10);
 
-            createCounter();
+            AddStep("recreate counter", SetUpComponents);
 
-            AddUntilStep("counter non-zero", () => counter.Current.Value > 0);
-            AddUntilStep("counter opaque", () => counter.Child.Alpha == 1);
+            AddUntilStep("counter non-zero", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.Current.Value > 0));
+            AddUntilStep("counter valid", () => this.ChildrenOfType<PerformancePointsCounter>().All(c => c.IsValid));
         }
 
         private void applyOneJudgement()
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
index e088d2ca87..d815b80cbc 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableAccuracyCounter.cs
@@ -4,7 +4,6 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play.HUD;
@@ -21,10 +20,11 @@ namespace osu.Game.Tests.Visual.Gameplay
         protected override Drawable CreateDefaultImplementation() => new DefaultAccuracyCounter();
         protected override Drawable CreateLegacyImplementation() => new LegacyAccuracyCounter();
 
-        [SetUpSteps]
-        public void SetUpSteps()
+        public override void SetUpSteps()
         {
             AddStep("Set initial accuracy", () => scoreProcessor.Accuracy.Value = 1);
+
+            base.SetUpSteps();
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs
index 1849e8abd0..3fd6caf7f2 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableHealthDisplay.cs
@@ -4,7 +4,6 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Testing;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Judgements;
@@ -25,14 +24,15 @@ namespace osu.Game.Tests.Visual.Gameplay
         protected override Drawable CreateDefaultImplementation() => new DefaultHealthDisplay { Scale = new Vector2(0.6f) };
         protected override Drawable CreateLegacyImplementation() => new LegacyHealthDisplay { Scale = new Vector2(0.6f) };
 
-        [SetUpSteps]
-        public void SetUpSteps()
+        public override void SetUpSteps()
         {
             AddStep(@"Reset all", delegate
             {
                 healthProcessor.Health.Value = 1;
                 healthProcessor.Failed += () => false; // health won't be updated if the processor gets into a "fail" state.
             });
+
+            base.SetUpSteps();
         }
 
         protected override void Update()
diff --git a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
new file mode 100644
index 0000000000..9e6b5f81e0
--- /dev/null
+++ b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
@@ -0,0 +1,9 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+namespace osu.Game.Screens.Play.HUD
+{
+    public partial class ArgonPerformancePointsCounter : PerformancePointsCounter
+    {
+    }
+}

From d7f1e50d66b10529a37d48c99a79a6b0ef2b54f8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 03:34:29 +0300
Subject: [PATCH 267/930] Add "Argon" performance points counter

---
 .../Play/HUD/ArgonPerformancePointsCounter.cs | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
index 9e6b5f81e0..022c1fab9e 100644
--- a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
@@ -1,9 +1,79 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
+using osu.Game.Configuration;
+using osu.Game.Localisation.SkinComponents;
+using osu.Game.Resources.Localisation.Web;
+
 namespace osu.Game.Screens.Play.HUD
 {
     public partial class ArgonPerformancePointsCounter : PerformancePointsCounter
     {
+        private ArgonCounterTextComponent text = null!;
+
+        protected override double RollingDuration => 250;
+
+        private const float alpha_when_invalid = 0.3f;
+
+        [SettingSource("Wireframe opacity", "Controls the opacity of the wire frames behind the digits.")]
+        public BindableFloat WireframeOpacity { get; } = new BindableFloat(0.25f)
+        {
+            Precision = 0.01f,
+            MinValue = 0,
+            MaxValue = 1,
+        };
+
+        [SettingSource(typeof(SkinnableComponentStrings), nameof(SkinnableComponentStrings.ShowLabel), nameof(SkinnableComponentStrings.ShowLabelDescription))]
+        public Bindable<bool> ShowLabel { get; } = new BindableBool(true);
+
+        public override bool IsValid
+        {
+            get => base.IsValid;
+            set
+            {
+                if (value == IsValid)
+                    return;
+
+                base.IsValid = value;
+                text.FadeTo(value ? 1 : alpha_when_invalid, 1000, Easing.OutQuint);
+            }
+        }
+
+        public override int DisplayedCount
+        {
+            get => base.DisplayedCount;
+            set
+            {
+                base.DisplayedCount = value;
+                updateWireframe();
+            }
+        }
+
+        private void updateWireframe()
+        {
+            int digitsRequiredForDisplayCount = getDigitsRequiredForDisplayCount();
+
+            if (digitsRequiredForDisplayCount != text.WireframeTemplate.Length)
+                text.WireframeTemplate = new string('#', digitsRequiredForDisplayCount);
+        }
+
+        private int getDigitsRequiredForDisplayCount()
+        {
+            int digitsRequired = 1;
+            long c = DisplayedCount;
+            while ((c /= 10) > 0)
+                digitsRequired++;
+            return digitsRequired;
+        }
+
+        protected override IHasText CreateText() => text = new ArgonCounterTextComponent(Anchor.TopRight, BeatmapsetsStrings.ShowScoreboardHeaderspp.ToUpper())
+        {
+            WireframeOpacity = { BindTarget = WireframeOpacity },
+            ShowLabel = { BindTarget = ShowLabel },
+        };
     }
 }

From 0cbcfcecdc3f777efe1adbda732787c26c294ff6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 03:58:43 +0300
Subject: [PATCH 268/930] Integrate "Argon" performance points counter with HUD
 layout

---
 osu.Game/Skinning/ArgonSkin.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Skinning/ArgonSkin.cs b/osu.Game/Skinning/ArgonSkin.cs
index 6fcab6a977..24e17d21f4 100644
--- a/osu.Game/Skinning/ArgonSkin.cs
+++ b/osu.Game/Skinning/ArgonSkin.cs
@@ -118,6 +118,7 @@ namespace osu.Game.Skinning
                                 var wedgePieces = container.OfType<ArgonWedgePiece>().ToArray();
                                 var score = container.OfType<ArgonScoreCounter>().FirstOrDefault();
                                 var accuracy = container.OfType<ArgonAccuracyCounter>().FirstOrDefault();
+                                var performancePoints = container.OfType<ArgonPerformancePointsCounter>().FirstOrDefault();
                                 var combo = container.OfType<ArgonComboCounter>().FirstOrDefault();
                                 var songProgress = container.OfType<ArgonSongProgress>().FirstOrDefault();
                                 var keyCounter = container.OfType<ArgonKeyCounterDisplay>().FirstOrDefault();
@@ -159,6 +160,13 @@ namespace osu.Game.Skinning
                                         accuracy.Origin = Anchor.TopRight;
                                     }
 
+                                    if (performancePoints != null && accuracy != null)
+                                    {
+                                        performancePoints.Position = new Vector2(accuracy.X, accuracy.Y + accuracy.DrawHeight + 10);
+                                        performancePoints.Anchor = Anchor.TopRight;
+                                        performancePoints.Origin = Anchor.TopRight;
+                                    }
+
                                     var hitError = container.OfType<HitErrorMeter>().FirstOrDefault();
 
                                     if (hitError != null)
@@ -224,6 +232,7 @@ namespace osu.Game.Skinning
                                         CornerRadius = { Value = 0.5f }
                                     },
                                     new ArgonAccuracyCounter(),
+                                    new ArgonPerformancePointsCounter(),
                                     new ArgonComboCounter
                                     {
                                         Scale = new Vector2(1.3f)

From b1477c30f2218ffd449f98f595c8a5c8a83fcfdf Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 04:30:57 +0300
Subject: [PATCH 269/930] Add deserialisation test coverage

---
 .../Archives/modified-argon-20240305.osk         | Bin 0 -> 2390 bytes
 osu.Game.Tests/Skins/SkinDeserialisationTest.cs  |   2 ++
 2 files changed, 2 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/Archives/modified-argon-20240305.osk

diff --git a/osu.Game.Tests/Resources/Archives/modified-argon-20240305.osk b/osu.Game.Tests/Resources/Archives/modified-argon-20240305.osk
new file mode 100644
index 0000000000000000000000000000000000000000..6db24352a5e62a877cc2c046fb8130a8dfe9c1b2
GIT binary patch
literal 2390
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

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Skins/SkinDeserialisationTest.cs b/osu.Game.Tests/Skins/SkinDeserialisationTest.cs
index 6423e061c5..d979bdab93 100644
--- a/osu.Game.Tests/Skins/SkinDeserialisationTest.cs
+++ b/osu.Game.Tests/Skins/SkinDeserialisationTest.cs
@@ -60,6 +60,8 @@ namespace osu.Game.Tests.Skins
             "Archives/modified-argon-20231106.osk",
             // Covers "Argon" accuracy/score/combo counters, and wedges
             "Archives/modified-argon-20231108.osk",
+            // Covers "Argon" performance points counter
+            "Archives/modified-argon-20240305.osk",
         };
 
         /// <summary>

From 49b3e81e8aa2f9ba438d3218d06a9e167fd30191 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 5 Mar 2024 04:34:41 +0300
Subject: [PATCH 270/930] Migrate `DefaultPerformancePointsCounter` and rename
 it

---
 .../Visual/Gameplay/TestScenePerformancePointsCounter.cs     | 3 ++-
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs        | 2 +-
 osu.Game/Skinning/Skin.cs                                    | 1 +
 .../Triangles/TrianglesPerformancePointsCounter.cs}          | 5 +++--
 osu.Game/Skinning/TrianglesSkin.cs                           | 3 ++-
 5 files changed, 9 insertions(+), 5 deletions(-)
 rename osu.Game/{Screens/Play/HUD/DefaultPerformancePointsCounter.cs => Skinning/Triangles/TrianglesPerformancePointsCounter.cs} (94%)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
index 986167279c..eada72326d 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePerformancePointsCounter.cs
@@ -18,6 +18,7 @@ using osu.Game.Rulesets.Osu.Scoring;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Screens.Play;
 using osu.Game.Screens.Play.HUD;
+using osu.Game.Skinning.Triangles;
 using osu.Game.Tests.Gameplay;
 
 namespace osu.Game.Tests.Visual.Gameplay
@@ -32,7 +33,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
         private int iteration;
 
-        protected override Drawable CreateDefaultImplementation() => new DefaultPerformancePointsCounter();
+        protected override Drawable CreateDefaultImplementation() => new TrianglesPerformancePointsCounter();
         protected override Drawable CreateArgonImplementation() => new ArgonPerformancePointsCounter();
         protected override Drawable CreateLegacyImplementation() => Empty();
 
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index 4b07e7da36..c5ad106bcc 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -27,7 +27,7 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Play.HUD
 {
-    public partial class PerformancePointsCounter : RollingCounter<int>, ISerialisableDrawable
+    public abstract partial class PerformancePointsCounter : RollingCounter<int>, ISerialisableDrawable
     {
         public bool UsesFixedAnchor { get; set; }
 
diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 9ee69d033d..91b21f0308 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -153,6 +153,7 @@ namespace osu.Game.Skinning
                         // handle namespace changes...
                         jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.SongProgress", @"osu.Game.Screens.Play.HUD.DefaultSongProgress");
                         jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.LegacyComboCounter", @"osu.Game.Skinning.LegacyComboCounter");
+                        jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.PerformancePointsCounter", @"osu.Game.Skinning.Triangles.TrianglesPerformancePointsCounter");
 
                         var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SerialisedDrawableInfo>>(jsonContent);
 
diff --git a/osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs b/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
similarity index 94%
rename from osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs
rename to osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
index 3c4e58e575..99da2c0942 100644
--- a/osu.Game/Screens/Play/HUD/DefaultPerformancePointsCounter.cs
+++ b/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
@@ -11,11 +11,12 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Resources.Localisation.Web;
+using osu.Game.Screens.Play.HUD;
 using osuTK;
 
-namespace osu.Game.Screens.Play.HUD
+namespace osu.Game.Skinning.Triangles
 {
-    public partial class DefaultPerformancePointsCounter : PerformancePointsCounter
+    public partial class TrianglesPerformancePointsCounter : PerformancePointsCounter
     {
         protected override bool IsRollingProportional => true;
 
diff --git a/osu.Game/Skinning/TrianglesSkin.cs b/osu.Game/Skinning/TrianglesSkin.cs
index a2dca5d333..6158d4c7bf 100644
--- a/osu.Game/Skinning/TrianglesSkin.cs
+++ b/osu.Game/Skinning/TrianglesSkin.cs
@@ -14,6 +14,7 @@ using osu.Game.Extensions;
 using osu.Game.IO;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Screens.Play.HUD.HitErrorMeters;
+using osu.Game.Skinning.Triangles;
 using osuTK;
 using osuTK.Graphics;
 
@@ -167,7 +168,7 @@ namespace osu.Game.Skinning
                                     new DefaultKeyCounterDisplay(),
                                     new BarHitErrorMeter(),
                                     new BarHitErrorMeter(),
-                                    new PerformancePointsCounter()
+                                    new TrianglesPerformancePointsCounter()
                                 }
                             };
 

From cceb616a18cc862f975da533bed42b49a89d2fa9 Mon Sep 17 00:00:00 2001
From: Jayden <jvyden@jvyden.xyz>
Date: Mon, 4 Mar 2024 22:25:36 -0500
Subject: [PATCH 271/930] Update failure messages

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Desktop/DiscordRichPresence.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 035add8044..85b6129043 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -184,14 +184,14 @@ namespace osu.Desktop
             game.Window?.Raise();
 
             if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
-                Logger.Log("Failed to parse the room secret Discord gave us", LoggingTarget.Network, LogLevel.Error);
+                Logger.Log("Could not parse room from Discord RPC Client", LoggingTarget.Network, LogLevel.Important);
 
             var request = new GetRoomRequest(roomId);
             request.Success += room => Schedule(() =>
             {
                 game.PresentMultiplayerMatch(room, password);
             });
-            request.Failure += _ => Logger.Log("Couldn't find the room Discord gave us", LoggingTarget.Network, LogLevel.Error);
+            request.Failure += _ => Logger.Log($"Could not find room {roomId} from Discord RPC Client", LoggingTarget.Network, LogLevel.Important);
             api.Queue(request);
         }
 

From 43841e210d2a1915d3c39bfe191ef62befbd3492 Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 09:58:46 +0100
Subject: [PATCH 272/930] Use ObjectDisposedException.ThrowIf throw helper

---
 osu.Game/Database/RealmAccess.cs | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 4bd7f36cdd..167d170c81 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -489,8 +489,7 @@ namespace osu.Game.Database
         /// <param name="action">The work to run.</param>
         public Task WriteAsync(Action<Realm> action)
         {
-            if (isDisposed)
-                throw new ObjectDisposedException(nameof(RealmAccess));
+            ObjectDisposedException.ThrowIf(isDisposed, this);
 
             // Required to ensure the write is tracked and accounted for before disposal.
             // Can potentially be avoided if we have a need to do so in the future.
@@ -675,8 +674,7 @@ namespace osu.Game.Database
 
         private Realm getRealmInstance()
         {
-            if (isDisposed)
-                throw new ObjectDisposedException(nameof(RealmAccess));
+            ObjectDisposedException.ThrowIf(isDisposed, this);
 
             bool tookSemaphoreLock = false;
 
@@ -1189,8 +1187,7 @@ namespace osu.Game.Database
             if (!ThreadSafety.IsUpdateThread)
                 throw new InvalidOperationException(@$"{nameof(BlockAllOperations)} must be called from the update thread.");
 
-            if (isDisposed)
-                throw new ObjectDisposedException(nameof(RealmAccess));
+            ObjectDisposedException.ThrowIf(isDisposed, this);
 
             SynchronizationContext? syncContext = null;
 

From 9bac60a98fc098cb4c6b1f118e61c5255bd5b235 Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 10:19:47 +0100
Subject: [PATCH 273/930] Use ArgumentNullException.ThrowIfNull in more places

---
 osu.Game/Rulesets/UI/DrawableRuleset.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index 13e28279e6..bdc0ff85ba 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -135,8 +135,7 @@ namespace osu.Game.Rulesets.UI
         protected DrawableRuleset(Ruleset ruleset, IBeatmap beatmap, IReadOnlyList<Mod> mods = null)
             : base(ruleset)
         {
-            if (beatmap == null)
-                throw new ArgumentNullException(nameof(beatmap), "Beatmap cannot be null.");
+            ArgumentNullException.ThrowIfNull(beatmap);
 
             if (!(beatmap is Beatmap<TObject> tBeatmap))
                 throw new ArgumentException($"{GetType()} expected the beatmap to contain hitobjects of type {typeof(TObject)}.", nameof(beatmap));

From a89130348469e1b1ea8e025bb2c6cf4a85da51b3 Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 10:20:30 +0100
Subject: [PATCH 274/930] Use ArgumentOutOfRangeException throw helper methods

---
 osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs       | 6 +++---
 osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs          | 2 +-
 osu.Game/Beatmaps/Timing/TimeSignature.cs                   | 3 +--
 osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs          | 3 +--
 osu.Game/Rulesets/Objects/Types/PathType.cs                 | 3 +--
 osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs | 3 +--
 osu.Game/Utils/LimitedCapacityQueue.cs                      | 3 +--
 osu.Game/Utils/StatelessRNG.cs                              | 2 +-
 8 files changed, 10 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs
index 835c67ff19..9cc0a8c414 100644
--- a/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs
+++ b/osu.Game.Rulesets.Osu/Beatmaps/OsuBeatmapProcessor.cs
@@ -58,9 +58,9 @@ namespace osu.Game.Rulesets.Osu.Beatmaps
 
         private void applyStacking(Beatmap<OsuHitObject> beatmap, int startIndex, int endIndex)
         {
-            if (startIndex > endIndex) throw new ArgumentOutOfRangeException(nameof(startIndex), $"{nameof(startIndex)} cannot be greater than {nameof(endIndex)}.");
-            if (startIndex < 0) throw new ArgumentOutOfRangeException(nameof(startIndex), $"{nameof(startIndex)} cannot be less than 0.");
-            if (endIndex < 0) throw new ArgumentOutOfRangeException(nameof(endIndex), $"{nameof(endIndex)} cannot be less than 0.");
+            ArgumentOutOfRangeException.ThrowIfGreaterThan(startIndex, endIndex);
+            ArgumentOutOfRangeException.ThrowIfNegative(startIndex);
+            ArgumentOutOfRangeException.ThrowIfNegative(endIndex);
 
             int extendedEndIndex = endIndex;
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
index 448cfaf84c..3ead61f64a 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuHitObjectComposer.cs
@@ -334,7 +334,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         /// <returns>The <see cref="OsuDistanceSnapGrid"/> from a selected <see cref="HitObject"/> to a target <see cref="HitObject"/>.</returns>
         private OsuDistanceSnapGrid createGrid(Func<HitObject, bool> sourceSelector, int targetOffset = 1)
         {
-            if (targetOffset < 1) throw new ArgumentOutOfRangeException(nameof(targetOffset));
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(targetOffset);
 
             int sourceIndex = -1;
 
diff --git a/osu.Game/Beatmaps/Timing/TimeSignature.cs b/osu.Game/Beatmaps/Timing/TimeSignature.cs
index 7499a725dc..377a878631 100644
--- a/osu.Game/Beatmaps/Timing/TimeSignature.cs
+++ b/osu.Game/Beatmaps/Timing/TimeSignature.cs
@@ -23,8 +23,7 @@ namespace osu.Game.Beatmaps.Timing
 
         public TimeSignature(int numerator)
         {
-            if (numerator < 1)
-                throw new ArgumentOutOfRangeException(nameof(numerator), numerator, "The numerator of a time signature must be positive.");
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(numerator);
 
             Numerator = numerator;
         }
diff --git a/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs b/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs
index 3dc2d133ba..17c3c51cfb 100644
--- a/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs
+++ b/osu.Game/Rulesets/Difficulty/Utils/ReverseQueue.cs
@@ -27,8 +27,7 @@ namespace osu.Game.Rulesets.Difficulty.Utils
 
         public ReverseQueue(int initialCapacity)
         {
-            if (initialCapacity <= 0)
-                throw new ArgumentOutOfRangeException(nameof(initialCapacity));
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(initialCapacity);
 
             items = new T[initialCapacity];
             capacity = initialCapacity;
diff --git a/osu.Game/Rulesets/Objects/Types/PathType.cs b/osu.Game/Rulesets/Objects/Types/PathType.cs
index 23f1ccf0bc..6983484dce 100644
--- a/osu.Game/Rulesets/Objects/Types/PathType.cs
+++ b/osu.Game/Rulesets/Objects/Types/PathType.cs
@@ -40,8 +40,7 @@ namespace osu.Game.Rulesets.Objects.Types
 
         public static PathType BSpline(int degree)
         {
-            if (degree <= 0)
-                throw new ArgumentOutOfRangeException(nameof(degree), "The degree of a B-Spline path must be greater than zero.");
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(degree);
 
             return new PathType { Type = SplineType.BSpline, Degree = degree };
         }
diff --git a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
index ed31bc8643..4abf0007a7 100644
--- a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
+++ b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
@@ -33,8 +33,7 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// <param name="items">The <see cref="SimpleStatisticItem"/>s to display in this row.</param>
         public SimpleStatisticTable(int columnCount, [ItemNotNull] IEnumerable<SimpleStatisticItem> items)
         {
-            if (columnCount < 1)
-                throw new ArgumentOutOfRangeException(nameof(columnCount));
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(columnCount);
 
             this.columnCount = columnCount;
             this.items = items.ToArray();
diff --git a/osu.Game/Utils/LimitedCapacityQueue.cs b/osu.Game/Utils/LimitedCapacityQueue.cs
index d36aa8af2c..b96148d4a0 100644
--- a/osu.Game/Utils/LimitedCapacityQueue.cs
+++ b/osu.Game/Utils/LimitedCapacityQueue.cs
@@ -35,8 +35,7 @@ namespace osu.Game.Utils
         /// <param name="capacity">The number of items the queue can hold.</param>
         public LimitedCapacityQueue(int capacity)
         {
-            if (capacity < 0)
-                throw new ArgumentOutOfRangeException(nameof(capacity));
+            ArgumentOutOfRangeException.ThrowIfNegative(capacity);
 
             this.capacity = capacity;
             array = new T[capacity];
diff --git a/osu.Game/Utils/StatelessRNG.cs b/osu.Game/Utils/StatelessRNG.cs
index 3db632fc42..8833dcbbdb 100644
--- a/osu.Game/Utils/StatelessRNG.cs
+++ b/osu.Game/Utils/StatelessRNG.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Utils
         /// </param>
         public static int NextInt(int maxValue, int seed, int series = 0)
         {
-            if (maxValue <= 0) throw new ArgumentOutOfRangeException(nameof(maxValue));
+            ArgumentOutOfRangeException.ThrowIfNegativeOrZero(maxValue);
 
             return (int)(NextULong(seed, series) % (ulong)maxValue);
         }

From 5965db4fd7344822d116aa7bd23ad2fa2ebfa22e Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 10:20:57 +0100
Subject: [PATCH 275/930] Use ArgumentException.ThrowIfNullOrEmpty throw helper

---
 osu.Game/IO/WrappedStorage.cs | 3 +--
 osu.Game/Online/API/OAuth.cs  | 4 ++--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/IO/WrappedStorage.cs b/osu.Game/IO/WrappedStorage.cs
index 95ff26db6a..5a8f4aef59 100644
--- a/osu.Game/IO/WrappedStorage.cs
+++ b/osu.Game/IO/WrappedStorage.cs
@@ -80,8 +80,7 @@ namespace osu.Game.IO
 
         public override Storage GetStorageForDirectory(string path)
         {
-            if (string.IsNullOrEmpty(path))
-                throw new ArgumentException("Must be non-null and not empty string", nameof(path));
+            ArgumentException.ThrowIfNullOrEmpty(path);
 
             if (!path.EndsWith(Path.DirectorySeparatorChar))
                 path += Path.DirectorySeparatorChar;
diff --git a/osu.Game/Online/API/OAuth.cs b/osu.Game/Online/API/OAuth.cs
index 4829310870..b06d9c6586 100644
--- a/osu.Game/Online/API/OAuth.cs
+++ b/osu.Game/Online/API/OAuth.cs
@@ -39,8 +39,8 @@ namespace osu.Game.Online.API
 
         internal void AuthenticateWithLogin(string username, string password)
         {
-            if (string.IsNullOrEmpty(username)) throw new ArgumentException("Missing username.");
-            if (string.IsNullOrEmpty(password)) throw new ArgumentException("Missing password.");
+            ArgumentException.ThrowIfNullOrEmpty(username);
+            ArgumentException.ThrowIfNullOrEmpty(password);
 
             var accessTokenRequest = new AccessTokenRequestPassword(username, password)
             {

From 6fabbe26166df10907358d5c58dc26f8cf17dbbe Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 10:27:12 +0100
Subject: [PATCH 276/930] Use new ToDictionary() overload without delegates

---
 osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs | 4 ++--
 osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs    | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
index 6f321fd401..64caddb2fc 100644
--- a/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
@@ -245,8 +245,8 @@ namespace osu.Game.Online.API.Requests.Responses
             RulesetID = score.RulesetID,
             Passed = score.Passed,
             Mods = score.APIMods,
-            Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(kvp => kvp.Key, kvp => kvp.Value),
-            MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(kvp => kvp.Key, kvp => kvp.Value),
+            Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(),
+            MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
         };
     }
 }
diff --git a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
index 2c5b91f10f..afdcef1d21 100644
--- a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
+++ b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
@@ -42,8 +42,8 @@ namespace osu.Game.Scoring.Legacy
         {
             OnlineID = score.OnlineID,
             Mods = score.APIMods,
-            Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(kvp => kvp.Key, kvp => kvp.Value),
-            MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(kvp => kvp.Key, kvp => kvp.Value),
+            Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(),
+            MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             ClientVersion = score.ClientVersion,
         };
     }

From d0f7ab3316584f92957cd738c57e6dfd85fb9fcc Mon Sep 17 00:00:00 2001
From: Berkan Diler <b.diler@gmx.de>
Date: Tue, 5 Mar 2024 17:18:59 +0100
Subject: [PATCH 277/930] Revert some changes

---
 osu.Game/Online/API/OAuth.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Online/API/OAuth.cs b/osu.Game/Online/API/OAuth.cs
index b06d9c6586..4829310870 100644
--- a/osu.Game/Online/API/OAuth.cs
+++ b/osu.Game/Online/API/OAuth.cs
@@ -39,8 +39,8 @@ namespace osu.Game.Online.API
 
         internal void AuthenticateWithLogin(string username, string password)
         {
-            ArgumentException.ThrowIfNullOrEmpty(username);
-            ArgumentException.ThrowIfNullOrEmpty(password);
+            if (string.IsNullOrEmpty(username)) throw new ArgumentException("Missing username.");
+            if (string.IsNullOrEmpty(password)) throw new ArgumentException("Missing password.");
 
             var accessTokenRequest = new AccessTokenRequestPassword(username, password)
             {

From e6f1a722cbb54a905a20c91fe30a8be072ba357c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 5 Mar 2024 18:48:58 +0100
Subject: [PATCH 278/930] Remove unused field and commented-out code

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 34 +++++--------------
 1 file changed, 9 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 6f70a914f0..08d00f8ac2 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -33,7 +33,6 @@ namespace osu.Game.Screens.Play
         private double countdownStartTime;
 
         private Drawable content = null!;
-        private Drawable background = null!;
         private SpriteText countdown = null!;
 
         public DelayedResumeOverlay()
@@ -53,9 +52,9 @@ namespace osu.Game.Screens.Play
                 Masking = true,
                 BorderColour = colours.Yellow,
                 BorderThickness = 1,
-                Children = new[]
+                Children = new Drawable[]
                 {
-                    background = new Box
+                    new Box
                     {
                         Size = new Vector2(250, 40),
                         Colour = Color4.Black,
@@ -75,29 +74,14 @@ namespace osu.Game.Screens.Play
                                 AutoSizeAxes = Axes.Both,
                                 Spacing = new Vector2(5),
                                 Colour = colours.Yellow,
-                                Children = new Drawable[]
+                                Child = countdown = new OsuSpriteText
                                 {
-                                    // new Box
-                                    // {
-                                    //     Anchor = Anchor.Centre,
-                                    //     Origin = Anchor.Centre,
-                                    //     Size = new Vector2(40, 3)
-                                    // },
-                                    countdown = new OsuSpriteText
-                                    {
-                                        Anchor = Anchor.Centre,
-                                        Origin = Anchor.Centre,
-                                        UseFullGlyphHeight = false,
-                                        AlwaysPresent = true,
-                                        Font = OsuFont.Numeric.With(size: 20, fixedWidth: true)
-                                    },
-                                    // new Box
-                                    // {
-                                    //     Anchor = Anchor.Centre,
-                                    //     Origin = Anchor.Centre,
-                                    //     Size = new Vector2(40, 3)
-                                    // }
-                                }
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    UseFullGlyphHeight = false,
+                                    AlwaysPresent = true,
+                                    Font = OsuFont.Numeric.With(size: 20, fixedWidth: true)
+                                },
                             }
                         }
                     }

From 57daaa7fed6b7c7021e0c85d83ff8e532f657c7c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 04:17:15 +0800
Subject: [PATCH 279/930] Add logging for `GameplayClockContainer` starting or
 stopping

---
 osu.Game/Screens/Play/GameplayClockContainer.cs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/GameplayClockContainer.cs b/osu.Game/Screens/Play/GameplayClockContainer.cs
index c039d1e535..255877e0aa 100644
--- a/osu.Game/Screens/Play/GameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/GameplayClockContainer.cs
@@ -122,8 +122,17 @@ namespace osu.Game.Screens.Play
             StopGameplayClock();
         }
 
-        protected virtual void StartGameplayClock() => GameplayClock.Start();
-        protected virtual void StopGameplayClock() => GameplayClock.Stop();
+        protected virtual void StartGameplayClock()
+        {
+            Logger.Log($"{nameof(GameplayClockContainer)} started via call to {nameof(StartGameplayClock)}");
+            GameplayClock.Start();
+        }
+
+        protected virtual void StopGameplayClock()
+        {
+            Logger.Log($"{nameof(GameplayClockContainer)} stopped via call to {nameof(StopGameplayClock)}");
+            GameplayClock.Stop();
+        }
 
         /// <summary>
         /// Resets this <see cref="GameplayClockContainer"/> and the source to an initial state ready for gameplay.

From 65ce4ca390925c43ebb8167c4aa19c15b8b46b01 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 04:17:51 +0800
Subject: [PATCH 280/930] Never set `waitingOnFrames` if a replay is not
 attached

---
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index 884310e44c..b49924762e 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -189,7 +189,7 @@ namespace osu.Game.Rulesets.UI
             double timeBehind = Math.Abs(proposedTime - referenceClock.CurrentTime);
 
             isCatchingUp.Value = timeBehind > 200;
-            waitingOnFrames.Value = state == PlaybackState.NotValid;
+            waitingOnFrames.Value = hasReplayAttached && state == PlaybackState.NotValid;
 
             manualClock.CurrentTime = proposedTime;
             manualClock.Rate = Math.Abs(referenceClock.Rate) * direction;

From 8b03acd27bdbdd6a997dbd70a00a7b4568e6b8bc Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 6 Mar 2024 00:05:56 +0300
Subject: [PATCH 281/930] Implement StoryboardElementWithDuration

---
 .../Formats/LegacyStoryboardDecoder.cs        |   2 +-
 osu.Game/Storyboards/CommandLoop.cs           |   1 +
 osu.Game/Storyboards/CommandTimeline.cs       |   4 +-
 osu.Game/Storyboards/CommandTimelineGroup.cs  |   9 +-
 .../Drawables/DrawableStoryboardAnimation.cs  |   2 +-
 .../Drawables/DrawableStoryboardSprite.cs     |   2 +-
 ...pable.cs => IDrawableStoryboardElement.cs} |   6 +-
 .../Storyboards/Drawables/IVectorScalable.cs  |  13 -
 osu.Game/Storyboards/StoryboardAnimation.cs   |   5 +-
 .../StoryboardElementWithDuration.cs          | 261 +++++++++++++++
 osu.Game/Storyboards/StoryboardSprite.cs      | 297 +-----------------
 11 files changed, 284 insertions(+), 318 deletions(-)
 rename osu.Game/Storyboards/Drawables/{IFlippable.cs => IDrawableStoryboardElement.cs} (54%)
 delete mode 100644 osu.Game/Storyboards/Drawables/IVectorScalable.cs
 create mode 100644 osu.Game/Storyboards/StoryboardElementWithDuration.cs

diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index a9a4d9cc49..ba328b2dbd 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyStoryboardDecoder : LegacyDecoder<Storyboard>
     {
-        private StoryboardSprite? storyboardSprite;
+        private StoryboardElementWithDuration? storyboardSprite;
         private CommandTimelineGroup? timelineGroup;
 
         private Storyboard storyboard = null!;
diff --git a/osu.Game/Storyboards/CommandLoop.cs b/osu.Game/Storyboards/CommandLoop.cs
index a912daea44..6dd782cb7f 100644
--- a/osu.Game/Storyboards/CommandLoop.cs
+++ b/osu.Game/Storyboards/CommandLoop.cs
@@ -50,6 +50,7 @@ namespace osu.Game.Storyboards
                     StartValue = command.StartValue,
                     EndValue = command.EndValue,
                     PropertyName = command.PropertyName,
+                    IsParameterCommand = command.IsParameterCommand,
                     LoopCount = TotalIterations,
                     Delay = fullLoopDuration - command.EndTime + command.StartTime
                 };
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
index ce25bfe25b..4ad31d88c2 100644
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ b/osu.Game/Storyboards/CommandTimeline.cs
@@ -25,6 +25,7 @@ namespace osu.Game.Storyboards
         public T EndValue { get; private set; }
 
         public string PropertyName { get; }
+        public bool IsParameterTimeline { get; set; }
 
         public CommandTimeline(string propertyName)
         {
@@ -38,7 +39,7 @@ namespace osu.Game.Storyboards
                 endTime = startTime;
             }
 
-            commands.Add(new TypedCommand { Easing = easing, StartTime = startTime, EndTime = endTime, StartValue = startValue, EndValue = endValue, PropertyName = PropertyName });
+            commands.Add(new TypedCommand { Easing = easing, StartTime = startTime, EndTime = endTime, StartValue = startValue, EndValue = endValue, PropertyName = PropertyName, IsParameterCommand = IsParameterTimeline });
 
             if (startTime < StartTime)
             {
@@ -65,6 +66,7 @@ namespace osu.Game.Storyboards
             public string PropertyName { get; set; }
             public int LoopCount { get; set; }
             public double Delay { get; set; }
+            public bool IsParameterCommand { get; set; }
 
             public T StartValue;
             public T EndValue;
diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index cb795e0ffe..0362925619 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.cs
@@ -22,9 +22,9 @@ namespace osu.Game.Storyboards
         public CommandTimeline<float> Rotation = new CommandTimeline<float>("Rotation");
         public CommandTimeline<ColourInfo> Colour = new CommandTimeline<ColourInfo>("Colour");
         public CommandTimeline<float> Alpha = new CommandTimeline<float>("Alpha");
-        public CommandTimeline<BlendingParameters> BlendingParameters = new CommandTimeline<BlendingParameters>("Blending");
-        public CommandTimeline<bool> FlipH = new CommandTimeline<bool>("FlipH");
-        public CommandTimeline<bool> FlipV = new CommandTimeline<bool>("FlipV");
+        public CommandTimeline<BlendingParameters> BlendingParameters = new CommandTimeline<BlendingParameters>("Blending") { IsParameterTimeline = true };
+        public CommandTimeline<bool> FlipH = new CommandTimeline<bool>("FlipH") { IsParameterTimeline = true };
+        public CommandTimeline<bool> FlipV = new CommandTimeline<bool>("FlipV") { IsParameterTimeline = true };
 
         private readonly ICommandTimeline[] timelines;
 
@@ -109,7 +109,8 @@ namespace osu.Game.Storyboards
                         EndTime = offset + command.EndTime,
                         StartValue = command.StartValue,
                         EndValue = command.EndValue,
-                        PropertyName = command.PropertyName
+                        PropertyName = command.PropertyName,
+                        IsParameterCommand = command.IsParameterCommand
                     });
             }
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index fae9ec7f2e..8e1a8ce949 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -16,7 +16,7 @@ using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public partial class DrawableStoryboardAnimation : TextureAnimation, IFlippable, IVectorScalable
+    public partial class DrawableStoryboardAnimation : TextureAnimation, IDrawableStoryboardElement
     {
         public StoryboardAnimation Animation { get; }
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index ec875219b6..6772178e85 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -13,7 +13,7 @@ using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public partial class DrawableStoryboardSprite : Sprite, IFlippable, IVectorScalable
+    public partial class DrawableStoryboardSprite : Sprite, IDrawableStoryboardElement
     {
         public StoryboardSprite Sprite { get; }
 
diff --git a/osu.Game/Storyboards/Drawables/IFlippable.cs b/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
similarity index 54%
rename from osu.Game/Storyboards/Drawables/IFlippable.cs
rename to osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
index 2a931875ea..6652b5509c 100644
--- a/osu.Game/Storyboards/Drawables/IFlippable.cs
+++ b/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
@@ -1,13 +1,15 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics.Transforms;
+using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    internal interface IFlippable : ITransformable
+    public interface IDrawableStoryboardElement : ITransformable
     {
         bool FlipH { get; set; }
         bool FlipV { get; set; }
+        Vector2 VectorScale { get; set; }
     }
 }
diff --git a/osu.Game/Storyboards/Drawables/IVectorScalable.cs b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
deleted file mode 100644
index ab0452df80..0000000000
--- a/osu.Game/Storyboards/Drawables/IVectorScalable.cs
+++ /dev/null
@@ -1,13 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Graphics.Transforms;
-using osuTK;
-
-namespace osu.Game.Storyboards.Drawables
-{
-    internal interface IVectorScalable : ITransformable
-    {
-        Vector2 VectorScale { get; set; }
-    }
-}
diff --git a/osu.Game/Storyboards/StoryboardAnimation.cs b/osu.Game/Storyboards/StoryboardAnimation.cs
index 1a4b6bb923..173acf7ff1 100644
--- a/osu.Game/Storyboards/StoryboardAnimation.cs
+++ b/osu.Game/Storyboards/StoryboardAnimation.cs
@@ -7,7 +7,7 @@ using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Storyboards
 {
-    public class StoryboardAnimation : StoryboardSprite
+    public class StoryboardAnimation : StoryboardElementWithDuration<DrawableStoryboardAnimation>
     {
         public int FrameCount;
         public double FrameDelay;
@@ -21,8 +21,7 @@ namespace osu.Game.Storyboards
             LoopType = loopType;
         }
 
-        public override Drawable CreateDrawable()
-            => new DrawableStoryboardAnimation(this);
+        public override DrawableStoryboardAnimation CreateStoryboardDrawable() => new DrawableStoryboardAnimation(this);
     }
 
     public enum AnimationLoopType
diff --git a/osu.Game/Storyboards/StoryboardElementWithDuration.cs b/osu.Game/Storyboards/StoryboardElementWithDuration.cs
new file mode 100644
index 0000000000..0c89b40c36
--- /dev/null
+++ b/osu.Game/Storyboards/StoryboardElementWithDuration.cs
@@ -0,0 +1,261 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Graphics;
+using osu.Game.Storyboards.Drawables;
+using osuTK;
+
+namespace osu.Game.Storyboards
+{
+    public abstract class StoryboardElementWithDuration : IStoryboardElementWithDuration
+    {
+        protected readonly List<CommandLoop> Loops = new List<CommandLoop>();
+        private readonly List<CommandTrigger> triggers = new List<CommandTrigger>();
+
+        public string Path { get; }
+        public bool IsDrawable => HasCommands;
+
+        public Anchor Origin;
+        public Vector2 InitialPosition;
+
+        public readonly CommandTimelineGroup TimelineGroup = new CommandTimelineGroup();
+
+        public double StartTime
+        {
+            get
+            {
+                // To get the initial start time, we need to check whether the first alpha command to exist (across all loops) has a StartValue of zero.
+                // A StartValue of zero governs, above all else, the first valid display time of a sprite.
+                //
+                // You can imagine that the first command of each type decides that type's start value, so if the initial alpha is zero,
+                // anything before that point can be ignored (the sprite is not visible after all).
+                var alphaCommands = new List<(double startTime, bool isZeroStartValue)>();
+
+                var command = TimelineGroup.Alpha.Commands.FirstOrDefault();
+                if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
+
+                foreach (var loop in Loops)
+                {
+                    command = loop.Alpha.Commands.FirstOrDefault();
+                    if (command != null) alphaCommands.Add((command.StartTime + loop.LoopStartTime, command.StartValue == 0));
+                }
+
+                if (alphaCommands.Count > 0)
+                {
+                    var firstAlpha = alphaCommands.MinBy(t => t.startTime);
+
+                    if (firstAlpha.isZeroStartValue)
+                        return firstAlpha.startTime;
+                }
+
+                return EarliestTransformTime;
+            }
+        }
+
+        public double EarliestTransformTime
+        {
+            get
+            {
+                // If we got to this point, either no alpha commands were present, or the earliest had a non-zero start value.
+                // The sprite's StartTime will be determined by the earliest command, regardless of type.
+                double earliestStartTime = TimelineGroup.StartTime;
+                foreach (var l in Loops)
+                    earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
+                return earliestStartTime;
+            }
+        }
+
+        public double EndTime
+        {
+            get
+            {
+                double latestEndTime = TimelineGroup.EndTime;
+
+                foreach (var l in Loops)
+                    latestEndTime = Math.Max(latestEndTime, l.EndTime);
+
+                return latestEndTime;
+            }
+        }
+
+        public double EndTimeForDisplay
+        {
+            get
+            {
+                double latestEndTime = TimelineGroup.EndTime;
+
+                foreach (var l in Loops)
+                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
+
+                return latestEndTime;
+            }
+        }
+
+        public bool HasCommands => TimelineGroup.HasCommands || Loops.Any(l => l.HasCommands);
+
+        protected StoryboardElementWithDuration(string path, Anchor origin, Vector2 initialPosition)
+        {
+            Path = path;
+            Origin = origin;
+            InitialPosition = initialPosition;
+        }
+
+        public abstract Drawable CreateDrawable();
+
+        public CommandLoop AddLoop(double startTime, int repeatCount)
+        {
+            var loop = new CommandLoop(startTime, repeatCount);
+            Loops.Add(loop);
+            return loop;
+        }
+
+        public CommandTrigger AddTrigger(string triggerName, double startTime, double endTime, int groupNumber)
+        {
+            var trigger = new CommandTrigger(triggerName, startTime, endTime, groupNumber);
+            triggers.Add(trigger);
+            return trigger;
+        }
+
+        protected IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups)
+        {
+            var commands = TimelineGroup.GetCommands(timelineSelector);
+            foreach (var loop in Loops)
+                commands = commands.Concat(loop.GetCommands(timelineSelector));
+
+            if (triggeredGroups != null)
+            {
+                foreach (var pair in triggeredGroups)
+                    commands = commands.Concat(pair.Item1.GetCommands(timelineSelector, pair.Item2));
+            }
+
+            return commands;
+        }
+
+        public override string ToString()
+            => $"{Path}, {Origin}, {InitialPosition}";
+    }
+
+    public abstract class StoryboardElementWithDuration<U> : StoryboardElementWithDuration
+        where U : Drawable, IDrawableStoryboardElement
+    {
+        private delegate void DrawablePropertyInitializer<in T>(U drawable, T value);
+
+        protected StoryboardElementWithDuration(string path, Anchor origin, Vector2 initialPosition)
+            : base(path, origin, initialPosition)
+        {
+        }
+
+        public override Drawable CreateDrawable() => CreateStoryboardDrawable();
+
+        public abstract U CreateStoryboardDrawable();
+
+        public void ApplyTransforms(U drawable, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups = null)
+        {
+            // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
+            // To achieve this, commands are "generated" as pairs of (command, initFunc, transformFunc) and batched into a contiguous list
+            // The list is then stably-sorted (to preserve command order), and applied to the drawable sequentially.
+
+            List<IGeneratedCommand<U>> generated = new List<IGeneratedCommand<U>>();
+
+            generateCommands(generated, GetCommands(g => g.X, triggeredGroups), (d, value) => d.X = value);
+            generateCommands(generated, GetCommands(g => g.Y, triggeredGroups), (d, value) => d.Y = value);
+            generateCommands(generated, GetCommands(g => g.Scale, triggeredGroups), (d, value) => d.Scale = value);
+            generateCommands(generated, GetCommands(g => g.Rotation, triggeredGroups), (d, value) => d.Rotation = value);
+            generateCommands(generated, GetCommands(g => g.Colour, triggeredGroups), (d, value) => d.Colour = value);
+            generateCommands(generated, GetCommands(g => g.Alpha, triggeredGroups), (d, value) => d.Alpha = value);
+            generateCommands(generated, GetCommands(g => g.BlendingParameters, triggeredGroups), (d, value) => d.Blending = value, false);
+            generateCommands(generated, GetCommands(g => g.VectorScale, triggeredGroups), (d, value) => d.VectorScale = value);
+            generateCommands(generated, GetCommands(g => g.FlipH, triggeredGroups), (d, value) => d.FlipH = value, false);
+            generateCommands(generated, GetCommands(g => g.FlipV, triggeredGroups), (d, value) => d.FlipV = value, false);
+
+            foreach (var command in generated.OrderBy(g => g.StartTime))
+                command.ApplyTo(drawable);
+        }
+
+        private void generateCommands<T>(List<IGeneratedCommand<U>> resultList, IEnumerable<CommandTimeline<T>.TypedCommand> commands,
+                                         DrawablePropertyInitializer<T> initializeProperty, bool alwaysInitialize = true)
+        {
+            bool initialized = false;
+
+            foreach (var command in commands)
+            {
+                DrawablePropertyInitializer<T>? initFunc = null;
+
+                if (!initialized)
+                {
+                    if (alwaysInitialize || command.StartTime == command.EndTime)
+                        initFunc = initializeProperty;
+                    initialized = true;
+                }
+
+                resultList.Add(new GeneratedCommand<T, U>(command, initFunc));
+            }
+        }
+
+        private interface IGeneratedCommand<in TDrawable>
+            where TDrawable : U
+        {
+            double StartTime { get; }
+
+            void ApplyTo(TDrawable drawable);
+        }
+
+        private readonly struct GeneratedCommand<T, TDrawable> : IGeneratedCommand<TDrawable>
+            where TDrawable : U
+        {
+            public double StartTime => command.StartTime;
+
+            private readonly DrawablePropertyInitializer<T>? initializeProperty;
+            private readonly CommandTimeline<T>.TypedCommand command;
+
+            public GeneratedCommand(CommandTimeline<T>.TypedCommand command, DrawablePropertyInitializer<T>? initializeProperty)
+            {
+                this.command = command;
+                this.initializeProperty = initializeProperty;
+            }
+
+            public void ApplyTo(TDrawable drawable)
+            {
+                initializeProperty?.Invoke(drawable, command.StartValue);
+
+                using (drawable.BeginAbsoluteSequence(command.StartTime))
+                    transform(drawable);
+            }
+
+            private void transform(TDrawable drawable)
+            {
+                if (command.IsParameterCommand)
+                {
+                    if (command.LoopCount == 0)
+                    {
+                        drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                .TransformTo(command.PropertyName, command.EndValue);
+                    }
+                    else
+                    {
+                        drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
+                                .TransformTo(command.PropertyName, command.EndValue)
+                                .Loop(command.Delay, command.LoopCount);
+                    }
+                }
+                else
+                {
+                    if (command.LoopCount == 0)
+                    {
+                        drawable.TransformTo(command.PropertyName, command.StartValue).Then()
+                                .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
+                    }
+                    else
+                    {
+                        drawable.TransformTo(command.PropertyName, command.StartValue).Then()
+                                .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
+                                .Loop(command.Delay, command.LoopCount);
+                    }
+                }
+            }
+        }
+    }
+}
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 2c04e4c983..69994f77a4 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -1,308 +1,21 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
-using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Graphics;
 using osu.Game.Storyboards.Drawables;
 using osuTK;
 
 namespace osu.Game.Storyboards
 {
-    public class StoryboardSprite : IStoryboardElementWithDuration
+    public class StoryboardSprite : StoryboardElementWithDuration<DrawableStoryboardSprite>
     {
-        private readonly List<CommandLoop> loops = new List<CommandLoop>();
-        private readonly List<CommandTrigger> triggers = new List<CommandTrigger>();
-
-        public string Path { get; }
-        public bool IsDrawable => HasCommands;
-
-        public Anchor Origin;
-        public Vector2 InitialPosition;
-
-        public readonly CommandTimelineGroup TimelineGroup = new CommandTimelineGroup();
-
-        public double StartTime
-        {
-            get
-            {
-                // To get the initial start time, we need to check whether the first alpha command to exist (across all loops) has a StartValue of zero.
-                // A StartValue of zero governs, above all else, the first valid display time of a sprite.
-                //
-                // You can imagine that the first command of each type decides that type's start value, so if the initial alpha is zero,
-                // anything before that point can be ignored (the sprite is not visible after all).
-                var alphaCommands = new List<(double startTime, bool isZeroStartValue)>();
-
-                var command = TimelineGroup.Alpha.Commands.FirstOrDefault();
-                if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
-
-                foreach (var loop in loops)
-                {
-                    command = loop.Alpha.Commands.FirstOrDefault();
-                    if (command != null) alphaCommands.Add((command.StartTime + loop.LoopStartTime, command.StartValue == 0));
-                }
-
-                if (alphaCommands.Count > 0)
-                {
-                    var firstAlpha = alphaCommands.MinBy(t => t.startTime);
-
-                    if (firstAlpha.isZeroStartValue)
-                        return firstAlpha.startTime;
-                }
-
-                return EarliestTransformTime;
-            }
-        }
-
-        public double EarliestTransformTime
-        {
-            get
-            {
-                // If we got to this point, either no alpha commands were present, or the earliest had a non-zero start value.
-                // The sprite's StartTime will be determined by the earliest command, regardless of type.
-                double earliestStartTime = TimelineGroup.StartTime;
-                foreach (var l in loops)
-                    earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
-                return earliestStartTime;
-            }
-        }
-
-        public double EndTime
-        {
-            get
-            {
-                double latestEndTime = TimelineGroup.EndTime;
-
-                foreach (var l in loops)
-                    latestEndTime = Math.Max(latestEndTime, l.EndTime);
-
-                return latestEndTime;
-            }
-        }
-
-        public double EndTimeForDisplay
-        {
-            get
-            {
-                double latestEndTime = TimelineGroup.EndTime;
-
-                foreach (var l in loops)
-                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
-
-                return latestEndTime;
-            }
-        }
-
-        public bool HasCommands => TimelineGroup.HasCommands || loops.Any(l => l.HasCommands);
-
-        private delegate void DrawablePropertyInitializer<in T>(Drawable drawable, T value);
-
         public StoryboardSprite(string path, Anchor origin, Vector2 initialPosition)
+            : base(path, origin, initialPosition)
         {
-            Path = path;
-            Origin = origin;
-            InitialPosition = initialPosition;
         }
 
-        public CommandLoop AddLoop(double startTime, int repeatCount)
-        {
-            var loop = new CommandLoop(startTime, repeatCount);
-            loops.Add(loop);
-            return loop;
-        }
-
-        public CommandTrigger AddTrigger(string triggerName, double startTime, double endTime, int groupNumber)
-        {
-            var trigger = new CommandTrigger(triggerName, startTime, endTime, groupNumber);
-            triggers.Add(trigger);
-            return trigger;
-        }
-
-        public virtual Drawable CreateDrawable()
-            => new DrawableStoryboardSprite(this);
-
-        public void ApplyTransforms(Drawable drawable, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups = null)
-        {
-            // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
-            // To achieve this, commands are "generated" as pairs of (command, initFunc, transformFunc) and batched into a contiguous list
-            // The list is then stably-sorted (to preserve command order), and applied to the drawable sequentially.
-
-            List<IGeneratedCommand> generated = new List<IGeneratedCommand>();
-
-            generateCommands(generated, getCommands(g => g.X, triggeredGroups), (d, value) => d.X = value);
-            generateCommands(generated, getCommands(g => g.Y, triggeredGroups), (d, value) => d.Y = value);
-            generateCommands(generated, getCommands(g => g.Scale, triggeredGroups), (d, value) => d.Scale = value);
-            generateCommands(generated, getCommands(g => g.Rotation, triggeredGroups), (d, value) => d.Rotation = value);
-            generateCommands(generated, getCommands(g => g.Colour, triggeredGroups), (d, value) => d.Colour = value);
-            generateCommands(generated, getCommands(g => g.Alpha, triggeredGroups), (d, value) => d.Alpha = value);
-            generateCommands(generated, getCommands(g => g.BlendingParameters, triggeredGroups), (d, value) => d.Blending = value, false);
-
-            if (drawable is IVectorScalable vectorScalable)
-            {
-                generateCommands(generated, getCommands(g => g.VectorScale, triggeredGroups), (_, value) => vectorScalable.VectorScale = value);
-            }
-
-            if (drawable is IFlippable flippable)
-            {
-                generateCommands(generated, getCommands(g => g.FlipH, triggeredGroups), (_, value) => flippable.FlipH = value, false);
-                generateCommands(generated, getCommands(g => g.FlipV, triggeredGroups), (_, value) => flippable.FlipV = value, false);
-            }
-
-            foreach (var command in generated.OrderBy(g => g.StartTime))
-                command.ApplyTo(drawable);
-        }
-
-        private void generateCommands<T>(List<IGeneratedCommand> resultList, IEnumerable<CommandTimeline<T>.TypedCommand> commands,
-                                         DrawablePropertyInitializer<T> initializeProperty, bool alwaysInitialize = true)
-        {
-            bool initialized = false;
-
-            foreach (var command in commands)
-            {
-                DrawablePropertyInitializer<T>? initFunc = null;
-
-                if (!initialized)
-                {
-                    if (alwaysInitialize || command.StartTime == command.EndTime)
-                        initFunc = initializeProperty;
-                    initialized = true;
-                }
-
-                resultList.Add(new GeneratedCommand<T>(command, initFunc));
-            }
-        }
-
-        private IEnumerable<CommandTimeline<T>.TypedCommand> getCommands<T>(CommandTimelineSelector<T> timelineSelector, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups)
-        {
-            var commands = TimelineGroup.GetCommands(timelineSelector);
-            foreach (var loop in loops)
-                commands = commands.Concat(loop.GetCommands(timelineSelector));
-
-            if (triggeredGroups != null)
-            {
-                foreach (var pair in triggeredGroups)
-                    commands = commands.Concat(pair.Item1.GetCommands(timelineSelector, pair.Item2));
-            }
-
-            return commands;
-        }
-
-        public override string ToString()
-            => $"{Path}, {Origin}, {InitialPosition}";
-
-        private interface IGeneratedCommand
-        {
-            double StartTime { get; }
-
-            void ApplyTo(Drawable drawable);
-        }
-
-        private readonly struct GeneratedCommand<T> : IGeneratedCommand
-        {
-            public double StartTime => command.StartTime;
-
-            private readonly DrawablePropertyInitializer<T>? initializeProperty;
-            private readonly CommandTimeline<T>.TypedCommand command;
-
-            public GeneratedCommand(CommandTimeline<T>.TypedCommand command, DrawablePropertyInitializer<T>? initializeProperty)
-            {
-                this.command = command;
-                this.initializeProperty = initializeProperty;
-            }
-
-            public void ApplyTo(Drawable drawable)
-            {
-                initializeProperty?.Invoke(drawable, command.StartValue);
-
-                switch (command.PropertyName)
-                {
-                    case "VectorScale":
-                        if (command.LoopCount == 0)
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then()
-                                                           .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
-                            }
-                        }
-                        else
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                ((IVectorScalable)drawable).TransformTo(command.PropertyName, command.StartValue).Then()
-                                                           .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
-                                                           .Loop(command.Delay, command.LoopCount);
-                            }
-                        }
-
-                        break;
-
-                    case "FlipH":
-                    case "FlipV":
-                        if (command.LoopCount == 0)
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                                      .TransformTo(command.PropertyName, command.EndValue);
-                            }
-                        }
-                        else
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                ((IFlippable)drawable).TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                                      .TransformTo(command.PropertyName, command.EndValue)
-                                                      .Loop(command.Delay, command.LoopCount);
-                            }
-                        }
-
-                        break;
-
-                    case "Blending":
-                        if (command.LoopCount == 0)
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                        .TransformTo(command.PropertyName, command.EndValue);
-                            }
-                        }
-                        else
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                        .TransformTo(command.PropertyName, command.EndValue)
-                                        .Loop(command.Delay, command.LoopCount);
-                            }
-                        }
-
-                        break;
-
-                    default:
-                        if (command.LoopCount == 0)
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                drawable.TransformTo(command.PropertyName, command.StartValue).Then()
-                                        .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
-                            }
-                        }
-                        else
-                        {
-                            using (drawable.BeginAbsoluteSequence(command.StartTime))
-                            {
-                                drawable.TransformTo(command.PropertyName, command.StartValue).Then()
-                                        .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
-                                        .Loop(command.Delay, command.LoopCount);
-                            }
-                        }
-
-                        break;
-                }
-            }
-        }
+        public override DrawableStoryboardSprite CreateStoryboardDrawable() => new DrawableStoryboardSprite(this);
     }
 }
+
+

From 1c8ede854d5ba97deafeea83abee96c61cb367bb Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 6 Mar 2024 00:17:56 +0300
Subject: [PATCH 282/930] Remove blank lines

---
 osu.Game/Storyboards/StoryboardSprite.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 69994f77a4..8eaab9428d 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -17,5 +17,3 @@ namespace osu.Game.Storyboards
         public override DrawableStoryboardSprite CreateStoryboardDrawable() => new DrawableStoryboardSprite(this);
     }
 }
-
-

From 07392a4d3eb7ff9c08c863d0aaf27cb33161dac7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 6 Mar 2024 01:10:22 +0300
Subject: [PATCH 283/930] Further simplify transform application

---
 .../StoryboardElementWithDuration.cs          | 37 +++----------------
 1 file changed, 6 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardElementWithDuration.cs b/osu.Game/Storyboards/StoryboardElementWithDuration.cs
index 0c89b40c36..06924a26ef 100644
--- a/osu.Game/Storyboards/StoryboardElementWithDuration.cs
+++ b/osu.Game/Storyboards/StoryboardElementWithDuration.cs
@@ -222,38 +222,13 @@ namespace osu.Game.Storyboards
                 initializeProperty?.Invoke(drawable, command.StartValue);
 
                 using (drawable.BeginAbsoluteSequence(command.StartTime))
-                    transform(drawable);
-            }
+                {
+                    var sequence = command.IsParameterCommand
+                        ? drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue)
+                        : drawable.TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
 
-            private void transform(TDrawable drawable)
-            {
-                if (command.IsParameterCommand)
-                {
-                    if (command.LoopCount == 0)
-                    {
-                        drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                .TransformTo(command.PropertyName, command.EndValue);
-                    }
-                    else
-                    {
-                        drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration)
-                                .TransformTo(command.PropertyName, command.EndValue)
-                                .Loop(command.Delay, command.LoopCount);
-                    }
-                }
-                else
-                {
-                    if (command.LoopCount == 0)
-                    {
-                        drawable.TransformTo(command.PropertyName, command.StartValue).Then()
-                                .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
-                    }
-                    else
-                    {
-                        drawable.TransformTo(command.PropertyName, command.StartValue).Then()
-                                .TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing)
-                                .Loop(command.Delay, command.LoopCount);
-                    }
+                    if (command.LoopCount > 0)
+                        sequence.Loop(command.Delay, command.LoopCount);
                 }
             }
         }

From b53777c2a42bab857664cb5c2887e5cced0c0625 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 5 Mar 2024 18:15:53 -0500
Subject: [PATCH 284/930] Refactor room secret handling to use JSON

Also log room secrets for debugging purposes
---
 osu.Desktop/DiscordRichPresence.cs | 41 ++++++++++++++++++++++++------
 1 file changed, 33 insertions(+), 8 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 85b6129043..7315ee0c17 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -5,6 +5,7 @@ using System;
 using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
+using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -147,7 +148,13 @@ namespace osu.Desktop
                         Size = room.Users.Count,
                     };
 
-                    presence.Secrets.JoinSecret = $"{room.RoomID}:{room.Settings.Password}";
+                    RoomSecret roomSecret = new RoomSecret
+                    {
+                        RoomID = room.RoomID,
+                        Password = room.Settings.Password,
+                    };
+
+                    presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
                 }
                 else
                 {
@@ -182,9 +189,13 @@ namespace osu.Desktop
         private void onJoin(object sender, JoinMessage args)
         {
             game.Window?.Raise();
+            Logger.Log($"Received room secret from Discord RPC Client: {args.Secret}", LoggingTarget.Network, LogLevel.Debug);
 
             if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
+            {
                 Logger.Log("Could not parse room from Discord RPC Client", LoggingTarget.Network, LogLevel.Important);
+                return;
+            }
 
             var request = new GetRoomRequest(roomId);
             request.Success += room => Schedule(() =>
@@ -216,21 +227,26 @@ namespace osu.Desktop
             });
         }
 
-        private static bool tryParseRoomSecret(ReadOnlySpan<char> secret, out long roomId, out string? password)
+        private static bool tryParseRoomSecret(string secretJson, out long roomId, out string? password)
         {
             roomId = 0;
             password = null;
 
-            int roomSecretSplitIndex = secret.IndexOf(':');
+            RoomSecret? roomSecret;
 
-            if (roomSecretSplitIndex == -1)
+            try
+            {
+                roomSecret = JsonConvert.DeserializeObject<RoomSecret>(secretJson);
+            }
+            catch
+            {
                 return false;
+            }
 
-            if (!long.TryParse(secret[..roomSecretSplitIndex], out roomId))
-                return false;
+            if (roomSecret == null) return false;
 
-            password = secret[(roomSecretSplitIndex + 1)..].ToString();
-            if (password.Length == 0) password = null;
+            roomId = roomSecret.RoomID;
+            password = roomSecret.Password;
 
             return true;
         }
@@ -254,5 +270,14 @@ namespace osu.Desktop
             client.Dispose();
             base.Dispose(isDisposing);
         }
+
+        private class RoomSecret
+        {
+            [JsonProperty(@"roomId", Required = Required.Always)]
+            public long RoomID { get; set; }
+
+            [JsonProperty(@"password", Required = Required.AllowNull)]
+            public string? Password { get; set; }
+        }
     }
 }

From 98713003176da6b09bafeea7392564959098956b Mon Sep 17 00:00:00 2001
From: Jayden <jvyden@jvyden.xyz>
Date: Tue, 5 Mar 2024 18:22:39 -0500
Subject: [PATCH 285/930] Improve language of user-facing errors
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Desktop/DiscordRichPresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 7315ee0c17..8fecd015d4 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -193,7 +193,7 @@ namespace osu.Desktop
 
             if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
             {
-                Logger.Log("Could not parse room from Discord RPC Client", LoggingTarget.Network, LogLevel.Important);
+                Logger.Log("Could not join multiplayer room.", LoggingTarget.Network, LogLevel.Important);
                 return;
             }
 

From 6455c0583b5e607baeca7f584410bc63515aa619 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 10:19:40 +0800
Subject: [PATCH 286/930] Update usage of `CircularProgress.Current`

---
 .../Skinning/Argon/ArgonSpinnerProgressArc.cs             | 6 +++---
 .../Skinning/Argon/ArgonSpinnerRingArc.cs                 | 6 +++---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs | 8 ++++++--
 osu.Game/Overlays/Volume/VolumeMeter.cs                   | 6 +++---
 .../Edit/Compose/Components/CircularDistanceSnapGrid.cs   | 2 +-
 osu.Game/Screens/Edit/Timing/TapButton.cs                 | 6 +++---
 osu.Game/Screens/Play/HUD/HoldForMenuButton.cs            | 7 ++++++-
 .../Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs   | 6 +++---
 .../Screens/Ranking/Expanded/Accuracy/GradedCircles.cs    | 2 +-
 osu.Game/Skinning/LegacySongProgress.cs                   | 4 ++--
 10 files changed, 31 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerProgressArc.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerProgressArc.cs
index 76afeeb2c4..1de5b1f309 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerProgressArc.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerProgressArc.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
                     Origin = Anchor.Centre,
                     Colour = Color4.White.Opacity(0.25f),
                     RelativeSizeAxes = Axes.Both,
-                    Current = { Value = arc_fill },
+                    Progress = arc_fill,
                     Rotation = 90 - arc_fill * 180,
                     InnerRadius = arc_radius,
                     RoundedCaps = true,
@@ -71,9 +71,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
             background.Alpha = spinner.Progress >= 1 ? 0 : 1;
 
             fill.Alpha = (float)Interpolation.DampContinuously(fill.Alpha, spinner.Progress > 0 && spinner.Progress < 1 ? 1 : 0, 40f, (float)Math.Abs(Time.Elapsed));
-            fill.Current.Value = (float)Interpolation.DampContinuously(fill.Current.Value, spinner.Progress >= 1 ? 0 : arc_fill * spinner.Progress, 40f, (float)Math.Abs(Time.Elapsed));
+            fill.Progress = (float)Interpolation.DampContinuously(fill.Progress, spinner.Progress >= 1 ? 0 : arc_fill * spinner.Progress, 40f, (float)Math.Abs(Time.Elapsed));
 
-            fill.Rotation = (float)(90 - fill.Current.Value * 180);
+            fill.Rotation = (float)(90 - fill.Progress * 180);
         }
 
         private partial class ProgressFill : CircularProgress
diff --git a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerRingArc.cs b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerRingArc.cs
index 702c5c2675..12cd0994b4 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerRingArc.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Argon/ArgonSpinnerRingArc.cs
@@ -33,7 +33,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 RelativeSizeAxes = Axes.Both,
-                Current = { Value = arc_fill },
+                Progress = arc_fill,
                 Rotation = -arc_fill * 180,
                 InnerRadius = arc_radius,
                 RoundedCaps = true,
@@ -44,10 +44,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Argon
         {
             base.Update();
 
-            fill.Current.Value = (float)Interpolation.DampContinuously(fill.Current.Value, spinner.Progress >= 1 ? arc_fill_complete : arc_fill, 40f, (float)Math.Abs(Time.Elapsed));
+            fill.Progress = (float)Interpolation.DampContinuously(fill.Progress, spinner.Progress >= 1 ? arc_fill_complete : arc_fill, 40f, (float)Math.Abs(Time.Elapsed));
             fill.InnerRadius = (float)Interpolation.DampContinuously(fill.InnerRadius, spinner.Progress >= 1 ? arc_radius * 2.2f : arc_radius, 40f, (float)Math.Abs(Time.Elapsed));
 
-            fill.Rotation = (float)(-fill.Current.Value * 180);
+            fill.Rotation = (float)(-fill.Progress * 180);
         }
     }
 }
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index 5a26a988fb..cd498c474a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -86,11 +86,15 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             Dimmed.BindValueChanged(_ => updateState());
 
             playButton.Playing.BindValueChanged(_ => updateState(), true);
-            ((IBindable<double>)progress.Current).BindTo(playButton.Progress);
-
             FinishTransforms(true);
         }
 
+        protected override void Update()
+        {
+            base.Update();
+            progress.Progress = playButton.Progress.Value;
+        }
+
         private void updateState()
         {
             bool shouldDim = Dimmed.Value || playButton.Playing.Value;
diff --git a/osu.Game/Overlays/Volume/VolumeMeter.cs b/osu.Game/Overlays/Volume/VolumeMeter.cs
index 6ec4971f06..e96cd0fa46 100644
--- a/osu.Game/Overlays/Volume/VolumeMeter.cs
+++ b/osu.Game/Overlays/Volume/VolumeMeter.cs
@@ -235,7 +235,7 @@ namespace osu.Game.Overlays.Volume
 
             Bindable.BindValueChanged(volume => { this.TransformTo(nameof(DisplayVolume), volume.NewValue, 400, Easing.OutQuint); }, true);
 
-            bgProgress.Current.Value = 0.75f;
+            bgProgress.Progress = 0.75f;
         }
 
         private int? displayVolumeInt;
@@ -265,8 +265,8 @@ namespace osu.Game.Overlays.Volume
                     text.Text = intValue.ToString(CultureInfo.CurrentCulture);
                 }
 
-                volumeCircle.Current.Value = displayVolume * 0.75f;
-                volumeCircleGlow.Current.Value = displayVolume * 0.75f;
+                volumeCircle.Progress = displayVolume * 0.75f;
+                volumeCircleGlow.Progress = displayVolume * 0.75f;
 
                 if (intVolumeChanged && IsLoaded)
                     Scheduler.AddOnce(playTickSound);
diff --git a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
index e33ef66007..92fe52148c 100644
--- a/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/CircularDistanceSnapGrid.cs
@@ -140,7 +140,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
                 Colour = this.baseColour = baseColour;
 
-                Current.Value = 1;
+                Progress = 1;
             }
 
             protected override void Update()
diff --git a/osu.Game/Screens/Edit/Timing/TapButton.cs b/osu.Game/Screens/Edit/Timing/TapButton.cs
index fd60fb1b5b..d2ae0e76cf 100644
--- a/osu.Game/Screens/Edit/Timing/TapButton.cs
+++ b/osu.Game/Screens/Edit/Timing/TapButton.cs
@@ -366,7 +366,7 @@ namespace osu.Game.Screens.Edit.Timing
                     new CircularProgress
                     {
                         RelativeSizeAxes = Axes.Both,
-                        Current = { Value = 1f / light_count - angular_light_gap },
+                        Progress = 1f / light_count - angular_light_gap,
                         Colour = colourProvider.Background2,
                     },
                     fillContent = new Container
@@ -379,7 +379,7 @@ namespace osu.Game.Screens.Edit.Timing
                             new CircularProgress
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Current = { Value = 1f / light_count - angular_light_gap },
+                                Progress = 1f / light_count - angular_light_gap,
                                 Blending = BlendingParameters.Additive
                             },
                             // Please do not try and make sense of this.
@@ -388,7 +388,7 @@ namespace osu.Game.Screens.Edit.Timing
                             Glow = new CircularProgress
                             {
                                 RelativeSizeAxes = Axes.Both,
-                                Current = { Value = 1f / light_count - 0.01f },
+                                Progress = 1f / light_count - 0.01f,
                                 Blending = BlendingParameters.Additive
                             }.WithEffect(new GlowEffect
                             {
diff --git a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
index a260156595..6d045e5f01 100644
--- a/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
+++ b/osu.Game/Screens/Play/HUD/HoldForMenuButton.cs
@@ -198,9 +198,14 @@ namespace osu.Game.Screens.Play.HUD
                 bind();
             }
 
+            protected override void Update()
+            {
+                base.Update();
+                circularProgress.Progress = Progress.Value;
+            }
+
             private void bind()
             {
-                ((IBindable<double>)circularProgress.Current).BindTo(Progress);
                 Progress.ValueChanged += progress =>
                 {
                     icon.Scale = new Vector2(1 + (float)progress.NewValue * 0.2f);
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index 83b02a0951..2231346404 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -147,7 +147,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                     Colour = OsuColour.Gray(47),
                     Alpha = 0.5f,
                     InnerRadius = accuracy_circle_radius + 0.01f, // Extends a little bit into the circle
-                    Current = { Value = 1 },
+                    Progress = 1,
                 },
                 accuracyCircle = new CircularProgress
                 {
@@ -268,7 +268,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                 if (targetAccuracy < 1 && targetAccuracy >= visual_alignment_offset)
                     targetAccuracy -= visual_alignment_offset;
 
-                accuracyCircle.FillTo(targetAccuracy, ACCURACY_TRANSFORM_DURATION, ACCURACY_TRANSFORM_EASING);
+                accuracyCircle.ProgressTo(targetAccuracy, ACCURACY_TRANSFORM_DURATION, ACCURACY_TRANSFORM_EASING);
 
                 if (withFlair)
                 {
@@ -359,7 +359,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                                 .FadeOut(800, Easing.Out);
 
                             accuracyCircle
-                                .FillTo(accuracyS - GRADE_SPACING_PERCENTAGE / 2 - visual_alignment_offset, 70, Easing.OutQuint);
+                                .ProgressTo(accuracyS - GRADE_SPACING_PERCENTAGE / 2 - visual_alignment_offset, 70, Easing.OutQuint);
 
                             badges.Single(b => b.Rank == getRank(ScoreRank.S))
                                   .FadeOut(70, Easing.OutQuint);
diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/GradedCircles.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/GradedCircles.cs
index 33b71c53a7..633ed6d92e 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/GradedCircles.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/GradedCircles.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
         {
             public double RevealProgress
             {
-                set => Current.Value = Math.Clamp(value, startProgress, endProgress) - startProgress;
+                set => Progress = Math.Clamp(value, startProgress, endProgress) - startProgress;
             }
 
             private readonly double startProgress;
diff --git a/osu.Game/Skinning/LegacySongProgress.cs b/osu.Game/Skinning/LegacySongProgress.cs
index 4295060a3a..9af82c4992 100644
--- a/osu.Game/Skinning/LegacySongProgress.cs
+++ b/osu.Game/Skinning/LegacySongProgress.cs
@@ -72,14 +72,14 @@ namespace osu.Game.Skinning
                 circularProgress.Scale = new Vector2(-1, 1);
                 circularProgress.Anchor = Anchor.TopRight;
                 circularProgress.Colour = new Colour4(199, 255, 47, 153);
-                circularProgress.Current.Value = 1 - progress;
+                circularProgress.Progress = 1 - progress;
             }
             else
             {
                 circularProgress.Scale = new Vector2(1);
                 circularProgress.Anchor = Anchor.TopLeft;
                 circularProgress.Colour = new Colour4(255, 255, 255, 153);
-                circularProgress.Current.Value = progress;
+                circularProgress.Progress = progress;
             }
         }
     }

From b53b752e543d563b1059cc66d6dd8c6077bb6e01 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 10:42:20 +0800
Subject: [PATCH 287/930] Update usage of `MathUtils`

---
 osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs                  | 2 +-
 .../Objects/Drawables/DrawableSliderRepeat.cs                | 2 +-
 osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs            | 2 +-
 .../Skinning/Default/SpinnerRotationTracker.cs               | 2 +-
 osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs          | 2 +-
 osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs         | 3 +--
 osu.Game/Graphics/Cursor/MenuCursorContainer.cs              | 2 +-
 osu.Game/Graphics/UserInterface/OsuNumberBox.cs              | 4 +---
 osu.Game/IO/Archives/ZipArchiveReader.cs                     | 3 +--
 .../Overlays/Settings/Sections/Input/TabletAreaSelection.cs  | 3 +--
 osu.Game/Overlays/Settings/SettingsNumberBox.cs              | 2 +-
 osu.Game/Screens/Menu/LogoVisualisation.cs                   | 4 ++--
 osu.Game/Utils/GeometryUtils.cs                              | 5 ++---
 13 files changed, 15 insertions(+), 21 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
index df9544b71e..992f4d5f03 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModSpunOut.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Rulesets.Osu.Mods
             // multiply the SPM by 1.01 to ensure that the spinner is completed. if the calculation is left exact,
             // some spinners may not complete due to very minor decimal loss during calculation
             float rotationSpeed = (float)(1.01 * spinner.HitObject.SpinsRequired / spinner.HitObject.Duration);
-            spinner.RotationTracker.AddRotation(MathUtils.RadiansToDegrees((float)rateIndependentElapsedTime * rotationSpeed * MathF.PI * 2.0f));
+            spinner.RotationTracker.AddRotation(float.RadiansToDegrees((float)rateIndependentElapsedTime * rotationSpeed * MathF.PI * 2.0f));
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
index 3239565528..fcbd0edfe0 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
@@ -146,7 +146,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
                 break;
             }
 
-            float aimRotation = MathUtils.RadiansToDegrees(MathF.Atan2(aimRotationVector.Y - Position.Y, aimRotationVector.X - Position.X));
+            float aimRotation = float.RadiansToDegrees(MathF.Atan2(aimRotationVector.Y - Position.Y, aimRotationVector.X - Position.X));
             while (Math.Abs(aimRotation - Arrow.Rotation) > 180)
                 aimRotation += aimRotation < Arrow.Rotation ? 360 : -360;
 
diff --git a/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs b/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs
index 1cf6bc91f0..d43e6092c2 100644
--- a/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs
+++ b/osu.Game.Rulesets.Osu/Replays/OsuAutoGenerator.cs
@@ -342,7 +342,7 @@ namespace osu.Game.Rulesets.Osu.Replays
             // 0.05 rad/ms, or ~477 RPM, as per stable.
             // the redundant conversion from RPM to rad/ms is here for ease of testing custom SPM specs.
             const float spin_rpm = 0.05f / (2 * MathF.PI) * 60000;
-            float radsPerMillisecond = MathUtils.DegreesToRadians(spin_rpm * 360) / 60000;
+            float radsPerMillisecond = float.DegreesToRadians(spin_rpm * 360) / 60000;
 
             switch (h)
             {
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
index 1d75663fd9..7e97f826f9 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/SpinnerRotationTracker.cs
@@ -66,7 +66,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
 
             if (mousePosition is Vector2 pos)
             {
-                float thisAngle = -MathUtils.RadiansToDegrees(MathF.Atan2(pos.X - DrawSize.X / 2, pos.Y - DrawSize.Y / 2));
+                float thisAngle = -float.RadiansToDegrees(MathF.Atan2(pos.X - DrawSize.X / 2, pos.Y - DrawSize.Y / 2));
                 float delta = lastAngle == null ? 0 : thisAngle - lastAngle.Value;
 
                 // Normalise the delta to -180 .. 180
diff --git a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
index f9d4a3b325..4b3b543ea4 100644
--- a/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
+++ b/osu.Game.Rulesets.Osu/Statistics/AccuracyHeatmap.cs
@@ -246,7 +246,7 @@ namespace osu.Game.Rulesets.Osu.Statistics
             // Likewise sin(pi/2)=1 and sin(3pi/2)=-1, whereas we actually want these values to appear on the bottom/top respectively, so the y-coordinate also needs to be inverted.
             //
             // We also need to apply the anti-clockwise rotation.
-            double rotatedAngle = finalAngle - MathUtils.DegreesToRadians(rotation);
+            double rotatedAngle = finalAngle - float.DegreesToRadians(rotation);
             var rotatedCoordinate = -1 * new Vector2((float)Math.Cos(rotatedAngle), (float)Math.Sin(rotatedAngle));
 
             Vector2 localCentre = new Vector2(points_per_dimension - 1) / 2;
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index cf4700bf85..6689f087cb 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using osu.Framework.Graphics;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO;
 using osu.Game.Storyboards;
@@ -230,7 +229,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Rotation.Add(easing, startTime, endTime, MathUtils.RadiansToDegrees(startValue), MathUtils.RadiansToDegrees(endValue));
+                                timelineGroup?.Rotation.Add(easing, startTime, endTime, float.RadiansToDegrees(startValue), float.RadiansToDegrees(endValue));
                                 break;
                             }
 
diff --git a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs b/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
index 7e42d45191..696ea62b42 100644
--- a/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
+++ b/osu.Game/Graphics/Cursor/MenuCursorContainer.cs
@@ -157,7 +157,7 @@ namespace osu.Game.Graphics.Cursor
                 if (dragRotationState == DragRotationState.Rotating && distance > 0)
                 {
                     Vector2 offset = e.MousePosition - positionMouseDown;
-                    float degrees = MathUtils.RadiansToDegrees(MathF.Atan2(-offset.X, offset.Y)) + 24.3f;
+                    float degrees = float.RadiansToDegrees(MathF.Atan2(-offset.X, offset.Y)) + 24.3f;
 
                     // Always rotate in the direction of least distance
                     float diff = (degrees - activeCursor.Rotation) % 360;
diff --git a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
index df92863797..e9b28f4771 100644
--- a/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuNumberBox.cs
@@ -1,14 +1,12 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Extensions;
-
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class OsuNumberBox : OsuTextBox
     {
         protected override bool AllowIme => false;
 
-        protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
+        protected override bool CanAddCharacter(char character) => char.IsAsciiDigit(character);
     }
 }
diff --git a/osu.Game/IO/Archives/ZipArchiveReader.cs b/osu.Game/IO/Archives/ZipArchiveReader.cs
index 5ef03b3641..7d7ce858dd 100644
--- a/osu.Game/IO/Archives/ZipArchiveReader.cs
+++ b/osu.Game/IO/Archives/ZipArchiveReader.cs
@@ -8,7 +8,6 @@ using System.Collections.Generic;
 using System.IO;
 using System.Linq;
 using Microsoft.Toolkit.HighPerformance;
-using osu.Framework.Extensions;
 using osu.Framework.IO.Stores;
 using SharpCompress.Archives.Zip;
 using SixLabors.ImageSharp.Memory;
@@ -36,7 +35,7 @@ namespace osu.Game.IO.Archives
             var owner = MemoryAllocator.Default.Allocate<byte>((int)entry.Size);
 
             using (Stream s = entry.OpenEntryStream())
-                s.ReadToFill(owner.Memory.Span);
+                s.ReadExactly(owner.Memory.Span);
 
             return new MemoryOwnerMemoryStream(owner);
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs b/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs
index 686002fe71..33f4f49173 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/TabletAreaSelection.cs
@@ -13,7 +13,6 @@ using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Framework.Input.Handlers.Tablet;
-using osu.Framework.Utils;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osuTK;
@@ -196,7 +195,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             var matrix = Matrix3.Identity;
 
             MatrixExtensions.TranslateFromLeft(ref matrix, offset);
-            MatrixExtensions.RotateFromLeft(ref matrix, MathUtils.DegreesToRadians(rotation.Value));
+            MatrixExtensions.RotateFromLeft(ref matrix, float.DegreesToRadians(rotation.Value));
 
             usableAreaQuad *= matrix;
 
diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index a0f85eda31..cdf648fc5f 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Overlays.Settings
         {
             protected override bool AllowIme => false;
 
-            protected override bool CanAddCharacter(char character) => character.IsAsciiDigit();
+            protected override bool CanAddCharacter(char character) => char.IsAsciiDigit(character);
 
             public new void NotifyInputError() => base.NotifyInputError();
         }
diff --git a/osu.Game/Screens/Menu/LogoVisualisation.cs b/osu.Game/Screens/Menu/LogoVisualisation.cs
index b722b83280..c47ce91711 100644
--- a/osu.Game/Screens/Menu/LogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/LogoVisualisation.cs
@@ -209,13 +209,13 @@ namespace osu.Game.Screens.Menu
                         if (audioData[i] < amplitude_dead_zone)
                             continue;
 
-                        float rotation = MathUtils.DegreesToRadians(i / (float)bars_per_visualiser * 360 + j * 360 / visualiser_rounds);
+                        float rotation = float.DegreesToRadians(i / (float)bars_per_visualiser * 360 + j * 360 / visualiser_rounds);
                         float rotationCos = MathF.Cos(rotation);
                         float rotationSin = MathF.Sin(rotation);
                         // taking the cos and sin to the 0..1 range
                         var barPosition = new Vector2(rotationCos / 2 + 0.5f, rotationSin / 2 + 0.5f) * size;
 
-                        var barSize = new Vector2(size * MathF.Sqrt(2 * (1 - MathF.Cos(MathUtils.DegreesToRadians(360f / bars_per_visualiser)))) / 2f, bar_length * audioData[i]);
+                        var barSize = new Vector2(size * MathF.Sqrt(2 * (1 - MathF.Cos(float.DegreesToRadians(360f / bars_per_visualiser)))) / 2f, bar_length * audioData[i]);
                         // The distance between the position and the sides of the bar.
                         var bottomOffset = new Vector2(-rotationSin * barSize.X / 2, rotationCos * barSize.X / 2);
                         // The distance between the bottom side of the bar and the top side.
diff --git a/osu.Game/Utils/GeometryUtils.cs b/osu.Game/Utils/GeometryUtils.cs
index 725e93d098..dbeba4dfc1 100644
--- a/osu.Game/Utils/GeometryUtils.cs
+++ b/osu.Game/Utils/GeometryUtils.cs
@@ -6,7 +6,6 @@ using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
-using osu.Framework.Utils;
 using osu.Game.Rulesets.Objects.Types;
 using osuTK;
 
@@ -28,8 +27,8 @@ namespace osu.Game.Utils
             point.Y -= origin.Y;
 
             Vector2 ret;
-            ret.X = point.X * MathF.Cos(MathUtils.DegreesToRadians(angle)) + point.Y * MathF.Sin(MathUtils.DegreesToRadians(angle));
-            ret.Y = point.X * -MathF.Sin(MathUtils.DegreesToRadians(angle)) + point.Y * MathF.Cos(MathUtils.DegreesToRadians(angle));
+            ret.X = point.X * MathF.Cos(float.DegreesToRadians(angle)) + point.Y * MathF.Sin(float.DegreesToRadians(angle));
+            ret.Y = point.X * -MathF.Sin(float.DegreesToRadians(angle)) + point.Y * MathF.Cos(float.DegreesToRadians(angle));
 
             ret.X += origin.X;
             ret.Y += origin.Y;

From 0696e7de524123d1b332a166c4cd81f5d6c24c15 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 10:42:42 +0800
Subject: [PATCH 288/930] Update ImageSharp usages

---
 osu.Game.Tests/Visual/Gameplay/TestScenePlayerMaxDimensions.cs | 2 +-
 osu.Game/Beatmaps/BeatmapPanelBackgroundTextureLoaderStore.cs  | 2 +-
 osu.Game/Skinning/LegacyTextureLoaderStore.cs                  | 2 +-
 osu.Game/Skinning/MaxDimensionLimitedTextureLoaderStore.cs     | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerMaxDimensions.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerMaxDimensions.cs
index 53a4abdd07..3f78dedec5 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerMaxDimensions.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerMaxDimensions.cs
@@ -121,7 +121,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
                 private TextureUpload upscale(TextureUpload textureUpload)
                 {
-                    var image = Image.LoadPixelData(textureUpload.Data.ToArray(), textureUpload.Width, textureUpload.Height);
+                    var image = Image.LoadPixelData(textureUpload.Data, textureUpload.Width, textureUpload.Height);
 
                     // The original texture upload will no longer be returned or used.
                     textureUpload.Dispose();
diff --git a/osu.Game/Beatmaps/BeatmapPanelBackgroundTextureLoaderStore.cs b/osu.Game/Beatmaps/BeatmapPanelBackgroundTextureLoaderStore.cs
index 128e100e4b..cf58ae73fe 100644
--- a/osu.Game/Beatmaps/BeatmapPanelBackgroundTextureLoaderStore.cs
+++ b/osu.Game/Beatmaps/BeatmapPanelBackgroundTextureLoaderStore.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Beatmaps
             // The original texture upload will no longer be returned or used.
             textureUpload.Dispose();
 
-            Size size = image.Size();
+            Size size = image.Size;
 
             // Assume that panel backgrounds are always displayed using `FillMode.Fill`.
             // Also assume that all backgrounds are wider than they are tall, so the
diff --git a/osu.Game/Skinning/LegacyTextureLoaderStore.cs b/osu.Game/Skinning/LegacyTextureLoaderStore.cs
index 29206bbb85..5045374c14 100644
--- a/osu.Game/Skinning/LegacyTextureLoaderStore.cs
+++ b/osu.Game/Skinning/LegacyTextureLoaderStore.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Skinning
 
         private TextureUpload convertToGrayscale(TextureUpload textureUpload)
         {
-            var image = Image.LoadPixelData(textureUpload.Data.ToArray(), textureUpload.Width, textureUpload.Height);
+            var image = Image.LoadPixelData(textureUpload.Data, textureUpload.Width, textureUpload.Height);
 
             // stable uses `0.299 * r + 0.587 * g + 0.114 * b`
             // (https://github.com/peppy/osu-stable-reference/blob/013c3010a9d495e3471a9c59518de17006f9ad89/osu!/Graphics/Textures/pTexture.cs#L138-L153)
diff --git a/osu.Game/Skinning/MaxDimensionLimitedTextureLoaderStore.cs b/osu.Game/Skinning/MaxDimensionLimitedTextureLoaderStore.cs
index f15097a169..58dadbe753 100644
--- a/osu.Game/Skinning/MaxDimensionLimitedTextureLoaderStore.cs
+++ b/osu.Game/Skinning/MaxDimensionLimitedTextureLoaderStore.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Skinning
 
             if (textureUpload.Height > max_supported_texture_size || textureUpload.Width > max_supported_texture_size)
             {
-                var image = Image.LoadPixelData(textureUpload.Data.ToArray(), textureUpload.Width, textureUpload.Height);
+                var image = Image.LoadPixelData(textureUpload.Data, textureUpload.Width, textureUpload.Height);
 
                 // The original texture upload will no longer be returned or used.
                 textureUpload.Dispose();

From 4c7678225ee018e24724024fe88580c024164b55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 12:13:41 +0800
Subject: [PATCH 289/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 1b395a7c83..4901f30d8a 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.223.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.306.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 6854b820ee..942763e388 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.223.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.207.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 747d6059da..6b63bfa1e2 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.223.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.306.0" />
   </ItemGroup>
 </Project>

From 3a224211aa322a0055342f10bd36e0af3c3b078c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 12:17:00 +0800
Subject: [PATCH 290/930] Update various packages which shouldn't cause issues

---
 osu.Game.Benchmarks/osu.Game.Benchmarks.csproj | 2 +-
 osu.Game/osu.Game.csproj                       | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
index 64da5412a8..af84ee47f1 100644
--- a/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
+++ b/osu.Game.Benchmarks/osu.Game.Benchmarks.csproj
@@ -7,7 +7,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="BenchmarkDotNet" Version="0.13.9" />
+    <PackageReference Include="BenchmarkDotNet" Version="0.13.12" />
     <PackageReference Include="nunit" Version="3.14.0" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.5.0" />
   </ItemGroup>
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 942763e388..b143a3a6b1 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -20,8 +20,8 @@
   </ItemGroup>
   <ItemGroup Label="Package References">
     <PackageReference Include="AutoMapper" Version="12.0.1" />
-    <PackageReference Include="DiffPlex" Version="1.7.1" />
-    <PackageReference Include="HtmlAgilityPack" Version="1.11.57" />
+    <PackageReference Include="DiffPlex" Version="1.7.2" />
+    <PackageReference Include="HtmlAgilityPack" Version="1.11.59" />
     <PackageReference Include="Humanizer" Version="2.14.1" />
     <PackageReference Include="MessagePack" Version="2.5.140" />
     <PackageReference Include="Microsoft.AspNetCore.SignalR.Client" Version="7.0.15" />
@@ -35,14 +35,14 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="11.5.0" />
+    <PackageReference Include="Realm" Version="11.7.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.207.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />
     <PackageReference Include="NUnit" Version="3.14.0" />
-    <PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="2.1.7" />
+    <PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="2.1.8" />
     <PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
     <PackageReference Include="TagLibSharp" Version="2.3.0" />
 

From 98ca021e6628d94df508709482f047a2cff7cdde Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Wed, 6 Mar 2024 01:17:11 -0500
Subject: [PATCH 291/930] Catch and warn about osu!stable lobbies

---
 osu.Desktop/DiscordRichPresence.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 8fecd015d4..b4a7e80d48 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -191,6 +191,15 @@ namespace osu.Desktop
             game.Window?.Raise();
             Logger.Log($"Received room secret from Discord RPC Client: {args.Secret}", LoggingTarget.Network, LogLevel.Debug);
 
+            // Stable and Lazer share the same Discord client ID, meaning they can accept join requests from each other.
+            // Since they aren't compatible in multi, see if stable's format is being used and log to avoid confusion.
+            // https://discord.com/channels/188630481301012481/188630652340404224/1214697229063946291
+            if (args.Secret[0] != '{')
+            {
+                Logger.Log("osu!stable rooms are not compatible with lazer.", LoggingTarget.Network, LogLevel.Important);
+                return;
+            }
+
             if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
             {
                 Logger.Log("Could not join multiplayer room.", LoggingTarget.Network, LogLevel.Important);

From 53fffc6a75df70e82be5c1e1a3d2fe633f86c834 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 6 Mar 2024 07:57:59 +0100
Subject: [PATCH 292/930] Remove unused using directives

---
 osu.Game/Overlays/Settings/SettingsNumberBox.cs | 1 -
 osu.Game/Screens/Menu/LogoVisualisation.cs      | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game/Overlays/Settings/SettingsNumberBox.cs b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
index cdf648fc5f..fbcdb4a968 100644
--- a/osu.Game/Overlays/Settings/SettingsNumberBox.cs
+++ b/osu.Game/Overlays/Settings/SettingsNumberBox.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
-using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
diff --git a/osu.Game/Screens/Menu/LogoVisualisation.cs b/osu.Game/Screens/Menu/LogoVisualisation.cs
index c47ce91711..6d9d2f69b7 100644
--- a/osu.Game/Screens/Menu/LogoVisualisation.cs
+++ b/osu.Game/Screens/Menu/LogoVisualisation.cs
@@ -14,7 +14,6 @@ using osu.Framework.Graphics.Rendering;
 using osu.Framework.Graphics.Rendering.Vertices;
 using osu.Framework.Graphics.Shaders;
 using osu.Framework.Graphics.Textures;
-using osu.Framework.Utils;
 using osu.Game.Beatmaps;
 using osuTK;
 using osuTK.Graphics;

From 08609e19d6bb13669cb4f44e0ae6b80a7444c786 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 6 Mar 2024 11:40:10 +0100
Subject: [PATCH 293/930] Fix osu! standardised score estimation algorithm
 violating basic invariants

As it turns out, the "lower" and "upper" estimates of the combo portion
of the score being converted were misnomers. In selected cases
(scores with high accuracy but combo being lower than max by more than
a few objects) the janky score-based math could overestimate the count
of remaining objects in a map. For instance, in one case the numbers
worked out something like this:

- Accuracy: practically 100%
- Max combo on beatmap: 571x
- Max combo for score: 551x

The score-based estimation attempts to extract a "remaining object
count" from score, by doing something along of sqrt(571^2 - 551^2). That
comes out to _almost 150_. Which leads to the estimation overshooting
the total max combo count on the beatmap by some hundred objects.

To curtail this nonsense, enforce some basic invariants:

- Neither estimate is allowed to exceed maximum achievable
- Ensure that lower estimate is really lower and upper is really upper
  by just looking at the values and making sure that is so rather than
  just saying that it is.
---
 .../Database/StandardisedScoreMigrationTools.cs | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/StandardisedScoreMigrationTools.cs b/osu.Game/Database/StandardisedScoreMigrationTools.cs
index 0594c80390..53ff1a25ca 100644
--- a/osu.Game/Database/StandardisedScoreMigrationTools.cs
+++ b/osu.Game/Database/StandardisedScoreMigrationTools.cs
@@ -415,7 +415,7 @@ namespace osu.Game.Database
 
                     // Calculate how many times the longest combo the user has achieved in the play can repeat
                     // without exceeding the combo portion in score V1 as achieved by the player.
-                    // This is a pessimistic estimate; it intentionally does not operate on object count and uses only score instead.
+                    // This it intentionally does not operate on object count and uses only score instead.
                     double maximumOccurrencesOfLongestCombo = Math.Floor(comboPortionInScoreV1 / comboPortionFromLongestComboInScoreV1);
                     double comboPortionFromRepeatedLongestCombosInScoreV1 = maximumOccurrencesOfLongestCombo * comboPortionFromLongestComboInScoreV1;
 
@@ -426,13 +426,12 @@ namespace osu.Game.Database
                     // ...and then based on that raw combo length, we calculate how much this last combo is worth in standardised score.
                     double remainingComboPortionInStandardisedScore = Math.Pow(remainingCombo, 1 + ScoreProcessor.COMBO_EXPONENT);
 
-                    double lowerEstimateOfComboPortionInStandardisedScore
+                    double scoreBasedEstimateOfComboPortionInStandardisedScore
                         = maximumOccurrencesOfLongestCombo * comboPortionFromLongestComboInStandardisedScore
                           + remainingComboPortionInStandardisedScore;
 
                     // Compute approximate upper estimate new score for that play.
                     // This time, divide the remaining combo among remaining objects equally to achieve longest possible combo lengths.
-                    // There is no rigorous proof that doing this will yield a correct upper bound, but it seems to work out in practice.
                     remainingComboPortionInScoreV1 = comboPortionInScoreV1 - comboPortionFromLongestComboInScoreV1;
                     double remainingCountOfObjectsGivingCombo = maximumLegacyCombo - score.MaxCombo - score.Statistics.GetValueOrDefault(HitResult.Miss);
                     // Because we assumed all combos were equal, `remainingComboPortionInScoreV1`
@@ -449,7 +448,17 @@ namespace osu.Game.Database
                     // we can skip adding the 1 and just multiply by x ^ 0.5.
                     remainingComboPortionInStandardisedScore = remainingCountOfObjectsGivingCombo * Math.Pow(lengthOfRemainingCombos, ScoreProcessor.COMBO_EXPONENT);
 
-                    double upperEstimateOfComboPortionInStandardisedScore = comboPortionFromLongestComboInStandardisedScore + remainingComboPortionInStandardisedScore;
+                    double objectCountBasedEstimateOfComboPortionInStandardisedScore = comboPortionFromLongestComboInStandardisedScore + remainingComboPortionInStandardisedScore;
+
+                    // Enforce some invariants on both of the estimates.
+                    // In rare cases they can produce invalid results.
+                    scoreBasedEstimateOfComboPortionInStandardisedScore =
+                        Math.Clamp(scoreBasedEstimateOfComboPortionInStandardisedScore, 0, maximumAchievableComboPortionInStandardisedScore);
+                    objectCountBasedEstimateOfComboPortionInStandardisedScore =
+                        Math.Clamp(objectCountBasedEstimateOfComboPortionInStandardisedScore, 0, maximumAchievableComboPortionInStandardisedScore);
+
+                    double lowerEstimateOfComboPortionInStandardisedScore = Math.Min(scoreBasedEstimateOfComboPortionInStandardisedScore, objectCountBasedEstimateOfComboPortionInStandardisedScore);
+                    double upperEstimateOfComboPortionInStandardisedScore = Math.Max(scoreBasedEstimateOfComboPortionInStandardisedScore, objectCountBasedEstimateOfComboPortionInStandardisedScore);
 
                     // Approximate by combining lower and upper estimates.
                     // As the lower-estimate is very pessimistic, we use a 30/70 ratio

From 5b6703ec0da46259daddd777ee88be5317aba2d5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 6 Mar 2024 19:23:29 +0800
Subject: [PATCH 294/930] Move optimisation to isolated method

---
 osu.Game/Storyboards/StoryboardSprite.cs | 76 +++++++++++++-----------
 1 file changed, 42 insertions(+), 34 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 350438942e..4992ae128d 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -90,41 +90,8 @@ namespace osu.Game.Storyboards
                 // Ignore the whole setup if there are loops. In theory they can be handled here too, however the logic will be overly complex.
                 if (loops.Count == 0)
                 {
-                    // Here we are starting from maximum value and trying to minimise the end time on each step.
-                    // There are few solid guesses we can make using which sprite's end time can be minimised: alpha = 0, scale = 0, colour.a = 0.
-                    double[] deathTimes =
-                    {
-                        double.MaxValue, // alpha
-                        double.MaxValue, // colour alpha
-                        double.MaxValue, // scale
-                        double.MaxValue, // scale x
-                        double.MaxValue, // scale y
-                    };
-
-                    // The loops below are following the same pattern.
-                    // We could be using TimelineGroup.EndValue here, however it's possible to have multiple commands with 0 value in a row
-                    // so we are saving the earliest of them.
-                    foreach (var alphaCommand in TimelineGroup.Alpha.Commands)
-                    {
-                        deathTimes[0] = alphaCommand.EndValue == 0
-                            ? Math.Min(alphaCommand.EndTime, deathTimes[0]) // commands are ordered by the start time, however end time may vary. Save the earliest.
-                            : double.MaxValue; // If value isn't 0 (sprite becomes visible again), revert the saved state.
-                    }
-
-                    foreach (var colourCommand in TimelineGroup.Colour.Commands)
-                        deathTimes[1] = colourCommand.EndValue.A == 0 ? Math.Min(colourCommand.EndTime, deathTimes[1]) : double.MaxValue;
-
-                    foreach (var scaleCommand in TimelineGroup.Scale.Commands)
-                        deathTimes[2] = scaleCommand.EndValue == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[2]) : double.MaxValue;
-
-                    foreach (var scaleCommand in TimelineGroup.VectorScale.Commands)
-                    {
-                        deathTimes[3] = scaleCommand.EndValue.X == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[3]) : double.MaxValue;
-                        deathTimes[4] = scaleCommand.EndValue.Y == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[4]) : double.MaxValue;
-                    }
-
                     // Take the minimum time of all the potential "death" reasons.
-                    latestEndTime = deathTimes.Min();
+                    latestEndTime = calculateOptimisedEndTime(TimelineGroup);
                 }
 
                 // If the logic above fails to find anything or discarded by the fact that there are loops present, latestEndTime will be double.MaxValue
@@ -238,6 +205,47 @@ namespace osu.Game.Storyboards
             return commands;
         }
 
+        private static double calculateOptimisedEndTime(CommandTimelineGroup timelineGroup)
+        {
+            // Here we are starting from maximum value and trying to minimise the end time on each step.
+            // There are few solid guesses we can make using which sprite's end time can be minimised: alpha = 0, scale = 0, colour.a = 0.
+            double[] deathTimes =
+            {
+                double.MaxValue, // alpha
+                double.MaxValue, // colour alpha
+                double.MaxValue, // scale
+                double.MaxValue, // scale x
+                double.MaxValue, // scale y
+            };
+
+            // The loops below are following the same pattern.
+            // We could be using TimelineGroup.EndValue here, however it's possible to have multiple commands with 0 value in a row
+            // so we are saving the earliest of them.
+            foreach (var alphaCommand in timelineGroup.Alpha.Commands)
+            {
+                if (alphaCommand.EndValue == 0)
+                    // commands are ordered by the start time, however end time may vary. Save the earliest.
+                    deathTimes[0] = Math.Min(alphaCommand.EndTime, deathTimes[0]);
+                else
+                    // If value isn't 0 (sprite becomes visible again), revert the saved state.
+                    deathTimes[0] = double.MaxValue;
+            }
+
+            foreach (var colourCommand in timelineGroup.Colour.Commands)
+                deathTimes[1] = colourCommand.EndValue.A == 0 ? Math.Min(colourCommand.EndTime, deathTimes[1]) : double.MaxValue;
+
+            foreach (var scaleCommand in timelineGroup.Scale.Commands)
+                deathTimes[2] = scaleCommand.EndValue == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[2]) : double.MaxValue;
+
+            foreach (var scaleCommand in timelineGroup.VectorScale.Commands)
+            {
+                deathTimes[3] = scaleCommand.EndValue.X == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[3]) : double.MaxValue;
+                deathTimes[4] = scaleCommand.EndValue.Y == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[4]) : double.MaxValue;
+            }
+
+            return deathTimes.Min();
+        }
+
         public override string ToString()
             => $"{Path}, {Origin}, {InitialPosition}";
 

From 672f645cbab747d02cbb61d31283f604a3244ed8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 6 Mar 2024 18:39:18 +0300
Subject: [PATCH 295/930] Clamp only on horizontal sides

---
 osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
index 6ba91fbbd5..8f9a2d7e74 100644
--- a/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
+++ b/osu.Game.Rulesets.Mania/Skinning/Legacy/LegacyKeyArea.cs
@@ -47,19 +47,18 @@ namespace osu.Game.Rulesets.Mania.Skinning.Legacy
                 AutoSizeAxes = Axes.Y,
                 Children = new Drawable[]
                 {
+                    // Key images are placed side-to-side on the playfield, therefore ClampToEdge must be used to prevent any gaps between each key.
                     upSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
-                        // ClampToEdge is used to avoid gaps between keys, see: https://github.com/ppy/osu/issues/27431
-                        Texture = skin.GetTexture(upImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
+                        Texture = skin.GetTexture(upImage, WrapMode.ClampToEdge, default),
                         RelativeSizeAxes = Axes.X,
                         Width = 1
                     },
                     downSprite = new Sprite
                     {
                         Origin = Anchor.BottomCentre,
-                        // ClampToEdge is used to avoid gaps between keys, see: https://github.com/ppy/osu/issues/27431
-                        Texture = skin.GetTexture(downImage, WrapMode.ClampToEdge, WrapMode.ClampToEdge),
+                        Texture = skin.GetTexture(downImage, WrapMode.ClampToEdge, default),
                         RelativeSizeAxes = Axes.X,
                         Width = 1,
                         Alpha = 0

From 3121cf81e6f8ad0dd8ecb80b5dfc2cff4f55c306 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 6 Mar 2024 21:30:09 +0100
Subject: [PATCH 296/930] Bump score version

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 775d87f3f2..4ee4231925 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -45,9 +45,10 @@ namespace osu.Game.Scoring.Legacy
         /// </description></item>
         /// <item><description>30000013: All local scores will use lazer definitions of ranks for consistency. Recalculates the rank of all scores.</description></item>
         /// <item><description>30000014: Fix edge cases in conversion for osu! scores on selected beatmaps. Reconvert all scores.</description></item>
+        /// <item><description>30000015: Fix osu! standardised score estimation algorithm violating basic invariants. Reconvert all scores.</description></item>
         /// </list>
         /// </remarks>
-        public const int LATEST_VERSION = 30000014;
+        public const int LATEST_VERSION = 30000015;
 
         /// <summary>
         /// The first stable-compatible YYYYMMDD format version given to lazer usage of replays.

From aa3cd402ca9ed3d666aac0e9934f9290af01b828 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 6 Mar 2024 21:30:31 +0100
Subject: [PATCH 297/930] Fix broken english

---
 osu.Game/Database/StandardisedScoreMigrationTools.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Database/StandardisedScoreMigrationTools.cs b/osu.Game/Database/StandardisedScoreMigrationTools.cs
index 53ff1a25ca..6f2f8d64fa 100644
--- a/osu.Game/Database/StandardisedScoreMigrationTools.cs
+++ b/osu.Game/Database/StandardisedScoreMigrationTools.cs
@@ -415,7 +415,7 @@ namespace osu.Game.Database
 
                     // Calculate how many times the longest combo the user has achieved in the play can repeat
                     // without exceeding the combo portion in score V1 as achieved by the player.
-                    // This it intentionally does not operate on object count and uses only score instead.
+                    // This intentionally does not operate on object count and uses only score instead.
                     double maximumOccurrencesOfLongestCombo = Math.Floor(comboPortionInScoreV1 / comboPortionFromLongestComboInScoreV1);
                     double comboPortionFromRepeatedLongestCombosInScoreV1 = maximumOccurrencesOfLongestCombo * comboPortionFromLongestComboInScoreV1;
 

From 336a6180e537ba1c205c488cead7c5494446b705 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Mar 2024 08:20:20 +0300
Subject: [PATCH 298/930] Expose `TRANSITION_LENGTH` from tab control

---
 osu.Game/Graphics/UserInterface/OsuTabControl.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index c260c92b43..f24977927f 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -116,18 +116,18 @@ namespace osu.Game.Graphics.UserInterface
                 }
             }
 
-            private const float transition_length = 500;
+            protected const float TRANSITION_LENGTH = 500;
 
-            protected void FadeHovered()
+            protected virtual void FadeHovered()
             {
-                Bar.FadeIn(transition_length, Easing.OutQuint);
-                Text.FadeColour(Color4.White, transition_length, Easing.OutQuint);
+                Bar.FadeIn(TRANSITION_LENGTH, Easing.OutQuint);
+                Text.FadeColour(Color4.White, TRANSITION_LENGTH, Easing.OutQuint);
             }
 
-            protected void FadeUnhovered()
+            protected virtual void FadeUnhovered()
             {
-                Bar.FadeTo(IsHovered ? 1 : 0, transition_length, Easing.OutQuint);
-                Text.FadeColour(IsHovered ? Color4.White : AccentColour, transition_length, Easing.OutQuint);
+                Bar.FadeTo(IsHovered ? 1 : 0, TRANSITION_LENGTH, Easing.OutQuint);
+                Text.FadeColour(IsHovered ? Color4.White : AccentColour, TRANSITION_LENGTH, Easing.OutQuint);
             }
 
             protected override bool OnHover(HoverEvent e)

From 0fe139a1892423030b1de36df957bff095fc6587 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 7 Mar 2024 08:20:46 +0300
Subject: [PATCH 299/930] Adjust editor screen switcher control design and
 behaviour

---
 .../Menus/EditorScreenSwitcherControl.cs      | 40 ++++++++++++++-----
 1 file changed, 31 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
index 1f6d61d0ad..2b0b1ea219 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorScreenSwitcherControl.cs
@@ -9,6 +9,7 @@ using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Edit.Components.Menus
 {
@@ -21,7 +22,7 @@ namespace osu.Game.Screens.Edit.Components.Menus
 
             TabContainer.RelativeSizeAxes &= ~Axes.X;
             TabContainer.AutoSizeAxes = Axes.X;
-            TabContainer.Padding = new MarginPadding(10);
+            TabContainer.Spacing = Vector2.Zero;
         }
 
         [BackgroundDependencyLoader]
@@ -42,30 +43,51 @@ namespace osu.Game.Screens.Edit.Components.Menus
 
         private partial class TabItem : OsuTabItem
         {
-            private const float transition_length = 250;
+            private readonly Box background;
+            private Color4 backgroundIdleColour;
+            private Color4 backgroundHoverColour;
 
             public TabItem(EditorScreenMode value)
                 : base(value)
             {
-                Text.Margin = new MarginPadding();
+                Text.Margin = new MarginPadding(10);
                 Text.Anchor = Anchor.CentreLeft;
                 Text.Origin = Anchor.CentreLeft;
 
                 Text.Font = OsuFont.TorusAlternate;
 
+                Add(background = new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Depth = float.MaxValue,
+                });
+
                 Bar.Expire();
             }
 
-            protected override void OnActivated()
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
             {
-                base.OnActivated();
-                Bar.ScaleTo(new Vector2(1, 5), transition_length, Easing.OutQuint);
+                backgroundIdleColour = colourProvider.Background2;
+                backgroundHoverColour = colourProvider.Background1;
             }
 
-            protected override void OnDeactivated()
+            protected override void LoadComplete()
             {
-                base.OnDeactivated();
-                Bar.ScaleTo(Vector2.One, transition_length, Easing.OutQuint);
+                base.LoadComplete();
+                background.Colour = backgroundIdleColour;
+            }
+
+            protected override void FadeHovered()
+            {
+                base.FadeHovered();
+                background.FadeColour(backgroundHoverColour, TRANSITION_LENGTH, Easing.OutQuint);
+            }
+
+            protected override void FadeUnhovered()
+            {
+                base.FadeUnhovered();
+                background.FadeColour(backgroundIdleColour, TRANSITION_LENGTH, Easing.OutQuint);
             }
         }
     }

From 56caf1935043112ec13c5d0b1d43e9d23b8d1f7e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 6 Mar 2024 22:48:54 -0800
Subject: [PATCH 300/930] Add visual test for failed S display

---
 .../TestSceneExpandedPanelMiddleContent.cs    | 21 +++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index d71c72f4ec..ceb2d4927c 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -88,8 +88,21 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("play time not displayed", () => !this.ChildrenOfType<ExpandedPanelMiddleContent.PlayedOnText>().Any());
         }
 
-        private void showPanel(ScoreInfo score) =>
-            Child = new ExpandedPanelMiddleContentContainer(score);
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestFailedSDisplay(bool withFlair)
+        {
+            AddStep("show failed S score", () =>
+            {
+                var score = TestResources.CreateTestScoreInfo(createTestBeatmap(new RealmUser()));
+                score.Rank = ScoreRank.A;
+                score.Accuracy = 0.975;
+                showPanel(score, withFlair);
+            });
+        }
+
+        private void showPanel(ScoreInfo score, bool withFlair = false) =>
+            Child = new ExpandedPanelMiddleContentContainer(score, withFlair);
 
         private BeatmapInfo createTestBeatmap([NotNull] RealmUser author)
         {
@@ -107,7 +120,7 @@ namespace osu.Game.Tests.Visual.Ranking
 
         private partial class ExpandedPanelMiddleContentContainer : Container
         {
-            public ExpandedPanelMiddleContentContainer(ScoreInfo score)
+            public ExpandedPanelMiddleContentContainer(ScoreInfo score, bool withFlair)
             {
                 Anchor = Anchor.Centre;
                 Origin = Anchor.Centre;
@@ -119,7 +132,7 @@ namespace osu.Game.Tests.Visual.Ranking
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4Extensions.FromHex("#444"),
                     },
-                    new ExpandedPanelMiddleContent(score)
+                    new ExpandedPanelMiddleContent(score, withFlair)
                 };
             }
         }

From c36232bc02ff9289b0ecc16a6235049f3ddaa63a Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 6 Mar 2024 20:08:46 -0800
Subject: [PATCH 301/930] Fix results screen accuracy circle not showing
 correctly for failed S with no flair

---
 .../Expanded/Accuracy/AccuracyCircle.cs       | 35 ++++++++++---------
 1 file changed, 18 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index 54829a6274..f04e4a6444 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -194,11 +194,11 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                 rankText = new RankText(score.Rank)
             };
 
+            if (isFailedSDueToMisses)
+                AddInternal(failedSRankText = new RankText(ScoreRank.S));
+
             if (withFlair)
             {
-                if (isFailedSDueToMisses)
-                    AddInternal(failedSRankText = new RankText(ScoreRank.S));
-
                 var applauseSamples = new List<string> { applauseSampleName };
                 if (score.Rank >= ScoreRank.B)
                     // when rank is B or higher, play legacy applause sample on legacy skins.
@@ -326,24 +326,25 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                 {
                     rankText.Appear();
 
-                    if (!withFlair) return;
-
-                    Schedule(() =>
-                    {
-                        isTicking = false;
-                        rankImpactSound.Play();
-                    });
-
-                    const double applause_pre_delay = 545f;
-                    const double applause_volume = 0.8f;
-
-                    using (BeginDelayedSequence(applause_pre_delay))
+                    if (withFlair)
                     {
                         Schedule(() =>
                         {
-                            rankApplauseSound.VolumeTo(applause_volume);
-                            rankApplauseSound.Play();
+                            isTicking = false;
+                            rankImpactSound.Play();
                         });
+
+                        const double applause_pre_delay = 545f;
+                        const double applause_volume = 0.8f;
+
+                        using (BeginDelayedSequence(applause_pre_delay))
+                        {
+                            Schedule(() =>
+                            {
+                                rankApplauseSound.VolumeTo(applause_volume);
+                                rankApplauseSound.Play();
+                            });
+                        }
                     }
                 }
 

From 1cafb0997713ee387f8994e972d64ad908aa4181 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 7 Mar 2024 17:22:38 +0900
Subject: [PATCH 302/930] Increase border thickness

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 08d00f8ac2..ba49810b2b 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -51,7 +51,7 @@ namespace osu.Game.Screens.Play
                 AutoSizeAxes = Axes.Both,
                 Masking = true,
                 BorderColour = colours.Yellow,
-                BorderThickness = 1,
+                BorderThickness = 2,
                 Children = new Drawable[]
                 {
                     new Box

From 039520d55dc9b9cc55e143a6da8bb87f684ef882 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 7 Mar 2024 09:49:20 +0100
Subject: [PATCH 303/930] Use slightly nicer parameterisation in test

---
 .../Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs    | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index ceb2d4927c..d97946a1d5 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -88,9 +88,8 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("play time not displayed", () => !this.ChildrenOfType<ExpandedPanelMiddleContent.PlayedOnText>().Any());
         }
 
-        [TestCase(false)]
-        [TestCase(true)]
-        public void TestFailedSDisplay(bool withFlair)
+        [Test]
+        public void TestFailedSDisplay([Values] bool withFlair)
         {
             AddStep("show failed S score", () =>
             {

From ca92a31cf97bcb28fd8d9e67fe0ac83b1085ac80 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 7 Mar 2024 21:10:11 +0900
Subject: [PATCH 304/930] Fix missing event unbinds

---
 osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs           | 9 +++++++++
 .../Components/Timeline/TimelineHitObjectBlueprint.cs    | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs b/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs
index 5ddc627642..3365b206cf 100644
--- a/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs
+++ b/osu.Game.Rulesets.Mania/Mods/ManiaModHidden.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Localisation;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Game.Rulesets.Mania.Skinning;
 using osu.Game.Rulesets.Mods;
@@ -101,6 +102,14 @@ namespace osu.Game.Rulesets.Mania.Mods
 
                 return base.GetHeight(coverage) * reference_playfield_height / availablePlayfieldHeight;
             }
+
+            protected override void Dispose(bool isDisposing)
+            {
+                base.Dispose(isDisposing);
+
+                if (skin.IsNotNull())
+                    skin.SourceChanged -= onSkinChanged;
+            }
         }
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index 47dc3fb82e..d4afcc0151 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -6,6 +6,7 @@ using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
@@ -265,6 +266,14 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             return !Precision.AlmostIntersects(maskingBounds, rect);
         }
 
+        protected override void Dispose(bool isDisposing)
+        {
+            base.Dispose(isDisposing);
+
+            if (skin.IsNotNull())
+                skin.SourceChanged -= updateColour;
+        }
+
         private partial class Tick : Circle
         {
             public Tick()

From 585ab5976877281be70cb6f52721382c5a86a861 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 6 Mar 2024 19:39:28 +0300
Subject: [PATCH 305/930] Apply major refactor to the storyboard commands flow
 structrure

---
 .../TestSceneDrawableStoryboardSprite.cs      |   3 +-
 .../Visual/Gameplay/TestSceneLeadIn.cs        |  16 +-
 .../Gameplay/TestSceneStoryboardWithOutro.cs  |   2 +-
 .../TestSceneMultiSpectatorScreen.cs          |   2 +-
 .../Formats/LegacyStoryboardDecoder.cs        |  39 +--
 osu.Game/Storyboards/CommandLoop.cs           |  63 -----
 osu.Game/Storyboards/CommandTimeline.cs       | 101 --------
 osu.Game/Storyboards/CommandTimelineGroup.cs  | 120 ---------
 .../Commands/IStoryboardCommand.cs            |  28 +++
 .../Commands/StoryboardAlphaCommand.cs        |  19 ++
 .../StoryboardBlendingParametersCommand.cs    |  21 ++
 .../Commands/StoryboardColourCommand.cs       |  20 ++
 .../Storyboards/Commands/StoryboardCommand.cs |  54 ++++
 .../Commands/StoryboardCommandGroup.cs        | 115 +++++++++
 .../Commands/StoryboardCommandList.cs         |  41 +++
 .../Commands/StoryboardFlipHCommand.cs        |  23 ++
 .../Commands/StoryboardFlipVCommand.cs        |  23 ++
 .../Commands/StoryboardLoopingGroup.cs        |  71 ++++++
 .../Commands/StoryboardRotationCommand.cs     |  21 ++
 .../Commands/StoryboardScaleCommand.cs        |  22 ++
 .../StoryboardTriggerGroup.cs}                |   7 +-
 .../Commands/StoryboardVectorScaleCommand.cs  |  24 ++
 .../Commands/StoryboardXCommand.cs            |  21 ++
 .../Commands/StoryboardYCommand.cs            |  21 ++
 .../Drawables/IDrawableStoryboardElement.cs   |   4 +-
 osu.Game/Storyboards/StoryboardAnimation.cs   |   4 +-
 .../StoryboardElementWithDuration.cs          | 236 ------------------
 osu.Game/Storyboards/StoryboardSprite.cs      | 153 +++++++++++-
 28 files changed, 713 insertions(+), 561 deletions(-)
 delete mode 100644 osu.Game/Storyboards/CommandLoop.cs
 delete mode 100644 osu.Game/Storyboards/CommandTimeline.cs
 delete mode 100644 osu.Game/Storyboards/CommandTimelineGroup.cs
 create mode 100644 osu.Game/Storyboards/Commands/IStoryboardCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardCommandList.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
 rename osu.Game/Storyboards/{CommandTrigger.cs => Commands/StoryboardTriggerGroup.cs} (68%)
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardXCommand.cs
 create mode 100644 osu.Game/Storyboards/Commands/StoryboardYCommand.cs
 delete mode 100644 osu.Game/Storyboards/StoryboardElementWithDuration.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 32693c2bb2..6209b42cbb 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -175,7 +175,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             var layer = storyboard.GetLayer("Background");
 
             var sprite = new StoryboardSprite(lookupName, origin, initialPosition);
-            sprite.AddLoop(Time.Current, 100).Alpha.Add(Easing.None, 0, 10000, 1, 1);
+            var loop = sprite.AddLoopingGroup(Time.Current, 100);
+            loop.AddAlpha(0, 10000, 1, 1, Easing.None);
 
             layer.Elements.Clear();
             layer.Add(sprite);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index dae3119ea4..c3eef4da9b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
-            sprite.TimelineGroup.Alpha.Add(Easing.None, firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1);
+            sprite.Group.AddAlpha(firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1, Easing.None);
 
             storyboard.GetLayer("Background").Add(sprite);
 
@@ -73,17 +73,17 @@ namespace osu.Game.Tests.Visual.Gameplay
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
             // these should be ignored as we have an alpha visibility blocker proceeding this command.
-            sprite.TimelineGroup.Scale.Add(Easing.None, loop_start_time, -18000, Vector2.Zero, Vector2.One);
-            var loopGroup = sprite.AddLoop(loop_start_time, 50);
-            loopGroup.Scale.Add(Easing.None, loop_start_time, -18000, Vector2.Zero, Vector2.One);
+            sprite.Group.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
+            var loopGroup = sprite.AddLoopingGroup(loop_start_time, 50);
+            loopGroup.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
 
-            var target = addEventToLoop ? loopGroup : sprite.TimelineGroup;
+            var target = addEventToLoop ? loopGroup : sprite.Group;
             double loopRelativeOffset = addEventToLoop ? -loop_start_time : 0;
-            target.Alpha.Add(Easing.None, loopRelativeOffset + firstStoryboardEvent, loopRelativeOffset + firstStoryboardEvent + 500, 0, 1);
+            target.AddAlpha(loopRelativeOffset + firstStoryboardEvent, loopRelativeOffset + firstStoryboardEvent + 500, 0, 1, Easing.None);
 
             // these should be ignored due to being in the future.
-            sprite.TimelineGroup.Alpha.Add(Easing.None, 18000, 20000, 0, 1);
-            loopGroup.Alpha.Add(Easing.None, 38000, 40000, 0, 1);
+            sprite.Group.AddAlpha(18000, 20000, 0, 1, Easing.None);
+            loopGroup.AddAlpha(38000, 40000, 0, 1, Easing.None);
 
             storyboard.GetLayer("Background").Add(sprite);
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index f532921d63..9269c3f4ae 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             var storyboard = new Storyboard();
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.TimelineGroup.Alpha.Add(Easing.None, 0, duration, 1, 0);
+            sprite.Group.AddAlpha(0, duration, 1, 0, Easing.None);
             storyboard.GetLayer("Background").Add(sprite);
             return storyboard;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index cebc75f90c..62a2bfeaab 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestIntroStoryboardElement() => testLeadIn(b =>
         {
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.TimelineGroup.Alpha.Add(Easing.None, -2000, 0, 0, 1);
+            sprite.Group.AddAlpha(-2000, 0, 0, 1, Easing.None);
             b.Storyboard.GetLayer("Background").Add(sprite);
         });
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index ba328b2dbd..33cdaa085e 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -10,6 +10,7 @@ using osu.Framework.Utils;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO;
 using osu.Game.Storyboards;
+using osu.Game.Storyboards.Commands;
 using osuTK;
 using osuTK.Graphics;
 
@@ -17,8 +18,8 @@ namespace osu.Game.Beatmaps.Formats
 {
     public class LegacyStoryboardDecoder : LegacyDecoder<Storyboard>
     {
-        private StoryboardElementWithDuration? storyboardSprite;
-        private CommandTimelineGroup? timelineGroup;
+        private StoryboardSprite? storyboardSprite;
+        private StoryboardCommandGroup? currentGroup;
 
         private Storyboard storyboard = null!;
 
@@ -165,7 +166,7 @@ namespace osu.Game.Beatmaps.Formats
             else
             {
                 if (depth < 2)
-                    timelineGroup = storyboardSprite?.TimelineGroup;
+                    currentGroup = storyboardSprite?.Group;
 
                 string commandType = split[0];
 
@@ -177,7 +178,7 @@ namespace osu.Game.Beatmaps.Formats
                         double startTime = split.Length > 2 ? Parsing.ParseDouble(split[2]) : double.MinValue;
                         double endTime = split.Length > 3 ? Parsing.ParseDouble(split[3]) : double.MaxValue;
                         int groupNumber = split.Length > 4 ? Parsing.ParseInt(split[4]) : 0;
-                        timelineGroup = storyboardSprite?.AddTrigger(triggerName, startTime, endTime, groupNumber);
+                        currentGroup = storyboardSprite?.AddTriggerGroup(triggerName, startTime, endTime, groupNumber);
                         break;
                     }
 
@@ -185,7 +186,7 @@ namespace osu.Game.Beatmaps.Formats
                     {
                         double startTime = Parsing.ParseDouble(split[1]);
                         int repeatCount = Parsing.ParseInt(split[2]);
-                        timelineGroup = storyboardSprite?.AddLoop(startTime, Math.Max(0, repeatCount - 1));
+                        currentGroup = storyboardSprite?.AddLoopingGroup(startTime, Math.Max(0, repeatCount - 1));
                         break;
                     }
 
@@ -204,7 +205,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Alpha.Add(easing, startTime, endTime, startValue, endValue);
+                                currentGroup?.AddAlpha(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -212,7 +213,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Scale.Add(easing, startTime, endTime, new Vector2(startValue), new Vector2(endValue));
+                                currentGroup?.AddScale(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -222,7 +223,7 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                timelineGroup?.VectorScale.Add(easing, startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY));
+                                currentGroup?.AddVectorScale(startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY), easing);
                                 break;
                             }
 
@@ -230,7 +231,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Rotation.Add(easing, startTime, endTime, MathUtils.RadiansToDegrees(startValue), MathUtils.RadiansToDegrees(endValue));
+                                currentGroup?.AddRotation(startTime, endTime, MathUtils.RadiansToDegrees(startValue), MathUtils.RadiansToDegrees(endValue), easing);
                                 break;
                             }
 
@@ -240,8 +241,8 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                timelineGroup?.X.Add(easing, startTime, endTime, startX, endX);
-                                timelineGroup?.Y.Add(easing, startTime, endTime, startY, endY);
+                                currentGroup?.AddX(startTime, endTime, startX, endX, easing);
+                                currentGroup?.AddY(startTime, endTime, startY, endY, easing);
                                 break;
                             }
 
@@ -249,7 +250,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.X.Add(easing, startTime, endTime, startValue, endValue);
+                                currentGroup?.AddX(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -257,7 +258,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                timelineGroup?.Y.Add(easing, startTime, endTime, startValue, endValue);
+                                currentGroup?.AddY(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -269,9 +270,9 @@ namespace osu.Game.Beatmaps.Formats
                                 float endRed = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startRed;
                                 float endGreen = split.Length > 8 ? Parsing.ParseFloat(split[8]) : startGreen;
                                 float endBlue = split.Length > 9 ? Parsing.ParseFloat(split[9]) : startBlue;
-                                timelineGroup?.Colour.Add(easing, startTime, endTime,
+                                currentGroup?.AddColour(startTime, endTime,
                                     new Color4(startRed / 255f, startGreen / 255f, startBlue / 255f, 1),
-                                    new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1));
+                                    new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1), easing);
                                 break;
                             }
 
@@ -282,16 +283,16 @@ namespace osu.Game.Beatmaps.Formats
                                 switch (type)
                                 {
                                     case "A":
-                                        timelineGroup?.BlendingParameters.Add(easing, startTime, endTime, BlendingParameters.Additive,
-                                            startTime == endTime ? BlendingParameters.Additive : BlendingParameters.Inherit);
+                                        currentGroup?.AddBlendingParameters(startTime, endTime, BlendingParameters.Additive,
+                                            startTime == endTime ? BlendingParameters.Additive : BlendingParameters.Inherit, easing);
                                         break;
 
                                     case "H":
-                                        timelineGroup?.FlipH.Add(easing, startTime, endTime, true, startTime == endTime);
+                                        currentGroup?.AddFlipH(startTime, endTime, true, startTime == endTime, easing);
                                         break;
 
                                     case "V":
-                                        timelineGroup?.FlipV.Add(easing, startTime, endTime, true, startTime == endTime);
+                                        currentGroup?.AddFlipV(startTime, endTime, true, startTime == endTime, easing);
                                         break;
                                 }
 
diff --git a/osu.Game/Storyboards/CommandLoop.cs b/osu.Game/Storyboards/CommandLoop.cs
deleted file mode 100644
index 6dd782cb7f..0000000000
--- a/osu.Game/Storyboards/CommandLoop.cs
+++ /dev/null
@@ -1,63 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-using System.Collections.Generic;
-
-namespace osu.Game.Storyboards
-{
-    public class CommandLoop : CommandTimelineGroup
-    {
-        public double LoopStartTime;
-
-        /// <summary>
-        /// The total number of times this loop is played back. Always greater than zero.
-        /// </summary>
-        public readonly int TotalIterations;
-
-        public override double StartTime => LoopStartTime + CommandsStartTime;
-
-        public override double EndTime =>
-            // In an ideal world, we would multiply the command duration by TotalIterations here.
-            // Unfortunately this would clash with how stable handled end times, and results in some storyboards playing outro
-            // sequences for minutes or hours.
-            StartTime + CommandsDuration;
-
-        /// <summary>
-        /// Construct a new command loop.
-        /// </summary>
-        /// <param name="startTime">The start time of the loop.</param>
-        /// <param name="repeatCount">The number of times the loop should repeat. Should be greater than zero. Zero means a single playback.</param>
-        public CommandLoop(double startTime, int repeatCount)
-        {
-            if (repeatCount < 0) throw new ArgumentException("Repeat count must be zero or above.", nameof(repeatCount));
-
-            LoopStartTime = startTime;
-            TotalIterations = repeatCount + 1;
-        }
-
-        public override IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
-        {
-            double fullLoopDuration = CommandsEndTime - CommandsStartTime;
-
-            foreach (var command in timelineSelector(this).Commands)
-            {
-                yield return new CommandTimeline<T>.TypedCommand
-                {
-                    Easing = command.Easing,
-                    StartTime = offset + LoopStartTime + command.StartTime,
-                    EndTime = offset + LoopStartTime + command.EndTime,
-                    StartValue = command.StartValue,
-                    EndValue = command.EndValue,
-                    PropertyName = command.PropertyName,
-                    IsParameterCommand = command.IsParameterCommand,
-                    LoopCount = TotalIterations,
-                    Delay = fullLoopDuration - command.EndTime + command.StartTime
-                };
-            }
-        }
-
-        public override string ToString()
-            => $"{LoopStartTime} x{TotalIterations}";
-    }
-}
diff --git a/osu.Game/Storyboards/CommandTimeline.cs b/osu.Game/Storyboards/CommandTimeline.cs
deleted file mode 100644
index 4ad31d88c2..0000000000
--- a/osu.Game/Storyboards/CommandTimeline.cs
+++ /dev/null
@@ -1,101 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-#nullable disable
-
-using osu.Framework.Graphics;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-
-namespace osu.Game.Storyboards
-{
-    public class CommandTimeline<T> : ICommandTimeline
-    {
-        private readonly List<TypedCommand> commands = new List<TypedCommand>();
-
-        public IEnumerable<TypedCommand> Commands => commands.OrderBy(c => c.StartTime);
-
-        public bool HasCommands => commands.Count > 0;
-
-        public double StartTime { get; private set; } = double.MaxValue;
-        public double EndTime { get; private set; } = double.MinValue;
-
-        public T StartValue { get; private set; }
-        public T EndValue { get; private set; }
-
-        public string PropertyName { get; }
-        public bool IsParameterTimeline { get; set; }
-
-        public CommandTimeline(string propertyName)
-        {
-            PropertyName = propertyName;
-        }
-
-        public void Add(Easing easing, double startTime, double endTime, T startValue, T endValue)
-        {
-            if (endTime < startTime)
-            {
-                endTime = startTime;
-            }
-
-            commands.Add(new TypedCommand { Easing = easing, StartTime = startTime, EndTime = endTime, StartValue = startValue, EndValue = endValue, PropertyName = PropertyName, IsParameterCommand = IsParameterTimeline });
-
-            if (startTime < StartTime)
-            {
-                StartValue = startValue;
-                StartTime = startTime;
-            }
-
-            if (endTime > EndTime)
-            {
-                EndValue = endValue;
-                EndTime = endTime;
-            }
-        }
-
-        public override string ToString()
-            => $"{commands.Count} command(s)";
-
-        public class TypedCommand : ICommand
-        {
-            public Easing Easing { get; set; }
-            public double StartTime { get; set; }
-            public double EndTime { get; set; }
-            public double Duration => EndTime - StartTime;
-            public string PropertyName { get; set; }
-            public int LoopCount { get; set; }
-            public double Delay { get; set; }
-            public bool IsParameterCommand { get; set; }
-
-            public T StartValue;
-            public T EndValue;
-
-            public int CompareTo(ICommand other)
-            {
-                int result = StartTime.CompareTo(other.StartTime);
-                if (result != 0) return result;
-
-                return EndTime.CompareTo(other.EndTime);
-            }
-
-            public override string ToString()
-                => $"{StartTime} -> {EndTime}, {StartValue} -> {EndValue} {Easing}";
-        }
-    }
-
-    public interface ICommandTimeline
-    {
-        double StartTime { get; }
-        double EndTime { get; }
-        bool HasCommands { get; }
-    }
-
-    public interface ICommand : IComparable<ICommand>
-    {
-        Easing Easing { get; set; }
-        double StartTime { get; set; }
-        double EndTime { get; set; }
-        double Duration { get; }
-    }
-}
diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
deleted file mode 100644
index 0362925619..0000000000
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ /dev/null
@@ -1,120 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-using osuTK;
-using osu.Framework.Graphics;
-using System.Collections.Generic;
-using System.Linq;
-using Newtonsoft.Json;
-using osu.Framework.Graphics.Colour;
-
-namespace osu.Game.Storyboards
-{
-    public delegate CommandTimeline<T> CommandTimelineSelector<T>(CommandTimelineGroup commandTimelineGroup);
-
-    public class CommandTimelineGroup
-    {
-        public CommandTimeline<float> X = new CommandTimeline<float>("X");
-        public CommandTimeline<float> Y = new CommandTimeline<float>("Y");
-        public CommandTimeline<Vector2> Scale = new CommandTimeline<Vector2>("Scale");
-        public CommandTimeline<Vector2> VectorScale = new CommandTimeline<Vector2>("VectorScale");
-        public CommandTimeline<float> Rotation = new CommandTimeline<float>("Rotation");
-        public CommandTimeline<ColourInfo> Colour = new CommandTimeline<ColourInfo>("Colour");
-        public CommandTimeline<float> Alpha = new CommandTimeline<float>("Alpha");
-        public CommandTimeline<BlendingParameters> BlendingParameters = new CommandTimeline<BlendingParameters>("Blending") { IsParameterTimeline = true };
-        public CommandTimeline<bool> FlipH = new CommandTimeline<bool>("FlipH") { IsParameterTimeline = true };
-        public CommandTimeline<bool> FlipV = new CommandTimeline<bool>("FlipV") { IsParameterTimeline = true };
-
-        private readonly ICommandTimeline[] timelines;
-
-        public CommandTimelineGroup()
-        {
-            timelines = new ICommandTimeline[]
-            {
-                X,
-                Y,
-                Scale,
-                VectorScale,
-                Rotation,
-                Colour,
-                Alpha,
-                BlendingParameters,
-                FlipH,
-                FlipV
-            };
-        }
-
-        [JsonIgnore]
-        public double CommandsStartTime
-        {
-            get
-            {
-                double min = double.MaxValue;
-
-                for (int i = 0; i < timelines.Length; i++)
-                    min = Math.Min(min, timelines[i].StartTime);
-
-                return min;
-            }
-        }
-
-        [JsonIgnore]
-        public double CommandsEndTime
-        {
-            get
-            {
-                double max = double.MinValue;
-
-                for (int i = 0; i < timelines.Length; i++)
-                    max = Math.Max(max, timelines[i].EndTime);
-
-                return max;
-            }
-        }
-
-        [JsonIgnore]
-        public double CommandsDuration => CommandsEndTime - CommandsStartTime;
-
-        [JsonIgnore]
-        public virtual double StartTime => CommandsStartTime;
-
-        [JsonIgnore]
-        public virtual double EndTime => CommandsEndTime;
-
-        [JsonIgnore]
-        public bool HasCommands
-        {
-            get
-            {
-                for (int i = 0; i < timelines.Length; i++)
-                {
-                    if (timelines[i].HasCommands)
-                        return true;
-                }
-
-                return false;
-            }
-        }
-
-        public virtual IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
-        {
-            if (offset != 0)
-            {
-                return timelineSelector(this).Commands.Select(command =>
-                    new CommandTimeline<T>.TypedCommand
-                    {
-                        Easing = command.Easing,
-                        StartTime = offset + command.StartTime,
-                        EndTime = offset + command.EndTime,
-                        StartValue = command.StartValue,
-                        EndValue = command.EndValue,
-                        PropertyName = command.PropertyName,
-                        IsParameterCommand = command.IsParameterCommand
-                    });
-            }
-
-            return timelineSelector(this).Commands;
-        }
-    }
-}
diff --git a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
new file mode 100644
index 0000000000..848dcab575
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
@@ -0,0 +1,28 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public interface IStoryboardCommand
+    {
+        /// <summary>
+        /// The start time of the storyboard command.
+        /// </summary>
+        double StartTime { get; }
+
+        /// <summary>
+        /// The end time of the storyboard command.
+        /// </summary>
+        double EndTime { get; }
+
+        /// <summary>
+        /// Applies the transforms described by this storyboard command to the target drawable.
+        /// </summary>
+        /// <param name="d">The target drawable.</param>
+        /// <returns>The sequence of transforms applied to the target drawable.</returns>
+        TransformSequence<Drawable> ApplyTransform(Drawable d);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
new file mode 100644
index 0000000000..729ecd72a7
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
@@ -0,0 +1,19 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardAlphaCommand : StoryboardCommand<float>
+    {
+        public StoryboardAlphaCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Alpha = StartValue;
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d) => d.FadeTo(StartValue).Then().FadeTo(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
new file mode 100644
index 0000000000..cc54909837
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardBlendingParametersCommand : StoryboardCommand<BlendingParameters>
+    {
+        public StoryboardBlendingParametersCommand(double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Blending = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.TransformTo(nameof(d.Blending), StartValue).Delay(Duration).TransformTo(nameof(d.Blending), EndValue);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
new file mode 100644
index 0000000000..be56a1d71b
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
@@ -0,0 +1,20 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+using osuTK.Graphics;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardColourCommand : StoryboardCommand<Color4>
+    {
+        public StoryboardColourCommand(double startTime, double endTime, Color4 startValue, Color4 endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Colour = StartValue;
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d) => d.FadeColour(StartValue).Then().FadeColour(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommand.cs b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
new file mode 100644
index 0000000000..883b9f57c1
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
@@ -0,0 +1,54 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public abstract class StoryboardCommand<T> : IStoryboardCommand
+    {
+        public double StartTime { get; }
+        public double EndTime { get; }
+        public double Duration => EndTime - StartTime;
+
+        protected StoryboardCommand(double startTime, double endTime, T startValue, T endValue, Easing easing)
+        {
+            if (endTime < startTime)
+                endTime = startTime;
+
+            StartTime = startTime;
+            StartValue = startValue;
+            EndTime = endTime;
+            EndValue = endValue;
+            Easing = easing;
+        }
+
+        public Easing Easing { get; set; }
+        public int LoopCount { get; set; }
+        public double Delay { get; set; }
+
+        public T StartValue;
+        public T EndValue;
+
+        /// <summary>
+        /// Sets the value of the corresponding property in <see cref="Drawable"/> to the start value of this command.
+        /// </summary>
+        public abstract void SetInitialValue(Drawable d);
+
+        /// <summary>
+        /// Transforms a corresponding property in <see cref="Drawable"/> that corresponds to this command group with the specified parameters.
+        /// </summary>
+        public abstract TransformSequence<Drawable> ApplyTransform(Drawable d);
+
+        public int CompareTo(IStoryboardCommand other)
+        {
+            int result = StartTime.CompareTo(other.StartTime);
+            if (result != 0) return result;
+
+            return EndTime.CompareTo(other.EndTime);
+        }
+
+        public override string ToString() => $"{StartTime} -> {EndTime}, {StartValue} -> {EndValue} {Easing}";
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
new file mode 100644
index 0000000000..02c43c9f60
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -0,0 +1,115 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.Linq;
+using Newtonsoft.Json;
+using osu.Framework.Graphics;
+using osu.Framework.Lists;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardCommandGroup
+    {
+        public SortedList<StoryboardCommand<float>> X;
+        public SortedList<StoryboardCommand<float>> Y;
+        public SortedList<StoryboardCommand<float>> Scale;
+        public SortedList<StoryboardCommand<Vector2>> VectorScale;
+        public SortedList<StoryboardCommand<float>> Rotation;
+        public SortedList<StoryboardCommand<Color4>> Colour;
+        public SortedList<StoryboardCommand<float>> Alpha;
+        public SortedList<StoryboardCommand<BlendingParameters>> BlendingParameters;
+        public SortedList<StoryboardCommand<bool>> FlipH;
+        public SortedList<StoryboardCommand<bool>> FlipV;
+
+        private readonly IReadOnlyList<IStoryboardCommand>[] lists;
+
+        /// <summary>
+        /// Returns the earliest start time of the commands added to this group.
+        /// </summary>
+        [JsonIgnore]
+        public double StartTime { get; private set; }
+
+        /// <summary>
+        /// Returns the latest end time of the commands added to this group.
+        /// </summary>
+        [JsonIgnore]
+        public double EndTime { get; private set; }
+
+        [JsonIgnore]
+        public double Duration => EndTime - StartTime;
+
+        [JsonIgnore]
+        public bool HasCommands { get; private set; }
+
+        public StoryboardCommandGroup()
+        {
+            lists = new IReadOnlyList<IStoryboardCommand>[]
+            {
+                X = new SortedList<StoryboardCommand<float>>(),
+                Y = new SortedList<StoryboardCommand<float>>(),
+                Scale = new SortedList<StoryboardCommand<float>>(),
+                VectorScale = new SortedList<StoryboardCommand<Vector2>>(),
+                Rotation = new SortedList<StoryboardCommand<float>>(),
+                Colour = new SortedList<StoryboardCommand<Color4>>(),
+                Alpha = new SortedList<StoryboardCommand<float>>(),
+                BlendingParameters = new SortedList<StoryboardCommand<BlendingParameters>>(),
+                FlipH = new SortedList<StoryboardCommand<bool>>(),
+                FlipV = new SortedList<StoryboardCommand<bool>>()
+            };
+        }
+
+        /// <summary>
+        /// Returns all commands contained by this group unsorted.
+        /// </summary>
+        public virtual IEnumerable<IStoryboardCommand> GetAllCommands() => lists.SelectMany(l => l);
+
+        public void AddX(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            => AddCommand(X, new StoryboardXCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddY(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            => AddCommand(Y, new StoryboardYCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddScale(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            => AddCommand(Scale, new StoryboardScaleCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddVectorScale(double startTime, double endTime, Vector2 startValue, Vector2 endValue, Easing easing)
+            => AddCommand(VectorScale, new StoryboardVectorScaleCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddRotation(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            => AddCommand(Rotation, new StoryboardRotationCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddColour(double startTime, double endTime, Color4 startValue, Color4 endValue, Easing easing)
+            => AddCommand(Colour, new StoryboardColourCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddAlpha(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            => AddCommand(Alpha, new StoryboardAlphaCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddBlendingParameters(double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue, Easing easing)
+            => AddCommand(BlendingParameters, new StoryboardBlendingParametersCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddFlipH(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
+            => AddCommand(FlipH, new StoryboardFlipHCommand(startTime, endTime, startValue, endValue, easing));
+
+        public void AddFlipV(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
+            => AddCommand(FlipV, new StoryboardFlipVCommand(startTime, endTime, startValue, endValue, easing));
+
+        /// <summary>
+        /// Adds the given storyboard <paramref name="command"/> to the target <paramref name="list"/>.
+        /// Can be overriden to apply custom effects to the given command before adding it to the list (e.g. looping or time offsets).
+        /// </summary>
+        /// <typeparam name="T">The value type of the target property affected by this storyboard command.</typeparam>
+        protected virtual void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
+        {
+            list.Add(command);
+
+            if (command.StartTime < StartTime)
+                StartTime = command.StartTime;
+
+            if (command.EndTime > EndTime)
+                EndTime = command.EndTime;
+        }
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandList.cs b/osu.Game/Storyboards/Commands/StoryboardCommandList.cs
new file mode 100644
index 0000000000..67012e9d49
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandList.cs
@@ -0,0 +1,41 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+namespace osu.Game.Storyboards.Commands
+{
+    // public class StoryboardCommandList<T> : IStoryboardCommandList
+    // {
+    //     // todo: change to sorted list and avoid enumerable type on exposed properties?
+    //     private readonly List<StoryboardCommand<T>> commands = new List<StoryboardCommand<T>>();
+    //
+    //     public IEnumerable<StoryboardCommand<T>> Commands => commands.OrderBy(c => c.StartTime);
+    //
+    //     IEnumerable<IStoryboardCommand> IStoryboardCommandList.Commands => Commands;
+    //     public bool HasCommands => commands.Count > 0;
+    //
+    //     public double StartTime { get; private set; } = double.MaxValue;
+    //     public double EndTime { get; private set; } = double.MinValue;
+    //
+    //     public T? StartValue { get; private set; }
+    //     public T? EndValue { get; private set; }
+    //
+    //     public void Add(StoryboardCommand<T> command)
+    //     {
+    //         commands.Add(command);
+    //
+    //         if (command.StartTime < StartTime)
+    //         {
+    //             StartValue = command.StartValue;
+    //             StartTime = command.StartTime;
+    //         }
+    //
+    //         if (command.EndTime > EndTime)
+    //         {
+    //             EndValue = command.EndValue;
+    //             EndTime = command.EndTime;
+    //         }
+    //     }
+    //
+    //     public override string ToString() => $"{commands.Count} command(s)";
+    // }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
new file mode 100644
index 0000000000..9bcb687d3c
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
@@ -0,0 +1,23 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+using osu.Game.Storyboards.Drawables;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardFlipHCommand : StoryboardCommand<bool>
+    {
+        public StoryboardFlipHCommand(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipH = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.TransformTo(nameof(IDrawableStoryboardElement.FlipH), StartValue).Delay(Duration)
+                .TransformTo(nameof(IDrawableStoryboardElement.FlipH), EndValue);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
new file mode 100644
index 0000000000..9f1f5faa33
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
@@ -0,0 +1,23 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+using osu.Game.Storyboards.Drawables;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardFlipVCommand : StoryboardCommand<bool>
+    {
+        public StoryboardFlipVCommand(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipV = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.TransformTo(nameof(IDrawableStoryboardElement.FlipV), StartValue).Delay(Duration)
+                .TransformTo(nameof(IDrawableStoryboardElement.FlipV), EndValue);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
new file mode 100644
index 0000000000..e520353bd6
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
@@ -0,0 +1,71 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardLoopingGroup : StoryboardCommandGroup
+    {
+        public double LoopStartTime;
+
+        /// <summary>
+        /// The total number of times this loop is played back. Always greater than zero.
+        /// </summary>
+        public readonly int TotalIterations;
+
+        /// <summary>
+        /// Construct a new command loop.
+        /// </summary>
+        /// <param name="startTime">The start time of the loop.</param>
+        /// <param name="repeatCount">The number of times the loop should repeat. Should be greater than zero. Zero means a single playback.</param>
+        public StoryboardLoopingGroup(double startTime, int repeatCount)
+        {
+            if (repeatCount < 0) throw new ArgumentException("Repeat count must be zero or above.", nameof(repeatCount));
+
+            LoopStartTime = startTime;
+            TotalIterations = repeatCount + 1;
+        }
+
+        protected override void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
+        {
+            // todo: this is broke!
+            double fullLoopDuration = EndTime - StartTime;
+            double loopDelay = fullLoopDuration - command.EndTime + command.StartTime;
+            base.AddCommand(list, new StoryboardLoopingCommand<T>(command, LoopStartTime, TotalIterations, loopDelay));
+        }
+
+        public override string ToString() => $"{LoopStartTime} x{TotalIterations}";
+
+        private class StoryboardLoopingCommand<T> : StoryboardCommand<T>
+        {
+            private readonly StoryboardCommand<T> command;
+            private readonly int loopCount;
+            private readonly double loopDelay;
+
+            public StoryboardLoopingCommand(StoryboardCommand<T> command, double loopStartTime, int loopCount, double loopDelay)
+                // In an ideal world, we would multiply the command duration by TotalIterations in command end time.
+                // Unfortunately this would clash with how stable handled end times, and results in some storyboards playing outro
+                // sequences for minutes or hours.
+                : base(loopStartTime + command.StartTime, loopStartTime + command.EndTime, command.StartValue, command.EndValue, command.Easing)
+            {
+                this.command = command;
+                this.loopCount = loopCount;
+                this.loopDelay = loopDelay;
+            }
+
+            public override void SetInitialValue(Drawable d) => command.SetInitialValue(d);
+
+            public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            {
+                if (loopCount == 0)
+                    return command.ApplyTransform(d);
+
+                return command.ApplyTransform(d).Loop(loopDelay, loopCount);
+            }
+        }
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
new file mode 100644
index 0000000000..c56dcd130f
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardRotationCommand : StoryboardCommand<float>
+    {
+        public StoryboardRotationCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Rotation = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.RotateTo(StartValue).Then().RotateTo(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
new file mode 100644
index 0000000000..9dbdd6ebd8
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
@@ -0,0 +1,22 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+using osuTK;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardScaleCommand : StoryboardCommand<float>
+    {
+        public StoryboardScaleCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Scale = new Vector2(StartValue);
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.ScaleTo(StartValue).Then().ScaleTo(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/CommandTrigger.cs b/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
similarity index 68%
rename from osu.Game/Storyboards/CommandTrigger.cs
rename to osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
index 011f345df2..dfb6f8cb1b 100644
--- a/osu.Game/Storyboards/CommandTrigger.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
@@ -1,16 +1,17 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-namespace osu.Game.Storyboards
+namespace osu.Game.Storyboards.Commands
 {
-    public class CommandTrigger : CommandTimelineGroup
+    // todo: this is not implemented and has never been, keep that in mind.
+    public class StoryboardTriggerGroup : StoryboardCommandGroup
     {
         public string TriggerName;
         public double TriggerStartTime;
         public double TriggerEndTime;
         public int GroupNumber;
 
-        public CommandTrigger(string triggerName, double startTime, double endTime, int groupNumber)
+        public StoryboardTriggerGroup(string triggerName, double startTime, double endTime, int groupNumber)
         {
             TriggerName = triggerName;
             TriggerStartTime = startTime;
diff --git a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
new file mode 100644
index 0000000000..fefb21b257
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
@@ -0,0 +1,24 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+using osu.Game.Storyboards.Drawables;
+using osuTK;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardVectorScaleCommand : StoryboardCommand<Vector2>
+    {
+        public StoryboardVectorScaleCommand(double startTime, double endTime, Vector2 startValue, Vector2 endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).VectorScale = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.TransformTo(nameof(IDrawableStoryboardElement.VectorScale), StartValue).Then()
+                .TransformTo(nameof(IDrawableStoryboardElement.VectorScale), EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
new file mode 100644
index 0000000000..a9f9cd4f8f
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardXCommand : StoryboardCommand<float>
+    {
+        public StoryboardXCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.X = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.MoveToX(StartValue).Then().MoveToX(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
new file mode 100644
index 0000000000..eb30b36720
--- /dev/null
+++ b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
@@ -0,0 +1,21 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Transforms;
+
+namespace osu.Game.Storyboards.Commands
+{
+    public class StoryboardYCommand : StoryboardCommand<float>
+    {
+        public StoryboardYCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
+            : base(startTime, endTime, startValue, endValue, easing)
+        {
+        }
+
+        public override void SetInitialValue(Drawable d) => d.Y = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            => d.MoveToY(StartValue).Then().MoveToY(EndValue, Duration, Easing);
+    }
+}
diff --git a/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs b/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
index 6652b5509c..04bae88c76 100644
--- a/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
+++ b/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
@@ -1,12 +1,12 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Graphics.Transforms;
+using osu.Framework.Graphics;
 using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public interface IDrawableStoryboardElement : ITransformable
+    public interface IDrawableStoryboardElement : IDrawable
     {
         bool FlipH { get; set; }
         bool FlipV { get; set; }
diff --git a/osu.Game/Storyboards/StoryboardAnimation.cs b/osu.Game/Storyboards/StoryboardAnimation.cs
index 173acf7ff1..0b714633c9 100644
--- a/osu.Game/Storyboards/StoryboardAnimation.cs
+++ b/osu.Game/Storyboards/StoryboardAnimation.cs
@@ -7,7 +7,7 @@ using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Storyboards
 {
-    public class StoryboardAnimation : StoryboardElementWithDuration<DrawableStoryboardAnimation>
+    public class StoryboardAnimation : StoryboardSprite
     {
         public int FrameCount;
         public double FrameDelay;
@@ -21,7 +21,7 @@ namespace osu.Game.Storyboards
             LoopType = loopType;
         }
 
-        public override DrawableStoryboardAnimation CreateStoryboardDrawable() => new DrawableStoryboardAnimation(this);
+        public override Drawable CreateDrawable() => new DrawableStoryboardAnimation(this);
     }
 
     public enum AnimationLoopType
diff --git a/osu.Game/Storyboards/StoryboardElementWithDuration.cs b/osu.Game/Storyboards/StoryboardElementWithDuration.cs
deleted file mode 100644
index 06924a26ef..0000000000
--- a/osu.Game/Storyboards/StoryboardElementWithDuration.cs
+++ /dev/null
@@ -1,236 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using osu.Framework.Graphics;
-using osu.Game.Storyboards.Drawables;
-using osuTK;
-
-namespace osu.Game.Storyboards
-{
-    public abstract class StoryboardElementWithDuration : IStoryboardElementWithDuration
-    {
-        protected readonly List<CommandLoop> Loops = new List<CommandLoop>();
-        private readonly List<CommandTrigger> triggers = new List<CommandTrigger>();
-
-        public string Path { get; }
-        public bool IsDrawable => HasCommands;
-
-        public Anchor Origin;
-        public Vector2 InitialPosition;
-
-        public readonly CommandTimelineGroup TimelineGroup = new CommandTimelineGroup();
-
-        public double StartTime
-        {
-            get
-            {
-                // To get the initial start time, we need to check whether the first alpha command to exist (across all loops) has a StartValue of zero.
-                // A StartValue of zero governs, above all else, the first valid display time of a sprite.
-                //
-                // You can imagine that the first command of each type decides that type's start value, so if the initial alpha is zero,
-                // anything before that point can be ignored (the sprite is not visible after all).
-                var alphaCommands = new List<(double startTime, bool isZeroStartValue)>();
-
-                var command = TimelineGroup.Alpha.Commands.FirstOrDefault();
-                if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
-
-                foreach (var loop in Loops)
-                {
-                    command = loop.Alpha.Commands.FirstOrDefault();
-                    if (command != null) alphaCommands.Add((command.StartTime + loop.LoopStartTime, command.StartValue == 0));
-                }
-
-                if (alphaCommands.Count > 0)
-                {
-                    var firstAlpha = alphaCommands.MinBy(t => t.startTime);
-
-                    if (firstAlpha.isZeroStartValue)
-                        return firstAlpha.startTime;
-                }
-
-                return EarliestTransformTime;
-            }
-        }
-
-        public double EarliestTransformTime
-        {
-            get
-            {
-                // If we got to this point, either no alpha commands were present, or the earliest had a non-zero start value.
-                // The sprite's StartTime will be determined by the earliest command, regardless of type.
-                double earliestStartTime = TimelineGroup.StartTime;
-                foreach (var l in Loops)
-                    earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
-                return earliestStartTime;
-            }
-        }
-
-        public double EndTime
-        {
-            get
-            {
-                double latestEndTime = TimelineGroup.EndTime;
-
-                foreach (var l in Loops)
-                    latestEndTime = Math.Max(latestEndTime, l.EndTime);
-
-                return latestEndTime;
-            }
-        }
-
-        public double EndTimeForDisplay
-        {
-            get
-            {
-                double latestEndTime = TimelineGroup.EndTime;
-
-                foreach (var l in Loops)
-                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
-
-                return latestEndTime;
-            }
-        }
-
-        public bool HasCommands => TimelineGroup.HasCommands || Loops.Any(l => l.HasCommands);
-
-        protected StoryboardElementWithDuration(string path, Anchor origin, Vector2 initialPosition)
-        {
-            Path = path;
-            Origin = origin;
-            InitialPosition = initialPosition;
-        }
-
-        public abstract Drawable CreateDrawable();
-
-        public CommandLoop AddLoop(double startTime, int repeatCount)
-        {
-            var loop = new CommandLoop(startTime, repeatCount);
-            Loops.Add(loop);
-            return loop;
-        }
-
-        public CommandTrigger AddTrigger(string triggerName, double startTime, double endTime, int groupNumber)
-        {
-            var trigger = new CommandTrigger(triggerName, startTime, endTime, groupNumber);
-            triggers.Add(trigger);
-            return trigger;
-        }
-
-        protected IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups)
-        {
-            var commands = TimelineGroup.GetCommands(timelineSelector);
-            foreach (var loop in Loops)
-                commands = commands.Concat(loop.GetCommands(timelineSelector));
-
-            if (triggeredGroups != null)
-            {
-                foreach (var pair in triggeredGroups)
-                    commands = commands.Concat(pair.Item1.GetCommands(timelineSelector, pair.Item2));
-            }
-
-            return commands;
-        }
-
-        public override string ToString()
-            => $"{Path}, {Origin}, {InitialPosition}";
-    }
-
-    public abstract class StoryboardElementWithDuration<U> : StoryboardElementWithDuration
-        where U : Drawable, IDrawableStoryboardElement
-    {
-        private delegate void DrawablePropertyInitializer<in T>(U drawable, T value);
-
-        protected StoryboardElementWithDuration(string path, Anchor origin, Vector2 initialPosition)
-            : base(path, origin, initialPosition)
-        {
-        }
-
-        public override Drawable CreateDrawable() => CreateStoryboardDrawable();
-
-        public abstract U CreateStoryboardDrawable();
-
-        public void ApplyTransforms(U drawable, IEnumerable<Tuple<CommandTimelineGroup, double>>? triggeredGroups = null)
-        {
-            // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
-            // To achieve this, commands are "generated" as pairs of (command, initFunc, transformFunc) and batched into a contiguous list
-            // The list is then stably-sorted (to preserve command order), and applied to the drawable sequentially.
-
-            List<IGeneratedCommand<U>> generated = new List<IGeneratedCommand<U>>();
-
-            generateCommands(generated, GetCommands(g => g.X, triggeredGroups), (d, value) => d.X = value);
-            generateCommands(generated, GetCommands(g => g.Y, triggeredGroups), (d, value) => d.Y = value);
-            generateCommands(generated, GetCommands(g => g.Scale, triggeredGroups), (d, value) => d.Scale = value);
-            generateCommands(generated, GetCommands(g => g.Rotation, triggeredGroups), (d, value) => d.Rotation = value);
-            generateCommands(generated, GetCommands(g => g.Colour, triggeredGroups), (d, value) => d.Colour = value);
-            generateCommands(generated, GetCommands(g => g.Alpha, triggeredGroups), (d, value) => d.Alpha = value);
-            generateCommands(generated, GetCommands(g => g.BlendingParameters, triggeredGroups), (d, value) => d.Blending = value, false);
-            generateCommands(generated, GetCommands(g => g.VectorScale, triggeredGroups), (d, value) => d.VectorScale = value);
-            generateCommands(generated, GetCommands(g => g.FlipH, triggeredGroups), (d, value) => d.FlipH = value, false);
-            generateCommands(generated, GetCommands(g => g.FlipV, triggeredGroups), (d, value) => d.FlipV = value, false);
-
-            foreach (var command in generated.OrderBy(g => g.StartTime))
-                command.ApplyTo(drawable);
-        }
-
-        private void generateCommands<T>(List<IGeneratedCommand<U>> resultList, IEnumerable<CommandTimeline<T>.TypedCommand> commands,
-                                         DrawablePropertyInitializer<T> initializeProperty, bool alwaysInitialize = true)
-        {
-            bool initialized = false;
-
-            foreach (var command in commands)
-            {
-                DrawablePropertyInitializer<T>? initFunc = null;
-
-                if (!initialized)
-                {
-                    if (alwaysInitialize || command.StartTime == command.EndTime)
-                        initFunc = initializeProperty;
-                    initialized = true;
-                }
-
-                resultList.Add(new GeneratedCommand<T, U>(command, initFunc));
-            }
-        }
-
-        private interface IGeneratedCommand<in TDrawable>
-            where TDrawable : U
-        {
-            double StartTime { get; }
-
-            void ApplyTo(TDrawable drawable);
-        }
-
-        private readonly struct GeneratedCommand<T, TDrawable> : IGeneratedCommand<TDrawable>
-            where TDrawable : U
-        {
-            public double StartTime => command.StartTime;
-
-            private readonly DrawablePropertyInitializer<T>? initializeProperty;
-            private readonly CommandTimeline<T>.TypedCommand command;
-
-            public GeneratedCommand(CommandTimeline<T>.TypedCommand command, DrawablePropertyInitializer<T>? initializeProperty)
-            {
-                this.command = command;
-                this.initializeProperty = initializeProperty;
-            }
-
-            public void ApplyTo(TDrawable drawable)
-            {
-                initializeProperty?.Invoke(drawable, command.StartValue);
-
-                using (drawable.BeginAbsoluteSequence(command.StartTime))
-                {
-                    var sequence = command.IsParameterCommand
-                        ? drawable.TransformTo(command.PropertyName, command.StartValue).Delay(command.Duration).TransformTo(command.PropertyName, command.EndValue)
-                        : drawable.TransformTo(command.PropertyName, command.StartValue).Then().TransformTo(command.PropertyName, command.EndValue, command.Duration, command.Easing);
-
-                    if (command.LoopCount > 0)
-                        sequence.Loop(command.Delay, command.LoopCount);
-                }
-            }
-        }
-    }
-}
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 8eaab9428d..dfd184a909 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -1,19 +1,164 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Graphics;
+using osu.Game.Storyboards.Commands;
 using osu.Game.Storyboards.Drawables;
 using osuTK;
 
 namespace osu.Game.Storyboards
 {
-    public class StoryboardSprite : StoryboardElementWithDuration<DrawableStoryboardSprite>
+    public class StoryboardSprite : IStoryboardElementWithDuration
     {
-        public StoryboardSprite(string path, Anchor origin, Vector2 initialPosition)
-            : base(path, origin, initialPosition)
+        private readonly List<StoryboardLoopingGroup> loopGroups = new List<StoryboardLoopingGroup>();
+        private readonly List<StoryboardTriggerGroup> triggerGroups = new List<StoryboardTriggerGroup>();
+
+        public string Path { get; }
+        public bool IsDrawable => HasCommands;
+
+        public Anchor Origin;
+        public Vector2 InitialPosition;
+
+        public readonly StoryboardCommandGroup Group = new StoryboardCommandGroup();
+
+        public double StartTime
         {
+            get
+            {
+                // To get the initial start time, we need to check whether the first alpha command to exist (across all loops) has a StartValue of zero.
+                // A StartValue of zero governs, above all else, the first valid display time of a sprite.
+                //
+                // You can imagine that the first command of each type decides that type's start value, so if the initial alpha is zero,
+                // anything before that point can be ignored (the sprite is not visible after all).
+                var alphaCommands = new List<(double startTime, bool isZeroStartValue)>();
+
+                var command = Group.Alpha.FirstOrDefault();
+                if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
+
+                foreach (var loop in loopGroups)
+                {
+                    command = loop.Alpha.FirstOrDefault();
+                    if (command != null) alphaCommands.Add((command.StartTime + loop.LoopStartTime, command.StartValue == 0));
+                }
+
+                if (alphaCommands.Count > 0)
+                {
+                    var firstAlpha = alphaCommands.MinBy(t => t.startTime);
+
+                    if (firstAlpha.isZeroStartValue)
+                        return firstAlpha.startTime;
+                }
+
+                return EarliestTransformTime;
+            }
         }
 
-        public override DrawableStoryboardSprite CreateStoryboardDrawable() => new DrawableStoryboardSprite(this);
+        public double EarliestTransformTime
+        {
+            get
+            {
+                // If we got to this point, either no alpha commands were present, or the earliest had a non-zero start value.
+                // The sprite's StartTime will be determined by the earliest command, regardless of type.
+                double earliestStartTime = Group.StartTime;
+                foreach (var l in loopGroups)
+                    earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
+                return earliestStartTime;
+            }
+        }
+
+        public double EndTime
+        {
+            get
+            {
+                double latestEndTime = Group.EndTime;
+
+                foreach (var l in loopGroups)
+                    latestEndTime = Math.Max(latestEndTime, l.EndTime);
+
+                return latestEndTime;
+            }
+        }
+
+        public double EndTimeForDisplay
+        {
+            get
+            {
+                double latestEndTime = Group.StartTime;
+
+                foreach (var l in loopGroups)
+                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.Duration * l.TotalIterations);
+
+                return latestEndTime;
+            }
+        }
+
+        public bool HasCommands => Group.HasCommands || loopGroups.Any(l => l.HasCommands);
+
+        public StoryboardSprite(string path, Anchor origin, Vector2 initialPosition)
+        {
+            Path = path;
+            Origin = origin;
+            InitialPosition = initialPosition;
+        }
+
+        public virtual Drawable CreateDrawable() => new DrawableStoryboardSprite(this);
+
+        public StoryboardLoopingGroup AddLoopingGroup(double loopStartTime, int repeatCount)
+        {
+            var loop = new StoryboardLoopingGroup(loopStartTime, repeatCount);
+            loopGroups.Add(loop);
+            return loop;
+        }
+
+        public StoryboardTriggerGroup AddTriggerGroup(string triggerName, double startTime, double endTime, int groupNumber)
+        {
+            var trigger = new StoryboardTriggerGroup(triggerName, startTime, endTime, groupNumber);
+            triggerGroups.Add(trigger);
+            return trigger;
+        }
+
+        public override string ToString() => $"{Path}, {Origin}, {InitialPosition}";
+
+        public void ApplyTransforms(Drawable drawable, IEnumerable<Tuple<StoryboardCommandGroup, double>>? triggeredGroups = null)
+        {
+            // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
+
+            var commands = Group.GetAllCommands();
+            commands = commands.Concat(loopGroups.SelectMany(l => l.GetAllCommands()));
+
+            // todo: triggers are not implemented yet.
+            // if (triggeredGroups != null)
+            //     commands = commands.Concat(triggeredGroups.SelectMany(tuple => tuple.Item1.GetAllCommands(tuple.Item2)));
+
+            foreach (var command in commands.OrderBy(c => c.StartTime))
+            {
+                using (drawable.BeginAbsoluteSequence(command.StartTime))
+                    command.ApplyTransform(drawable);
+            }
+        }
+
+        // todo: need to revisit property initialisation. apparently it has to be done per first command of every affected property (transforms are supposed to do that already?).
+        // private void generateCommands<T>(List<IGeneratedCommand> resultList, IEnumerable<StoryboardCommandList<T>.TypedCommand> commands,
+        //                                  DrawablePropertyInitializer<T> initializeProperty, DrawableTransform<T> transform, bool alwaysInitialize = true)
+        // {
+        //     bool initialized = false;
+        //
+        //     foreach (var command in commands)
+        //     {
+        //         DrawablePropertyInitializer<T>? initFunc = null;
+        //
+        //         if (!initialized)
+        //         {
+        //             if (alwaysInitialize || command.StartTime == command.EndTime)
+        //                 initFunc = initializeProperty;
+        //             initialized = true;
+        //         }
+        //
+        //         resultList.Add(new GeneratedCommand<T>(command, initFunc, transform));
+        //     }
+        // }
     }
 }

From 9b77d8c972abefe0e7e0d524e26a90b457f41abf Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 01:59:26 +0300
Subject: [PATCH 306/930] Fix group start/end time not calculating correctly

---
 osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
index 02c43c9f60..5bb7ee6acf 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -30,13 +30,13 @@ namespace osu.Game.Storyboards.Commands
         /// Returns the earliest start time of the commands added to this group.
         /// </summary>
         [JsonIgnore]
-        public double StartTime { get; private set; }
+        public double StartTime { get; private set; } = double.MaxValue;
 
         /// <summary>
         /// Returns the latest end time of the commands added to this group.
         /// </summary>
         [JsonIgnore]
-        public double EndTime { get; private set; }
+        public double EndTime { get; private set; } = double.MinValue;
 
         [JsonIgnore]
         public double Duration => EndTime - StartTime;

From 6c257e515996d04a7e31c35ac9bf7219442e2f2e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 01:59:42 +0300
Subject: [PATCH 307/930] Fix `HasCommands` property not set at all

---
 osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
index 5bb7ee6acf..0d4a79079b 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -104,6 +104,7 @@ namespace osu.Game.Storyboards.Commands
         protected virtual void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
         {
             list.Add(command);
+            HasCommands = true;
 
             if (command.StartTime < StartTime)
                 StartTime = command.StartTime;

From 87b065b8c3c82a365be4a2b9274042480e417a36 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 02:00:23 +0300
Subject: [PATCH 308/930] Fix incorrect start time calculations

`LoopStartTime` is now baked into each `IStoryboardCommand`.
---
 osu.Game/Storyboards/StoryboardSprite.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index dfd184a909..fc3c5d343c 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Storyboards
                 foreach (var loop in loopGroups)
                 {
                     command = loop.Alpha.FirstOrDefault();
-                    if (command != null) alphaCommands.Add((command.StartTime + loop.LoopStartTime, command.StartValue == 0));
+                    if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
                 }
 
                 if (alphaCommands.Count > 0)
@@ -120,8 +120,6 @@ namespace osu.Game.Storyboards
             return trigger;
         }
 
-        public override string ToString() => $"{Path}, {Origin}, {InitialPosition}";
-
         public void ApplyTransforms(Drawable drawable, IEnumerable<Tuple<StoryboardCommandGroup, double>>? triggeredGroups = null)
         {
             // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
@@ -140,6 +138,8 @@ namespace osu.Game.Storyboards
             }
         }
 
+        public override string ToString() => $"{Path}, {Origin}, {InitialPosition}";
+
         // todo: need to revisit property initialisation. apparently it has to be done per first command of every affected property (transforms are supposed to do that already?).
         // private void generateCommands<T>(List<IGeneratedCommand> resultList, IEnumerable<StoryboardCommandList<T>.TypedCommand> commands,
         //                                  DrawablePropertyInitializer<T> initializeProperty, DrawableTransform<T> transform, bool alwaysInitialize = true)

From 3755dd059af7855219a1867d894aee803e722fa2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 01:58:58 +0300
Subject: [PATCH 309/930] Calculate loop delays at point of transform
 application

---
 .../Commands/StoryboardLoopingGroup.cs        | 36 +++++++++----------
 1 file changed, 16 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
index e520353bd6..39b81ead28 100644
--- a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardLoopingGroup : StoryboardCommandGroup
     {
-        public double LoopStartTime;
+        private readonly double loopStartTime;
 
         /// <summary>
         /// The total number of times this loop is played back. Always greater than zero.
@@ -26,45 +26,41 @@ namespace osu.Game.Storyboards.Commands
         {
             if (repeatCount < 0) throw new ArgumentException("Repeat count must be zero or above.", nameof(repeatCount));
 
-            LoopStartTime = startTime;
+            loopStartTime = startTime;
             TotalIterations = repeatCount + 1;
         }
 
         protected override void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
-        {
-            // todo: this is broke!
-            double fullLoopDuration = EndTime - StartTime;
-            double loopDelay = fullLoopDuration - command.EndTime + command.StartTime;
-            base.AddCommand(list, new StoryboardLoopingCommand<T>(command, LoopStartTime, TotalIterations, loopDelay));
-        }
+            => base.AddCommand(list, new StoryboardLoopingCommand<T>(command, this));
 
-        public override string ToString() => $"{LoopStartTime} x{TotalIterations}";
+        public override string ToString() => $"{loopStartTime} x{TotalIterations}";
 
         private class StoryboardLoopingCommand<T> : StoryboardCommand<T>
         {
             private readonly StoryboardCommand<T> command;
-            private readonly int loopCount;
-            private readonly double loopDelay;
+            private readonly StoryboardLoopingGroup loopingGroup;
 
-            public StoryboardLoopingCommand(StoryboardCommand<T> command, double loopStartTime, int loopCount, double loopDelay)
+            public StoryboardLoopingCommand(StoryboardCommand<T> command, StoryboardLoopingGroup loopingGroup)
                 // In an ideal world, we would multiply the command duration by TotalIterations in command end time.
                 // Unfortunately this would clash with how stable handled end times, and results in some storyboards playing outro
                 // sequences for minutes or hours.
-                : base(loopStartTime + command.StartTime, loopStartTime + command.EndTime, command.StartValue, command.EndValue, command.Easing)
+                : base(loopingGroup.loopStartTime + command.StartTime, loopingGroup.loopStartTime + command.EndTime, command.StartValue, command.EndValue, command.Easing)
             {
                 this.command = command;
-                this.loopCount = loopCount;
-                this.loopDelay = loopDelay;
+                this.loopingGroup = loopingGroup;
             }
 
-            public override void SetInitialValue(Drawable d) => command.SetInitialValue(d);
+            public override string PropertyName => command.PropertyName;
 
-            public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+            public override void ApplyInitialValue(Drawable d) => command.ApplyInitialValue(d);
+
+            public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             {
-                if (loopCount == 0)
-                    return command.ApplyTransform(d);
+                if (loopingGroup.TotalIterations == 0)
+                    return command.ApplyTransforms(d);
 
-                return command.ApplyTransform(d).Loop(loopDelay, loopCount);
+                double loopingGroupDuration = loopingGroup.Duration;
+                return command.ApplyTransforms(d).Loop(loopingGroupDuration - Duration, loopingGroup.TotalIterations);
             }
         }
     }

From 2ca36254f46c3501d97a8782bcc7a699104557d1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 02:02:22 +0300
Subject: [PATCH 310/930] Fix comparison interface not implemented on
 storyboard command classes

---
 osu.Game/Storyboards/Commands/StoryboardCommand.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/StoryboardCommand.cs b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
index 883b9f57c1..1647faf243 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
@@ -1,12 +1,13 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
 namespace osu.Game.Storyboards.Commands
 {
-    public abstract class StoryboardCommand<T> : IStoryboardCommand
+    public abstract class StoryboardCommand<T> : IStoryboardCommand, IComparable<StoryboardCommand<T>>
     {
         public double StartTime { get; }
         public double EndTime { get; }
@@ -41,10 +42,14 @@ namespace osu.Game.Storyboards.Commands
         /// </summary>
         public abstract TransformSequence<Drawable> ApplyTransform(Drawable d);
 
-        public int CompareTo(IStoryboardCommand other)
+        public int CompareTo(StoryboardCommand<T>? other)
         {
+            if (other == null)
+                return 1;
+
             int result = StartTime.CompareTo(other.StartTime);
-            if (result != 0) return result;
+            if (result != 0)
+                return result;
 
             return EndTime.CompareTo(other.EndTime);
         }

From b450abb687823132c9bb3c6b1041bb70bb05d8ea Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 02:02:45 +0300
Subject: [PATCH 311/930] Support applying initial values of storyboard
 commands

---
 .../Storyboards/Commands/IStoryboardCommand.cs     | 14 +++++++++++++-
 .../Storyboards/Commands/StoryboardAlphaCommand.cs |  8 ++++++--
 .../StoryboardBlendingParametersCommand.cs         |  9 ++++++---
 .../Commands/StoryboardColourCommand.cs            |  8 ++++++--
 osu.Game/Storyboards/Commands/StoryboardCommand.cs | 12 ++++--------
 .../Storyboards/Commands/StoryboardFlipHCommand.cs |  6 ++++--
 .../Storyboards/Commands/StoryboardFlipVCommand.cs |  6 ++++--
 .../Commands/StoryboardRotationCommand.cs          |  6 ++++--
 .../Storyboards/Commands/StoryboardScaleCommand.cs |  6 ++++--
 .../Commands/StoryboardVectorScaleCommand.cs       |  6 ++++--
 .../Storyboards/Commands/StoryboardXCommand.cs     |  6 ++++--
 .../Storyboards/Commands/StoryboardYCommand.cs     |  6 ++++--
 osu.Game/Storyboards/StoryboardSprite.cs           | 10 +++++++++-
 13 files changed, 72 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
index 848dcab575..05613a987d 100644
--- a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
@@ -18,11 +18,23 @@ namespace osu.Game.Storyboards.Commands
         /// </summary>
         double EndTime { get; }
 
+        /// <summary>
+        /// The name of the <see cref="Drawable"/> property affected by this storyboard command.
+        /// Used to apply initial property values based on the list of commands given in <see cref="StoryboardSprite"/>.
+        /// </summary>
+        string PropertyName { get; }
+
+        /// <summary>
+        /// Sets the value of the corresponding property in <see cref="Drawable"/> to the start value of this command.
+        /// </summary>
+        /// <param name="d">The target drawable.</param>
+        void ApplyInitialValue(Drawable d);
+
         /// <summary>
         /// Applies the transforms described by this storyboard command to the target drawable.
         /// </summary>
         /// <param name="d">The target drawable.</param>
         /// <returns>The sequence of transforms applied to the target drawable.</returns>
-        TransformSequence<Drawable> ApplyTransform(Drawable d);
+        TransformSequence<Drawable> ApplyTransforms(Drawable d);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
index 729ecd72a7..1d91d6ccc1 100644
--- a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
@@ -13,7 +13,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Alpha = StartValue;
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d) => d.FadeTo(StartValue).Then().FadeTo(EndValue, Duration, Easing);
+        public override string PropertyName => nameof(Drawable.Alpha);
+
+        public override void ApplyInitialValue(Drawable d) => d.Alpha = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+            => d.FadeTo(StartValue).Then().FadeTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
index cc54909837..3a2d372a66 100644
--- a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
@@ -13,9 +13,12 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Blending = StartValue;
+        public override string PropertyName => nameof(Drawable.Blending);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
-            => d.TransformTo(nameof(d.Blending), StartValue).Delay(Duration).TransformTo(nameof(d.Blending), EndValue);
+        public override void ApplyInitialValue(Drawable d) => d.Blending = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+            => d.TransformTo(nameof(d.Blending), StartValue).Delay(Duration)
+                .TransformTo(nameof(d.Blending), EndValue);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
index be56a1d71b..fbde7e1af7 100644
--- a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
@@ -14,7 +14,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Colour = StartValue;
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d) => d.FadeColour(StartValue).Then().FadeColour(EndValue, Duration, Easing);
+        public override string PropertyName => nameof(Drawable.Colour);
+
+        public override void ApplyInitialValue(Drawable d) => d.Colour = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+            => d.FadeColour(StartValue).Then().FadeColour(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommand.cs b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
index 1647faf243..58fcb148ff 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
@@ -32,15 +32,11 @@ namespace osu.Game.Storyboards.Commands
         public T StartValue;
         public T EndValue;
 
-        /// <summary>
-        /// Sets the value of the corresponding property in <see cref="Drawable"/> to the start value of this command.
-        /// </summary>
-        public abstract void SetInitialValue(Drawable d);
+        public abstract string PropertyName { get; }
 
-        /// <summary>
-        /// Transforms a corresponding property in <see cref="Drawable"/> that corresponds to this command group with the specified parameters.
-        /// </summary>
-        public abstract TransformSequence<Drawable> ApplyTransform(Drawable d);
+        public abstract void ApplyInitialValue(Drawable d);
+
+        public abstract TransformSequence<Drawable> ApplyTransforms(Drawable d);
 
         public int CompareTo(StoryboardCommand<T>? other)
         {
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
index 9bcb687d3c..c381b0bb64 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
@@ -14,9 +14,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipH = StartValue;
+        public override string PropertyName => nameof(IDrawableStoryboardElement.FlipH);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipH = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.TransformTo(nameof(IDrawableStoryboardElement.FlipH), StartValue).Delay(Duration)
                 .TransformTo(nameof(IDrawableStoryboardElement.FlipH), EndValue);
     }
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
index 9f1f5faa33..e43e5e9205 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
@@ -14,9 +14,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipV = StartValue;
+        public override string PropertyName => nameof(IDrawableStoryboardElement.FlipV);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipV = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.TransformTo(nameof(IDrawableStoryboardElement.FlipV), StartValue).Delay(Duration)
                 .TransformTo(nameof(IDrawableStoryboardElement.FlipV), EndValue);
     }
diff --git a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
index c56dcd130f..2a449af843 100644
--- a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
@@ -13,9 +13,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Rotation = StartValue;
+        public override string PropertyName => nameof(Drawable.Rotation);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => d.Rotation = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.RotateTo(StartValue).Then().RotateTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
index 9dbdd6ebd8..bf9796148c 100644
--- a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
@@ -14,9 +14,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Scale = new Vector2(StartValue);
+        public override string PropertyName => nameof(Drawable.Scale);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => d.Scale = new Vector2(StartValue);
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.ScaleTo(StartValue).Then().ScaleTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
index fefb21b257..638dc6a5ee 100644
--- a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
@@ -15,9 +15,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).VectorScale = StartValue;
+        public override string PropertyName => nameof(IDrawableStoryboardElement.VectorScale);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).VectorScale = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.TransformTo(nameof(IDrawableStoryboardElement.VectorScale), StartValue).Then()
                 .TransformTo(nameof(IDrawableStoryboardElement.VectorScale), EndValue, Duration, Easing);
     }
diff --git a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
index a9f9cd4f8f..809a77256c 100644
--- a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
@@ -13,9 +13,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.X = StartValue;
+        public override string PropertyName => nameof(Drawable.X);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => d.X = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.MoveToX(StartValue).Then().MoveToX(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
index eb30b36720..d054135878 100644
--- a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
@@ -13,9 +13,11 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override void SetInitialValue(Drawable d) => d.Y = StartValue;
+        public override string PropertyName => nameof(Drawable.Y);
 
-        public override TransformSequence<Drawable> ApplyTransform(Drawable d)
+        public override void ApplyInitialValue(Drawable d) => d.Y = StartValue;
+
+        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
             => d.MoveToY(StartValue).Then().MoveToY(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index fc3c5d343c..9d7ab66692 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -131,10 +131,18 @@ namespace osu.Game.Storyboards
             // if (triggeredGroups != null)
             //     commands = commands.Concat(triggeredGroups.SelectMany(tuple => tuple.Item1.GetAllCommands(tuple.Item2)));
 
+            HashSet<string> appliedProperties = new HashSet<string>();
+
             foreach (var command in commands.OrderBy(c => c.StartTime))
             {
+                if (!appliedProperties.Contains(command.PropertyName))
+                {
+                    command.ApplyInitialValue(drawable);
+                    appliedProperties.Add(command.PropertyName);
+                }
+
                 using (drawable.BeginAbsoluteSequence(command.StartTime))
-                    command.ApplyTransform(drawable);
+                    command.ApplyTransforms(drawable);
             }
         }
 

From fa9b2f0cd541bb4c80c895a0bbeced418ccd85e1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 03:06:49 +0300
Subject: [PATCH 312/930] Add generics to `ApplyInitialValue`/`ApplyTransforms`
 for ability to return custom transform sequences

*sigh*
---
 .../Visual/Gameplay/TestSceneLeadIn.cs        |  8 +--
 .../Gameplay/TestSceneStoryboardWithOutro.cs  |  2 +-
 .../TestSceneMultiSpectatorScreen.cs          |  2 +-
 .../Formats/LegacyStoryboardDecoder.cs        | 32 ++++-----
 .../Commands/IStoryboardCommand.cs            |  7 +-
 .../Commands/StoryboardAlphaCommand.cs        |  4 +-
 .../StoryboardBlendingParametersCommand.cs    |  4 +-
 .../Commands/StoryboardColourCommand.cs       |  4 +-
 .../Storyboards/Commands/StoryboardCommand.cs | 19 +++---
 .../Commands/StoryboardCommandGroup.cs        | 48 ++++---------
 .../Commands/StoryboardCommandList.cs         | 41 ------------
 .../Commands/StoryboardFlipHCommand.cs        | 10 +--
 .../Commands/StoryboardFlipVCommand.cs        | 10 +--
 .../Commands/StoryboardLoopingGroup.cs        |  5 +-
 .../Commands/StoryboardRotationCommand.cs     |  4 +-
 .../Commands/StoryboardScaleCommand.cs        |  4 +-
 .../Commands/StoryboardTriggerGroup.cs        |  1 -
 .../Commands/StoryboardVectorScaleCommand.cs  | 10 +--
 .../Commands/StoryboardXCommand.cs            |  4 +-
 .../Commands/StoryboardYCommand.cs            |  4 +-
 .../Drawables/DrawableStoryboardAnimation.cs  |  2 +-
 .../Drawables/DrawableStoryboardSprite.cs     |  6 +-
 ...ableStoryboardElement.cs => IFlippable.cs} |  4 +-
 .../Storyboards/Drawables/IVectorScalable.cs  | 13 ++++
 osu.Game/Storyboards/StoryboardSprite.cs      | 67 ++++++-------------
 25 files changed, 122 insertions(+), 193 deletions(-)
 delete mode 100644 osu.Game/Storyboards/Commands/StoryboardCommandList.cs
 rename osu.Game/Storyboards/Drawables/{IDrawableStoryboardElement.cs => IFlippable.cs} (72%)
 create mode 100644 osu.Game/Storyboards/Drawables/IVectorScalable.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index c3eef4da9b..b2196e77b4 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
-            sprite.Group.AddAlpha(firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1, Easing.None);
 
             storyboard.GetLayer("Background").Add(sprite);
 
@@ -73,16 +73,16 @@ namespace osu.Game.Tests.Visual.Gameplay
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
             // these should be ignored as we have an alpha visibility blocker proceeding this command.
-            sprite.Group.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
+            sprite.Commands.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
             var loopGroup = sprite.AddLoopingGroup(loop_start_time, 50);
             loopGroup.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
 
-            var target = addEventToLoop ? loopGroup : sprite.Group;
+            var target = addEventToLoop ? loopGroup : sprite.Commands;
             double loopRelativeOffset = addEventToLoop ? -loop_start_time : 0;
             target.AddAlpha(loopRelativeOffset + firstStoryboardEvent, loopRelativeOffset + firstStoryboardEvent + 500, 0, 1, Easing.None);
 
             // these should be ignored due to being in the future.
-            sprite.Group.AddAlpha(18000, 20000, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(18000, 20000, 0, 1, Easing.None);
             loopGroup.AddAlpha(38000, 40000, 0, 1, Easing.None);
 
             storyboard.GetLayer("Background").Add(sprite);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 9269c3f4ae..8bdb7297fe 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             var storyboard = new Storyboard();
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.Group.AddAlpha(0, duration, 1, 0, Easing.None);
+            sprite.Commands.AddAlpha(0, duration, 1, 0, Easing.None);
             storyboard.GetLayer("Background").Add(sprite);
             return storyboard;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 62a2bfeaab..7cd2e2fdaa 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestIntroStoryboardElement() => testLeadIn(b =>
         {
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.Group.AddAlpha(-2000, 0, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(-2000, 0, 0, 1, Easing.None);
             b.Storyboard.GetLayer("Background").Add(sprite);
         });
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index 33cdaa085e..83277b71c8 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Beatmaps.Formats
     public class LegacyStoryboardDecoder : LegacyDecoder<Storyboard>
     {
         private StoryboardSprite? storyboardSprite;
-        private StoryboardCommandGroup? currentGroup;
+        private StoryboardCommandGroup? currentCommandsGroup;
 
         private Storyboard storyboard = null!;
 
@@ -166,7 +166,7 @@ namespace osu.Game.Beatmaps.Formats
             else
             {
                 if (depth < 2)
-                    currentGroup = storyboardSprite?.Group;
+                    currentCommandsGroup = storyboardSprite?.Commands;
 
                 string commandType = split[0];
 
@@ -178,7 +178,7 @@ namespace osu.Game.Beatmaps.Formats
                         double startTime = split.Length > 2 ? Parsing.ParseDouble(split[2]) : double.MinValue;
                         double endTime = split.Length > 3 ? Parsing.ParseDouble(split[3]) : double.MaxValue;
                         int groupNumber = split.Length > 4 ? Parsing.ParseInt(split[4]) : 0;
-                        currentGroup = storyboardSprite?.AddTriggerGroup(triggerName, startTime, endTime, groupNumber);
+                        currentCommandsGroup = storyboardSprite?.AddTriggerGroup(triggerName, startTime, endTime, groupNumber);
                         break;
                     }
 
@@ -186,7 +186,7 @@ namespace osu.Game.Beatmaps.Formats
                     {
                         double startTime = Parsing.ParseDouble(split[1]);
                         int repeatCount = Parsing.ParseInt(split[2]);
-                        currentGroup = storyboardSprite?.AddLoopingGroup(startTime, Math.Max(0, repeatCount - 1));
+                        currentCommandsGroup = storyboardSprite?.AddLoopingGroup(startTime, Math.Max(0, repeatCount - 1));
                         break;
                     }
 
@@ -205,7 +205,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentGroup?.AddAlpha(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddAlpha(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -213,7 +213,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentGroup?.AddScale(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddScale(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -223,7 +223,7 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                currentGroup?.AddVectorScale(startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY), easing);
+                                currentCommandsGroup?.AddVectorScale(startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY), easing);
                                 break;
                             }
 
@@ -231,7 +231,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentGroup?.AddRotation(startTime, endTime, MathUtils.RadiansToDegrees(startValue), MathUtils.RadiansToDegrees(endValue), easing);
+                                currentCommandsGroup?.AddRotation(startTime, endTime, MathUtils.RadiansToDegrees(startValue), MathUtils.RadiansToDegrees(endValue), easing);
                                 break;
                             }
 
@@ -241,8 +241,8 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                currentGroup?.AddX(startTime, endTime, startX, endX, easing);
-                                currentGroup?.AddY(startTime, endTime, startY, endY, easing);
+                                currentCommandsGroup?.AddX(startTime, endTime, startX, endX, easing);
+                                currentCommandsGroup?.AddY(startTime, endTime, startY, endY, easing);
                                 break;
                             }
 
@@ -250,7 +250,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentGroup?.AddX(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddX(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -258,7 +258,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentGroup?.AddY(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddY(startTime, endTime, startValue, endValue, easing);
                                 break;
                             }
 
@@ -270,7 +270,7 @@ namespace osu.Game.Beatmaps.Formats
                                 float endRed = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startRed;
                                 float endGreen = split.Length > 8 ? Parsing.ParseFloat(split[8]) : startGreen;
                                 float endBlue = split.Length > 9 ? Parsing.ParseFloat(split[9]) : startBlue;
-                                currentGroup?.AddColour(startTime, endTime,
+                                currentCommandsGroup?.AddColour(startTime, endTime,
                                     new Color4(startRed / 255f, startGreen / 255f, startBlue / 255f, 1),
                                     new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1), easing);
                                 break;
@@ -283,16 +283,16 @@ namespace osu.Game.Beatmaps.Formats
                                 switch (type)
                                 {
                                     case "A":
-                                        currentGroup?.AddBlendingParameters(startTime, endTime, BlendingParameters.Additive,
+                                        currentCommandsGroup?.AddBlendingParameters(startTime, endTime, BlendingParameters.Additive,
                                             startTime == endTime ? BlendingParameters.Additive : BlendingParameters.Inherit, easing);
                                         break;
 
                                     case "H":
-                                        currentGroup?.AddFlipH(startTime, endTime, true, startTime == endTime, easing);
+                                        currentCommandsGroup?.AddFlipH(startTime, endTime, true, startTime == endTime, easing);
                                         break;
 
                                     case "V":
-                                        currentGroup?.AddFlipV(startTime, endTime, true, startTime == endTime, easing);
+                                        currentCommandsGroup?.AddFlipV(startTime, endTime, true, startTime == endTime, easing);
                                         break;
                                 }
 
diff --git a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
index 05613a987d..6efb19afe4 100644
--- a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
+using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Storyboards.Commands
 {
@@ -28,13 +29,15 @@ namespace osu.Game.Storyboards.Commands
         /// Sets the value of the corresponding property in <see cref="Drawable"/> to the start value of this command.
         /// </summary>
         /// <param name="d">The target drawable.</param>
-        void ApplyInitialValue(Drawable d);
+        void ApplyInitialValue<TDrawable>(TDrawable d)
+            where TDrawable : Drawable, IFlippable, IVectorScalable;
 
         /// <summary>
         /// Applies the transforms described by this storyboard command to the target drawable.
         /// </summary>
         /// <param name="d">The target drawable.</param>
         /// <returns>The sequence of transforms applied to the target drawable.</returns>
-        TransformSequence<Drawable> ApplyTransforms(Drawable d);
+        TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
+            where TDrawable : Drawable, IFlippable, IVectorScalable;
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
index 1d91d6ccc1..f4a90b372a 100644
--- a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Alpha);
 
-        public override void ApplyInitialValue(Drawable d) => d.Alpha = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Alpha = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.FadeTo(StartValue).Then().FadeTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
index 3a2d372a66..3e2e8bb0e8 100644
--- a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Blending);
 
-        public override void ApplyInitialValue(Drawable d) => d.Blending = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Blending = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.TransformTo(nameof(d.Blending), StartValue).Delay(Duration)
                 .TransformTo(nameof(d.Blending), EndValue);
     }
diff --git a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
index fbde7e1af7..66390eb305 100644
--- a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
@@ -16,9 +16,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Colour);
 
-        public override void ApplyInitialValue(Drawable d) => d.Colour = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Colour = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.FadeColour(StartValue).Then().FadeColour(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommand.cs b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
index 58fcb148ff..4f2f0f04a2 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
@@ -4,6 +4,7 @@
 using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
+using osu.Game.Storyboards.Drawables;
 
 namespace osu.Game.Storyboards.Commands
 {
@@ -11,6 +12,11 @@ namespace osu.Game.Storyboards.Commands
     {
         public double StartTime { get; }
         public double EndTime { get; }
+
+        public T StartValue { get; }
+        public T EndValue { get; }
+        public Easing Easing { get; }
+
         public double Duration => EndTime - StartTime;
 
         protected StoryboardCommand(double startTime, double endTime, T startValue, T endValue, Easing easing)
@@ -25,18 +31,13 @@ namespace osu.Game.Storyboards.Commands
             Easing = easing;
         }
 
-        public Easing Easing { get; set; }
-        public int LoopCount { get; set; }
-        public double Delay { get; set; }
-
-        public T StartValue;
-        public T EndValue;
-
         public abstract string PropertyName { get; }
 
-        public abstract void ApplyInitialValue(Drawable d);
+        public abstract void ApplyInitialValue<TDrawable>(TDrawable d)
+            where TDrawable : Drawable, IFlippable, IVectorScalable;
 
-        public abstract TransformSequence<Drawable> ApplyTransforms(Drawable d);
+        public abstract TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
+            where TDrawable : Drawable, IFlippable, IVectorScalable;
 
         public int CompareTo(StoryboardCommand<T>? other)
         {
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
index 0d4a79079b..fb847d2e44 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Graphics;
 using osu.Framework.Lists;
@@ -13,18 +12,20 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardCommandGroup
     {
-        public SortedList<StoryboardCommand<float>> X;
-        public SortedList<StoryboardCommand<float>> Y;
-        public SortedList<StoryboardCommand<float>> Scale;
-        public SortedList<StoryboardCommand<Vector2>> VectorScale;
-        public SortedList<StoryboardCommand<float>> Rotation;
-        public SortedList<StoryboardCommand<Color4>> Colour;
-        public SortedList<StoryboardCommand<float>> Alpha;
-        public SortedList<StoryboardCommand<BlendingParameters>> BlendingParameters;
-        public SortedList<StoryboardCommand<bool>> FlipH;
-        public SortedList<StoryboardCommand<bool>> FlipV;
+        public SortedList<StoryboardCommand<float>> X = new SortedList<StoryboardCommand<float>>();
+        public SortedList<StoryboardCommand<float>> Y = new SortedList<StoryboardCommand<float>>();
+        public SortedList<StoryboardCommand<float>> Scale = new SortedList<StoryboardCommand<float>>();
+        public SortedList<StoryboardCommand<Vector2>> VectorScale = new SortedList<StoryboardCommand<Vector2>>();
+        public SortedList<StoryboardCommand<float>> Rotation = new SortedList<StoryboardCommand<float>>();
+        public SortedList<StoryboardCommand<Color4>> Colour = new SortedList<StoryboardCommand<Color4>>();
+        public SortedList<StoryboardCommand<float>> Alpha = new SortedList<StoryboardCommand<float>>();
+        public SortedList<StoryboardCommand<BlendingParameters>> BlendingParameters = new SortedList<StoryboardCommand<BlendingParameters>>();
+        public SortedList<StoryboardCommand<bool>> FlipH = new SortedList<StoryboardCommand<bool>>();
+        public SortedList<StoryboardCommand<bool>> FlipV = new SortedList<StoryboardCommand<bool>>();
 
-        private readonly IReadOnlyList<IStoryboardCommand>[] lists;
+        public IReadOnlyList<IStoryboardCommand> AllCommands => allCommands;
+
+        private readonly List<IStoryboardCommand> allCommands = new List<IStoryboardCommand>();
 
         /// <summary>
         /// Returns the earliest start time of the commands added to this group.
@@ -44,28 +45,6 @@ namespace osu.Game.Storyboards.Commands
         [JsonIgnore]
         public bool HasCommands { get; private set; }
 
-        public StoryboardCommandGroup()
-        {
-            lists = new IReadOnlyList<IStoryboardCommand>[]
-            {
-                X = new SortedList<StoryboardCommand<float>>(),
-                Y = new SortedList<StoryboardCommand<float>>(),
-                Scale = new SortedList<StoryboardCommand<float>>(),
-                VectorScale = new SortedList<StoryboardCommand<Vector2>>(),
-                Rotation = new SortedList<StoryboardCommand<float>>(),
-                Colour = new SortedList<StoryboardCommand<Color4>>(),
-                Alpha = new SortedList<StoryboardCommand<float>>(),
-                BlendingParameters = new SortedList<StoryboardCommand<BlendingParameters>>(),
-                FlipH = new SortedList<StoryboardCommand<bool>>(),
-                FlipV = new SortedList<StoryboardCommand<bool>>()
-            };
-        }
-
-        /// <summary>
-        /// Returns all commands contained by this group unsorted.
-        /// </summary>
-        public virtual IEnumerable<IStoryboardCommand> GetAllCommands() => lists.SelectMany(l => l);
-
         public void AddX(double startTime, double endTime, float startValue, float endValue, Easing easing)
             => AddCommand(X, new StoryboardXCommand(startTime, endTime, startValue, endValue, easing));
 
@@ -104,6 +83,7 @@ namespace osu.Game.Storyboards.Commands
         protected virtual void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
         {
             list.Add(command);
+            allCommands.Add(command);
             HasCommands = true;
 
             if (command.StartTime < StartTime)
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandList.cs b/osu.Game/Storyboards/Commands/StoryboardCommandList.cs
deleted file mode 100644
index 67012e9d49..0000000000
--- a/osu.Game/Storyboards/Commands/StoryboardCommandList.cs
+++ /dev/null
@@ -1,41 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-namespace osu.Game.Storyboards.Commands
-{
-    // public class StoryboardCommandList<T> : IStoryboardCommandList
-    // {
-    //     // todo: change to sorted list and avoid enumerable type on exposed properties?
-    //     private readonly List<StoryboardCommand<T>> commands = new List<StoryboardCommand<T>>();
-    //
-    //     public IEnumerable<StoryboardCommand<T>> Commands => commands.OrderBy(c => c.StartTime);
-    //
-    //     IEnumerable<IStoryboardCommand> IStoryboardCommandList.Commands => Commands;
-    //     public bool HasCommands => commands.Count > 0;
-    //
-    //     public double StartTime { get; private set; } = double.MaxValue;
-    //     public double EndTime { get; private set; } = double.MinValue;
-    //
-    //     public T? StartValue { get; private set; }
-    //     public T? EndValue { get; private set; }
-    //
-    //     public void Add(StoryboardCommand<T> command)
-    //     {
-    //         commands.Add(command);
-    //
-    //         if (command.StartTime < StartTime)
-    //         {
-    //             StartValue = command.StartValue;
-    //             StartTime = command.StartTime;
-    //         }
-    //
-    //         if (command.EndTime > EndTime)
-    //         {
-    //             EndValue = command.EndValue;
-    //             EndTime = command.EndTime;
-    //         }
-    //     }
-    //
-    //     public override string ToString() => $"{commands.Count} command(s)";
-    // }
-}
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
index c381b0bb64..26aef23226 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
@@ -14,12 +14,12 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override string PropertyName => nameof(IDrawableStoryboardElement.FlipH);
+        public override string PropertyName => nameof(IFlippable.FlipH);
 
-        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipH = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.FlipH = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
-            => d.TransformTo(nameof(IDrawableStoryboardElement.FlipH), StartValue).Delay(Duration)
-                .TransformTo(nameof(IDrawableStoryboardElement.FlipH), EndValue);
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
+            => d.TransformTo(nameof(IFlippable.FlipH), StartValue).Delay(Duration)
+                .TransformTo(nameof(IFlippable.FlipH), EndValue);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
index e43e5e9205..88423da2af 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
@@ -14,12 +14,12 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override string PropertyName => nameof(IDrawableStoryboardElement.FlipV);
+        public override string PropertyName => nameof(IFlippable.FlipV);
 
-        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).FlipV = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.FlipV = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
-            => d.TransformTo(nameof(IDrawableStoryboardElement.FlipV), StartValue).Delay(Duration)
-                .TransformTo(nameof(IDrawableStoryboardElement.FlipV), EndValue);
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
+            => d.TransformTo(nameof(IFlippable.FlipV), StartValue).Delay(Duration)
+                .TransformTo(nameof(IFlippable.FlipV), EndValue);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
index 39b81ead28..e97de84ab7 100644
--- a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
@@ -3,7 +3,6 @@
 
 using System;
 using System.Collections.Generic;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Transforms;
 
 namespace osu.Game.Storyboards.Commands
@@ -52,9 +51,9 @@ namespace osu.Game.Storyboards.Commands
 
             public override string PropertyName => command.PropertyName;
 
-            public override void ApplyInitialValue(Drawable d) => command.ApplyInitialValue(d);
+            public override void ApplyInitialValue<TDrawable>(TDrawable d) => command.ApplyInitialValue(d);
 
-            public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+            public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             {
                 if (loopingGroup.TotalIterations == 0)
                     return command.ApplyTransforms(d);
diff --git a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
index 2a449af843..4347dc9d77 100644
--- a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Rotation);
 
-        public override void ApplyInitialValue(Drawable d) => d.Rotation = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Rotation = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.RotateTo(StartValue).Then().RotateTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
index bf9796148c..b0f33fd6b8 100644
--- a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
@@ -16,9 +16,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Scale);
 
-        public override void ApplyInitialValue(Drawable d) => d.Scale = new Vector2(StartValue);
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Scale = new Vector2(StartValue);
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.ScaleTo(StartValue).Then().ScaleTo(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs b/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
index dfb6f8cb1b..89a68e9ec0 100644
--- a/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardTriggerGroup.cs
@@ -3,7 +3,6 @@
 
 namespace osu.Game.Storyboards.Commands
 {
-    // todo: this is not implemented and has never been, keep that in mind.
     public class StoryboardTriggerGroup : StoryboardCommandGroup
     {
         public string TriggerName;
diff --git a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
index 638dc6a5ee..5d3fef5948 100644
--- a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
@@ -15,12 +15,12 @@ namespace osu.Game.Storyboards.Commands
         {
         }
 
-        public override string PropertyName => nameof(IDrawableStoryboardElement.VectorScale);
+        public override string PropertyName => nameof(IVectorScalable.VectorScale);
 
-        public override void ApplyInitialValue(Drawable d) => ((IDrawableStoryboardElement)d).VectorScale = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.VectorScale = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
-            => d.TransformTo(nameof(IDrawableStoryboardElement.VectorScale), StartValue).Then()
-                .TransformTo(nameof(IDrawableStoryboardElement.VectorScale), EndValue, Duration, Easing);
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
+            => d.TransformTo(nameof(d.VectorScale), StartValue).Then()
+                .TransformTo(nameof(d.VectorScale), EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
index 809a77256c..7df9a75768 100644
--- a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.X);
 
-        public override void ApplyInitialValue(Drawable d) => d.X = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.X = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.MoveToX(StartValue).Then().MoveToX(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
index d054135878..d7dc32a0f3 100644
--- a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
@@ -15,9 +15,9 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Y);
 
-        public override void ApplyInitialValue(Drawable d) => d.Y = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Y = StartValue;
 
-        public override TransformSequence<Drawable> ApplyTransforms(Drawable d)
+        public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.MoveToY(StartValue).Then().MoveToY(EndValue, Duration, Easing);
     }
 }
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index 8e1a8ce949..fae9ec7f2e 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -16,7 +16,7 @@ using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public partial class DrawableStoryboardAnimation : TextureAnimation, IDrawableStoryboardElement
+    public partial class DrawableStoryboardAnimation : TextureAnimation, IFlippable, IVectorScalable
     {
         public StoryboardAnimation Animation { get; }
 
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index 6772178e85..507a51aca4 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
@@ -13,7 +14,7 @@ using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public partial class DrawableStoryboardSprite : Sprite, IDrawableStoryboardElement
+    public partial class DrawableStoryboardSprite : Sprite, IFlippable, IVectorScalable
     {
         public StoryboardSprite Sprite { get; }
 
@@ -101,6 +102,9 @@ namespace osu.Game.Storyboards.Drawables
             else
                 Texture = textureStore.Get(Sprite.Path);
 
+            if (Sprite.Path == "SB/textbox.png")
+                Debugger.Break();
+
             Sprite.ApplyTransforms(this);
         }
 
diff --git a/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs b/osu.Game/Storyboards/Drawables/IFlippable.cs
similarity index 72%
rename from osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
rename to osu.Game/Storyboards/Drawables/IFlippable.cs
index 04bae88c76..79f98ea6ef 100644
--- a/osu.Game/Storyboards/Drawables/IDrawableStoryboardElement.cs
+++ b/osu.Game/Storyboards/Drawables/IFlippable.cs
@@ -2,14 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Graphics;
-using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
-    public interface IDrawableStoryboardElement : IDrawable
+    public interface IFlippable : IDrawable
     {
         bool FlipH { get; set; }
         bool FlipV { get; set; }
-        Vector2 VectorScale { get; set; }
     }
 }
diff --git a/osu.Game/Storyboards/Drawables/IVectorScalable.cs b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
new file mode 100644
index 0000000000..ce6047c8f6
--- /dev/null
+++ b/osu.Game/Storyboards/Drawables/IVectorScalable.cs
@@ -0,0 +1,13 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osuTK;
+
+namespace osu.Game.Storyboards.Drawables
+{
+    public interface IVectorScalable : IDrawable
+    {
+        Vector2 VectorScale { get; set; }
+    }
+}
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 9d7ab66692..f2c011bfca 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -13,7 +13,7 @@ namespace osu.Game.Storyboards
 {
     public class StoryboardSprite : IStoryboardElementWithDuration
     {
-        private readonly List<StoryboardLoopingGroup> loopGroups = new List<StoryboardLoopingGroup>();
+        private readonly List<StoryboardLoopingGroup> loopingGroups = new List<StoryboardLoopingGroup>();
         private readonly List<StoryboardTriggerGroup> triggerGroups = new List<StoryboardTriggerGroup>();
 
         public string Path { get; }
@@ -22,7 +22,7 @@ namespace osu.Game.Storyboards
         public Anchor Origin;
         public Vector2 InitialPosition;
 
-        public readonly StoryboardCommandGroup Group = new StoryboardCommandGroup();
+        public readonly StoryboardCommandGroup Commands = new StoryboardCommandGroup();
 
         public double StartTime
         {
@@ -35,10 +35,10 @@ namespace osu.Game.Storyboards
                 // anything before that point can be ignored (the sprite is not visible after all).
                 var alphaCommands = new List<(double startTime, bool isZeroStartValue)>();
 
-                var command = Group.Alpha.FirstOrDefault();
+                var command = Commands.Alpha.FirstOrDefault();
                 if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
 
-                foreach (var loop in loopGroups)
+                foreach (var loop in loopingGroups)
                 {
                     command = loop.Alpha.FirstOrDefault();
                     if (command != null) alphaCommands.Add((command.StartTime, command.StartValue == 0));
@@ -62,8 +62,8 @@ namespace osu.Game.Storyboards
             {
                 // If we got to this point, either no alpha commands were present, or the earliest had a non-zero start value.
                 // The sprite's StartTime will be determined by the earliest command, regardless of type.
-                double earliestStartTime = Group.StartTime;
-                foreach (var l in loopGroups)
+                double earliestStartTime = Commands.StartTime;
+                foreach (var l in loopingGroups)
                     earliestStartTime = Math.Min(earliestStartTime, l.StartTime);
                 return earliestStartTime;
             }
@@ -73,9 +73,9 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                double latestEndTime = Group.EndTime;
+                double latestEndTime = Commands.EndTime;
 
-                foreach (var l in loopGroups)
+                foreach (var l in loopingGroups)
                     latestEndTime = Math.Max(latestEndTime, l.EndTime);
 
                 return latestEndTime;
@@ -86,16 +86,16 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                double latestEndTime = Group.StartTime;
+                double latestEndTime = Commands.StartTime;
 
-                foreach (var l in loopGroups)
+                foreach (var l in loopingGroups)
                     latestEndTime = Math.Max(latestEndTime, l.StartTime + l.Duration * l.TotalIterations);
 
                 return latestEndTime;
             }
         }
 
-        public bool HasCommands => Group.HasCommands || loopGroups.Any(l => l.HasCommands);
+        public bool HasCommands => Commands.HasCommands || loopingGroups.Any(l => l.HasCommands);
 
         public StoryboardSprite(string path, Anchor origin, Vector2 initialPosition)
         {
@@ -109,7 +109,7 @@ namespace osu.Game.Storyboards
         public StoryboardLoopingGroup AddLoopingGroup(double loopStartTime, int repeatCount)
         {
             var loop = new StoryboardLoopingGroup(loopStartTime, repeatCount);
-            loopGroups.Add(loop);
+            loopingGroups.Add(loop);
             return loop;
         }
 
@@ -120,26 +120,20 @@ namespace osu.Game.Storyboards
             return trigger;
         }
 
-        public void ApplyTransforms(Drawable drawable, IEnumerable<Tuple<StoryboardCommandGroup, double>>? triggeredGroups = null)
+        public void ApplyTransforms<TDrawable>(TDrawable drawable)
+            where TDrawable : Drawable, IFlippable, IVectorScalable
         {
-            // For performance reasons, we need to apply the commands in order by start time. Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
-
-            var commands = Group.GetAllCommands();
-            commands = commands.Concat(loopGroups.SelectMany(l => l.GetAllCommands()));
-
-            // todo: triggers are not implemented yet.
-            // if (triggeredGroups != null)
-            //     commands = commands.Concat(triggeredGroups.SelectMany(tuple => tuple.Item1.GetAllCommands(tuple.Item2)));
-
             HashSet<string> appliedProperties = new HashSet<string>();
 
+            // For performance reasons, we need to apply the commands in chronological order.
+            // Not doing so will cause many functions to be interleaved, resulting in O(n^2) complexity.
+            IEnumerable<IStoryboardCommand> commands = Commands.AllCommands;
+            commands = commands.Concat(loopingGroups.SelectMany(l => l.AllCommands));
+
             foreach (var command in commands.OrderBy(c => c.StartTime))
             {
-                if (!appliedProperties.Contains(command.PropertyName))
-                {
+                if (appliedProperties.Add(command.PropertyName))
                     command.ApplyInitialValue(drawable);
-                    appliedProperties.Add(command.PropertyName);
-                }
 
                 using (drawable.BeginAbsoluteSequence(command.StartTime))
                     command.ApplyTransforms(drawable);
@@ -147,26 +141,5 @@ namespace osu.Game.Storyboards
         }
 
         public override string ToString() => $"{Path}, {Origin}, {InitialPosition}";
-
-        // todo: need to revisit property initialisation. apparently it has to be done per first command of every affected property (transforms are supposed to do that already?).
-        // private void generateCommands<T>(List<IGeneratedCommand> resultList, IEnumerable<StoryboardCommandList<T>.TypedCommand> commands,
-        //                                  DrawablePropertyInitializer<T> initializeProperty, DrawableTransform<T> transform, bool alwaysInitialize = true)
-        // {
-        //     bool initialized = false;
-        //
-        //     foreach (var command in commands)
-        //     {
-        //         DrawablePropertyInitializer<T>? initFunc = null;
-        //
-        //         if (!initialized)
-        //         {
-        //             if (alwaysInitialize || command.StartTime == command.EndTime)
-        //                 initFunc = initializeProperty;
-        //             initialized = true;
-        //         }
-        //
-        //         resultList.Add(new GeneratedCommand<T>(command, initFunc, transform));
-        //     }
-        // }
     }
 }

From 79da6d861326ca9d6d897d7a0059471a4548d8bf Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 03:07:59 +0300
Subject: [PATCH 313/930] Fix refactor error on `EndTimeForDisplay`

Not sure when this happened >.>
---
 osu.Game/Storyboards/StoryboardSprite.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index f2c011bfca..f961019883 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                double latestEndTime = Commands.StartTime;
+                double latestEndTime = Commands.EndTime;
 
                 foreach (var l in loopingGroups)
                     latestEndTime = Math.Max(latestEndTime, l.StartTime + l.Duration * l.TotalIterations);

From 87b4406bdc01d5ff5a9dd0cbff59fdf4f25f5829 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 09:41:28 +0800
Subject: [PATCH 314/930] Pad at minimum three digits for argon pp display

---
 osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
index 022c1fab9e..c57e7bc7ea 100644
--- a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
@@ -55,7 +56,7 @@ namespace osu.Game.Screens.Play.HUD
 
         private void updateWireframe()
         {
-            int digitsRequiredForDisplayCount = getDigitsRequiredForDisplayCount();
+            int digitsRequiredForDisplayCount = Math.Max(3, getDigitsRequiredForDisplayCount());
 
             if (digitsRequiredForDisplayCount != text.WireframeTemplate.Length)
                 text.WireframeTemplate = new string('#', digitsRequiredForDisplayCount);

From f2753ef7a225316ec96ecb1ca8e1be261d2ca570 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 09:41:38 +0800
Subject: [PATCH 315/930] Decrease size of pp display relative to accuracy

---
 osu.Game/Skinning/ArgonSkin.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/ArgonSkin.cs b/osu.Game/Skinning/ArgonSkin.cs
index 24e17d21f4..953badaf65 100644
--- a/osu.Game/Skinning/ArgonSkin.cs
+++ b/osu.Game/Skinning/ArgonSkin.cs
@@ -232,7 +232,10 @@ namespace osu.Game.Skinning
                                         CornerRadius = { Value = 0.5f }
                                     },
                                     new ArgonAccuracyCounter(),
-                                    new ArgonPerformancePointsCounter(),
+                                    new ArgonPerformancePointsCounter
+                                    {
+                                        Scale = new Vector2(0.8f),
+                                    },
                                     new ArgonComboCounter
                                     {
                                         Scale = new Vector2(1.3f)

From ae2ef8ee1ece9083ca41118dc59846047d021022 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 10:19:00 +0800
Subject: [PATCH 316/930] Fix typo in wireframe description

---
 osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs          | 2 +-
 osu.Game/Screens/Play/HUD/ArgonComboCounter.cs             | 2 +-
 osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs | 2 +-
 osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs             | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs b/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
index 4cc04e1485..d7fe1f52ff 100644
--- a/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonAccuracyCounter.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Screens.Play.HUD
     {
         protected override double RollingDuration => 250;
 
-        [SettingSource("Wireframe opacity", "Controls the opacity of the wire frames behind the digits.")]
+        [SettingSource("Wireframe opacity", "Controls the opacity of the wireframes behind the digits.")]
         public BindableFloat WireframeOpacity { get; } = new BindableFloat(0.25f)
         {
             Precision = 0.01f,
diff --git a/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs b/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
index 3f187650b2..db0480c566 100644
--- a/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonComboCounter.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override double RollingDuration => 250;
 
-        [SettingSource("Wireframe opacity", "Controls the opacity of the wire frames behind the digits.")]
+        [SettingSource("Wireframe opacity", "Controls the opacity of the wireframes behind the digits.")]
         public BindableFloat WireframeOpacity { get; } = new BindableFloat(0.25f)
         {
             Precision = 0.01f,
diff --git a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
index c57e7bc7ea..d4d842bd9a 100644
--- a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Screens.Play.HUD
 
         private const float alpha_when_invalid = 0.3f;
 
-        [SettingSource("Wireframe opacity", "Controls the opacity of the wire frames behind the digits.")]
+        [SettingSource("Wireframe opacity", "Controls the opacity of the wireframes behind the digits.")]
         public BindableFloat WireframeOpacity { get; } = new BindableFloat(0.25f)
         {
             Precision = 0.01f,
diff --git a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
index a14ab3cbcd..8658651407 100644
--- a/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonScoreCounter.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Screens.Play.HUD
 
         protected override double RollingDuration => 250;
 
-        [SettingSource("Wireframe opacity", "Controls the opacity of the wire frames behind the digits.")]
+        [SettingSource("Wireframe opacity", "Controls the opacity of the wireframes behind the digits.")]
         public BindableFloat WireframeOpacity { get; } = new BindableFloat(0.25f)
         {
             Precision = 0.01f,

From 0ebb12f67f97d82ef8931df095445c1c6542ba08 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 10:23:43 +0800
Subject: [PATCH 317/930] Move skinnable interface specification to
 non-`abstract` classes

---
 osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs    | 3 ++-
 osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs         | 2 +-
 .../Skinning/Triangles/TrianglesPerformancePointsCounter.cs   | 4 +---
 3 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
index d4d842bd9a..1620da2f2e 100644
--- a/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/ArgonPerformancePointsCounter.cs
@@ -9,10 +9,11 @@ using osu.Framework.Graphics.Sprites;
 using osu.Game.Configuration;
 using osu.Game.Localisation.SkinComponents;
 using osu.Game.Resources.Localisation.Web;
+using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Play.HUD
 {
-    public partial class ArgonPerformancePointsCounter : PerformancePointsCounter
+    public partial class ArgonPerformancePointsCounter : PerformancePointsCounter, ISerialisableDrawable
     {
         private ArgonCounterTextComponent text = null!;
 
diff --git a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
index c5ad106bcc..25c1387220 100644
--- a/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
+++ b/osu.Game/Screens/Play/HUD/PerformancePointsCounter.cs
@@ -27,7 +27,7 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Screens.Play.HUD
 {
-    public abstract partial class PerformancePointsCounter : RollingCounter<int>, ISerialisableDrawable
+    public abstract partial class PerformancePointsCounter : RollingCounter<int>
     {
         public bool UsesFixedAnchor { get; set; }
 
diff --git a/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs b/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
index 99da2c0942..d6753a81ba 100644
--- a/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
+++ b/osu.Game/Skinning/Triangles/TrianglesPerformancePointsCounter.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -16,7 +14,7 @@ using osuTK;
 
 namespace osu.Game.Skinning.Triangles
 {
-    public partial class TrianglesPerformancePointsCounter : PerformancePointsCounter
+    public partial class TrianglesPerformancePointsCounter : PerformancePointsCounter, ISerialisableDrawable
     {
         protected override bool IsRollingProportional => true;
 

From 928639863325278dd66fe428bdd10870b9ca0e64 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 10:26:08 +0800
Subject: [PATCH 318/930] Move naming migrations to more correct place

---
 osu.Game/Skinning/Skin.cs | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Skinning/Skin.cs b/osu.Game/Skinning/Skin.cs
index 91b21f0308..e4ca908d90 100644
--- a/osu.Game/Skinning/Skin.cs
+++ b/osu.Game/Skinning/Skin.cs
@@ -133,6 +133,11 @@ namespace osu.Game.Skinning
 
                     SkinLayoutInfo? layoutInfo = null;
 
+                    // handle namespace changes...
+                    jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.SongProgress", @"osu.Game.Screens.Play.HUD.DefaultSongProgress");
+                    jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.LegacyComboCounter", @"osu.Game.Skinning.LegacyComboCounter");
+                    jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.PerformancePointsCounter", @"osu.Game.Skinning.Triangles.TrianglesPerformancePointsCounter");
+
                     try
                     {
                         // First attempt to deserialise using the new SkinLayoutInfo format
@@ -150,11 +155,6 @@ namespace osu.Game.Skinning
                     // If deserialisation using SkinLayoutInfo fails, attempt to deserialise using the old naked list.
                     if (layoutInfo == null)
                     {
-                        // handle namespace changes...
-                        jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.SongProgress", @"osu.Game.Screens.Play.HUD.DefaultSongProgress");
-                        jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.LegacyComboCounter", @"osu.Game.Skinning.LegacyComboCounter");
-                        jsonContent = jsonContent.Replace(@"osu.Game.Screens.Play.HUD.PerformancePointsCounter", @"osu.Game.Skinning.Triangles.TrianglesPerformancePointsCounter");
-
                         var deserializedContent = JsonConvert.DeserializeObject<IEnumerable<SerialisedDrawableInfo>>(jsonContent);
 
                         if (deserializedContent == null)

From fcc35a6accce8c849ec1de154d01e4fffa7ebc4a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 11:37:13 +0800
Subject: [PATCH 319/930] Fix cross-talk between pooled `DrawableSliderRepeat`
 usage causing incorrect rotation

---
 osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
index fcbd0edfe0..27c5278614 100644
--- a/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Drawables/DrawableSliderRepeat.cs
@@ -79,6 +79,7 @@ namespace osu.Game.Rulesets.Osu.Objects.Drawables
             base.OnApply();
 
             Position = HitObject.Position - DrawableSlider.Position;
+            hasRotation = false;
         }
 
         protected override void CheckForResult(bool userTriggered, double timeOffset) => DrawableSlider.SliderInputManager.TryJudgeNestedObject(this, timeOffset);

From 5e7d9ea04ac544b43bb349b99151f2599da5c747 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 13:59:04 +0800
Subject: [PATCH 320/930] Adjust scroll speed back to original

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index a5fc75aea3..dcd78833bd 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -346,7 +346,7 @@ namespace osu.Game.Overlays.Mods
             ScheduleAfterChildren(() =>
             {
                 columnScroll.ScrollToEnd(false);
-                columnScroll.ScrollTo(0, true, 0.0055);
+                columnScroll.ScrollTo(0);
             });
         }
 

From 44d0dc6113a408a15a18025325e55646a2147b14 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 8 Mar 2024 11:05:07 +0100
Subject: [PATCH 321/930] Fix 1px flashlight gaps when gameplay scaling mode is
 active

Closes https://github.com/ppy/osu/issues/27522.

Concerns mostly taiko and catch.

Not much of a proper fix rather than a workaround but it is what it is.
I tried a few other things, including setting `MaskingSmoothness = 0` on
the scaling container itself, to no avail.
---
 osu.Game/Rulesets/Mods/ModFlashlight.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/ModFlashlight.cs b/osu.Game/Rulesets/Mods/ModFlashlight.cs
index c3775b0875..c924915bd0 100644
--- a/osu.Game/Rulesets/Mods/ModFlashlight.cs
+++ b/osu.Game/Rulesets/Mods/ModFlashlight.cs
@@ -7,6 +7,7 @@ using System.Runtime.InteropServices;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Rendering;
 using osu.Framework.Graphics.Rendering.Vertices;
@@ -88,7 +89,13 @@ namespace osu.Game.Rulesets.Mods
             flashlight.Combo.BindTo(Combo);
             flashlight.GetPlayfieldScale = () => drawableRuleset.Playfield.Scale;
 
-            drawableRuleset.Overlays.Add(flashlight);
+            drawableRuleset.Overlays.Add(new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                // workaround for 1px gaps on the edges of the playfield which would sometimes show with "gameplay" screen scaling active.
+                Padding = new MarginPadding(-1),
+                Child = flashlight,
+            });
         }
 
         protected abstract Flashlight CreateFlashlight();

From 46e5bda40c68e15aca0dcbd3d468144d9efe6065 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 8 Mar 2024 19:02:12 +0800
Subject: [PATCH 322/930] Fix test failures

---
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
index 3dca179f2f..075fdd88ca 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModFlashlight.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
                 PassCondition = () =>
                 {
                     var flashlightOverlay = Player.DrawableRuleset.Overlays
-                                                  .OfType<ModFlashlight<OsuHitObject>.Flashlight>()
+                                                  .ChildrenOfType<ModFlashlight<OsuHitObject>.Flashlight>()
                                                   .First();
 
                     return Precision.AlmostEquals(mod.DefaultFlashlightSize * .5f, flashlightOverlay.GetSize());

From ad842b60f5416c83edf0f341575bd80572465b58 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Fri, 8 Mar 2024 21:43:18 +0900
Subject: [PATCH 323/930] Add support for Argon hitsounds

---
 osu.Game/Skinning/ArgonProSkin.cs | 6 ++++--
 osu.Game/Skinning/ArgonSkin.cs    | 5 ++++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/ArgonProSkin.cs b/osu.Game/Skinning/ArgonProSkin.cs
index b753dd8fbe..6ec9945c0e 100644
--- a/osu.Game/Skinning/ArgonProSkin.cs
+++ b/osu.Game/Skinning/ArgonProSkin.cs
@@ -24,9 +24,11 @@ namespace osu.Game.Skinning
         {
             foreach (string lookup in sampleInfo.LookupNames)
             {
-                string remappedLookup = lookup.Replace(@"Gameplay/", @"Gameplay/ArgonPro/");
+                var sample = Samples?.Get(lookup)
+                             ?? Resources.AudioManager?.Samples.Get(lookup.Replace(@"Gameplay/", @"Gameplay/ArgonPro/"))
+                             ?? Resources.AudioManager?.Samples.Get(lookup.Replace(@"Gameplay/", @"Gameplay/Argon/"))
+                             ?? Resources.AudioManager?.Samples.Get(lookup);
 
-                var sample = Samples?.Get(remappedLookup) ?? Resources.AudioManager?.Samples.Get(remappedLookup);
                 if (sample != null)
                     return sample;
             }
diff --git a/osu.Game/Skinning/ArgonSkin.cs b/osu.Game/Skinning/ArgonSkin.cs
index 953badaf65..8fd393fcc5 100644
--- a/osu.Game/Skinning/ArgonSkin.cs
+++ b/osu.Game/Skinning/ArgonSkin.cs
@@ -77,7 +77,10 @@ namespace osu.Game.Skinning
         {
             foreach (string lookup in sampleInfo.LookupNames)
             {
-                var sample = Samples?.Get(lookup) ?? Resources.AudioManager?.Samples.Get(lookup);
+                var sample = Samples?.Get(lookup)
+                             ?? Resources.AudioManager?.Samples.Get(lookup.Replace(@"Gameplay/", @"Gameplay/Argon/"))
+                             ?? Resources.AudioManager?.Samples.Get(lookup);
+
                 if (sample != null)
                     return sample;
             }

From 48c83195677736a41d1bb3b8e8d563247481de72 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 8 Mar 2024 16:01:57 +0100
Subject: [PATCH 324/930] change multiplier to 0.9x

---
 osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
index 4ecb94467e..81973e65cc 100644
--- a/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
+++ b/osu.Game.Rulesets.Taiko/Mods/TaikoModConstantSpeed.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Rulesets.Taiko.Mods
     {
         public override string Name => "Constant Speed";
         public override string Acronym => "CS";
-        public override double ScoreMultiplier => 0.8;
+        public override double ScoreMultiplier => 0.9;
         public override LocalisableString Description => "No more tricky speed changes!";
         public override IconUsage? Icon => FontAwesome.Solid.Equals;
         public override ModType Type => ModType.Conversion;

From a8792b35850c53a5946e6e20176282dc33292075 Mon Sep 17 00:00:00 2001
From: Hivie <rayenattia@gmail.com>
Date: Fri, 8 Mar 2024 16:02:17 +0100
Subject: [PATCH 325/930] better assertion

---
 osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
index c88bbec9bc..ee7acec65c 100644
--- a/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/UI/DrawableTaikoRuleset.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         protected virtual double ComputeTimeRange()
         {
             // Adjust when we're using constant algorithm to not be sluggish.
-            double multiplier = VisualisationMethod == ScrollVisualisationMethod.Overlapping ? 1 : 4 * Beatmap.Difficulty.SliderMultiplier;
+            double multiplier = VisualisationMethod == ScrollVisualisationMethod.Constant ? 4 * Beatmap.Difficulty.SliderMultiplier : 1;
             return PlayfieldAdjustmentContainer.ComputeTimeRange() / multiplier;
         }
 

From 27d78fdb087e0be54973ab40fb02818e747b9e62 Mon Sep 17 00:00:00 2001
From: Jamie Taylor <me@nekodex.net>
Date: Sat, 9 Mar 2024 01:10:28 +0900
Subject: [PATCH 326/930] Add fallback to find spinner samples without a bank
 prefix

---
 osu.Game/Audio/HitSampleInfo.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Audio/HitSampleInfo.cs b/osu.Game/Audio/HitSampleInfo.cs
index 24cb1730bf..f9c93d72ff 100644
--- a/osu.Game/Audio/HitSampleInfo.cs
+++ b/osu.Game/Audio/HitSampleInfo.cs
@@ -80,6 +80,8 @@ namespace osu.Game.Audio
                     yield return $"Gameplay/{Bank}-{Name}{Suffix}";
 
                 yield return $"Gameplay/{Bank}-{Name}";
+
+                yield return $"Gameplay/{Name}";
             }
         }
 

From a85be2a46d574fe62416e7313afa3bfdd3873dd0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 20:22:26 +0300
Subject: [PATCH 327/930] Fix merge conflicts

---
 osu.Game/Storyboards/StoryboardSprite.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index a6312ccb79..944d77e745 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -97,10 +97,10 @@ namespace osu.Game.Storyboards
 
                 // If the logic above fails to find anything or discarded by the fact that there are loops present, latestEndTime will be double.MaxValue
                 // and thus conservativeEndTime will be used.
-                double conservativeEndTime = TimelineGroup.EndTime;
+                double conservativeEndTime = Commands.EndTime;
 
-                foreach (var l in loops)
-                    conservativeEndTime = Math.Max(conservativeEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
+                foreach (var l in loopingGroups)
+                    conservativeEndTime = Math.Max(conservativeEndTime, l.StartTime + l.Duration * l.TotalIterations);
 
                 return Math.Min(latestEndTime, conservativeEndTime);
             }

From c1649b76d638dbe0f32217be7027e7a98b5b6026 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 21:33:46 +0300
Subject: [PATCH 328/930] Reorder command properties to match general format

I had them shuffled around in the middle of the refactor.
---
 .../TestSceneDrawableStoryboardSprite.cs      |  2 +-
 .../Visual/Gameplay/TestSceneLeadIn.cs        | 12 +++---
 .../Gameplay/TestSceneStoryboardWithOutro.cs  |  2 +-
 .../TestSceneMultiSpectatorScreen.cs          |  2 +-
 .../Formats/LegacyStoryboardDecoder.cs        | 28 ++++++-------
 .../Commands/StoryboardAlphaCommand.cs        |  4 +-
 .../StoryboardBlendingParametersCommand.cs    |  4 +-
 .../Commands/StoryboardColourCommand.cs       |  4 +-
 .../Storyboards/Commands/StoryboardCommand.cs |  2 +-
 .../Commands/StoryboardCommandGroup.cs        | 40 +++++++++----------
 .../Commands/StoryboardFlipHCommand.cs        |  4 +-
 .../Commands/StoryboardFlipVCommand.cs        |  4 +-
 .../Commands/StoryboardLoopingGroup.cs        |  2 +-
 .../Commands/StoryboardRotationCommand.cs     |  4 +-
 .../Commands/StoryboardScaleCommand.cs        |  4 +-
 .../Commands/StoryboardVectorScaleCommand.cs  |  4 +-
 .../Commands/StoryboardXCommand.cs            |  4 +-
 .../Commands/StoryboardYCommand.cs            |  4 +-
 18 files changed, 65 insertions(+), 65 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 6209b42cbb..6bfa141d85 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -176,7 +176,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             var sprite = new StoryboardSprite(lookupName, origin, initialPosition);
             var loop = sprite.AddLoopingGroup(Time.Current, 100);
-            loop.AddAlpha(0, 10000, 1, 1, Easing.None);
+            loop.AddAlpha(Easing.None, 0, 10000, 1, 1);
 
             layer.Elements.Clear();
             layer.Add(sprite);
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
index b2196e77b4..5a71369976 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneLeadIn.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
-            sprite.Commands.AddAlpha(firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(Easing.None, firstStoryboardEvent, firstStoryboardEvent + 500, 0, 1);
 
             storyboard.GetLayer("Background").Add(sprite);
 
@@ -73,17 +73,17 @@ namespace osu.Game.Tests.Visual.Gameplay
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
 
             // these should be ignored as we have an alpha visibility blocker proceeding this command.
-            sprite.Commands.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
+            sprite.Commands.AddScale(Easing.None, loop_start_time, -18000, 0, 1);
             var loopGroup = sprite.AddLoopingGroup(loop_start_time, 50);
-            loopGroup.AddScale(loop_start_time, -18000, 0, 1, Easing.None);
+            loopGroup.AddScale(Easing.None, loop_start_time, -18000, 0, 1);
 
             var target = addEventToLoop ? loopGroup : sprite.Commands;
             double loopRelativeOffset = addEventToLoop ? -loop_start_time : 0;
-            target.AddAlpha(loopRelativeOffset + firstStoryboardEvent, loopRelativeOffset + firstStoryboardEvent + 500, 0, 1, Easing.None);
+            target.AddAlpha(Easing.None, loopRelativeOffset + firstStoryboardEvent, loopRelativeOffset + firstStoryboardEvent + 500, 0, 1);
 
             // these should be ignored due to being in the future.
-            sprite.Commands.AddAlpha(18000, 20000, 0, 1, Easing.None);
-            loopGroup.AddAlpha(38000, 40000, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(Easing.None, 18000, 20000, 0, 1);
+            loopGroup.AddAlpha(Easing.None, 38000, 40000, 0, 1);
 
             storyboard.GetLayer("Background").Add(sprite);
 
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
index 8bdb7297fe..aff6139c08 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithOutro.cs
@@ -216,7 +216,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             var storyboard = new Storyboard();
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.Commands.AddAlpha(0, duration, 1, 0, Easing.None);
+            sprite.Commands.AddAlpha(Easing.None, 0, duration, 1, 0);
             storyboard.GetLayer("Background").Add(sprite);
             return storyboard;
         }
diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
index 7cd2e2fdaa..2b17f91e68 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneMultiSpectatorScreen.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Multiplayer
         public void TestIntroStoryboardElement() => testLeadIn(b =>
         {
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.Commands.AddAlpha(-2000, 0, 0, 1, Easing.None);
+            sprite.Commands.AddAlpha(Easing.None, -2000, 0, 0, 1);
             b.Storyboard.GetLayer("Background").Add(sprite);
         });
 
diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index 739e81a2fe..195d59d0eb 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -204,7 +204,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentCommandsGroup?.AddAlpha(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddAlpha(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
@@ -212,7 +212,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentCommandsGroup?.AddScale(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddScale(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
@@ -222,7 +222,7 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                currentCommandsGroup?.AddVectorScale(startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY), easing);
+                                currentCommandsGroup?.AddVectorScale(easing, startTime, endTime, new Vector2(startX, startY), new Vector2(endX, endY));
                                 break;
                             }
 
@@ -230,7 +230,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentCommandsGroup?.AddRotation(startTime, endTime, float.RadiansToDegrees(startValue), float.RadiansToDegrees(endValue), easing);
+                                currentCommandsGroup?.AddRotation(easing, startTime, endTime, float.RadiansToDegrees(startValue), float.RadiansToDegrees(endValue));
                                 break;
                             }
 
@@ -240,8 +240,8 @@ namespace osu.Game.Beatmaps.Formats
                                 float startY = Parsing.ParseFloat(split[5]);
                                 float endX = split.Length > 6 ? Parsing.ParseFloat(split[6]) : startX;
                                 float endY = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startY;
-                                currentCommandsGroup?.AddX(startTime, endTime, startX, endX, easing);
-                                currentCommandsGroup?.AddY(startTime, endTime, startY, endY, easing);
+                                currentCommandsGroup?.AddX(easing, startTime, endTime, startX, endX);
+                                currentCommandsGroup?.AddY(easing, startTime, endTime, startY, endY);
                                 break;
                             }
 
@@ -249,7 +249,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentCommandsGroup?.AddX(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddX(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
@@ -257,7 +257,7 @@ namespace osu.Game.Beatmaps.Formats
                             {
                                 float startValue = Parsing.ParseFloat(split[4]);
                                 float endValue = split.Length > 5 ? Parsing.ParseFloat(split[5]) : startValue;
-                                currentCommandsGroup?.AddY(startTime, endTime, startValue, endValue, easing);
+                                currentCommandsGroup?.AddY(easing, startTime, endTime, startValue, endValue);
                                 break;
                             }
 
@@ -269,9 +269,9 @@ namespace osu.Game.Beatmaps.Formats
                                 float endRed = split.Length > 7 ? Parsing.ParseFloat(split[7]) : startRed;
                                 float endGreen = split.Length > 8 ? Parsing.ParseFloat(split[8]) : startGreen;
                                 float endBlue = split.Length > 9 ? Parsing.ParseFloat(split[9]) : startBlue;
-                                currentCommandsGroup?.AddColour(startTime, endTime,
+                                currentCommandsGroup?.AddColour(easing, startTime, endTime,
                                     new Color4(startRed / 255f, startGreen / 255f, startBlue / 255f, 1),
-                                    new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1), easing);
+                                    new Color4(endRed / 255f, endGreen / 255f, endBlue / 255f, 1));
                                 break;
                             }
 
@@ -282,16 +282,16 @@ namespace osu.Game.Beatmaps.Formats
                                 switch (type)
                                 {
                                     case "A":
-                                        currentCommandsGroup?.AddBlendingParameters(startTime, endTime, BlendingParameters.Additive,
-                                            startTime == endTime ? BlendingParameters.Additive : BlendingParameters.Inherit, easing);
+                                        currentCommandsGroup?.AddBlendingParameters(easing, startTime, endTime, BlendingParameters.Additive,
+                                            startTime == endTime ? BlendingParameters.Additive : BlendingParameters.Inherit);
                                         break;
 
                                     case "H":
-                                        currentCommandsGroup?.AddFlipH(startTime, endTime, true, startTime == endTime, easing);
+                                        currentCommandsGroup?.AddFlipH(easing, startTime, endTime, true, startTime == endTime);
                                         break;
 
                                     case "V":
-                                        currentCommandsGroup?.AddFlipV(startTime, endTime, true, startTime == endTime, easing);
+                                        currentCommandsGroup?.AddFlipV(easing, startTime, endTime, true, startTime == endTime);
                                         break;
                                 }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
index f4a90b372a..1c17da7592 100644
--- a/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardAlphaCommand.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardAlphaCommand : StoryboardCommand<float>
     {
-        public StoryboardAlphaCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardAlphaCommand(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
index 3e2e8bb0e8..9ac6613708 100644
--- a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardBlendingParametersCommand : StoryboardCommand<BlendingParameters>
     {
-        public StoryboardBlendingParametersCommand(double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardBlendingParametersCommand(Easing easing, double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
index 66390eb305..da8a20647c 100644
--- a/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardColourCommand.cs
@@ -9,8 +9,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardColourCommand : StoryboardCommand<Color4>
     {
-        public StoryboardColourCommand(double startTime, double endTime, Color4 startValue, Color4 endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardColourCommand(Easing easing, double startTime, double endTime, Color4 startValue, Color4 endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommand.cs b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
index 4f2f0f04a2..60c28e7833 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommand.cs
@@ -19,7 +19,7 @@ namespace osu.Game.Storyboards.Commands
 
         public double Duration => EndTime - StartTime;
 
-        protected StoryboardCommand(double startTime, double endTime, T startValue, T endValue, Easing easing)
+        protected StoryboardCommand(Easing easing, double startTime, double endTime, T startValue, T endValue)
         {
             if (endTime < startTime)
                 endTime = startTime;
diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
index fb847d2e44..40dd8f78e6 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -45,35 +45,35 @@ namespace osu.Game.Storyboards.Commands
         [JsonIgnore]
         public bool HasCommands { get; private set; }
 
-        public void AddX(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            => AddCommand(X, new StoryboardXCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddX(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            => AddCommand(X, new StoryboardXCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddY(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            => AddCommand(Y, new StoryboardYCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddY(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            => AddCommand(Y, new StoryboardYCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddScale(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            => AddCommand(Scale, new StoryboardScaleCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddScale(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            => AddCommand(Scale, new StoryboardScaleCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddVectorScale(double startTime, double endTime, Vector2 startValue, Vector2 endValue, Easing easing)
-            => AddCommand(VectorScale, new StoryboardVectorScaleCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddVectorScale(Easing easing, double startTime, double endTime, Vector2 startValue, Vector2 endValue)
+            => AddCommand(VectorScale, new StoryboardVectorScaleCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddRotation(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            => AddCommand(Rotation, new StoryboardRotationCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddRotation(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            => AddCommand(Rotation, new StoryboardRotationCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddColour(double startTime, double endTime, Color4 startValue, Color4 endValue, Easing easing)
-            => AddCommand(Colour, new StoryboardColourCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddColour(Easing easing, double startTime, double endTime, Color4 startValue, Color4 endValue)
+            => AddCommand(Colour, new StoryboardColourCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddAlpha(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            => AddCommand(Alpha, new StoryboardAlphaCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddAlpha(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            => AddCommand(Alpha, new StoryboardAlphaCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddBlendingParameters(double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue, Easing easing)
-            => AddCommand(BlendingParameters, new StoryboardBlendingParametersCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddBlendingParameters(Easing easing, double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue)
+            => AddCommand(BlendingParameters, new StoryboardBlendingParametersCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddFlipH(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
-            => AddCommand(FlipH, new StoryboardFlipHCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddFlipH(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
+            => AddCommand(FlipH, new StoryboardFlipHCommand(easing, startTime, endTime, startValue, endValue));
 
-        public void AddFlipV(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
-            => AddCommand(FlipV, new StoryboardFlipVCommand(startTime, endTime, startValue, endValue, easing));
+        public void AddFlipV(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
+            => AddCommand(FlipV, new StoryboardFlipVCommand(easing, startTime, endTime, startValue, endValue));
 
         /// <summary>
         /// Adds the given storyboard <paramref name="command"/> to the target <paramref name="list"/>.
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
index 26aef23226..fa07ff6645 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
@@ -9,8 +9,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardFlipHCommand : StoryboardCommand<bool>
     {
-        public StoryboardFlipHCommand(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardFlipHCommand(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
index 88423da2af..fa6a170c25 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
@@ -9,8 +9,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardFlipVCommand : StoryboardCommand<bool>
     {
-        public StoryboardFlipVCommand(double startTime, double endTime, bool startValue, bool endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardFlipVCommand(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
index e97de84ab7..a886998679 100644
--- a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Storyboards.Commands
                 // In an ideal world, we would multiply the command duration by TotalIterations in command end time.
                 // Unfortunately this would clash with how stable handled end times, and results in some storyboards playing outro
                 // sequences for minutes or hours.
-                : base(loopingGroup.loopStartTime + command.StartTime, loopingGroup.loopStartTime + command.EndTime, command.StartValue, command.EndValue, command.Easing)
+                : base(command.Easing, loopingGroup.loopStartTime + command.StartTime, loopingGroup.loopStartTime + command.EndTime, command.StartValue, command.EndValue)
             {
                 this.command = command;
                 this.loopingGroup = loopingGroup;
diff --git a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
index 4347dc9d77..7e097fce25 100644
--- a/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardRotationCommand.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardRotationCommand : StoryboardCommand<float>
     {
-        public StoryboardRotationCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardRotationCommand(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
index b0f33fd6b8..832533af5e 100644
--- a/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardScaleCommand.cs
@@ -9,8 +9,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardScaleCommand : StoryboardCommand<float>
     {
-        public StoryboardScaleCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardScaleCommand(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
index 5d3fef5948..06983a1590 100644
--- a/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardVectorScaleCommand.cs
@@ -10,8 +10,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardVectorScaleCommand : StoryboardCommand<Vector2>
     {
-        public StoryboardVectorScaleCommand(double startTime, double endTime, Vector2 startValue, Vector2 endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardVectorScaleCommand(Easing easing, double startTime, double endTime, Vector2 startValue, Vector2 endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
index 7df9a75768..d52e9c8a05 100644
--- a/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardXCommand.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardXCommand : StoryboardCommand<float>
     {
-        public StoryboardXCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardXCommand(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 
diff --git a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
index d7dc32a0f3..90dfe4d995 100644
--- a/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardYCommand.cs
@@ -8,8 +8,8 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardYCommand : StoryboardCommand<float>
     {
-        public StoryboardYCommand(double startTime, double endTime, float startValue, float endValue, Easing easing)
-            : base(startTime, endTime, startValue, endValue, easing)
+        public StoryboardYCommand(Easing easing, double startTime, double endTime, float startValue, float endValue)
+            : base(easing, startTime, endTime, startValue, endValue)
         {
         }
 

From 0efa12a86a5b3f19251e90b65f80f523a9ded5bc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 21:52:56 +0300
Subject: [PATCH 329/930] Fix parameter commands applying initial value before
 start time

---
 osu.Game/Storyboards/Commands/IStoryboardCommand.cs         | 3 +++
 .../Commands/StoryboardBlendingParametersCommand.cs         | 6 +++++-
 osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs     | 6 +++++-
 osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs     | 6 +++++-
 4 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
index 6efb19afe4..ea14f5fa40 100644
--- a/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
+++ b/osu.Game/Storyboards/Commands/IStoryboardCommand.cs
@@ -28,6 +28,9 @@ namespace osu.Game.Storyboards.Commands
         /// <summary>
         /// Sets the value of the corresponding property in <see cref="Drawable"/> to the start value of this command.
         /// </summary>
+        /// <remarks>
+        /// Parameter commands (e.g. <see cref="StoryboardFlipHCommand"/> / <see cref="StoryboardFlipVCommand"/> / <see cref="StoryboardBlendingParametersCommand"/>) only apply the start value if they have zero duration, i.e. take "permanent" effect regardless of time.
+        /// </remarks>
         /// <param name="d">The target drawable.</param>
         void ApplyInitialValue<TDrawable>(TDrawable d)
             where TDrawable : Drawable, IFlippable, IVectorScalable;
diff --git a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
index 9ac6613708..cf9cadf1a7 100644
--- a/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardBlendingParametersCommand.cs
@@ -15,7 +15,11 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(Drawable.Blending);
 
-        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.Blending = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d)
+        {
+            if (StartTime == EndTime)
+                d.Blending = StartValue;
+        }
 
         public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.TransformTo(nameof(d.Blending), StartValue).Delay(Duration)
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
index fa07ff6645..fbf7295f15 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipHCommand.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(IFlippable.FlipH);
 
-        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.FlipH = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d)
+        {
+            if (StartTime == EndTime)
+                d.FlipH = StartValue;
+        }
 
         public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.TransformTo(nameof(IFlippable.FlipH), StartValue).Delay(Duration)
diff --git a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
index fa6a170c25..136bd52f1f 100644
--- a/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardFlipVCommand.cs
@@ -16,7 +16,11 @@ namespace osu.Game.Storyboards.Commands
 
         public override string PropertyName => nameof(IFlippable.FlipV);
 
-        public override void ApplyInitialValue<TDrawable>(TDrawable d) => d.FlipV = StartValue;
+        public override void ApplyInitialValue<TDrawable>(TDrawable d)
+        {
+            if (StartTime == EndTime)
+                d.FlipV = StartValue;
+        }
 
         public override TransformSequence<TDrawable> ApplyTransforms<TDrawable>(TDrawable d)
             => d.TransformTo(nameof(IFlippable.FlipV), StartValue).Delay(Duration)

From 6861d9a302f2995ac05ff717e8911d9eabe3e25b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 22:28:13 +0300
Subject: [PATCH 330/930] Expose storyboard command lists as read-only and
 remove unnecessary memory footprint

Mutation should be done only with the methods exposed by `StoryboardCommandGroup`.
---
 .../Commands/StoryboardCommandGroup.cs        | 80 +++++++++++++------
 1 file changed, 57 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
index 40dd8f78e6..0925231412 100644
--- a/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardCommandGroup.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Linq;
 using Newtonsoft.Json;
 using osu.Framework.Graphics;
 using osu.Framework.Lists;
@@ -12,20 +13,45 @@ namespace osu.Game.Storyboards.Commands
 {
     public class StoryboardCommandGroup
     {
-        public SortedList<StoryboardCommand<float>> X = new SortedList<StoryboardCommand<float>>();
-        public SortedList<StoryboardCommand<float>> Y = new SortedList<StoryboardCommand<float>>();
-        public SortedList<StoryboardCommand<float>> Scale = new SortedList<StoryboardCommand<float>>();
-        public SortedList<StoryboardCommand<Vector2>> VectorScale = new SortedList<StoryboardCommand<Vector2>>();
-        public SortedList<StoryboardCommand<float>> Rotation = new SortedList<StoryboardCommand<float>>();
-        public SortedList<StoryboardCommand<Color4>> Colour = new SortedList<StoryboardCommand<Color4>>();
-        public SortedList<StoryboardCommand<float>> Alpha = new SortedList<StoryboardCommand<float>>();
-        public SortedList<StoryboardCommand<BlendingParameters>> BlendingParameters = new SortedList<StoryboardCommand<BlendingParameters>>();
-        public SortedList<StoryboardCommand<bool>> FlipH = new SortedList<StoryboardCommand<bool>>();
-        public SortedList<StoryboardCommand<bool>> FlipV = new SortedList<StoryboardCommand<bool>>();
+        private readonly SortedList<StoryboardCommand<float>> x = new SortedList<StoryboardCommand<float>>();
 
-        public IReadOnlyList<IStoryboardCommand> AllCommands => allCommands;
+        public IReadOnlyList<StoryboardCommand<float>> X => x;
 
-        private readonly List<IStoryboardCommand> allCommands = new List<IStoryboardCommand>();
+        private readonly SortedList<StoryboardCommand<float>> y = new SortedList<StoryboardCommand<float>>();
+
+        public IReadOnlyList<StoryboardCommand<float>> Y => y;
+
+        private readonly SortedList<StoryboardCommand<float>> scale = new SortedList<StoryboardCommand<float>>();
+
+        public IReadOnlyList<StoryboardCommand<float>> Scale => scale;
+
+        private readonly SortedList<StoryboardCommand<Vector2>> vectorScale = new SortedList<StoryboardCommand<Vector2>>();
+
+        public IReadOnlyList<StoryboardCommand<Vector2>> VectorScale => vectorScale;
+
+        private readonly SortedList<StoryboardCommand<float>> rotation = new SortedList<StoryboardCommand<float>>();
+
+        public IReadOnlyList<StoryboardCommand<float>> Rotation => rotation;
+
+        private readonly SortedList<StoryboardCommand<Color4>> colour = new SortedList<StoryboardCommand<Color4>>();
+
+        public IReadOnlyList<StoryboardCommand<Color4>> Colour => colour;
+
+        private readonly SortedList<StoryboardCommand<float>> alpha = new SortedList<StoryboardCommand<float>>();
+
+        public IReadOnlyList<StoryboardCommand<float>> Alpha => alpha;
+
+        private readonly SortedList<StoryboardCommand<BlendingParameters>> blendingParameters = new SortedList<StoryboardCommand<BlendingParameters>>();
+
+        public IReadOnlyList<StoryboardCommand<BlendingParameters>> BlendingParameters => blendingParameters;
+
+        private readonly SortedList<StoryboardCommand<bool>> flipH = new SortedList<StoryboardCommand<bool>>();
+
+        public IReadOnlyList<StoryboardCommand<bool>> FlipH => flipH;
+
+        private readonly SortedList<StoryboardCommand<bool>> flipV = new SortedList<StoryboardCommand<bool>>();
+
+        public IReadOnlyList<StoryboardCommand<bool>> FlipV => flipV;
 
         /// <summary>
         /// Returns the earliest start time of the commands added to this group.
@@ -45,35 +71,44 @@ namespace osu.Game.Storyboards.Commands
         [JsonIgnore]
         public bool HasCommands { get; private set; }
 
+        private readonly IReadOnlyList<IStoryboardCommand>[] lists;
+
+        public IEnumerable<IStoryboardCommand> AllCommands => lists.SelectMany(g => g);
+
+        public StoryboardCommandGroup()
+        {
+            lists = new IReadOnlyList<IStoryboardCommand>[] { X, Y, Scale, VectorScale, Rotation, Colour, Alpha, BlendingParameters, FlipH, FlipV };
+        }
+
         public void AddX(Easing easing, double startTime, double endTime, float startValue, float endValue)
-            => AddCommand(X, new StoryboardXCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(x, new StoryboardXCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddY(Easing easing, double startTime, double endTime, float startValue, float endValue)
-            => AddCommand(Y, new StoryboardYCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(y, new StoryboardYCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddScale(Easing easing, double startTime, double endTime, float startValue, float endValue)
-            => AddCommand(Scale, new StoryboardScaleCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(scale, new StoryboardScaleCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddVectorScale(Easing easing, double startTime, double endTime, Vector2 startValue, Vector2 endValue)
-            => AddCommand(VectorScale, new StoryboardVectorScaleCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(vectorScale, new StoryboardVectorScaleCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddRotation(Easing easing, double startTime, double endTime, float startValue, float endValue)
-            => AddCommand(Rotation, new StoryboardRotationCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(rotation, new StoryboardRotationCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddColour(Easing easing, double startTime, double endTime, Color4 startValue, Color4 endValue)
-            => AddCommand(Colour, new StoryboardColourCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(colour, new StoryboardColourCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddAlpha(Easing easing, double startTime, double endTime, float startValue, float endValue)
-            => AddCommand(Alpha, new StoryboardAlphaCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(alpha, new StoryboardAlphaCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddBlendingParameters(Easing easing, double startTime, double endTime, BlendingParameters startValue, BlendingParameters endValue)
-            => AddCommand(BlendingParameters, new StoryboardBlendingParametersCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(blendingParameters, new StoryboardBlendingParametersCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddFlipH(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
-            => AddCommand(FlipH, new StoryboardFlipHCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(flipH, new StoryboardFlipHCommand(easing, startTime, endTime, startValue, endValue));
 
         public void AddFlipV(Easing easing, double startTime, double endTime, bool startValue, bool endValue)
-            => AddCommand(FlipV, new StoryboardFlipVCommand(easing, startTime, endTime, startValue, endValue));
+            => AddCommand(flipV, new StoryboardFlipVCommand(easing, startTime, endTime, startValue, endValue));
 
         /// <summary>
         /// Adds the given storyboard <paramref name="command"/> to the target <paramref name="list"/>.
@@ -83,7 +118,6 @@ namespace osu.Game.Storyboards.Commands
         protected virtual void AddCommand<T>(ICollection<StoryboardCommand<T>> list, StoryboardCommand<T> command)
         {
             list.Add(command);
-            allCommands.Add(command);
             HasCommands = true;
 
             if (command.StartTime < StartTime)

From 1942d46a38fac400e28dbe95a3d5a2d6c0a95cc2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 22:37:27 +0300
Subject: [PATCH 331/930] Remove leftover debugging code

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index 507a51aca4..da4b5c641d 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -102,9 +102,6 @@ namespace osu.Game.Storyboards.Drawables
             else
                 Texture = textureStore.Get(Sprite.Path);
 
-            if (Sprite.Path == "SB/textbox.png")
-                Debugger.Break();
-
             Sprite.ApplyTransforms(this);
         }
 

From 8c92bb0595f6528c86c39a0851fd7e6edd8be5f6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 23:09:16 +0300
Subject: [PATCH 332/930] Remove unused using directive

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index da4b5c641d..ec875219b6 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;

From 9f71eac1dbe26df48cdcdaff181a0ca6be71f219 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 8 Mar 2024 23:09:50 +0300
Subject: [PATCH 333/930] Remove extra end line

---
 osu.Game/Storyboards/StoryboardSprite.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 944d77e745..80a76cd831 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -195,4 +195,3 @@ namespace osu.Game.Storyboards
         public override string ToString() => $"{Path}, {Origin}, {InitialPosition}";
     }
 }
-

From db1c59475b0e31fd17d6944804c23a65b206c756 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Fri, 9 Feb 2024 15:10:45 -0800
Subject: [PATCH 334/930] Wrap beatmap listing filters and match web spacing

---
 .../BeatmapListingSearchControl.cs            |  1 +
 .../BeatmapListing/BeatmapSearchFilterRow.cs  | 37 ++++---------------
 ...BeatmapSearchMultipleSelectionFilterRow.cs |  4 +-
 .../Overlays/BeatmapListing/FilterTabItem.cs  |  2 -
 4 files changed, 9 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
index 3fa0fc7a77..bab64165cb 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingSearchControl.cs
@@ -128,6 +128,7 @@ namespace osu.Game.Overlays.BeatmapListing
                                 RelativeSizeAxes = Axes.X,
                                 Direction = FillDirection.Vertical,
                                 Padding = new MarginPadding { Horizontal = 10 },
+                                Spacing = new Vector2(5),
                                 Children = new Drawable[]
                                 {
                                     generalFilter = new BeatmapSearchGeneralFilterRow(),
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
index 6d75521cb0..f79695a123 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
@@ -1,14 +1,12 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
 using osuTK;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Localisation;
@@ -49,8 +47,6 @@ namespace osu.Game.Overlays.BeatmapListing
                     {
                         new OsuSpriteText
                         {
-                            Anchor = Anchor.BottomLeft,
-                            Origin = Anchor.BottomLeft,
                             Font = OsuFont.GetFont(size: 13),
                             Text = header
                         },
@@ -69,10 +65,8 @@ namespace osu.Game.Overlays.BeatmapListing
         {
             public BeatmapSearchFilter()
             {
-                Anchor = Anchor.BottomLeft;
-                Origin = Anchor.BottomLeft;
                 RelativeSizeAxes = Axes.X;
-                Height = 15;
+                AutoSizeAxes = Axes.Y;
 
                 TabContainer.Spacing = new Vector2(10, 0);
 
@@ -83,33 +77,16 @@ namespace osu.Game.Overlays.BeatmapListing
                 }
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OverlayColourProvider colourProvider)
-            {
-                if (Dropdown is FilterDropdown fd)
-                    fd.AccentColour = colourProvider.Light2;
-            }
-
-            protected override Dropdown<T> CreateDropdown() => new FilterDropdown();
+            protected override Dropdown<T> CreateDropdown() => null!;
 
             protected override TabItem<T> CreateTabItem(T value) => new FilterTabItem<T>(value);
 
-            private partial class FilterDropdown : OsuTabDropdown<T>
+            protected override TabFillFlowContainer CreateTabFlow() => new TabFillFlowContainer
             {
-                protected override DropdownHeader CreateHeader() => new FilterHeader
-                {
-                    Anchor = Anchor.TopRight,
-                    Origin = Anchor.TopRight
-                };
-
-                private partial class FilterHeader : OsuTabDropdownHeader
-                {
-                    public FilterHeader()
-                    {
-                        Background.Height = 1;
-                    }
-                }
-            }
+                RelativeSizeAxes = Axes.X,
+                AutoSizeAxes = Axes.Y,
+                AllowMultiline = true,
+            };
         }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index abd2643a41..e59beb43ff 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -52,10 +52,8 @@ namespace osu.Game.Overlays.BeatmapListing
             [BackgroundDependencyLoader]
             private void load()
             {
-                Anchor = Anchor.BottomLeft;
-                Origin = Anchor.BottomLeft;
                 RelativeSizeAxes = Axes.X;
-                Height = 15;
+                AutoSizeAxes = Axes.Y;
                 Spacing = new Vector2(10, 0);
 
                 AddRange(GetValues().Select(CreateTabItem));
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index c33d5056fa..831cf812ff 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -33,8 +33,6 @@ namespace osu.Game.Overlays.BeatmapListing
         private void load()
         {
             AutoSizeAxes = Axes.Both;
-            Anchor = Anchor.BottomLeft;
-            Origin = Anchor.BottomLeft;
             AddRangeInternal(new Drawable[]
             {
                 text = new OsuSpriteText

From 26c97ef73314a5e307beb5b1b2b755fa78188dc7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 9 Mar 2024 00:51:33 +0300
Subject: [PATCH 335/930] Fix WikiPanelContainer causing poor performance

---
 osu.Game/Overlays/Wiki/WikiPanelContainer.cs | 68 +++++++++++++-------
 1 file changed, 43 insertions(+), 25 deletions(-)

diff --git a/osu.Game/Overlays/Wiki/WikiPanelContainer.cs b/osu.Game/Overlays/Wiki/WikiPanelContainer.cs
index cbffe5732e..555dab852e 100644
--- a/osu.Game/Overlays/Wiki/WikiPanelContainer.cs
+++ b/osu.Game/Overlays/Wiki/WikiPanelContainer.cs
@@ -3,7 +3,6 @@
 
 #nullable disable
 
-using System;
 using Markdig.Syntax;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -22,29 +21,61 @@ using osuTK.Graphics;
 
 namespace osu.Game.Overlays.Wiki
 {
-    public partial class WikiPanelContainer : Container
+    public partial class WikiPanelContainer : CompositeDrawable
     {
-        private WikiPanelMarkdownContainer panelContainer;
+        private const float padding = 3;
 
         private readonly string text;
-
         private readonly bool isFullWidth;
 
         public WikiPanelContainer(string text, bool isFullWidth = false)
         {
             this.text = text;
             this.isFullWidth = isFullWidth;
-
-            RelativeSizeAxes = Axes.X;
-            Padding = new MarginPadding(3);
         }
 
+        private PanelBackground background;
+
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, IAPIProvider api)
+        private void load(IAPIProvider api)
         {
-            Children = new Drawable[]
+            RelativeSizeAxes = Axes.X;
+            AutoSizeAxes = Axes.Y;
+            InternalChildren = new Drawable[]
             {
+                background = new PanelBackground
+                {
+                    BypassAutoSizeAxes = Axes.Both
+                },
                 new Container
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding(padding),
+                    Child = new WikiPanelMarkdownContainer(isFullWidth)
+                    {
+                        CurrentPath = $@"{api.WebsiteRootUrl}/wiki/",
+                        Text = text,
+                        RelativeSizeAxes = Axes.X,
+                        AutoSizeAxes = Axes.Y
+                    }
+                }
+            };
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+            background.Size = Parent!.DrawSize * new Vector2(Size.X, 1);
+        }
+
+        private partial class PanelBackground : CompositeDrawable
+        {
+            [BackgroundDependencyLoader]
+            private void load(OverlayColourProvider colourProvider)
+            {
+                Padding = new MarginPadding(padding);
+                InternalChild = new Container
                 {
                     RelativeSizeAxes = Axes.Both,
                     Masking = true,
@@ -60,22 +91,9 @@ namespace osu.Game.Overlays.Wiki
                     {
                         Colour = colourProvider.Background4,
                         RelativeSizeAxes = Axes.Both,
-                    },
-                },
-                panelContainer = new WikiPanelMarkdownContainer(isFullWidth)
-                {
-                    CurrentPath = $@"{api.WebsiteRootUrl}/wiki/",
-                    Text = text,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                }
-            };
-        }
-
-        protected override void Update()
-        {
-            base.Update();
-            Height = Math.Max(panelContainer.Height, Parent!.DrawHeight);
+                    }
+                };
+            }
         }
 
         private partial class WikiPanelMarkdownContainer : WikiMarkdownContainer

From 82048df9f16607c8b9887ddf91cf880fdb5927c3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 9 Mar 2024 04:42:17 +0300
Subject: [PATCH 336/930] Add basic test scene for asserting storyboard
 commands behaviour

Pending actual test coverage.
---
 .../Gameplay/TestSceneStoryboardCommands.cs   | 166 ++++++++++++++++++
 1 file changed, 166 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
new file mode 100644
index 0000000000..1893182b32
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
@@ -0,0 +1,166 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.IO.Stores;
+using osu.Framework.Timing;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Storyboards;
+using osu.Game.Storyboards.Drawables;
+using osu.Game.Tests.Resources;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public partial class TestSceneStoryboardCommands : OsuTestScene
+    {
+        [Cached(typeof(Storyboard))]
+        private TestStoryboard storyboard { get; set; } = new TestStoryboard
+        {
+            UseSkinSprites = false,
+            AlwaysProvideTexture = true,
+        };
+
+        private readonly ManualClock manualClock = new ManualClock { Rate = 1, IsRunning = true };
+        private bool forward;
+
+        private const string lookup_name = "hitcircleoverlay";
+        private const double clock_limit = 2500;
+
+        protected override Container<Drawable> Content => content;
+
+        private Container content = null!;
+        private SpriteText timelineText = null!;
+        private Box timelineMarker = null!;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            base.Content.Children = new Drawable[]
+            {
+                content = new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                },
+                timelineText = new OsuSpriteText
+                {
+                    Anchor = Anchor.BottomLeft,
+                    Origin = Anchor.BottomLeft,
+                    Margin = new MarginPadding { Bottom = 60 },
+                },
+                timelineMarker = new Box
+                {
+                    Anchor = Anchor.BottomLeft,
+                    Origin = Anchor.BottomCentre,
+                    RelativePositionAxes = Axes.X,
+                    Size = new Vector2(2, 50),
+                },
+            };
+        }
+
+        [SetUp]
+        public void SetUp()
+        {
+            manualClock.CurrentTime = 0;
+            forward = true;
+        }
+
+        [Test]
+        public void TestLoop()
+        {
+            AddStep("create sprite", () => Child = createSprite(s =>
+            {
+                var loop = s.AddLoopingGroup(600, 10);
+                loop.AddY(Easing.OutBounce, 0, 500, 100, 240);
+                loop.AddY(Easing.OutQuint, 700, 1000, 240, 100);
+            }));
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (manualClock.CurrentTime > clock_limit || manualClock.CurrentTime < 0)
+                forward = !forward;
+
+            manualClock.CurrentTime += Time.Elapsed * (forward ? 1 : -1);
+            timelineText.Text = $"Time: {manualClock.CurrentTime:0}ms";
+            timelineMarker.X = (float)(manualClock.CurrentTime / clock_limit);
+        }
+
+        private DrawableStoryboard createSprite(Action<StoryboardSprite>? addCommands = null)
+        {
+            var layer = storyboard.GetLayer("Background");
+
+            var sprite = new StoryboardSprite(lookup_name, Anchor.Centre, new Vector2(320, 240));
+            sprite.Commands.AddScale(Easing.None, 0, clock_limit, 0.5f, 0.5f);
+            sprite.Commands.AddAlpha(Easing.None, 0, clock_limit, 1, 1);
+            addCommands?.Invoke(sprite);
+
+            layer.Elements.Clear();
+            layer.Add(sprite);
+
+            return storyboard.CreateDrawable().With(c => c.Clock = new FramedClock(manualClock));
+        }
+
+        private partial class TestStoryboard : Storyboard
+        {
+            public override DrawableStoryboard CreateDrawable(IReadOnlyList<Mod>? mods = null)
+            {
+                return new TestDrawableStoryboard(this, mods);
+            }
+
+            public bool AlwaysProvideTexture { get; set; }
+
+            public override string GetStoragePathFromStoryboardPath(string path) => AlwaysProvideTexture ? path : string.Empty;
+
+            private partial class TestDrawableStoryboard : DrawableStoryboard
+            {
+                private readonly bool alwaysProvideTexture;
+
+                public TestDrawableStoryboard(TestStoryboard storyboard, IReadOnlyList<Mod>? mods)
+                    : base(storyboard, mods)
+                {
+                    alwaysProvideTexture = storyboard.AlwaysProvideTexture;
+                }
+
+                protected override IResourceStore<byte[]> CreateResourceLookupStore() => alwaysProvideTexture
+                    ? new AlwaysReturnsTextureStore()
+                    : new ResourceStore<byte[]>();
+
+                internal class AlwaysReturnsTextureStore : IResourceStore<byte[]>
+                {
+                    private const string test_image = "Resources/Textures/test-image.png";
+
+                    private readonly DllResourceStore store;
+
+                    public AlwaysReturnsTextureStore()
+                    {
+                        store = TestResources.GetStore();
+                    }
+
+                    public void Dispose() => store.Dispose();
+
+                    public byte[] Get(string name) => store.Get(test_image);
+
+                    public Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = new CancellationToken()) => store.GetAsync(test_image, cancellationToken);
+
+                    public Stream GetStream(string name) => store.GetStream(test_image);
+
+                    public IEnumerable<string> GetAvailableResources() => store.GetAvailableResources();
+                }
+            }
+        }
+    }
+}

From dd36942508aee46ff0b0357daed108f293260924 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 9 Mar 2024 13:58:05 +0300
Subject: [PATCH 337/930] Reduce allocations in DrawableFlag tooltip

---
 osu.Game/Users/Drawables/DrawableFlag.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Users/Drawables/DrawableFlag.cs b/osu.Game/Users/Drawables/DrawableFlag.cs
index 289f68ee7f..08c323d42c 100644
--- a/osu.Game/Users/Drawables/DrawableFlag.cs
+++ b/osu.Game/Users/Drawables/DrawableFlag.cs
@@ -15,11 +15,14 @@ namespace osu.Game.Users.Drawables
     {
         private readonly CountryCode countryCode;
 
-        public LocalisableString TooltipText => countryCode == CountryCode.Unknown ? string.Empty : countryCode.GetDescription();
+        public LocalisableString TooltipText => countryCode == CountryCode.Unknown ? string.Empty : description;
+
+        private readonly string description;
 
         public DrawableFlag(CountryCode countryCode)
         {
             this.countryCode = countryCode;
+            description = countryCode.GetDescription();
         }
 
         [BackgroundDependencyLoader]

From 58b6acde10eee69faedd57fcf5c6f1869eb8fba7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 9 Mar 2024 14:10:32 +0300
Subject: [PATCH 338/930] Further simplify tooltip text creation

---
 osu.Game/Users/Drawables/DrawableFlag.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Users/Drawables/DrawableFlag.cs b/osu.Game/Users/Drawables/DrawableFlag.cs
index 08c323d42c..39f0ab370b 100644
--- a/osu.Game/Users/Drawables/DrawableFlag.cs
+++ b/osu.Game/Users/Drawables/DrawableFlag.cs
@@ -15,14 +15,14 @@ namespace osu.Game.Users.Drawables
     {
         private readonly CountryCode countryCode;
 
-        public LocalisableString TooltipText => countryCode == CountryCode.Unknown ? string.Empty : description;
+        public LocalisableString TooltipText => tooltipText;
 
-        private readonly string description;
+        private readonly string tooltipText;
 
         public DrawableFlag(CountryCode countryCode)
         {
             this.countryCode = countryCode;
-            description = countryCode.GetDescription();
+            tooltipText = countryCode == CountryCode.Unknown ? string.Empty : countryCode.GetDescription();
         }
 
         [BackgroundDependencyLoader]

From b8a362fcb69390fb774bcb5a4afc78bb138ddf7e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 9 Mar 2024 20:17:27 +0800
Subject: [PATCH 339/930] Simplify assignment by using an auto property

---
 osu.Game/Users/Drawables/DrawableFlag.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Users/Drawables/DrawableFlag.cs b/osu.Game/Users/Drawables/DrawableFlag.cs
index 39f0ab370b..6813b13cef 100644
--- a/osu.Game/Users/Drawables/DrawableFlag.cs
+++ b/osu.Game/Users/Drawables/DrawableFlag.cs
@@ -15,14 +15,12 @@ namespace osu.Game.Users.Drawables
     {
         private readonly CountryCode countryCode;
 
-        public LocalisableString TooltipText => tooltipText;
-
-        private readonly string tooltipText;
+        public LocalisableString TooltipText { get; }
 
         public DrawableFlag(CountryCode countryCode)
         {
             this.countryCode = countryCode;
-            tooltipText = countryCode == CountryCode.Unknown ? string.Empty : countryCode.GetDescription();
+            TooltipText = countryCode == CountryCode.Unknown ? string.Empty : countryCode.GetDescription();
         }
 
         [BackgroundDependencyLoader]

From 31739be49912ffedf1ae7a4deeb747b8b2ec9204 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 9 Mar 2024 20:46:48 +0800
Subject: [PATCH 340/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index b143a3a6b1..55bd68dea0 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.7.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.207.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.309.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From 549a8d678e4a9d8c91a1a220bef6f3519aaa687d Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 9 Mar 2024 20:50:54 +0300
Subject: [PATCH 341/930] Reduce allocations in ControlPointList

---
 .../Screens/Edit/Timing/ControlPointList.cs   | 27 +++++++++++++++----
 1 file changed, 22 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Timing/ControlPointList.cs b/osu.Game/Screens/Edit/Timing/ControlPointList.cs
index 7cd1dbc630..4e4090ccd0 100644
--- a/osu.Game/Screens/Edit/Timing/ControlPointList.cs
+++ b/osu.Game/Screens/Edit/Timing/ControlPointList.cs
@@ -162,26 +162,43 @@ namespace osu.Game.Screens.Edit.Timing
 
                     // If the selected group only has one control point, update the tracking type.
                     case 1:
-                        trackedType = selectedGroup.Value?.ControlPoints.Single().GetType();
+                        trackedType = selectedGroup.Value?.ControlPoints[0].GetType();
                         break;
 
                     // If the selected group has more than one control point, choose the first as the tracking type
                     // if we don't already have a singular tracked type.
                     default:
-                        trackedType ??= selectedGroup.Value?.ControlPoints.FirstOrDefault()?.GetType();
+                        trackedType ??= selectedGroup.Value?.ControlPoints[0].GetType();
                         break;
                 }
             }
 
             if (trackedType != null)
             {
+                double accurateTime = clock.CurrentTimeAccurate;
+
                 // We don't have an efficient way of looking up groups currently, only individual point types.
                 // To improve the efficiency of this in the future, we should reconsider the overall structure of ControlPointInfo.
 
                 // Find the next group which has the same type as the selected one.
-                var found = Beatmap.ControlPointInfo.Groups
-                                   .Where(g => g.ControlPoints.Any(cp => cp.GetType() == trackedType))
-                                   .LastOrDefault(g => g.Time <= clock.CurrentTimeAccurate);
+                ControlPointGroup? found = null;
+
+                for (int i = 0; i < Beatmap.ControlPointInfo.Groups.Count; i++)
+                {
+                    var g = Beatmap.ControlPointInfo.Groups[i];
+
+                    if (g.Time > accurateTime)
+                        continue;
+
+                    for (int j = 0; j < g.ControlPoints.Count; j++)
+                    {
+                        if (g.ControlPoints[j].GetType() == trackedType)
+                        {
+                            found = g;
+                            break;
+                        }
+                    }
+                }
 
                 if (found != null)
                     selectedGroup.Value = found;

From e08651668c46f3c7cbef87b2fadd23d609e9fee2 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 9 Mar 2024 21:55:00 +0300
Subject: [PATCH 342/930] Fix TestSceneSkinnableSound failing

---
 osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
index 3f78dbfd96..6c8dc6a220 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneSkinnableSound.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private TestSkinSourceContainer skinSource = null!;
         private PausableSkinnableSound skinnableSound = null!;
 
-        private const string sample_lookup = "Gameplay/normal-sliderslide";
+        private const string sample_lookup = "Gameplay/Argon/normal-sliderslide";
 
         [SetUpSteps]
         public void SetUpSteps()

From 8a1c5a754763cb8cc25963ab0e5b3439683a357a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 10 Mar 2024 07:23:22 +0300
Subject: [PATCH 343/930] Adjust time values

---
 .../Visual/Gameplay/TestSceneStoryboardCommands.cs          | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
index 1893182b32..11c07824d3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
@@ -81,9 +81,9 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             AddStep("create sprite", () => Child = createSprite(s =>
             {
-                var loop = s.AddLoopingGroup(600, 10);
-                loop.AddY(Easing.OutBounce, 0, 500, 100, 240);
-                loop.AddY(Easing.OutQuint, 700, 1000, 240, 100);
+                var loop = s.AddLoopingGroup(500, 10);
+                loop.AddY(Easing.OutBounce, 0, 600, 100, 240);
+                loop.AddY(Easing.OutQuint, 800, 1200, 240, 100);
             }));
         }
 

From d039b565621790c8df3b5eaf0243deaa0cd9d5bb Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 10 Mar 2024 07:26:27 +0300
Subject: [PATCH 344/930] Add test case for running with high number of loops

---
 .../Visual/Gameplay/TestSceneStoryboardCommands.cs    | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
index 11c07824d3..1392cc3a21 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
@@ -87,6 +87,17 @@ namespace osu.Game.Tests.Visual.Gameplay
             }));
         }
 
+        [Test]
+        public void TestLoopManyTimes()
+        {
+            AddStep("create sprite", () => Child = createSprite(s =>
+            {
+                var loop = s.AddLoopingGroup(500, 10000);
+                loop.AddY(Easing.OutBounce, 0, 60, 100, 240);
+                loop.AddY(Easing.OutQuint, 80, 120, 240, 100);
+            }));
+        }
+
         protected override void Update()
         {
             base.Update();

From 99b06102b1bb67cd13c2e582c9796212d31c65d1 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 10 Mar 2024 09:01:31 +0300
Subject: [PATCH 345/930] Add enough test coverage

---
 .../Gameplay/TestSceneStoryboardCommands.cs   | 115 +++++++++++++++---
 1 file changed, 101 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
index 1392cc3a21..4af3d23463 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardCommands.cs
@@ -4,6 +4,7 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using NUnit.Framework;
@@ -13,6 +14,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.IO.Stores;
+using osu.Framework.Testing;
 using osu.Framework.Timing;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Rulesets.Mods;
@@ -33,7 +35,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         };
 
         private readonly ManualClock manualClock = new ManualClock { Rate = 1, IsRunning = true };
-        private bool forward;
+        private int clockDirection;
 
         private const string lookup_name = "hitcircleoverlay";
         private const double clock_limit = 2500;
@@ -69,28 +71,75 @@ namespace osu.Game.Tests.Visual.Gameplay
             };
         }
 
-        [SetUp]
-        public void SetUp()
+        [SetUpSteps]
+        public void SetUpSteps()
         {
-            manualClock.CurrentTime = 0;
-            forward = true;
+            AddStep("start clock", () => clockDirection = 1);
+            AddStep("pause clock", () => clockDirection = 0);
+            AddStep("set clock = 0", () => manualClock.CurrentTime = 0);
         }
 
         [Test]
-        public void TestLoop()
+        public void TestNormalCommandPlayback()
         {
-            AddStep("create sprite", () => Child = createSprite(s =>
+            AddStep("create storyboard", () => Child = createStoryboard(s =>
             {
-                var loop = s.AddLoopingGroup(500, 10);
-                loop.AddY(Easing.OutBounce, 0, 600, 100, 240);
-                loop.AddY(Easing.OutQuint, 800, 1200, 240, 100);
+                s.Commands.AddY(Easing.OutBounce, 500, 900, 100, 240);
+                s.Commands.AddY(Easing.OutQuint, 1100, 1500, 240, 100);
             }));
+
+            assert(0, 100);
+            assert(500, 100);
+            assert(1000, 240);
+            assert(1500, 100);
+            assert(clock_limit, 100);
+            assert(1500, 100);
+            assert(1000, 240);
+            assert(500, 100);
+            assert(0, 100);
+
+            void assert(double time, double y)
+            {
+                AddStep($"set clock = {time}", () => manualClock.CurrentTime = time);
+                AddAssert($"sprite y = {y} at t = {time}", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().Y == y);
+            }
+        }
+
+        [Test]
+        public void TestLoopingCommandsPlayback()
+        {
+            AddStep("create storyboard", () => Child = createStoryboard(s =>
+            {
+                var loop = s.AddLoopingGroup(250, 1);
+                loop.AddY(Easing.OutBounce, 0, 400, 100, 240);
+                loop.AddY(Easing.OutQuint, 600, 1000, 240, 100);
+            }));
+
+            assert(0, 100);
+            assert(250, 100);
+            assert(850, 240);
+            assert(1250, 100);
+            assert(1850, 240);
+            assert(2250, 100);
+            assert(clock_limit, 100);
+            assert(2250, 100);
+            assert(1850, 240);
+            assert(1250, 100);
+            assert(850, 240);
+            assert(250, 100);
+            assert(0, 100);
+
+            void assert(double time, double y)
+            {
+                AddStep($"set clock = {time}", () => manualClock.CurrentTime = time);
+                AddAssert($"sprite y = {y} at t = {time}", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().Y == y);
+            }
         }
 
         [Test]
         public void TestLoopManyTimes()
         {
-            AddStep("create sprite", () => Child = createSprite(s =>
+            AddStep("create storyboard", () => Child = createStoryboard(s =>
             {
                 var loop = s.AddLoopingGroup(500, 10000);
                 loop.AddY(Easing.OutBounce, 0, 60, 100, 240);
@@ -98,19 +147,57 @@ namespace osu.Game.Tests.Visual.Gameplay
             }));
         }
 
+        [Test]
+        public void TestParameterTemporaryEffect()
+        {
+            AddStep("create storyboard", () => Child = createStoryboard(s =>
+            {
+                s.Commands.AddFlipV(Easing.None, 1000, 1500, true, false);
+            }));
+
+            AddAssert("sprite not flipped at t = 0", () => !this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("set clock = 1250", () => manualClock.CurrentTime = 1250);
+            AddAssert("sprite flipped at t = 1250", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("set clock = 2000", () => manualClock.CurrentTime = 2000);
+            AddAssert("sprite not flipped at t = 2000", () => !this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("resume clock", () => clockDirection = 1);
+        }
+
+        [Test]
+        public void TestParameterPermanentEffect()
+        {
+            AddStep("create storyboard", () => Child = createStoryboard(s =>
+            {
+                s.Commands.AddFlipV(Easing.None, 1000, 1000, true, true);
+            }));
+
+            AddAssert("sprite flipped at t = 0", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("set clock = 1250", () => manualClock.CurrentTime = 1250);
+            AddAssert("sprite flipped at t = 1250", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("set clock = 2000", () => manualClock.CurrentTime = 2000);
+            AddAssert("sprite flipped at t = 2000", () => this.ChildrenOfType<DrawableStoryboardSprite>().Single().FlipV);
+
+            AddStep("resume clock", () => clockDirection = 1);
+        }
+
         protected override void Update()
         {
             base.Update();
 
             if (manualClock.CurrentTime > clock_limit || manualClock.CurrentTime < 0)
-                forward = !forward;
+                clockDirection = -clockDirection;
 
-            manualClock.CurrentTime += Time.Elapsed * (forward ? 1 : -1);
+            manualClock.CurrentTime += Time.Elapsed * clockDirection;
             timelineText.Text = $"Time: {manualClock.CurrentTime:0}ms";
             timelineMarker.X = (float)(manualClock.CurrentTime / clock_limit);
         }
 
-        private DrawableStoryboard createSprite(Action<StoryboardSprite>? addCommands = null)
+        private DrawableStoryboard createStoryboard(Action<StoryboardSprite>? addCommands = null)
         {
             var layer = storyboard.GetLayer("Background");
 

From 6ff4b1d7e3d461adf4b67c676a62f39ecfd7ec21 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 10 Mar 2024 15:42:03 +0300
Subject: [PATCH 346/930] Don't update SubTreeMasking in OsuPlayfield

---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 411a02c5af..80379094ae 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -9,6 +9,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
@@ -35,6 +36,8 @@ namespace osu.Game.Rulesets.Osu.UI
 
         private readonly JudgementPooler<DrawableOsuJudgement> judgementPooler;
 
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+
         public SmokeContainer Smoke { get; }
         public FollowPointRenderer FollowPoints { get; }
 

From 6ecef33fd7a9dcee06349e1075e10ed3bce9e7c7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 10 Mar 2024 22:45:29 +0300
Subject: [PATCH 347/930] Fic incorrect ExtendableCircle gradient

---
 .../Components/Timeline/TimelineHitObjectBlueprint.cs       | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
index d4afcc0151..7e6e886ff7 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineHitObjectBlueprint.cs
@@ -471,6 +471,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         /// </summary>
         public partial class ExtendableCircle : CompositeDrawable
         {
+            public new ColourInfo Colour
+            {
+                get => Content.Colour;
+                set => Content.Colour = value;
+            }
+
             protected readonly Circle Content;
 
             public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => Content.ReceivePositionalInputAt(screenSpacePos);

From 283de215d37aca9605bbf5b0a11dc440455bb348 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 11 Mar 2024 01:01:26 +0300
Subject: [PATCH 348/930] Adjust log message and comment

---
 osu.Desktop/DiscordRichPresence.cs | 18 ++++++------------
 1 file changed, 6 insertions(+), 12 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index b4a7e80d48..2e5db2f5c1 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -189,20 +189,14 @@ namespace osu.Desktop
         private void onJoin(object sender, JoinMessage args)
         {
             game.Window?.Raise();
-            Logger.Log($"Received room secret from Discord RPC Client: {args.Secret}", LoggingTarget.Network, LogLevel.Debug);
 
-            // Stable and Lazer share the same Discord client ID, meaning they can accept join requests from each other.
+            Logger.Log($"Received room secret from Discord RPC Client: \"{args.Secret}\"", LoggingTarget.Network, LogLevel.Debug);
+
+            // Stable and lazer share the same Discord client ID, meaning they can accept join requests from each other.
             // Since they aren't compatible in multi, see if stable's format is being used and log to avoid confusion.
-            // https://discord.com/channels/188630481301012481/188630652340404224/1214697229063946291
-            if (args.Secret[0] != '{')
+            if (args.Secret[0] != '{' || !tryParseRoomSecret(args.Secret, out long roomId, out string? password))
             {
-                Logger.Log("osu!stable rooms are not compatible with lazer.", LoggingTarget.Network, LogLevel.Important);
-                return;
-            }
-
-            if (!tryParseRoomSecret(args.Secret, out long roomId, out string? password))
-            {
-                Logger.Log("Could not join multiplayer room.", LoggingTarget.Network, LogLevel.Important);
+                Logger.Log("Could not join multiplayer room, invitation is invalid or incompatible.", LoggingTarget.Network, LogLevel.Important);
                 return;
             }
 
@@ -211,7 +205,7 @@ namespace osu.Desktop
             {
                 game.PresentMultiplayerMatch(room, password);
             });
-            request.Failure += _ => Logger.Log($"Could not find room {roomId} from Discord RPC Client", LoggingTarget.Network, LogLevel.Important);
+            request.Failure += _ => Logger.Log($"Could not join multiplayer room, room could not be found (room ID: {roomId}).", LoggingTarget.Network, LogLevel.Important);
             api.Queue(request);
         }
 

From 2be6d1f1c60f6e146b056f3fc42c1205cea22826 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 11:26:03 +0800
Subject: [PATCH 349/930] Apply NRT to `OsuPlayfield`

---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 80379094ae..9b8128a107 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Diagnostics;
 using System.Linq;
@@ -79,7 +77,7 @@ namespace osu.Game.Rulesets.Osu.UI
             NewResult += onNewResult;
         }
 
-        private IHitPolicy hitPolicy;
+        private IHitPolicy hitPolicy = null!;
 
         public IHitPolicy HitPolicy
         {
@@ -119,12 +117,12 @@ namespace osu.Game.Rulesets.Osu.UI
             judgementAboveHitObjectLayer.Add(judgement.ProxiedAboveHitObjectsContent);
         }
 
-        [BackgroundDependencyLoader(true)]
-        private void load(OsuRulesetConfigManager config, IBeatmap beatmap)
+        [BackgroundDependencyLoader]
+        private void load(OsuRulesetConfigManager? config, IBeatmap? beatmap)
         {
             config?.BindWith(OsuRulesetSetting.PlayfieldBorderStyle, playfieldBorder.PlayfieldBorderStyle);
 
-            var osuBeatmap = (OsuBeatmap)beatmap;
+            var osuBeatmap = (OsuBeatmap?)beatmap;
 
             RegisterPool<HitCircle, DrawableHitCircle>(20, 100);
 

From f3d154a9955697cd25db6a2dd3393daf668acac2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 11:28:15 +0800
Subject: [PATCH 350/930] Add inline comment explaining optimisation

---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 9b8128a107..63030293ac 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -34,6 +34,8 @@ namespace osu.Game.Rulesets.Osu.UI
 
         private readonly JudgementPooler<DrawableOsuJudgement> judgementPooler;
 
+        // For osu! gameplay, everything is always on screen.
+        // Skipping masking calculations improves performance in intense beatmaps (ie. https://osu.ppy.sh/beatmapsets/150945#osu/372245)
         public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
 
         public SmokeContainer Smoke { get; }

From e3936930c7df32ccd53f6c8f4ea2dca14dec3934 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 13:11:57 +0800
Subject: [PATCH 351/930] Remove local optimisation in `DrawableHitObject`

---
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index de05219212..28aa2ccb79 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -15,7 +15,6 @@ using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -632,8 +631,6 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         #endregion
 
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
-
         protected override void UpdateAfterChildren()
         {
             base.UpdateAfterChildren();

From d12b11e234f0e9d279e70c71ab595a063ec98e47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 13:14:29 +0800
Subject: [PATCH 352/930] Revert "Remove local optimisation in
 `DrawableHitObject`"

This reverts commit e3936930c7df32ccd53f6c8f4ea2dca14dec3934.
---
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 28aa2ccb79..de05219212 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -15,6 +15,7 @@ using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -631,6 +632,8 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         #endregion
 
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+
         protected override void UpdateAfterChildren()
         {
             base.UpdateAfterChildren();

From 091425db3091104269531f28218b3b309e50c426 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 14:43:54 +0800
Subject: [PATCH 353/930] Fix nullability hint

---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 63030293ac..a55a55f760 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Rulesets.Osu.UI
 
         public static readonly Vector2 BASE_SIZE = new Vector2(512, 384);
 
-        protected override GameplayCursorContainer CreateCursor() => new OsuCursorContainer();
+        protected override GameplayCursorContainer? CreateCursor() => new OsuCursorContainer();
 
         private readonly Container judgementAboveHitObjectLayer;
 

From fc05268fc33fc16f214501f3dffe1ec33a301e29 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 14:45:52 +0800
Subject: [PATCH 354/930] Apply NRT to `DrawableOsuEditorRuleset` too

---
 osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
index 14e7b93f3a..68c565af4d 100644
--- a/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
+++ b/osu.Game.Rulesets.Osu/Edit/DrawableOsuEditorRuleset.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Mods;
@@ -25,7 +23,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private partial class OsuEditorPlayfield : OsuPlayfield
         {
-            protected override GameplayCursorContainer CreateCursor() => null;
+            protected override GameplayCursorContainer? CreateCursor() => null;
 
             public OsuEditorPlayfield()
             {

From e0f1f70b820030452c2f32d1d7dfe6417230f9c7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 11 Mar 2024 15:52:38 +0900
Subject: [PATCH 355/930] Adjust NRT to prevent future issues

This way, it will yet at us if the setter is ever moved out of the ctor.
---
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index a55a55f760..4933eb4041 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -79,11 +80,12 @@ namespace osu.Game.Rulesets.Osu.UI
             NewResult += onNewResult;
         }
 
-        private IHitPolicy hitPolicy = null!;
+        private IHitPolicy hitPolicy;
 
         public IHitPolicy HitPolicy
         {
             get => hitPolicy;
+            [MemberNotNull(nameof(hitPolicy))]
             set
             {
                 hitPolicy = value ?? throw new ArgumentNullException(nameof(value));

From 226df7163e1b34eb4a78f02f0038493b673a8dce Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 11 Mar 2024 16:55:49 +0800
Subject: [PATCH 356/930] Update client ID

---
 osu.Desktop/DiscordRichPresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 2e5db2f5c1..4e3db2db2d 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -25,7 +25,7 @@ namespace osu.Desktop
 {
     internal partial class DiscordRichPresence : Component
     {
-        private const string client_id = "367827983903490050";
+        private const string client_id = "1216669957799018608";
 
         private DiscordRpcClient client = null!;
 

From 169e2e1b4e21c824e586cd1be88b33875e9a2e30 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 11 Mar 2024 09:54:49 +0300
Subject: [PATCH 357/930] Change maximum room number to closest powers of two

---
 osu.Desktop/DiscordRichPresence.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 4e3db2db2d..886038bcf0 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -142,9 +142,8 @@ namespace osu.Desktop
                         Privacy = string.IsNullOrEmpty(room.Settings.Password) ? Party.PrivacySetting.Public : Party.PrivacySetting.Private,
                         ID = room.RoomID.ToString(),
                         // technically lobbies can have infinite users, but Discord needs this to be set to something.
-                        // 1024 just happens to look nice.
-                        // https://discord.com/channels/188630481301012481/188630652340404224/1212967974793642034
-                        Max = 1024,
+                        // to make party display sensible, assign a powers of two above participants count (8 at minimum).
+                        Max = (int)Math.Max(8, Math.Pow(2, Math.Ceiling(Math.Log2(room.Users.Count)))),
                         Size = room.Users.Count,
                     };
 

From 8b730acb082379174f9a48b5fd132b184b4e9a81 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Mon, 11 Mar 2024 11:18:59 +0300
Subject: [PATCH 358/930] Update presence on changes to multiplayer room

---
 osu.Desktop/DiscordRichPresence.cs | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 886038bcf0..8de1a08e7a 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -8,6 +8,7 @@ using DiscordRPC.Message;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game;
@@ -91,6 +92,8 @@ namespace osu.Desktop
             activity.BindValueChanged(_ => updateStatus());
             privacyMode.BindValueChanged(_ => updateStatus());
 
+            multiplayerClient.RoomUpdated += updateStatus;
+
             client.Initialize();
         }
 
@@ -269,6 +272,9 @@ namespace osu.Desktop
 
         protected override void Dispose(bool isDisposing)
         {
+            if (multiplayerClient.IsNotNull())
+                multiplayerClient.RoomUpdated -= updateStatus;
+
             client.Dispose();
             base.Dispose(isDisposing);
         }

From e5e7c8f26841654a6819f3c88c40a347184c086b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 11 Mar 2024 14:58:28 +0100
Subject: [PATCH 359/930] Wrap beatmap listing filter names too

While we're here fixing...

Addresses
https://github.com/ppy/osu/discussions/15452#discussioncomment-2734237.
---
 osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
index f79695a123..0b54a921f5 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchFilterRow.cs
@@ -6,10 +6,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
 using osuTK;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Localisation;
+using osu.Game.Graphics.Containers;
 
 namespace osu.Game.Overlays.BeatmapListing
 {
@@ -45,9 +45,10 @@ namespace osu.Game.Overlays.BeatmapListing
                 {
                     new[]
                     {
-                        new OsuSpriteText
+                        new OsuTextFlowContainer(t => t.Font = OsuFont.GetFont(size: 13))
                         {
-                            Font = OsuFont.GetFont(size: 13),
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
                             Text = header
                         },
                         filter = CreateFilter()

From f30dfcb728b216659bf80ff513f7c0cdb97d56f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 11 Mar 2024 21:34:10 +0100
Subject: [PATCH 360/930] Fix ruleset medals not displaying due to
 deserialisation failure
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦🤦

Reported in
https://discord.com/channels/188630481301012481/188630652340404224/1216812697589518386.
---
 .../Notifications/WebSocket/Events/UserAchievementUnlock.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs b/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs
index 6c7c8af4f4..3f803a4fe5 100644
--- a/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs
+++ b/osu.Game/Online/Notifications/WebSocket/Events/UserAchievementUnlock.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Online.Notifications.WebSocket.Events
         public uint AchievementId { get; set; }
 
         [JsonProperty("achievement_mode")]
-        public ushort? AchievementMode { get; set; }
+        public string? AchievementMode { get; set; }
 
         [JsonProperty("cover_url")]
         public string CoverUrl { get; set; } = string.Empty;

From 5580ce31fa6c37c7c65a703cfe820705928453bd Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Mon, 11 Mar 2024 18:15:18 -0400
Subject: [PATCH 361/930] Log Discord RPC updates

---
 osu.Desktop/DiscordRichPresence.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 8de1a08e7a..6c8bd26d3d 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -114,6 +114,8 @@ namespace osu.Desktop
                 return;
             }
 
+            Logger.Log("Updating Discord RPC", LoggingTarget.Network, LogLevel.Debug);
+
             if (activity.Value != null)
             {
                 bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;

From e4e7dd14f30ee5c2d28ccc967a0a891fbbd076b7 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Mon, 11 Mar 2024 18:16:13 -0400
Subject: [PATCH 362/930] Revert "Update presence on changes to multiplayer
 room"

This reverts commit 8b730acb082379174f9a48b5fd132b184b4e9a81.
---
 osu.Desktop/DiscordRichPresence.cs | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 6c8bd26d3d..ca26cab0fd 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -8,7 +8,6 @@ using DiscordRPC.Message;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game;
@@ -92,8 +91,6 @@ namespace osu.Desktop
             activity.BindValueChanged(_ => updateStatus());
             privacyMode.BindValueChanged(_ => updateStatus());
 
-            multiplayerClient.RoomUpdated += updateStatus;
-
             client.Initialize();
         }
 
@@ -274,9 +271,6 @@ namespace osu.Desktop
 
         protected override void Dispose(bool isDisposing)
         {
-            if (multiplayerClient.IsNotNull())
-                multiplayerClient.RoomUpdated -= updateStatus;
-
             client.Dispose();
             base.Dispose(isDisposing);
         }

From 83052fe1d98174a832e4ed7e9c52b04c5eb7c6c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Mar 2024 15:41:50 +0800
Subject: [PATCH 363/930] Downgrade realm to work around crashes on latest
 release

See https://github.com/ppy/osu/issues/27577.
---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 55bd68dea0..0b70515abf 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Realm" Version="11.7.0" />
+    <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.309.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />

From 961058f5c8ca538b1a96a82651b30e49b92c90c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Mar 2024 09:05:28 +0100
Subject: [PATCH 364/930] Add failing test case

---
 .../Archives/skin-with-subfolder-zip-entries.osk  | Bin 0 -> 894 bytes
 osu.Game.Tests/Skins/IO/ImportSkinTest.cs         |  10 ++++++++++
 2 files changed, 10 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/Archives/skin-with-subfolder-zip-entries.osk

diff --git a/osu.Game.Tests/Resources/Archives/skin-with-subfolder-zip-entries.osk b/osu.Game.Tests/Resources/Archives/skin-with-subfolder-zip-entries.osk
new file mode 100644
index 0000000000000000000000000000000000000000..013bca3801866f95f7139fbed30f96fb2a6b2639
GIT binary patch
literal 894
zcmWIWW@Zs#0D)fToCq)jN+<wnx6(WXxBQ%x)FK79(wrQH{4^j96iQ7jDJ@DZ)(-&c
z<^rpq0Mxzh&<1aDAP<B!h|pb<T3n)6Qc+S|keHs4T2hj!keHXEkP9?CDKRIf7-9I@
z!i)&1-I{l0fQEvw01yXfXXYt5=jWBA=7A0I%P+~u%u82DOfD$}>aJ8o04|V8AWw2I
zfK1XY?5o`h<TWvZL>L%~fhOr?=4GDkw_SJ0K%k|1ep1|jmnGM2G-Y{9ME;m|BpsAa
zdiX}EdTqz%zyg(Z44p4_Fr3YD|D0*^dB@$=T(75H%;>qrZuxLUl1|$^qZKpCQXYC3
z#yQ^GeEcET*{AILmN4?)b)Ee8k;Bi_RSP&LwpzKFwp97OxN&0g#UpQ@>CDl1clVL&
zm59~7Cw(RLCr>>h`BUbIZ}-+&SvgO1Zgt--I_0?Z*!?H>cjm9{y*o)W$#hTc2C>C+
z_D=kJe3g2DHzSih1FjfU0eTMvKmi5<gyNHnK>@6ekwJnX*M{T1U&$?CAfW<?jksbR
zW}^a7lN}HfvJsXBkZr#Dl>ZSSn=z9F%;pB5t+Rm`J%J$Gz#u;>J*p6w-*6=rWE-9W
ZZGa^l;!I{`18QMl0m2o)Fg*YcR{%bq?(hHr

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
index 606a5afac2..62e7a80435 100644
--- a/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
+++ b/osu.Game.Tests/Skins/IO/ImportSkinTest.cs
@@ -173,6 +173,16 @@ namespace osu.Game.Tests.Skins.IO
             assertCorrectMetadata(import1, "name 1 [my custom skin 1]", "author 1", 1.0m, osu);
         });
 
+        [Test]
+        public Task TestImportWithSubfolder() => runSkinTest(async osu =>
+        {
+            const string filename = "Archives/skin-with-subfolder-zip-entries.osk";
+            var import = await loadSkinIntoOsu(osu, new ImportTask(TestResources.OpenResource(filename), filename));
+
+            assertCorrectMetadata(import, $"Totally fully features skin [Real Skin with Real Features] [{filename[..^4]}]", "Unknown", 2.7m, osu);
+            Assert.That(import.PerformRead(r => r.Files.Count), Is.EqualTo(3));
+        });
+
         #endregion
 
         #region Cases where imports should be uniquely imported

From 83e47b3c4c1c3a59c6ded7249797daa436d46572 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 12 Mar 2024 09:06:24 +0100
Subject: [PATCH 365/930] Fix exports containing zero byte files after import
 from specific ZIP archives

Closes https://github.com/ppy/osu/issues/27540.

As it turns out, some ZIP archivers (like 7zip) will decide to add fake
entries for directories, and some (like windows zipfolders) won't.
The "directory" entries aren't really properly supported using any
actual data or attributes, they're detected by sharpcompress basically
by heuristics:

    https://github.com/adamhathcock/sharpcompress/blob/ab5535eba365ec8fae58f92d53763ddf2dbf45af/src/SharpCompress/Common/Zip/Headers/ZipFileEntry.cs#L19-L31

When importing into realm we have thus far presumed that these directory
entries will not be a thing. Having them be a thing breaks multiple
things, like:

- When importing from ZIPs with separate directory entries, a separate
  `RealmFile` is created for a directory entry even though it doesn't
  represent a real file
- As a result, when re-exporting a model with files imported from such
  an archive, a zero-byte file would be created because to the database
  it looks like it was originally a zero-byte file.

If you want to have fun, google "zip empty directories". You'll see
a whole gamut of languages, libraries, and developers stepping on this
rake. Yet another episode of underspecced mistakes from decades ago
that were somebody's "good idea" but continue to wreak havoc forevermore
because now there are two competing conventions you can't just pick one.
---
 osu.Game/IO/Archives/ZipArchiveReader.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/IO/Archives/ZipArchiveReader.cs b/osu.Game/IO/Archives/ZipArchiveReader.cs
index 7d7ce858dd..cc5c65d184 100644
--- a/osu.Game/IO/Archives/ZipArchiveReader.cs
+++ b/osu.Game/IO/Archives/ZipArchiveReader.cs
@@ -46,7 +46,7 @@ namespace osu.Game.IO.Archives
             archiveStream.Dispose();
         }
 
-        public override IEnumerable<string> Filenames => archive.Entries.Select(e => e.Key).ExcludeSystemFileNames();
+        public override IEnumerable<string> Filenames => archive.Entries.Where(e => !e.IsDirectory).Select(e => e.Key).ExcludeSystemFileNames();
 
         private class MemoryOwnerMemoryStream : Stream
         {

From 88ec0cdbc704e041bd6b77ff24d1a4206d888896 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Mar 2024 17:35:00 +0800
Subject: [PATCH 366/930] Fix seek ending too early in sample playback test

---
 .../TestSceneGameplaySamplePlayback.cs        | 21 ++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
index 057197e819..ad3fe7cb7e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneGameplaySamplePlayback.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Tests.Visual.Gameplay
     {
         protected override bool AllowBackwardsSeeks => true;
 
+        private bool seek;
+
         [Test]
         public void TestAllSamplesStopDuringSeek()
         {
@@ -42,7 +44,7 @@ namespace osu.Game.Tests.Visual.Gameplay
                 if (!samples.Any(s => s.Playing))
                     return false;
 
-                Player.ChildrenOfType<GameplayClockContainer>().First().Seek(40000);
+                seek = true;
                 return true;
             });
 
@@ -55,10 +57,27 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddAssert("sample playback still disabled", () => sampleDisabler.SamplePlaybackDisabled.Value);
 
+            AddStep("stop seeking", () => seek = false);
+
             AddUntilStep("seek finished, sample playback enabled", () => !sampleDisabler.SamplePlaybackDisabled.Value);
             AddUntilStep("any sample is playing", () => Player.ChildrenOfType<PausableSkinnableSound>().Any(s => s.IsPlaying));
         }
 
+        protected override void Update()
+        {
+            base.Update();
+
+            if (seek)
+            {
+                // Frame stable playback is too fast to catch up these days.
+                //
+                // We want to keep seeking while asserting various test conditions, so
+                // continue to seek until we unset the flag.
+                var gameplayClockContainer = Player.ChildrenOfType<GameplayClockContainer>().First();
+                gameplayClockContainer.Seek(gameplayClockContainer.CurrentTime > 30000 ? 0 : 60000);
+            }
+        }
+
         private IEnumerable<PausableSkinnableSound> allSounds => Player.ChildrenOfType<PausableSkinnableSound>();
         private IEnumerable<PausableSkinnableSound> allLoopingSounds => allSounds.Where(sound => sound.Looping);
 

From a4a433b92add36153d8f9b06ffa757480ff3b5ee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 12 Mar 2024 20:14:50 +0800
Subject: [PATCH 367/930] Remember login by default

Kinda what is expected from a user's perspective
---
 osu.Game/Configuration/OsuConfigManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index a71460ded7..f4a4c553d8 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -75,7 +75,7 @@ namespace osu.Game.Configuration
 #pragma warning restore CS0618 // Type or member is obsolete
             SetDefault(OsuSetting.AutomaticallyDownloadMissingBeatmaps, false);
 
-            SetDefault(OsuSetting.SavePassword, false).ValueChanged += enabled =>
+            SetDefault(OsuSetting.SavePassword, true).ValueChanged += enabled =>
             {
                 if (enabled.NewValue)
                     SetValue(OsuSetting.SaveUsername, true);

From e2e99fc5cc392b57276a1c79f3b68c2831c64ac0 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Tue, 12 Mar 2024 21:07:21 -0700
Subject: [PATCH 368/930] Rearrange rankings overlay tabs to match web

---
 osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs | 2 +-
 osu.Game/Overlays/Rankings/RankingsScope.cs         | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs b/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs
index cf132ed4da..0eaa6ce827 100644
--- a/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs
+++ b/osu.Game/Overlays/Rankings/RankingsOverlayHeader.cs
@@ -52,9 +52,9 @@ namespace osu.Game.Overlays.Rankings
                 switch (scope)
                 {
                     case RankingsScope.Performance:
-                    case RankingsScope.Spotlights:
                     case RankingsScope.Score:
                     case RankingsScope.Country:
+                    case RankingsScope.Spotlights:
                         return true;
 
                     default:
diff --git a/osu.Game/Overlays/Rankings/RankingsScope.cs b/osu.Game/Overlays/Rankings/RankingsScope.cs
index 356a861764..0740c17e8c 100644
--- a/osu.Game/Overlays/Rankings/RankingsScope.cs
+++ b/osu.Game/Overlays/Rankings/RankingsScope.cs
@@ -11,15 +11,15 @@ namespace osu.Game.Overlays.Rankings
         [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypePerformance))]
         Performance,
 
-        [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypeCharts))]
-        Spotlights,
-
         [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypeScore))]
         Score,
 
         [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypeCountry))]
         Country,
 
+        [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypeCharts))]
+        Spotlights,
+
         [LocalisableDescription(typeof(RankingsStrings), nameof(RankingsStrings.TypeKudosu))]
         Kudosu,
     }

From 20c760835ab81c4a90c46656f69d8b59b0903fc1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Mar 2024 13:55:49 +0100
Subject: [PATCH 369/930] Fix audio in video check crashing on unexpected
 failures

---
 osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
index f712a7867d..38976dd4b5 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAudioInVideo.cs
@@ -1,8 +1,10 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using System.Collections.Generic;
 using System.IO;
+using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.IO.FileAbstraction;
 using osu.Game.Rulesets.Edit.Checks.Components;
@@ -75,6 +77,11 @@ namespace osu.Game.Rulesets.Edit.Checks
                 {
                     issue = new IssueTemplateFileError(this).Create(filename, "Unsupported format");
                 }
+                catch (Exception ex)
+                {
+                    issue = new IssueTemplateFileError(this).Create(filename, "Internal failure - see logs for more info");
+                    Logger.Log($"Failed when running {nameof(CheckAudioInVideo)}: {ex}");
+                }
 
                 yield return issue;
             }

From d32f19b546e63e844acaa3c4c3911225cb757ace Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 13 Mar 2024 15:18:20 +0100
Subject: [PATCH 370/930] Fix first word bold not applying correctly after
 first language change

Closes https://github.com/ppy/osu/issues/27549.

I'm not entirely sure why the old solution failed exactly, but also
think it's unimportant because I think past me was an idiot and was
playing stupid games with the juggling of indices between two callbacks
with no ordering guarantees and expecting not to win stupid prizes.

I'm not sure this requires any follow-up reconsiderations of that entire
text flow API, but if opinions differ, I'll re-examine.
---
 osu.Game/Overlays/Mods/ModSelectColumn.cs | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectColumn.cs b/osu.Game/Overlays/Mods/ModSelectColumn.cs
index b2c5a054e1..61b29ef65b 100644
--- a/osu.Game/Overlays/Mods/ModSelectColumn.cs
+++ b/osu.Game/Overlays/Mods/ModSelectColumn.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -8,9 +9,11 @@ using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Localisation;
+using System.Linq;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Backgrounds;
 using osu.Game.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
 using osuTK;
 using osuTK.Graphics;
 
@@ -181,17 +184,15 @@ namespace osu.Game.Overlays.Mods
         {
             headerText.Clear();
 
-            int wordIndex = 0;
+            ITextPart part = headerText.AddText(text);
+            part.DrawablePartsRecreated += applySemiBoldToFirstWord;
+            applySemiBoldToFirstWord(part.Drawables);
 
-            ITextPart part = headerText.AddText(text, t =>
+            void applySemiBoldToFirstWord(IEnumerable<Drawable> d)
             {
-                if (wordIndex == 0)
-                    t.Font = t.Font.With(weight: FontWeight.SemiBold);
-                wordIndex += 1;
-            });
-
-            // Reset the index so that if the parts are refreshed (e.g. through changes in localisation) the correct word is re-emboldened.
-            part.DrawablePartsRecreated += _ => wordIndex = 0;
+                if (d.FirstOrDefault() is OsuSpriteText firstWord)
+                    firstWord.Font = firstWord.Font.With(weight: FontWeight.SemiBold);
+            }
         }
 
         [BackgroundDependencyLoader]

From 789a9f4dfa071dacc9157914e93792231d568923 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Mar 2024 11:01:57 +0900
Subject: [PATCH 371/930] Initial redesign following flyte's design

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 125 +++++++++++-------
 1 file changed, 79 insertions(+), 46 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index ba49810b2b..e9dd26a06b 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -3,10 +3,12 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
@@ -21,7 +23,12 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public partial class DelayedResumeOverlay : ResumeOverlay
     {
-        private const double countdown_time = 800;
+        private const float outer_size = 200;
+        private const float inner_size = 150;
+        private const float progress_stroke_width = 7;
+        private const float progress_size = inner_size + progress_stroke_width / 2f;
+
+        private const double countdown_time = 3000;
 
         protected override LocalisableString Message => string.Empty;
 
@@ -31,9 +38,15 @@ namespace osu.Game.Screens.Play
         private ScheduledDelegate? scheduledResume;
         private int countdownCount = 3;
         private double countdownStartTime;
+        private bool countdownComplete;
 
-        private Drawable content = null!;
-        private SpriteText countdown = null!;
+        private Drawable outerContent = null!;
+        private Container innerContent = null!;
+
+        private Container countdownComponents = null!;
+        private Drawable countdownBackground = null!;
+        private SpriteText countdownText = null!;
+        private CircularProgress countdownProgress = null!;
 
         public DelayedResumeOverlay()
         {
@@ -44,44 +57,48 @@ namespace osu.Game.Screens.Play
         [BackgroundDependencyLoader]
         private void load()
         {
-            Add(content = new CircularContainer
+            Add(outerContent = new Circle
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
-                AutoSizeAxes = Axes.Both,
-                Masking = true,
-                BorderColour = colours.Yellow,
-                BorderThickness = 2,
-                Children = new Drawable[]
+                Size = new Vector2(outer_size),
+                Colour = Color4.Black.Opacity(0.25f)
+            });
+
+            Add(innerContent = new Container
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                RelativeSizeAxes = Axes.Both,
+                Children = new[]
                 {
-                    new Box
-                    {
-                        Size = new Vector2(250, 40),
-                        Colour = Color4.Black,
-                        Alpha = 0.8f
-                    },
-                    new Container
+                    countdownBackground = new Circle
                     {
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
-                        AutoSizeAxes = Axes.Both,
+                        Size = new Vector2(inner_size),
+                        Colour = Color4.Black.Opacity(0.25f)
+                    },
+                    countdownComponents = new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
                         Children = new Drawable[]
                         {
-                            new FillFlowContainer
+                            countdownProgress = new CircularProgress
                             {
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
-                                AutoSizeAxes = Axes.Both,
-                                Spacing = new Vector2(5),
-                                Colour = colours.Yellow,
-                                Child = countdown = new OsuSpriteText
-                                {
-                                    Anchor = Anchor.Centre,
-                                    Origin = Anchor.Centre,
-                                    UseFullGlyphHeight = false,
-                                    AlwaysPresent = true,
-                                    Font = OsuFont.Numeric.With(size: 20, fixedWidth: true)
-                                },
+                                Size = new Vector2(progress_size),
+                                InnerRadius = progress_stroke_width / progress_size,
+                                RoundedCaps = true
+                            },
+                            countdownText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                UseFullGlyphHeight = false,
+                                AlwaysPresent = true,
+                                Font = OsuFont.Torus.With(size: 70, weight: FontWeight.Light)
                             }
                         }
                     }
@@ -93,14 +110,26 @@ namespace osu.Game.Screens.Play
         {
             this.FadeIn();
 
-            content.FadeInFromZero(150, Easing.OutQuint);
-            content.ScaleTo(new Vector2(1.5f, 1)).Then().ScaleTo(1, 150, Easing.OutElasticQuarter);
+            // The transition effects.
+            outerContent.FadeIn().ScaleTo(Vector2.Zero).Then().ScaleTo(Vector2.One, 200, Easing.OutQuint);
+            innerContent.FadeIn().ScaleTo(Vector2.Zero).Then().ScaleTo(Vector2.One, 400, Easing.OutElasticHalf);
+            countdownComponents.FadeOut().Then().Delay(50).FadeTo(1, 100);
 
+            // Reset states for various components.
+            countdownBackground.FadeIn();
+            countdownText.FadeIn();
+            countdownProgress.FadeIn().ScaleTo(1);
+
+            countdownComplete = false;
             countdownCount = 3;
             countdownStartTime = Time.Current;
 
             scheduledResume?.Cancel();
-            scheduledResume = Scheduler.AddDelayed(Resume, countdown_time);
+            scheduledResume = Scheduler.AddDelayed(() =>
+            {
+                countdownComplete = true;
+                Resume();
+            }, countdown_time);
         }
 
         protected override void Update()
@@ -114,20 +143,14 @@ namespace osu.Game.Screens.Play
             double amountTimePassed = Math.Min(countdown_time, Time.Current - countdownStartTime) / countdown_time;
             int newCount = 3 - (int)Math.Floor(amountTimePassed * 3);
 
-            if (newCount > 0)
-            {
-                countdown.Alpha = 1;
-                countdown.Text = newCount.ToString();
-            }
-            else
-                countdown.Alpha = 0;
+            countdownProgress.Current.Value = amountTimePassed;
+            countdownText.Text = Math.Max(1, newCount).ToString();
+            countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 
-            if (newCount != countdownCount)
+            if (countdownCount != newCount && newCount > 0)
             {
-                if (newCount == 0)
-                    content.ScaleTo(new Vector2(1.5f, 1), 150, Easing.OutQuint);
-                else
-                    content.ScaleTo(new Vector2(1.05f, 1), 50, Easing.OutQuint).Then().ScaleTo(1, 50, Easing.Out);
+                countdownText.ScaleTo(0.25f).Then().ScaleTo(1, 200, Easing.OutQuint);
+                outerContent.Delay(25).Then().ScaleTo(1.05f, 100).Then().ScaleTo(1f, 200, Easing.Out);
             }
 
             countdownCount = newCount;
@@ -135,9 +158,19 @@ namespace osu.Game.Screens.Play
 
         protected override void PopOut()
         {
-            this.Delay(150).FadeOut();
+            this.Delay(300).FadeOut();
 
-            content.FadeOut(150, Easing.OutQuint);
+            outerContent.FadeOut();
+            countdownBackground.FadeOut();
+            countdownText.FadeOut();
+
+            if (countdownComplete)
+            {
+                countdownProgress.ScaleTo(2f, 300, Easing.OutQuint);
+                countdownProgress.Delay(200).FadeOut(100, Easing.Out);
+            }
+            else
+                countdownProgress.FadeOut();
 
             scheduledResume?.Cancel();
         }

From b431bb11764c4c4088eea49f4cd7f5e7611e4aa9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 14 Mar 2024 12:24:12 +0900
Subject: [PATCH 372/930] Resolve post-merge issues

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index e9dd26a06b..196ca24358 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -32,9 +32,6 @@ namespace osu.Game.Screens.Play
 
         protected override LocalisableString Message => string.Empty;
 
-        [Resolved]
-        private OsuColour colours { get; set; } = null!;
-
         private ScheduledDelegate? scheduledResume;
         private int countdownCount = 3;
         private double countdownStartTime;
@@ -143,7 +140,7 @@ namespace osu.Game.Screens.Play
             double amountTimePassed = Math.Min(countdown_time, Time.Current - countdownStartTime) / countdown_time;
             int newCount = 3 - (int)Math.Floor(amountTimePassed * 3);
 
-            countdownProgress.Current.Value = amountTimePassed;
+            countdownProgress.Progress = amountTimePassed;
             countdownText.Text = Math.Max(1, newCount).ToString();
             countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 

From b309aad895b001e042ec85f2c6103457fdd801a1 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Fri, 8 Mar 2024 13:13:08 -0800
Subject: [PATCH 373/930] Fix noticeable masking artifact of beatmap cards when
 already downloaded
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Had a similar fix before seeing https://github.com/ppy/osu/pull/20743#discussion_r994955470, but using that diff instead so co-authoring.

Co-Authored-By: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 .../Drawables/Cards/CollapsibleButtonContainer.cs         | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
index fe2ee8c7cc..32df1755a7 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                 downloadTracker,
                 background = new Container
                 {
-                    RelativeSizeAxes = Axes.Both,
+                    RelativeSizeAxes = Axes.Y,
                     Anchor = Anchor.CentreRight,
                     Origin = Anchor.CentreRight,
                     Child = new Box
@@ -165,9 +165,11 @@ namespace osu.Game.Beatmaps.Drawables.Cards
 
         private void updateState()
         {
-            float targetWidth = Width - (ShowDetails.Value ? ButtonsExpandedWidth : ButtonsCollapsedWidth);
+            float buttonAreaWidth = ShowDetails.Value ? ButtonsExpandedWidth : ButtonsCollapsedWidth;
+            float mainAreaWidth = Width - buttonAreaWidth;
 
-            mainArea.ResizeWidthTo(targetWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            mainArea.ResizeWidthTo(mainAreaWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+            background.ResizeWidthTo(buttonAreaWidth + BeatmapCard.CORNER_RADIUS, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
             background.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
             buttons.FadeTo(ShowDetails.Value ? 1 : 0, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);

From b4cee12db96644a8364ed1525aea51f526c1dcb6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 14 Mar 2024 09:21:29 +0300
Subject: [PATCH 374/930] Use defined colours for counter background

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 196ca24358..c6cfeca142 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -3,7 +3,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -13,8 +12,8 @@ using osu.Framework.Localisation;
 using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
 using osuTK;
-using osuTK.Graphics;
 
 namespace osu.Game.Screens.Play
 {
@@ -54,12 +53,15 @@ namespace osu.Game.Screens.Play
         [BackgroundDependencyLoader]
         private void load()
         {
+            // todo: this shouldn't define its own colour provider, but nothing in Player screen does, so let's do that for now.
+            var colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
             Add(outerContent = new Circle
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 Size = new Vector2(outer_size),
-                Colour = Color4.Black.Opacity(0.25f)
+                Colour = colourProvider.Background6,
             });
 
             Add(innerContent = new Container
@@ -74,7 +76,7 @@ namespace osu.Game.Screens.Play
                         Anchor = Anchor.Centre,
                         Origin = Anchor.Centre,
                         Size = new Vector2(inner_size),
-                        Colour = Color4.Black.Opacity(0.25f)
+                        Colour = colourProvider.Background4,
                     },
                     countdownComponents = new Container
                     {

From f8a841e907e9b2deb3ca08c425a0e665a5c07775 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 14 Mar 2024 00:17:22 -0700
Subject: [PATCH 375/930] Add comment explaining why width is limited to the
 button area

Same comment as https://github.com/ppy/osu/blob/a47ccb8edd2392258b6b7e176b222a9ecd511fc0/osu.Game/Screens/Select/BeatmapInfoWedgeV2.cs#L91-L92.
---
 osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
index 32df1755a7..a29724032e 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/CollapsibleButtonContainer.cs
@@ -169,6 +169,8 @@ namespace osu.Game.Beatmaps.Drawables.Cards
             float mainAreaWidth = Width - buttonAreaWidth;
 
             mainArea.ResizeWidthTo(mainAreaWidth, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
+
+            // By limiting the width we avoid this box showing up as an outline around the drawables that are on top of it.
             background.ResizeWidthTo(buttonAreaWidth + BeatmapCard.CORNER_RADIUS, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);
 
             background.FadeColour(downloadTracker.State.Value == DownloadState.LocallyAvailable ? colours.Lime0 : colourProvider.Background3, BeatmapCard.TRANSITION_DURATION, Easing.OutQuint);

From 42bd558d7c159857ca7356b8485d710802685fc6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Mar 2024 22:41:29 +0800
Subject: [PATCH 376/930] Only update text when necessary (reducing unnecessary
 string allocadtions)

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index c6cfeca142..468e67901d 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.Play
         protected override LocalisableString Message => string.Empty;
 
         private ScheduledDelegate? scheduledResume;
-        private int countdownCount = 3;
+        private int? countdownCount;
         private double countdownStartTime;
         private bool countdownComplete;
 
@@ -120,7 +120,7 @@ namespace osu.Game.Screens.Play
             countdownProgress.FadeIn().ScaleTo(1);
 
             countdownComplete = false;
-            countdownCount = 3;
+            countdownCount = null;
             countdownStartTime = Time.Current;
 
             scheduledResume?.Cancel();
@@ -143,11 +143,11 @@ namespace osu.Game.Screens.Play
             int newCount = 3 - (int)Math.Floor(amountTimePassed * 3);
 
             countdownProgress.Progress = amountTimePassed;
-            countdownText.Text = Math.Max(1, newCount).ToString();
             countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 
             if (countdownCount != newCount && newCount > 0)
             {
+                countdownText.Text = Math.Max(1, newCount).ToString();
                 countdownText.ScaleTo(0.25f).Then().ScaleTo(1, 200, Easing.OutQuint);
                 outerContent.Delay(25).Then().ScaleTo(1.05f, 100).Then().ScaleTo(1f, 200, Easing.Out);
             }

From d7769ec3e25cc985fea44e6fb0d02ab668e2dd33 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Mar 2024 22:38:59 +0800
Subject: [PATCH 377/930] Adjust animation

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 468e67901d..7c34050bbf 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -112,7 +112,7 @@ namespace osu.Game.Screens.Play
             // The transition effects.
             outerContent.FadeIn().ScaleTo(Vector2.Zero).Then().ScaleTo(Vector2.One, 200, Easing.OutQuint);
             innerContent.FadeIn().ScaleTo(Vector2.Zero).Then().ScaleTo(Vector2.One, 400, Easing.OutElasticHalf);
-            countdownComponents.FadeOut().Then().Delay(50).FadeTo(1, 100);
+            countdownComponents.FadeOut().Delay(50).FadeTo(1, 100);
 
             // Reset states for various components.
             countdownBackground.FadeIn();
@@ -166,7 +166,7 @@ namespace osu.Game.Screens.Play
             if (countdownComplete)
             {
                 countdownProgress.ScaleTo(2f, 300, Easing.OutQuint);
-                countdownProgress.Delay(200).FadeOut(100, Easing.Out);
+                countdownProgress.FadeOut(100, Easing.Out);
             }
             else
                 countdownProgress.FadeOut();

From 888245b44fa13e46a7fb23b4a801f3fd36d38fee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Mar 2024 22:44:26 +0800
Subject: [PATCH 378/930] Reorder methods

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 38 +++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 7c34050bbf..4b703ec3cf 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -131,6 +131,25 @@ namespace osu.Game.Screens.Play
             }, countdown_time);
         }
 
+        protected override void PopOut()
+        {
+            this.Delay(300).FadeOut();
+
+            outerContent.FadeOut();
+            countdownBackground.FadeOut();
+            countdownText.FadeOut();
+
+            if (countdownComplete)
+            {
+                countdownProgress.ScaleTo(2f, 300, Easing.OutQuint);
+                countdownProgress.FadeOut(100, Easing.Out);
+            }
+            else
+                countdownProgress.FadeOut();
+
+            scheduledResume?.Cancel();
+        }
+
         protected override void Update()
         {
             base.Update();
@@ -154,24 +173,5 @@ namespace osu.Game.Screens.Play
 
             countdownCount = newCount;
         }
-
-        protected override void PopOut()
-        {
-            this.Delay(300).FadeOut();
-
-            outerContent.FadeOut();
-            countdownBackground.FadeOut();
-            countdownText.FadeOut();
-
-            if (countdownComplete)
-            {
-                countdownProgress.ScaleTo(2f, 300, Easing.OutQuint);
-                countdownProgress.FadeOut(100, Easing.Out);
-            }
-            else
-                countdownProgress.FadeOut();
-
-            scheduledResume?.Cancel();
-        }
     }
 }

From 2845303a74986d4310d7fb4a77b56a1bd980a8d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Mar 2024 22:44:57 +0800
Subject: [PATCH 379/930] Fix non-matching scale outwards animation

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 4b703ec3cf..c3c98510e3 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Play
             if (countdownComplete)
             {
                 countdownProgress.ScaleTo(2f, 300, Easing.OutQuint);
-                countdownProgress.FadeOut(100, Easing.Out);
+                countdownProgress.FadeOut(300, Easing.OutQuint);
             }
             else
                 countdownProgress.FadeOut();

From 23975d4dd162b503ccb0e79f0c0d570c5606f901 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 14 Mar 2024 22:49:53 +0800
Subject: [PATCH 380/930] Add flash and reduce overall time for countdown to 2
 seconds

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index c3c98510e3..fd1ce5d829 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -22,12 +22,15 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public partial class DelayedResumeOverlay : ResumeOverlay
     {
+        // todo: this shouldn't define its own colour provider, but nothing in Player screen does, so let's do that for now.
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+
         private const float outer_size = 200;
         private const float inner_size = 150;
         private const float progress_stroke_width = 7;
         private const float progress_size = inner_size + progress_stroke_width / 2f;
 
-        private const double countdown_time = 3000;
+        private const double countdown_time = 2000;
 
         protected override LocalisableString Message => string.Empty;
 
@@ -53,9 +56,6 @@ namespace osu.Game.Screens.Play
         [BackgroundDependencyLoader]
         private void load()
         {
-            // todo: this shouldn't define its own colour provider, but nothing in Player screen does, so let's do that for now.
-            var colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
-
             Add(outerContent = new Circle
             {
                 Anchor = Anchor.Centre,
@@ -169,6 +169,8 @@ namespace osu.Game.Screens.Play
                 countdownText.Text = Math.Max(1, newCount).ToString();
                 countdownText.ScaleTo(0.25f).Then().ScaleTo(1, 200, Easing.OutQuint);
                 outerContent.Delay(25).Then().ScaleTo(1.05f, 100).Then().ScaleTo(1f, 200, Easing.Out);
+
+                countdownBackground.FlashColour(colourProvider.Background3, 400, Easing.Out);
             }
 
             countdownCount = newCount;

From 1aa695add9db68d3aef453f476486209a3aeb5f5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 09:14:17 +0100
Subject: [PATCH 381/930] Implement alternate design of player loader
 disclaimers

---
 .../Screens/Play/PlayerLoaderDisclaimer.cs    | 67 +++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs

diff --git a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
new file mode 100644
index 0000000000..c8112055c8
--- /dev/null
+++ b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
@@ -0,0 +1,67 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Localisation;
+using osu.Game.Graphics;
+using osu.Game.Overlays;
+using osuTK;
+
+namespace osu.Game.Screens.Play
+{
+    public partial class PlayerLoaderDisclaimer : CompositeDrawable
+    {
+        private readonly LocalisableString title;
+        private readonly LocalisableString content;
+
+        public PlayerLoaderDisclaimer(LocalisableString title, LocalisableString content)
+        {
+            this.title = title;
+            this.content = content;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuColour colours)
+        {
+            Width = SettingsToolboxGroup.CONTAINER_WIDTH;
+            AutoSizeAxes = Axes.Y;
+
+            InternalChildren = new Drawable[]
+            {
+                new Circle
+                {
+                    Width = 7,
+                    Height = 15,
+                    Margin = new MarginPadding { Top = 2 },
+                    Colour = colours.Orange1,
+                },
+                new FillFlowContainer
+                {
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y,
+                    Padding = new MarginPadding { Left = 12 },
+                    Direction = FillDirection.Vertical,
+                    Spacing = new Vector2(0, 2),
+                    Children = new[]
+                    {
+                        new TextFlowContainer(t => t.Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17))
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Text = title,
+                        },
+                        new TextFlowContainer(t => t.Font = OsuFont.GetFont(size: 16))
+                        {
+                            RelativeSizeAxes = Axes.X,
+                            AutoSizeAxes = Axes.Y,
+                            Text = content,
+                        }
+                    }
+                }
+            };
+        }
+    }
+}

From 42ae18976ff4287567f1b69c27d27215353573a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 09:27:33 +0100
Subject: [PATCH 382/930] Replace existing epilepsy warning with inline display

---
 .../Visual/Gameplay/TestScenePlayerLoader.cs  |  35 +-----
 osu.Game/Screens/Play/EpilepsyWarning.cs      | 102 ------------------
 osu.Game/Screens/Play/PlayerLoader.cs         |  67 +++++-------
 3 files changed, 26 insertions(+), 178 deletions(-)
 delete mode 100644 osu.Game/Screens/Play/EpilepsyWarning.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index c6827d4197..dac8545729 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -334,13 +334,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for current", () => loader.IsCurrentScreen());
 
-            AddAssert($"epilepsy warning {(warning ? "present" : "absent")}", () => (getWarning() != null) == warning);
-
-            if (warning)
-            {
-                AddUntilStep("sound volume decreased", () => Beatmap.Value.Track.AggregateVolume.Value == 0.25);
-                AddUntilStep("sound volume restored", () => Beatmap.Value.Track.AggregateVolume.Value == 1);
-            }
+            AddAssert($"epilepsy warning {(warning ? "present" : "absent")}", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Count(), () => Is.EqualTo(warning ? 1 : 0));
 
             restoreVolumes();
         }
@@ -357,30 +351,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for current", () => loader.IsCurrentScreen());
 
-            AddUntilStep("epilepsy warning absent", () => getWarning() == null);
-
-            restoreVolumes();
-        }
-
-        [Test]
-        public void TestEpilepsyWarningEarlyExit()
-        {
-            saveVolumes();
-            setFullVolume();
-
-            AddStep("enable storyboards", () => config.SetValue(OsuSetting.ShowStoryboard, true));
-            AddStep("set epilepsy warning", () => epilepsyWarning = true);
-            AddStep("load dummy beatmap", () => resetPlayer(false));
-
-            AddUntilStep("wait for current", () => loader.IsCurrentScreen());
-
-            AddUntilStep("wait for epilepsy warning", () => getWarning().Alpha > 0);
-            AddUntilStep("warning is shown", () => getWarning().State.Value == Visibility.Visible);
-
-            AddStep("exit early", () => loader.Exit());
-
-            AddUntilStep("warning is hidden", () => getWarning().State.Value == Visibility.Hidden);
-            AddUntilStep("sound volume restored", () => Beatmap.Value.Track.AggregateVolume.Value == 1);
+            AddUntilStep("epilepsy warning absent", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Single().Alpha, () => Is.Zero);
 
             restoreVolumes();
         }
@@ -479,8 +450,6 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("click notification", () => notification.TriggerClick());
         }
 
-        private EpilepsyWarning getWarning() => loader.ChildrenOfType<EpilepsyWarning>().SingleOrDefault(w => w.IsAlive);
-
         private partial class TestPlayerLoader : PlayerLoader
         {
             public new VisualSettings VisualSettings => base.VisualSettings;
diff --git a/osu.Game/Screens/Play/EpilepsyWarning.cs b/osu.Game/Screens/Play/EpilepsyWarning.cs
deleted file mode 100644
index 6316bbdb4e..0000000000
--- a/osu.Game/Screens/Play/EpilepsyWarning.cs
+++ /dev/null
@@ -1,102 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-#nullable disable
-
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
-using osu.Game.Screens.Backgrounds;
-using osuTK;
-
-namespace osu.Game.Screens.Play
-{
-    public partial class EpilepsyWarning : VisibilityContainer
-    {
-        public const double FADE_DURATION = 250;
-
-        public EpilepsyWarning()
-        {
-            RelativeSizeAxes = Axes.Both;
-            Alpha = 0f;
-        }
-
-        private BackgroundScreenBeatmap dimmableBackground;
-
-        public BackgroundScreenBeatmap DimmableBackground
-        {
-            get => dimmableBackground;
-            set
-            {
-                dimmableBackground = value;
-
-                if (IsLoaded)
-                    updateBackgroundFade();
-            }
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            Children = new Drawable[]
-            {
-                new FillFlowContainer
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Vertical,
-                    Children = new Drawable[]
-                    {
-                        new SpriteIcon
-                        {
-                            Colour = colours.Yellow,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Icon = FontAwesome.Solid.ExclamationTriangle,
-                            Size = new Vector2(50),
-                        },
-                        new OsuTextFlowContainer(s => s.Font = OsuFont.GetFont(size: 25))
-                        {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            TextAnchor = Anchor.Centre,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                        }.With(tfc =>
-                        {
-                            tfc.AddText("This beatmap contains scenes with ");
-                            tfc.AddText("rapidly flashing colours", s =>
-                            {
-                                s.Font = s.Font.With(weight: FontWeight.Bold);
-                                s.Colour = colours.Yellow;
-                            });
-                            tfc.AddText(".");
-
-                            tfc.NewParagraph();
-                            tfc.AddText("Please take caution if you are affected by epilepsy.");
-                        }),
-                    }
-                }
-            };
-        }
-
-        protected override void PopIn()
-        {
-            updateBackgroundFade();
-
-            this.FadeIn(FADE_DURATION, Easing.OutQuint);
-        }
-
-        private void updateBackgroundFade()
-        {
-            DimmableBackground?.FadeColour(OsuColour.Gray(0.5f), FADE_DURATION, Easing.OutQuint);
-        }
-
-        protected override void PopOut() => this.FadeOut(FADE_DURATION);
-    }
-}
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index aa730a8e0f..75240ba2ba 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -71,6 +71,7 @@ namespace osu.Game.Screens.Play
 
         protected Task? DisposalTask { get; private set; }
 
+        private FillFlowContainer disclaimers = null!;
         private OsuScrollContainer settingsScroll = null!;
 
         private Bindable<bool> showStoryboards = null!;
@@ -137,7 +138,7 @@ namespace osu.Game.Screens.Play
 
         private ScheduledDelegate? scheduledPushPlayer;
 
-        private EpilepsyWarning? epilepsyWarning;
+        private PlayerLoaderDisclaimer? epilepsyWarning;
 
         private bool quickRestart;
 
@@ -188,6 +189,16 @@ namespace osu.Game.Screens.Play
                         Origin = Anchor.Centre,
                     },
                 }),
+                disclaimers = new FillFlowContainer
+                {
+                    Anchor = Anchor.TopLeft,
+                    Origin = Anchor.TopLeft,
+                    RelativeSizeAxes = Axes.Y,
+                    AutoSizeAxes = Axes.X,
+                    Direction = FillDirection.Vertical,
+                    Padding = new MarginPadding(padding),
+                    Spacing = new Vector2(padding),
+                },
                 settingsScroll = new OsuScrollContainer
                 {
                     Anchor = Anchor.TopRight,
@@ -216,11 +227,7 @@ namespace osu.Game.Screens.Play
 
             if (Beatmap.Value.BeatmapInfo.EpilepsyWarning)
             {
-                AddInternal(epilepsyWarning = new EpilepsyWarning
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                });
+                disclaimers.Add(epilepsyWarning = new PlayerLoaderDisclaimer("This beatmap contains scenes with rapidly flashing colours", "Please take caution if you are affected by epilepsy."));
             }
         }
 
@@ -229,6 +236,9 @@ namespace osu.Game.Screens.Play
             base.LoadComplete();
 
             inputManager = GetContainingInputManager();
+
+            showStoryboards.BindValueChanged(val => epilepsyWarning?.FadeTo(val.NewValue ? 1 : 0, 250, Easing.OutQuint), true);
+            epilepsyWarning?.FinishTransforms(true);
         }
 
         #region Screen handling
@@ -237,15 +247,10 @@ namespace osu.Game.Screens.Play
         {
             base.OnEntering(e);
 
-            ApplyToBackground(b =>
-            {
-                if (epilepsyWarning != null)
-                    epilepsyWarning.DimmableBackground = b;
-            });
-
             Beatmap.Value.Track.AddAdjustment(AdjustableProperty.Volume, volumeAdjustment);
 
-            // Start off-screen.
+            // Start side content off-screen.
+            disclaimers.MoveToX(-disclaimers.DrawWidth);
             settingsScroll.MoveToX(settingsScroll.DrawWidth);
 
             content.ScaleTo(0.7f);
@@ -301,9 +306,6 @@ namespace osu.Game.Screens.Play
             cancelLoad();
             ContentOut();
 
-            // If the load sequence was interrupted, the epilepsy warning may already be displayed (or in the process of being displayed).
-            epilepsyWarning?.Hide();
-
             // Ensure the screen doesn't expire until all the outwards fade operations have completed.
             this.Delay(CONTENT_OUT_DURATION).FadeOut();
 
@@ -433,6 +435,8 @@ namespace osu.Game.Screens.Play
             content.FadeInFromZero(500, Easing.OutQuint);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
 
+            disclaimers.FadeInFromZero(500, Easing.Out)
+                       .MoveToX(0, 500, Easing.OutQuint);
             settingsScroll.FadeInFromZero(500, Easing.Out)
                           .MoveToX(0, 500, Easing.OutQuint);
 
@@ -466,6 +470,8 @@ namespace osu.Game.Screens.Play
                        lowPassFilter = null;
                    });
 
+            disclaimers.FadeOut(CONTENT_OUT_DURATION, Easing.Out)
+                       .MoveToX(-disclaimers.DrawWidth, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
             settingsScroll.FadeOut(CONTENT_OUT_DURATION, Easing.OutQuint)
                           .MoveToX(settingsScroll.DrawWidth, CONTENT_OUT_DURATION * 2, Easing.OutQuint);
 
@@ -503,33 +509,8 @@ namespace osu.Game.Screens.Play
 
                 TransformSequence<PlayerLoader> pushSequence = this.Delay(0);
 
-                // only show if the warning was created (i.e. the beatmap needs it)
-                // and this is not a restart of the map (the warning expires after first load).
-                //
-                // note the late check of storyboard enable as the user may have just changed it
-                // from the settings on the loader screen.
-                if (epilepsyWarning?.IsAlive == true && showStoryboards.Value)
-                {
-                    const double epilepsy_display_length = 3000;
-
-                    pushSequence
-                        .Delay(CONTENT_OUT_DURATION)
-                        .Schedule(() => epilepsyWarning.State.Value = Visibility.Visible)
-                        .TransformBindableTo(volumeAdjustment, 0.25, EpilepsyWarning.FADE_DURATION, Easing.OutQuint)
-                        .Delay(epilepsy_display_length)
-                        .Schedule(() =>
-                        {
-                            epilepsyWarning.Hide();
-                            epilepsyWarning.Expire();
-                        })
-                        .Delay(EpilepsyWarning.FADE_DURATION);
-                }
-                else
-                {
-                    // This goes hand-in-hand with the restoration of low pass filter in contentOut().
-                    this.TransformBindableTo(volumeAdjustment, 0, CONTENT_OUT_DURATION, Easing.OutCubic);
-                    epilepsyWarning?.Expire();
-                }
+                // This goes hand-in-hand with the restoration of low pass filter in contentOut().
+                this.TransformBindableTo(volumeAdjustment, 0, CONTENT_OUT_DURATION, Easing.OutCubic);
 
                 pushSequence.Schedule(() =>
                 {

From f3a444b7aca2295e92d473e7fe84a23aefd239b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 09:41:37 +0100
Subject: [PATCH 383/930] Add disclaimer for loved/qualified status

---
 .../Visual/Gameplay/TestScenePlayerLoader.cs  | 43 ++++++++++++++++++-
 osu.Game/Screens/Play/PlayerLoader.cs         | 12 ++++++
 2 files changed, 54 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index dac8545729..91e35b067b 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -16,6 +16,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
@@ -37,6 +38,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         private TestPlayer player;
 
         private bool epilepsyWarning;
+        private BeatmapOnlineStatus onlineStatus;
 
         [Resolved]
         private AudioManager audioManager { get; set; }
@@ -118,8 +120,9 @@ namespace osu.Game.Tests.Visual.Gameplay
             // Add intro time to test quick retry skipping (TestQuickRetry).
             workingBeatmap.BeatmapInfo.AudioLeadIn = 60000;
 
-            // Turn on epilepsy warning to test warning display (TestEpilepsyWarning).
+            // Set up data for testing disclaimer display.
             workingBeatmap.BeatmapInfo.EpilepsyWarning = epilepsyWarning;
+            workingBeatmap.BeatmapInfo.Status = onlineStatus;
 
             Beatmap.Value = workingBeatmap;
 
@@ -356,6 +359,44 @@ namespace osu.Game.Tests.Visual.Gameplay
             restoreVolumes();
         }
 
+        [TestCase(BeatmapOnlineStatus.Loved, 1)]
+        [TestCase(BeatmapOnlineStatus.Qualified, 1)]
+        [TestCase(BeatmapOnlineStatus.Graveyard, 0)]
+        public void TestStatusWarning(BeatmapOnlineStatus status, int expectedDisclaimerCount)
+        {
+            saveVolumes();
+            setFullVolume();
+
+            AddStep("enable storyboards", () => config.SetValue(OsuSetting.ShowStoryboard, true));
+            AddStep("disable epilepsy warning", () => epilepsyWarning = false);
+            AddStep("set beatmap status", () => onlineStatus = status);
+            AddStep("load dummy beatmap", () => resetPlayer(false));
+
+            AddUntilStep("wait for current", () => loader.IsCurrentScreen());
+
+            AddAssert($"disclaimer count is {expectedDisclaimerCount}", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Count(), () => Is.EqualTo(expectedDisclaimerCount));
+
+            restoreVolumes();
+        }
+
+        [Test]
+        public void TestCombinedWarnings()
+        {
+            saveVolumes();
+            setFullVolume();
+
+            AddStep("enable storyboards", () => config.SetValue(OsuSetting.ShowStoryboard, true));
+            AddStep("disable epilepsy warning", () => epilepsyWarning = true);
+            AddStep("set beatmap status", () => onlineStatus = BeatmapOnlineStatus.Loved);
+            AddStep("load dummy beatmap", () => resetPlayer(false));
+
+            AddUntilStep("wait for current", () => loader.IsCurrentScreen());
+
+            AddAssert($"disclaimer count is 2", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Count(), () => Is.EqualTo(2));
+
+            restoreVolumes();
+        }
+
         [TestCase(true, 1.0, false)] // on battery, above cutoff --> no warning
         [TestCase(false, 0.1, false)] // not on battery, below cutoff --> no warning
         [TestCase(true, 0.25, true)] // on battery, at cutoff --> warning
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 75240ba2ba..2d75b69b4a 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -18,6 +18,7 @@ using osu.Framework.Threading;
 using osu.Framework.Utils;
 using osu.Game.Audio;
 using osu.Game.Audio.Effects;
+using osu.Game.Beatmaps;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
@@ -229,6 +230,17 @@ namespace osu.Game.Screens.Play
             {
                 disclaimers.Add(epilepsyWarning = new PlayerLoaderDisclaimer("This beatmap contains scenes with rapidly flashing colours", "Please take caution if you are affected by epilepsy."));
             }
+
+            switch (Beatmap.Value.BeatmapInfo.Status)
+            {
+                case BeatmapOnlineStatus.Loved:
+                    disclaimers.Add(new PlayerLoaderDisclaimer("This beatmap is loved", "No performance points will be awarded.\nLeaderboards may be reset by the beatmap creator."));
+                    break;
+
+                case BeatmapOnlineStatus.Qualified:
+                    disclaimers.Add(new PlayerLoaderDisclaimer("This beatmap is qualified", "No performance points will be awarded.\nLeaderboards will be reset when the beatmap is ranked."));
+                    break;
+            }
         }
 
         protected override void LoadComplete()

From 4688a53cf435861af05f8253d029f30a4e5db342 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 09:43:09 +0100
Subject: [PATCH 384/930] Stay on player loader a bit longer if disclaimers are
 present

Just to make reading the text easier.
---
 osu.Game/Screens/Play/PlayerLoader.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 2d75b69b4a..29ad6d2a47 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Play
 
         protected const double CONTENT_OUT_DURATION = 300;
 
-        protected virtual double PlayerPushDelay => 1800;
+        protected virtual double PlayerPushDelay => 1800 + disclaimers.Count * 500;
 
         public override bool HideOverlaysOnEnter => hideOverlays;
 

From 4e2098adb86c73f8391255331c08dc5349567e67 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 09:46:18 +0100
Subject: [PATCH 385/930] Fix test crosstalk

---
 .../Visual/Gameplay/TestScenePlayerLoader.cs      | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index 91e35b067b..0ec4284a00 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -37,8 +37,8 @@ namespace osu.Game.Tests.Visual.Gameplay
         private TestPlayerLoader loader;
         private TestPlayer player;
 
-        private bool epilepsyWarning;
-        private BeatmapOnlineStatus onlineStatus;
+        private bool? epilepsyWarning;
+        private BeatmapOnlineStatus? onlineStatus;
 
         [Resolved]
         private AudioManager audioManager { get; set; }
@@ -83,7 +83,12 @@ namespace osu.Game.Tests.Visual.Gameplay
         }
 
         [SetUp]
-        public void Setup() => Schedule(() => player = null);
+        public void Setup() => Schedule(() =>
+        {
+            player = null;
+            epilepsyWarning = null;
+            onlineStatus = null;
+        });
 
         [SetUpSteps]
         public override void SetUpSteps()
@@ -121,8 +126,8 @@ namespace osu.Game.Tests.Visual.Gameplay
             workingBeatmap.BeatmapInfo.AudioLeadIn = 60000;
 
             // Set up data for testing disclaimer display.
-            workingBeatmap.BeatmapInfo.EpilepsyWarning = epilepsyWarning;
-            workingBeatmap.BeatmapInfo.Status = onlineStatus;
+            workingBeatmap.BeatmapInfo.EpilepsyWarning = epilepsyWarning ?? false;
+            workingBeatmap.BeatmapInfo.Status = onlineStatus ?? BeatmapOnlineStatus.Ranked;
 
             Beatmap.Value = workingBeatmap;
 

From 49a087f7fcf764fe4764e4dff0c178287f2dc5f8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 10:58:00 +0100
Subject: [PATCH 386/930] Add localisation support

---
 osu.Game/Localisation/PlayerLoaderStrings.cs | 48 ++++++++++++++++++++
 osu.Game/Screens/Play/PlayerLoader.cs        |  6 +--
 2 files changed, 51 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game/Localisation/PlayerLoaderStrings.cs

diff --git a/osu.Game/Localisation/PlayerLoaderStrings.cs b/osu.Game/Localisation/PlayerLoaderStrings.cs
new file mode 100644
index 0000000000..eba98c7aa7
--- /dev/null
+++ b/osu.Game/Localisation/PlayerLoaderStrings.cs
@@ -0,0 +1,48 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class PlayerLoaderStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.PlayerLoader";
+
+        /// <summary>
+        /// "This beatmap contains scenes with rapidly flashing colours"
+        /// </summary>
+        public static LocalisableString EpilepsyWarningTitle => new TranslatableString(getKey(@"epilepsy_warning_title"), @"This beatmap contains scenes with rapidly flashing colours");
+
+        /// <summary>
+        /// "Please take caution if you are affected by epilepsy."
+        /// </summary>
+        public static LocalisableString EpilepsyWarningContent => new TranslatableString(getKey(@"epilepsy_warning_content"), @"Please take caution if you are affected by epilepsy.");
+
+        /// <summary>
+        /// "This beatmap is loved"
+        /// </summary>
+        public static LocalisableString LovedBeatmapDisclaimerTitle => new TranslatableString(getKey(@"loved_beatmap_disclaimer_title"), @"This beatmap is loved");
+
+        /// <summary>
+        /// "No performance points will be awarded.
+        /// Leaderboards may be reset by the beatmap creator."
+        /// </summary>
+        public static LocalisableString LovedBeatmapDisclaimerContent => new TranslatableString(getKey(@"loved_beatmap_disclaimer_content"), @"No performance points will be awarded.
+Leaderboards may be reset by the beatmap creator.");
+
+        /// <summary>
+        /// "This beatmap is qualified"
+        /// </summary>
+        public static LocalisableString QualifiedBeatmapDisclaimerTitle => new TranslatableString(getKey(@"qualified_beatmap_disclaimer_title"), @"This beatmap is qualified");
+
+        /// <summary>
+        /// "No performance points will be awarded.
+        /// Leaderboards will be reset when the beatmap is ranked."
+        /// </summary>
+        public static LocalisableString QualifiedBeatmapDisclaimerContent => new TranslatableString(getKey(@"qualified_beatmap_disclaimer_content"), @"No performance points will be awarded.
+Leaderboards will be reset when the beatmap is ranked.");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 29ad6d2a47..ad9814e8c9 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -228,17 +228,17 @@ namespace osu.Game.Screens.Play
 
             if (Beatmap.Value.BeatmapInfo.EpilepsyWarning)
             {
-                disclaimers.Add(epilepsyWarning = new PlayerLoaderDisclaimer("This beatmap contains scenes with rapidly flashing colours", "Please take caution if you are affected by epilepsy."));
+                disclaimers.Add(epilepsyWarning = new PlayerLoaderDisclaimer(PlayerLoaderStrings.EpilepsyWarningTitle, PlayerLoaderStrings.EpilepsyWarningContent));
             }
 
             switch (Beatmap.Value.BeatmapInfo.Status)
             {
                 case BeatmapOnlineStatus.Loved:
-                    disclaimers.Add(new PlayerLoaderDisclaimer("This beatmap is loved", "No performance points will be awarded.\nLeaderboards may be reset by the beatmap creator."));
+                    disclaimers.Add(new PlayerLoaderDisclaimer(PlayerLoaderStrings.LovedBeatmapDisclaimerTitle, PlayerLoaderStrings.LovedBeatmapDisclaimerContent));
                     break;
 
                 case BeatmapOnlineStatus.Qualified:
-                    disclaimers.Add(new PlayerLoaderDisclaimer("This beatmap is qualified", "No performance points will be awarded.\nLeaderboards will be reset when the beatmap is ranked."));
+                    disclaimers.Add(new PlayerLoaderDisclaimer(PlayerLoaderStrings.QualifiedBeatmapDisclaimerTitle, PlayerLoaderStrings.QualifiedBeatmapDisclaimerContent));
                     break;
             }
         }

From 5513a727488fb1825a2ca60514ab478b92623b30 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 10:33:32 +0100
Subject: [PATCH 387/930] Improve hiding transition when multiple disclaimers
 are visible

---
 osu.Game/Screens/Play/PlayerLoader.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index ad9814e8c9..0cc8ed0f4b 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -194,8 +194,10 @@ namespace osu.Game.Screens.Play
                 {
                     Anchor = Anchor.TopLeft,
                     Origin = Anchor.TopLeft,
-                    RelativeSizeAxes = Axes.Y,
-                    AutoSizeAxes = Axes.X,
+                    Width = SettingsToolboxGroup.CONTAINER_WIDTH + padding * 2,
+                    AutoSizeAxes = Axes.Y,
+                    AutoSizeDuration = 250,
+                    AutoSizeEasing = Easing.OutQuint,
                     Direction = FillDirection.Vertical,
                     Padding = new MarginPadding(padding),
                     Spacing = new Vector2(padding),

From 87682008fd0de936edb734c69d49cb0e7e4c4b78 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 11:26:48 +0100
Subject: [PATCH 388/930] Fix code quality inspection

---
 osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
index 0ec4284a00..4b00a86950 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestScenePlayerLoader.cs
@@ -397,7 +397,7 @@ namespace osu.Game.Tests.Visual.Gameplay
 
             AddUntilStep("wait for current", () => loader.IsCurrentScreen());
 
-            AddAssert($"disclaimer count is 2", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Count(), () => Is.EqualTo(2));
+            AddAssert("disclaimer count is 2", () => this.ChildrenOfType<PlayerLoaderDisclaimer>().Count(), () => Is.EqualTo(2));
 
             restoreVolumes();
         }

From 51568ba06a0465b3e3c3de13f4d9ce885c6e82ad Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 11:31:45 +0100
Subject: [PATCH 389/930] Add background to disclaimers

---
 .../Screens/Play/PlayerLoaderDisclaimer.cs    | 52 ++++++++++++-------
 1 file changed, 34 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
index c8112055c8..b41a2d3112 100644
--- a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
+++ b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
@@ -24,40 +24,56 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
+        private void load(OsuColour colours, OverlayColourProvider colourProvider)
         {
-            Width = SettingsToolboxGroup.CONTAINER_WIDTH;
+            RelativeSizeAxes = Axes.X;
             AutoSizeAxes = Axes.Y;
+            Masking = true;
+            CornerRadius = 5;
 
             InternalChildren = new Drawable[]
             {
-                new Circle
+                new Box
                 {
-                    Width = 7,
-                    Height = 15,
-                    Margin = new MarginPadding { Top = 2 },
-                    Colour = colours.Orange1,
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = colourProvider.Background4,
                 },
-                new FillFlowContainer
+                new Container
                 {
                     RelativeSizeAxes = Axes.X,
                     AutoSizeAxes = Axes.Y,
-                    Padding = new MarginPadding { Left = 12 },
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(0, 2),
-                    Children = new[]
+                    Padding = new MarginPadding(10),
+                    Children = new Drawable[]
                     {
-                        new TextFlowContainer(t => t.Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17))
+                        new Circle
                         {
-                            RelativeSizeAxes = Axes.X,
-                            AutoSizeAxes = Axes.Y,
-                            Text = title,
+                            Width = 7,
+                            Height = 15,
+                            Margin = new MarginPadding { Top = 2 },
+                            Colour = colours.Orange1,
                         },
-                        new TextFlowContainer(t => t.Font = OsuFont.GetFont(size: 16))
+                        new FillFlowContainer
                         {
                             RelativeSizeAxes = Axes.X,
                             AutoSizeAxes = Axes.Y,
-                            Text = content,
+                            Padding = new MarginPadding { Left = 12 },
+                            Direction = FillDirection.Vertical,
+                            Spacing = new Vector2(0, 2),
+                            Children = new[]
+                            {
+                                new TextFlowContainer(t => t.Font = OsuFont.GetFont(weight: FontWeight.Bold, size: 17))
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Text = title,
+                                },
+                                new TextFlowContainer(t => t.Font = OsuFont.GetFont(size: 16))
+                                {
+                                    RelativeSizeAxes = Axes.X,
+                                    AutoSizeAxes = Axes.Y,
+                                    Text = content,
+                                }
+                            }
                         }
                     }
                 }

From e6883b841802c5a8689ca80b13ca277022901b71 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 11:38:51 +0100
Subject: [PATCH 390/930] Tweak visuals further

---
 osu.Game/Screens/Play/PlayerLoader.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 0cc8ed0f4b..196180f3dd 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -200,7 +200,7 @@ namespace osu.Game.Screens.Play
                     AutoSizeEasing = Easing.OutQuint,
                     Direction = FillDirection.Vertical,
                     Padding = new MarginPadding(padding),
-                    Spacing = new Vector2(padding),
+                    Spacing = new Vector2(20),
                 },
                 settingsScroll = new OsuScrollContainer
                 {
@@ -269,9 +269,12 @@ namespace osu.Game.Screens.Play
 
             content.ScaleTo(0.7f);
 
-            contentIn();
+            const double metadata_delay = 750;
 
-            MetadataInfo.Delay(750).FadeIn(500, Easing.OutQuint);
+            contentIn();
+            MetadataInfo.Delay(metadata_delay).FadeIn(500, Easing.OutQuint);
+            disclaimers.Delay(metadata_delay).FadeInFromZero(500, Easing.Out)
+                       .MoveToX(0, 500, Easing.OutQuint);
 
             // after an initial delay, start the debounced load check.
             // this will continue to execute even after resuming back on restart.
@@ -449,8 +452,6 @@ namespace osu.Game.Screens.Play
             content.FadeInFromZero(500, Easing.OutQuint);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
 
-            disclaimers.FadeInFromZero(500, Easing.Out)
-                       .MoveToX(0, 500, Easing.OutQuint);
             settingsScroll.FadeInFromZero(500, Easing.Out)
                           .MoveToX(0, 500, Easing.OutQuint);
 

From a78210c88f6d3d519c4aa884033b3a30e8e82657 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 15 Mar 2024 11:45:27 +0100
Subject: [PATCH 391/930] Handle hover so that users can hover disclaimer to
 block load & read it

---
 osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
index b41a2d3112..9dd5a3832c 100644
--- a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
+++ b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
 using osu.Game.Overlays;
@@ -79,5 +80,8 @@ namespace osu.Game.Screens.Play
                 }
             };
         }
+
+        // handle hover so that users can hover the disclaimer to delay load if they want to read it.
+        protected override bool OnHover(HoverEvent e) => true;
     }
 }

From 0f8d526453b1ada099a52fa7d69340b9cb04963f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 10:09:49 +0800
Subject: [PATCH 392/930] Adjust timings and delay disclaimers the same as
 settings

---
 osu.Game/Screens/Play/PlayerLoader.cs | 20 ++++++++++++--------
 1 file changed, 12 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 196180f3dd..75c97d594d 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -269,12 +269,10 @@ namespace osu.Game.Screens.Play
 
             content.ScaleTo(0.7f);
 
-            const double metadata_delay = 750;
+            const double metadata_delay = 500;
 
-            contentIn();
             MetadataInfo.Delay(metadata_delay).FadeIn(500, Easing.OutQuint);
-            disclaimers.Delay(metadata_delay).FadeInFromZero(500, Easing.Out)
-                       .MoveToX(0, 500, Easing.OutQuint);
+            contentIn(metadata_delay + 250);
 
             // after an initial delay, start the debounced load check.
             // this will continue to execute even after resuming back on restart.
@@ -352,7 +350,7 @@ namespace osu.Game.Screens.Play
             {
                 if (this.IsCurrentScreen())
                     content.StartTracking(logo, resuming ? 0 : 500, Easing.InOutExpo);
-            }, resuming ? 0 : 500);
+            }, resuming ? 0 : 250);
         }
 
         protected override void LogoExiting(OsuLogo logo)
@@ -445,15 +443,21 @@ namespace osu.Game.Screens.Play
             this.MakeCurrent();
         }
 
-        private void contentIn()
+        private void contentIn(double delayBeforeSideDisplays = 0)
         {
             MetadataInfo.Loading = true;
 
             content.FadeInFromZero(500, Easing.OutQuint);
             content.ScaleTo(1, 650, Easing.OutQuint).Then().Schedule(prepareNewPlayer);
 
-            settingsScroll.FadeInFromZero(500, Easing.Out)
-                          .MoveToX(0, 500, Easing.OutQuint);
+            using (BeginDelayedSequence(delayBeforeSideDisplays))
+            {
+                settingsScroll.FadeInFromZero(500, Easing.Out)
+                              .MoveToX(0, 500, Easing.OutQuint);
+
+                disclaimers.FadeInFromZero(500, Easing.Out)
+                           .MoveToX(0, 500, Easing.OutQuint);
+            }
 
             AddRangeInternal(new[]
             {

From a49c4ebea634cff84243192ef59e1fa273f5042f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 10:23:21 +0800
Subject: [PATCH 393/930] Match settings panels' backgrounds visually and
 behaviourally

---
 .../Screens/Play/PlayerLoaderDisclaimer.cs    | 26 ++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
index 9dd5a3832c..3637a4b210 100644
--- a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
+++ b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Screens.Play
         private readonly LocalisableString title;
         private readonly LocalisableString content;
 
+        private Box background = null!;
+
         public PlayerLoaderDisclaimer(LocalisableString title, LocalisableString content)
         {
             this.title = title;
@@ -34,10 +36,11 @@ namespace osu.Game.Screens.Play
 
             InternalChildren = new Drawable[]
             {
-                new Box
+                background = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
                     Colour = colourProvider.Background4,
+                    Alpha = 0.1f,
                 },
                 new Container
                 {
@@ -81,7 +84,24 @@ namespace osu.Game.Screens.Play
             };
         }
 
-        // handle hover so that users can hover the disclaimer to delay load if they want to read it.
-        protected override bool OnHover(HoverEvent e) => true;
+        protected override bool OnHover(HoverEvent e)
+        {
+            updateFadeState();
+
+            // handle hover so that users can hover the disclaimer to delay load if they want to read it.
+            return true;
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            updateFadeState();
+            base.OnHoverLost(e);
+        }
+
+        private void updateFadeState()
+        {
+            // Matches SettingsToolboxGroup
+            background.FadeTo(IsHovered ? 1 : 0.1f, (float)500, Easing.OutQuint);
+        }
     }
 }

From bde3da2746c4f80e33dd9a632a8a9d95e7bef186 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 11:11:42 +0800
Subject: [PATCH 394/930] Fix failing test

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs      | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 204dea39b2..7d517b3155 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.PolygonExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
@@ -90,12 +91,13 @@ namespace osu.Game.Tests.Visual.Background
             AddStep("Start player loader", () => songSelect.Push(playerLoader = new TestPlayerLoader(player = new LoadBlockingTestPlayer { BlockLoad = true })));
             AddUntilStep("Wait for Player Loader to load", () => playerLoader?.IsLoaded ?? false);
             AddAssert("Background retained from song select", () => songSelect.IsBackgroundCurrent());
-            AddStep("Trigger background preview", () =>
+
+            AddUntilStep("Screen is dimmed and blur applied", () =>
             {
-                InputManager.MoveMouseTo(playerLoader.ScreenPos);
                 InputManager.MoveMouseTo(playerLoader.VisualSettingsPos);
+                return songSelect.IsBackgroundDimmed() && songSelect.IsUserBlurApplied();
             });
-            AddUntilStep("Screen is dimmed and blur applied", () => songSelect.IsBackgroundDimmed() && songSelect.IsUserBlurApplied());
+
             AddStep("Stop background preview", () => InputManager.MoveMouseTo(playerLoader.ScreenPos));
             AddUntilStep("Screen is undimmed and user blur removed", () => songSelect.IsBackgroundUndimmed() && songSelect.CheckBackgroundBlur(playerLoader.ExpectedBackgroundBlur));
         }

From a598ea5b97fd467395e901f8dbe08de4b620120b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 12:14:32 +0800
Subject: [PATCH 395/930] Remove unused using statement

---
 osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index 7d517b3155..c5540eae88 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -9,7 +9,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
-using osu.Framework.Extensions.PolygonExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;

From c0ae94dc60d6ac9df97784760cee4b5e6baa046b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 12:15:12 +0800
Subject: [PATCH 396/930] Attempt to fix test better

---
 .../Visual/Background/TestSceneUserDimBackgrounds.cs        | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
index c5540eae88..aac7689b1b 100644
--- a/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
+++ b/osu.Game.Tests/Visual/Background/TestSceneUserDimBackgrounds.cs
@@ -89,7 +89,11 @@ namespace osu.Game.Tests.Visual.Background
             setupUserSettings();
             AddStep("Start player loader", () => songSelect.Push(playerLoader = new TestPlayerLoader(player = new LoadBlockingTestPlayer { BlockLoad = true })));
             AddUntilStep("Wait for Player Loader to load", () => playerLoader?.IsLoaded ?? false);
-            AddAssert("Background retained from song select", () => songSelect.IsBackgroundCurrent());
+            AddAssert("Background retained from song select", () =>
+            {
+                InputManager.MoveMouseTo(playerLoader);
+                return songSelect.IsBackgroundCurrent();
+            });
 
             AddUntilStep("Screen is dimmed and blur applied", () =>
             {

From 15c0b1a2ec786dbdac2263655229430764f2a1d3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 16 Mar 2024 13:18:42 +0800
Subject: [PATCH 397/930] Remove redundant cast

---
 osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
index 3637a4b210..592af166ba 100644
--- a/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
+++ b/osu.Game/Screens/Play/PlayerLoaderDisclaimer.cs
@@ -101,7 +101,7 @@ namespace osu.Game.Screens.Play
         private void updateFadeState()
         {
             // Matches SettingsToolboxGroup
-            background.FadeTo(IsHovered ? 1 : 0.1f, (float)500, Easing.OutQuint);
+            background.FadeTo(IsHovered ? 1 : 0.1f, 500, Easing.OutQuint);
         }
     }
 }

From ea3a9314f9dd3bb19fcc0aff6c1b212cf96cc560 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Wed, 13 Mar 2024 23:08:00 +0300
Subject: [PATCH 398/930] Improve TimelineControlPointDisplay performance

---
 .../Timeline/TimelineControlPointDisplay.cs   | 104 +++++++++++++-----
 .../Components/Timeline/TopPointPiece.cs      |   6 +-
 2 files changed, 78 insertions(+), 32 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index cd97b293ba..60d113ef58 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
@@ -1,10 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Collections.Specialized;
-using System.Diagnostics;
-using System.Linq;
+using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Caching;
 using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Screens.Edit.Components.Timelines.Summary.Parts;
 
@@ -15,6 +14,16 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     /// </summary>
     public partial class TimelineControlPointDisplay : TimelinePart<TimelineControlPointGroup>
     {
+        [Resolved]
+        private Timeline? timeline { get; set; }
+
+        /// <summary>
+        /// The visible time/position range of the timeline.
+        /// </summary>
+        private (float min, float max) visibleRange = (float.MinValue, float.MaxValue);
+
+        private readonly Cached groupCache = new Cached();
+
         private readonly IBindableList<ControlPointGroup> controlPointGroups = new BindableList<ControlPointGroup>();
 
         protected override void LoadBeatmap(EditorBeatmap beatmap)
@@ -23,34 +32,71 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
             controlPointGroups.UnbindAll();
             controlPointGroups.BindTo(beatmap.ControlPointInfo.Groups);
-            controlPointGroups.BindCollectionChanged((_, args) =>
+            controlPointGroups.BindCollectionChanged((_, _) =>
             {
-                switch (args.Action)
-                {
-                    case NotifyCollectionChangedAction.Reset:
-                        Clear();
-                        break;
-
-                    case NotifyCollectionChangedAction.Add:
-                        Debug.Assert(args.NewItems != null);
-
-                        foreach (var group in args.NewItems.OfType<ControlPointGroup>())
-                            Add(new TimelineControlPointGroup(group));
-                        break;
-
-                    case NotifyCollectionChangedAction.Remove:
-                        Debug.Assert(args.OldItems != null);
-
-                        foreach (var group in args.OldItems.OfType<ControlPointGroup>())
-                        {
-                            var matching = Children.SingleOrDefault(gv => ReferenceEquals(gv.Group, group));
-
-                            matching?.Expire();
-                        }
-
-                        break;
-                }
+                invalidateGroups();
             }, true);
         }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            if (timeline == null || DrawWidth <= 0) return;
+
+            (float, float) newRange = (
+                (ToLocalSpace(timeline.ScreenSpaceDrawQuad.TopLeft).X - TopPointPiece.WIDTH) / DrawWidth * Content.RelativeChildSize.X,
+                (ToLocalSpace(timeline.ScreenSpaceDrawQuad.TopRight).X) / DrawWidth * Content.RelativeChildSize.X);
+
+            if (visibleRange != newRange)
+            {
+                visibleRange = newRange;
+                invalidateGroups();
+            }
+
+            if (!groupCache.IsValid)
+                recreateDrawableGroups();
+        }
+
+        private void invalidateGroups() => groupCache.Invalidate();
+
+        private void recreateDrawableGroups()
+        {
+            // Remove groups outside the visible range
+            for (int i = Count - 1; i >= 0; i--)
+            {
+                var g = Children[i];
+
+                if (!shouldBeVisible(g.Group))
+                    g.Expire();
+            }
+
+            // Add remaining ones
+            foreach (var group in controlPointGroups)
+            {
+                if (!shouldBeVisible(group))
+                    continue;
+
+                bool alreadyVisible = false;
+
+                foreach (var g in this)
+                {
+                    if (ReferenceEquals(g.Group, group))
+                    {
+                        alreadyVisible = true;
+                        break;
+                    }
+                }
+
+                if (alreadyVisible)
+                    continue;
+
+                Add(new TimelineControlPointGroup(group));
+            }
+
+            groupCache.Validate();
+        }
+
+        private bool shouldBeVisible(ControlPointGroup group) => group.Time >= visibleRange.min && group.Time <= visibleRange.max;
     }
 }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs
index 243cdc6ddd..a40a805361 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TopPointPiece.cs
@@ -19,12 +19,12 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
         protected OsuSpriteText Label { get; private set; } = null!;
 
-        private const float width = 80;
+        public const float WIDTH = 80;
 
         public TopPointPiece(ControlPoint point)
         {
             Point = point;
-            Width = width;
+            Width = WIDTH;
             Height = 16;
             Margin = new MarginPadding { Vertical = 4 };
 
@@ -65,7 +65,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                 new Container
                 {
                     RelativeSizeAxes = Axes.Y,
-                    Width = width - triangle_portion,
+                    Width = WIDTH - triangle_portion,
                     Anchor = Anchor.CentreLeft,
                     Origin = Anchor.CentreLeft,
                     Colour = Point.GetRepresentingColour(colours),

From e825db61eeebc0e1f94b2f62b6dba30c478dd58a Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 16 Mar 2024 12:26:56 +0300
Subject: [PATCH 399/930] Fix enumerator allocation

---
 .../Components/Timeline/TimelineControlPointDisplay.cs        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index 60d113ef58..950b717ffb 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
@@ -72,8 +72,10 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             }
 
             // Add remaining ones
-            foreach (var group in controlPointGroups)
+            for (int i = 0; i < controlPointGroups.Count; i++)
             {
+                var group = controlPointGroups[i];
+
                 if (!shouldBeVisible(group))
                     continue;
 

From 981ee54cdca16653753c85a71192f404cb80e85c Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 16 Mar 2024 15:05:52 +0300
Subject: [PATCH 400/930] Fix transforms overhead in TimelineTickDisplay

---
 .../Edit/Compose/Components/Timeline/TimelineTickDisplay.cs   | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 7e7bef8cf2..5348d03a38 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -165,7 +165,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
             // save a few drawables beyond the currently used for edge cases.
             while (drawableIndex < Math.Min(usedDrawables + 16, Count))
-                Children[drawableIndex++].Hide();
+                Children[drawableIndex++].Alpha = 0;
 
             // expire any excess
             while (drawableIndex < Count)
@@ -182,7 +182,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
                     point = Children[drawableIndex];
 
                 drawableIndex++;
-                point.Show();
+                point.Alpha = 1;
 
                 return point;
             }

From 34a5e2d606070ba043afc501030933bd4f158412 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 16 Mar 2024 15:20:37 +0300
Subject: [PATCH 401/930] Don't update subtree masking in TimelineTickDisplay

---
 .../Edit/Compose/Components/Timeline/TimelineTickDisplay.cs   | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index 5348d03a38..c3adb43032 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -18,6 +19,9 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 {
     public partial class TimelineTickDisplay : TimelinePart<PointVisualisation>
     {
+        // With current implementation every tick in the sub-tree should be visible, no need to check whether they are masked away.
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+
         [Resolved]
         private EditorBeatmap beatmap { get; set; } = null!;
 

From 0a6960296ec1947594b06623cfd925433e09d380 Mon Sep 17 00:00:00 2001
From: Vlad Frangu <me@vladfrangu.dev>
Date: Sat, 16 Mar 2024 21:32:55 +0200
Subject: [PATCH 402/930] feat: Support filtering for multiple statuses

---
 .../Filtering/FilterQueryParserTest.cs        | 22 ++++++++++----
 osu.Game/Screens/Select/FilterCriteria.cs     | 17 ++++++++++-
 osu.Game/Screens/Select/FilterQueryParser.cs  | 29 ++++++++++++++++++-
 3 files changed, 60 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index bf888348ee..c109e5bad2 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -256,8 +256,9 @@ namespace osu.Game.Tests.NonVisual.Filtering
             const string query = "status=r";
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
-            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Min);
-            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Max);
+            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
+            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values!);
+            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
         }
 
         [Test]
@@ -268,10 +269,19 @@ namespace osu.Game.Tests.NonVisual.Filtering
             FilterQueryParser.ApplyQueries(filterCriteria, query);
             Assert.AreEqual("I want the pp", filterCriteria.SearchText.Trim());
             Assert.AreEqual(4, filterCriteria.SearchTerms.Length);
-            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Min);
-            Assert.IsTrue(filterCriteria.OnlineStatus.IsLowerInclusive);
-            Assert.AreEqual(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Max);
-            Assert.IsTrue(filterCriteria.OnlineStatus.IsUpperInclusive);
+            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
+        }
+
+        [Test]
+        public void TestApplyStatusMatches()
+        {
+            const string query = "status=ranked status=loved";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Loved, filterCriteria.OnlineStatus.Values);
         }
 
         [TestCase("creator")]
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 46083f7c88..dd6b602ade 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Select
         public OptionalRange<double> Length;
         public OptionalRange<double> BPM;
         public OptionalRange<int> BeatDivisor;
-        public OptionalRange<BeatmapOnlineStatus> OnlineStatus;
+        public OptionalArray<BeatmapOnlineStatus> OnlineStatus;
         public OptionalRange<DateTimeOffset> LastPlayed;
         public OptionalTextFilter Creator;
         public OptionalTextFilter Artist;
@@ -114,6 +114,21 @@ namespace osu.Game.Screens.Select
 
         public IRulesetFilterCriteria? RulesetCriteria { get; set; }
 
+        public struct OptionalArray<T> : IEquatable<OptionalArray<T>>
+            where T : struct
+        {
+            public bool HasFilter => Values?.Length > 0;
+
+            public bool IsInRange(T value)
+            {
+                return Values?.Contains(value) ?? false;
+            }
+
+            public T[]? Values;
+
+            public bool Equals(OptionalArray<T> other) => Values?.SequenceEqual(other.Values ?? Array.Empty<T>()) ?? false;
+        }
+
         public struct OptionalRange<T> : IEquatable<OptionalRange<T>>
             where T : struct
         {
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 2c4077dacf..208e7f559e 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select
                     return TryUpdateCriteriaRange(ref criteria.BeatDivisor, op, value, tryParseInt);
 
                 case "status":
-                    return TryUpdateCriteriaRange(ref criteria.OnlineStatus, op, value, tryParseEnum);
+                    return TryUpdateArrayRange(ref criteria.OnlineStatus, op, value, tryParseEnum);
 
                 case "creator":
                 case "author":
@@ -300,6 +300,33 @@ namespace osu.Game.Screens.Select
             where T : struct
             => parseFunction.Invoke(val, out var converted) && tryUpdateCriteriaRange(ref range, op, converted);
 
+        /// <summary>
+        /// Attempts to parse a keyword filter of type <typeparamref name="T"/>,
+        /// from the specified <paramref name="op"/> and <paramref name="val"/>.
+        /// If <paramref name="val"/> can be parsed into <typeparamref name="T"/> using <paramref name="parseFunction"/>, the function returns <c>true</c>
+        /// and the resulting range constraint is stored into the <paramref name="range"/>'s expected values.
+        /// </summary>
+        /// <param name="range">The <see cref="FilterCriteria.OptionalArray{T}"/> to store the parsed data into, if successful.</param>
+        /// <param name="op">The operator for the keyword filter. Currently, only <see cref="Operator.Equal"/> can be used.</param>
+        /// <param name="val">The value of the keyword filter.</param>
+        /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
+        public static bool TryUpdateArrayRange<T>(ref FilterCriteria.OptionalArray<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
+            where T : struct
+            => parseFunction.Invoke(val, out var converted) && tryUpdateArrayRange(ref range, op, converted);
+
+        private static bool tryUpdateArrayRange<T>(ref FilterCriteria.OptionalArray<T> range, Operator op, T value)
+            where T : struct
+        {
+            if (op != Operator.Equal)
+                return false;
+
+            range.Values ??= Array.Empty<T>();
+
+            range.Values = range.Values.Append(value).ToArray();
+
+            return true;
+        }
+
         private static bool tryUpdateCriteriaRange<T>(ref FilterCriteria.OptionalRange<T> range, Operator op, T value)
             where T : struct
         {

From e1c1609271bee3b21c38383596f20f31c2a3573e Mon Sep 17 00:00:00 2001
From: Vlad Frangu <me@vladfrangu.dev>
Date: Sat, 16 Mar 2024 21:48:44 +0200
Subject: [PATCH 403/930] chore: correct equal logic

---
 osu.Game/Screens/Select/FilterCriteria.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index dd6b602ade..6cec7a387d 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -126,7 +126,13 @@ namespace osu.Game.Screens.Select
 
             public T[]? Values;
 
-            public bool Equals(OptionalArray<T> other) => Values?.SequenceEqual(other.Values ?? Array.Empty<T>()) ?? false;
+            public bool Equals(OptionalArray<T> other)
+            {
+                if (Values is null && other.Values is null)
+                    return true;
+
+                return Values?.SequenceEqual(other.Values ?? Array.Empty<T>()) ?? false;
+            }
         }
 
         public struct OptionalRange<T> : IEquatable<OptionalRange<T>>

From 63816adbc081065fe68b9bc20b49b9329c4abbd2 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 16 Mar 2024 21:20:12 -0300
Subject: [PATCH 404/930] Add verify checks to unused audio at the end

---
 .../Checks/CheckUnusedAudioAtEndTest.cs       | 90 +++++++++++++++++++
 .../CheckUnusedAudioAtEndStrings.cs           | 19 ++++
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |  2 +
 .../Edit/Checks/CheckUnusedAudioAtEnd.cs      | 50 +++++++++++
 4 files changed, 161 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
 create mode 100644 osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
new file mode 100644
index 0000000000..687feae63d
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
@@ -0,0 +1,90 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using Moq;
+using NUnit.Framework;
+using osu.Framework.Timing;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Objects;
+using static osu.Game.Tests.Visual.OsuTestScene.ClockBackedTestWorkingBeatmap;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    public class CheckUnusedAudioTest
+    {
+        private CheckUnusedAudioAtEnd check = null!;
+
+        private IBeatmap beatmapNotFullyMapped = null!;
+
+        private IBeatmap beatmapFullyMapped = null!;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckUnusedAudioAtEnd();
+            beatmapNotFullyMapped = new Beatmap<HitObject>
+            {
+                HitObjects =
+                {
+                    new HitCircle { StartTime = 0 },
+                    new HitCircle { StartTime = 1_298 },
+                },
+                BeatmapInfo = new BeatmapInfo
+                {
+                    Metadata = new BeatmapMetadata { AudioFile = "abc123.jpg" }
+                }
+            };
+            beatmapFullyMapped = new Beatmap<HitObject>
+            {
+                HitObjects =
+                {
+                    new HitCircle { StartTime = 0 },
+                    new HitCircle { StartTime = 9000 },
+                },
+                BeatmapInfo = new BeatmapInfo
+                {
+                    Metadata = new BeatmapMetadata { AudioFile = "abc123.jpg" }
+                }
+            };
+        }
+
+        [Test]
+        public void TestAudioNotFullyUsed()
+        {
+            var context = getContext(beatmapNotFullyMapped);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckUnusedAudioAtEnd.IssueTemplateUnusedAudioAtEnd);
+        }
+
+        [Test]
+        public void TestAudioFullyUsed()
+        {
+            var context = getContext(beatmapFullyMapped);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        private BeatmapVerifierContext getContext(IBeatmap beatmap)
+        {
+            return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(beatmap).Object);
+        }
+
+        private Mock<IWorkingBeatmap> getMockWorkingBeatmap(IBeatmap beatmap)
+        {
+            var mockTrack = new TrackVirtualStore(new FramedClock()).GetVirtual(10000, "virtual");
+
+            var mockWorkingBeatmap = new Mock<IWorkingBeatmap>();
+            mockWorkingBeatmap.SetupGet(w => w.Beatmap).Returns(beatmap);
+            mockWorkingBeatmap.SetupGet(w => w.Track).Returns(mockTrack);
+
+            return mockWorkingBeatmap;
+        }
+    }
+}
diff --git a/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs b/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs
new file mode 100644
index 0000000000..46f92237a9
--- /dev/null
+++ b/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs
@@ -0,0 +1,19 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class CheckUnusedAudioAtEndStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.CheckUnusedAudioAtEnd";
+
+        /// <summary>
+        /// "{0}% of the audio is not mapped."
+        /// </summary>
+        public static LocalisableString OfTheAudioIsNot(double percentageLeft) => new TranslatableString(getKey(@"of_the_audio_is_not"), @"{0}% of the audio is not mapped.", percentageLeft);
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index dcf5eb4da9..4bba72d828 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -36,12 +36,14 @@ namespace osu.Game.Rulesets.Edit
             new CheckConcurrentObjects(),
             new CheckZeroLengthObjects(),
             new CheckDrainLength(),
+            new CheckUnusedAudioAtEnd(),
 
             // Timing
             new CheckPreviewTime(),
 
             // Events
             new CheckBreaks()
+
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
new file mode 100644
index 0000000000..c120e0993a
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -0,0 +1,50 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Rulesets.Objects;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckUnusedAudioAtEnd : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Compose, "More than 20% unused audio at the end");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateUnusedAudioAtEnd(this),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            double mappedLength = context.Beatmap.HitObjects.Last().GetEndTime();
+            double trackLength = context.WorkingBeatmap.Track.Length;
+
+            double mappedPercentage = calculatePercentage(mappedLength, trackLength);
+
+            if (mappedPercentage < 80)
+            {
+                yield return new IssueTemplateUnusedAudioAtEnd(this).Create();
+            }
+
+        }
+
+        private double calculatePercentage(double mappedLenght, double trackLenght)
+        {
+            return Math.Round(mappedLenght / trackLenght * 100);
+        }
+
+        public class IssueTemplateUnusedAudioAtEnd : IssueTemplate
+        {
+            public IssueTemplateUnusedAudioAtEnd(ICheck check)
+                : base(check, IssueType.Problem, "There is more than 20% unused audio at the end.")
+            {
+            }
+
+            public Issue Create() => new Issue(this);
+        }
+    }
+}

From f7aff76592c108ff3df1b97b3d2b8e8d7ded6938 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 16 Mar 2024 23:03:06 -0300
Subject: [PATCH 405/930] Fix codefactor issues

---
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs              | 1 -
 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs | 1 -
 2 files changed, 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 4bba72d828..4a316afd22 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -43,7 +43,6 @@ namespace osu.Game.Rulesets.Edit
 
             // Events
             new CheckBreaks()
-
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index c120e0993a..9c1f2748e9 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -29,7 +29,6 @@ namespace osu.Game.Rulesets.Edit.Checks
             {
                 yield return new IssueTemplateUnusedAudioAtEnd(this).Create();
             }
-
         }
 
         private double calculatePercentage(double mappedLenght, double trackLenght)

From 80f24a07916e9ae03fa4631e7f9018812139214d Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 16 Mar 2024 23:30:59 -0300
Subject: [PATCH 406/930] Fix test class name not matching file name

---
 osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
index 687feae63d..29c5cb96fd 100644
--- a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
@@ -14,7 +14,7 @@ using static osu.Game.Tests.Visual.OsuTestScene.ClockBackedTestWorkingBeatmap;
 
 namespace osu.Game.Tests.Editing.Checks
 {
-    public class CheckUnusedAudioTest
+    public class CheckUnusedAudioAtEndTest
     {
         private CheckUnusedAudioAtEnd check = null!;
 

From d0678bfbee7952e2b82c6d25bd2abc5952937421 Mon Sep 17 00:00:00 2001
From: Vlad Frangu <me@vladfrangu.dev>
Date: Mon, 18 Mar 2024 15:30:43 +0200
Subject: [PATCH 407/930] chore: requested changes

---
 .../Filtering/FilterQueryParserTest.cs        | 20 ++++++--
 osu.Game/Screens/Select/FilterCriteria.cs     | 19 +++----
 osu.Game/Screens/Select/FilterQueryParser.cs  | 50 +++++++++++++++----
 3 files changed, 67 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index c109e5bad2..98d3286409 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -256,8 +256,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             const string query = "status=r";
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
-            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
-            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values!);
+            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
             Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
         }
 
@@ -269,7 +268,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             FilterQueryParser.ApplyQueries(filterCriteria, query);
             Assert.AreEqual("I want the pp", filterCriteria.SearchText.Trim());
             Assert.AreEqual(4, filterCriteria.SearchTerms.Length);
-            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
+            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
             Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
         }
 
@@ -279,11 +278,24 @@ namespace osu.Game.Tests.NonVisual.Filtering
             const string query = "status=ranked status=loved";
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
-            Assert.IsNotNull(filterCriteria.OnlineStatus.Values);
+            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
             Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
             Assert.Contains(BeatmapOnlineStatus.Loved, filterCriteria.OnlineStatus.Values);
         }
 
+        [Test]
+        public void TestApplyRangeStatusMatches()
+        {
+            const string query = "status>=r";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Approved, filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Qualified, filterCriteria.OnlineStatus.Values);
+            Assert.Contains(BeatmapOnlineStatus.Loved, filterCriteria.OnlineStatus.Values);
+        }
+
         [TestCase("creator")]
         [TestCase("author")]
         [TestCase("mapper")]
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 6cec7a387d..1d155574cf 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Screens.Select
         public OptionalRange<double> Length;
         public OptionalRange<double> BPM;
         public OptionalRange<int> BeatDivisor;
-        public OptionalArray<BeatmapOnlineStatus> OnlineStatus;
+        public OptionalSet<BeatmapOnlineStatus> OnlineStatus = new OptionalSet<BeatmapOnlineStatus>();
         public OptionalRange<DateTimeOffset> LastPlayed;
         public OptionalTextFilter Creator;
         public OptionalTextFilter Artist;
@@ -114,24 +114,25 @@ namespace osu.Game.Screens.Select
 
         public IRulesetFilterCriteria? RulesetCriteria { get; set; }
 
-        public struct OptionalArray<T> : IEquatable<OptionalArray<T>>
+        public struct OptionalSet<T> : IEquatable<OptionalSet<T>>
             where T : struct
         {
-            public bool HasFilter => Values?.Length > 0;
+            public bool HasFilter => Values.Count > 0;
 
             public bool IsInRange(T value)
             {
-                return Values?.Contains(value) ?? false;
+                return Values.Contains(value);
             }
 
-            public T[]? Values;
+            public SortedSet<T> Values = new SortedSet<T>();
 
-            public bool Equals(OptionalArray<T> other)
+            public OptionalSet()
             {
-                if (Values is null && other.Values is null)
-                    return true;
+            }
 
-                return Values?.SequenceEqual(other.Values ?? Array.Empty<T>()) ?? false;
+            public bool Equals(OptionalSet<T> other)
+            {
+                return Values.SetEquals(other.Values);
             }
         }
 
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 208e7f559e..fbb09b93bd 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select
                     return TryUpdateCriteriaRange(ref criteria.BeatDivisor, op, value, tryParseInt);
 
                 case "status":
-                    return TryUpdateArrayRange(ref criteria.OnlineStatus, op, value, tryParseEnum);
+                    return TryUpdateSetRange(ref criteria.OnlineStatus, op, value, tryParseEnum);
 
                 case "creator":
                 case "author":
@@ -306,23 +306,55 @@ namespace osu.Game.Screens.Select
         /// If <paramref name="val"/> can be parsed into <typeparamref name="T"/> using <paramref name="parseFunction"/>, the function returns <c>true</c>
         /// and the resulting range constraint is stored into the <paramref name="range"/>'s expected values.
         /// </summary>
-        /// <param name="range">The <see cref="FilterCriteria.OptionalArray{T}"/> to store the parsed data into, if successful.</param>
+        /// <param name="range">The <see cref="FilterCriteria.OptionalSet{T}"/> to store the parsed data into, if successful.</param>
         /// <param name="op">The operator for the keyword filter. Currently, only <see cref="Operator.Equal"/> can be used.</param>
         /// <param name="val">The value of the keyword filter.</param>
         /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
-        public static bool TryUpdateArrayRange<T>(ref FilterCriteria.OptionalArray<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
+        public static bool TryUpdateSetRange<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
             where T : struct
-            => parseFunction.Invoke(val, out var converted) && tryUpdateArrayRange(ref range, op, converted);
+            => parseFunction.Invoke(val, out var converted) && tryUpdateSetRange(ref range, op, converted);
 
-        private static bool tryUpdateArrayRange<T>(ref FilterCriteria.OptionalArray<T> range, Operator op, T value)
+        private static bool tryUpdateSetRange<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T value)
             where T : struct
         {
-            if (op != Operator.Equal)
-                return false;
+            var enumValues = (T[])Enum.GetValues(typeof(T));
 
-            range.Values ??= Array.Empty<T>();
+            foreach (var enumValue in enumValues)
+            {
+                switch (op)
+                {
+                    case Operator.Less:
+                        if (Comparer<T>.Default.Compare(enumValue, value) < 0)
+                            range.Values.Add(enumValue);
 
-            range.Values = range.Values.Append(value).ToArray();
+                        break;
+
+                    case Operator.LessOrEqual:
+                        if (Comparer<T>.Default.Compare(enumValue, value) <= 0)
+                            range.Values.Add(enumValue);
+
+                        break;
+
+                    case Operator.Equal:
+                        range.Values.Add(value);
+                        break;
+
+                    case Operator.GreaterOrEqual:
+                        if (Comparer<T>.Default.Compare(enumValue, value) >= 0)
+                            range.Values.Add(enumValue);
+
+                        break;
+
+                    case Operator.Greater:
+                        if (Comparer<T>.Default.Compare(enumValue, value) > 0)
+                            range.Values.Add(enumValue);
+
+                        break;
+
+                    default:
+                        return false;
+                }
+            }
 
             return true;
         }

From 77119b2cdb1c4f2b743aa9a99eac1f48f74064d1 Mon Sep 17 00:00:00 2001
From: Vlad Frangu <me@vladfrangu.dev>
Date: Mon, 18 Mar 2024 16:44:42 +0200
Subject: [PATCH 408/930] chore: correct doc string

---
 osu.Game/Screens/Select/FilterQueryParser.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index fbb09b93bd..76d58963e7 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -307,7 +307,7 @@ namespace osu.Game.Screens.Select
         /// and the resulting range constraint is stored into the <paramref name="range"/>'s expected values.
         /// </summary>
         /// <param name="range">The <see cref="FilterCriteria.OptionalSet{T}"/> to store the parsed data into, if successful.</param>
-        /// <param name="op">The operator for the keyword filter. Currently, only <see cref="Operator.Equal"/> can be used.</param>
+        /// <param name="op">The operator for the keyword filter.</param>
         /// <param name="val">The value of the keyword filter.</param>
         /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
         public static bool TryUpdateSetRange<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)

From a3f3dcf853b6148c6c2cbebe41b88711c01d468a Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 18 Mar 2024 13:27:43 -0300
Subject: [PATCH 409/930] Inline percentage calculation

---
 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index 9c1f2748e9..8795eeac2d 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             double mappedLength = context.Beatmap.HitObjects.Last().GetEndTime();
             double trackLength = context.WorkingBeatmap.Track.Length;
 
-            double mappedPercentage = calculatePercentage(mappedLength, trackLength);
+            double mappedPercentage = Math.Round(mappedLength / trackLength * 100);
 
             if (mappedPercentage < 80)
             {
@@ -31,11 +31,6 @@ namespace osu.Game.Rulesets.Edit.Checks
             }
         }
 
-        private double calculatePercentage(double mappedLenght, double trackLenght)
-        {
-            return Math.Round(mappedLenght / trackLenght * 100);
-        }
-
         public class IssueTemplateUnusedAudioAtEnd : IssueTemplate
         {
             public IssueTemplateUnusedAudioAtEnd(ICheck check)

From 915a9682b5be54b090d39ae2a44beae8ea2c9ce7 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 18 Mar 2024 13:51:36 -0300
Subject: [PATCH 410/930] Fix issue type and display percentage left

---
 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index 8795eeac2d..d22303b7df 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -27,18 +27,19 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             if (mappedPercentage < 80)
             {
-                yield return new IssueTemplateUnusedAudioAtEnd(this).Create();
+                double percentageLeft = Math.Abs(mappedPercentage - 100);
+                yield return new IssueTemplateUnusedAudioAtEnd(this).Create(percentageLeft);
             }
         }
 
         public class IssueTemplateUnusedAudioAtEnd : IssueTemplate
         {
             public IssueTemplateUnusedAudioAtEnd(ICheck check)
-                : base(check, IssueType.Problem, "There is more than 20% unused audio at the end.")
+                : base(check, IssueType.Warning, "Currently there is {0}% unused audio at the end. Ensure the outro significantly contributes to the song, otherwise cut the outro.")
             {
             }
 
-            public Issue Create() => new Issue(this);
+            public Issue Create(double percentageLeft) => new Issue(this, percentageLeft);
         }
     }
 }

From c23212f4efad0c58207265877a5130177f47d2e5 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 18 Mar 2024 14:02:33 -0300
Subject: [PATCH 411/930] Use `GetLastObjectTime` to calculate mapped length

---
 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index d22303b7df..d9a675fd17 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -3,9 +3,8 @@
 
 using System;
 using System.Collections.Generic;
-using System.Linq;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
-using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Edit.Checks
 {
@@ -20,7 +19,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
-            double mappedLength = context.Beatmap.HitObjects.Last().GetEndTime();
+            double mappedLength = context.Beatmap.GetLastObjectTime();
             double trackLength = context.WorkingBeatmap.Track.Length;
 
             double mappedPercentage = Math.Round(mappedLength / trackLength * 100);

From 0edc249637d56208bca655db17e274738df0b70e Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Mon, 18 Mar 2024 20:38:19 +0300
Subject: [PATCH 412/930] Make Timeline non-nullable

---
 .../Components/Timeline/TimelineControlPointDisplay.cs        | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index 950b717ffb..1bf12e40d1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
@@ -15,7 +15,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     public partial class TimelineControlPointDisplay : TimelinePart<TimelineControlPointGroup>
     {
         [Resolved]
-        private Timeline? timeline { get; set; }
+        private Timeline timeline { get; set; } = null!;
 
         /// <summary>
         /// The visible time/position range of the timeline.
@@ -42,7 +42,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         {
             base.Update();
 
-            if (timeline == null || DrawWidth <= 0) return;
+            if (DrawWidth <= 0) return;
 
             (float, float) newRange = (
                 (ToLocalSpace(timeline.ScreenSpaceDrawQuad.TopLeft).X - TopPointPiece.WIDTH) / DrawWidth * Content.RelativeChildSize.X,

From 7ca45c75b3348f66c0ec86e02a72c114abb27c8c Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Mon, 18 Mar 2024 20:46:38 +0300
Subject: [PATCH 413/930] Don't iterate backwards on children without a reason

---
 .../Components/Timeline/TimelineControlPointDisplay.cs    | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index 1bf12e40d1..8e522fa715 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
@@ -63,12 +63,10 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
         private void recreateDrawableGroups()
         {
             // Remove groups outside the visible range
-            for (int i = Count - 1; i >= 0; i--)
+            foreach (var drawableGroup in this)
             {
-                var g = Children[i];
-
-                if (!shouldBeVisible(g.Group))
-                    g.Expire();
+                if (!shouldBeVisible(drawableGroup.Group))
+                    drawableGroup.Expire();
             }
 
             // Add remaining ones

From f6d7f18f2592071d98872e2cda18f8de9d20cfa1 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 18 Mar 2024 15:59:19 -0300
Subject: [PATCH 414/930] Remove unused localisation file

---
 .../CheckUnusedAudioAtEndStrings.cs           | 19 -------------------
 1 file changed, 19 deletions(-)
 delete mode 100644 osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs

diff --git a/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs b/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs
deleted file mode 100644
index 46f92237a9..0000000000
--- a/osu.Game/Localisation/CheckUnusedAudioAtEndStrings.cs
+++ /dev/null
@@ -1,19 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Localisation;
-
-namespace osu.Game.Localisation
-{
-    public static class CheckUnusedAudioAtEndStrings
-    {
-        private const string prefix = @"osu.Game.Resources.Localisation.CheckUnusedAudioAtEnd";
-
-        /// <summary>
-        /// "{0}% of the audio is not mapped."
-        /// </summary>
-        public static LocalisableString OfTheAudioIsNot(double percentageLeft) => new TranslatableString(getKey(@"of_the_audio_is_not"), @"{0}% of the audio is not mapped.", percentageLeft);
-
-        private static string getKey(string key) => $@"{prefix}:{key}";
-    }
-}

From 5241c999c1f3300f36723a1d070c23240936c8da Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 18 Mar 2024 16:08:41 -0300
Subject: [PATCH 415/930] Add different warning to maps with storyboard/video

---
 .../Checks/CheckUnusedAudioAtEndTest.cs       | 51 +++++++++++++++++--
 .../Edit/Checks/CheckUnusedAudioAtEnd.cs      | 37 +++++++++++++-
 2 files changed, 84 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
index 29c5cb96fd..33d73a8086 100644
--- a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
@@ -4,12 +4,15 @@
 using System.Linq;
 using Moq;
 using NUnit.Framework;
+using osu.Framework.Graphics;
 using osu.Framework.Timing;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Edit.Checks;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Storyboards;
+using osuTK;
 using static osu.Game.Tests.Visual.OsuTestScene.ClockBackedTestWorkingBeatmap;
 
 namespace osu.Game.Tests.Editing.Checks
@@ -47,7 +50,7 @@ namespace osu.Game.Tests.Editing.Checks
                 },
                 BeatmapInfo = new BeatmapInfo
                 {
-                    Metadata = new BeatmapMetadata { AudioFile = "abc123.jpg" }
+                    Metadata = new BeatmapMetadata { AudioFile = "abc123.jpg" },
                 }
             };
         }
@@ -62,6 +65,42 @@ namespace osu.Game.Tests.Editing.Checks
             Assert.That(issues.Single().Template is CheckUnusedAudioAtEnd.IssueTemplateUnusedAudioAtEnd);
         }
 
+        [Test]
+        public void TestAudioNotFullyUsedWithVideo()
+        {
+            var storyboard = new Storyboard();
+
+            var video = new StoryboardVideo("abc123.mp4", 0);
+
+            storyboard.GetLayer("Video").Add(video);
+
+            var mockWorkingBeatmap = getMockWorkingBeatmap(beatmapNotFullyMapped, storyboard);
+
+            var context = getContext(beatmapNotFullyMapped, mockWorkingBeatmap);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckUnusedAudioAtEnd.IssueTemplateUnusedAudioAtEndStoryboardOrVideo);
+        }
+
+        [Test]
+        public void TestAudioNotFullyUsedWithStoryboardElement()
+        {
+            var storyboard = new Storyboard();
+
+            var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
+
+            storyboard.GetLayer("Background").Add(sprite);
+
+            var mockWorkingBeatmap = getMockWorkingBeatmap(beatmapNotFullyMapped, storyboard);
+
+            var context = getContext(beatmapNotFullyMapped, mockWorkingBeatmap);
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckUnusedAudioAtEnd.IssueTemplateUnusedAudioAtEndStoryboardOrVideo);
+        }
+
         [Test]
         public void TestAudioFullyUsed()
         {
@@ -73,16 +112,22 @@ namespace osu.Game.Tests.Editing.Checks
 
         private BeatmapVerifierContext getContext(IBeatmap beatmap)
         {
-            return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(beatmap).Object);
+            return new BeatmapVerifierContext(beatmap, getMockWorkingBeatmap(beatmap, new Storyboard()).Object);
         }
 
-        private Mock<IWorkingBeatmap> getMockWorkingBeatmap(IBeatmap beatmap)
+        private BeatmapVerifierContext getContext(IBeatmap beatmap, Mock<IWorkingBeatmap> workingBeatmap)
+        {
+            return new BeatmapVerifierContext(beatmap, workingBeatmap.Object);
+        }
+
+        private Mock<IWorkingBeatmap> getMockWorkingBeatmap(IBeatmap beatmap, Storyboard storyboard)
         {
             var mockTrack = new TrackVirtualStore(new FramedClock()).GetVirtual(10000, "virtual");
 
             var mockWorkingBeatmap = new Mock<IWorkingBeatmap>();
             mockWorkingBeatmap.SetupGet(w => w.Beatmap).Returns(beatmap);
             mockWorkingBeatmap.SetupGet(w => w.Track).Returns(mockTrack);
+            mockWorkingBeatmap.SetupGet(w => w.Storyboard).Returns(storyboard);
 
             return mockWorkingBeatmap;
         }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index d9a675fd17..2f768b6ffa 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Storyboards;
 
 namespace osu.Game.Rulesets.Edit.Checks
 {
@@ -15,6 +16,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
             new IssueTemplateUnusedAudioAtEnd(this),
+            new IssueTemplateUnusedAudioAtEndStoryboardOrVideo(this),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
@@ -27,10 +29,33 @@ namespace osu.Game.Rulesets.Edit.Checks
             if (mappedPercentage < 80)
             {
                 double percentageLeft = Math.Abs(mappedPercentage - 100);
-                yield return new IssueTemplateUnusedAudioAtEnd(this).Create(percentageLeft);
+
+                bool storyboardIsPresent = isAnyStoryboardElementPresent(context.WorkingBeatmap.Storyboard);
+
+                if (storyboardIsPresent)
+                {
+                    yield return new IssueTemplateUnusedAudioAtEndStoryboardOrVideo(this).Create(percentageLeft);
+                }
+                else
+                {
+                    yield return new IssueTemplateUnusedAudioAtEnd(this).Create(percentageLeft);
+                }
             }
         }
 
+        private bool isAnyStoryboardElementPresent(Storyboard storyboard)
+        {
+            foreach (var layer in storyboard.Layers)
+            {
+                foreach (var _ in layer.Elements)
+                {
+                    return true;
+                }
+            }
+
+            return false;
+        }
+
         public class IssueTemplateUnusedAudioAtEnd : IssueTemplate
         {
             public IssueTemplateUnusedAudioAtEnd(ICheck check)
@@ -40,5 +65,15 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             public Issue Create(double percentageLeft) => new Issue(this, percentageLeft);
         }
+
+        public class IssueTemplateUnusedAudioAtEndStoryboardOrVideo : IssueTemplate
+        {
+            public IssueTemplateUnusedAudioAtEndStoryboardOrVideo(ICheck check)
+                : base(check, IssueType.Warning, "Currently there is {0}% unused audio at the end. Ensure the outro significantly contributes to the song, or is being occupied by the video or storyboard, otherwise cut the outro.")
+            {
+            }
+
+            public Issue Create(double percentageLeft) => new Issue(this, percentageLeft);
+        }
     }
 }

From a8ce6a0bba5c65ab12360191d7589365d0996133 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Tue, 19 Mar 2024 02:43:34 +0300
Subject: [PATCH 416/930] Use `Slice` method instead of index range operators
 for readability

---
 .../Rulesets/Objects/Legacy/ConvertHitObjectParser.cs     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 2b058d5e1f..283a59b7ed 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -303,16 +303,16 @@ namespace osu.Game.Rulesets.Objects.Legacy
                     {
                         int startIndex = segmentsBuffer[i].StartIndex;
                         int endIndex = segmentsBuffer[i + 1].StartIndex;
-                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints[startIndex..endIndex], pointsBuffer[endIndex]));
+                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints.Slice(startIndex, endIndex - startIndex), pointsBuffer[endIndex]));
                     }
                     else
                     {
                         int startIndex = segmentsBuffer[i].StartIndex;
-                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints[startIndex..], null));
+                        controlPoints.AddRange(convertPoints(segmentsBuffer[i].Type, allPoints.Slice(startIndex), null));
                     }
                 }
 
-                return mergePointsLists(controlPoints);
+                return mergeControlPointsLists(controlPoints);
             }
             finally
             {
@@ -402,7 +402,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
                                              - (p1.X - p0.X) * (p2.Y - p0.Y));
         }
 
-        private PathControlPoint[] mergePointsLists(List<ArraySegment<PathControlPoint>> controlPointList)
+        private PathControlPoint[] mergeControlPointsLists(List<ArraySegment<PathControlPoint>> controlPointList)
         {
             int totalCount = 0;
 

From af713a78695f4abd3e8023a98245f034fbb55da8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 19 Mar 2024 17:20:59 +0900
Subject: [PATCH 417/930] Fix incorrectly encoded score IsPerfect value

---
 .../Formats/LegacyScoreEncoderTest.cs         | 38 ++++++++++++++++---
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs |  7 +++-
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs |  2 +-
 3 files changed, 40 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
index c0a7285f39..c0bf47dfc9 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
@@ -6,6 +6,7 @@ using System.IO;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Rulesets.Catch;
+using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
@@ -21,9 +22,9 @@ namespace osu.Game.Tests.Beatmaps.Formats
         public void CatchMergesFruitAndDropletMisses(int missCount, int largeTickMissCount)
         {
             var ruleset = new CatchRuleset().RulesetInfo;
-
             var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
             var beatmap = new TestBeatmap(ruleset);
+
             scoreInfo.Statistics = new Dictionary<HitResult, int>
             {
                 [HitResult.Great] = 50,
@@ -31,14 +32,41 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 [HitResult.Miss] = missCount,
                 [HitResult.LargeTickMiss] = largeTickMissCount
             };
-            var score = new Score { ScoreInfo = scoreInfo };
 
-            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
+            var score = new Score { ScoreInfo = scoreInfo };
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap, out _);
 
             Assert.That(decodedAfterEncode.ScoreInfo.GetCountMiss(), Is.EqualTo(missCount + largeTickMissCount));
         }
 
-        private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap)
+        [Test]
+        public void ScoreWithMissIsNotPerfect()
+        {
+            var ruleset = new OsuRuleset().RulesetInfo;
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
+            var beatmap = new TestBeatmap(ruleset);
+
+            scoreInfo.Statistics = new Dictionary<HitResult, int>
+            {
+                [HitResult.Great] = 2,
+                [HitResult.Miss] = 1,
+            };
+
+            scoreInfo.MaximumStatistics = new Dictionary<HitResult, int>
+            {
+                [HitResult.Great] = 3
+            };
+
+            // Hit -> Miss -> Hit
+            scoreInfo.Combo = 1;
+            scoreInfo.MaxCombo = 1;
+
+            encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, new Score { ScoreInfo = scoreInfo }, beatmap, out var decoder);
+
+            Assert.That(decoder.DecodedPerfectValue, Is.False);
+        }
+
+        private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap, out LegacyScoreDecoderTest.TestLegacyScoreDecoder decoder)
         {
             var encodeStream = new MemoryStream();
 
@@ -47,7 +75,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
             var decodeStream = new MemoryStream(encodeStream.GetBuffer());
 
-            var decoder = new LegacyScoreDecoderTest.TestLegacyScoreDecoder(beatmapVersion);
+            decoder = new LegacyScoreDecoderTest.TestLegacyScoreDecoder(beatmapVersion);
             var decodedAfterEncode = decoder.Parse(decodeStream);
             return decodedAfterEncode;
         }
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 65e2c02655..f2c096da15 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -27,6 +27,11 @@ namespace osu.Game.Scoring.Legacy
 {
     public abstract class LegacyScoreDecoder
     {
+        /// <summary>
+        /// The decoded "IsPerfect" value. This isn't used by osu!lazer.
+        /// </summary>
+        public bool DecodedPerfectValue { get; private set; }
+
         private IBeatmap currentBeatmap;
         private Ruleset currentRuleset;
 
@@ -82,7 +87,7 @@ namespace osu.Game.Scoring.Legacy
                 scoreInfo.MaxCombo = sr.ReadUInt16();
 
                 /* score.Perfect = */
-                sr.ReadBoolean();
+                DecodedPerfectValue = sr.ReadBoolean();
 
                 scoreInfo.Mods = currentRuleset.ConvertFromLegacyMods((LegacyMods)sr.ReadInt32()).ToArray();
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 4ee4231925..1df54565e9 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Scoring.Legacy
                 sw.Write((ushort)(score.ScoreInfo.GetCountMiss() ?? 0));
                 sw.Write((int)(score.ScoreInfo.TotalScore));
                 sw.Write((ushort)score.ScoreInfo.MaxCombo);
-                sw.Write(score.ScoreInfo.Combo == score.ScoreInfo.MaxCombo);
+                sw.Write(score.ScoreInfo.Combo == score.ScoreInfo.GetMaximumAchievableCombo());
                 sw.Write((int)score.ScoreInfo.Ruleset.CreateInstance().ConvertToLegacyMods(score.ScoreInfo.Mods));
 
                 sw.Write(getHpGraphFormatted());

From 6e3350941749a87b21ed2c819c063e7a556509f0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 19 Mar 2024 17:44:37 +0900
Subject: [PATCH 418/930] Remove added property, use local decoding instead

---
 .../Formats/LegacyScoreEncoderTest.cs         | 34 ++++++++++++++++---
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs |  7 +---
 2 files changed, 30 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
index c0bf47dfc9..806f538249 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using System.IO;
 using NUnit.Framework;
 using osu.Game.Beatmaps.Formats;
+using osu.Game.IO.Legacy;
 using osu.Game.Rulesets.Catch;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Scoring;
@@ -34,7 +35,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
             };
 
             var score = new Score { ScoreInfo = scoreInfo };
-            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap, out _);
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
 
             Assert.That(decodedAfterEncode.ScoreInfo.GetCountMiss(), Is.EqualTo(missCount + largeTickMissCount));
         }
@@ -61,12 +62,35 @@ namespace osu.Game.Tests.Beatmaps.Formats
             scoreInfo.Combo = 1;
             scoreInfo.MaxCombo = 1;
 
-            encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, new Score { ScoreInfo = scoreInfo }, beatmap, out var decoder);
+            using (var ms = new MemoryStream())
+            {
+                new LegacyScoreEncoder(new Score { ScoreInfo = scoreInfo }, beatmap).Encode(ms, true);
 
-            Assert.That(decoder.DecodedPerfectValue, Is.False);
+                ms.Seek(0, SeekOrigin.Begin);
+
+                using (var sr = new SerializationReader(ms))
+                {
+                    sr.ReadByte(); // ruleset id
+                    sr.ReadInt32(); // version
+                    sr.ReadString(); // beatmap hash
+                    sr.ReadString(); // username
+                    sr.ReadString(); // score hash
+                    sr.ReadInt16(); // count300
+                    sr.ReadInt16(); // count100
+                    sr.ReadInt16(); // count50
+                    sr.ReadInt16(); // countGeki
+                    sr.ReadInt16(); // countKatu
+                    sr.ReadInt16(); // countMiss
+                    sr.ReadInt32(); // total score
+                    sr.ReadInt16(); // max combo
+                    bool isPerfect = sr.ReadBoolean(); // full combo
+
+                    Assert.That(isPerfect, Is.False);
+                }
+            }
         }
 
-        private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap, out LegacyScoreDecoderTest.TestLegacyScoreDecoder decoder)
+        private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap)
         {
             var encodeStream = new MemoryStream();
 
@@ -75,7 +99,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
             var decodeStream = new MemoryStream(encodeStream.GetBuffer());
 
-            decoder = new LegacyScoreDecoderTest.TestLegacyScoreDecoder(beatmapVersion);
+            var decoder = new LegacyScoreDecoderTest.TestLegacyScoreDecoder(beatmapVersion);
             var decodedAfterEncode = decoder.Parse(decodeStream);
             return decodedAfterEncode;
         }
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index f2c096da15..65e2c02655 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -27,11 +27,6 @@ namespace osu.Game.Scoring.Legacy
 {
     public abstract class LegacyScoreDecoder
     {
-        /// <summary>
-        /// The decoded "IsPerfect" value. This isn't used by osu!lazer.
-        /// </summary>
-        public bool DecodedPerfectValue { get; private set; }
-
         private IBeatmap currentBeatmap;
         private Ruleset currentRuleset;
 
@@ -87,7 +82,7 @@ namespace osu.Game.Scoring.Legacy
                 scoreInfo.MaxCombo = sr.ReadUInt16();
 
                 /* score.Perfect = */
-                DecodedPerfectValue = sr.ReadBoolean();
+                sr.ReadBoolean();
 
                 scoreInfo.Mods = currentRuleset.ConvertFromLegacyMods((LegacyMods)sr.ReadInt32()).ToArray();
 

From f6069d8d93b05c752b1aeaa36e4c269580880f26 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 19 Mar 2024 17:46:18 +0900
Subject: [PATCH 419/930] Compare against MaxCombo instead

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 1df54565e9..93f51ee74d 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -93,7 +93,7 @@ namespace osu.Game.Scoring.Legacy
                 sw.Write((ushort)(score.ScoreInfo.GetCountMiss() ?? 0));
                 sw.Write((int)(score.ScoreInfo.TotalScore));
                 sw.Write((ushort)score.ScoreInfo.MaxCombo);
-                sw.Write(score.ScoreInfo.Combo == score.ScoreInfo.GetMaximumAchievableCombo());
+                sw.Write(score.ScoreInfo.MaxCombo == score.ScoreInfo.GetMaximumAchievableCombo());
                 sw.Write((int)score.ScoreInfo.Ruleset.CreateInstance().ConvertToLegacyMods(score.ScoreInfo.Mods));
 
                 sw.Write(getHpGraphFormatted());

From 0de5ca8d2df633b044b41d121bb3ed97aee73e47 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Mar 2024 01:26:39 +0800
Subject: [PATCH 420/930] Update incorrect xmldoc

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index fd1ce5d829..8bb3ae8182 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -18,7 +18,7 @@ using osuTK;
 namespace osu.Game.Screens.Play
 {
     /// <summary>
-    /// Simple <see cref="ResumeOverlay"/> that resumes after 800ms.
+    /// Simple <see cref="ResumeOverlay"/> that resumes after a short delay.
     /// </summary>
     public partial class DelayedResumeOverlay : ResumeOverlay
     {

From feaf59e15f701e1348122e17c4650420b8a581ff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 18:19:06 +0100
Subject: [PATCH 421/930] Use `HashSet` instead of `SortedSet`

No need for it to be sorted.
---
 .../NonVisual/Filtering/FilterQueryParserTest.cs | 16 ++++++++--------
 osu.Game/Screens/Select/FilterCriteria.cs        | 12 +++---------
 2 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index 98d3286409..bd706b5b4c 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -257,7 +257,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
             Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
         }
 
         [Test]
@@ -269,7 +269,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
             Assert.AreEqual("I want the pp", filterCriteria.SearchText.Trim());
             Assert.AreEqual(4, filterCriteria.SearchTerms.Length);
             Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
         }
 
         [Test]
@@ -279,8 +279,8 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
             Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Loved, filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Loved));
         }
 
         [Test]
@@ -290,10 +290,10 @@ namespace osu.Game.Tests.NonVisual.Filtering
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
             Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Ranked, filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Approved, filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Qualified, filterCriteria.OnlineStatus.Values);
-            Assert.Contains(BeatmapOnlineStatus.Loved, filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Approved));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Qualified));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Loved));
         }
 
         [TestCase("creator")]
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 1d155574cf..6750b07aba 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -119,21 +119,15 @@ namespace osu.Game.Screens.Select
         {
             public bool HasFilter => Values.Count > 0;
 
-            public bool IsInRange(T value)
-            {
-                return Values.Contains(value);
-            }
+            public bool IsInRange(T value) => Values.Contains(value);
 
-            public SortedSet<T> Values = new SortedSet<T>();
+            public HashSet<T> Values = new HashSet<T>();
 
             public OptionalSet()
             {
             }
 
-            public bool Equals(OptionalSet<T> other)
-            {
-                return Values.SetEquals(other.Values);
-            }
+            public bool Equals(OptionalSet<T> other) => Values.SetEquals(other.Values);
         }
 
         public struct OptionalRange<T> : IEquatable<OptionalRange<T>>

From 320373e3e0a50c5b94a0f5a68a108ce24b3da2e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 18:28:13 +0100
Subject: [PATCH 422/930] Rename method to match convention better

---
 osu.Game/Screens/Select/FilterQueryParser.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 76d58963e7..194a288426 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select
                     return TryUpdateCriteriaRange(ref criteria.BeatDivisor, op, value, tryParseInt);
 
                 case "status":
-                    return TryUpdateSetRange(ref criteria.OnlineStatus, op, value, tryParseEnum);
+                    return TryUpdateCriteriaSet(ref criteria.OnlineStatus, op, value, tryParseEnum);
 
                 case "creator":
                 case "author":
@@ -310,11 +310,11 @@ namespace osu.Game.Screens.Select
         /// <param name="op">The operator for the keyword filter.</param>
         /// <param name="val">The value of the keyword filter.</param>
         /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
-        public static bool TryUpdateSetRange<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
+        public static bool TryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
             where T : struct
-            => parseFunction.Invoke(val, out var converted) && tryUpdateSetRange(ref range, op, converted);
+            => parseFunction.Invoke(val, out var converted) && tryUpdateCriteriaSet(ref range, op, converted);
 
-        private static bool tryUpdateSetRange<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T value)
+        private static bool tryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T value)
             where T : struct
         {
             var enumValues = (T[])Enum.GetValues(typeof(T));

From af3f7dcbbfb3e5b955f45e56815238eae71ccbdf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 18:31:07 +0100
Subject: [PATCH 423/930] Retouch update criteria method

---
 osu.Game/Screens/Select/FilterQueryParser.cs | 30 ++++++++------------
 1 file changed, 12 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 194a288426..32b533e18d 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -311,44 +311,38 @@ namespace osu.Game.Screens.Select
         /// <param name="val">The value of the keyword filter.</param>
         /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
         public static bool TryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
-            where T : struct
+            where T : struct, Enum
             => parseFunction.Invoke(val, out var converted) && tryUpdateCriteriaSet(ref range, op, converted);
 
-        private static bool tryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T value)
-            where T : struct
+        private static bool tryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T pivotValue)
+            where T : struct, Enum
         {
-            var enumValues = (T[])Enum.GetValues(typeof(T));
+            var allDefinedValues = Enum.GetValues<T>();
 
-            foreach (var enumValue in enumValues)
+            foreach (var val in allDefinedValues)
             {
+                int compareResult = Comparer<T>.Default.Compare(val, pivotValue);
+
                 switch (op)
                 {
                     case Operator.Less:
-                        if (Comparer<T>.Default.Compare(enumValue, value) < 0)
-                            range.Values.Add(enumValue);
-
+                        if (compareResult < 0) range.Values.Add(val);
                         break;
 
                     case Operator.LessOrEqual:
-                        if (Comparer<T>.Default.Compare(enumValue, value) <= 0)
-                            range.Values.Add(enumValue);
-
+                        if (compareResult <= 0) range.Values.Add(val);
                         break;
 
                     case Operator.Equal:
-                        range.Values.Add(value);
+                        if (compareResult == 0) range.Values.Add(val);
                         break;
 
                     case Operator.GreaterOrEqual:
-                        if (Comparer<T>.Default.Compare(enumValue, value) >= 0)
-                            range.Values.Add(enumValue);
-
+                        if (compareResult >= 0) range.Values.Add(val);
                         break;
 
                     case Operator.Greater:
-                        if (Comparer<T>.Default.Compare(enumValue, value) > 0)
-                            range.Values.Add(enumValue);
-
+                        if (compareResult > 0) range.Values.Add(val);
                         break;
 
                     default:

From 0211ae12adbed9b0d37881fbc87774ca901a0953 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 19:16:33 +0100
Subject: [PATCH 424/930] Add failing test case for crash on empty beatmap

---
 .../Editing/Checks/CheckUnusedAudioAtEndTest.cs        | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
index 33d73a8086..bf996b06ea 100644
--- a/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckUnusedAudioAtEndTest.cs
@@ -55,6 +55,16 @@ namespace osu.Game.Tests.Editing.Checks
             };
         }
 
+        [Test]
+        public void TestEmptyBeatmap()
+        {
+            var context = getContext(new Beatmap<HitObject>());
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckUnusedAudioAtEnd.IssueTemplateUnusedAudioAtEnd);
+        }
+
         [Test]
         public void TestAudioNotFullyUsed()
         {

From 2b83e6bc4cc325375f1db483e84af25f73330087 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 19:17:22 +0100
Subject: [PATCH 425/930] Fix check crash on empty beatmap

---
 osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
index 2f768b6ffa..2e97fbeb99 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckUnusedAudioAtEnd.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Edit.Checks.Components;
 using osu.Game.Storyboards;
@@ -21,7 +22,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
-            double mappedLength = context.Beatmap.GetLastObjectTime();
+            double mappedLength = context.Beatmap.HitObjects.Any() ? context.Beatmap.GetLastObjectTime() : 0;
             double trackLength = context.WorkingBeatmap.Track.Length;
 
             double mappedPercentage = Math.Round(mappedLength / trackLength * 100);

From e4418547feba011e5461d2a9d5358d198d341427 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 19 Mar 2024 19:19:07 +0100
Subject: [PATCH 426/930] Document `GetLastObjectTime()` exception on empty
 beatmap

---
 osu.Game/Beatmaps/IBeatmap.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Beatmaps/IBeatmap.cs b/osu.Game/Beatmaps/IBeatmap.cs
index b5bb6ccafc..6fe494ca0f 100644
--- a/osu.Game/Beatmaps/IBeatmap.cs
+++ b/osu.Game/Beatmaps/IBeatmap.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Game.Beatmaps.ControlPoints;
@@ -129,6 +130,7 @@ namespace osu.Game.Beatmaps
         ///
         /// It's not super efficient so calls should be kept to a minimum.
         /// </remarks>
+        /// <exception cref="InvalidOperationException">If <paramref name="beatmap"/> has no objects.</exception>
         public static double GetLastObjectTime(this IBeatmap beatmap) => beatmap.HitObjects.Max(h => h.GetEndTime());
 
         #region Helper methods

From 808d6e09436468c8690311f235852ed0dd7834c9 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 19 Mar 2024 16:02:06 -0400
Subject: [PATCH 427/930] Prevent potential threading issues

---
 osu.Desktop/DiscordRichPresence.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index ca26cab0fd..080032a298 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -97,11 +97,13 @@ namespace osu.Desktop
         private void onReady(object _, ReadyMessage __)
         {
             Logger.Log("Discord RPC Client ready.", LoggingTarget.Network, LogLevel.Debug);
-            updateStatus();
+            Schedule(updateStatus);
         }
 
         private void updateStatus()
         {
+            Debug.Assert(ThreadSafety.IsUpdateThread);
+
             if (!client.IsInitialized)
                 return;
 

From 0ecfa580d7a48d247ab9fa9907fdd0f1d739d732 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 19 Mar 2024 16:03:32 -0400
Subject: [PATCH 428/930] Move room code from activity code, prevent duplicate
 RPC updates

---
 osu.Desktop/DiscordRichPresence.cs | 68 +++++++++++++++++-------------
 1 file changed, 39 insertions(+), 29 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 080032a298..633b6324b7 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -2,12 +2,14 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics;
 using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Development;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
 using osu.Game;
@@ -48,6 +50,8 @@ namespace osu.Desktop
 
         private readonly Bindable<DiscordRichPresenceMode> privacyMode = new Bindable<DiscordRichPresenceMode>();
 
+        private int usersCurrentlyInLobby = 0;
+
         private readonly RichPresence presence = new RichPresence
         {
             Assets = new Assets { LargeImageKey = "osu_logo_lazer" },
@@ -115,10 +119,10 @@ namespace osu.Desktop
 
             Logger.Log("Updating Discord RPC", LoggingTarget.Network, LogLevel.Debug);
 
+            bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
+
             if (activity.Value != null)
             {
-                bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
-
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
                 presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation) ?? string.Empty);
 
@@ -137,33 +141,6 @@ namespace osu.Desktop
                 {
                     presence.Buttons = null;
                 }
-
-                if (!hideIdentifiableInformation && multiplayerClient.Room != null)
-                {
-                    MultiplayerRoom room = multiplayerClient.Room;
-                    presence.Party = new Party
-                    {
-                        Privacy = string.IsNullOrEmpty(room.Settings.Password) ? Party.PrivacySetting.Public : Party.PrivacySetting.Private,
-                        ID = room.RoomID.ToString(),
-                        // technically lobbies can have infinite users, but Discord needs this to be set to something.
-                        // to make party display sensible, assign a powers of two above participants count (8 at minimum).
-                        Max = (int)Math.Max(8, Math.Pow(2, Math.Ceiling(Math.Log2(room.Users.Count)))),
-                        Size = room.Users.Count,
-                    };
-
-                    RoomSecret roomSecret = new RoomSecret
-                    {
-                        RoomID = room.RoomID,
-                        Password = room.Settings.Password,
-                    };
-
-                    presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
-                }
-                else
-                {
-                    presence.Party = null;
-                    presence.Secrets.JoinSecret = null;
-                }
             }
             else
             {
@@ -171,6 +148,39 @@ namespace osu.Desktop
                 presence.Details = string.Empty;
             }
 
+            if (!hideIdentifiableInformation && multiplayerClient.Room != null)
+            {
+                MultiplayerRoom room = multiplayerClient.Room;
+
+                if (room.Users.Count == usersCurrentlyInLobby)
+                    return;
+
+                presence.Party = new Party
+                {
+                    Privacy = string.IsNullOrEmpty(room.Settings.Password) ? Party.PrivacySetting.Public : Party.PrivacySetting.Private,
+                    ID = room.RoomID.ToString(),
+                    // technically lobbies can have infinite users, but Discord needs this to be set to something.
+                    // to make party display sensible, assign a powers of two above participants count (8 at minimum).
+                    Max = (int)Math.Max(8, Math.Pow(2, Math.Ceiling(Math.Log2(room.Users.Count)))),
+                    Size = room.Users.Count,
+                };
+
+                RoomSecret roomSecret = new RoomSecret
+                {
+                    RoomID = room.RoomID,
+                    Password = room.Settings.Password,
+                };
+
+                presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
+                usersCurrentlyInLobby = room.Users.Count;
+            }
+            else
+            {
+                presence.Party = null;
+                presence.Secrets.JoinSecret = null;
+                usersCurrentlyInLobby = 0;
+            }
+
             // update user information
             if (privacyMode.Value == DiscordRichPresenceMode.Limited)
                 presence.Assets.LargeImageText = string.Empty;

From c71daba4f663164a8180561bbadc8e0ee6f78a46 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 19 Mar 2024 16:05:13 -0400
Subject: [PATCH 429/930] Improve logging of RPC

Co-authored-by: Salman Ahmed <frenzibyte@gmail.com>
---
 osu.Desktop/DiscordRichPresence.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 633b6324b7..f47b2eaba5 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -117,8 +117,6 @@ namespace osu.Desktop
                 return;
             }
 
-            Logger.Log("Updating Discord RPC", LoggingTarget.Network, LogLevel.Debug);
-
             bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
 
             if (activity.Value != null)
@@ -181,6 +179,8 @@ namespace osu.Desktop
                 usersCurrentlyInLobby = 0;
             }
 
+            Logger.Log($"Updating Discord RPC presence with activity status: {presence.State}, details: {presence.Details}", LoggingTarget.Network, LogLevel.Debug);
+
             // update user information
             if (privacyMode.Value == DiscordRichPresenceMode.Limited)
                 presence.Assets.LargeImageText = string.Empty;

From 4305c3db5b70b70d1e28ba1deeb807b28742481e Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 19 Mar 2024 16:15:22 -0400
Subject: [PATCH 430/930] Show login overlay when joining room while not logged
 in

---
 osu.Desktop/DiscordRichPresence.cs | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index f47b2eaba5..a2d7ace0e0 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -19,6 +19,7 @@ using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Online.Rooms;
+using osu.Game.Overlays;
 using osu.Game.Rulesets;
 using osu.Game.Users;
 using LogLevel = osu.Framework.Logging.LogLevel;
@@ -42,6 +43,8 @@ namespace osu.Desktop
         [Resolved]
         private OsuGame game { get; set; } = null!;
 
+        private LoginOverlay? login { get; set; }
+
         [Resolved]
         private MultiplayerClient multiplayerClient { get; set; } = null!;
 
@@ -65,6 +68,8 @@ namespace osu.Desktop
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
+            login = game.Dependencies.Get<LoginOverlay>();
+
             client = new DiscordRpcClient(client_id)
             {
                 SkipIdenticalPresence = false // handles better on discord IPC loss, see updateStatus call in onReady.
@@ -203,6 +208,12 @@ namespace osu.Desktop
         {
             game.Window?.Raise();
 
+            if (!api.IsLoggedIn)
+            {
+                Schedule(() => login?.Show());
+                return;
+            }
+
             Logger.Log($"Received room secret from Discord RPC Client: \"{args.Secret}\"", LoggingTarget.Network, LogLevel.Debug);
 
             // Stable and lazer share the same Discord client ID, meaning they can accept join requests from each other.

From 1a08dbaa2ba929c26e3463163f3c8ac9523809c5 Mon Sep 17 00:00:00 2001
From: jvyden <jvyden@jvyden.xyz>
Date: Tue, 19 Mar 2024 17:03:30 -0400
Subject: [PATCH 431/930] Fix code style

---
 osu.Desktop/DiscordRichPresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index a2d7ace0e0..d8013aabfe 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -53,7 +53,7 @@ namespace osu.Desktop
 
         private readonly Bindable<DiscordRichPresenceMode> privacyMode = new Bindable<DiscordRichPresenceMode>();
 
-        private int usersCurrentlyInLobby = 0;
+        private int usersCurrentlyInLobby;
 
         private readonly RichPresence presence = new RichPresence
         {

From d83a53fc944eea90ad8244e248ec762e6d6d6ad3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Mar 2024 12:10:05 +0800
Subject: [PATCH 432/930] Remove unused `ScreenBreadcrumbControl`

See https://github.com/ppy/osu-framework/pull/6218#discussion_r1529932798.
---
 .../TestSceneScreenBreadcrumbControl.cs       | 138 ------------------
 .../UserInterface/ScreenBreadcrumbControl.cs  |  48 ------
 2 files changed, 186 deletions(-)
 delete mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs
 delete mode 100644 osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs
deleted file mode 100644
index 968cf9f9db..0000000000
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneScreenBreadcrumbControl.cs
+++ /dev/null
@@ -1,138 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using NUnit.Framework;
-using osu.Framework.Allocation;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Screens;
-using osu.Game.Graphics;
-using osu.Game.Graphics.Sprites;
-using osu.Game.Graphics.UserInterface;
-using osu.Game.Graphics.UserInterfaceV2;
-using osu.Game.Screens;
-using osuTK;
-
-namespace osu.Game.Tests.Visual.UserInterface
-{
-    [TestFixture]
-    public partial class TestSceneScreenBreadcrumbControl : OsuTestScene
-    {
-        private readonly ScreenBreadcrumbControl breadcrumbs;
-        private readonly OsuScreenStack screenStack;
-
-        public TestSceneScreenBreadcrumbControl()
-        {
-            OsuSpriteText titleText;
-
-            IScreen startScreen = new TestScreenOne();
-
-            screenStack = new OsuScreenStack { RelativeSizeAxes = Axes.Both };
-            screenStack.Push(startScreen);
-
-            Children = new Drawable[]
-            {
-                screenStack,
-                new FillFlowContainer
-                {
-                    RelativeSizeAxes = Axes.X,
-                    AutoSizeAxes = Axes.Y,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(10),
-                    Children = new Drawable[]
-                    {
-                        breadcrumbs = new ScreenBreadcrumbControl(screenStack)
-                        {
-                            RelativeSizeAxes = Axes.X,
-                        },
-                        titleText = new OsuSpriteText(),
-                    },
-                },
-            };
-
-            breadcrumbs.Current.ValueChanged += screen => titleText.Text = $"Changed to {screen.NewValue}";
-            breadcrumbs.Current.TriggerChange();
-
-            waitForCurrent();
-            pushNext();
-            waitForCurrent();
-            pushNext();
-            waitForCurrent();
-
-            AddStep(@"make start current", () => startScreen.MakeCurrent());
-
-            waitForCurrent();
-            pushNext();
-            waitForCurrent();
-            AddAssert(@"only 2 items", () => breadcrumbs.Items.Count == 2);
-            AddStep(@"exit current", () => screenStack.CurrentScreen.Exit());
-            AddAssert(@"current screen is first", () => startScreen == screenStack.CurrentScreen);
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            breadcrumbs.StripColour = colours.Blue;
-        }
-
-        private void pushNext() => AddStep(@"push next screen", () => ((TestScreen)screenStack.CurrentScreen).PushNext());
-        private void waitForCurrent() => AddUntilStep("current screen", () => screenStack.CurrentScreen.IsCurrentScreen());
-
-        private abstract partial class TestScreen : OsuScreen
-        {
-            protected abstract string NextTitle { get; }
-            protected abstract TestScreen CreateNextScreen();
-
-            public TestScreen PushNext()
-            {
-                TestScreen screen = CreateNextScreen();
-                this.Push(screen);
-
-                return screen;
-            }
-
-            protected TestScreen()
-            {
-                InternalChild = new FillFlowContainer
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    AutoSizeAxes = Axes.Both,
-                    Direction = FillDirection.Vertical,
-                    Spacing = new Vector2(10),
-                    Children = new Drawable[]
-                    {
-                        new OsuSpriteText
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            Text = Title,
-                        },
-                        new RoundedButton
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            Width = 100,
-                            Text = $"Push {NextTitle}",
-                            Action = () => PushNext(),
-                        },
-                    },
-                };
-            }
-        }
-
-        private partial class TestScreenOne : TestScreen
-        {
-            public override string Title => @"Screen One";
-            protected override string NextTitle => @"Two";
-            protected override TestScreen CreateNextScreen() => new TestScreenTwo();
-        }
-
-        private partial class TestScreenTwo : TestScreen
-        {
-            public override string Title => @"Screen Two";
-            protected override string NextTitle => @"One";
-            protected override TestScreen CreateNextScreen() => new TestScreenOne();
-        }
-    }
-}
diff --git a/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs b/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs
deleted file mode 100644
index 65dce422d6..0000000000
--- a/osu.Game/Graphics/UserInterface/ScreenBreadcrumbControl.cs
+++ /dev/null
@@ -1,48 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-#nullable disable
-
-using System.Linq;
-using osu.Framework.Extensions.IEnumerableExtensions;
-using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Screens;
-
-namespace osu.Game.Graphics.UserInterface
-{
-    /// <summary>
-    /// A <see cref="BreadcrumbControl{IScreen}"/> which follows the active screen (and allows navigation) in a <see cref="Screen"/> stack.
-    /// </summary>
-    public partial class ScreenBreadcrumbControl : BreadcrumbControl<IScreen>
-    {
-        public ScreenBreadcrumbControl(ScreenStack stack)
-        {
-            stack.ScreenPushed += onPushed;
-            stack.ScreenExited += onExited;
-
-            if (stack.CurrentScreen != null)
-                onPushed(null, stack.CurrentScreen);
-        }
-
-        protected override void SelectTab(TabItem<IScreen> tab)
-        {
-            // override base method to prevent current item from being changed on click.
-            // depend on screen push/exit to change current item instead.
-            tab.Value.MakeCurrent();
-        }
-
-        private void onPushed(IScreen lastScreen, IScreen newScreen)
-        {
-            AddItem(newScreen);
-            Current.Value = newScreen;
-        }
-
-        private void onExited(IScreen lastScreen, IScreen newScreen)
-        {
-            if (newScreen != null)
-                Current.Value = newScreen;
-
-            Items.ToList().SkipWhile(s => s != Current.Value).Skip(1).ForEach(RemoveItem);
-        }
-    }
-}

From b11ae1c5714b43d33ebbec569faf6569d0304c25 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 20 Mar 2024 06:40:18 +0300
Subject: [PATCH 433/930] Organise code, still hook up to `RoomChanged` to
 update room privacy mode, and use `SkipIdenticalPresence` + scheduling to
 avoid potential rate-limits

---
 osu.Desktop/DiscordRichPresence.cs | 87 ++++++++++++++++++------------
 1 file changed, 54 insertions(+), 33 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index d8013aabfe..8e4af5c5b1 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -2,16 +2,16 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Diagnostics;
 using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
 using Newtonsoft.Json;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
-using osu.Framework.Development;
+using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Logging;
+using osu.Framework.Threading;
 using osu.Game;
 using osu.Game.Configuration;
 using osu.Game.Extensions;
@@ -53,8 +53,6 @@ namespace osu.Desktop
 
         private readonly Bindable<DiscordRichPresenceMode> privacyMode = new Bindable<DiscordRichPresenceMode>();
 
-        private int usersCurrentlyInLobby;
-
         private readonly RichPresence presence = new RichPresence
         {
             Assets = new Assets { LargeImageKey = "osu_logo_lazer" },
@@ -72,7 +70,9 @@ namespace osu.Desktop
 
             client = new DiscordRpcClient(client_id)
             {
-                SkipIdenticalPresence = false // handles better on discord IPC loss, see updateStatus call in onReady.
+                // SkipIdenticalPresence allows us to fire SetPresence at any point and leave it to the underlying implementation
+                // to check whether a difference has actually occurred before sending a command to Discord (with a minor caveat that's handled in onReady).
+                SkipIdenticalPresence = true
             };
 
             client.OnReady += onReady;
@@ -95,10 +95,11 @@ namespace osu.Desktop
                 activity.BindTo(u.NewValue.Activity);
             }, true);
 
-            ruleset.BindValueChanged(_ => updateStatus());
-            status.BindValueChanged(_ => updateStatus());
-            activity.BindValueChanged(_ => updateStatus());
-            privacyMode.BindValueChanged(_ => updateStatus());
+            ruleset.BindValueChanged(_ => updatePresence());
+            status.BindValueChanged(_ => updatePresence());
+            activity.BindValueChanged(_ => updatePresence());
+            privacyMode.BindValueChanged(_ => updatePresence());
+            multiplayerClient.RoomUpdated += onRoomUpdated;
 
             client.Initialize();
         }
@@ -106,24 +107,44 @@ namespace osu.Desktop
         private void onReady(object _, ReadyMessage __)
         {
             Logger.Log("Discord RPC Client ready.", LoggingTarget.Network, LogLevel.Debug);
-            Schedule(updateStatus);
+
+            // when RPC is lost and reconnected, we have to clear presence state for updatePresence to work (see DiscordRpcClient.SkipIdenticalPresence).
+            if (client.CurrentPresence != null)
+                client.SetPresence(null);
+
+            updatePresence();
         }
 
-        private void updateStatus()
+        private void onRoomUpdated() => updatePresence();
+
+        private ScheduledDelegate? presenceUpdateDelegate;
+
+        private void updatePresence()
         {
-            Debug.Assert(ThreadSafety.IsUpdateThread);
-
-            if (!client.IsInitialized)
-                return;
-
-            if (status.Value == UserStatus.Offline || privacyMode.Value == DiscordRichPresenceMode.Off)
+            presenceUpdateDelegate?.Cancel();
+            presenceUpdateDelegate = Scheduler.AddDelayed(() =>
             {
-                client.ClearPresence();
-                return;
-            }
+                if (!client.IsInitialized)
+                    return;
 
-            bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
+                if (status.Value == UserStatus.Offline || privacyMode.Value == DiscordRichPresenceMode.Off)
+                {
+                    client.ClearPresence();
+                    return;
+                }
 
+                bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
+
+                updatePresenceStatus(hideIdentifiableInformation);
+                updatePresenceParty(hideIdentifiableInformation);
+                updatePresenceAssets();
+
+                client.SetPresence(presence);
+            }, 200);
+        }
+
+        private void updatePresenceStatus(bool hideIdentifiableInformation)
+        {
             if (activity.Value != null)
             {
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
@@ -150,14 +171,14 @@ namespace osu.Desktop
                 presence.State = "Idle";
                 presence.Details = string.Empty;
             }
+        }
 
+        private void updatePresenceParty(bool hideIdentifiableInformation)
+        {
             if (!hideIdentifiableInformation && multiplayerClient.Room != null)
             {
                 MultiplayerRoom room = multiplayerClient.Room;
 
-                if (room.Users.Count == usersCurrentlyInLobby)
-                    return;
-
                 presence.Party = new Party
                 {
                     Privacy = string.IsNullOrEmpty(room.Settings.Password) ? Party.PrivacySetting.Public : Party.PrivacySetting.Private,
@@ -175,17 +196,16 @@ namespace osu.Desktop
                 };
 
                 presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
-                usersCurrentlyInLobby = room.Users.Count;
             }
             else
             {
                 presence.Party = null;
                 presence.Secrets.JoinSecret = null;
-                usersCurrentlyInLobby = 0;
             }
+        }
 
-            Logger.Log($"Updating Discord RPC presence with activity status: {presence.State}, details: {presence.Details}", LoggingTarget.Network, LogLevel.Debug);
-
+        private void updatePresenceAssets()
+        {
             // update user information
             if (privacyMode.Value == DiscordRichPresenceMode.Limited)
                 presence.Assets.LargeImageText = string.Empty;
@@ -200,17 +220,15 @@ namespace osu.Desktop
             // update ruleset
             presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset() ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
             presence.Assets.SmallImageText = ruleset.Value.Name;
-
-            client.SetPresence(presence);
         }
 
-        private void onJoin(object sender, JoinMessage args)
+        private void onJoin(object sender, JoinMessage args) => Scheduler.AddOnce(() =>
         {
             game.Window?.Raise();
 
             if (!api.IsLoggedIn)
             {
-                Schedule(() => login?.Show());
+                login?.Show();
                 return;
             }
 
@@ -231,7 +249,7 @@ namespace osu.Desktop
             });
             request.Failure += _ => Logger.Log($"Could not join multiplayer room, room could not be found (room ID: {roomId}).", LoggingTarget.Network, LogLevel.Important);
             api.Queue(request);
-        }
+        });
 
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
@@ -294,6 +312,9 @@ namespace osu.Desktop
 
         protected override void Dispose(bool isDisposing)
         {
+            if (multiplayerClient.IsNotNull())
+                multiplayerClient.RoomUpdated -= onRoomUpdated;
+
             client.Dispose();
             base.Dispose(isDisposing);
         }

From 5f86b5a2fa2b109ec63d283a84356dc46efb67ac Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 20 Mar 2024 07:36:15 +0300
Subject: [PATCH 434/930] Use DI correctly

---
 osu.Desktop/DiscordRichPresence.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 8e4af5c5b1..d78459ff28 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -43,6 +43,7 @@ namespace osu.Desktop
         [Resolved]
         private OsuGame game { get; set; } = null!;
 
+        [Resolved]
         private LoginOverlay? login { get; set; }
 
         [Resolved]
@@ -66,8 +67,6 @@ namespace osu.Desktop
         [BackgroundDependencyLoader]
         private void load(OsuConfigManager config)
         {
-            login = game.Dependencies.Get<LoginOverlay>();
-
             client = new DiscordRpcClient(client_id)
             {
                 // SkipIdenticalPresence allows us to fire SetPresence at any point and leave it to the underlying implementation

From fd509c82f50a59293fee0978769bcaa02c28f852 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 20 Mar 2024 12:52:54 +0800
Subject: [PATCH 435/930] Adjust code structure slightly

---
 .../Timeline/TimelineControlPointDisplay.cs      | 16 ++++++----------
 1 file changed, 6 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
index 8e522fa715..116a3ee105 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineControlPointDisplay.cs
@@ -32,10 +32,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
             controlPointGroups.UnbindAll();
             controlPointGroups.BindTo(beatmap.ControlPointInfo.Groups);
-            controlPointGroups.BindCollectionChanged((_, _) =>
-            {
-                invalidateGroups();
-            }, true);
+            controlPointGroups.BindCollectionChanged((_, _) => groupCache.Invalidate(), true);
         }
 
         protected override void Update()
@@ -51,19 +48,20 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             if (visibleRange != newRange)
             {
                 visibleRange = newRange;
-                invalidateGroups();
+                groupCache.Invalidate();
             }
 
             if (!groupCache.IsValid)
+            {
                 recreateDrawableGroups();
+                groupCache.Validate();
+            }
         }
 
-        private void invalidateGroups() => groupCache.Invalidate();
-
         private void recreateDrawableGroups()
         {
             // Remove groups outside the visible range
-            foreach (var drawableGroup in this)
+            foreach (TimelineControlPointGroup drawableGroup in this)
             {
                 if (!shouldBeVisible(drawableGroup.Group))
                     drawableGroup.Expire();
@@ -93,8 +91,6 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
 
                 Add(new TimelineControlPointGroup(group));
             }
-
-            groupCache.Validate();
         }
 
         private bool shouldBeVisible(ControlPointGroup group) => group.Time >= visibleRange.min && group.Time <= visibleRange.max;

From 1f343b75454c416b8c17d98428330096213c7fc6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 20 Mar 2024 08:27:49 +0100
Subject: [PATCH 436/930] Add extended logging when discarding online metadata
 lookup results

Related to: https://github.com/ppy/osu/issues/27674

Relevant log output for that particular case:

	[network] 2024-03-20 07:25:30 [verbose]: Performing request osu.Game.Online.API.Requests.GetBeatmapRequest
	[network] 2024-03-20 07:25:30 [verbose]: Request to https://dev.ppy.sh/api/v2/beatmaps/lookup successfully completed!
	[network] 2024-03-20 07:25:30 [verbose]: GetBeatmapRequest finished with response size of 3,170 bytes
	[database] 2024-03-20 07:25:30 [verbose]: [4fe02] [APIBeatmapMetadataSource] Online retrieval mapped Tsukiyama Sae - Hana Saku Iro wa Koi no Gotoshi (Log Off Now) [Destiny] to 744883 / 1613507.
	[database] 2024-03-20 07:25:30 [verbose]: Discarding metadata lookup result due to mismatching online ID (expected: 1570982 actual: 1613507)
	[network] 2024-03-20 07:25:30 [verbose]: Performing request osu.Game.Online.API.Requests.GetBeatmapRequest
	[network] 2024-03-20 07:25:30 [verbose]: Request to https://dev.ppy.sh/api/v2/beatmaps/lookup successfully completed!
	[network] 2024-03-20 07:25:30 [verbose]: GetBeatmapRequest finished with response size of 2,924 bytes
	[database] 2024-03-20 07:25:30 [verbose]: [4fe02] [APIBeatmapMetadataSource] Online retrieval mapped Tsukiyama Sae - Hana Saku Iro wa Koi no Gotoshi (Log Off Now) [Easy] to 744883 / 1570982.
	[database] 2024-03-20 07:25:30 [verbose]: Discarding metadata lookup result due to mismatching online ID (expected: 1613507 actual: 1570982)

Note that the online IDs are swapped.
---
 osu.Game/Beatmaps/BeatmapUpdaterMetadataLookup.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapUpdaterMetadataLookup.cs b/osu.Game/Beatmaps/BeatmapUpdaterMetadataLookup.cs
index f395718a93..034ec31ee4 100644
--- a/osu.Game/Beatmaps/BeatmapUpdaterMetadataLookup.cs
+++ b/osu.Game/Beatmaps/BeatmapUpdaterMetadataLookup.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Online.API;
 
@@ -85,10 +86,16 @@ namespace osu.Game.Beatmaps
         private bool shouldDiscardLookupResult(OnlineBeatmapMetadata result, BeatmapInfo beatmapInfo)
         {
             if (beatmapInfo.OnlineID > 0 && result.BeatmapID != beatmapInfo.OnlineID)
+            {
+                Logger.Log($"Discarding metadata lookup result due to mismatching online ID (expected: {beatmapInfo.OnlineID} actual: {result.BeatmapID})", LoggingTarget.Database);
                 return true;
+            }
 
             if (beatmapInfo.OnlineID == -1 && result.MD5Hash != beatmapInfo.MD5Hash)
+            {
+                Logger.Log($"Discarding metadata lookup result due to mismatching hash (expected: {beatmapInfo.MD5Hash} actual: {result.MD5Hash})", LoggingTarget.Database);
                 return true;
+            }
 
             return false;
         }

From c78e203df5434495a79589559b973917a4088a3e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 20 Mar 2024 17:30:34 +0900
Subject: [PATCH 437/930] Fix infinite health processor loop when no top-level
 objects

This is unlikely to occur in actual gameplay, but occurs in the
follow-up test.
---
 osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
index 2bc3ea80ec..7cee5ebecf 100644
--- a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
@@ -108,6 +108,9 @@ namespace osu.Game.Rulesets.Scoring
                     increaseHp(h);
                 }
 
+                if (topLevelObjectCount == 0)
+                    return testDrop;
+
                 if (!fail && currentHp < lowestHpEnd)
                 {
                     fail = true;

From 66ace02e5872bd900acdaf7682a9178eea7dc168 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 20 Mar 2024 17:31:11 +0900
Subject: [PATCH 438/930] Add test for banana shower fail

---
 osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
index d0a8ce4bbc..1b46be01fb 100644
--- a/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/CatchHealthProcessorTest.cs
@@ -19,6 +19,7 @@ namespace osu.Game.Rulesets.Catch.Tests
             [new Droplet(), 0.01, true],
             [new TinyDroplet(), 0, false],
             [new Banana(), 0, false],
+            [new BananaShower(), 0, false]
         ];
 
         [TestCaseSource(nameof(test_cases))]

From bf5640049a73e2eb01c5cc02814aaea43d7c00e5 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 20 Mar 2024 17:31:31 +0900
Subject: [PATCH 439/930] Fix banana showers causing fails when hp is at 0

---
 osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
index 2f55f9a85f..b2509091fe 100644
--- a/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
+++ b/osu.Game.Rulesets.Catch/Scoring/CatchHealthProcessor.cs
@@ -32,6 +32,10 @@ namespace osu.Game.Rulesets.Catch.Scoring
             if (result.Type == HitResult.SmallTickMiss)
                 return false;
 
+            // on stable, banana showers don't exist as concrete objects themselves, so they can't cause a fail.
+            if (result.HitObject is BananaShower)
+                return false;
+
             return base.CheckDefaultFailCondition(result);
         }
 

From 4904c49c38b418f3a151c34c114be96983bb03b7 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 20 Mar 2024 09:31:58 -0300
Subject: [PATCH 440/930] Add abnormal difficulty settings checks

---
 .../CheckAbnormalDifficultySettingsTest.cs    | 93 +++++++++++++++++++
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |  5 +-
 .../Checks/CheckAbnormalDifficultySettings.cs | 82 ++++++++++++++++
 3 files changed, 179 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs b/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs
new file mode 100644
index 0000000000..94305755c4
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs
@@ -0,0 +1,93 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Rulesets.Edit.Checks;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Tests.Beatmaps;
+using System.Linq;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckAbnormalDifficultySettingsTest
+    {
+        private CheckAbnormalDifficultySettings check = null!;
+
+        private IBeatmap beatmap = new Beatmap<HitObject>();
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckAbnormalDifficultySettings();
+            beatmap.Difficulty = new();
+        }
+
+        [Test]
+        public void TestSettingsNormal()
+        {
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestAllSettingsMoreThanOneDecimal()
+        {
+            beatmap.Difficulty = new()
+            {
+                ApproachRate = 5.55f,
+                OverallDifficulty = 7.7777f,
+                CircleSize = 4.444f,
+                DrainRate = 1.1111111111f,
+            };
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(4));
+        }
+
+        [Test]
+        public void TestAllSettingsLessThanZero()
+        {
+            beatmap.Difficulty = new()
+            {
+                ApproachRate = -1,
+                OverallDifficulty = -20,
+                CircleSize = -11,
+                DrainRate = -34,
+            };
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(4));
+        }
+
+        [Test]
+        public void TestAllSettingsHigherThanTen()
+        {
+            beatmap.Difficulty = new()
+            {
+                ApproachRate = 14,
+                OverallDifficulty = 24,
+                CircleSize = 30,
+                DrainRate = 90,
+            };
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(4));
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index dcf5eb4da9..edabe941b7 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -41,7 +41,10 @@ namespace osu.Game.Rulesets.Edit
             new CheckPreviewTime(),
 
             // Events
-            new CheckBreaks()
+            new CheckBreaks(),
+
+            // Settings
+            new CheckAbnormalDifficultySettings(),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
new file mode 100644
index 0000000000..73049b323d
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
@@ -0,0 +1,82 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckAbnormalDifficultySettings : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Abnormal difficulty settings");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateMoreThanOneDecimal(this),
+            new IssueTemplateOutOfRange(this),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (hasMoreThanOneDecimalPlace(diff.ApproachRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
+
+            if (isOutOfRange(diff.ApproachRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
+
+
+            if (hasMoreThanOneDecimalPlace(diff.OverallDifficulty))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (isOutOfRange(diff.OverallDifficulty))
+                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+
+            if (hasMoreThanOneDecimalPlace(diff.CircleSize))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
+
+            if (isOutOfRange(diff.CircleSize))
+                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
+
+
+            if (hasMoreThanOneDecimalPlace(diff.DrainRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+
+            if (isOutOfRange(diff.DrainRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+        }
+
+        private bool isOutOfRange(float setting)
+        {
+            return setting < 0f || setting > 10f;
+        }
+
+        private bool hasMoreThanOneDecimalPlace(float setting)
+        {
+            return float.Round(setting, 1) != setting;
+        }
+
+        public class IssueTemplateMoreThanOneDecimal : IssueTemplate
+        {
+            public IssueTemplateMoreThanOneDecimal(ICheck check)
+                : base(check, IssueType.Problem, "{0} {1} has more than one decimal place.")
+            {
+            }
+
+            public Issue Create(string settingName, float settingValue) => new Issue(this, settingName, settingValue);
+        }
+
+        public class IssueTemplateOutOfRange : IssueTemplate
+        {
+            public IssueTemplateOutOfRange(ICheck check)
+                : base(check, IssueType.Warning, "{0} is {1} although it is capped between 0 to 10 in-game.")
+            {
+            }
+
+            public Issue Create(string settingName, float settingValue) => new Issue(this, settingName, settingValue);
+        }
+    }
+}

From ac7fca10d63e3f92db65572ea77ae0ab4bb58df6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 21 Mar 2024 00:47:37 +0900
Subject: [PATCH 441/930] Warn about not using an official "deployed" build

---
 osu.Game/Localisation/NotificationsStrings.cs |  5 +++++
 osu.Game/Updater/UpdateManager.cs             |  6 ++++++
 osu.Game/Utils/OfficialBuildAttribute.cs      | 12 ++++++++++++
 3 files changed, 23 insertions(+)
 create mode 100644 osu.Game/Utils/OfficialBuildAttribute.cs

diff --git a/osu.Game/Localisation/NotificationsStrings.cs b/osu.Game/Localisation/NotificationsStrings.cs
index f4965e4ebe..5328bcd066 100644
--- a/osu.Game/Localisation/NotificationsStrings.cs
+++ b/osu.Game/Localisation/NotificationsStrings.cs
@@ -125,6 +125,11 @@ Click to see what's new!", version);
         /// </summary>
         public static LocalisableString UpdateReadyToInstall => new TranslatableString(getKey(@"update_ready_to_install"), @"Update ready to install. Click to restart!");
 
+        /// <summary>
+        /// "This is not an official build of the game and scores will not be submitted."
+        /// </summary>
+        public static LocalisableString NotOfficialBuild => new TranslatableString(getKey(@"not_official_build"), @"This is not an official build of the game and scores will not be submitted.");
+
         /// <summary>
         /// "Downloading update..."
         /// </summary>
diff --git a/osu.Game/Updater/UpdateManager.cs b/osu.Game/Updater/UpdateManager.cs
index 8f13e0f42a..bcb28d8b14 100644
--- a/osu.Game/Updater/UpdateManager.cs
+++ b/osu.Game/Updater/UpdateManager.cs
@@ -1,7 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Reflection;
 using System.Threading.Tasks;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -11,6 +13,7 @@ using osu.Game.Graphics;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Utils;
 using osuTK;
 
 namespace osu.Game.Updater
@@ -51,6 +54,9 @@ namespace osu.Game.Updater
                 // only show a notification if we've previously saved a version to the config file (ie. not the first run).
                 if (!string.IsNullOrEmpty(lastVersion))
                     Notifications.Post(new UpdateCompleteNotification(version));
+
+                if (RuntimeInfo.EntryAssembly.GetCustomAttribute<OfficialBuildAttribute>() == null)
+                    Notifications.Post(new SimpleNotification { Text = NotificationsStrings.NotOfficialBuild });
             }
 
             // debug / local compilations will reset to a non-release string.
diff --git a/osu.Game/Utils/OfficialBuildAttribute.cs b/osu.Game/Utils/OfficialBuildAttribute.cs
new file mode 100644
index 0000000000..66c1ef5591
--- /dev/null
+++ b/osu.Game/Utils/OfficialBuildAttribute.cs
@@ -0,0 +1,12 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using JetBrains.Annotations;
+
+namespace osu.Game.Utils
+{
+    [UsedImplicitly]
+    [AttributeUsage(AttributeTargets.Assembly)]
+    public class OfficialBuildAttribute : Attribute;
+}

From c605e463a41388f43a0493d1246a813f1f7d4ab1 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 20 Mar 2024 15:52:16 -0300
Subject: [PATCH 442/930] Add mania keycount check

---
 .../Editor/Checks/CheckKeyCountTest.cs        | 75 +++++++++++++++++++
 .../Edit/Checks/CheckKeyCount.cs              | 55 ++++++++++++++
 .../Edit/ManiaBeatmapVerifier.cs              | 24 ++++++
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  2 +
 .../Checks/CheckAbnormalDifficultySettings.cs |  4 +-
 5 files changed, 158 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
 create mode 100644 osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
 create mode 100644 osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
new file mode 100644
index 0000000000..91361e2a62
--- /dev/null
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
@@ -0,0 +1,75 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+using osu.Game.Rulesets.Mania.Edit.Checks;
+using System.Linq;
+
+namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class CheckKeyCountTest
+    {
+        private CheckKeyCount check = null!;
+
+        private IBeatmap beatmap = null!;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckKeyCount();
+
+            beatmap = new Beatmap<HitObject>()
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    Ruleset = new ManiaRuleset().RulesetInfo
+                }
+            };
+        }
+
+        [Test]
+        public void TestKeycountFour()
+        {
+            beatmap.Difficulty.CircleSize = 4;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestKeycountSmallerThanFour()
+        {
+            beatmap.Difficulty.CircleSize = 1;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckKeyCount.IssueTemplateKeycountTooLow);
+        }
+
+        [Test]
+        public void TestKeycountHigherThanTen()
+        {
+            beatmap.Difficulty.CircleSize = 11;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckKeyCount.IssueTemplateKeycountNonStandard);
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs b/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
new file mode 100644
index 0000000000..57991bd3ff
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
@@ -0,0 +1,55 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Mania.Edit.Checks
+{
+    public class CheckKeyCount : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Check mania keycount.");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateKeycountTooLow(this),
+            new IssueTemplateKeycountNonStandard(this),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (diff.CircleSize < 4)
+            {
+                yield return new IssueTemplateKeycountTooLow(this).Create(diff.CircleSize);
+            }
+
+            if (diff.CircleSize > 10)
+            {
+                yield return new IssueTemplateKeycountNonStandard(this).Create(diff.CircleSize);
+            }
+        }
+
+        public class IssueTemplateKeycountTooLow : IssueTemplate
+        {
+            public IssueTemplateKeycountTooLow(ICheck check)
+                : base(check, IssueType.Problem, "Key count is {0} and must be 4 or higher.")
+            {
+            }
+
+            public Issue Create(float current) => new Issue(this, current);
+        }
+
+        public class IssueTemplateKeycountNonStandard : IssueTemplate
+        {
+            public IssueTemplateKeycountNonStandard(ICheck check)
+                : base(check, IssueType.Warning, "Key count {0} is higher than 10.")
+            {
+            }
+
+            public Issue Create(float current) => new Issue(this, current);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs b/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs
new file mode 100644
index 0000000000..778dcfc6e1
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs
@@ -0,0 +1,24 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.Linq;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Rulesets.Mania.Edit.Checks;
+
+namespace osu.Game.Rulesets.Mania.Edit
+{
+    public class ManiaBeatmapVerifier : IBeatmapVerifier
+    {
+        private readonly List<ICheck> checks = new List<ICheck>
+        {
+            new CheckKeyCount(),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            return checks.SelectMany(check => check.Run(context));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 0b54fb3da0..3d4803f1e4 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -65,6 +65,8 @@ namespace osu.Game.Rulesets.Mania
 
         public override HitObjectComposer CreateHitObjectComposer() => new ManiaHitObjectComposer(this);
 
+        public override IBeatmapVerifier CreateBeatmapVerifier() => new ManiaBeatmapVerifier();
+
         public override ISkin? CreateSkinTransformer(ISkin skin, IBeatmap beatmap)
         {
             switch (skin)
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
index 73049b323d..3c454a57fe 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
@@ -4,7 +4,6 @@
 using System.Collections.Generic;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
-
 namespace osu.Game.Rulesets.Edit.Checks
 {
     public class CheckAbnormalDifficultySettings : ICheck
@@ -20,6 +19,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
+            string ruleset = context.Beatmap.BeatmapInfo.Ruleset.ShortName;
 
             if (hasMoreThanOneDecimalPlace(diff.ApproachRate))
                 yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
@@ -38,7 +38,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             if (hasMoreThanOneDecimalPlace(diff.CircleSize))
                 yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
 
-            if (isOutOfRange(diff.CircleSize))
+            if (ruleset != "mania" && isOutOfRange(diff.CircleSize))
                 yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
 
 

From 2d6a3b8e2b5e3f0023957868a0706f5df162e110 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 20 Mar 2024 16:51:27 -0300
Subject: [PATCH 443/930] Remove warning for 10K+

---
 .../Editor/Checks/CheckKeyCountTest.cs           | 12 ------------
 .../Edit/Checks/CheckKeyCount.cs                 | 16 ----------------
 2 files changed, 28 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
index 91361e2a62..564c611548 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
@@ -55,18 +55,6 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
             Assert.That(issues.Single().Template is CheckKeyCount.IssueTemplateKeycountTooLow);
         }
 
-        [Test]
-        public void TestKeycountHigherThanTen()
-        {
-            beatmap.Difficulty.CircleSize = 11;
-
-            var context = getContext();
-            var issues = check.Run(context).ToList();
-
-            Assert.That(issues, Has.Count.EqualTo(1));
-            Assert.That(issues.Single().Template is CheckKeyCount.IssueTemplateKeycountNonStandard);
-        }
-
         private BeatmapVerifierContext getContext()
         {
             return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
diff --git a/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs b/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
index 57991bd3ff..51ead5f423 100644
--- a/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Checks/CheckKeyCount.cs
@@ -14,7 +14,6 @@ namespace osu.Game.Rulesets.Mania.Edit.Checks
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
             new IssueTemplateKeycountTooLow(this),
-            new IssueTemplateKeycountNonStandard(this),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
@@ -25,11 +24,6 @@ namespace osu.Game.Rulesets.Mania.Edit.Checks
             {
                 yield return new IssueTemplateKeycountTooLow(this).Create(diff.CircleSize);
             }
-
-            if (diff.CircleSize > 10)
-            {
-                yield return new IssueTemplateKeycountNonStandard(this).Create(diff.CircleSize);
-            }
         }
 
         public class IssueTemplateKeycountTooLow : IssueTemplate
@@ -41,15 +35,5 @@ namespace osu.Game.Rulesets.Mania.Edit.Checks
 
             public Issue Create(float current) => new Issue(this, current);
         }
-
-        public class IssueTemplateKeycountNonStandard : IssueTemplate
-        {
-            public IssueTemplateKeycountNonStandard(ICheck check)
-                : base(check, IssueType.Warning, "Key count {0} is higher than 10.")
-            {
-            }
-
-            public Issue Create(float current) => new Issue(this, current);
-        }
     }
 }

From b132734f9c429da05b976544b266528c765019e6 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 20 Mar 2024 18:54:38 -0300
Subject: [PATCH 444/930] Fix codefactor issues

---
 .../Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs    | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
index 3c454a57fe..db154f4efc 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
@@ -27,21 +27,18 @@ namespace osu.Game.Rulesets.Edit.Checks
             if (isOutOfRange(diff.ApproachRate))
                 yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
 
-
             if (hasMoreThanOneDecimalPlace(diff.OverallDifficulty))
                 yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
 
             if (isOutOfRange(diff.OverallDifficulty))
                 yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
 
-
             if (hasMoreThanOneDecimalPlace(diff.CircleSize))
                 yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
 
             if (ruleset != "mania" && isOutOfRange(diff.CircleSize))
                 yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
 
-
             if (hasMoreThanOneDecimalPlace(diff.DrainRate))
                 yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
 

From a07d5115bfef749e2b766a554ceb420c82206dd0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Mar 2024 11:42:22 +0800
Subject: [PATCH 445/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index de7497d58e..0e091dbd37 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.309.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.321.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From 55d66d4615e65bdbcc794d385da3210aa130d7cf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Mar 2024 11:45:46 +0800
Subject: [PATCH 446/930] Add sounds to countdown

---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 29 +++++++++++++++----
 1 file changed, 23 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 8bb3ae8182..147d48ae02 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -3,6 +3,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -47,6 +49,8 @@ namespace osu.Game.Screens.Play
         private SpriteText countdownText = null!;
         private CircularProgress countdownProgress = null!;
 
+        private Sample? sampleCountdown;
+
         public DelayedResumeOverlay()
         {
             Anchor = Anchor.Centre;
@@ -54,7 +58,7 @@ namespace osu.Game.Screens.Play
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
             Add(outerContent = new Circle
             {
@@ -103,6 +107,8 @@ namespace osu.Game.Screens.Play
                     }
                 }
             });
+
+            sampleCountdown = audio.Samples.Get(@"Gameplay/resume-countdown");
         }
 
         protected override void PopIn()
@@ -164,13 +170,24 @@ namespace osu.Game.Screens.Play
             countdownProgress.Progress = amountTimePassed;
             countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 
-            if (countdownCount != newCount && newCount > 0)
+            if (countdownCount != newCount)
             {
-                countdownText.Text = Math.Max(1, newCount).ToString();
-                countdownText.ScaleTo(0.25f).Then().ScaleTo(1, 200, Easing.OutQuint);
-                outerContent.Delay(25).Then().ScaleTo(1.05f, 100).Then().ScaleTo(1f, 200, Easing.Out);
+                if (newCount > 0)
+                {
+                    countdownText.Text = Math.Max(1, newCount).ToString();
+                    countdownText.ScaleTo(0.25f).Then().ScaleTo(1, 200, Easing.OutQuint);
+                    outerContent.Delay(25).Then().ScaleTo(1.05f, 100).Then().ScaleTo(1f, 200, Easing.Out);
 
-                countdownBackground.FlashColour(colourProvider.Background3, 400, Easing.Out);
+                    countdownBackground.FlashColour(colourProvider.Background3, 400, Easing.Out);
+                }
+
+                var chan = sampleCountdown?.GetChannel();
+
+                if (chan != null)
+                {
+                    chan.Frequency.Value = newCount == 0 ? 0.5f : 1;
+                    chan.Play();
+                }
             }
 
             countdownCount = newCount;

From b99b0337cffd33519b1323adbda98cb13b395f63 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 21 Mar 2024 13:06:25 +0800
Subject: [PATCH 447/930] Adjust text slightly

---
 osu.Game/Localisation/NotificationsStrings.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Localisation/NotificationsStrings.cs b/osu.Game/Localisation/NotificationsStrings.cs
index 5328bcd066..3188ca5533 100644
--- a/osu.Game/Localisation/NotificationsStrings.cs
+++ b/osu.Game/Localisation/NotificationsStrings.cs
@@ -126,9 +126,9 @@ Click to see what's new!", version);
         public static LocalisableString UpdateReadyToInstall => new TranslatableString(getKey(@"update_ready_to_install"), @"Update ready to install. Click to restart!");
 
         /// <summary>
-        /// "This is not an official build of the game and scores will not be submitted."
+        /// "This is not an official build of the game. Scores will not be submitted and other online systems may not work as intended."
         /// </summary>
-        public static LocalisableString NotOfficialBuild => new TranslatableString(getKey(@"not_official_build"), @"This is not an official build of the game and scores will not be submitted.");
+        public static LocalisableString NotOfficialBuild => new TranslatableString(getKey(@"not_official_build"), @"This is not an official build of the game. Scores will not be submitted and other online systems may not work as intended.");
 
         /// <summary>
         /// "Downloading update..."

From a4822fd615ef983be0399182f98159fc8546e427 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Fri, 22 Mar 2024 01:37:06 -0300
Subject: [PATCH 448/930] Make `CheckAbnormalDifficultySettings` abstract

---
 .../CheckAbnormalDifficultySettingsTest.cs    | 93 -------------------
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |  3 -
 .../Checks/CheckAbnormalDifficultySettings.cs | 41 ++------
 3 files changed, 8 insertions(+), 129 deletions(-)
 delete mode 100644 osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs b/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs
deleted file mode 100644
index 94305755c4..0000000000
--- a/osu.Game.Tests/Editing/Checks/CheckAbnormalDifficultySettingsTest.cs
+++ /dev/null
@@ -1,93 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Game.Rulesets.Edit.Checks;
-using NUnit.Framework;
-using osu.Game.Beatmaps;
-using osu.Game.Rulesets.Objects;
-using osu.Game.Rulesets.Edit;
-using osu.Game.Tests.Beatmaps;
-using System.Linq;
-
-namespace osu.Game.Tests.Editing.Checks
-{
-    [TestFixture]
-    public class CheckAbnormalDifficultySettingsTest
-    {
-        private CheckAbnormalDifficultySettings check = null!;
-
-        private IBeatmap beatmap = new Beatmap<HitObject>();
-
-        [SetUp]
-        public void Setup()
-        {
-            check = new CheckAbnormalDifficultySettings();
-            beatmap.Difficulty = new();
-        }
-
-        [Test]
-        public void TestSettingsNormal()
-        {
-            var context = getContext();
-            var issues = check.Run(context).ToList();
-
-            Assert.That(issues, Has.Count.EqualTo(0));
-        }
-
-        [Test]
-        public void TestAllSettingsMoreThanOneDecimal()
-        {
-            beatmap.Difficulty = new()
-            {
-                ApproachRate = 5.55f,
-                OverallDifficulty = 7.7777f,
-                CircleSize = 4.444f,
-                DrainRate = 1.1111111111f,
-            };
-
-            var context = getContext();
-            var issues = check.Run(context).ToList();
-
-            Assert.That(issues, Has.Count.EqualTo(4));
-        }
-
-        [Test]
-        public void TestAllSettingsLessThanZero()
-        {
-            beatmap.Difficulty = new()
-            {
-                ApproachRate = -1,
-                OverallDifficulty = -20,
-                CircleSize = -11,
-                DrainRate = -34,
-            };
-
-            var context = getContext();
-            var issues = check.Run(context).ToList();
-
-            Assert.That(issues, Has.Count.EqualTo(4));
-        }
-
-        [Test]
-        public void TestAllSettingsHigherThanTen()
-        {
-            beatmap.Difficulty = new()
-            {
-                ApproachRate = 14,
-                OverallDifficulty = 24,
-                CircleSize = 30,
-                DrainRate = 90,
-            };
-
-            var context = getContext();
-            var issues = check.Run(context).ToList();
-
-            Assert.That(issues, Has.Count.EqualTo(4));
-        }
-
-        private BeatmapVerifierContext getContext()
-        {
-            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
-        }
-    }
-}
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index edabe941b7..2eb52e88c7 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -42,9 +42,6 @@ namespace osu.Game.Rulesets.Edit
 
             // Events
             new CheckBreaks(),
-
-            // Settings
-            new CheckAbnormalDifficultySettings(),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
index db154f4efc..93592a866b 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
@@ -6,9 +6,9 @@ using osu.Game.Rulesets.Edit.Checks.Components;
 
 namespace osu.Game.Rulesets.Edit.Checks
 {
-    public class CheckAbnormalDifficultySettings : ICheck
+    public abstract class CheckAbnormalDifficultySettings : ICheck
     {
-        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Abnormal difficulty settings");
+        public abstract CheckMetadata Metadata { get; }
 
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
@@ -16,42 +16,17 @@ namespace osu.Game.Rulesets.Edit.Checks
             new IssueTemplateOutOfRange(this),
         };
 
-        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
-        {
-            var diff = context.Beatmap.Difficulty;
-            string ruleset = context.Beatmap.BeatmapInfo.Ruleset.ShortName;
+        public abstract IEnumerable<Issue> Run(BeatmapVerifierContext context);
 
-            if (hasMoreThanOneDecimalPlace(diff.ApproachRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
-
-            if (isOutOfRange(diff.ApproachRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
-
-            if (hasMoreThanOneDecimalPlace(diff.OverallDifficulty))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
-
-            if (isOutOfRange(diff.OverallDifficulty))
-                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
-
-            if (hasMoreThanOneDecimalPlace(diff.CircleSize))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
-
-            if (ruleset != "mania" && isOutOfRange(diff.CircleSize))
-                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
-
-            if (hasMoreThanOneDecimalPlace(diff.DrainRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
-
-            if (isOutOfRange(diff.DrainRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
-        }
-
-        private bool isOutOfRange(float setting)
+        /// <summary>
+        /// If the setting is out of the boundaries set by the editor (0 - 10)
+        /// </summary>
+        protected bool OutOfRange(float setting)
         {
             return setting < 0f || setting > 10f;
         }
 
-        private bool hasMoreThanOneDecimalPlace(float setting)
+        protected bool HasMoreThanOneDecimalPlace(float setting)
         {
             return float.Round(setting, 1) != setting;
         }

From e2df0981843c3428fa11a232d341d97ac3e0505f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Mar 2024 08:25:03 +0100
Subject: [PATCH 449/930] Add failing test case for desired artist sort
 behaviour

---
 .../SongSelect/TestSceneBeatmapCarousel.cs    | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
index de2ae3708f..c0102b238c 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneBeatmapCarousel.cs
@@ -666,6 +666,56 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert($"Check {zzz_lowercase} is second last", () => carousel.BeatmapSets.SkipLast(1).Last().Metadata.Artist == zzz_lowercase);
         }
 
+        [Test]
+        public void TestSortByArtistUsesTitleAsTiebreaker()
+        {
+            var sets = new List<BeatmapSetInfo>();
+
+            AddStep("Populuate beatmap sets", () =>
+            {
+                sets.Clear();
+
+                for (int i = 0; i < 20; i++)
+                {
+                    var set = TestResources.CreateTestBeatmapSetInfo();
+
+                    if (i == 4)
+                    {
+                        set.Beatmaps.ForEach(b =>
+                        {
+                            b.Metadata.Artist = "ZZZ";
+                            b.Metadata.Title = "AAA";
+                        });
+                    }
+
+                    if (i == 8)
+                    {
+                        set.Beatmaps.ForEach(b =>
+                        {
+                            b.Metadata.Artist = "ZZZ";
+                            b.Metadata.Title = "ZZZ";
+                        });
+                    }
+
+                    sets.Add(set);
+                }
+            });
+
+            loadBeatmaps(sets);
+
+            AddStep("Sort by artist", () => carousel.Filter(new FilterCriteria { Sort = SortMode.Artist }, false));
+            AddAssert("Check last item", () =>
+            {
+                var lastItem = carousel.BeatmapSets.Last();
+                return lastItem.Metadata.Artist == "ZZZ" && lastItem.Metadata.Title == "ZZZ";
+            });
+            AddAssert("Check second last item", () =>
+            {
+                var secondLastItem = carousel.BeatmapSets.SkipLast(1).Last();
+                return secondLastItem.Metadata.Artist == "ZZZ" && secondLastItem.Metadata.Title == "AAA";
+            });
+        }
+
         /// <summary>
         /// Ensures stability is maintained on different sort modes for items with equal properties.
         /// </summary>

From a1880e89c299f55a8907050988b8200e854ed34b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Mar 2024 08:31:59 +0100
Subject: [PATCH 450/930] Use title as tiebreaker when sorting beatmap carousel
 by artist

Closes https://github.com/ppy/osu/issues/27548.

Reference: https://github.com/peppy/osu-stable-reference/blob/e53980dd76857ee899f66ce519ba1597e7874f28/osu!/GameplayElements/Beatmaps/BeatmapTreeManager.cs#L341-L347
---
 osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
index 43c9c621e8..7e15699804 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmapSet.cs
@@ -69,6 +69,8 @@ namespace osu.Game.Screens.Select.Carousel
                 default:
                 case SortMode.Artist:
                     comparison = OrdinalSortByCaseStringComparer.DEFAULT.Compare(BeatmapSet.Metadata.Artist, otherSet.BeatmapSet.Metadata.Artist);
+                    if (comparison == 0)
+                        goto case SortMode.Title;
                     break;
 
                 case SortMode.Title:

From 6fa663c8cac732c6d705955f52565f1f78b7eddd Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Fri, 22 Mar 2024 14:48:22 -0300
Subject: [PATCH 451/930] Make check ruleset specific

---
 ...heckCatchAbnormalDifficultySettingsTest.cs | 158 ++++++++++++++
 .../Edit/CatchBeatmapVerifier.cs              |   3 +-
 .../CheckCatchAbnormalDifficultySettings.cs   |  38 ++++
 ...heckManiaAbnormalDifficultySettingsTest.cs | 121 +++++++++++
 .../CheckManiaAbnormalDifficultySettings.cs   |  32 +++
 .../Edit/ManiaBeatmapVerifier.cs              |   2 +
 .../CheckOsuAbnormalDifficultySettingsTest.cs | 194 ++++++++++++++++++
 .../CheckOsuAbnormalDifficultySettings.cs     |  43 ++++
 .../Edit/OsuBeatmapVerifier.cs                |   3 +
 ...heckTaikoAbnormalDifficultySettingsTest.cs |  84 ++++++++
 .../CheckTaikoAbnormalDifficultySettings.cs   |  26 +++
 .../Edit/TaikoBeatmapVerifier.cs              |  24 +++
 osu.Game.Rulesets.Taiko/TaikoRuleset.cs       |   2 +
 13 files changed, 729 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
 create mode 100644 osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
 create mode 100644 osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
 create mode 100644 osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
 create mode 100644 osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
 create mode 100644 osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
 create mode 100644 osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
 create mode 100644 osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
 create mode 100644 osu.Game.Rulesets.Taiko/Edit/TaikoBeatmapVerifier.cs

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
new file mode 100644
index 0000000000..2ae2e20215
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
@@ -0,0 +1,158 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Catch.Edit.Checks;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Rulesets.Catch.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class CheckCatchAbnormalDifficultySettingsTest
+    {
+        private CheckCatchAbnormalDifficultySettings check = null!;
+
+        private IBeatmap beatmap = new Beatmap<HitObject>();
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckCatchAbnormalDifficultySettings();
+
+            beatmap.BeatmapInfo.Ruleset = new CatchRuleset().RulesetInfo;
+            beatmap.Difficulty = new BeatmapDifficulty()
+            {
+                ApproachRate = 5,
+                CircleSize = 5,
+                DrainRate = 5,
+            };
+        }
+
+        [Test]
+        public void TestNormalSettings()
+        {
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestApproachRateTwoDecimals()
+        {
+            beatmap.Difficulty.ApproachRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestCircleSizeTwoDecimals()
+        {
+            beatmap.Difficulty.CircleSize = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestDrainRateTwoDecimals()
+        {
+            beatmap.Difficulty.DrainRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestApproachRateUnder()
+        {
+            beatmap.Difficulty.ApproachRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestCircleSizeUnder()
+        {
+            beatmap.Difficulty.CircleSize = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateUnder()
+        {
+            beatmap.Difficulty.DrainRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestApproachRateOver()
+        {
+            beatmap.Difficulty.ApproachRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestCircleSizeOver()
+        {
+            beatmap.Difficulty.CircleSize = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateOver()
+        {
+            beatmap.Difficulty.DrainRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
index c7a41a4e22..71da6d5014 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchBeatmapVerifier.cs
@@ -13,7 +13,8 @@ namespace osu.Game.Rulesets.Catch.Edit
     {
         private readonly List<ICheck> checks = new List<ICheck>
         {
-            new CheckBananaShowerGap()
+            new CheckBananaShowerGap(),
+            new CheckCatchAbnormalDifficultySettings(),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
new file mode 100644
index 0000000000..8295795f00
--- /dev/null
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
@@ -0,0 +1,38 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Catch.Edit.Checks
+{
+    public class CheckCatchAbnormalDifficultySettings : CheckAbnormalDifficultySettings
+    {
+        public override CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Checks catch relevant settings");
+
+        public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (HasMoreThanOneDecimalPlace(diff.ApproachRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
+
+            if (OutOfRange(diff.ApproachRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
+
+            if (HasMoreThanOneDecimalPlace(diff.CircleSize))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
+
+            if (OutOfRange(diff.CircleSize))
+                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
+
+            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+
+            if (OutOfRange(diff.DrainRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
new file mode 100644
index 0000000000..6c585aace3
--- /dev/null
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
@@ -0,0 +1,121 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mania.Edit.Checks;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class CheckManiaAbnormalDifficultySettingsTest
+    {
+        private CheckManiaAbnormalDifficultySettings check = null!;
+
+        private IBeatmap beatmap = new Beatmap<HitObject>();
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckManiaAbnormalDifficultySettings();
+
+            beatmap.BeatmapInfo.Ruleset = new ManiaRuleset().RulesetInfo;
+            beatmap.Difficulty = new BeatmapDifficulty()
+            {
+                OverallDifficulty = 5,
+                DrainRate = 5,
+            };
+        }
+
+        [Test]
+        public void TestNormalSettings()
+        {
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestOverallDifficultyTwoDecimals()
+        {
+            beatmap.Difficulty.OverallDifficulty = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestDrainRateTwoDecimals()
+        {
+            beatmap.Difficulty.DrainRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestOverallDifficultyUnder()
+        {
+            beatmap.Difficulty.OverallDifficulty = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateUnder()
+        {
+            beatmap.Difficulty.DrainRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestOverallDifficultyOver()
+        {
+            beatmap.Difficulty.OverallDifficulty = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateOver()
+        {
+            beatmap.Difficulty.DrainRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
new file mode 100644
index 0000000000..ae0cc3aa4c
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
@@ -0,0 +1,32 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Mania.Edit.Checks
+{
+    public class CheckManiaAbnormalDifficultySettings : CheckAbnormalDifficultySettings
+    {
+        public override CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Checks mania relevant settings");
+
+        public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (OutOfRange(diff.OverallDifficulty))
+                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+
+            if (OutOfRange(diff.DrainRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs b/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs
index 778dcfc6e1..4adabfa4d7 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaBeatmapVerifier.cs
@@ -13,7 +13,9 @@ namespace osu.Game.Rulesets.Mania.Edit
     {
         private readonly List<ICheck> checks = new List<ICheck>
         {
+            // Settings
             new CheckKeyCount(),
+            new CheckManiaAbnormalDifficultySettings(),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
new file mode 100644
index 0000000000..53ccd3c7a7
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
@@ -0,0 +1,194 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Rulesets.Osu.Edit.Checks;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Tests.Beatmaps;
+using System.Linq;
+
+namespace osu.Game.Rulesets.Osu.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class CheckOsuAbnormalDifficultySettingsTest
+    {
+        private CheckOsuAbnormalDifficultySettings check = null!;
+
+        private IBeatmap beatmap = new Beatmap<HitObject>();
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckOsuAbnormalDifficultySettings();
+
+            beatmap.Difficulty = new BeatmapDifficulty()
+            {
+                ApproachRate = 5,
+                CircleSize = 5,
+                DrainRate = 5,
+                OverallDifficulty = 5,
+            };
+        }
+
+        [Test]
+        public void TestNormalSettings()
+        {
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestApproachRateTwoDecimals()
+        {
+            beatmap.Difficulty.ApproachRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestCircleSizeTwoDecimals()
+        {
+            beatmap.Difficulty.CircleSize = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestDrainRateTwoDecimals()
+        {
+            beatmap.Difficulty.DrainRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestOverallDifficultyTwoDecimals()
+        {
+            beatmap.Difficulty.OverallDifficulty = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestApproachRateUnder()
+        {
+            beatmap.Difficulty.ApproachRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestCircleSizeUnder()
+        {
+            beatmap.Difficulty.CircleSize = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateUnder()
+        {
+            beatmap.Difficulty.DrainRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestOverallDifficultyUnder()
+        {
+            beatmap.Difficulty.OverallDifficulty = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestApproachRateOver()
+        {
+            beatmap.Difficulty.ApproachRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestCircleSizeOver()
+        {
+            beatmap.Difficulty.CircleSize = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateOver()
+        {
+            beatmap.Difficulty.DrainRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestOverallDifficultyOver()
+        {
+            beatmap.Difficulty.OverallDifficulty = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
new file mode 100644
index 0000000000..c1eca7fff7
--- /dev/null
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
@@ -0,0 +1,43 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Osu.Edit.Checks
+{
+    public class CheckOsuAbnormalDifficultySettings : CheckAbnormalDifficultySettings
+    {
+        public override CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Checks osu relevant settings");
+        public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (HasMoreThanOneDecimalPlace(diff.ApproachRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
+
+            if (OutOfRange(diff.ApproachRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
+
+            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (OutOfRange(diff.OverallDifficulty))
+                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (HasMoreThanOneDecimalPlace(diff.CircleSize))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
+
+            if (OutOfRange(diff.CircleSize))
+                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
+
+            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+
+            if (OutOfRange(diff.DrainRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs b/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs
index 325e9ed4cb..4b01a1fc39 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuBeatmapVerifier.cs
@@ -21,6 +21,9 @@ namespace osu.Game.Rulesets.Osu.Edit
             new CheckTimeDistanceEquality(),
             new CheckLowDiffOverlaps(),
             new CheckTooShortSliders(),
+
+            // Settings
+            new CheckOsuAbnormalDifficultySettings(),
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
new file mode 100644
index 0000000000..f10e62f3bf
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
@@ -0,0 +1,84 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Rulesets.Taiko.Edit.Checks;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Tests.Beatmaps;
+using System.Linq;
+
+namespace osu.Game.Rulesets.Taiko.Tests.Editor.Checks
+{
+    [TestFixture]
+    public class CheckTaikoAbnormalDifficultySettingsTest
+    {
+        private CheckTaikoAbnormalDifficultySettings check = null!;
+
+        private IBeatmap beatmap = new Beatmap<HitObject>();
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckTaikoAbnormalDifficultySettings();
+
+            beatmap.BeatmapInfo.Ruleset = new TaikoRuleset().RulesetInfo;
+            beatmap.Difficulty = new BeatmapDifficulty()
+            {
+                OverallDifficulty = 5,
+            };
+        }
+
+        [Test]
+        public void TestNormalSettings()
+        {
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestOverallDifficultyTwoDecimals()
+        {
+            beatmap.Difficulty.OverallDifficulty = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
+        [Test]
+        public void TestOverallDifficultyUnder()
+        {
+            beatmap.Difficulty.OverallDifficulty = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestOverallDifficultyOver()
+        {
+            beatmap.Difficulty.OverallDifficulty = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        private BeatmapVerifierContext getContext()
+        {
+            return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
new file mode 100644
index 0000000000..ce35f21853
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
@@ -0,0 +1,26 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Taiko.Edit.Checks
+{
+    public class CheckTaikoAbnormalDifficultySettings : CheckAbnormalDifficultySettings
+    {
+        public override CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Checks taiko relevant settings");
+
+        public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var diff = context.Beatmap.Difficulty;
+
+            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (OutOfRange(diff.OverallDifficulty))
+                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/Edit/TaikoBeatmapVerifier.cs b/osu.Game.Rulesets.Taiko/Edit/TaikoBeatmapVerifier.cs
new file mode 100644
index 0000000000..f5c3f1846d
--- /dev/null
+++ b/osu.Game.Rulesets.Taiko/Edit/TaikoBeatmapVerifier.cs
@@ -0,0 +1,24 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.Linq;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Rulesets.Taiko.Edit.Checks;
+
+namespace osu.Game.Rulesets.Taiko.Edit
+{
+    public class TaikoBeatmapVerifier : IBeatmapVerifier
+    {
+        private readonly List<ICheck> checks = new List<ICheck>
+        {
+            new CheckTaikoAbnormalDifficultySettings(),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            return checks.SelectMany(check => check.Run(context));
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
index 24b0ec5d57..d7184bce60 100644
--- a/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoRuleset.cs
@@ -188,6 +188,8 @@ namespace osu.Game.Rulesets.Taiko
 
         public override HitObjectComposer CreateHitObjectComposer() => new TaikoHitObjectComposer(this);
 
+        public override IBeatmapVerifier CreateBeatmapVerifier() => new TaikoBeatmapVerifier();
+
         public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TaikoDifficultyCalculator(RulesetInfo, beatmap);
 
         public override PerformanceCalculator CreatePerformanceCalculator() => new TaikoPerformanceCalculator();

From c7c03302653790668d0fdb49f25dfceb016eaf3e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 22 Mar 2024 19:05:58 +0100
Subject: [PATCH 452/930] Attempt to disable rulesets that can be linked to an
 unhandled crash

---
 osu.Game/OsuGameBase.cs                |  4 ++-
 osu.Game/Rulesets/RealmRulesetStore.cs | 48 ++++++++++++++++++++++++--
 osu.Game/Rulesets/RulesetStore.cs      | 24 +++++++++----
 3 files changed, 65 insertions(+), 11 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 81e3d8bed8..8bda8fb6c2 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -678,12 +678,14 @@ namespace osu.Game
         /// <summary>
         /// Allows a maximum of one unhandled exception, per second of execution.
         /// </summary>
-        private bool onExceptionThrown(Exception _)
+        private bool onExceptionThrown(Exception ex)
         {
             bool continueExecution = Interlocked.Decrement(ref allowableExceptions) >= 0;
 
             Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {allowableExceptions} more allowable exceptions" : "denied")} .");
 
+            RulesetStore.TryDisableCustomRulesetsCausing(ex);
+
             // restore the stock of allowable exceptions after a short delay.
             Task.Delay(1000).ContinueWith(_ => Interlocked.Increment(ref allowableExceptions));
 
diff --git a/osu.Game/Rulesets/RealmRulesetStore.cs b/osu.Game/Rulesets/RealmRulesetStore.cs
index ba6f4583d1..36eae7af2c 100644
--- a/osu.Game/Rulesets/RealmRulesetStore.cs
+++ b/osu.Game/Rulesets/RealmRulesetStore.cs
@@ -3,8 +3,11 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
 using System.Linq;
 using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
@@ -13,17 +16,20 @@ namespace osu.Game.Rulesets
 {
     public class RealmRulesetStore : RulesetStore
     {
+        private readonly RealmAccess realmAccess;
         public override IEnumerable<RulesetInfo> AvailableRulesets => availableRulesets;
 
         private readonly List<RulesetInfo> availableRulesets = new List<RulesetInfo>();
 
-        public RealmRulesetStore(RealmAccess realm, Storage? storage = null)
+        public RealmRulesetStore(RealmAccess realmAccess, Storage? storage = null)
             : base(storage)
         {
-            prepareDetachedRulesets(realm);
+            this.realmAccess = realmAccess;
+            prepareDetachedRulesets();
+            informUserAboutBrokenRulesets();
         }
 
-        private void prepareDetachedRulesets(RealmAccess realmAccess)
+        private void prepareDetachedRulesets()
         {
             realmAccess.Write(realm =>
             {
@@ -143,5 +149,41 @@ namespace osu.Game.Rulesets
 
             instance.CreateBeatmapProcessor(converter.Convert());
         }
+
+        private void informUserAboutBrokenRulesets()
+        {
+            if (RulesetStorage == null)
+                return;
+
+            foreach (string brokenRulesetDll in RulesetStorage.GetFiles(@".", @"*.dll.broken"))
+            {
+                Logger.Log($"Ruleset '{Path.GetFileNameWithoutExtension(brokenRulesetDll)}' has been disabled due to causing a crash.\n\n"
+                           + "Please update the ruleset or report the issue to the developers of the ruleset if no updates are available.", level: LogLevel.Important);
+            }
+        }
+
+        internal void TryDisableCustomRulesetsCausing(Exception exception)
+        {
+            var stackTrace = new StackTrace(exception);
+
+            foreach (var frame in stackTrace.GetFrames())
+            {
+                var declaringAssembly = frame.GetMethod()?.DeclaringType?.Assembly;
+                if (declaringAssembly == null)
+                    continue;
+
+                if (UserRulesetAssemblies.Contains(declaringAssembly))
+                {
+                    string sourceLocation = declaringAssembly.Location;
+                    string destinationLocation = Path.ChangeExtension(sourceLocation, @".dll.broken");
+
+                    if (File.Exists(sourceLocation))
+                    {
+                        Logger.Log($"Unhandled exception traced back to custom ruleset {Path.GetFileNameWithoutExtension(sourceLocation)}. Marking as broken.");
+                        File.Move(sourceLocation, destinationLocation);
+                    }
+                }
+            }
+        }
     }
 }
diff --git a/osu.Game/Rulesets/RulesetStore.cs b/osu.Game/Rulesets/RulesetStore.cs
index ac36ee6494..f33d42a53e 100644
--- a/osu.Game/Rulesets/RulesetStore.cs
+++ b/osu.Game/Rulesets/RulesetStore.cs
@@ -18,6 +18,8 @@ namespace osu.Game.Rulesets
         private const string ruleset_library_prefix = @"osu.Game.Rulesets";
 
         protected readonly Dictionary<Assembly, Type> LoadedAssemblies = new Dictionary<Assembly, Type>();
+        protected readonly HashSet<Assembly> UserRulesetAssemblies = new HashSet<Assembly>();
+        protected readonly Storage? RulesetStorage;
 
         /// <summary>
         /// All available rulesets.
@@ -41,9 +43,9 @@ namespace osu.Game.Rulesets
             // to load as unable to locate the game core assembly.
             AppDomain.CurrentDomain.AssemblyResolve += resolveRulesetDependencyAssembly;
 
-            var rulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
-            if (rulesetStorage != null)
-                loadUserRulesets(rulesetStorage);
+            RulesetStorage = storage?.GetStorageForDirectory(@"rulesets");
+            if (RulesetStorage != null)
+                loadUserRulesets(RulesetStorage);
         }
 
         /// <summary>
@@ -105,7 +107,11 @@ namespace osu.Game.Rulesets
             var rulesets = rulesetStorage.GetFiles(@".", @$"{ruleset_library_prefix}.*.dll");
 
             foreach (string? ruleset in rulesets.Where(f => !f.Contains(@"Tests")))
-                loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
+            {
+                var assembly = loadRulesetFromFile(rulesetStorage.GetFullPath(ruleset));
+                if (assembly != null)
+                    UserRulesetAssemblies.Add(assembly);
+            }
         }
 
         private void loadFromDisk()
@@ -126,21 +132,25 @@ namespace osu.Game.Rulesets
             }
         }
 
-        private void loadRulesetFromFile(string file)
+        private Assembly? loadRulesetFromFile(string file)
         {
             string filename = Path.GetFileNameWithoutExtension(file);
 
             if (LoadedAssemblies.Values.Any(t => Path.GetFileNameWithoutExtension(t.Assembly.Location) == filename))
-                return;
+                return null;
 
             try
             {
-                addRuleset(Assembly.LoadFrom(file));
+                var assembly = Assembly.LoadFrom(file);
+                addRuleset(assembly);
+                return assembly;
             }
             catch (Exception e)
             {
                 LogFailedLoad(filename, e);
             }
+
+            return null;
         }
 
         private void addRuleset(Assembly assembly)

From 6fbe1a5b8d1a80c6a5b1e277ee015162b7ea8083 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 23 Mar 2024 19:22:47 -0300
Subject: [PATCH 453/930] Add video resolution check

---
 .../Checks/CheckVideoResolutionTest.cs        |  86 +++++++++++++
 .../Videos/test-video-resolution-high.mp4     | Bin 0 -> 13655 bytes
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |   1 +
 .../Edit/Checks/CheckVideoResolution.cs       | 117 ++++++++++++++++++
 4 files changed, 204 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
 create mode 100644 osu.Game.Tests/Resources/Videos/test-video-resolution-high.mp4
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs b/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
new file mode 100644
index 0000000000..ab677a15d4
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
@@ -0,0 +1,86 @@
+using System.IO;
+using System.Linq;
+using Moq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Storyboards;
+using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Resources;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckVideoResolutionTest
+    {
+        private CheckVideoResolution check = null!;
+
+        private IBeatmap beatmap = null!;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckVideoResolution();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files =
+                        {
+                            CheckTestHelpers.CreateMockFile("mp4"),
+                        }
+                    }
+                }
+            };
+        }
+
+        [Test]
+        public void TestNoVideo()
+        {
+            beatmap.BeatmapInfo.BeatmapSet?.Files.Clear();
+
+            var issues = check.Run(getContext(null)).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(0));
+        }
+
+        [Test]
+        public void TestVideoAcceptableResolution()
+        {
+            using (var resourceStream = TestResources.OpenResource("Videos/test-video.mp4"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
+        [Test]
+        public void TestVideoHighResolution()
+        {
+            using (var resourceStream = TestResources.OpenResource("Videos/test-video-resolution-high.mp4"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckVideoResolution.IssueTemplateHighResolution);
+            }
+        }
+
+        private BeatmapVerifierContext getContext(Stream? resourceStream)
+        {
+            var storyboard = new Storyboard();
+            var layer = storyboard.GetLayer("Video");
+            layer.Add(new StoryboardVideo("abc123.mp4", 0));
+
+            var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
+            mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(resourceStream);
+            mockWorkingBeatmap.As<IWorkingBeatmap>().SetupGet(w => w.Storyboard).Returns(storyboard);
+
+            return new BeatmapVerifierContext(beatmap, mockWorkingBeatmap.Object);
+        }
+    }
+}
diff --git a/osu.Game.Tests/Resources/Videos/test-video-resolution-high.mp4 b/osu.Game.Tests/Resources/Videos/test-video-resolution-high.mp4
new file mode 100644
index 0000000000000000000000000000000000000000..fbdb00d3ad464a7f2d9d223d5fa9edb67fdaa689
GIT binary patch
literal 13655
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

literal 0
HcmV?d00001

diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 4a316afd22..95f79391ef 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -18,6 +18,7 @@ namespace osu.Game.Rulesets.Edit
             // Resources
             new CheckBackgroundPresence(),
             new CheckBackgroundQuality(),
+            new CheckVideoResolution(),
 
             // Audio
             new CheckAudioPresence(),
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs b/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs
new file mode 100644
index 0000000000..831962e2e9
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs
@@ -0,0 +1,117 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using osu.Framework.Logging;
+using osu.Game.Beatmaps;
+using osu.Game.IO.FileAbstraction;
+using osu.Game.Rulesets.Edit.Checks.Components;
+using osu.Game.Storyboards;
+using TagLib;
+using File = TagLib.File;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckVideoResolution : ICheck
+    {
+        private const int max_video_width = 1280;
+
+        private const int max_video_height = 720;
+
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Resources, "Too high video resolution.");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateHighResolution(this),
+            new IssueTemplateFileError(this),
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+            var videoPaths = getVideoPaths(context.WorkingBeatmap.Storyboard);
+
+            foreach (string filename in videoPaths)
+            {
+                string? storagePath = beatmapSet?.GetPathForFile(filename);
+
+                // Don't report any issues for missing video here since another check is already doing that (CheckAudioInVideo)
+                if (storagePath == null) continue;
+
+                Issue issue;
+
+                try
+                {
+                    using (Stream data = context.WorkingBeatmap.GetStream(storagePath))
+                    using (File tagFile = File.Create(new StreamFileAbstraction(filename, data)))
+                    {
+                        int height = tagFile.Properties.VideoHeight;
+                        int width = tagFile.Properties.VideoWidth;
+
+                        if (height <= max_video_height || width <= max_video_width)
+                            continue;
+
+                        issue = new IssueTemplateHighResolution(this).Create(filename, width, height);
+                    }
+                }
+                catch (CorruptFileException)
+                {
+                    issue = new IssueTemplateFileError(this).Create(filename, "Corrupt file");
+                }
+                catch (UnsupportedFormatException)
+                {
+                    issue = new IssueTemplateFileError(this).Create(filename, "Unsupported format");
+                }
+                catch (Exception ex)
+                {
+                    issue = new IssueTemplateFileError(this).Create(filename, "Internal failure - see logs for more info");
+                    Logger.Log($"Failed when running {nameof(CheckVideoResolution)}: {ex}");
+                }
+
+                yield return issue;
+            }
+        }
+
+        private List<string> getVideoPaths(Storyboard storyboard)
+        {
+            var videoPaths = new List<string>();
+
+            foreach (var layer in storyboard.Layers)
+            {
+                foreach (var element in layer.Elements)
+                {
+                    if (element is not StoryboardVideo video)
+                        continue;
+
+                    if (!videoPaths.Contains(video.Path))
+                        videoPaths.Add(video.Path);
+                }
+            }
+
+            return videoPaths;
+        }
+
+        public class IssueTemplateHighResolution : IssueTemplate
+        {
+            public IssueTemplateHighResolution(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" resolution exceeds 1280x720 ({1}x{2})")
+            {
+            }
+
+            public Issue Create(string filename, int width, int height) => new Issue(this, filename, width, height);
+        }
+
+        public class IssueTemplateFileError : IssueTemplate
+        {
+            public IssueTemplateFileError(ICheck check)
+                : base(check, IssueType.Error, "Could not check resolution for \"{0}\" ({1}).")
+            {
+            }
+
+            public Issue Create(string filename, string errorReason) => new Issue(this, filename, errorReason);
+        }
+
+    }
+}

From eb938272040be14caa292fe65800356a6ae03a1a Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 23 Mar 2024 23:11:13 -0300
Subject: [PATCH 454/930] Add missing copyright header

---
 osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs b/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
index ab677a15d4..1e16c67aab 100644
--- a/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckVideoResolutionTest.cs
@@ -1,3 +1,6 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
 using System.IO;
 using System.Linq;
 using Moq;

From 8a05fecad5862d744d49b8febcb389e4e22b9850 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 23 Mar 2024 23:28:55 -0300
Subject: [PATCH 455/930] Fix formatting issue

---
 osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs b/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs
index 831962e2e9..1b603b7e47 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckVideoResolution.cs
@@ -112,6 +112,5 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             public Issue Create(string filename, string errorReason) => new Issue(this, filename, errorReason);
         }
-
     }
 }

From ef2a16dd8ff260efa5117a10352e6ec771dfa2c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Mar 2024 16:41:40 +0800
Subject: [PATCH 456/930] Various renaming and class updates to allow multiple
 menu banners

---
 .../Visual/Menus/TestSceneMainMenu.cs         | 46 +++++++++-----
 ...tleRequest.cs => GetMenuContentRequest.cs} |  4 +-
 .../API/Requests/Responses/APIMenuContent.cs  | 42 +++++++++++++
 .../API/Requests/Responses/APIMenuImage.cs    | 57 +++++++++++++++++
 .../API/Requests/Responses/APISystemTitle.cs  | 30 ---------
 osu.Game/Screens/Menu/MainMenu.cs             |  8 +--
 .../{SystemTitle.cs => OnlineMenuBanner.cs}   | 62 ++++++++++---------
 7 files changed, 169 insertions(+), 80 deletions(-)
 rename osu.Game/Online/API/Requests/{GetSystemTitleRequest.cs => GetMenuContentRequest.cs} (74%)
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
 create mode 100644 osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
 delete mode 100644 osu.Game/Online/API/Requests/Responses/APISystemTitle.cs
 rename osu.Game/Screens/Menu/{SystemTitle.cs => OnlineMenuBanner.cs} (79%)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs b/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
index 7053a9d544..3c78edb8a5 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
@@ -13,30 +13,48 @@ namespace osu.Game.Tests.Visual.Menus
 {
     public partial class TestSceneMainMenu : OsuGameTestScene
     {
-        private SystemTitle systemTitle => Game.ChildrenOfType<SystemTitle>().Single();
+        private OnlineMenuBanner onlineMenuBanner => Game.ChildrenOfType<OnlineMenuBanner>().Single();
 
         [Test]
-        public void TestSystemTitle()
+        public void TestOnlineMenuBanner()
         {
-            AddStep("set system title", () => systemTitle.Current.Value = new APISystemTitle
+            AddStep("set online content", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
-                Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
-                Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
+                        Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                    }
+                }
             });
-            AddAssert("system title not visible", () => systemTitle.State.Value, () => Is.EqualTo(Visibility.Hidden));
+            AddAssert("system title not visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Hidden));
             AddStep("enter menu", () => InputManager.Key(Key.Enter));
-            AddUntilStep("system title visible", () => systemTitle.State.Value, () => Is.EqualTo(Visibility.Visible));
-            AddStep("set another title", () => systemTitle.Current.Value = new APISystemTitle
+            AddUntilStep("system title visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddStep("set another title", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
-                Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
-                Url = @"https://osu.ppy.sh/community/contests/189",
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                }
             });
-            AddStep("set title with nonexistent image", () => systemTitle.Current.Value = new APISystemTitle
+            AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
-                Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
-                Url = @"https://osu.ppy.sh/community/contests/189",
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                }
             });
-            AddStep("unset system title", () => systemTitle.Current.Value = null);
+            AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
         }
     }
 }
diff --git a/osu.Game/Online/API/Requests/GetSystemTitleRequest.cs b/osu.Game/Online/API/Requests/GetMenuContentRequest.cs
similarity index 74%
rename from osu.Game/Online/API/Requests/GetSystemTitleRequest.cs
rename to osu.Game/Online/API/Requests/GetMenuContentRequest.cs
index 52ca0c11eb..ad2bac6696 100644
--- a/osu.Game/Online/API/Requests/GetSystemTitleRequest.cs
+++ b/osu.Game/Online/API/Requests/GetMenuContentRequest.cs
@@ -5,9 +5,9 @@ using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Online.API.Requests
 {
-    public class GetSystemTitleRequest : OsuJsonWebRequest<APISystemTitle>
+    public class GetMenuContentRequest : OsuJsonWebRequest<APIMenuContent>
     {
-        public GetSystemTitleRequest()
+        public GetMenuContentRequest()
             : base(@"https://assets.ppy.sh/lazer-status.json")
         {
         }
diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
new file mode 100644
index 0000000000..acee6c99ba
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
@@ -0,0 +1,42 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIMenuContent : IEquatable<APIMenuContent>
+    {
+        /// <summary>
+        /// Images which should be displayed in rotation.
+        /// </summary>
+        [JsonProperty(@"images")]
+        public APIMenuImage[] Images { get; init; } = Array.Empty<APIMenuImage>();
+
+        public DateTimeOffset LastUpdated { get; init; }
+
+        public bool Equals(APIMenuContent? other)
+        {
+            if (ReferenceEquals(null, other)) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return LastUpdated.Equals(other.LastUpdated);
+        }
+
+        public override bool Equals(object? obj)
+        {
+            if (ReferenceEquals(null, obj)) return false;
+            if (ReferenceEquals(this, obj)) return true;
+
+            if (obj.GetType() != GetType()) return false;
+
+            return Equals((APIMenuContent)obj);
+        }
+
+        public override int GetHashCode()
+        {
+            return LastUpdated.GetHashCode();
+        }
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
new file mode 100644
index 0000000000..4824e23d4b
--- /dev/null
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
@@ -0,0 +1,57 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using Newtonsoft.Json;
+
+namespace osu.Game.Online.API.Requests.Responses
+{
+    public class APIMenuImage : IEquatable<APIMenuImage>
+    {
+        /// <summary>
+        /// A URL pointing to the image which should be displayed. Generally should be an @2x image filename.
+        /// </summary>
+        [JsonProperty(@"image")]
+        public string Image { get; init; } = string.Empty;
+
+        /// <summary>
+        /// A URL that should be opened on clicking the image.
+        /// </summary>
+        [JsonProperty(@"url")]
+        public string Url { get; init; } = string.Empty;
+
+        /// <summary>
+        /// The time at which this item should begin displaying. If <c>null</c>, will display immediately.
+        /// </summary>
+        [JsonProperty(@"begins")]
+        public DateTimeOffset? Begins { get; set; }
+
+        /// <summary>
+        /// The time at which this item should stop displaying. If <c>null</c>, will display indefinitely.
+        /// </summary>
+        [JsonProperty(@"expires")]
+        public DateTimeOffset? Expires { get; set; }
+
+        public bool Equals(APIMenuImage? other)
+        {
+            if (ReferenceEquals(null, other)) return false;
+            if (ReferenceEquals(this, other)) return true;
+
+            return Image == other.Image && Url == other.Url;
+        }
+
+        public override bool Equals(object? obj)
+        {
+            if (ReferenceEquals(null, obj)) return false;
+            if (ReferenceEquals(this, obj)) return true;
+            if (obj.GetType() != GetType()) return false;
+
+            return Equals((APIMenuImage)obj);
+        }
+
+        public override int GetHashCode()
+        {
+            return HashCode.Combine(Image, Url);
+        }
+    }
+}
diff --git a/osu.Game/Online/API/Requests/Responses/APISystemTitle.cs b/osu.Game/Online/API/Requests/Responses/APISystemTitle.cs
deleted file mode 100644
index bfa5c1043b..0000000000
--- a/osu.Game/Online/API/Requests/Responses/APISystemTitle.cs
+++ /dev/null
@@ -1,30 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-using Newtonsoft.Json;
-
-namespace osu.Game.Online.API.Requests.Responses
-{
-    public class APISystemTitle : IEquatable<APISystemTitle>
-    {
-        [JsonProperty(@"image")]
-        public string Image { get; set; } = string.Empty;
-
-        [JsonProperty(@"url")]
-        public string Url { get; set; } = string.Empty;
-
-        public bool Equals(APISystemTitle? other)
-        {
-            if (ReferenceEquals(null, other)) return false;
-            if (ReferenceEquals(this, other)) return true;
-
-            return Image == other.Image && Url == other.Url;
-        }
-
-        public override bool Equals(object? obj) => obj is APISystemTitle other && Equals(other);
-
-        // ReSharper disable NonReadonlyMemberInGetHashCode
-        public override int GetHashCode() => HashCode.Combine(Image, Url);
-    }
-}
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index decb901c32..235c5d5c56 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -98,7 +98,7 @@ namespace osu.Game.Screens.Menu
         private ParallaxContainer buttonsContainer;
         private SongTicker songTicker;
         private Container logoTarget;
-        private SystemTitle systemTitle;
+        private OnlineMenuBanner onlineMenuBanner;
         private MenuTip menuTip;
         private FillFlowContainer bottomElementsFlow;
         private SupporterDisplay supporterDisplay;
@@ -178,7 +178,7 @@ namespace osu.Game.Screens.Menu
                             Anchor = Anchor.TopCentre,
                             Origin = Anchor.TopCentre,
                         },
-                        systemTitle = new SystemTitle
+                        onlineMenuBanner = new OnlineMenuBanner
                         {
                             Anchor = Anchor.TopCentre,
                             Origin = Anchor.TopCentre,
@@ -201,12 +201,12 @@ namespace osu.Game.Screens.Menu
                     case ButtonSystemState.Initial:
                     case ButtonSystemState.Exit:
                         ApplyToBackground(b => b.FadeColour(Color4.White, 500, Easing.OutSine));
-                        systemTitle.State.Value = Visibility.Hidden;
+                        onlineMenuBanner.State.Value = Visibility.Hidden;
                         break;
 
                     default:
                         ApplyToBackground(b => b.FadeColour(OsuColour.Gray(0.8f), 500, Easing.OutSine));
-                        systemTitle.State.Value = Visibility.Visible;
+                        onlineMenuBanner.State.Value = Visibility.Visible;
                         break;
                 }
             };
diff --git a/osu.Game/Screens/Menu/SystemTitle.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
similarity index 79%
rename from osu.Game/Screens/Menu/SystemTitle.cs
rename to osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 813a470ed6..cf20196f85 100644
--- a/osu.Game/Screens/Menu/SystemTitle.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
@@ -18,42 +19,28 @@ using osu.Game.Online.API.Requests.Responses;
 
 namespace osu.Game.Screens.Menu
 {
-    public partial class SystemTitle : VisibilityContainer
+    public partial class OnlineMenuBanner : VisibilityContainer
     {
-        internal Bindable<APISystemTitle?> Current { get; } = new Bindable<APISystemTitle?>();
+        internal Bindable<APIMenuContent> Current { get; } = new Bindable<APIMenuContent>(new APIMenuContent());
 
         private const float transition_duration = 500;
 
         private Container content = null!;
         private CancellationTokenSource? cancellationTokenSource;
-        private SystemTitleImage? currentImage;
-
-        private ScheduledDelegate? openUrlAction;
+        private MenuImage? currentImage;
 
         [BackgroundDependencyLoader]
-        private void load(OsuGame? game)
+        private void load()
         {
             AutoSizeAxes = Axes.Both;
             AutoSizeDuration = transition_duration;
             AutoSizeEasing = Easing.OutQuint;
 
-            InternalChild = content = new OsuClickableContainer
+            InternalChild = content = new Container
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
                 AutoSizeAxes = Axes.Both,
-                Action = () =>
-                {
-                    currentImage?.Flash();
-
-                    // Delay slightly to allow animation to play out.
-                    openUrlAction?.Cancel();
-                    openUrlAction = Scheduler.AddDelayed(() =>
-                    {
-                        if (!string.IsNullOrEmpty(Current.Value?.Url))
-                            game?.HandleLink(Current.Value.Url);
-                    }, 250);
-                }
             };
         }
 
@@ -98,7 +85,7 @@ namespace osu.Game.Screens.Menu
 
         private void checkForUpdates()
         {
-            var request = new GetSystemTitleRequest();
+            var request = new GetMenuContentRequest();
             Task.Run(() => request.Perform())
                 .ContinueWith(r =>
                 {
@@ -121,12 +108,12 @@ namespace osu.Game.Screens.Menu
             cancellationTokenSource = null;
             currentImage?.FadeOut(500, Easing.OutQuint).Expire();
 
-            if (string.IsNullOrEmpty(Current.Value?.Image))
+            if (Current.Value.Images.Length == 0)
                 return;
 
-            LoadComponentAsync(new SystemTitleImage(Current.Value), loaded =>
+            LoadComponentAsync(new MenuImage(Current.Value.Images.First()), loaded =>
             {
-                if (!loaded.SystemTitle.Equals(Current.Value))
+                if (!loaded.Image.Equals(Current.Value.Images.First()))
                     loaded.Dispose();
 
                 content.Add(currentImage = loaded);
@@ -134,22 +121,24 @@ namespace osu.Game.Screens.Menu
         }
 
         [LongRunningLoad]
-        private partial class SystemTitleImage : CompositeDrawable
+        private partial class MenuImage : OsuClickableContainer
         {
-            public readonly APISystemTitle SystemTitle;
+            public readonly APIMenuImage Image;
 
             private Sprite flash = null!;
 
-            public SystemTitleImage(APISystemTitle systemTitle)
+            private ScheduledDelegate? openUrlAction;
+
+            public MenuImage(APIMenuImage image)
             {
-                SystemTitle = systemTitle;
+                Image = image;
             }
 
             [BackgroundDependencyLoader]
-            private void load(LargeTextureStore textureStore)
+            private void load(LargeTextureStore textureStore, OsuGame game)
             {
-                Texture? texture = textureStore.Get(SystemTitle.Image);
-                if (texture != null && SystemTitle.Image.Contains(@"@2x"))
+                Texture? texture = textureStore.Get(Image.Image);
+                if (texture != null && Image.Image.Contains(@"@2x"))
                     texture.ScaleAdjust *= 2;
 
                 AutoSizeAxes = Axes.Both;
@@ -163,6 +152,19 @@ namespace osu.Game.Screens.Menu
                         Blending = BlendingParameters.Additive,
                     },
                 };
+
+                Action = () =>
+                {
+                    Flash();
+
+                    // Delay slightly to allow animation to play out.
+                    openUrlAction?.Cancel();
+                    openUrlAction = Scheduler.AddDelayed(() =>
+                    {
+                        if (!string.IsNullOrEmpty(Image.Url))
+                            game?.HandleLink(Image.Url);
+                    }, 250);
+                };
             }
 
             protected override void LoadComplete()

From 4c82e44291fdf23bf324d1d8f4a3092ede9437da Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Mar 2024 20:07:17 +0800
Subject: [PATCH 457/930] Add isolated test coverage of online menu banner

---
 .../Visual/Menus/TestSceneMainMenu.cs         | 23 ------
 .../Visual/Menus/TestSceneOnlineMenuBanner.cs | 71 +++++++++++++++++++
 2 files changed, 71 insertions(+), 23 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs b/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
index 3c78edb8a5..e2a841d79a 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneMainMenu.cs
@@ -32,29 +32,6 @@ namespace osu.Game.Tests.Visual.Menus
             AddAssert("system title not visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Hidden));
             AddStep("enter menu", () => InputManager.Key(Key.Enter));
             AddUntilStep("system title visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Visible));
-            AddStep("set another title", () => onlineMenuBanner.Current.Value = new APIMenuContent
-            {
-                Images = new[]
-                {
-                    new APIMenuImage
-                    {
-                        Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
-                        Url = @"https://osu.ppy.sh/community/contests/189",
-                    }
-                }
-            });
-            AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
-            {
-                Images = new[]
-                {
-                    new APIMenuImage
-                    {
-                        Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
-                        Url = @"https://osu.ppy.sh/community/contests/189",
-                    }
-                }
-            });
-            AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
         }
     }
 }
diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
new file mode 100644
index 0000000000..a80212e0a1
--- /dev/null
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -0,0 +1,71 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Screens.Menu;
+
+namespace osu.Game.Tests.Visual.Menus
+{
+    public partial class TestSceneOnlineMenuBanner : OsuTestScene
+    {
+        private OnlineMenuBanner onlineMenuBanner = null!;
+
+        [SetUpSteps]
+        public void SetUpSteps()
+        {
+            AddStep("Create banner", () =>
+            {
+                Child = onlineMenuBanner = new OnlineMenuBanner
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    State = { Value = Visibility.Visible }
+                };
+            });
+        }
+
+        [Test]
+        public void TestBasic()
+        {
+            AddAssert("system title not visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Hidden));
+            AddStep("set online content", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
+                        Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                    }
+                },
+            });
+            AddStep("set another title", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                }
+            });
+            AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                }
+            });
+            AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
+        }
+    }
+}

From ec4a9a5fdd4ffa1df41b2e26227d27d1277ae8d2 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 23 Mar 2024 23:07:31 +0800
Subject: [PATCH 458/930] Make work again for simple case

---
 .../API/Requests/Responses/APIMenuContent.cs  | 12 ++++++---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs     | 25 +++++++------------
 2 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
index acee6c99ba..7b53488030 100644
--- a/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Linq;
 using Newtonsoft.Json;
 
 namespace osu.Game.Online.API.Requests.Responses
@@ -14,14 +15,12 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"images")]
         public APIMenuImage[] Images { get; init; } = Array.Empty<APIMenuImage>();
 
-        public DateTimeOffset LastUpdated { get; init; }
-
         public bool Equals(APIMenuContent? other)
         {
             if (ReferenceEquals(null, other)) return false;
             if (ReferenceEquals(this, other)) return true;
 
-            return LastUpdated.Equals(other.LastUpdated);
+            return Images.SequenceEqual(other.Images);
         }
 
         public override bool Equals(object? obj)
@@ -36,7 +35,12 @@ namespace osu.Game.Online.API.Requests.Responses
 
         public override int GetHashCode()
         {
-            return LastUpdated.GetHashCode();
+            var hash = new HashCode();
+
+            foreach (var image in Images)
+                hash.Add(image.GetHashCode());
+
+            return hash.ToHashCode();
         }
     }
 }
diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index cf20196f85..613a6eed4c 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Screens.Menu
         {
             base.LoadComplete();
 
-            Current.BindValueChanged(_ => loadNewImage(), true);
+            Current.BindValueChanged(_ => loadNewImages(), true);
 
             checkForUpdates();
         }
@@ -102,7 +102,7 @@ namespace osu.Game.Screens.Menu
                 });
         }
 
-        private void loadNewImage()
+        private void loadNewImages()
         {
             cancellationTokenSource?.Cancel();
             cancellationTokenSource = null;
@@ -131,19 +131,19 @@ namespace osu.Game.Screens.Menu
 
             public MenuImage(APIMenuImage image)
             {
+                AutoSizeAxes = Axes.Both;
+
                 Image = image;
             }
 
             [BackgroundDependencyLoader]
-            private void load(LargeTextureStore textureStore, OsuGame game)
+            private void load(LargeTextureStore textureStore, OsuGame? game)
             {
                 Texture? texture = textureStore.Get(Image.Image);
                 if (texture != null && Image.Image.Contains(@"@2x"))
                     texture.ScaleAdjust *= 2;
 
-                AutoSizeAxes = Axes.Both;
-
-                InternalChildren = new Drawable[]
+                Children = new Drawable[]
                 {
                     new Sprite { Texture = texture },
                     flash = new Sprite
@@ -155,7 +155,9 @@ namespace osu.Game.Screens.Menu
 
                 Action = () =>
                 {
-                    Flash();
+                    flash.FadeInFromZero(50)
+                         .Then()
+                         .FadeOut(500, Easing.OutQuint);
 
                     // Delay slightly to allow animation to play out.
                     openUrlAction?.Cancel();
@@ -174,15 +176,6 @@ namespace osu.Game.Screens.Menu
                 this.FadeInFromZero(500, Easing.OutQuint);
                 flash.FadeOutFromOne(4000, Easing.OutQuint);
             }
-
-            public Drawable Flash()
-            {
-                flash.FadeInFromZero(50)
-                     .Then()
-                     .FadeOut(500, Easing.OutQuint);
-
-                return this;
-            }
         }
     }
 }

From a4c619ea97c190a9a4929d89268677af7b72a985 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Mar 2024 15:14:56 +0800
Subject: [PATCH 459/930] Add basic support for loading multiple images

---
 .../Visual/Menus/TestSceneOnlineMenuBanner.cs | 21 ++++-
 osu.Game/Screens/Menu/OnlineMenuBanner.cs     | 80 ++++++++++---------
 2 files changed, 64 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index a80212e0a1..4cc379a18b 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -31,7 +31,6 @@ namespace osu.Game.Tests.Visual.Menus
         [Test]
         public void TestBasic()
         {
-            AddAssert("system title not visible", () => onlineMenuBanner.State.Value, () => Is.EqualTo(Visibility.Hidden));
             AddStep("set online content", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
                 Images = new[]
@@ -43,6 +42,7 @@ namespace osu.Game.Tests.Visual.Menus
                     }
                 },
             });
+
             AddStep("set another title", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
                 Images = new[]
@@ -54,6 +54,24 @@ namespace osu.Game.Tests.Visual.Menus
                     }
                 }
             });
+
+            AddStep("set multiple images", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
+                        Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                    },
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                },
+            });
+
             AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
                 Images = new[]
@@ -65,6 +83,7 @@ namespace osu.Game.Tests.Visual.Menus
                     }
                 }
             });
+
             AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
         }
     }
diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 613a6eed4c..587a93fb67 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -27,7 +27,6 @@ namespace osu.Game.Screens.Menu
 
         private Container content = null!;
         private CancellationTokenSource? cancellationTokenSource;
-        private MenuImage? currentImage;
 
         [BackgroundDependencyLoader]
         private void load()
@@ -48,32 +47,6 @@ namespace osu.Game.Screens.Menu
 
         protected override void PopOut() => content.FadeOut(transition_duration, Easing.OutQuint);
 
-        protected override bool OnHover(HoverEvent e)
-        {
-            content.ScaleTo(1.05f, 2000, Easing.OutQuint);
-            return base.OnHover(e);
-        }
-
-        protected override void OnHoverLost(HoverLostEvent e)
-        {
-            content.ScaleTo(1f, 500, Easing.OutQuint);
-            base.OnHoverLost(e);
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            content.ScaleTo(0.95f, 500, Easing.OutQuint);
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            content
-                .ScaleTo(0.95f)
-                .ScaleTo(1, 500, Easing.OutElastic);
-            base.OnMouseUp(e);
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -106,17 +79,26 @@ namespace osu.Game.Screens.Menu
         {
             cancellationTokenSource?.Cancel();
             cancellationTokenSource = null;
-            currentImage?.FadeOut(500, Easing.OutQuint).Expire();
 
-            if (Current.Value.Images.Length == 0)
+            var newContent = Current.Value;
+
+            foreach (var i in content)
+            {
+                i.FadeOutFromOne(100, Easing.OutQuint)
+                 .Expire();
+            }
+
+            if (newContent.Images.Length == 0)
                 return;
 
-            LoadComponentAsync(new MenuImage(Current.Value.Images.First()), loaded =>
+            LoadComponentsAsync(newContent.Images.Select(i => new MenuImage(i)), loaded =>
             {
-                if (!loaded.Image.Equals(Current.Value.Images.First()))
-                    loaded.Dispose();
+                if (!newContent.Equals(Current.Value))
+                    return;
 
-                content.Add(currentImage = loaded);
+                content.AddRange(loaded);
+
+                loaded.First().Show();
             }, (cancellationTokenSource ??= new CancellationTokenSource()).Token);
         }
 
@@ -132,6 +114,8 @@ namespace osu.Game.Screens.Menu
             public MenuImage(APIMenuImage image)
             {
                 AutoSizeAxes = Axes.Both;
+                Anchor = Anchor.BottomCentre;
+                Origin = Anchor.BottomCentre;
 
                 Image = image;
             }
@@ -169,13 +153,37 @@ namespace osu.Game.Screens.Menu
                 };
             }
 
-            protected override void LoadComplete()
+            public override void Show()
             {
-                base.LoadComplete();
-
                 this.FadeInFromZero(500, Easing.OutQuint);
                 flash.FadeOutFromOne(4000, Easing.OutQuint);
             }
+
+            protected override bool OnHover(HoverEvent e)
+            {
+                this.ScaleTo(1.05f, 2000, Easing.OutQuint);
+                return true;
+            }
+
+            protected override void OnHoverLost(HoverLostEvent e)
+            {
+                this.ScaleTo(1f, 500, Easing.OutQuint);
+                base.OnHoverLost(e);
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                this.ScaleTo(0.95f, 500, Easing.OutQuint);
+                return true;
+            }
+
+            protected override void OnMouseUp(MouseUpEvent e)
+            {
+                this
+                    .ScaleTo(0.95f)
+                    .ScaleTo(1, 500, Easing.OutElastic);
+                base.OnMouseUp(e);
+            }
         }
     }
 }

From d0b164b44f6d986f965c469cd838bfacbe0a3de6 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 24 Mar 2024 23:37:30 +0800
Subject: [PATCH 460/930] Add automatic rotation support

---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs | 38 +++++++++++++++++++----
 1 file changed, 32 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 587a93fb67..a4648265ae 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -28,6 +28,10 @@ namespace osu.Game.Screens.Menu
         private Container content = null!;
         private CancellationTokenSource? cancellationTokenSource;
 
+        private int displayIndex = -1;
+
+        private ScheduledDelegate? nextDisplay;
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -77,16 +81,16 @@ namespace osu.Game.Screens.Menu
 
         private void loadNewImages()
         {
+            nextDisplay?.Cancel();
+
             cancellationTokenSource?.Cancel();
             cancellationTokenSource = null;
 
             var newContent = Current.Value;
 
-            foreach (var i in content)
-            {
-                i.FadeOutFromOne(100, Easing.OutQuint)
-                 .Expire();
-            }
+            // A better fade out would be nice, but the menu content changes *very* rarely
+            // so let's keep things simple for now.
+            content.Clear(true);
 
             if (newContent.Images.Length == 0)
                 return;
@@ -96,12 +100,34 @@ namespace osu.Game.Screens.Menu
                 if (!newContent.Equals(Current.Value))
                     return;
 
+                // start hidden
+                foreach (var image in loaded)
+                    image.Hide();
+
                 content.AddRange(loaded);
 
-                loaded.First().Show();
+                displayIndex = -1;
+                showNext();
             }, (cancellationTokenSource ??= new CancellationTokenSource()).Token);
         }
 
+        private void showNext()
+        {
+            nextDisplay?.Cancel();
+
+            bool previousShowing = displayIndex >= 0;
+            if (previousShowing)
+                content[displayIndex % content.Count].FadeOut(400, Easing.OutQuint);
+
+            displayIndex++;
+
+            using (BeginDelayedSequence(previousShowing ? 300 : 0))
+                content[displayIndex % content.Count].Show();
+
+            if (content.Count > 1)
+                nextDisplay = Scheduler.AddDelayed(showNext, 12000);
+        }
+
         [LongRunningLoad]
         private partial class MenuImage : OsuClickableContainer
         {

From 3847aae57d88ea2156c7599c53a0e994fffd4760 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Mar 2024 12:14:40 +0800
Subject: [PATCH 461/930] Don't rotate when hovering

---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs | 26 ++++++++++++++++-------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index a4648265ae..74062d5b9f 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Screens.Menu
 {
     public partial class OnlineMenuBanner : VisibilityContainer
     {
+        public double DelayBetweenRotation = 7500;
+
         internal Bindable<APIMenuContent> Current { get; } = new Bindable<APIMenuContent>(new APIMenuContent());
 
         private const float transition_duration = 500;
@@ -115,21 +117,29 @@ namespace osu.Game.Screens.Menu
         {
             nextDisplay?.Cancel();
 
-            bool previousShowing = displayIndex >= 0;
-            if (previousShowing)
-                content[displayIndex % content.Count].FadeOut(400, Easing.OutQuint);
+            // If the user is hovering a banner, don't rotate yet.
+            bool anyHovered = content.Any(i => i.IsHovered);
 
-            displayIndex++;
+            if (!anyHovered)
+            {
+                bool previousShowing = displayIndex >= 0;
+                if (previousShowing)
+                    content[displayIndex % content.Count].FadeOut(400, Easing.OutQuint);
 
-            using (BeginDelayedSequence(previousShowing ? 300 : 0))
-                content[displayIndex % content.Count].Show();
+                displayIndex++;
+
+                using (BeginDelayedSequence(previousShowing ? 300 : 0))
+                    content[displayIndex % content.Count].Show();
+            }
 
             if (content.Count > 1)
-                nextDisplay = Scheduler.AddDelayed(showNext, 12000);
+            {
+                nextDisplay = Scheduler.AddDelayed(showNext, DelayBetweenRotation);
+            }
         }
 
         [LongRunningLoad]
-        private partial class MenuImage : OsuClickableContainer
+        public partial class MenuImage : OsuClickableContainer
         {
             public readonly APIMenuImage Image;
 

From e9f15534ed7ea64b7cfe77360f488b3a63e703db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Mar 2024 12:14:47 +0800
Subject: [PATCH 462/930] Improve test coverage

---
 .../Visual/Menus/TestSceneOnlineMenuBanner.cs | 75 ++++++++++++++++---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs     |  7 +-
 2 files changed, 71 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index 4cc379a18b..6be5b80983 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -21,6 +22,8 @@ namespace osu.Game.Tests.Visual.Menus
             {
                 Child = onlineMenuBanner = new OnlineMenuBanner
                 {
+                    FetchOnlineContent = false,
+                    DelayBetweenRotation = 500,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     State = { Value = Visibility.Visible }
@@ -43,6 +46,18 @@ namespace osu.Game.Tests.Visual.Menus
                 },
             });
 
+            AddUntilStep("wait for one image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 1)
+                    return false;
+
+                var image = images.Single();
+
+                return image.IsPresent && image.Image.Url == "https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023";
+            });
+
             AddStep("set another title", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
                 Images = new[]
@@ -55,6 +70,40 @@ namespace osu.Game.Tests.Visual.Menus
                 }
             });
 
+            AddUntilStep("wait for new image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 1)
+                    return false;
+
+                var image = images.Single();
+
+                return image.IsPresent && image.Image.Url == "https://osu.ppy.sh/community/contests/189";
+            });
+
+            AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                    }
+                }
+            });
+
+            AddUntilStep("wait for no image shown", () => !onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Any());
+
+            AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
+
+            AddUntilStep("wait for no image shown", () => !onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Any());
+        }
+
+        [Test]
+        public void TestMultipleImages()
+        {
             AddStep("set multiple images", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
                 Images = new[]
@@ -72,19 +121,25 @@ namespace osu.Game.Tests.Visual.Menus
                 },
             });
 
-            AddStep("set title with nonexistent image", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            AddUntilStep("wait for first image shown", () =>
             {
-                Images = new[]
-                {
-                    new APIMenuImage
-                    {
-                        Image = @"https://test.invalid/@2x", // .invalid TLD reserved by https://datatracker.ietf.org/doc/html/rfc2606#section-2
-                        Url = @"https://osu.ppy.sh/community/contests/189",
-                    }
-                }
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 2)
+                    return false;
+
+                return images.First().IsPresent && !images.Last().IsPresent;
             });
 
-            AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
+            AddUntilStep("wait for second image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 2)
+                    return false;
+
+                return !images.First().IsPresent && images.Last().IsPresent;
+            });
         }
     }
 }
diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 74062d5b9f..2ab6417370 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -21,7 +21,9 @@ namespace osu.Game.Screens.Menu
 {
     public partial class OnlineMenuBanner : VisibilityContainer
     {
-        public double DelayBetweenRotation = 7500;
+        public double DelayBetweenRotation { get; set; } = 7500;
+
+        public bool FetchOnlineContent { get; set; } = true;
 
         internal Bindable<APIMenuContent> Current { get; } = new Bindable<APIMenuContent>(new APIMenuContent());
 
@@ -64,6 +66,9 @@ namespace osu.Game.Screens.Menu
 
         private void checkForUpdates()
         {
+            if (!FetchOnlineContent)
+                return;
+
             var request = new GetMenuContentRequest();
             Task.Run(() => request.Perform())
                 .ContinueWith(r =>

From f0614928b182bf2d575c5e298e29d2254fd28ecb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Mar 2024 13:19:12 +0800
Subject: [PATCH 463/930] Read from new location

---
 osu.Game/Online/API/Requests/GetMenuContentRequest.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Online/API/Requests/GetMenuContentRequest.cs b/osu.Game/Online/API/Requests/GetMenuContentRequest.cs
index ad2bac6696..26747489d6 100644
--- a/osu.Game/Online/API/Requests/GetMenuContentRequest.cs
+++ b/osu.Game/Online/API/Requests/GetMenuContentRequest.cs
@@ -8,7 +8,7 @@ namespace osu.Game.Online.API.Requests
     public class GetMenuContentRequest : OsuJsonWebRequest<APIMenuContent>
     {
         public GetMenuContentRequest()
-            : base(@"https://assets.ppy.sh/lazer-status.json")
+            : base(@"https://assets.ppy.sh/menu-content.json")
         {
         }
     }

From 057f86dd145dd5d0ba573737ca61aceb27dcc70a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Mar 2024 14:28:23 +0800
Subject: [PATCH 464/930] Add handling of expiration

---
 .../Visual/Menus/TestSceneOnlineMenuBanner.cs | 60 +++++++++++++++++++
 .../API/Requests/Responses/APIMenuImage.cs    |  4 ++
 osu.Game/Screens/Menu/OnlineMenuBanner.cs     | 60 ++++++++++++-------
 3 files changed, 102 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index 6be5b80983..2dd08ce306 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
@@ -141,5 +142,64 @@ namespace osu.Game.Tests.Visual.Menus
                 return !images.First().IsPresent && images.Last().IsPresent;
             });
         }
+
+        [Test]
+        public void TestExpiry()
+        {
+            AddStep("set multiple images, second expiring soon", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
+                        Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                    },
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/wf2023-vote@2x.png",
+                        Url = @"https://osu.ppy.sh/community/contests/189",
+                        Expires = DateTimeOffset.Now.AddSeconds(2),
+                    }
+                },
+            });
+
+            AddUntilStep("wait for first image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 2)
+                    return false;
+
+                return images.First().IsPresent && !images.Last().IsPresent;
+            });
+
+            AddUntilStep("wait for second image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 2)
+                    return false;
+
+                return !images.First().IsPresent && images.Last().IsPresent;
+            });
+
+            AddUntilStep("wait for expiry", () =>
+            {
+                return onlineMenuBanner
+                       .ChildrenOfType<OnlineMenuBanner.MenuImage>()
+                       .Any(i => !i.Image.IsCurrent);
+            });
+
+            AddUntilStep("wait for first image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 2)
+                    return false;
+
+                return images.First().IsPresent && !images.Last().IsPresent;
+            });
+        }
     }
 }
diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
index 4824e23d4b..42129ca96e 100644
--- a/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
@@ -20,6 +20,10 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty(@"url")]
         public string Url { get; init; } = string.Empty;
 
+        public bool IsCurrent =>
+            (Begins == null || Begins < DateTimeOffset.UtcNow) &&
+            (Expires == null || Expires > DateTimeOffset.UtcNow);
+
         /// <summary>
         /// The time at which this item should begin displaying. If <c>null</c>, will display immediately.
         /// </summary>
diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 2ab6417370..55ceb84d7b 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Screens.Menu
 
         private const float transition_duration = 500;
 
-        private Container content = null!;
+        private Container<MenuImage> content = null!;
         private CancellationTokenSource? cancellationTokenSource;
 
         private int displayIndex = -1;
@@ -43,7 +43,7 @@ namespace osu.Game.Screens.Menu
             AutoSizeDuration = transition_duration;
             AutoSizeEasing = Easing.OutQuint;
 
-            InternalChild = content = new Container
+            InternalChild = content = new Container<MenuImage>
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
@@ -59,8 +59,7 @@ namespace osu.Game.Screens.Menu
         {
             base.LoadComplete();
 
-            Current.BindValueChanged(_ => loadNewImages(), true);
-
+            Current.BindValueChanged(loadNewImages, true);
             checkForUpdates();
         }
 
@@ -86,25 +85,24 @@ namespace osu.Game.Screens.Menu
                 });
         }
 
-        private void loadNewImages()
+        /// <summary>
+        /// Takes <see cref="Current"/> and materialises and displays drawables for all valid images to be displayed.
+        /// </summary>
+        /// <param name="images"></param>
+        private void loadNewImages(ValueChangedEvent<APIMenuContent> images)
         {
             nextDisplay?.Cancel();
 
             cancellationTokenSource?.Cancel();
             cancellationTokenSource = null;
 
-            var newContent = Current.Value;
-
             // A better fade out would be nice, but the menu content changes *very* rarely
             // so let's keep things simple for now.
             content.Clear(true);
 
-            if (newContent.Images.Length == 0)
-                return;
-
-            LoadComponentsAsync(newContent.Images.Select(i => new MenuImage(i)), loaded =>
+            LoadComponentsAsync(images.NewValue.Images.Select(i => new MenuImage(i)), loaded =>
             {
-                if (!newContent.Equals(Current.Value))
+                if (!images.NewValue.Equals(Current.Value))
                     return;
 
                 // start hidden
@@ -127,20 +125,38 @@ namespace osu.Game.Screens.Menu
 
             if (!anyHovered)
             {
-                bool previousShowing = displayIndex >= 0;
-                if (previousShowing)
-                    content[displayIndex % content.Count].FadeOut(400, Easing.OutQuint);
+                int previousIndex = displayIndex;
 
-                displayIndex++;
+                if (displayIndex == -1)
+                    displayIndex = 0;
 
-                using (BeginDelayedSequence(previousShowing ? 300 : 0))
-                    content[displayIndex % content.Count].Show();
+                // To handle expiration simply, arrange all images in best-next order.
+                // Fade in the first valid one, then handle fading out the last if required.
+                var currentRotation = content
+                                      .Skip(displayIndex + 1)
+                                      .Concat(content.Take(displayIndex + 1));
+
+                foreach (var image in currentRotation)
+                {
+                    if (!image.Image.IsCurrent) continue;
+
+                    using (BeginDelayedSequence(previousIndex >= 0 ? 300 : 0))
+                    {
+                        displayIndex = content.IndexOf(image);
+
+                        if (displayIndex != previousIndex)
+                            image.Show();
+
+                        break;
+                    }
+                }
+
+                if (previousIndex >= 0 && previousIndex != displayIndex)
+                    content[previousIndex].FadeOut(400, Easing.OutQuint);
             }
 
-            if (content.Count > 1)
-            {
-                nextDisplay = Scheduler.AddDelayed(showNext, DelayBetweenRotation);
-            }
+            // Re-scheduling this method will both handle rotation and re-checking for expiration dates.
+            nextDisplay = Scheduler.AddDelayed(showNext, DelayBetweenRotation);
         }
 
         [LongRunningLoad]

From bb9fa52fda51f46e4e0fe39e2be8196ab0dc0fba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 25 Mar 2024 14:53:05 +0800
Subject: [PATCH 465/930] Fix `displayIndex` not being correctly set to `-1`
 after last expiry date

---
 .../Visual/Menus/TestSceneOnlineMenuBanner.cs | 36 ++++++++++++++++++-
 osu.Game/Screens/Menu/OnlineMenuBanner.cs     | 11 +++---
 2 files changed, 41 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index 2dd08ce306..380085ce04 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -144,7 +144,41 @@ namespace osu.Game.Tests.Visual.Menus
         }
 
         [Test]
-        public void TestExpiry()
+        public void TestFutureSingle()
+        {
+            AddStep("set image with time constraints", () => onlineMenuBanner.Current.Value = new APIMenuContent
+            {
+                Images = new[]
+                {
+                    new APIMenuImage
+                    {
+                        Image = @"https://assets.ppy.sh/main-menu/project-loved-2@2x.png",
+                        Url = @"https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023",
+                        Begins = DateTimeOffset.Now.AddSeconds(2),
+                        Expires = DateTimeOffset.Now.AddSeconds(5),
+                    },
+                },
+            });
+
+            AddUntilStep("wait for no image shown", () => !onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Any(i => i.IsPresent));
+
+            AddUntilStep("wait for one image shown", () =>
+            {
+                var images = onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>();
+
+                if (images.Count() != 1)
+                    return false;
+
+                var image = images.Single();
+
+                return image.IsPresent && image.Image.Url == "https://osu.ppy.sh/home/news/2023-12-21-project-loved-december-2023";
+            });
+
+            AddUntilStep("wait for no image shown", () => !onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Any(i => i.IsPresent));
+        }
+
+        [Test]
+        public void TestExpiryMultiple()
         {
             AddStep("set multiple images, second expiring soon", () => onlineMenuBanner.Current.Value = new APIMenuContent
             {
diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 55ceb84d7b..37bec7aa63 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -127,14 +127,15 @@ namespace osu.Game.Screens.Menu
             {
                 int previousIndex = displayIndex;
 
-                if (displayIndex == -1)
-                    displayIndex = 0;
-
                 // To handle expiration simply, arrange all images in best-next order.
                 // Fade in the first valid one, then handle fading out the last if required.
                 var currentRotation = content
-                                      .Skip(displayIndex + 1)
-                                      .Concat(content.Take(displayIndex + 1));
+                                      .Skip(Math.Max(0, previousIndex) + 1)
+                                      .Concat(content.Take(Math.Max(0, previousIndex) + 1));
+
+                // After the loop, displayIndex will be the new valid index or -1 if
+                // none valid.
+                displayIndex = -1;
 
                 foreach (var image in currentRotation)
                 {

From 78037fa4773dfc8f8063d45e104bd84131515bcc Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 25 Mar 2024 04:19:14 -0300
Subject: [PATCH 466/930] Handle new combo on `HandleReverse`

---
 .../Edit/CatchSelectionHandler.cs             | 33 ++++++++++++++++---
 .../Edit/OsuSelectionHandler.cs               | 20 +++++++++++
 2 files changed, 48 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index 418351e2f3..e3d82cc517 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -76,21 +76,44 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public override bool HandleReverse()
         {
+            var hitObjects = EditorBeatmap.SelectedHitObjects;
+
             double selectionStartTime = SelectedItems.Min(h => h.StartTime);
             double selectionEndTime = SelectedItems.Max(h => h.GetEndTime());
 
-            EditorBeatmap.PerformOnSelection(hitObject =>
-            {
-                hitObject.StartTime = selectionEndTime - (hitObject.GetEndTime() - selectionStartTime);
+            var newComboPlaces = hitObjects
+                .OfType<CatchHitObject>()
+                .Where(h => h.NewCombo)
+                .Select(obj => obj.StartTime)
+                .ToList();
 
-                if (hitObject is JuiceStream juiceStream)
+            foreach (var h in hitObjects)
+            {
+                h.StartTime = selectionEndTime - (h.GetEndTime() - selectionStartTime);
+
+                if (h is JuiceStream juiceStream)
                 {
                     juiceStream.Path.Reverse(out Vector2 positionalOffset);
                     juiceStream.OriginalX += positionalOffset.X;
                     juiceStream.LegacyConvertedY += positionalOffset.Y;
                     EditorBeatmap.Update(juiceStream);
                 }
-            });
+            }
+
+            foreach (var h in hitObjects)
+            {
+                if (h is CatchHitObject obj) obj.NewCombo = false;
+            }
+
+            foreach (double place in newComboPlaces)
+            {
+                hitObjects
+                    .OfType<CatchHitObject>()
+                    .Where(obj => obj.StartTime == place)
+                    .ToList()
+                    .ForEach(obj => obj.NewCombo = true);
+            }
+
             return true;
         }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index cea2adc6e2..b4980b55d4 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -85,6 +85,12 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             bool moreThanOneObject = hitObjects.Count > 1;
 
+            var newComboPlaces = hitObjects
+                .OfType<OsuHitObject>()
+                .Where(h => h.NewCombo)
+                .Select(obj => obj.StartTime)
+                .ToList();
+
             foreach (var h in hitObjects)
             {
                 if (moreThanOneObject)
@@ -97,6 +103,20 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             }
 
+            foreach (var h in hitObjects)
+            {
+                if (h is OsuHitObject obj) obj.NewCombo = false;
+            }
+
+            foreach (double place in newComboPlaces)
+            {
+                hitObjects
+                    .OfType<OsuHitObject>()
+                    .Where(obj => obj.StartTime == place)
+                    .ToList()
+                    .ForEach(obj => obj.NewCombo = true);
+            }
+
             return true;
         }
 

From fb08d6816ba21cc6cb3351694ff587a2100fc86a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 11:33:15 +0100
Subject: [PATCH 467/930] Only attempt to disable rulesets when decidedly
 crashing out

---
 osu.Game/OsuGameBase.cs | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 8bda8fb6c2..fb7a238c46 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -678,18 +678,21 @@ namespace osu.Game
         /// <summary>
         /// Allows a maximum of one unhandled exception, per second of execution.
         /// </summary>
+        /// <returns>Whether to ignore the exception and continue running.</returns>
         private bool onExceptionThrown(Exception ex)
         {
-            bool continueExecution = Interlocked.Decrement(ref allowableExceptions) >= 0;
-
-            Logger.Log($"Unhandled exception has been {(continueExecution ? $"allowed with {allowableExceptions} more allowable exceptions" : "denied")} .");
-
-            RulesetStore.TryDisableCustomRulesetsCausing(ex);
+            if (Interlocked.Decrement(ref allowableExceptions) < 0)
+            {
+                Logger.Log("Too many unhandled exceptions, crashing out.");
+                RulesetStore.TryDisableCustomRulesetsCausing(ex);
+                return false;
+            }
 
+            Logger.Log($"Unhandled exception has been allowed with {allowableExceptions} more allowable exceptions.");
             // restore the stock of allowable exceptions after a short delay.
             Task.Delay(1000).ContinueWith(_ => Interlocked.Increment(ref allowableExceptions));
 
-            return continueExecution;
+            return true;
         }
 
         protected override void Dispose(bool isDisposing)

From 4979305b2d59188e97efd03e4e49e90aacb32485 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 11:34:29 +0100
Subject: [PATCH 468/930] Ensure `TryDisableCustomRulesetsCausing()` never
 actually crashes itself

---
 osu.Game/Rulesets/RealmRulesetStore.cs | 31 ++++++++++++++++----------
 1 file changed, 19 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Rulesets/RealmRulesetStore.cs b/osu.Game/Rulesets/RealmRulesetStore.cs
index 36eae7af2c..2455a9a73f 100644
--- a/osu.Game/Rulesets/RealmRulesetStore.cs
+++ b/osu.Game/Rulesets/RealmRulesetStore.cs
@@ -164,26 +164,33 @@ namespace osu.Game.Rulesets
 
         internal void TryDisableCustomRulesetsCausing(Exception exception)
         {
-            var stackTrace = new StackTrace(exception);
-
-            foreach (var frame in stackTrace.GetFrames())
+            try
             {
-                var declaringAssembly = frame.GetMethod()?.DeclaringType?.Assembly;
-                if (declaringAssembly == null)
-                    continue;
+                var stackTrace = new StackTrace(exception);
 
-                if (UserRulesetAssemblies.Contains(declaringAssembly))
+                foreach (var frame in stackTrace.GetFrames())
                 {
-                    string sourceLocation = declaringAssembly.Location;
-                    string destinationLocation = Path.ChangeExtension(sourceLocation, @".dll.broken");
+                    var declaringAssembly = frame.GetMethod()?.DeclaringType?.Assembly;
+                    if (declaringAssembly == null)
+                        continue;
 
-                    if (File.Exists(sourceLocation))
+                    if (UserRulesetAssemblies.Contains(declaringAssembly))
                     {
-                        Logger.Log($"Unhandled exception traced back to custom ruleset {Path.GetFileNameWithoutExtension(sourceLocation)}. Marking as broken.");
-                        File.Move(sourceLocation, destinationLocation);
+                        string sourceLocation = declaringAssembly.Location;
+                        string destinationLocation = Path.ChangeExtension(sourceLocation, @".dll.broken");
+
+                        if (File.Exists(sourceLocation))
+                        {
+                            Logger.Log($"Unhandled exception traced back to custom ruleset {Path.GetFileNameWithoutExtension(sourceLocation)}. Marking as broken.");
+                            File.Move(sourceLocation, destinationLocation);
+                        }
                     }
                 }
             }
+            catch (Exception ex)
+            {
+                Logger.Log($"Attempt to trace back crash to custom ruleset failed: {ex}");
+            }
         }
     }
 }

From 3db88fbcea288f5c4136739bd26e0bdab9e0b05a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 17:54:20 +0100
Subject: [PATCH 469/930] Use less confusing message format when logging
 discord errors

The "code" is a number, so it looked weird when put in the middle
without any nearby punctuation. Example:

	An error occurred with Discord RPC Client: 5005 secrets cannot currently be sent with buttons
---
 osu.Desktop/DiscordRichPresence.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index d78459ff28..eaa9a90f27 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -75,7 +75,7 @@ namespace osu.Desktop
             };
 
             client.OnReady += onReady;
-            client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Code} {e.Message}", LoggingTarget.Network, LogLevel.Error);
+            client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Message} ({e.Code})", LoggingTarget.Network, LogLevel.Error);
 
             // A URI scheme is required to support game invitations, as well as informing Discord of the game executable path to support launching the game when a user clicks on join/spectate.
             client.RegisterUriScheme();

From e95f29cf4ba8840e0305bbae7637d01ddc03f285 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 17:57:13 +0100
Subject: [PATCH 470/930] Rename `updatePresence() => schedulePresenceUpdate()`

The method doesn't actually update anything by itself, and I want to
free up the `updatePresence()` name for the actual update.
---
 osu.Desktop/DiscordRichPresence.cs | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index eaa9a90f27..811f2f3548 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -94,10 +94,10 @@ namespace osu.Desktop
                 activity.BindTo(u.NewValue.Activity);
             }, true);
 
-            ruleset.BindValueChanged(_ => updatePresence());
-            status.BindValueChanged(_ => updatePresence());
-            activity.BindValueChanged(_ => updatePresence());
-            privacyMode.BindValueChanged(_ => updatePresence());
+            ruleset.BindValueChanged(_ => schedulePresenceUpdate());
+            status.BindValueChanged(_ => schedulePresenceUpdate());
+            activity.BindValueChanged(_ => schedulePresenceUpdate());
+            privacyMode.BindValueChanged(_ => schedulePresenceUpdate());
             multiplayerClient.RoomUpdated += onRoomUpdated;
 
             client.Initialize();
@@ -111,14 +111,14 @@ namespace osu.Desktop
             if (client.CurrentPresence != null)
                 client.SetPresence(null);
 
-            updatePresence();
+            schedulePresenceUpdate();
         }
 
-        private void onRoomUpdated() => updatePresence();
+        private void onRoomUpdated() => schedulePresenceUpdate();
 
         private ScheduledDelegate? presenceUpdateDelegate;
 
-        private void updatePresence()
+        private void schedulePresenceUpdate()
         {
             presenceUpdateDelegate?.Cancel();
             presenceUpdateDelegate = Scheduler.AddDelayed(() =>

From a398754a27ac26a1f6e57790b2c609226ad805fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 18:00:42 +0100
Subject: [PATCH 471/930] Merge all presence methods into one

I'm about to make them interdependent (and it's discord's fault),
so it doesn't really make sense to make them separate at this point
I don't think. And it felt weird anyway.
---
 osu.Desktop/DiscordRichPresence.cs | 20 +++++++-------------
 1 file changed, 7 insertions(+), 13 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 811f2f3548..d67437ba62 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -134,16 +134,14 @@ namespace osu.Desktop
 
                 bool hideIdentifiableInformation = privacyMode.Value == DiscordRichPresenceMode.Limited || status.Value == UserStatus.DoNotDisturb;
 
-                updatePresenceStatus(hideIdentifiableInformation);
-                updatePresenceParty(hideIdentifiableInformation);
-                updatePresenceAssets();
-
+                updatePresence(hideIdentifiableInformation);
                 client.SetPresence(presence);
             }, 200);
         }
 
-        private void updatePresenceStatus(bool hideIdentifiableInformation)
+        private void updatePresence(bool hideIdentifiableInformation)
         {
+            // user activity
             if (activity.Value != null)
             {
                 presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
@@ -170,10 +168,8 @@ namespace osu.Desktop
                 presence.State = "Idle";
                 presence.Details = string.Empty;
             }
-        }
 
-        private void updatePresenceParty(bool hideIdentifiableInformation)
-        {
+            // user party
             if (!hideIdentifiableInformation && multiplayerClient.Room != null)
             {
                 MultiplayerRoom room = multiplayerClient.Room;
@@ -201,11 +197,9 @@ namespace osu.Desktop
                 presence.Party = null;
                 presence.Secrets.JoinSecret = null;
             }
-        }
 
-        private void updatePresenceAssets()
-        {
-            // update user information
+            // game images:
+            // large image tooltip
             if (privacyMode.Value == DiscordRichPresenceMode.Limited)
                 presence.Assets.LargeImageText = string.Empty;
             else
@@ -216,7 +210,7 @@ namespace osu.Desktop
                     presence.Assets.LargeImageText = $"{user.Value.Username}" + (user.Value.Statistics?.GlobalRank > 0 ? $" (rank #{user.Value.Statistics.GlobalRank:N0})" : string.Empty);
             }
 
-            // update ruleset
+            // small image
             presence.Assets.SmallImageKey = ruleset.Value.IsLegacyRuleset() ? $"mode_{ruleset.Value.OnlineID}" : "mode_custom";
             presence.Assets.SmallImageText = ruleset.Value.Name;
         }

From 53c3aec3c364a2541180e1bc34b4c40ee688f2b6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 18:02:54 +0100
Subject: [PATCH 472/930] Fix discord RPC errors in multiplayer

Reproduction steps:

1. Go to multiplayer
2. Create a room
3. Play a map to completion
4. Wait for "secrets cannot currently be sent with buttons" error
   messages

The fix is to clear the buttons since they're the less important ones.
---
 osu.Desktop/DiscordRichPresence.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index d67437ba62..6e8554d617 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -191,6 +191,9 @@ namespace osu.Desktop
                 };
 
                 presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
+                // discord cannot handle both secrets and buttons at the same time, so we need to choose something.
+                // the multiplayer room seems more important.
+                presence.Buttons = null;
             }
             else
             {

From 6266af8a5696edb32da2f57b877f84dbcab66e3d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 18:57:58 +0100
Subject: [PATCH 473/930] Fix taiko legacy score simulator not including swell
 tick score gain into bonus portion

Reported in https://discord.com/channels/188630481301012481/1097318920991559880/1221836384038551613.

Example score: https://osu.ppy.sh/scores/1855965185

The cause of the overestimation was an error in taiko's score simulator.
In lazer taiko, swell ticks don't give any score anymore, while they did
in stable.

For all intents and purposes, swell ticks can be considered "bonus"
objects that "don't give any actual bonus score". Which is to say,
during simulation of a legacy score swell ticks hit should be treated
as bonus, because if they aren't, then otherwise they will be treated
essentially as *normal hits*, meaning that they will be included in
the *accuracy* portion of score, which breaks all sorts of follow-up
assumptions:

- The accuracy portion of the best possible total score becomes
  overinflated in comparison to reality, while the combo portion of
  that maximum score becomes underestimated.

- Because the affected score has low accuracy, the estimated accuracy
  portion of the score (as given by maximmum accuracy portion of score
  times the actual numerical accuracy of the score) is also low.

- However, the next step is estimating the combo portion, which is done
  by taking legacy total score, subtracting the aforementioned
  estimation for accuracy total score from that, and then dividing
  the result by the maximum achievable combo score on the map. Because
  most of actual "combo" score from swell ticks was "moved" into the
  accuracy portion due to the aforementioned error, the maximum
  achievable combo score becomes so small that the estimated combo
  portion exceeds 1.

Instead, this change makes it so that gains from swell ticks are treated
as "bonus", which means that they are excluded from the accuracy portion
of score and instead count into the bonus portion of score, bringing the
scores concerned more in line with expectations - although due to
pessimistic assumptions in the simulation of the swell itself,
the conversion will still overestimate total score for affected scores,
just not by *that* much.
---
 osu.Game.Rulesets.Taiko/Difficulty/TaikoLegacyScoreSimulator.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Difficulty/TaikoLegacyScoreSimulator.cs b/osu.Game.Rulesets.Taiko/Difficulty/TaikoLegacyScoreSimulator.cs
index 66ff0fc3d9..9839d94277 100644
--- a/osu.Game.Rulesets.Taiko/Difficulty/TaikoLegacyScoreSimulator.cs
+++ b/osu.Game.Rulesets.Taiko/Difficulty/TaikoLegacyScoreSimulator.cs
@@ -95,6 +95,8 @@ namespace osu.Game.Rulesets.Taiko.Difficulty
                 case SwellTick:
                     scoreIncrease = 300;
                     increaseCombo = false;
+                    isBonus = true;
+                    bonusResult = HitResult.IgnoreHit;
                     break;
 
                 case DrumRollTick:

From 73926592b91e1cf6348b3e7ae3c68142dbbd8d06 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 25 Mar 2024 19:27:38 +0100
Subject: [PATCH 474/930] Bump legacy score version to recalculate all scores

---
 osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
index 93f51ee74d..0f00cce080 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreEncoder.cs
@@ -46,9 +46,10 @@ namespace osu.Game.Scoring.Legacy
         /// <item><description>30000013: All local scores will use lazer definitions of ranks for consistency. Recalculates the rank of all scores.</description></item>
         /// <item><description>30000014: Fix edge cases in conversion for osu! scores on selected beatmaps. Reconvert all scores.</description></item>
         /// <item><description>30000015: Fix osu! standardised score estimation algorithm violating basic invariants. Reconvert all scores.</description></item>
+        /// <item><description>30000016: Fix taiko standardised score estimation algorithm not including swell tick score gain into bonus portion. Reconvert all scores.</description></item>
         /// </list>
         /// </remarks>
-        public const int LATEST_VERSION = 30000015;
+        public const int LATEST_VERSION = 30000016;
 
         /// <summary>
         /// The first stable-compatible YYYYMMDD format version given to lazer usage of replays.

From 10683de578590d9a17c690df4ef9fc89515599a5 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 26 Mar 2024 04:59:47 -0300
Subject: [PATCH 475/930] Use order of new combo flags instead of `StartTime`

---
 .../Edit/CatchSelectionHandler.cs             | 22 +++++++------------
 .../Edit/OsuSelectionHandler.cs               | 22 +++++++------------
 2 files changed, 16 insertions(+), 28 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index e3d82cc517..e3d2347c4d 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -81,12 +81,13 @@ namespace osu.Game.Rulesets.Catch.Edit
             double selectionStartTime = SelectedItems.Min(h => h.StartTime);
             double selectionEndTime = SelectedItems.Max(h => h.GetEndTime());
 
-            var newComboPlaces = hitObjects
+            var newComboOrder = hitObjects
                 .OfType<CatchHitObject>()
-                .Where(h => h.NewCombo)
-                .Select(obj => obj.StartTime)
+                .Select(obj => obj.NewCombo)
                 .ToList();
 
+            newComboOrder.Reverse();
+
             foreach (var h in hitObjects)
             {
                 h.StartTime = selectionEndTime - (h.GetEndTime() - selectionStartTime);
@@ -100,18 +101,11 @@ namespace osu.Game.Rulesets.Catch.Edit
                 }
             }
 
-            foreach (var h in hitObjects)
+            int i = 0;
+            foreach (bool newCombo in newComboOrder)
             {
-                if (h is CatchHitObject obj) obj.NewCombo = false;
-            }
-
-            foreach (double place in newComboPlaces)
-            {
-                hitObjects
-                    .OfType<CatchHitObject>()
-                    .Where(obj => obj.StartTime == place)
-                    .ToList()
-                    .ForEach(obj => obj.NewCombo = true);
+                hitObjects.OfType<CatchHitObject>().ToList()[i].NewCombo = newCombo;
+                i++;
             }
 
             return true;
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index b4980b55d4..df39ab8fce 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -85,12 +85,13 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             bool moreThanOneObject = hitObjects.Count > 1;
 
-            var newComboPlaces = hitObjects
+            var newComboOrder = hitObjects
                 .OfType<OsuHitObject>()
-                .Where(h => h.NewCombo)
-                .Select(obj => obj.StartTime)
+                .Select(obj => obj.NewCombo)
                 .ToList();
 
+            newComboOrder.Reverse();
+
             foreach (var h in hitObjects)
             {
                 if (moreThanOneObject)
@@ -103,18 +104,11 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             }
 
-            foreach (var h in hitObjects)
+            int i = 0;
+            foreach (bool newCombo in newComboOrder)
             {
-                if (h is OsuHitObject obj) obj.NewCombo = false;
-            }
-
-            foreach (double place in newComboPlaces)
-            {
-                hitObjects
-                    .OfType<OsuHitObject>()
-                    .Where(obj => obj.StartTime == place)
-                    .ToList()
-                    .ForEach(obj => obj.NewCombo = true);
+                hitObjects.OfType<OsuHitObject>().ToList()[i].NewCombo = newCombo;
+                i++;
             }
 
             return true;

From 9b923b19094bbcdf3f130d005085de70368cb8c6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 10:55:49 +0100
Subject: [PATCH 476/930] Fix code quality issues

---
 .../Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs | 4 ++--
 .../Editor/Checks/CheckKeyCountTest.cs                        | 2 +-
 .../Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs | 4 ++--
 .../Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs   | 4 ++--
 .../Edit/Checks/CheckOsuAbnormalDifficultySettings.cs         | 1 +
 .../Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs | 4 ++--
 6 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
index 2ae2e20215..33aa4cba5d 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/Checks/CheckCatchAbnormalDifficultySettingsTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor.Checks
     {
         private CheckCatchAbnormalDifficultySettings check = null!;
 
-        private IBeatmap beatmap = new Beatmap<HitObject>();
+        private readonly IBeatmap beatmap = new Beatmap<HitObject>();
 
         [SetUp]
         public void Setup()
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor.Checks
             check = new CheckCatchAbnormalDifficultySettings();
 
             beatmap.BeatmapInfo.Ruleset = new CatchRuleset().RulesetInfo;
-            beatmap.Difficulty = new BeatmapDifficulty()
+            beatmap.Difficulty = new BeatmapDifficulty
             {
                 ApproachRate = 5,
                 CircleSize = 5,
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
index 564c611548..b40a62176c 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckKeyCountTest.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
         {
             check = new CheckKeyCount();
 
-            beatmap = new Beatmap<HitObject>()
+            beatmap = new Beatmap<HitObject>
             {
                 BeatmapInfo = new BeatmapInfo
                 {
diff --git a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
index 6c585aace3..da5ab037e5 100644
--- a/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Editor/Checks/CheckManiaAbnormalDifficultySettingsTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
     {
         private CheckManiaAbnormalDifficultySettings check = null!;
 
-        private IBeatmap beatmap = new Beatmap<HitObject>();
+        private readonly IBeatmap beatmap = new Beatmap<HitObject>();
 
         [SetUp]
         public void Setup()
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Mania.Tests.Editor.Checks
             check = new CheckManiaAbnormalDifficultySettings();
 
             beatmap.BeatmapInfo.Ruleset = new ManiaRuleset().RulesetInfo;
-            beatmap.Difficulty = new BeatmapDifficulty()
+            beatmap.Difficulty = new BeatmapDifficulty
             {
                 OverallDifficulty = 5,
                 DrainRate = 5,
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
index 53ccd3c7a7..5f49714d93 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/Checks/CheckOsuAbnormalDifficultySettingsTest.cs
@@ -17,14 +17,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor.Checks
     {
         private CheckOsuAbnormalDifficultySettings check = null!;
 
-        private IBeatmap beatmap = new Beatmap<HitObject>();
+        private readonly IBeatmap beatmap = new Beatmap<HitObject>();
 
         [SetUp]
         public void Setup()
         {
             check = new CheckOsuAbnormalDifficultySettings();
 
-            beatmap.Difficulty = new BeatmapDifficulty()
+            beatmap.Difficulty = new BeatmapDifficulty
             {
                 ApproachRate = 5,
                 CircleSize = 5,
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
index c1eca7fff7..7ad861f317 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
@@ -11,6 +11,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Checks
     public class CheckOsuAbnormalDifficultySettings : CheckAbnormalDifficultySettings
     {
         public override CheckMetadata Metadata => new CheckMetadata(CheckCategory.Settings, "Checks osu relevant settings");
+
         public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
index f10e62f3bf..4a6cf0313a 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
@@ -17,7 +17,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor.Checks
     {
         private CheckTaikoAbnormalDifficultySettings check = null!;
 
-        private IBeatmap beatmap = new Beatmap<HitObject>();
+        private readonly IBeatmap beatmap = new Beatmap<HitObject>();
 
         [SetUp]
         public void Setup()
@@ -25,7 +25,7 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor.Checks
             check = new CheckTaikoAbnormalDifficultySettings();
 
             beatmap.BeatmapInfo.Ruleset = new TaikoRuleset().RulesetInfo;
-            beatmap.Difficulty = new BeatmapDifficulty()
+            beatmap.Difficulty = new BeatmapDifficulty
             {
                 OverallDifficulty = 5,
             };

From 8fb308c1925e1cdbda3eba6e58b7ef5c8fb1fe89 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 10:57:20 +0100
Subject: [PATCH 477/930] Add failing test coverage for checking taiko HP too

I was wrong, taiko uses HP (to calculate miss penalty).
---
 ...heckTaikoAbnormalDifficultySettingsTest.cs | 36 +++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
index 4a6cf0313a..6a50fd0956 100644
--- a/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
+++ b/osu.Game.Rulesets.Taiko.Tests/Editor/Checks/CheckTaikoAbnormalDifficultySettingsTest.cs
@@ -52,6 +52,18 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor.Checks
             Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
         }
 
+        [Test]
+        public void TestDrainRateTwoDecimals()
+        {
+            beatmap.Difficulty.DrainRate = 5.55f;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateMoreThanOneDecimal);
+        }
+
         [Test]
         public void TestOverallDifficultyUnder()
         {
@@ -76,6 +88,30 @@ namespace osu.Game.Rulesets.Taiko.Tests.Editor.Checks
             Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
         }
 
+        [Test]
+        public void TestDrainRateUnder()
+        {
+            beatmap.Difficulty.DrainRate = -10;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
+        [Test]
+        public void TestDrainRateOver()
+        {
+            beatmap.Difficulty.DrainRate = 20;
+
+            var context = getContext();
+            var issues = check.Run(context).ToList();
+
+            Assert.That(issues, Has.Count.EqualTo(1));
+            Assert.That(issues.Single().Template is CheckAbnormalDifficultySettings.IssueTemplateOutOfRange);
+        }
+
         private BeatmapVerifierContext getContext()
         {
             return new BeatmapVerifierContext(beatmap, new TestWorkingBeatmap(beatmap));

From e7cf1ab4df36879306ef6e4c38b535ba370a0e90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 10:58:39 +0100
Subject: [PATCH 478/930] Add checks for taiko drain rate

---
 .../Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs     | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
index ce35f21853..10e2867ca0 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
@@ -21,6 +21,12 @@ namespace osu.Game.Rulesets.Taiko.Edit.Checks
 
             if (OutOfRange(diff.OverallDifficulty))
                 yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+
+            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
+                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+
+            if (OutOfRange(diff.DrainRate))
+                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
         }
     }
 }

From 1866b4b6b10d1990db311eb96ae02c5c5609e918 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 11:13:03 +0100
Subject: [PATCH 479/930] Refactor abstract check to reduce duplication

---
 .../CheckCatchAbnormalDifficultySettings.cs   | 25 +++++++-------
 .../CheckManiaAbnormalDifficultySettings.cs   | 17 +++++-----
 .../CheckOsuAbnormalDifficultySettings.cs     | 33 ++++++++++---------
 .../CheckTaikoAbnormalDifficultySettings.cs   | 17 +++++-----
 .../Checks/CheckAbnormalDifficultySettings.cs | 13 +++++---
 5 files changed, 57 insertions(+), 48 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
index 8295795f00..d2c3df0872 100644
--- a/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Catch/Edit/Checks/CheckCatchAbnormalDifficultySettings.cs
@@ -15,24 +15,25 @@ namespace osu.Game.Rulesets.Catch.Edit.Checks
         public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
+            Issue? issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.ApproachRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
+            if (HasMoreThanOneDecimalPlace("Approach rate", diff.ApproachRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.ApproachRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
+            if (OutOfRange("Approach rate", diff.ApproachRate, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.CircleSize))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
+            if (HasMoreThanOneDecimalPlace("Circle size", diff.CircleSize, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.CircleSize))
-                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
+            if (OutOfRange("Circle size", diff.CircleSize, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+            if (HasMoreThanOneDecimalPlace("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.DrainRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+            if (OutOfRange("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
index ae0cc3aa4c..233c602c21 100644
--- a/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Mania/Edit/Checks/CheckManiaAbnormalDifficultySettings.cs
@@ -15,18 +15,19 @@ namespace osu.Game.Rulesets.Mania.Edit.Checks
         public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
+            Issue? issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (HasMoreThanOneDecimalPlace("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.OverallDifficulty))
-                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (OutOfRange("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+            if (HasMoreThanOneDecimalPlace("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.DrainRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+            if (OutOfRange("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
index 7ad861f317..1c44d54633 100644
--- a/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Checks/CheckOsuAbnormalDifficultySettings.cs
@@ -15,30 +15,31 @@ namespace osu.Game.Rulesets.Osu.Edit.Checks
         public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
+            Issue? issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.ApproachRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Approach rate", diff.ApproachRate);
+            if (HasMoreThanOneDecimalPlace("Approach rate", diff.ApproachRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.ApproachRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Approach rate", diff.ApproachRate);
+            if (OutOfRange("Approach rate", diff.ApproachRate, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (HasMoreThanOneDecimalPlace("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.OverallDifficulty))
-                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (OutOfRange("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.CircleSize))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Circle size", diff.CircleSize);
+            if (HasMoreThanOneDecimalPlace("Circle size", diff.CircleSize, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.CircleSize))
-                yield return new IssueTemplateOutOfRange(this).Create("Circle size", diff.CircleSize);
+            if (OutOfRange("Circle size", diff.CircleSize, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+            if (HasMoreThanOneDecimalPlace("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.DrainRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+            if (OutOfRange("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
index 10e2867ca0..38ba7b1b01 100644
--- a/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
+++ b/osu.Game.Rulesets.Taiko/Edit/Checks/CheckTaikoAbnormalDifficultySettings.cs
@@ -15,18 +15,19 @@ namespace osu.Game.Rulesets.Taiko.Edit.Checks
         public override IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var diff = context.Beatmap.Difficulty;
+            Issue? issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.OverallDifficulty))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (HasMoreThanOneDecimalPlace("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.OverallDifficulty))
-                yield return new IssueTemplateOutOfRange(this).Create("Overall difficulty", diff.OverallDifficulty);
+            if (OutOfRange("Overall difficulty", diff.OverallDifficulty, out issue))
+                yield return issue;
 
-            if (HasMoreThanOneDecimalPlace(diff.DrainRate))
-                yield return new IssueTemplateMoreThanOneDecimal(this).Create("Drain rate", diff.DrainRate);
+            if (HasMoreThanOneDecimalPlace("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
 
-            if (OutOfRange(diff.DrainRate))
-                yield return new IssueTemplateOutOfRange(this).Create("Drain rate", diff.DrainRate);
+            if (OutOfRange("Drain rate", diff.DrainRate, out issue))
+                yield return issue;
         }
     }
 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
index 93592a866b..638f0cfd53 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckAbnormalDifficultySettings.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using System.Diagnostics.CodeAnalysis;
 using osu.Game.Rulesets.Edit.Checks.Components;
 
 namespace osu.Game.Rulesets.Edit.Checks
@@ -21,14 +22,18 @@ namespace osu.Game.Rulesets.Edit.Checks
         /// <summary>
         /// If the setting is out of the boundaries set by the editor (0 - 10)
         /// </summary>
-        protected bool OutOfRange(float setting)
+        protected bool OutOfRange(string setting, float value, [NotNullWhen(true)] out Issue? issue)
         {
-            return setting < 0f || setting > 10f;
+            bool hasIssue = value < 0f || value > 10f;
+            issue = hasIssue ? new IssueTemplateOutOfRange(this).Create(setting, value) : null;
+            return hasIssue;
         }
 
-        protected bool HasMoreThanOneDecimalPlace(float setting)
+        protected bool HasMoreThanOneDecimalPlace(string setting, float value, [NotNullWhen(true)] out Issue? issue)
         {
-            return float.Round(setting, 1) != setting;
+            bool hasIssue = float.Round(value, 1) != value;
+            issue = hasIssue ? new IssueTemplateMoreThanOneDecimal(this).Create(setting, value) : null;
+            return hasIssue;
         }
 
         public class IssueTemplateMoreThanOneDecimal : IssueTemplate

From c24eb066dc4927580ffecfe79460819bc5486f84 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 12:03:24 +0100
Subject: [PATCH 480/930] Update tests to match new expected behaviour

Co-authored-by: Vlad Frangu <me@vladfrangu.dev>
---
 .../Filtering/FilterQueryParserTest.cs        | 45 +++++++++++++++++--
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index bd706b5b4c..ea14412f55 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -273,12 +273,21 @@ namespace osu.Game.Tests.NonVisual.Filtering
         }
 
         [Test]
-        public void TestApplyStatusMatches()
+        public void TestApplyMultipleEqualityStatusQueries()
         {
             const string query = "status=ranked status=loved";
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
-            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Is.Empty);
+        }
+
+        [Test]
+        public void TestApplyEqualStatusQueryWithMultipleValues()
+        {
+            const string query = "status=ranked,loved";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.That(filterCriteria.OnlineStatus.Values, Is.Not.Empty);
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Loved));
         }
@@ -289,13 +298,43 @@ namespace osu.Game.Tests.NonVisual.Filtering
             const string query = "status>=r";
             var filterCriteria = new FilterCriteria();
             FilterQueryParser.ApplyQueries(filterCriteria, query);
-            Assert.IsNotEmpty(filterCriteria.OnlineStatus.Values);
+            Assert.That(filterCriteria.OnlineStatus.Values, Has.Count.EqualTo(4));
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Ranked));
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Approved));
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Qualified));
             Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Loved));
         }
 
+        [Test]
+        public void TestApplyRangeStatusWithMultipleMatchesQuery()
+        {
+            const string query = "status>=r,l";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.That(filterCriteria.OnlineStatus.Values, Is.EquivalentTo(Enum.GetValues<BeatmapOnlineStatus>()));
+        }
+
+        [Test]
+        public void TestApplyTwoRangeStatusQuery()
+        {
+            const string query = "status>r status<l";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.That(filterCriteria.OnlineStatus.Values, Has.Count.EqualTo(2));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Approved));
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Qualified));
+        }
+
+        [Test]
+        public void TestApplyRangeAndEqualStatusQuery()
+        {
+            const string query = "status>r status=loved";
+            var filterCriteria = new FilterCriteria();
+            FilterQueryParser.ApplyQueries(filterCriteria, query);
+            Assert.That(filterCriteria.OnlineStatus.Values, Is.Not.Empty);
+            Assert.That(filterCriteria.OnlineStatus.Values, Contains.Item(BeatmapOnlineStatus.Loved));
+        }
+
         [TestCase("creator")]
         [TestCase("author")]
         [TestCase("mapper")]

From e52d51cd0a8c102755bd3ef94beccb69580b36c0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 12:20:38 +0100
Subject: [PATCH 481/930] Update `OptionalSet` implementation to intersect
 across multiple filters rather than union

---
 osu.Game/Screens/Select/FilterCriteria.cs    |  9 +-
 osu.Game/Screens/Select/FilterQueryParser.cs | 86 ++++++++++++--------
 2 files changed, 56 insertions(+), 39 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 6750b07aba..01b0e9b7d9 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -114,17 +114,18 @@ namespace osu.Game.Screens.Select
 
         public IRulesetFilterCriteria? RulesetCriteria { get; set; }
 
-        public struct OptionalSet<T> : IEquatable<OptionalSet<T>>
-            where T : struct
+        public readonly struct OptionalSet<T> : IEquatable<OptionalSet<T>>
+            where T : struct, Enum
         {
-            public bool HasFilter => Values.Count > 0;
+            public bool HasFilter => true;
 
             public bool IsInRange(T value) => Values.Contains(value);
 
-            public HashSet<T> Values = new HashSet<T>();
+            public HashSet<T> Values { get; }
 
             public OptionalSet()
             {
+                Values = Enum.GetValues<T>().ToHashSet();
             }
 
             public bool Equals(OptionalSet<T> other) => Values.SetEquals(other.Values);
diff --git a/osu.Game/Screens/Select/FilterQueryParser.cs b/osu.Game/Screens/Select/FilterQueryParser.cs
index 32b533e18d..4e49495f47 100644
--- a/osu.Game/Screens/Select/FilterQueryParser.cs
+++ b/osu.Game/Screens/Select/FilterQueryParser.cs
@@ -69,7 +69,7 @@ namespace osu.Game.Screens.Select
                     return TryUpdateCriteriaRange(ref criteria.BeatDivisor, op, value, tryParseInt);
 
                 case "status":
-                    return TryUpdateCriteriaSet(ref criteria.OnlineStatus, op, value, tryParseEnum);
+                    return TryUpdateCriteriaSet(ref criteria.OnlineStatus, op, value);
 
                 case "creator":
                 case "author":
@@ -302,54 +302,70 @@ namespace osu.Game.Screens.Select
 
         /// <summary>
         /// Attempts to parse a keyword filter of type <typeparamref name="T"/>,
-        /// from the specified <paramref name="op"/> and <paramref name="val"/>.
-        /// If <paramref name="val"/> can be parsed into <typeparamref name="T"/> using <paramref name="parseFunction"/>, the function returns <c>true</c>
+        /// from the specified <paramref name="op"/> and <paramref name="filterValue"/>.
+        /// If <paramref name="filterValue"/> can be parsed successfully, the function returns <c>true</c>
         /// and the resulting range constraint is stored into the <paramref name="range"/>'s expected values.
         /// </summary>
         /// <param name="range">The <see cref="FilterCriteria.OptionalSet{T}"/> to store the parsed data into, if successful.</param>
         /// <param name="op">The operator for the keyword filter.</param>
-        /// <param name="val">The value of the keyword filter.</param>
-        /// <param name="parseFunction">Function used to determine if <paramref name="val"/> can be converted to type <typeparamref name="T"/>.</param>
-        public static bool TryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string val, TryParseFunction<T> parseFunction)
-            where T : struct, Enum
-            => parseFunction.Invoke(val, out var converted) && tryUpdateCriteriaSet(ref range, op, converted);
-
-        private static bool tryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, T pivotValue)
+        /// <param name="filterValue">The value of the keyword filter.</param>
+        public static bool TryUpdateCriteriaSet<T>(ref FilterCriteria.OptionalSet<T> range, Operator op, string filterValue)
             where T : struct, Enum
         {
-            var allDefinedValues = Enum.GetValues<T>();
+            var matchingValues = new HashSet<T>();
 
-            foreach (var val in allDefinedValues)
+            if (op == Operator.Equal && filterValue.Contains(','))
             {
-                int compareResult = Comparer<T>.Default.Compare(val, pivotValue);
+                string[] splitValues = filterValue.Split(',', StringSplitOptions.RemoveEmptyEntries | StringSplitOptions.TrimEntries);
 
-                switch (op)
+                foreach (string splitValue in splitValues)
                 {
-                    case Operator.Less:
-                        if (compareResult < 0) range.Values.Add(val);
-                        break;
-
-                    case Operator.LessOrEqual:
-                        if (compareResult <= 0) range.Values.Add(val);
-                        break;
-
-                    case Operator.Equal:
-                        if (compareResult == 0) range.Values.Add(val);
-                        break;
-
-                    case Operator.GreaterOrEqual:
-                        if (compareResult >= 0) range.Values.Add(val);
-                        break;
-
-                    case Operator.Greater:
-                        if (compareResult > 0) range.Values.Add(val);
-                        break;
-
-                    default:
+                    if (!tryParseEnum<T>(splitValue, out var parsedValue))
                         return false;
+
+                    matchingValues.Add(parsedValue);
+                }
+            }
+            else
+            {
+                if (!tryParseEnum<T>(filterValue, out var pivotValue))
+                    return false;
+
+                var allDefinedValues = Enum.GetValues<T>();
+
+                foreach (var val in allDefinedValues)
+                {
+                    int compareResult = Comparer<T>.Default.Compare(val, pivotValue);
+
+                    switch (op)
+                    {
+                        case Operator.Less:
+                            if (compareResult < 0) matchingValues.Add(val);
+                            break;
+
+                        case Operator.LessOrEqual:
+                            if (compareResult <= 0) matchingValues.Add(val);
+                            break;
+
+                        case Operator.Equal:
+                            if (compareResult == 0) matchingValues.Add(val);
+                            break;
+
+                        case Operator.GreaterOrEqual:
+                            if (compareResult >= 0) matchingValues.Add(val);
+                            break;
+
+                        case Operator.Greater:
+                            if (compareResult > 0) matchingValues.Add(val);
+                            break;
+
+                        default:
+                            return false;
+                    }
                 }
             }
 
+            range.Values.IntersectWith(matchingValues);
             return true;
         }
 

From 9474156df4bb33bda65c0bd2d68d565825f1b3d1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 20:21:12 +0800
Subject: [PATCH 482/930] Improve equality implementations

---
 .../API/Requests/Responses/APIMenuContent.cs    | 10 +---------
 .../API/Requests/Responses/APIMenuImage.cs      | 17 +++++------------
 2 files changed, 6 insertions(+), 21 deletions(-)

diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
index 7b53488030..6aad0f6c87 100644
--- a/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuContent.cs
@@ -23,15 +23,7 @@ namespace osu.Game.Online.API.Requests.Responses
             return Images.SequenceEqual(other.Images);
         }
 
-        public override bool Equals(object? obj)
-        {
-            if (ReferenceEquals(null, obj)) return false;
-            if (ReferenceEquals(this, obj)) return true;
-
-            if (obj.GetType() != GetType()) return false;
-
-            return Equals((APIMenuContent)obj);
-        }
+        public override bool Equals(object? other) => other is APIMenuContent content && Equals(content);
 
         public override int GetHashCode()
         {
diff --git a/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
index 42129ca96e..8aff08099a 100644
--- a/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
+++ b/osu.Game/Online/API/Requests/Responses/APIMenuImage.cs
@@ -28,34 +28,27 @@ namespace osu.Game.Online.API.Requests.Responses
         /// The time at which this item should begin displaying. If <c>null</c>, will display immediately.
         /// </summary>
         [JsonProperty(@"begins")]
-        public DateTimeOffset? Begins { get; set; }
+        public DateTimeOffset? Begins { get; init; }
 
         /// <summary>
         /// The time at which this item should stop displaying. If <c>null</c>, will display indefinitely.
         /// </summary>
         [JsonProperty(@"expires")]
-        public DateTimeOffset? Expires { get; set; }
+        public DateTimeOffset? Expires { get; init; }
 
         public bool Equals(APIMenuImage? other)
         {
             if (ReferenceEquals(null, other)) return false;
             if (ReferenceEquals(this, other)) return true;
 
-            return Image == other.Image && Url == other.Url;
+            return Image == other.Image && Url == other.Url && Begins == other.Begins && Expires == other.Expires;
         }
 
-        public override bool Equals(object? obj)
-        {
-            if (ReferenceEquals(null, obj)) return false;
-            if (ReferenceEquals(this, obj)) return true;
-            if (obj.GetType() != GetType()) return false;
-
-            return Equals((APIMenuImage)obj);
-        }
+        public override bool Equals(object? other) => other is APIMenuImage content && Equals(content);
 
         public override int GetHashCode()
         {
-            return HashCode.Combine(Image, Url);
+            return HashCode.Combine(Image, Url, Begins, Expires);
         }
     }
 }

From fd649edabae36603cccfc8a847a81de05b32f257 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 20:21:48 +0800
Subject: [PATCH 483/930] Also don't rotate images during a drag operation

---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 37bec7aa63..260c021719 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -120,8 +120,8 @@ namespace osu.Game.Screens.Menu
         {
             nextDisplay?.Cancel();
 
-            // If the user is hovering a banner, don't rotate yet.
-            bool anyHovered = content.Any(i => i.IsHovered);
+            // If the user is interacting with a banner, don't rotate yet.
+            bool anyHovered = content.Any(i => i.IsHovered || i.IsDragged);
 
             if (!anyHovered)
             {
@@ -242,6 +242,8 @@ namespace osu.Game.Screens.Menu
                     .ScaleTo(1, 500, Easing.OutElastic);
                 base.OnMouseUp(e);
             }
+
+            protected override bool OnDragStart(DragStartEvent e) => true;
         }
     }
 }

From e77d4c8cfaf66e1e717b0094632a3704b77e73f0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 20:28:03 +0800
Subject: [PATCH 484/930] Remove unnecessary `Math.Max`

---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 260c021719..6f98b73939 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -130,8 +130,8 @@ namespace osu.Game.Screens.Menu
                 // To handle expiration simply, arrange all images in best-next order.
                 // Fade in the first valid one, then handle fading out the last if required.
                 var currentRotation = content
-                                      .Skip(Math.Max(0, previousIndex) + 1)
-                                      .Concat(content.Take(Math.Max(0, previousIndex) + 1));
+                                      .Skip(previousIndex + 1)
+                                      .Concat(content.Take(previousIndex + 1));
 
                 // After the loop, displayIndex will be the new valid index or -1 if
                 // none valid.

From dee88573a756f9652628d13f2033cd4b78244870 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 13:44:12 +0100
Subject: [PATCH 485/930] Fix test failure in visual browser

I'm not sure why it's failing headless and I'm not particularly
interested in finding that out right now.
---
 osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index 380085ce04..60e42838d8 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -9,6 +9,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Testing;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Screens.Menu;
+using osuTK;
 
 namespace osu.Game.Tests.Visual.Menus
 {
@@ -95,7 +96,7 @@ namespace osu.Game.Tests.Visual.Menus
                 }
             });
 
-            AddUntilStep("wait for no image shown", () => !onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Any());
+            AddUntilStep("wait for no image shown", () => onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Single().Size, () => Is.EqualTo(Vector2.Zero));
 
             AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
 

From b4ccbc68e447f0dba68470d70510195bfad009f5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 21:20:22 +0800
Subject: [PATCH 486/930] Fix failing test

---
 osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
index 60e42838d8..0b90fd13c3 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneOnlineMenuBanner.cs
@@ -96,7 +96,7 @@ namespace osu.Game.Tests.Visual.Menus
                 }
             });
 
-            AddUntilStep("wait for no image shown", () => onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().Single().Size, () => Is.EqualTo(Vector2.Zero));
+            AddUntilStep("wait for no image shown", () => onlineMenuBanner.ChildrenOfType<OnlineMenuBanner.MenuImage>().SingleOrDefault()?.Size, () => Is.EqualTo(Vector2.Zero));
 
             AddStep("unset system title", () => onlineMenuBanner.Current.Value = new APIMenuContent());
 

From a5f15a119e325f954e8f5358227269a99dec4e5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 22:51:54 +0800
Subject: [PATCH 487/930] Apply rate adjust fix in all cases rather than
 specifically for `Clock.Rate == 1`

---
 osu.Game/Graphics/Containers/BeatSyncedContainer.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index a14dfd4d64..de9a5aff3a 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -96,10 +96,8 @@ namespace osu.Game.Graphics.Containers
                 // In the case of gameplay, we are usually within a hierarchy with the correct rate applied to our `Drawable.Clock`.
                 // This means that the amount of early adjustment is adjusted in line with audio track rate changes.
                 // But other cases like the osu! logo at the main menu won't correctly have this rate information.
-                //
-                // So for cases where the rate of the source isn't in sync with our hierarchy, let's assume we need to account for it locally.
-                if (Clock.Rate == 1 && BeatSyncSource.Clock.Rate != Clock.Rate)
-                    early *= BeatSyncSource.Clock.Rate;
+                // We can adjust here to ensure the applied early activation always matches expectations.
+                early *= BeatSyncSource.Clock.Rate / Clock.Rate;
 
                 currentTrackTime = BeatSyncSource.Clock.CurrentTime + early;
 

From 4c1a1b54be7ffab08eb6e2713dbeca953f15044c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 27 Mar 2024 00:07:51 +0900
Subject: [PATCH 488/930] Fix NVAPI startup exception on non-Windows platforms

---
 osu.Desktop/NVAPI.cs   | 2 ++
 osu.Desktop/Program.cs | 3 ++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/NVAPI.cs b/osu.Desktop/NVAPI.cs
index 78a814c585..554f89a847 100644
--- a/osu.Desktop/NVAPI.cs
+++ b/osu.Desktop/NVAPI.cs
@@ -8,11 +8,13 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Runtime.InteropServices;
+using System.Runtime.Versioning;
 using osu.Framework.Logging;
 
 namespace osu.Desktop
 {
     [SuppressMessage("ReSharper", "InconsistentNaming")]
+    [SupportedOSPlatform("windows")]
     internal static class NVAPI
     {
         private const string osu_filename = "osu!.exe";
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 73670adc49..2d7ec5aa5f 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -70,7 +70,8 @@ namespace osu.Desktop
             // NVIDIA profiles are based on the executable name of a process.
             // Lazer and stable share the same executable name.
             // Stable sets this setting to "Off", which may not be what we want, so let's force it back to the default "Auto" on startup.
-            NVAPI.ThreadedOptimisations = NvThreadControlSetting.OGL_THREAD_CONTROL_DEFAULT;
+            if (OperatingSystem.IsWindows())
+                NVAPI.ThreadedOptimisations = NvThreadControlSetting.OGL_THREAD_CONTROL_DEFAULT;
 
             // Back up the cwd before DesktopGameHost changes it
             string cwd = Environment.CurrentDirectory;

From 01a72d5afaa788e707308bea0764565ad1b044e6 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 26 Mar 2024 12:10:40 -0300
Subject: [PATCH 489/930] Fix combo not reversing properly depending on the
 order of selection

---
 .../Edit/CatchSelectionHandler.cs               | 17 +++++++++--------
 .../Edit/OsuSelectionHandler.cs                 | 17 +++++++++--------
 2 files changed, 18 insertions(+), 16 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index e3d2347c4d..f8fe9805e6 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -76,17 +76,15 @@ namespace osu.Game.Rulesets.Catch.Edit
 
         public override bool HandleReverse()
         {
-            var hitObjects = EditorBeatmap.SelectedHitObjects;
+            var hitObjects = EditorBeatmap.SelectedHitObjects
+                .OfType<CatchHitObject>()
+                .OrderBy(obj => obj.StartTime)
+                .ToList();
 
             double selectionStartTime = SelectedItems.Min(h => h.StartTime);
             double selectionEndTime = SelectedItems.Max(h => h.GetEndTime());
 
-            var newComboOrder = hitObjects
-                .OfType<CatchHitObject>()
-                .Select(obj => obj.NewCombo)
-                .ToList();
-
-            newComboOrder.Reverse();
+            var newComboOrder = hitObjects.Select(obj => obj.NewCombo).ToList();
 
             foreach (var h in hitObjects)
             {
@@ -101,10 +99,13 @@ namespace osu.Game.Rulesets.Catch.Edit
                 }
             }
 
+            // re-order objects again after flipping their times
+            hitObjects = [.. hitObjects.OrderBy(obj => obj.StartTime)];
+
             int i = 0;
             foreach (bool newCombo in newComboOrder)
             {
-                hitObjects.OfType<CatchHitObject>().ToList()[i].NewCombo = newCombo;
+                hitObjects[i].NewCombo = newCombo;
                 i++;
             }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index df39ab8fce..0e889cab81 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -78,19 +78,17 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         public override bool HandleReverse()
         {
-            var hitObjects = EditorBeatmap.SelectedHitObjects;
+            var hitObjects = EditorBeatmap.SelectedHitObjects
+                .OfType<OsuHitObject>()
+                .OrderBy(obj => obj.StartTime)
+                .ToList();
 
             double endTime = hitObjects.Max(h => h.GetEndTime());
             double startTime = hitObjects.Min(h => h.StartTime);
 
             bool moreThanOneObject = hitObjects.Count > 1;
 
-            var newComboOrder = hitObjects
-                .OfType<OsuHitObject>()
-                .Select(obj => obj.NewCombo)
-                .ToList();
-
-            newComboOrder.Reverse();
+            var newComboOrder = hitObjects.Select(obj => obj.NewCombo).ToList();
 
             foreach (var h in hitObjects)
             {
@@ -104,10 +102,13 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             }
 
+            // re-order objects again after flipping their times
+            hitObjects = [.. hitObjects.OrderBy(obj => obj.StartTime)];
+
             int i = 0;
             foreach (bool newCombo in newComboOrder)
             {
-                hitObjects.OfType<OsuHitObject>().ToList()[i].NewCombo = newCombo;
+                hitObjects[i].NewCombo = newCombo;
                 i++;
             }
 

From e02ad6cf94d3a9bba0cbcac6ecee5a0125f9da89 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 26 Mar 2024 23:38:34 +0800
Subject: [PATCH 490/930] Fix test regression

---
 osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModTouchDevice.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModTouchDevice.cs b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModTouchDevice.cs
index fdb1cac3e5..8c81431770 100644
--- a/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModTouchDevice.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Mods/TestSceneOsuModTouchDevice.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Mods
         private SessionStatics statics { get; set; } = null!;
 
         private ScoreAccessibleSoloPlayer currentPlayer = null!;
-        private readonly ManualClock manualClock = new ManualClock { Rate = 0 };
+        private readonly ManualClock manualClock = new ManualClock { Rate = 1 };
 
         protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard? storyboard = null)
             => new ClockBackedTestWorkingBeatmap(beatmap, storyboard, new FramedClock(manualClock), Audio);

From 0b29a762b8aa712d1a0b697f367ae809a0896f15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 26 Mar 2024 17:36:00 +0100
Subject: [PATCH 491/930] Add precautionary guard to avoid potential
 div-by-zero

Probably wouldn't happen outside of tests, but I'd rather not find out
next release.
---
 osu.Game/Graphics/Containers/BeatSyncedContainer.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
index de9a5aff3a..7210371ebf 100644
--- a/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
+++ b/osu.Game/Graphics/Containers/BeatSyncedContainer.cs
@@ -97,7 +97,8 @@ namespace osu.Game.Graphics.Containers
                 // This means that the amount of early adjustment is adjusted in line with audio track rate changes.
                 // But other cases like the osu! logo at the main menu won't correctly have this rate information.
                 // We can adjust here to ensure the applied early activation always matches expectations.
-                early *= BeatSyncSource.Clock.Rate / Clock.Rate;
+                if (Clock.Rate > 0)
+                    early *= BeatSyncSource.Clock.Rate / Clock.Rate;
 
                 currentTrackTime = BeatSyncSource.Clock.CurrentTime + early;
 

From 600098d845611a45147154690cc09f992c961119 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 27 Mar 2024 04:05:04 +0900
Subject: [PATCH 492/930] Fix bulbs on Catmull sliders

---
 osu.Game/Rulesets/Objects/SliderPath.cs | 68 +++++++++++++++++++++++--
 1 file changed, 64 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Objects/SliderPath.cs b/osu.Game/Rulesets/Objects/SliderPath.cs
index f33a07f082..5398d6c45f 100644
--- a/osu.Game/Rulesets/Objects/SliderPath.cs
+++ b/osu.Game/Rulesets/Objects/SliderPath.cs
@@ -42,6 +42,17 @@ namespace osu.Game.Rulesets.Objects
         private readonly List<double> cumulativeLength = new List<double>();
         private readonly Cached pathCache = new Cached();
 
+        /// <summary>
+        /// Any additional length of the path which was optimised out during piecewise approximation, but should still be considered as part of <see cref="calculatedLength"/>.
+        /// </summary>
+        /// <remarks>
+        /// This is a hack for Catmull paths.
+        /// </remarks>
+        private double optimisedLength;
+
+        /// <summary>
+        /// The final calculated length of the path.
+        /// </summary>
         private double calculatedLength;
 
         private readonly List<int> segmentEnds = new List<int>();
@@ -244,6 +255,7 @@ namespace osu.Game.Rulesets.Objects
         {
             calculatedPath.Clear();
             segmentEnds.Clear();
+            optimisedLength = 0;
 
             if (ControlPoints.Count == 0)
                 return;
@@ -268,7 +280,8 @@ namespace osu.Game.Rulesets.Objects
                     calculatedPath.Add(segmentVertices[0]);
                 else if (segmentVertices.Length > 1)
                 {
-                    List<Vector2> subPath = calculateSubPath(segmentVertices, segmentType);
+                    List<Vector2> subPath = calculateSubPath(segmentVertices, segmentType, ref optimisedLength);
+
                     // Skip the first vertex if it is the same as the last vertex from the previous segment
                     bool skipFirst = calculatedPath.Count > 0 && subPath.Count > 0 && calculatedPath.Last() == subPath[0];
 
@@ -287,7 +300,7 @@ namespace osu.Game.Rulesets.Objects
             }
         }
 
-        private List<Vector2> calculateSubPath(ReadOnlySpan<Vector2> subControlPoints, PathType type)
+        private static List<Vector2> calculateSubPath(ReadOnlySpan<Vector2> subControlPoints, PathType type, ref double optimisedLength)
         {
             switch (type.Type)
             {
@@ -295,6 +308,7 @@ namespace osu.Game.Rulesets.Objects
                     return PathApproximator.LinearToPiecewiseLinear(subControlPoints);
 
                 case SplineType.PerfectCurve:
+                {
                     if (subControlPoints.Length != 3)
                         break;
 
@@ -305,9 +319,55 @@ namespace osu.Game.Rulesets.Objects
                         break;
 
                     return subPath;
+                }
 
                 case SplineType.Catmull:
-                    return PathApproximator.CatmullToPiecewiseLinear(subControlPoints);
+                {
+                    List<Vector2> subPath = PathApproximator.CatmullToPiecewiseLinear(subControlPoints);
+
+                    // At draw time, osu!stable optimises paths by only keeping piecewise segments that are 6px apart.
+                    // For the most part we don't care about this optimisation, and its additional heuristics are hard to reproduce in every implementation.
+                    //
+                    // However, it matters for Catmull paths which form "bulbs" around sequential knots with identical positions,
+                    // so we'll apply a very basic form of the optimisation here and return a length representing the optimised portion.
+                    // The returned length is important so that the optimisation doesn't cause the path to get extended to match the value of ExpectedDistance.
+
+                    List<Vector2> optimisedPath = new List<Vector2>(subPath.Count);
+
+                    Vector2? lastStart = null;
+                    double lengthRemovedSinceStart = 0;
+
+                    for (int i = 0; i < subPath.Count; i++)
+                    {
+                        if (lastStart == null)
+                        {
+                            optimisedPath.Add(subPath[i]);
+                            lastStart = subPath[i];
+                            continue;
+                        }
+
+                        Debug.Assert(i > 0);
+
+                        double distFromStart = Vector2.Distance(lastStart.Value, subPath[i]);
+                        lengthRemovedSinceStart += Vector2.Distance(subPath[i - 1], subPath[i]);
+
+                        // See PathApproximator.catmull_detail.
+                        const int catmull_detail = 50;
+                        const int catmull_segment_length = catmull_detail * 2;
+
+                        // Either 6px from the start, the last vertex at every knot, or the end of the path.
+                        if (distFromStart > 6 || (i + 1) % catmull_segment_length == 0 || i == subPath.Count - 1)
+                        {
+                            optimisedPath.Add(subPath[i]);
+                            optimisedLength += lengthRemovedSinceStart - distFromStart;
+
+                            lastStart = null;
+                            lengthRemovedSinceStart = 0;
+                        }
+                    }
+
+                    return optimisedPath;
+                }
             }
 
             return PathApproximator.BSplineToPiecewiseLinear(subControlPoints, type.Degree ?? subControlPoints.Length);
@@ -315,7 +375,7 @@ namespace osu.Game.Rulesets.Objects
 
         private void calculateLength()
         {
-            calculatedLength = 0;
+            calculatedLength = optimisedLength;
             cumulativeLength.Clear();
             cumulativeLength.Add(0);
 

From 4490dbf8960214dcc9d3f67dbfc88ab5255c6e94 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 27 Mar 2024 13:37:47 +0900
Subject: [PATCH 493/930] Update diffcalc workflow

---
 .github/workflows/diffcalc.yml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/diffcalc.yml b/.github/workflows/diffcalc.yml
index 7a2dcecb9c..2ed176fe8d 100644
--- a/.github/workflows/diffcalc.yml
+++ b/.github/workflows/diffcalc.yml
@@ -110,10 +110,14 @@ jobs:
     if: ${{ github.event_name == 'workflow_dispatch' || contains(github.event.comment.body, '!diffcalc') }}
     steps:
       - name: Check permissions
-        if: ${{ github.event_name != 'workflow_dispatch' }}
-        uses: actions-cool/check-user-permission@a0668c9aec87f3875fc56170b6452a453e9dd819 # v2.2.0
-        with:
-          require: 'write'
+        run: |
+          ALLOWED_USERS=(smoogipoo peppy bdach)
+          for i in "${ALLOWED_USERS[@]}"; do
+              if [[ "${{ github.actor }}" == "$i" ]]; then
+                  exit 0
+              fi
+          done
+          exit 1
 
   create-comment:
     name: Create PR comment

From 60c93d2c6de6690913ba6f9552615116c2470a29 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 27 Mar 2024 08:22:51 -0300
Subject: [PATCH 494/930] Add reverse pattern visual tests

---
 .../Editor/TestSceneCatchReverseSelection.cs  | 313 ++++++++++++++++
 .../Editor/TestSceneOsuReverseSelection.cs    | 347 ++++++++++++++++++
 2 files changed, 660 insertions(+)
 create mode 100644 osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
 create mode 100644 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
new file mode 100644
index 0000000000..c8a48f76eb
--- /dev/null
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
@@ -0,0 +1,313 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Catch.Objects;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Catch.Tests.Editor
+{
+    [TestFixture]
+    public partial class TestSceneCatchReverseSelection : TestSceneEditor
+    {
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset, false);
+
+        [Test]
+        public void TestReverseSelectionTwoFruits()
+        {
+            float fruit1OldX = default;
+            float fruit2OldX = default;
+
+            addObjects([
+                new Fruit
+                {
+                    StartTime = 200,
+                    X = fruit1OldX = 0,
+                },
+                new Fruit
+                {
+                    StartTime = 400,
+                    X = fruit2OldX = 20,
+                }
+            ]);
+
+            selectEverything();
+            reverseSelection();
+
+            AddAssert("fruit1 is at fruit2's X",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
+                () => Is.EqualTo(fruit2OldX)
+            );
+
+            AddAssert("fruit2 is at fruit1's X",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
+                () => Is.EqualTo(fruit1OldX)
+            );
+
+            AddAssert("fruit2 is not a new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionThreeFruits()
+        {
+            float fruit1OldX = default;
+            float fruit2OldX = default;
+            float fruit3OldX = default;
+
+            addObjects([
+                new Fruit
+                {
+                    StartTime = 200,
+                    X = fruit1OldX = 0,
+                },
+                new Fruit
+                {
+                    StartTime = 400,
+                    X = fruit2OldX = 20,
+                },
+                new Fruit
+                {
+                    StartTime = 600,
+                    X = fruit3OldX = 40,
+                }
+            ]);
+
+            selectEverything();
+            reverseSelection();
+
+            AddAssert("fruit1 is at fruit3's X",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
+                () => Is.EqualTo(fruit3OldX)
+            );
+
+            AddAssert("fruit2's X is unchanged",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
+                () => Is.EqualTo(fruit2OldX)
+            );
+
+            AddAssert("fruit3's is at fruit1's X",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).EffectiveX,
+                () => Is.EqualTo(fruit1OldX)
+            );
+
+            AddAssert("fruit3 is not a new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionFruitAndJuiceStream()
+        {
+            addObjects([
+                new Fruit
+                {
+                    StartTime = 200,
+                    X = 0,
+                },
+                new JuiceStream
+                {
+                    StartTime = 400,
+                    X = 20,
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(),
+                            new PathControlPoint(new Vector2(50))
+                        }
+                    }
+                }
+            ]);
+
+            selectEverything();
+            reverseSelection();
+
+            AddAssert("First element is juice stream",
+                () => EditorBeatmap.HitObjects.First().GetType(),
+                () => Is.EqualTo(typeof(JuiceStream))
+            );
+
+            AddAssert("Last element is fruit",
+                () => EditorBeatmap.HitObjects.Last().GetType(),
+                () => Is.EqualTo(typeof(Fruit))
+            );
+
+            AddAssert("Fruit is not new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionTwoFruitsAndJuiceStream()
+        {
+            addObjects([
+                new Fruit
+                {
+                    StartTime = 200,
+                    X = 0,
+                },
+                new Fruit
+                {
+                    StartTime = 400,
+                    X = 20,
+                },
+                new JuiceStream
+                {
+                    StartTime = 600,
+                    X = 40,
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(),
+                            new PathControlPoint(new Vector2(50))
+                        }
+                    }
+                }
+            ]);
+
+            selectEverything();
+            reverseSelection();
+
+            AddAssert("First element is juice stream",
+                () => EditorBeatmap.HitObjects.First().GetType(),
+                () => Is.EqualTo(typeof(JuiceStream))
+            );
+
+            AddAssert("Middle element is Fruit",
+                () => EditorBeatmap.HitObjects.ElementAt(1).GetType(),
+                () => Is.EqualTo(typeof(Fruit))
+            );
+
+            AddAssert("Last element is Fruit",
+                () => EditorBeatmap.HitObjects.Last().GetType(),
+                () => Is.EqualTo(typeof(Fruit))
+            );
+
+            AddAssert("Last fruit is not new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().Last().NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionTwoCombos()
+        {
+            float fruit1OldX = default;
+            float fruit2OldX = default;
+            float fruit3OldX = default;
+
+            float fruit4OldX = default;
+            float fruit5OldX = default;
+            float fruit6OldX = default;
+
+            addObjects([
+                new Fruit
+                {
+                    StartTime = 200,
+                    X = fruit1OldX = 0,
+                },
+                new Fruit
+                {
+                    StartTime = 400,
+                    X = fruit2OldX = 20,
+                },
+                new Fruit
+                {
+                    StartTime = 600,
+                    X = fruit3OldX = 40,
+                },
+
+                new Fruit
+                {
+                    StartTime = 800,
+                    NewCombo = true,
+                    X = fruit4OldX = 60,
+                },
+                new Fruit
+                {
+                    StartTime = 1000,
+                    X = fruit5OldX = 80,
+                },
+                new Fruit
+                {
+                    StartTime = 1200,
+                    X = fruit6OldX = 100,
+                }
+            ]);
+
+            selectEverything();
+            reverseSelection();
+
+            AddAssert("fruit1 is at fruit6 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
+                () => Is.EqualTo(fruit6OldX)
+            );
+
+            AddAssert("fruit2 is at fruit5 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
+                () => Is.EqualTo(fruit5OldX)
+            );
+
+            AddAssert("fruit3 is at fruit4 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).EffectiveX,
+                () => Is.EqualTo(fruit4OldX)
+            );
+
+            AddAssert("fruit4 is at fruit3 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(3).EffectiveX,
+                () => Is.EqualTo(fruit3OldX)
+            );
+
+            AddAssert("fruit5 is at fruit2 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(4).EffectiveX,
+                () => Is.EqualTo(fruit2OldX)
+            );
+
+            AddAssert("fruit6 is at fruit1 position",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(5).EffectiveX,
+                () => Is.EqualTo(fruit1OldX)
+            );
+
+            AddAssert("fruit1 is new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).NewCombo,
+                () => Is.EqualTo(true)
+            );
+
+            AddAssert("fruit4 is new combo",
+                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(3).NewCombo,
+                () => Is.EqualTo(true)
+            );
+        }
+
+        private void addObjects(CatchHitObject[] hitObjects) => AddStep("Add objects", () => EditorBeatmap.AddRange(hitObjects));
+
+        private void selectEverything()
+        {
+            AddStep("Select everything", () =>
+            {
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+        }
+
+        private void reverseSelection()
+        {
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+        }
+    }
+}
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs
new file mode 100644
index 0000000000..33104288ab
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs
@@ -0,0 +1,347 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Tests.Beatmaps;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Tests.Editor
+{
+    [TestFixture]
+    public partial class TestSceneOsuReverseSelection : TestSceneOsuEditor
+    {
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset) => new TestBeatmap(ruleset, false);
+
+        [Test]
+        public void TestReverseSelectionTwoCircles()
+        {
+            Vector2 circle1OldPosition = default;
+            Vector2 circle2OldPosition = default;
+
+            AddStep("Add circles", () =>
+            {
+                var circle1 = new HitCircle
+                {
+                    StartTime = 0,
+                    Position = circle1OldPosition = new Vector2(208, 240)
+                };
+                var circle2 = new HitCircle
+                {
+                    StartTime = 200,
+                    Position = circle2OldPosition = new Vector2(256, 144)
+                };
+
+                EditorBeatmap.AddRange([circle1, circle2]);
+            });
+
+            AddStep("Select circles", () =>
+            {
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+
+            AddAssert("circle1 is at circle2 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
+                () => Is.EqualTo(circle2OldPosition)
+            );
+
+            AddAssert("circle2 is at circle1 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
+                () => Is.EqualTo(circle1OldPosition)
+            );
+
+            AddAssert("circle2 is not a new combo",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionThreeCircles()
+        {
+            Vector2 circle1OldPosition = default;
+            Vector2 circle2OldPosition = default;
+            Vector2 circle3OldPosition = default;
+
+            AddStep("Add circles", () =>
+            {
+                var circle1 = new HitCircle
+                {
+                    StartTime = 0,
+                    Position = circle1OldPosition = new Vector2(208, 240)
+                };
+                var circle2 = new HitCircle
+                {
+                    StartTime = 200,
+                    Position = circle2OldPosition = new Vector2(256, 144)
+                };
+                var circle3 = new HitCircle
+                {
+                    StartTime = 400,
+                    Position = circle3OldPosition = new Vector2(304, 240)
+                };
+
+                EditorBeatmap.AddRange([circle1, circle2, circle3]);
+            });
+
+            AddStep("Select circles", () =>
+            {
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+
+            AddAssert("circle1 is at circle3 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
+                () => Is.EqualTo(circle3OldPosition)
+            );
+
+            AddAssert("circle3 is at circle1 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).Position,
+                () => Is.EqualTo(circle1OldPosition)
+            );
+
+            AddAssert("circle3 is not a new combo",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).NewCombo,
+                () => Is.EqualTo(false)
+            );
+        }
+
+        [Test]
+        public void TestReverseSelectionCircleAndSlider()
+        {
+            Vector2 circleOldPosition = default;
+            Vector2 sliderHeadOldPosition = default;
+            Vector2 sliderTailOldPosition = default;
+
+            AddStep("Add objects", () =>
+            {
+                var circle = new HitCircle
+                {
+                    StartTime = 0,
+                    Position = circleOldPosition = new Vector2(208, 240)
+                };
+                var slider = new Slider
+                {
+                    StartTime = 200,
+                    Position = sliderHeadOldPosition = new Vector2(257, 144),
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(),
+                            new PathControlPoint(new Vector2(100))
+                        }
+                    }
+                };
+
+                sliderTailOldPosition = slider.EndPosition;
+
+                EditorBeatmap.AddRange([circle, slider]);
+            });
+
+            AddStep("Select objects", () =>
+            {
+                var circle = (HitCircle)EditorBeatmap.HitObjects[0];
+                var slider = (Slider)EditorBeatmap.HitObjects[1];
+
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+
+            AddAssert("circle is at the same position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
+                () => Is.EqualTo(circleOldPosition)
+            );
+
+            AddAssert("Slider head is at slider tail", () =>
+                Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).Position, sliderTailOldPosition) < 1);
+
+            AddAssert("Slider tail is at slider head", () =>
+                Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).EndPosition, sliderHeadOldPosition) < 1);
+        }
+
+        [Test]
+        public void TestReverseSelectionTwoCirclesAndSlider()
+        {
+            Vector2 circle1OldPosition = default;
+            Vector2 circle2OldPosition = default;
+
+            Vector2 sliderHeadOldPosition = default;
+            Vector2 sliderTailOldPosition = default;
+
+            AddStep("Add objects", () =>
+            {
+                var circle1 = new HitCircle
+                {
+                    StartTime = 0,
+                    Position = circle1OldPosition = new Vector2(208, 240)
+                };
+                var circle2 = new HitCircle
+                {
+                    StartTime = 200,
+                    Position = circle2OldPosition = new Vector2(256, 144)
+                };
+                var slider = new Slider
+                {
+                    StartTime = 200,
+                    Position = sliderHeadOldPosition = new Vector2(304, 240),
+                    Path = new SliderPath
+                    {
+                        ControlPoints =
+                        {
+                            new PathControlPoint(),
+                            new PathControlPoint(new Vector2(100))
+                        }
+                    }
+                };
+
+                sliderTailOldPosition = slider.EndPosition;
+
+                EditorBeatmap.AddRange([circle1, circle2, slider]);
+            });
+
+            AddStep("Select objects", () =>
+            {
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+
+            AddAssert("circle1 is at circle2 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
+                () => Is.EqualTo(circle2OldPosition)
+            );
+
+            AddAssert("circle2 is at circle1 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
+                () => Is.EqualTo(circle1OldPosition)
+            );
+
+            AddAssert("Slider head is at slider tail", () =>
+                Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).Position, sliderTailOldPosition) < 1);
+
+            AddAssert("Slider tail is at slider head", () =>
+                Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).EndPosition, sliderHeadOldPosition) < 1);
+        }
+
+        [Test]
+        public void TestReverseSelectionTwoCombos()
+        {
+            Vector2 circle1OldPosition = default;
+            Vector2 circle2OldPosition = default;
+            Vector2 circle3OldPosition = default;
+
+            Vector2 circle4OldPosition = default;
+            Vector2 circle5OldPosition = default;
+            Vector2 circle6OldPosition = default;
+
+            AddStep("Add circles", () =>
+            {
+                var circle1 = new HitCircle
+                {
+                    StartTime = 0,
+                    Position = circle1OldPosition = new Vector2(216, 240)
+                };
+                var circle2 = new HitCircle
+                {
+                    StartTime = 200,
+                    Position = circle2OldPosition = new Vector2(120, 192)
+                };
+                var circle3 = new HitCircle
+                {
+                    StartTime = 400,
+                    Position = circle3OldPosition = new Vector2(216, 144)
+                };
+
+                var circle4 = new HitCircle
+                {
+                    StartTime = 646,
+                    NewCombo = true,
+                    Position = circle4OldPosition = new Vector2(296, 240)
+                };
+                var circle5 = new HitCircle
+                {
+                    StartTime = 846,
+                    Position = circle5OldPosition = new Vector2(392, 162)
+                };
+                var circle6 = new HitCircle
+                {
+                    StartTime = 1046,
+                    Position = circle6OldPosition = new Vector2(296, 144)
+                };
+
+                EditorBeatmap.AddRange([circle1, circle2, circle3, circle4, circle5, circle6]);
+            });
+
+            AddStep("Select circles", () =>
+            {
+                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+            });
+
+            AddStep("Reverse selection", () =>
+            {
+                InputManager.PressKey(Key.LControl);
+                InputManager.Key(Key.G);
+                InputManager.ReleaseKey(Key.LControl);
+            });
+
+            AddAssert("circle1 is at circle6 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
+                () => Is.EqualTo(circle6OldPosition)
+            );
+
+            AddAssert("circle2 is at circle5 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
+                () => Is.EqualTo(circle5OldPosition)
+            );
+
+            AddAssert("circle3 is at circle4 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).Position,
+                () => Is.EqualTo(circle4OldPosition)
+            );
+
+            AddAssert("circle4 is at circle3 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(3).Position,
+                () => Is.EqualTo(circle3OldPosition)
+            );
+
+            AddAssert("circle5 is at circle2 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(4).Position,
+                () => Is.EqualTo(circle2OldPosition)
+            );
+
+            AddAssert("circle6 is at circle1 position",
+                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(5).Position,
+                () => Is.EqualTo(circle1OldPosition)
+            );
+        }
+    }
+}

From 53900d5472ac14a41003f5353bd704e42e245a7b Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Wed, 27 Mar 2024 18:56:26 +0100
Subject: [PATCH 495/930] Fix tests failing locally due to not using invariant
 culture

---
 osu.Game/Skinning/SkinImporter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/SkinImporter.cs b/osu.Game/Skinning/SkinImporter.cs
index 3e948a8afb..59c7f0ba26 100644
--- a/osu.Game/Skinning/SkinImporter.cs
+++ b/osu.Game/Skinning/SkinImporter.cs
@@ -132,7 +132,7 @@ namespace osu.Game.Skinning
             {
                 // skins without a skin.ini are supposed to import using the "latest version" spec.
                 // see https://github.com/peppy/osu-stable-reference/blob/1531237b63392e82c003c712faa028406073aa8f/osu!/Graphics/Skinning/SkinManager.cs#L297-L298
-                newLines.Add($"Version: {SkinConfiguration.LATEST_VERSION}");
+                newLines.Add(FormattableString.Invariant($"Version: {SkinConfiguration.LATEST_VERSION}"));
 
                 // In the case a skin doesn't have a skin.ini yet, let's create one.
                 writeNewSkinIni();

From a9cbabf71135ff97c587a1c01079b56850ef27f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 28 Mar 2024 10:05:26 +0100
Subject: [PATCH 496/930] Simplify tests

---
 .../Editor/TestSceneCatchReverseSelection.cs  | 196 ++++++------------
 .../Editor/TestSceneOsuReverseSelection.cs    | 177 ++++++----------
 2 files changed, 133 insertions(+), 240 deletions(-)

diff --git a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
index c8a48f76eb..36a0e3388e 100644
--- a/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
+++ b/osu.Game.Rulesets.Catch.Tests/Editor/TestSceneCatchReverseSelection.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
@@ -20,93 +21,78 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
         [Test]
         public void TestReverseSelectionTwoFruits()
         {
-            float fruit1OldX = default;
-            float fruit2OldX = default;
+            CatchHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             addObjects([
                 new Fruit
                 {
                     StartTime = 200,
-                    X = fruit1OldX = 0,
+                    X = 0,
                 },
                 new Fruit
                 {
                     StartTime = 400,
-                    X = fruit2OldX = 20,
+                    X = 20,
                 }
             ]);
 
+            AddStep("store objects & new combo data", () =>
+            {
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
+            });
+
             selectEverything();
             reverseSelection();
 
-            AddAssert("fruit1 is at fruit2's X",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
-                () => Is.EqualTo(fruit2OldX)
-            );
-
-            AddAssert("fruit2 is at fruit1's X",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
-                () => Is.EqualTo(fruit1OldX)
-            );
-
-            AddAssert("fruit2 is not a new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionThreeFruits()
         {
-            float fruit1OldX = default;
-            float fruit2OldX = default;
-            float fruit3OldX = default;
+            CatchHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             addObjects([
                 new Fruit
                 {
                     StartTime = 200,
-                    X = fruit1OldX = 0,
+                    X = 0,
                 },
                 new Fruit
                 {
                     StartTime = 400,
-                    X = fruit2OldX = 20,
+                    X = 20,
                 },
                 new Fruit
                 {
                     StartTime = 600,
-                    X = fruit3OldX = 40,
+                    X = 40,
                 }
             ]);
 
+            AddStep("store objects & new combo data", () =>
+            {
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
+            });
+
             selectEverything();
             reverseSelection();
 
-            AddAssert("fruit1 is at fruit3's X",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
-                () => Is.EqualTo(fruit3OldX)
-            );
-
-            AddAssert("fruit2's X is unchanged",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
-                () => Is.EqualTo(fruit2OldX)
-            );
-
-            AddAssert("fruit3's is at fruit1's X",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).EffectiveX,
-                () => Is.EqualTo(fruit1OldX)
-            );
-
-            AddAssert("fruit3 is not a new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionFruitAndJuiceStream()
         {
+            CatchHitObject[] objects = null!;
+            bool[] newCombos = null!;
+
             addObjects([
                 new Fruit
                 {
@@ -128,28 +114,25 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
                 }
             ]);
 
+            AddStep("store objects & new combo data", () =>
+            {
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
+            });
+
             selectEverything();
             reverseSelection();
 
-            AddAssert("First element is juice stream",
-                () => EditorBeatmap.HitObjects.First().GetType(),
-                () => Is.EqualTo(typeof(JuiceStream))
-            );
-
-            AddAssert("Last element is fruit",
-                () => EditorBeatmap.HitObjects.Last().GetType(),
-                () => Is.EqualTo(typeof(Fruit))
-            );
-
-            AddAssert("Fruit is not new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionTwoFruitsAndJuiceStream()
         {
+            CatchHitObject[] objects = null!;
+            bool[] newCombos = null!;
+
             addObjects([
                 new Fruit
                 {
@@ -176,122 +159,79 @@ namespace osu.Game.Rulesets.Catch.Tests.Editor
                 }
             ]);
 
+            AddStep("store objects & new combo data", () =>
+            {
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
+            });
+
             selectEverything();
             reverseSelection();
 
-            AddAssert("First element is juice stream",
-                () => EditorBeatmap.HitObjects.First().GetType(),
-                () => Is.EqualTo(typeof(JuiceStream))
-            );
-
-            AddAssert("Middle element is Fruit",
-                () => EditorBeatmap.HitObjects.ElementAt(1).GetType(),
-                () => Is.EqualTo(typeof(Fruit))
-            );
-
-            AddAssert("Last element is Fruit",
-                () => EditorBeatmap.HitObjects.Last().GetType(),
-                () => Is.EqualTo(typeof(Fruit))
-            );
-
-            AddAssert("Last fruit is not new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().Last().NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionTwoCombos()
         {
-            float fruit1OldX = default;
-            float fruit2OldX = default;
-            float fruit3OldX = default;
-
-            float fruit4OldX = default;
-            float fruit5OldX = default;
-            float fruit6OldX = default;
+            CatchHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             addObjects([
                 new Fruit
                 {
                     StartTime = 200,
-                    X = fruit1OldX = 0,
+                    X = 0,
                 },
                 new Fruit
                 {
                     StartTime = 400,
-                    X = fruit2OldX = 20,
+                    X = 20,
                 },
                 new Fruit
                 {
                     StartTime = 600,
-                    X = fruit3OldX = 40,
+                    X = 40,
                 },
 
                 new Fruit
                 {
                     StartTime = 800,
                     NewCombo = true,
-                    X = fruit4OldX = 60,
+                    X = 60,
                 },
                 new Fruit
                 {
                     StartTime = 1000,
-                    X = fruit5OldX = 80,
+                    X = 80,
                 },
                 new Fruit
                 {
                     StartTime = 1200,
-                    X = fruit6OldX = 100,
+                    X = 100,
                 }
             ]);
 
+            AddStep("store objects & new combo data", () =>
+            {
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
+            });
+
             selectEverything();
             reverseSelection();
 
-            AddAssert("fruit1 is at fruit6 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).EffectiveX,
-                () => Is.EqualTo(fruit6OldX)
-            );
-
-            AddAssert("fruit2 is at fruit5 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(1).EffectiveX,
-                () => Is.EqualTo(fruit5OldX)
-            );
-
-            AddAssert("fruit3 is at fruit4 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(2).EffectiveX,
-                () => Is.EqualTo(fruit4OldX)
-            );
-
-            AddAssert("fruit4 is at fruit3 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(3).EffectiveX,
-                () => Is.EqualTo(fruit3OldX)
-            );
-
-            AddAssert("fruit5 is at fruit2 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(4).EffectiveX,
-                () => Is.EqualTo(fruit2OldX)
-            );
-
-            AddAssert("fruit6 is at fruit1 position",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(5).EffectiveX,
-                () => Is.EqualTo(fruit1OldX)
-            );
-
-            AddAssert("fruit1 is new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(0).NewCombo,
-                () => Is.EqualTo(true)
-            );
-
-            AddAssert("fruit4 is new combo",
-                () => EditorBeatmap.HitObjects.OfType<Fruit>().ElementAt(3).NewCombo,
-                () => Is.EqualTo(true)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         private void addObjects(CatchHitObject[] hitObjects) => AddStep("Add objects", () => EditorBeatmap.AddRange(hitObjects));
 
+        private IEnumerable<CatchHitObject> getObjects() => EditorBeatmap.HitObjects.OfType<CatchHitObject>();
+
+        private IEnumerable<bool> getObjectNewCombos() => getObjects().Select(ho => ho.NewCombo);
+
         private void selectEverything()
         {
             AddStep("Select everything", () =>
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs
index 33104288ab..28c1577fcb 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuReverseSelection.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Game.Beatmaps;
@@ -20,30 +21,33 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Test]
         public void TestReverseSelectionTwoCircles()
         {
-            Vector2 circle1OldPosition = default;
-            Vector2 circle2OldPosition = default;
+            OsuHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             AddStep("Add circles", () =>
             {
                 var circle1 = new HitCircle
                 {
                     StartTime = 0,
-                    Position = circle1OldPosition = new Vector2(208, 240)
+                    Position = new Vector2(208, 240)
                 };
                 var circle2 = new HitCircle
                 {
                     StartTime = 200,
-                    Position = circle2OldPosition = new Vector2(256, 144)
+                    Position = new Vector2(256, 144)
                 };
 
                 EditorBeatmap.AddRange([circle1, circle2]);
             });
 
-            AddStep("Select circles", () =>
+            AddStep("store objects & new combo data", () =>
             {
-                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
             });
 
+            AddStep("Select circles", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+
             AddStep("Reverse selection", () =>
             {
                 InputManager.PressKey(Key.LControl);
@@ -51,55 +55,45 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.ReleaseKey(Key.LControl);
             });
 
-            AddAssert("circle1 is at circle2 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
-                () => Is.EqualTo(circle2OldPosition)
-            );
-
-            AddAssert("circle2 is at circle1 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
-                () => Is.EqualTo(circle1OldPosition)
-            );
-
-            AddAssert("circle2 is not a new combo",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionThreeCircles()
         {
-            Vector2 circle1OldPosition = default;
-            Vector2 circle2OldPosition = default;
-            Vector2 circle3OldPosition = default;
+            OsuHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             AddStep("Add circles", () =>
             {
                 var circle1 = new HitCircle
                 {
                     StartTime = 0,
-                    Position = circle1OldPosition = new Vector2(208, 240)
+                    Position = new Vector2(208, 240)
                 };
                 var circle2 = new HitCircle
                 {
                     StartTime = 200,
-                    Position = circle2OldPosition = new Vector2(256, 144)
+                    Position = new Vector2(256, 144)
                 };
                 var circle3 = new HitCircle
                 {
                     StartTime = 400,
-                    Position = circle3OldPosition = new Vector2(304, 240)
+                    Position = new Vector2(304, 240)
                 };
 
                 EditorBeatmap.AddRange([circle1, circle2, circle3]);
             });
 
-            AddStep("Select circles", () =>
+            AddStep("store objects & new combo data", () =>
             {
-                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
             });
 
+            AddStep("Select circles", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+
             AddStep("Reverse selection", () =>
             {
                 InputManager.PressKey(Key.LControl);
@@ -107,26 +101,16 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.ReleaseKey(Key.LControl);
             });
 
-            AddAssert("circle1 is at circle3 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
-                () => Is.EqualTo(circle3OldPosition)
-            );
-
-            AddAssert("circle3 is at circle1 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).Position,
-                () => Is.EqualTo(circle1OldPosition)
-            );
-
-            AddAssert("circle3 is not a new combo",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).NewCombo,
-                () => Is.EqualTo(false)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
 
         [Test]
         public void TestReverseSelectionCircleAndSlider()
         {
-            Vector2 circleOldPosition = default;
+            OsuHitObject[] objects = null!;
+            bool[] newCombos = null!;
+
             Vector2 sliderHeadOldPosition = default;
             Vector2 sliderTailOldPosition = default;
 
@@ -135,7 +119,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 var circle = new HitCircle
                 {
                     StartTime = 0,
-                    Position = circleOldPosition = new Vector2(208, 240)
+                    Position = new Vector2(208, 240)
                 };
                 var slider = new Slider
                 {
@@ -156,14 +140,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 EditorBeatmap.AddRange([circle, slider]);
             });
 
-            AddStep("Select objects", () =>
+            AddStep("store objects & new combo data", () =>
             {
-                var circle = (HitCircle)EditorBeatmap.HitObjects[0];
-                var slider = (Slider)EditorBeatmap.HitObjects[1];
-
-                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
             });
 
+            AddStep("Select objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+
             AddStep("Reverse selection", () =>
             {
                 InputManager.PressKey(Key.LControl);
@@ -171,10 +155,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.ReleaseKey(Key.LControl);
             });
 
-            AddAssert("circle is at the same position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
-                () => Is.EqualTo(circleOldPosition)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
 
             AddAssert("Slider head is at slider tail", () =>
                 Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).Position, sliderTailOldPosition) < 1);
@@ -186,8 +168,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Test]
         public void TestReverseSelectionTwoCirclesAndSlider()
         {
-            Vector2 circle1OldPosition = default;
-            Vector2 circle2OldPosition = default;
+            OsuHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             Vector2 sliderHeadOldPosition = default;
             Vector2 sliderTailOldPosition = default;
@@ -197,12 +179,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 var circle1 = new HitCircle
                 {
                     StartTime = 0,
-                    Position = circle1OldPosition = new Vector2(208, 240)
+                    Position = new Vector2(208, 240)
                 };
                 var circle2 = new HitCircle
                 {
                     StartTime = 200,
-                    Position = circle2OldPosition = new Vector2(256, 144)
+                    Position = new Vector2(256, 144)
                 };
                 var slider = new Slider
                 {
@@ -223,11 +205,14 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 EditorBeatmap.AddRange([circle1, circle2, slider]);
             });
 
-            AddStep("Select objects", () =>
+            AddStep("store objects & new combo data", () =>
             {
-                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
             });
 
+            AddStep("Select objects", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+
             AddStep("Reverse selection", () =>
             {
                 InputManager.PressKey(Key.LControl);
@@ -235,15 +220,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.ReleaseKey(Key.LControl);
             });
 
-            AddAssert("circle1 is at circle2 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
-                () => Is.EqualTo(circle2OldPosition)
-            );
-
-            AddAssert("circle2 is at circle1 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
-                () => Is.EqualTo(circle1OldPosition)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
 
             AddAssert("Slider head is at slider tail", () =>
                 Vector2.Distance(EditorBeatmap.HitObjects.OfType<Slider>().ElementAt(0).Position, sliderTailOldPosition) < 1);
@@ -255,57 +233,55 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         [Test]
         public void TestReverseSelectionTwoCombos()
         {
-            Vector2 circle1OldPosition = default;
-            Vector2 circle2OldPosition = default;
-            Vector2 circle3OldPosition = default;
-
-            Vector2 circle4OldPosition = default;
-            Vector2 circle5OldPosition = default;
-            Vector2 circle6OldPosition = default;
+            OsuHitObject[] objects = null!;
+            bool[] newCombos = null!;
 
             AddStep("Add circles", () =>
             {
                 var circle1 = new HitCircle
                 {
                     StartTime = 0,
-                    Position = circle1OldPosition = new Vector2(216, 240)
+                    Position = new Vector2(216, 240)
                 };
                 var circle2 = new HitCircle
                 {
                     StartTime = 200,
-                    Position = circle2OldPosition = new Vector2(120, 192)
+                    Position = new Vector2(120, 192)
                 };
                 var circle3 = new HitCircle
                 {
                     StartTime = 400,
-                    Position = circle3OldPosition = new Vector2(216, 144)
+                    Position = new Vector2(216, 144)
                 };
 
                 var circle4 = new HitCircle
                 {
                     StartTime = 646,
                     NewCombo = true,
-                    Position = circle4OldPosition = new Vector2(296, 240)
+                    Position = new Vector2(296, 240)
                 };
                 var circle5 = new HitCircle
                 {
                     StartTime = 846,
-                    Position = circle5OldPosition = new Vector2(392, 162)
+                    Position = new Vector2(392, 162)
                 };
                 var circle6 = new HitCircle
                 {
                     StartTime = 1046,
-                    Position = circle6OldPosition = new Vector2(296, 144)
+                    Position = new Vector2(296, 144)
                 };
 
                 EditorBeatmap.AddRange([circle1, circle2, circle3, circle4, circle5, circle6]);
             });
 
-            AddStep("Select circles", () =>
+            AddStep("store objects & new combo data", () =>
             {
-                EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects);
+                objects = getObjects().ToArray();
+                newCombos = getObjectNewCombos().ToArray();
             });
 
+            AddStep("Select circles", () => EditorBeatmap.SelectedHitObjects.AddRange(EditorBeatmap.HitObjects));
+
             AddStep("Reverse selection", () =>
             {
                 InputManager.PressKey(Key.LControl);
@@ -313,35 +289,12 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 InputManager.ReleaseKey(Key.LControl);
             });
 
-            AddAssert("circle1 is at circle6 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(0).Position,
-                () => Is.EqualTo(circle6OldPosition)
-            );
-
-            AddAssert("circle2 is at circle5 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(1).Position,
-                () => Is.EqualTo(circle5OldPosition)
-            );
-
-            AddAssert("circle3 is at circle4 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(2).Position,
-                () => Is.EqualTo(circle4OldPosition)
-            );
-
-            AddAssert("circle4 is at circle3 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(3).Position,
-                () => Is.EqualTo(circle3OldPosition)
-            );
-
-            AddAssert("circle5 is at circle2 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(4).Position,
-                () => Is.EqualTo(circle2OldPosition)
-            );
-
-            AddAssert("circle6 is at circle1 position",
-                () => EditorBeatmap.HitObjects.OfType<HitCircle>().ElementAt(5).Position,
-                () => Is.EqualTo(circle1OldPosition)
-            );
+            AddAssert("objects reversed", getObjects, () => Is.EqualTo(objects.Reverse()));
+            AddAssert("new combo positions preserved", getObjectNewCombos, () => Is.EqualTo(newCombos));
         }
+
+        private IEnumerable<OsuHitObject> getObjects() => EditorBeatmap.HitObjects.OfType<OsuHitObject>();
+
+        private IEnumerable<bool> getObjectNewCombos() => getObjects().Select(ho => ho.NewCombo);
     }
 }

From 2f786ffc32d925d15d3417f696ac3a046dc2af80 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 28 Mar 2024 10:12:27 +0100
Subject: [PATCH 497/930] Simplify implementation

---
 .../Edit/CatchSelectionHandler.cs             | 21 +++++++++----------
 .../Edit/OsuSelectionHandler.cs               | 21 +++++++++----------
 2 files changed, 20 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
index f8fe9805e6..a2784126eb 100644
--- a/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
+++ b/osu.Game.Rulesets.Catch/Edit/CatchSelectionHandler.cs
@@ -77,13 +77,16 @@ namespace osu.Game.Rulesets.Catch.Edit
         public override bool HandleReverse()
         {
             var hitObjects = EditorBeatmap.SelectedHitObjects
-                .OfType<CatchHitObject>()
-                .OrderBy(obj => obj.StartTime)
-                .ToList();
+                                          .OfType<CatchHitObject>()
+                                          .OrderBy(obj => obj.StartTime)
+                                          .ToList();
 
             double selectionStartTime = SelectedItems.Min(h => h.StartTime);
             double selectionEndTime = SelectedItems.Max(h => h.GetEndTime());
 
+            // the expectation is that even if the objects themselves are reversed temporally,
+            // the position of new combos in the selection should remain the same.
+            // preserve it for later before doing the reversal.
             var newComboOrder = hitObjects.Select(obj => obj.NewCombo).ToList();
 
             foreach (var h in hitObjects)
@@ -99,15 +102,11 @@ namespace osu.Game.Rulesets.Catch.Edit
                 }
             }
 
-            // re-order objects again after flipping their times
-            hitObjects = [.. hitObjects.OrderBy(obj => obj.StartTime)];
+            // re-order objects by start time again after reversing, and restore new combo flag positioning
+            hitObjects = hitObjects.OrderBy(obj => obj.StartTime).ToList();
 
-            int i = 0;
-            foreach (bool newCombo in newComboOrder)
-            {
-                hitObjects[i].NewCombo = newCombo;
-                i++;
-            }
+            for (int i = 0; i < hitObjects.Count; ++i)
+                hitObjects[i].NewCombo = newComboOrder[i];
 
             return true;
         }
diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
index 0e889cab81..b33272968b 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionHandler.cs
@@ -79,15 +79,18 @@ namespace osu.Game.Rulesets.Osu.Edit
         public override bool HandleReverse()
         {
             var hitObjects = EditorBeatmap.SelectedHitObjects
-                .OfType<OsuHitObject>()
-                .OrderBy(obj => obj.StartTime)
-                .ToList();
+                                          .OfType<OsuHitObject>()
+                                          .OrderBy(obj => obj.StartTime)
+                                          .ToList();
 
             double endTime = hitObjects.Max(h => h.GetEndTime());
             double startTime = hitObjects.Min(h => h.StartTime);
 
             bool moreThanOneObject = hitObjects.Count > 1;
 
+            // the expectation is that even if the objects themselves are reversed temporally,
+            // the position of new combos in the selection should remain the same.
+            // preserve it for later before doing the reversal.
             var newComboOrder = hitObjects.Select(obj => obj.NewCombo).ToList();
 
             foreach (var h in hitObjects)
@@ -102,15 +105,11 @@ namespace osu.Game.Rulesets.Osu.Edit
                 }
             }
 
-            // re-order objects again after flipping their times
-            hitObjects = [.. hitObjects.OrderBy(obj => obj.StartTime)];
+            // re-order objects by start time again after reversing, and restore new combo flag positioning
+            hitObjects = hitObjects.OrderBy(obj => obj.StartTime).ToList();
 
-            int i = 0;
-            foreach (bool newCombo in newComboOrder)
-            {
-                hitObjects[i].NewCombo = newCombo;
-                i++;
-            }
+            for (int i = 0; i < hitObjects.Count; ++i)
+                hitObjects[i].NewCombo = newComboOrder[i];
 
             return true;
         }

From 5febd40bd9910f73e65d4bf37b08069833828e7d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 22:30:39 +0900
Subject: [PATCH 498/930] Add HP and AR to
 LegacyBeatmapConversionDifficultyInfo

---
 .../LegacyBeatmapConversionDifficultyInfo.cs     | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Scoring/Legacy/LegacyBeatmapConversionDifficultyInfo.cs b/osu.Game/Rulesets/Scoring/Legacy/LegacyBeatmapConversionDifficultyInfo.cs
index 7d69069455..f8b8567305 100644
--- a/osu.Game/Rulesets/Scoring/Legacy/LegacyBeatmapConversionDifficultyInfo.cs
+++ b/osu.Game/Rulesets/Scoring/Legacy/LegacyBeatmapConversionDifficultyInfo.cs
@@ -18,6 +18,16 @@ namespace osu.Game.Rulesets.Scoring.Legacy
         /// </summary>
         public IRulesetInfo SourceRuleset { get; set; } = new RulesetInfo();
 
+        /// <summary>
+        /// The beatmap drain rate.
+        /// </summary>
+        public float DrainRate { get; set; }
+
+        /// <summary>
+        /// The beatmap approach rate.
+        /// </summary>
+        public float ApproachRate { get; set; }
+
         /// <summary>
         /// The beatmap circle size.
         /// </summary>
@@ -41,8 +51,6 @@ namespace osu.Game.Rulesets.Scoring.Legacy
         /// </summary>
         public int TotalObjectCount { get; set; }
 
-        float IBeatmapDifficultyInfo.DrainRate => 0;
-        float IBeatmapDifficultyInfo.ApproachRate => 0;
         double IBeatmapDifficultyInfo.SliderMultiplier => 0;
         double IBeatmapDifficultyInfo.SliderTickRate => 0;
 
@@ -51,6 +59,8 @@ namespace osu.Game.Rulesets.Scoring.Legacy
         public static LegacyBeatmapConversionDifficultyInfo FromBeatmap(IBeatmap beatmap) => new LegacyBeatmapConversionDifficultyInfo
         {
             SourceRuleset = beatmap.BeatmapInfo.Ruleset,
+            DrainRate = beatmap.Difficulty.DrainRate,
+            ApproachRate = beatmap.Difficulty.ApproachRate,
             CircleSize = beatmap.Difficulty.CircleSize,
             OverallDifficulty = beatmap.Difficulty.OverallDifficulty,
             EndTimeObjectCount = beatmap.HitObjects.Count(h => h is IHasDuration),
@@ -60,6 +70,8 @@ namespace osu.Game.Rulesets.Scoring.Legacy
         public static LegacyBeatmapConversionDifficultyInfo FromBeatmapInfo(IBeatmapInfo beatmapInfo) => new LegacyBeatmapConversionDifficultyInfo
         {
             SourceRuleset = beatmapInfo.Ruleset,
+            DrainRate = beatmapInfo.Difficulty.DrainRate,
+            ApproachRate = beatmapInfo.Difficulty.ApproachRate,
             CircleSize = beatmapInfo.Difficulty.CircleSize,
             OverallDifficulty = beatmapInfo.Difficulty.OverallDifficulty,
             EndTimeObjectCount = beatmapInfo.EndTimeObjectCount,

From 64399e9dd9841b7062e5f218c688424440c00b65 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 22:32:27 +0900
Subject: [PATCH 499/930] Refactor pattern generation to not require
 ManiaBeatmap

---
 .../Beatmaps/ManiaBeatmapConverter.cs         | 30 ++++++++++++++-----
 .../Legacy/EndTimeObjectPatternGenerator.cs   |  4 +--
 .../Legacy/HitObjectPatternGenerator.cs       |  6 ++--
 .../Legacy/PathObjectPatternGenerator.cs      |  4 +--
 .../Patterns/Legacy/PatternGenerator.cs       | 22 +++++---------
 .../Beatmaps/Patterns/PatternGenerator.cs     |  8 ++---
 6 files changed, 41 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index def22608d6..cc975c7def 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -27,8 +27,24 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         private const int max_notes_for_density = 7;
 
+        /// <summary>
+        /// The total number of columns.
+        /// </summary>
+        public int TotalColumns => TargetColumns * (Dual ? 2 : 1);
+
+        /// <summary>
+        /// The number of columns per-stage.
+        /// </summary>
         public int TargetColumns;
+
+        /// <summary>
+        /// Whether to double the number of stages.
+        /// </summary>
         public bool Dual;
+
+        /// <summary>
+        /// Whether the beatmap instantiated with is for the mania ruleset.
+        /// </summary>
         public readonly bool IsForCurrentRuleset;
 
         private readonly int originalTargetColumns;
@@ -152,7 +168,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// <returns>The hit objects generated.</returns>
         private IEnumerable<ManiaHitObject> generateSpecific(HitObject original, IBeatmap originalBeatmap)
         {
-            var generator = new SpecificBeatmapPatternGenerator(Random, original, beatmap, lastPattern, originalBeatmap);
+            var generator = new SpecificBeatmapPatternGenerator(Random, original, originalBeatmap, TotalColumns, lastPattern);
 
             foreach (var newPattern in generator.Generate())
             {
@@ -171,13 +187,13 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// <returns>The hit objects generated.</returns>
         private IEnumerable<ManiaHitObject> generateConverted(HitObject original, IBeatmap originalBeatmap)
         {
-            Patterns.PatternGenerator conversion = null;
+            Patterns.PatternGenerator? conversion = null;
 
             switch (original)
             {
                 case IHasPath:
                 {
-                    var generator = new PathObjectPatternGenerator(Random, original, beatmap, lastPattern, originalBeatmap);
+                    var generator = new PathObjectPatternGenerator(Random, original, originalBeatmap, TotalColumns, lastPattern);
                     conversion = generator;
 
                     var positionData = original as IHasPosition;
@@ -195,7 +211,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
                 case IHasDuration endTimeData:
                 {
-                    conversion = new EndTimeObjectPatternGenerator(Random, original, beatmap, lastPattern, originalBeatmap);
+                    conversion = new EndTimeObjectPatternGenerator(Random, original, originalBeatmap, TotalColumns, lastPattern);
 
                     recordNote(endTimeData.EndTime, new Vector2(256, 192));
                     computeDensity(endTimeData.EndTime);
@@ -206,7 +222,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
                 {
                     computeDensity(original.StartTime);
 
-                    conversion = new HitObjectPatternGenerator(Random, original, beatmap, lastPattern, lastTime, lastPosition, density, lastStair, originalBeatmap);
+                    conversion = new HitObjectPatternGenerator(Random, original, originalBeatmap, TotalColumns, lastPattern, lastTime, lastPosition, density, lastStair);
 
                     recordNote(original.StartTime, positionData.Position);
                     break;
@@ -231,8 +247,8 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         private class SpecificBeatmapPatternGenerator : Patterns.Legacy.PatternGenerator
         {
-            public SpecificBeatmapPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
-                : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
+            public SpecificBeatmapPatternGenerator(LegacyRandom random, HitObject hitObject, IBeatmap beatmap, int totalColumns, Pattern previousPattern)
+                : base(random, hitObject, beatmap, previousPattern, totalColumns)
             {
             }
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
index 2265d3d347..52bb87ae19 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/EndTimeObjectPatternGenerator.cs
@@ -17,8 +17,8 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         private readonly int endTime;
         private readonly PatternType convertType;
 
-        public EndTimeObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
-            : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
+        public EndTimeObjectPatternGenerator(LegacyRandom random, HitObject hitObject, IBeatmap beatmap, int totalColumns, Pattern previousPattern)
+            : base(random, hitObject, beatmap, previousPattern, totalColumns)
         {
             endTime = (int)((HitObject as IHasDuration)?.EndTime ?? 0);
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
index 27cb681300..ad45a3fb21 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/HitObjectPatternGenerator.cs
@@ -23,9 +23,9 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private readonly PatternType convertType;
 
-        public HitObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, double previousTime, Vector2 previousPosition, double density,
-                                         PatternType lastStair, IBeatmap originalBeatmap)
-            : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
+        public HitObjectPatternGenerator(LegacyRandom random, HitObject hitObject, IBeatmap beatmap, int totalColumns, Pattern previousPattern, double previousTime, Vector2 previousPosition,
+                                         double density, PatternType lastStair)
+            : base(random, hitObject, beatmap, previousPattern, totalColumns)
         {
             StairType = lastStair;
 
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PathObjectPatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PathObjectPatternGenerator.cs
index 4922915c7d..6d593a75e7 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PathObjectPatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PathObjectPatternGenerator.cs
@@ -31,8 +31,8 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
 
         private PatternType convertType;
 
-        public PathObjectPatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
-            : base(random, hitObject, beatmap, previousPattern, originalBeatmap)
+        public PathObjectPatternGenerator(LegacyRandom random, HitObject hitObject, IBeatmap beatmap, int totalColumns, Pattern previousPattern)
+            : base(random, hitObject, beatmap, previousPattern, totalColumns)
         {
             convertType = PatternType.None;
             if (!Beatmap.ControlPointInfo.EffectPointAt(hitObject.StartTime).KiaiMode)
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
index 77f93b4ef9..48b8778501 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/Legacy/PatternGenerator.cs
@@ -27,20 +27,12 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
         /// </summary>
         protected readonly LegacyRandom Random;
 
-        /// <summary>
-        /// The beatmap which <see cref="HitObject"/> is being converted from.
-        /// </summary>
-        protected readonly IBeatmap OriginalBeatmap;
-
-        protected PatternGenerator(LegacyRandom random, HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern, IBeatmap originalBeatmap)
-            : base(hitObject, beatmap, previousPattern)
+        protected PatternGenerator(LegacyRandom random, HitObject hitObject, IBeatmap beatmap, Pattern previousPattern, int totalColumns)
+            : base(hitObject, beatmap, totalColumns, previousPattern)
         {
             ArgumentNullException.ThrowIfNull(random);
-            ArgumentNullException.ThrowIfNull(originalBeatmap);
 
             Random = random;
-            OriginalBeatmap = originalBeatmap;
-
             RandomStart = TotalColumns == 8 ? 1 : 0;
         }
 
@@ -104,17 +96,17 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy
                 if (conversionDifficulty != null)
                     return conversionDifficulty.Value;
 
-                HitObject lastObject = OriginalBeatmap.HitObjects.LastOrDefault();
-                HitObject firstObject = OriginalBeatmap.HitObjects.FirstOrDefault();
+                HitObject lastObject = Beatmap.HitObjects.LastOrDefault();
+                HitObject firstObject = Beatmap.HitObjects.FirstOrDefault();
 
                 // Drain time in seconds
-                int drainTime = (int)(((lastObject?.StartTime ?? 0) - (firstObject?.StartTime ?? 0) - OriginalBeatmap.TotalBreakTime) / 1000);
+                int drainTime = (int)(((lastObject?.StartTime ?? 0) - (firstObject?.StartTime ?? 0) - Beatmap.TotalBreakTime) / 1000);
 
                 if (drainTime == 0)
                     drainTime = 10000;
 
-                IBeatmapDifficultyInfo difficulty = OriginalBeatmap.Difficulty;
-                conversionDifficulty = ((difficulty.DrainRate + Math.Clamp(difficulty.ApproachRate, 4, 7)) / 1.5 + (double)OriginalBeatmap.HitObjects.Count / drainTime * 9f) / 38f * 5f / 1.15;
+                IBeatmapDifficultyInfo difficulty = Beatmap.Difficulty;
+                conversionDifficulty = ((difficulty.DrainRate + Math.Clamp(difficulty.ApproachRate, 4, 7)) / 1.5 + (double)Beatmap.HitObjects.Count / drainTime * 9f) / 38f * 5f / 1.15;
                 conversionDifficulty = Math.Min(conversionDifficulty.Value, 12);
 
                 return conversionDifficulty.Value;
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs
index 3d3c35773b..8d98515fa4 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/Patterns/PatternGenerator.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Objects;
 
 namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns
@@ -25,11 +26,11 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns
         /// <summary>
         /// The beatmap which <see cref="HitObject"/> is a part of.
         /// </summary>
-        protected readonly ManiaBeatmap Beatmap;
+        protected readonly IBeatmap Beatmap;
 
         protected readonly int TotalColumns;
 
-        protected PatternGenerator(HitObject hitObject, ManiaBeatmap beatmap, Pattern previousPattern)
+        protected PatternGenerator(HitObject hitObject, IBeatmap beatmap, int totalColumns, Pattern previousPattern)
         {
             ArgumentNullException.ThrowIfNull(hitObject);
             ArgumentNullException.ThrowIfNull(beatmap);
@@ -38,8 +39,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps.Patterns
             HitObject = hitObject;
             Beatmap = beatmap;
             PreviousPattern = previousPattern;
-
-            TotalColumns = Beatmap.TotalColumns;
+            TotalColumns = totalColumns;
         }
 
         /// <summary>

From 10edb5461490568a06f43c443dc6cc7f19b14c8a Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 22:39:15 +0900
Subject: [PATCH 500/930] Add ability to query key count with mods

---
 .../Beatmaps/ManiaBeatmapConverter.cs         | 93 ++++++++++---------
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  4 +-
 osu.Game/Rulesets/ILegacyRuleset.cs           |  5 +-
 .../Carousel/DrawableCarouselBeatmap.cs       |  7 +-
 .../Screens/Select/Details/AdvancedStats.cs   |  2 +-
 5 files changed, 61 insertions(+), 50 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index cc975c7def..8b339239a0 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Game.Rulesets.Mania.Objects;
 using System;
 using System.Linq;
@@ -14,6 +12,7 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns;
 using osu.Game.Rulesets.Mania.Beatmaps.Patterns.Legacy;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Utils;
 using osuTK;
@@ -50,17 +49,21 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         private readonly int originalTargetColumns;
 
         // Internal for testing purposes
-        internal LegacyRandom Random { get; private set; }
+        internal readonly LegacyRandom Random;
 
         private Pattern lastPattern = new Pattern();
 
-        private ManiaBeatmap beatmap;
-
         public ManiaBeatmapConverter(IBeatmap beatmap, Ruleset ruleset)
-            : base(beatmap, ruleset)
+            : this(beatmap, LegacyBeatmapConversionDifficultyInfo.FromBeatmap(beatmap), ruleset)
         {
-            IsForCurrentRuleset = beatmap.BeatmapInfo.Ruleset.Equals(ruleset.RulesetInfo);
-            TargetColumns = GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmap(beatmap));
+        }
+
+        private ManiaBeatmapConverter(IBeatmap? beatmap, LegacyBeatmapConversionDifficultyInfo difficulty, Ruleset ruleset)
+            : base(beatmap!, ruleset)
+        {
+            IsForCurrentRuleset = difficulty.SourceRuleset.Equals(ruleset.RulesetInfo);
+            Random = new LegacyRandom((int)MathF.Round(difficulty.DrainRate + difficulty.CircleSize) * 20 + (int)(difficulty.OverallDifficulty * 41.2) + (int)MathF.Round(difficulty.ApproachRate));
+            TargetColumns = getColumnCount(difficulty);
 
             if (IsForCurrentRuleset && TargetColumns > ManiaRuleset.MAX_STAGE_KEYS)
             {
@@ -69,51 +72,57 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
             }
 
             originalTargetColumns = TargetColumns;
+
+            static int getColumnCount(LegacyBeatmapConversionDifficultyInfo difficulty)
+            {
+                double roundedCircleSize = Math.Round(difficulty.CircleSize);
+
+                if (difficulty.SourceRuleset.ShortName == ManiaRuleset.SHORT_NAME)
+                    return (int)Math.Max(1, roundedCircleSize);
+
+                double roundedOverallDifficulty = Math.Round(difficulty.OverallDifficulty);
+
+                if (difficulty.TotalObjectCount > 0 && difficulty.EndTimeObjectCount >= 0)
+                {
+                    int countSliderOrSpinner = difficulty.EndTimeObjectCount;
+
+                    // In osu!stable, this division appears as if it happens on floats, but due to release-mode
+                    // optimisations, it actually ends up happening on doubles.
+                    double percentSpecialObjects = (double)countSliderOrSpinner / difficulty.TotalObjectCount;
+
+                    if (percentSpecialObjects < 0.2)
+                        return 7;
+                    if (percentSpecialObjects < 0.3 || roundedCircleSize >= 5)
+                        return roundedOverallDifficulty > 5 ? 7 : 6;
+                    if (percentSpecialObjects > 0.6)
+                        return roundedOverallDifficulty > 4 ? 5 : 4;
+                }
+
+                return Math.Max(4, Math.Min((int)roundedOverallDifficulty + 1, 7));
+            }
         }
 
-        public static int GetColumnCount(LegacyBeatmapConversionDifficultyInfo difficulty)
+        public static int GetColumnCount(IBeatmapInfo beatmapInfo, IReadOnlyList<Mod>? mods = null)
+            => GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo), mods);
+
+        public static int GetColumnCount(LegacyBeatmapConversionDifficultyInfo difficulty, IReadOnlyList<Mod>? mods = null)
         {
-            double roundedCircleSize = Math.Round(difficulty.CircleSize);
+            var converter = new ManiaBeatmapConverter(null, difficulty, new ManiaRuleset());
 
-            if (difficulty.SourceRuleset.ShortName == ManiaRuleset.SHORT_NAME)
-                return (int)Math.Max(1, roundedCircleSize);
-
-            double roundedOverallDifficulty = Math.Round(difficulty.OverallDifficulty);
-
-            if (difficulty.TotalObjectCount > 0 && difficulty.EndTimeObjectCount >= 0)
+            if (mods != null)
             {
-                int countSliderOrSpinner = difficulty.EndTimeObjectCount;
-
-                // In osu!stable, this division appears as if it happens on floats, but due to release-mode
-                // optimisations, it actually ends up happening on doubles.
-                double percentSpecialObjects = (double)countSliderOrSpinner / difficulty.TotalObjectCount;
-
-                if (percentSpecialObjects < 0.2)
-                    return 7;
-                if (percentSpecialObjects < 0.3 || roundedCircleSize >= 5)
-                    return roundedOverallDifficulty > 5 ? 7 : 6;
-                if (percentSpecialObjects > 0.6)
-                    return roundedOverallDifficulty > 4 ? 5 : 4;
+                foreach (var m in mods.OfType<IApplicableToBeatmapConverter>())
+                    m.ApplyToBeatmapConverter(converter);
             }
 
-            return Math.Max(4, Math.Min((int)roundedOverallDifficulty + 1, 7));
+            return converter.TotalColumns;
         }
 
         public override bool CanConvert() => Beatmap.HitObjects.All(h => h is IHasXPosition);
 
-        protected override Beatmap<ManiaHitObject> ConvertBeatmap(IBeatmap original, CancellationToken cancellationToken)
-        {
-            IBeatmapDifficultyInfo difficulty = original.Difficulty;
-
-            int seed = (int)MathF.Round(difficulty.DrainRate + difficulty.CircleSize) * 20 + (int)(difficulty.OverallDifficulty * 41.2) + (int)MathF.Round(difficulty.ApproachRate);
-            Random = new LegacyRandom(seed);
-
-            return base.ConvertBeatmap(original, cancellationToken);
-        }
-
         protected override Beatmap<ManiaHitObject> CreateBeatmap()
         {
-            beatmap = new ManiaBeatmap(new StageDefinition(TargetColumns), originalTargetColumns);
+            ManiaBeatmap beatmap = new ManiaBeatmap(new StageDefinition(TargetColumns), originalTargetColumns);
 
             if (Dual)
                 beatmap.Stages.Add(new StageDefinition(TargetColumns));
@@ -131,10 +140,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
             }
 
             var objects = IsForCurrentRuleset ? generateSpecific(original, beatmap) : generateConverted(original, beatmap);
-
-            if (objects == null)
-                yield break;
-
             foreach (ManiaHitObject obj in objects)
                 yield return obj;
         }
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 3d4803f1e4..77168dca68 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -423,8 +423,8 @@ namespace osu.Game.Rulesets.Mania
 
         public override DifficultySection CreateEditorDifficultySection() => new ManiaDifficultySection();
 
-        public int GetKeyCount(IBeatmapInfo beatmapInfo)
-            => ManiaBeatmapConverter.GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo));
+        public int GetKeyCount(IBeatmapInfo beatmapInfo, IReadOnlyList<Mod>? mods = null)
+            => ManiaBeatmapConverter.GetColumnCount(beatmapInfo, mods);
     }
 
     public enum PlayfieldType
diff --git a/osu.Game/Rulesets/ILegacyRuleset.cs b/osu.Game/Rulesets/ILegacyRuleset.cs
index 18d86f477a..e116f7a1a3 100644
--- a/osu.Game/Rulesets/ILegacyRuleset.cs
+++ b/osu.Game/Rulesets/ILegacyRuleset.cs
@@ -1,7 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring.Legacy;
 
 namespace osu.Game.Rulesets
@@ -18,8 +20,7 @@ namespace osu.Game.Rulesets
         /// <summary>
         /// Retrieves the number of mania keys required to play the beatmap.
         /// </summary>
-        /// <returns></returns>
-        int GetKeyCount(IBeatmapInfo beatmapInfo) => 0;
+        int GetKeyCount(IBeatmapInfo beatmapInfo, IReadOnlyList<Mod>? mods = null) => 0;
 
         ILegacyScoreSimulator CreateLegacyScoreSimulator();
     }
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 01e58d4ab2..2752beb645 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -28,6 +28,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osuTK;
 using osuTK.Graphics;
 
@@ -75,6 +76,9 @@ namespace osu.Game.Screens.Select.Carousel
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; } = null!;
 
+        [Resolved]
+        private IBindable<IReadOnlyList<Mod>>? mods { get; set; } = null!;
+
         private IBindable<StarDifficulty?> starDifficultyBindable = null!;
         private CancellationTokenSource? starDifficultyCancellationSource;
 
@@ -185,6 +189,7 @@ namespace osu.Game.Screens.Select.Carousel
             base.LoadComplete();
 
             ruleset.BindValueChanged(_ => updateKeyCount());
+            mods?.BindValueChanged(_ => updateKeyCount());
         }
 
         protected override void Selected()
@@ -255,7 +260,7 @@ namespace osu.Game.Screens.Select.Carousel
                 ILegacyRuleset legacyRuleset = (ILegacyRuleset)ruleset.Value.CreateInstance();
 
                 keyCountText.Alpha = 1;
-                keyCountText.Text = $"[{legacyRuleset.GetKeyCount(beatmapInfo)}K]";
+                keyCountText.Text = $"[{legacyRuleset.GetKeyCount(beatmapInfo, mods?.Value)}K]";
             }
             else
                 keyCountText.Alpha = 0;
diff --git a/osu.Game/Screens/Select/Details/AdvancedStats.cs b/osu.Game/Screens/Select/Details/AdvancedStats.cs
index 1aba977f44..cb820f4da9 100644
--- a/osu.Game/Screens/Select/Details/AdvancedStats.cs
+++ b/osu.Game/Screens/Select/Details/AdvancedStats.cs
@@ -199,7 +199,7 @@ namespace osu.Game.Screens.Select.Details
                     // For the time being, the key count is static no matter what, because:
                     // a) The method doesn't have knowledge of the active keymods. Doing so may require considerations for filtering.
                     // b) Using the difficulty adjustment mod to adjust OD doesn't have an effect on conversion.
-                    int keyCount = baseDifficulty == null ? 0 : legacyRuleset.GetKeyCount(BeatmapInfo);
+                    int keyCount = baseDifficulty == null ? 0 : legacyRuleset.GetKeyCount(BeatmapInfo, mods.Value);
 
                     FirstValue.Title = BeatmapsetsStrings.ShowStatsCsMania;
                     FirstValue.Value = (keyCount, keyCount);

From ce21235db495bb10e0f49763b7351f4f70fa51b3 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 22:47:43 +0900
Subject: [PATCH 501/930] Remove unused OriginalTargetColumns

---
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs          | 6 ------
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs | 6 +-----
 2 files changed, 1 insertion(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
index 28cdf8907e..8222e5477d 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmap.cs
@@ -22,11 +22,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         public int TotalColumns => Stages.Sum(g => g.Columns);
 
-        /// <summary>
-        /// The total number of columns that were present in this <see cref="ManiaBeatmap"/> before any user adjustments.
-        /// </summary>
-        public readonly int OriginalTotalColumns;
-
         /// <summary>
         /// Creates a new <see cref="ManiaBeatmap"/>.
         /// </summary>
@@ -35,7 +30,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         public ManiaBeatmap(StageDefinition defaultStage, int? originalTotalColumns = null)
         {
             Stages.Add(defaultStage);
-            OriginalTotalColumns = originalTotalColumns ?? defaultStage.Columns;
         }
 
         public override IEnumerable<BeatmapStatistic> GetStatistics()
diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index 8b339239a0..bed04a882f 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -46,8 +46,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
         /// </summary>
         public readonly bool IsForCurrentRuleset;
 
-        private readonly int originalTargetColumns;
-
         // Internal for testing purposes
         internal readonly LegacyRandom Random;
 
@@ -71,8 +69,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
                 Dual = true;
             }
 
-            originalTargetColumns = TargetColumns;
-
             static int getColumnCount(LegacyBeatmapConversionDifficultyInfo difficulty)
             {
                 double roundedCircleSize = Math.Round(difficulty.CircleSize);
@@ -122,7 +118,7 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
 
         protected override Beatmap<ManiaHitObject> CreateBeatmap()
         {
-            ManiaBeatmap beatmap = new ManiaBeatmap(new StageDefinition(TargetColumns), originalTargetColumns);
+            ManiaBeatmap beatmap = new ManiaBeatmap(new StageDefinition(TargetColumns));
 
             if (Dual)
                 beatmap.Stages.Add(new StageDefinition(TargetColumns));

From c08a4898b27347201d63200d162718ddaf874068 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 22:58:39 +0900
Subject: [PATCH 502/930] Refactor score simulator to use GetColumnCount()

---
 .../Difficulty/ManiaLegacyScoreSimulator.cs                | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Difficulty/ManiaLegacyScoreSimulator.cs b/osu.Game.Rulesets.Mania/Difficulty/ManiaLegacyScoreSimulator.cs
index d9fd96ac6a..8a1b127265 100644
--- a/osu.Game.Rulesets.Mania/Difficulty/ManiaLegacyScoreSimulator.cs
+++ b/osu.Game.Rulesets.Mania/Difficulty/ManiaLegacyScoreSimulator.cs
@@ -51,13 +51,8 @@ namespace osu.Game.Rulesets.Mania.Difficulty
                 return multiplier;
 
             // Apply key mod multipliers.
-
             int originalColumns = ManiaBeatmapConverter.GetColumnCount(difficulty);
-            int actualColumns = originalColumns;
-
-            actualColumns = mods.OfType<ManiaKeyMod>().SingleOrDefault()?.KeyCount ?? actualColumns;
-            if (mods.Any(m => m is ManiaModDualStages))
-                actualColumns *= 2;
+            int actualColumns = ManiaBeatmapConverter.GetColumnCount(difficulty, mods);
 
             if (actualColumns > originalColumns)
                 multiplier *= 0.9;

From 9fd6449fd8b7c8b7a9019d1d3a25cb46a5b5562c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 23:02:25 +0900
Subject: [PATCH 503/930] Add mods to FilterCriteria, pass to ruleset method

---
 osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs      |  5 ++---
 .../NonVisual/Filtering/FilterMatchingTest.cs       |  2 +-
 .../NonVisual/Filtering/FilterQueryParserTest.cs    |  2 +-
 osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs  |  3 ++-
 osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs |  2 +-
 .../Select/Carousel/DrawableCarouselBeatmap.cs      |  6 +++---
 osu.Game/Screens/Select/FilterControl.cs            | 13 ++++++++++---
 osu.Game/Screens/Select/FilterCriteria.cs           |  2 ++
 8 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
index 930ca217cd..07ed3ebd63 100644
--- a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
+++ b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
@@ -4,7 +4,6 @@
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Filter;
 using osu.Game.Rulesets.Mania.Beatmaps;
-using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
 
@@ -14,9 +13,9 @@ namespace osu.Game.Rulesets.Mania
     {
         private FilterCriteria.OptionalRange<float> keys;
 
-        public bool Matches(BeatmapInfo beatmapInfo)
+        public bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria)
         {
-            return !keys.HasFilter || keys.IsInRange(ManiaBeatmapConverter.GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo)));
+            return !keys.HasFilter || keys.IsInRange(ManiaBeatmapConverter.GetColumnCount(beatmapInfo, criteria.Mods));
         }
 
         public bool TryParseCustomKeywordCriteria(string key, Operator op, string value)
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index c7a32ebbc4..78d8eabba7 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -309,7 +309,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
                 match = shouldMatch;
             }
 
-            public bool Matches(BeatmapInfo beatmapInfo) => match;
+            public bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria) => match;
             public bool TryParseCustomKeywordCriteria(string key, Operator op, string value) => false;
         }
     }
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index ea14412f55..b0ceed45b9 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -502,7 +502,7 @@ namespace osu.Game.Tests.NonVisual.Filtering
         {
             public string? CustomValue { get; set; }
 
-            public bool Matches(BeatmapInfo beatmapInfo) => true;
+            public bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria) => true;
 
             public bool TryParseCustomKeywordCriteria(string key, Operator op, string value)
             {
diff --git a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
index dd2ad2cbfa..f926b04db4 100644
--- a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
+++ b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
@@ -18,11 +18,12 @@ namespace osu.Game.Rulesets.Filter
         /// in addition to the ones mandated by song select.
         /// </summary>
         /// <param name="beatmapInfo">The beatmap to test the criteria against.</param>
+        /// <param name="criteria">The filter criteria.</param>
         /// <returns>
         /// <c>true</c> if the beatmap matches the ruleset-specific custom filtering criteria,
         /// <c>false</c> otherwise.
         /// </returns>
-        bool Matches(BeatmapInfo beatmapInfo);
+        bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria);
 
         /// <summary>
         /// Attempts to parse a single custom keyword criterion, given by the user via the song select search box.
diff --git a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
index 43461a48bb..8f38ae710c 100644
--- a/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/CarouselBeatmap.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Screens.Select.Carousel
 
             match &= criteria.CollectionBeatmapMD5Hashes?.Contains(BeatmapInfo.MD5Hash) ?? true;
             if (match && criteria.RulesetCriteria != null)
-                match &= criteria.RulesetCriteria.Matches(BeatmapInfo);
+                match &= criteria.RulesetCriteria.Matches(BeatmapInfo, criteria);
 
             return match;
         }
diff --git a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
index 2752beb645..f725d98342 100644
--- a/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
+++ b/osu.Game/Screens/Select/Carousel/DrawableCarouselBeatmap.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Screens.Select.Carousel
         private IBindable<RulesetInfo> ruleset { get; set; } = null!;
 
         [Resolved]
-        private IBindable<IReadOnlyList<Mod>>? mods { get; set; } = null!;
+        private IBindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
 
         private IBindable<StarDifficulty?> starDifficultyBindable = null!;
         private CancellationTokenSource? starDifficultyCancellationSource;
@@ -189,7 +189,7 @@ namespace osu.Game.Screens.Select.Carousel
             base.LoadComplete();
 
             ruleset.BindValueChanged(_ => updateKeyCount());
-            mods?.BindValueChanged(_ => updateKeyCount());
+            mods.BindValueChanged(_ => updateKeyCount());
         }
 
         protected override void Selected()
@@ -260,7 +260,7 @@ namespace osu.Game.Screens.Select.Carousel
                 ILegacyRuleset legacyRuleset = (ILegacyRuleset)ruleset.Value.CreateInstance();
 
                 keyCountText.Alpha = 1;
-                keyCountText.Text = $"[{legacyRuleset.GetKeyCount(beatmapInfo, mods?.Value)}K]";
+                keyCountText.Text = $"[{legacyRuleset.GetKeyCount(beatmapInfo, mods.Value)}K]";
             }
             else
                 keyCountText.Alpha = 0;
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 17297c9ebf..b19a7699c5 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -4,6 +4,7 @@
 #nullable disable
 
 using System;
+using System.Collections.Generic;
 using System.Collections.Immutable;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
@@ -22,6 +23,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Select.Filter;
 using osuTK;
 using osuTK.Graphics;
@@ -65,6 +67,7 @@ namespace osu.Game.Screens.Select
                 Sort = sortMode.Value,
                 AllowConvertedBeatmaps = showConverted.Value,
                 Ruleset = ruleset.Value,
+                Mods = mods.Value,
                 CollectionBeatmapMD5Hashes = collectionDropdown.Current.Value?.Collection?.PerformRead(c => c.BeatmapMD5Hashes).ToImmutableHashSet()
             };
 
@@ -84,7 +87,7 @@ namespace osu.Game.Screens.Select
             base.ReceivePositionalInputAt(screenSpacePos) || sortTabs.ReceivePositionalInputAt(screenSpacePos);
 
         [BackgroundDependencyLoader(permitNulls: true)]
-        private void load(OsuColour colours, IBindable<RulesetInfo> parentRuleset, OsuConfigManager config)
+        private void load(OsuColour colours, OsuConfigManager config)
         {
             sortMode = config.GetBindable<SortMode>(OsuSetting.SongSelectSortingMode);
             groupMode = config.GetBindable<GroupMode>(OsuSetting.SongSelectGroupingMode);
@@ -214,8 +217,8 @@ namespace osu.Game.Screens.Select
             config.BindWith(OsuSetting.DisplayStarsMaximum, maximumStars);
             maximumStars.ValueChanged += _ => updateCriteria();
 
-            ruleset.BindTo(parentRuleset);
             ruleset.BindValueChanged(_ => updateCriteria());
+            mods.BindValueChanged(_ => updateCriteria());
 
             groupMode.BindValueChanged(_ => updateCriteria());
             sortMode.BindValueChanged(_ => updateCriteria());
@@ -239,7 +242,11 @@ namespace osu.Game.Screens.Select
             searchTextBox.HoldFocus = true;
         }
 
-        private readonly IBindable<RulesetInfo> ruleset = new Bindable<RulesetInfo>();
+        [Resolved]
+        private IBindable<RulesetInfo> ruleset { get; set; } = null!;
+
+        [Resolved]
+        private IBindable<IReadOnlyList<Mod>> mods { get; set; } = null!;
 
         private readonly Bindable<bool> showConverted = new Bindable<bool>();
         private readonly Bindable<double> minimumStars = new BindableDouble();
diff --git a/osu.Game/Screens/Select/FilterCriteria.cs b/osu.Game/Screens/Select/FilterCriteria.cs
index 01b0e9b7d9..190efd0fb0 100644
--- a/osu.Game/Screens/Select/FilterCriteria.cs
+++ b/osu.Game/Screens/Select/FilterCriteria.cs
@@ -10,6 +10,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Collections;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Filter;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Select.Filter;
 
 namespace osu.Game.Screens.Select
@@ -50,6 +51,7 @@ namespace osu.Game.Screens.Select
         public OptionalTextFilter[] SearchTerms = Array.Empty<OptionalTextFilter>();
 
         public RulesetInfo? Ruleset;
+        public IReadOnlyList<Mod>? Mods;
         public bool AllowConvertedBeatmaps;
 
         private string searchText = string.Empty;

From 6e746a0fa053eb5c5c0d1b8cde1d0a1e1ba2c737 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 28 Mar 2024 23:56:46 +0900
Subject: [PATCH 504/930] Fix carousel reoder on initial enter

---
 osu.Game/Screens/Select/FilterControl.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index b19a7699c5..7b8b5393bd 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -218,7 +218,13 @@ namespace osu.Game.Screens.Select
             maximumStars.ValueChanged += _ => updateCriteria();
 
             ruleset.BindValueChanged(_ => updateCriteria());
-            mods.BindValueChanged(_ => updateCriteria());
+            mods.BindValueChanged(_ =>
+            {
+                // Mods are updated once by the mod select overlay when song select is entered, regardless of if there are any mods.
+                // Updating the criteria here so early triggers a re-ordering of panels on song select, via... some mechanism.
+                // Todo: Investigate/fix the above and remove this schedule.
+                Scheduler.AddOnce(updateCriteria);
+            });
 
             groupMode.BindValueChanged(_ => updateCriteria());
             sortMode.BindValueChanged(_ => updateCriteria());

From cbbb46cad87d40b3416e23c60f8dc5bf391004c9 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 29 Mar 2024 00:25:03 +0900
Subject: [PATCH 505/930] Update action versions in diffcalc workflow

---
 .github/workflows/diffcalc.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/diffcalc.yml b/.github/workflows/diffcalc.yml
index 2ed176fe8d..7fd0f798cd 100644
--- a/.github/workflows/diffcalc.yml
+++ b/.github/workflows/diffcalc.yml
@@ -126,7 +126,7 @@ jobs:
     if: ${{ github.event_name == 'issue_comment' && github.event.issue.pull_request }}
     steps:
       - name: Create comment
-        uses: thollander/actions-comment-pull-request@363c6f6eae92cc5c3a66e95ba016fc771bb38943 # v2.4.2
+        uses: thollander/actions-comment-pull-request@fabd468d3a1a0b97feee5f6b9e499eab0dd903f6 # v2.5.0
         with:
           comment_tag: ${{ env.EXECUTION_ID }}
           message: |
@@ -253,7 +253,7 @@ jobs:
 
       - name: Restore cache
         id: restore-cache
-        uses: maxnowack/local-cache@038cc090b52e4f205fbc468bf5b0756df6f68775 # v1
+        uses: maxnowack/local-cache@720e69c948191660a90aa1cf6a42fc4d2dacdf30 # v2
         with:
           path: ${{ steps.query.outputs.DATA_NAME }}.tar.bz2
           key: ${{ steps.query.outputs.DATA_NAME }}
@@ -284,7 +284,7 @@ jobs:
 
       - name: Restore cache
         id: restore-cache
-        uses: maxnowack/local-cache@038cc090b52e4f205fbc468bf5b0756df6f68775 # v1
+        uses: maxnowack/local-cache@720e69c948191660a90aa1cf6a42fc4d2dacdf30 # v2
         with:
           path: ${{ steps.query.outputs.DATA_NAME }}.tar.bz2
           key: ${{ steps.query.outputs.DATA_NAME }}
@@ -358,7 +358,7 @@ jobs:
     steps:
       - name: Update comment on success
         if: ${{ needs.generator.result == 'success' }}
-        uses: thollander/actions-comment-pull-request@363c6f6eae92cc5c3a66e95ba016fc771bb38943 # v2.4.2
+        uses: thollander/actions-comment-pull-request@fabd468d3a1a0b97feee5f6b9e499eab0dd903f6 # v2.5.0
         with:
           comment_tag: ${{ env.EXECUTION_ID }}
           mode: upsert
@@ -369,7 +369,7 @@ jobs:
 
       - name: Update comment on failure
         if: ${{ needs.generator.result == 'failure' }}
-        uses: thollander/actions-comment-pull-request@363c6f6eae92cc5c3a66e95ba016fc771bb38943 # v2.4.2
+        uses: thollander/actions-comment-pull-request@fabd468d3a1a0b97feee5f6b9e499eab0dd903f6 # v2.5.0
         with:
           comment_tag: ${{ env.EXECUTION_ID }}
           mode: upsert
@@ -379,7 +379,7 @@ jobs:
 
       - name: Update comment on cancellation
         if: ${{ needs.generator.result == 'cancelled' }}
-        uses: thollander/actions-comment-pull-request@363c6f6eae92cc5c3a66e95ba016fc771bb38943 # v2.4.2
+        uses: thollander/actions-comment-pull-request@fabd468d3a1a0b97feee5f6b9e499eab0dd903f6 # v2.5.0
         with:
           comment_tag: ${{ env.EXECUTION_ID }}
           mode: delete

From c51a2e169d374b1cb820e2975def1cb2bbd902f7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 12:19:06 +0800
Subject: [PATCH 506/930] Add test coverage of crash scenario

---
 osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs b/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
index e603f72bb8..24c9d1294f 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
@@ -74,6 +74,10 @@ namespace osu.Game.Tests.Visual.Menus
             });
             AddStep("enter code", () => loginOverlay.ChildrenOfType<OsuTextBox>().First().Text = "88800088");
             assertAPIState(APIState.Online);
+
+            AddStep("set failing", () => { dummyAPI.SetState(APIState.Failing); });
+            AddStep("return to online", () => { dummyAPI.SetState(APIState.Online); });
+
             AddStep("clear handler", () => dummyAPI.HandleRequest = null);
         }
 

From fef8afb833b7ddfd42b97260faff7593da514868 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 12:03:05 +0800
Subject: [PATCH 507/930] Fix double binding causing game crash after API
 enters failing state

See https://sentry.ppy.sh/organizations/ppy/issues/33406/?alert_rule_id=4&alert_timestamp=1711655107332&alert_type=email&environment=production&project=2&referrer=alert_email
---
 osu.Game/Overlays/Login/LoginPanel.cs | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Login/LoginPanel.cs b/osu.Game/Overlays/Login/LoginPanel.cs
index 25bf612bc3..d5c7ed29b8 100644
--- a/osu.Game/Overlays/Login/LoginPanel.cs
+++ b/osu.Game/Overlays/Login/LoginPanel.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Overlays.Login
         [Resolved]
         private OsuColour colours { get; set; } = null!;
 
-        private UserDropdown dropdown = null!;
+        private UserDropdown? dropdown;
 
         /// <summary>
         /// Called to request a hide of a parent displaying this container.
@@ -68,6 +68,14 @@ namespace osu.Game.Overlays.Login
             apiState.BindValueChanged(onlineStateChanged, true);
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            userStatus.BindTo(api.LocalUser.Value.Status);
+            userStatus.BindValueChanged(e => updateDropdownCurrent(e.NewValue), true);
+        }
+
         private void onlineStateChanged(ValueChangedEvent<APIState> state) => Schedule(() =>
         {
             form = null;
@@ -144,9 +152,6 @@ namespace osu.Game.Overlays.Login
                         },
                     };
 
-                    userStatus.BindTo(api.LocalUser.Value.Status);
-                    userStatus.BindValueChanged(e => updateDropdownCurrent(e.NewValue), true);
-
                     dropdown.Current.BindValueChanged(action =>
                     {
                         switch (action.NewValue)
@@ -171,6 +176,7 @@ namespace osu.Game.Overlays.Login
                                 break;
                         }
                     }, true);
+
                     break;
             }
 
@@ -180,6 +186,9 @@ namespace osu.Game.Overlays.Login
 
         private void updateDropdownCurrent(UserStatus? status)
         {
+            if (dropdown == null)
+                return;
+
             switch (status)
             {
                 case UserStatus.Online:

From d9cf5b5440ff3146e94d1c5da5c3c7c11bd53dd8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 15:44:01 +0800
Subject: [PATCH 508/930] Fix bindable not being correctly re-bound across
 local user changes

---
 .../Visual/Menus/TestSceneLoginOverlay.cs     | 12 +++++++++
 osu.Game/Overlays/Login/LoginPanel.cs         | 25 +++++++++++--------
 2 files changed, 27 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs b/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
index 24c9d1294f..460d7814e0 100644
--- a/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
+++ b/osu.Game.Tests/Visual/Menus/TestSceneLoginOverlay.cs
@@ -15,6 +15,7 @@ using osu.Game.Online.API.Requests;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Login;
 using osu.Game.Overlays.Settings;
+using osu.Game.Users;
 using osu.Game.Users.Drawables;
 using osuTK.Input;
 
@@ -72,13 +73,24 @@ namespace osu.Game.Tests.Visual.Menus
 
                 return false;
             });
+
             AddStep("enter code", () => loginOverlay.ChildrenOfType<OsuTextBox>().First().Text = "88800088");
             assertAPIState(APIState.Online);
+            assertDropdownState(UserAction.Online);
 
             AddStep("set failing", () => { dummyAPI.SetState(APIState.Failing); });
             AddStep("return to online", () => { dummyAPI.SetState(APIState.Online); });
 
             AddStep("clear handler", () => dummyAPI.HandleRequest = null);
+
+            assertDropdownState(UserAction.Online);
+            AddStep("change user state", () => dummyAPI.LocalUser.Value.Status.Value = UserStatus.DoNotDisturb);
+            assertDropdownState(UserAction.DoNotDisturb);
+        }
+
+        private void assertDropdownState(UserAction state)
+        {
+            AddAssert($"dropdown state is {state}", () => loginOverlay.ChildrenOfType<UserDropdown>().First().Current.Value, () => Is.EqualTo(state));
         }
 
         private void assertAPIState(APIState expected) =>
diff --git a/osu.Game/Overlays/Login/LoginPanel.cs b/osu.Game/Overlays/Login/LoginPanel.cs
index d5c7ed29b8..a8adf4ce8c 100644
--- a/osu.Game/Overlays/Login/LoginPanel.cs
+++ b/osu.Game/Overlays/Login/LoginPanel.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays.Settings;
 using osu.Game.Users;
 using osuTK;
@@ -37,8 +38,10 @@ namespace osu.Game.Overlays.Login
         /// </summary>
         public Action? RequestHide;
 
+        private IBindable<APIUser> user = null!;
+        private readonly Bindable<UserStatus?> status = new Bindable<UserStatus?>();
+
         private readonly IBindable<APIState> apiState = new Bindable<APIState>();
-        private readonly Bindable<UserStatus?> userStatus = new Bindable<UserStatus?>();
 
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
@@ -61,19 +64,21 @@ namespace osu.Game.Overlays.Login
             AutoSizeAxes = Axes.Y;
         }
 
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            apiState.BindTo(api.State);
-            apiState.BindValueChanged(onlineStateChanged, true);
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
 
-            userStatus.BindTo(api.LocalUser.Value.Status);
-            userStatus.BindValueChanged(e => updateDropdownCurrent(e.NewValue), true);
+            apiState.BindTo(api.State);
+            apiState.BindValueChanged(onlineStateChanged, true);
+
+            user = api.LocalUser.GetBoundCopy();
+            user.BindValueChanged(u =>
+            {
+                status.UnbindBindings();
+                status.BindTo(u.NewValue.Status);
+            }, true);
+
+            status.BindValueChanged(e => updateDropdownCurrent(e.NewValue), true);
         }
 
         private void onlineStateChanged(ValueChangedEvent<APIState> state) => Schedule(() =>

From 233b9eb1723fb44a26c1a65c1d583e3e6f87f7b5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 17:11:55 +0800
Subject: [PATCH 509/930] Avoid reporting an import as successful when all
 beatmaps failed to import

---
 osu.Game/Beatmaps/BeatmapImporter.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index 5ff3ab64b2..9ca0aafddd 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.cs
@@ -434,6 +434,9 @@ namespace osu.Game.Beatmaps
                 }
             }
 
+            if (!beatmaps.Any())
+                throw new ArgumentException($"No valid beatmap files found in the beatmap archive.");
+
             return beatmaps;
         }
     }

From df4a28db915653f79603ef78ea44af48d781391e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 17:32:20 +0800
Subject: [PATCH 510/930] Fix failing test due to missing ruleset store

---
 osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
index 5f722e381c..016928c6d6 100644
--- a/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
+++ b/osu.Game.Tests/Database/LegacyBeatmapImporterTest.cs
@@ -12,6 +12,7 @@ using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO;
+using osu.Game.Rulesets;
 using osu.Game.Tests.Resources;
 
 namespace osu.Game.Tests.Database
@@ -77,6 +78,7 @@ namespace osu.Game.Tests.Database
             {
                 using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
                 using (var tmpStorage = new TemporaryNativeStorage("stable-songs-folder"))
+                using (new RealmRulesetStore(realm, storage))
                 {
                     var stableStorage = new StableStorage(tmpStorage.GetFullPath(""), host);
                     var songsStorage = stableStorage.GetStorageForDirectory(StableStorage.STABLE_DEFAULT_SONGS_PATH);

From 2d3b273974de4cb85dea652f3915a37f7ee0451e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 29 Mar 2024 10:36:17 +0100
Subject: [PATCH 511/930] Remove redundant string interpolation

---
 osu.Game/Beatmaps/BeatmapImporter.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/BeatmapImporter.cs b/osu.Game/Beatmaps/BeatmapImporter.cs
index 9ca0aafddd..2137f33e77 100644
--- a/osu.Game/Beatmaps/BeatmapImporter.cs
+++ b/osu.Game/Beatmaps/BeatmapImporter.cs
@@ -435,7 +435,7 @@ namespace osu.Game.Beatmaps
             }
 
             if (!beatmaps.Any())
-                throw new ArgumentException($"No valid beatmap files found in the beatmap archive.");
+                throw new ArgumentException("No valid beatmap files found in the beatmap archive.");
 
             return beatmaps;
         }

From e06df34a1c7f57ffec818be87264c4e82b61e508 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 29 Mar 2024 11:16:31 +0100
Subject: [PATCH 512/930] Apply partial fade on pp display on results screen
 when score will not give pp

---
 .../TestSceneExpandedPanelMiddleContent.cs    | 37 +++++++++++++++++++
 osu.Game/Localisation/ResultsScreenStrings.cs | 24 ++++++++++++
 .../Statistics/PerformanceStatistic.cs        | 32 ++++++++++++++--
 3 files changed, 89 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Localisation/ResultsScreenStrings.cs

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index d97946a1d5..9f7726313a 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -14,13 +14,16 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.Sprites;
+using osu.Game.Localisation;
 using osu.Game.Models;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Scoring;
 using osu.Game.Screens.Ranking;
 using osu.Game.Screens.Ranking.Expanded;
+using osu.Game.Screens.Ranking.Expanded.Statistics;
 using osu.Game.Tests.Beatmaps;
 using osu.Game.Tests.Resources;
 using osuTK;
@@ -67,6 +70,40 @@ namespace osu.Game.Tests.Visual.Ranking
             AddAssert("play time displayed", () => this.ChildrenOfType<ExpandedPanelMiddleContent.PlayedOnText>().Any());
         }
 
+        [Test]
+        public void TestPPShownAsProvisionalWhenBeatmapHasNoLeaderboard()
+        {
+            AddStep("show example score", () =>
+            {
+                var beatmap = createTestBeatmap(new RealmUser());
+                beatmap.Status = BeatmapOnlineStatus.Graveyard;
+                showPanel(TestResources.CreateTestScoreInfo(beatmap));
+            });
+
+            AddAssert("pp display faded out", () =>
+            {
+                var ppDisplay = this.ChildrenOfType<PerformanceStatistic>().Single();
+                return ppDisplay.Alpha == 0.5 && ppDisplay.TooltipText == ResultsScreenStrings.NoPPForUnrankedBeatmaps;
+            });
+        }
+
+        [Test]
+        public void TestPPShownAsProvisionalWhenUnrankedModsArePresent()
+        {
+            AddStep("show example score", () =>
+            {
+                var score = TestResources.CreateTestScoreInfo(createTestBeatmap(new RealmUser()));
+                score.Mods = score.Mods.Append(new OsuModDifficultyAdjust()).ToArray();
+                showPanel(score);
+            });
+
+            AddAssert("pp display faded out", () =>
+            {
+                var ppDisplay = this.ChildrenOfType<PerformanceStatistic>().Single();
+                return ppDisplay.Alpha == 0.5 && ppDisplay.TooltipText == ResultsScreenStrings.NoPPForUnrankedMods;
+            });
+        }
+
         [Test]
         public void TestWithDefaultDate()
         {
diff --git a/osu.Game/Localisation/ResultsScreenStrings.cs b/osu.Game/Localisation/ResultsScreenStrings.cs
new file mode 100644
index 0000000000..54e7717af9
--- /dev/null
+++ b/osu.Game/Localisation/ResultsScreenStrings.cs
@@ -0,0 +1,24 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class ResultsScreenStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.ResultsScreen";
+
+        /// <summary>
+        /// "Performance points are not granted for this score because the beatmap is not ranked."
+        /// </summary>
+        public static LocalisableString NoPPForUnrankedBeatmaps => new TranslatableString(getKey(@"no_pp_for_unranked_beatmaps"), @"Performance points are not granted for this score because the beatmap is not ranked.");
+
+        /// <summary>
+        /// "Performance points are not granted for this score because of unranked mods."
+        /// </summary>
+        public static LocalisableString NoPPForUnrankedMods => new TranslatableString(getKey(@"no_pp_for_unranked_mods"), @"Performance points are not granted for this score because of unranked mods.");
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 22c1e26d43..0a9c68eafc 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -4,20 +4,26 @@
 #nullable disable
 
 using System;
+using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Localisation;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
+using osu.Game.Localisation;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
-    public partial class PerformanceStatistic : StatisticDisplay
+    public partial class PerformanceStatistic : StatisticDisplay, IHasTooltip
     {
+        public LocalisableString TooltipText { get; private set; }
+
         private readonly ScoreInfo score;
 
         private readonly Bindable<int> performance = new Bindable<int>();
@@ -37,7 +43,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         {
             if (score.PP.HasValue)
             {
-                setPerformanceValue(score.PP.Value);
+                setPerformanceValue(score, score.PP.Value);
             }
             else
             {
@@ -52,15 +58,33 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
                     var result = await performanceCalculator.CalculateAsync(score, attributes.Value.Attributes, cancellationToken ?? default).ConfigureAwait(false);
 
-                    Schedule(() => setPerformanceValue(result.Total));
+                    Schedule(() => setPerformanceValue(score, result.Total));
                 }, cancellationToken ?? default);
             }
         }
 
-        private void setPerformanceValue(double? pp)
+        private void setPerformanceValue(ScoreInfo scoreInfo, double? pp)
         {
             if (pp.HasValue)
+            {
                 performance.Value = (int)Math.Round(pp.Value, MidpointRounding.AwayFromZero);
+
+                if (!scoreInfo.BeatmapInfo!.Status.GrantsPerformancePoints())
+                {
+                    Alpha = 0.5f;
+                    TooltipText = ResultsScreenStrings.NoPPForUnrankedBeatmaps;
+                }
+                else if (scoreInfo.Mods.Any(m => !m.Ranked))
+                {
+                    Alpha = 0.5f;
+                    TooltipText = ResultsScreenStrings.NoPPForUnrankedMods;
+                }
+                else
+                {
+                    Alpha = 1f;
+                    TooltipText = default;
+                }
+            }
         }
 
         public override void Appear()

From c21805589eb2014bd07e6386b9398734e9a99dcb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 29 Mar 2024 22:40:04 +0800
Subject: [PATCH 513/930] Fix taiko mascot size not matching stable

---
 osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
index 7b1e31112e..e863c4c2e4 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
@@ -27,7 +27,8 @@ namespace osu.Game.Rulesets.Taiko.UI
             InternalChild = textureAnimation = createTextureAnimation(state).With(animation =>
             {
                 animation.Origin = animation.Anchor = Anchor.BottomLeft;
-                animation.Scale = new Vector2(0.51f); // close enough to stable
+                // matches stable (https://github.com/peppy/osu-stable-reference/blob/054d0380c19aa5972be176d9d242ceb0e1630ae6/osu!/GameModes/Play/Rulesets/Taiko/TaikoMascot.cs#L34)
+                animation.Scale = new Vector2(0.6f);
             });
 
             RelativeSizeAxes = Axes.Both;

From 51f79c33e1c93ecb4cbf71e5de820941a0fa622e Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 29 Mar 2024 23:33:04 +0300
Subject: [PATCH 514/930] Fix URL pointing to non-existent commit

---
 osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
index e863c4c2e4..90f7782aba 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoMascotAnimation.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Rulesets.Taiko.UI
             InternalChild = textureAnimation = createTextureAnimation(state).With(animation =>
             {
                 animation.Origin = animation.Anchor = Anchor.BottomLeft;
-                // matches stable (https://github.com/peppy/osu-stable-reference/blob/054d0380c19aa5972be176d9d242ceb0e1630ae6/osu!/GameModes/Play/Rulesets/Taiko/TaikoMascot.cs#L34)
+                // matches stable (https://github.com/peppy/osu-stable-reference/blob/e53980dd76857ee899f66ce519ba1597e7874f28/osu!/GameModes/Play/Rulesets/Taiko/TaikoMascot.cs#L34)
                 animation.Scale = new Vector2(0.6f);
             });
 

From 8d6358a138605828c5260b4efca907049ed73e92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Sat, 30 Mar 2024 16:02:31 +0700
Subject: [PATCH 515/930] Fix editor rotation allowing spinner only bug

---
 osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
index 1998e02a5c..d48bc6a90b 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionRotationHandler.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.Edit
         {
             var quad = GeometryUtils.GetSurroundingQuad(selectedMovableObjects);
             CanRotateSelectionOrigin.Value = quad.Width > 0 || quad.Height > 0;
-            CanRotatePlayfieldOrigin.Value = selectedItems.Any();
+            CanRotatePlayfieldOrigin.Value = selectedMovableObjects.Any();
         }
 
         private OsuHitObject[]? objectsInRotation;

From 5d497ba4a8ada3ae5ad733ed6d856328b39a9576 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Sat, 30 Mar 2024 16:04:22 +0700
Subject: [PATCH 516/930] Simplify TooltipText for EditorRadioButton

---
 .../Edit/PreciseRotationPopover.cs                  |  8 +++++++-
 osu.Game/Rulesets/Edit/HitObjectComposer.cs         |  8 +++++++-
 .../Components/RadioButtons/EditorRadioButton.cs    |  2 +-
 .../Edit/Components/RadioButtons/RadioButton.cs     | 13 +++----------
 4 files changed, 18 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index 2cf6799279..6c29184be4 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -68,7 +68,13 @@ namespace osu.Game.Rulesets.Osu.Edit
                     }
                 }
             };
-            selectionCentreButton.TooltipTextWhenDisabled = "We can't rotate a circle around itself! Can we?";
+            selectionCentreButton.Selected.DisabledChanged += (isDisabled) =>
+            {
+                if (isDisabled)
+                    selectionCentreButton.TooltipText = "We can't rotate a circle around itself! Can we?";
+                else
+                    selectionCentreButton.TooltipText = string.Empty;
+            };
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index bc8de7f4b2..09bac7a791 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -214,7 +214,13 @@ namespace osu.Game.Rulesets.Edit
 
             foreach (var item in toolboxCollection.Items)
             {
-                item.TooltipTextWhenDisabled = "Add at least one timing point first!";
+                item.Selected.DisabledChanged += (isDisabled) =>
+                {
+                    if (isDisabled)
+                        item.TooltipText = "Add at least one timing point first!";
+                    else
+                        item.TooltipText = string.Empty;
+                };
             }
 
             TernaryStates = CreateTernaryButtons().ToArray();
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
index 9d1f87e1e0..29bb24eb43 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/EditorRadioButton.cs
@@ -94,6 +94,6 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
             X = 40f
         };
 
-        public LocalisableString TooltipText => Enabled.Value ? Button.TooltipTextWhenEnabled : Button.TooltipTextWhenDisabled;
+        public LocalisableString TooltipText => Button.TooltipText;
     }
 }
diff --git a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
index 2d1416c9c6..f49fc6f6ab 100644
--- a/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
+++ b/osu.Game/Screens/Edit/Components/RadioButtons/RadioButton.cs
@@ -16,16 +16,6 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
         /// </summary>
         public readonly BindableBool Selected;
 
-        /// <summary>
-        /// Tooltip text that will be shown on hover if button is enabled.
-        /// </summary>
-        public LocalisableString TooltipTextWhenEnabled { get; set; } = string.Empty;
-
-        /// <summary>
-        /// Tooltip text that will be shown on hover if button is disabled.
-        /// </summary>
-        public LocalisableString TooltipTextWhenDisabled { get; set; } = string.Empty;
-
         /// <summary>
         /// The item related to this button.
         /// </summary>
@@ -62,5 +52,8 @@ namespace osu.Game.Screens.Edit.Components.RadioButtons
         /// Deselects this <see cref="RadioButton"/>.
         /// </summary>
         public void Deselect() => Selected.Value = false;
+
+        // Tooltip text that will be shown when hovered over
+        public LocalisableString TooltipText { get; set; } = string.Empty;
     }
 }

From 6f782266b51b717e996cc258b05da8fb737533d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Sat, 30 Mar 2024 17:03:40 +0700
Subject: [PATCH 517/930] Fix inspection

---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs | 7 ++-----
 osu.Game/Rulesets/Edit/HitObjectComposer.cs          | 7 ++-----
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index 6c29184be4..70441b33dd 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -68,12 +68,9 @@ namespace osu.Game.Rulesets.Osu.Edit
                     }
                 }
             };
-            selectionCentreButton.Selected.DisabledChanged += (isDisabled) =>
+            selectionCentreButton.Selected.DisabledChanged += isDisabled =>
             {
-                if (isDisabled)
-                    selectionCentreButton.TooltipText = "We can't rotate a circle around itself! Can we?";
-                else
-                    selectionCentreButton.TooltipText = string.Empty;
+                selectionCentreButton.TooltipText = isDisabled ? "We can't rotate a circle around itself! Can we?" : string.Empty;
             };
         }
 
diff --git a/osu.Game/Rulesets/Edit/HitObjectComposer.cs b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
index 09bac7a791..4d92a08bed 100644
--- a/osu.Game/Rulesets/Edit/HitObjectComposer.cs
+++ b/osu.Game/Rulesets/Edit/HitObjectComposer.cs
@@ -214,12 +214,9 @@ namespace osu.Game.Rulesets.Edit
 
             foreach (var item in toolboxCollection.Items)
             {
-                item.Selected.DisabledChanged += (isDisabled) =>
+                item.Selected.DisabledChanged += isDisabled =>
                 {
-                    if (isDisabled)
-                        item.TooltipText = "Add at least one timing point first!";
-                    else
-                        item.TooltipText = string.Empty;
+                    item.TooltipText = isDisabled ? "Add at least one timing point first!" : string.Empty;
                 };
             }
 

From b445e27ad6bfae93244b89acc1544aef01978bdc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?= <honguyenminh@outlook.com>
Date: Sat, 30 Mar 2024 17:54:27 +0700
Subject: [PATCH 518/930] Aggregate two CanRotate bindable for enabling the
 Rotate button

---
 osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
index 19590e9b6e..3e2cbe9d60 100644
--- a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
+++ b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
@@ -51,9 +51,17 @@ namespace osu.Game.Rulesets.Osu.Edit
         {
             base.LoadComplete();
 
+            // aggregate two values into canRotate
+            RotationHandler.CanRotatePlayfieldOrigin.BindValueChanged(_ => updateCanRotateAggregate());
+            RotationHandler.CanRotateSelectionOrigin.BindValueChanged(_ => updateCanRotateAggregate());
+
+            void updateCanRotateAggregate()
+            {
+                canRotate.Value = RotationHandler.CanRotatePlayfieldOrigin.Value || RotationHandler.CanRotateSelectionOrigin.Value;
+            }
+
             // bindings to `Enabled` on the buttons are decoupled on purpose
             // due to the weird `OsuButton` behaviour of resetting `Enabled` to `false` when `Action` is set.
-            canRotate.BindTo(RotationHandler.CanRotatePlayfieldOrigin);
             canRotate.BindValueChanged(_ => rotateButton.Enabled.Value = canRotate.Value, true);
         }
 

From 54472e6452c61671d487f59d6e61af89daaa6d59 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 31 Mar 2024 01:20:27 +0300
Subject: [PATCH 519/930] Decouple GlowingDrawable from GlowingSpriteText

---
 osu.Game/Graphics/Sprites/GlowingDrawable.cs  | 41 +++++++++++++++++++
 .../Graphics/Sprites/GlowingSpriteText.cs     | 39 ++++--------------
 2 files changed, 50 insertions(+), 30 deletions(-)
 create mode 100644 osu.Game/Graphics/Sprites/GlowingDrawable.cs

diff --git a/osu.Game/Graphics/Sprites/GlowingDrawable.cs b/osu.Game/Graphics/Sprites/GlowingDrawable.cs
new file mode 100644
index 0000000000..10085ad38b
--- /dev/null
+++ b/osu.Game/Graphics/Sprites/GlowingDrawable.cs
@@ -0,0 +1,41 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
+using osu.Framework.Utils;
+using osuTK;
+
+namespace osu.Game.Graphics.Sprites
+{
+    public abstract partial class GlowingDrawable : BufferedContainer
+    {
+        // Inflate draw quad to prevent glow from trimming at the edges.
+        // Padding won't suffice since it will affect drawable position in cases when it's not centered.
+        protected override Quad ComputeScreenSpaceDrawQuad()
+            => base.ComputeScreenSpaceDrawQuad().AABBFloat.Inflate(new Vector2(Blur.KernelSize(BlurSigma.X), Blur.KernelSize(BlurSigma.Y)));
+
+        public ColourInfo GlowColour
+        {
+            get => EffectColour;
+            set
+            {
+                EffectColour = value;
+                BackgroundColour = value.MultiplyAlpha(0f);
+            }
+        }
+
+        protected GlowingDrawable()
+            : base(cachedFrameBuffer: true)
+        {
+            AutoSizeAxes = Axes.Both;
+            RedrawOnScale = false;
+            DrawOriginal = true;
+            Child = CreateDrawable();
+        }
+
+        protected abstract Drawable CreateDrawable();
+    }
+}
diff --git a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs b/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
index 669c5da01e..3ac13bf862 100644
--- a/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
+++ b/osu.Game/Graphics/Sprites/GlowingSpriteText.cs
@@ -4,24 +4,17 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
-using osu.Framework.Utils;
 using osuTK;
 
 namespace osu.Game.Graphics.Sprites
 {
-    public partial class GlowingSpriteText : BufferedContainer, IHasText
+    public partial class GlowingSpriteText : GlowingDrawable, IHasText
     {
         private const float blur_sigma = 3f;
 
-        // Inflate draw quad to prevent glow from trimming at the edges.
-        // Padding won't suffice since it will affect text position in cases when it's not centered.
-        protected override Quad ComputeScreenSpaceDrawQuad() => base.ComputeScreenSpaceDrawQuad().AABBFloat.Inflate(Blur.KernelSize(blur_sigma));
-
-        private readonly OsuSpriteText text;
+        private OsuSpriteText text = null!;
 
         public LocalisableString Text
         {
@@ -47,16 +40,6 @@ namespace osu.Game.Graphics.Sprites
             set => text.Colour = value;
         }
 
-        public ColourInfo GlowColour
-        {
-            get => EffectColour;
-            set
-            {
-                EffectColour = value;
-                BackgroundColour = value.MultiplyAlpha(0f);
-            }
-        }
-
         public Vector2 Spacing
         {
             get => text.Spacing;
@@ -76,20 +59,16 @@ namespace osu.Game.Graphics.Sprites
         }
 
         public GlowingSpriteText()
-            : base(cachedFrameBuffer: true)
         {
-            AutoSizeAxes = Axes.Both;
             BlurSigma = new Vector2(blur_sigma);
-            RedrawOnScale = false;
-            DrawOriginal = true;
             EffectBlending = BlendingParameters.Additive;
-            EffectPlacement = EffectPlacement.InFront;
-            Child = text = new OsuSpriteText
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                Shadow = false,
-            };
         }
+
+        protected override Drawable CreateDrawable() => text = new OsuSpriteText
+        {
+            Anchor = Anchor.Centre,
+            Origin = Anchor.Centre,
+            Shadow = false,
+        };
     }
 }

From 58a68e94af79205aa13989fb8b896c9d27c0f9c0 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 31 Mar 2024 01:30:08 +0300
Subject: [PATCH 520/930] Simplify glowing icons in break overlay

---
 osu.Game/Screens/Play/Break/BlurredIcon.cs | 44 ++---------------
 osu.Game/Screens/Play/Break/GlowIcon.cs    | 57 ++++++++--------------
 2 files changed, 23 insertions(+), 78 deletions(-)

diff --git a/osu.Game/Screens/Play/Break/BlurredIcon.cs b/osu.Game/Screens/Play/Break/BlurredIcon.cs
index 2bf59ea63b..9cd617d3e3 100644
--- a/osu.Game/Screens/Play/Break/BlurredIcon.cs
+++ b/osu.Game/Screens/Play/Break/BlurredIcon.cs
@@ -1,52 +1,16 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Sprites;
-using osu.Game.Graphics;
-using osuTK;
 
 namespace osu.Game.Screens.Play.Break
 {
-    public partial class BlurredIcon : BufferedContainer
+    public partial class BlurredIcon : GlowIcon
     {
-        private readonly SpriteIcon icon;
-
-        public IconUsage Icon
-        {
-            set => icon.Icon = value;
-            get => icon.Icon;
-        }
-
-        public override Vector2 Size
-        {
-            set
-            {
-                icon.Size = value;
-                base.Size = value + BlurSigma * 5;
-                ForceRedraw();
-            }
-            get => base.Size;
-        }
-
         public BlurredIcon()
-            : base(cachedFrameBuffer: true)
         {
-            RelativePositionAxes = Axes.X;
-            Child = icon = new SpriteIcon
-            {
-                Origin = Anchor.Centre,
-                Anchor = Anchor.Centre,
-                Shadow = false,
-            };
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colours)
-        {
-            Colour = colours.BlueLighter;
+            EffectBlending = BlendingParameters.Additive;
+            DrawOriginal = false;
         }
     }
 }
diff --git a/osu.Game/Screens/Play/Break/GlowIcon.cs b/osu.Game/Screens/Play/Break/GlowIcon.cs
index 8e2b9da0ad..a68cfdac42 100644
--- a/osu.Game/Screens/Play/Break/GlowIcon.cs
+++ b/osu.Game/Screens/Play/Break/GlowIcon.cs
@@ -3,64 +3,45 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
 using osuTK;
 
 namespace osu.Game.Screens.Play.Break
 {
-    public partial class GlowIcon : Container
+    public partial class GlowIcon : GlowingDrawable
     {
-        private readonly SpriteIcon spriteIcon;
-        private readonly BlurredIcon blurredIcon;
-
-        public override Vector2 Size
-        {
-            get => base.Size;
-            set
-            {
-                blurredIcon.Size = spriteIcon.Size = value;
-                blurredIcon.ForceRedraw();
-            }
-        }
-
-        public Vector2 BlurSigma
-        {
-            get => blurredIcon.BlurSigma;
-            set => blurredIcon.BlurSigma = value;
-        }
+        private SpriteIcon icon = null!;
 
         public IconUsage Icon
         {
-            get => spriteIcon.Icon;
-            set => spriteIcon.Icon = blurredIcon.Icon = value;
+            set => icon.Icon = value;
+            get => icon.Icon;
+        }
+
+        public new Vector2 Size
+        {
+            set => icon.Size = value;
+            get => icon.Size;
         }
 
         public GlowIcon()
         {
             RelativePositionAxes = Axes.X;
-            AutoSizeAxes = Axes.Both;
-            Children = new Drawable[]
-            {
-                blurredIcon = new BlurredIcon
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                },
-                spriteIcon = new SpriteIcon
-                {
-                    Anchor = Anchor.Centre,
-                    Origin = Anchor.Centre,
-                    Shadow = false,
-                }
-            };
         }
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
-            blurredIcon.Colour = colours.Blue;
+            GlowColour = colours.BlueLighter;
         }
+
+        protected override Drawable CreateDrawable() => icon = new SpriteIcon
+        {
+            Origin = Anchor.Centre,
+            Anchor = Anchor.Centre,
+            Shadow = false,
+        };
     }
 }

From 11b113580496fd979bfa083573e0e17ac6cb8f64 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 31 Mar 2024 01:55:34 +0300
Subject: [PATCH 521/930] Adjust blurred icons position due to size handling
 differences

---
 osu.Game/Screens/Play/Break/BreakArrows.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/Break/BreakArrows.cs b/osu.Game/Screens/Play/Break/BreakArrows.cs
index 41277c7557..40474a7137 100644
--- a/osu.Game/Screens/Play/Break/BreakArrows.cs
+++ b/osu.Game/Screens/Play/Break/BreakArrows.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Screens.Play.Break
 
         private const int blurred_icon_blur_sigma = 20;
         private const int blurred_icon_size = 130;
-        private const float blurred_icon_final_offset = 0.35f;
+        private const float blurred_icon_final_offset = 0.38f;
         private const float blurred_icon_offscreen_offset = 0.7f;
 
         private readonly GlowIcon leftGlowIcon;

From 450e7016bcbf2e778910f6114da6688140d3cbd5 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sat, 30 Mar 2024 21:23:05 -0300
Subject: [PATCH 522/930] Bind `StackHeight` changes to visual update methods

---
 .../TestScenePathControlPointVisualiser.cs    | 48 +++++++++++++++++++
 .../PathControlPointConnectionPiece.cs        |  2 +
 .../Components/PathControlPointPiece.cs       |  2 +
 3 files changed, 52 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
index 2b53554ed1..0c12e6fb21 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
@@ -172,6 +172,54 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             assertControlPointPathType(4, null);
         }
 
+        [Test]
+        public void TestStackingUpdatesPointsPosition()
+        {
+            createVisualiser(true);
+
+            Vector2[] points = [
+                new Vector2(200),
+                new Vector2(300),
+                new Vector2(500, 300),
+                new Vector2(700, 200),
+                new Vector2(500, 100)
+            ];
+
+            foreach (var point in points) addControlPointStep(point);
+
+            AddStep("apply stacking", () => slider.StackHeightBindable.Value += 1);
+
+            for (int i = 0; i < points.Length; i++)
+                addAssertPointPositionChanged(points, i);
+        }
+
+        [Test]
+        public void TestStackingUpdatesConnectionPosition()
+        {
+            createVisualiser(true);
+
+            Vector2 connectionPosition = default!;
+
+            addControlPointStep(connectionPosition = new Vector2(300));
+            addControlPointStep(new Vector2(600));
+
+            // Apply a big number in stacking so the person running the test can clearly see if it fails
+            AddStep("apply stacking", () => slider.StackHeightBindable.Value += 10);
+
+            AddAssert($"Connection at {connectionPosition} changed",
+                () => visualiser.Connections[0].Position,
+                () => !Is.EqualTo(connectionPosition)
+            );
+        }
+
+        private void addAssertPointPositionChanged(Vector2[] points, int index)
+        {
+            AddAssert($"Point at {points.ElementAt(index)} changed",
+                () => visualiser.Pieces[index].Position,
+                () => !Is.EqualTo(points.ElementAt(index))
+            );
+        }
+
         private void createVisualiser(bool allowSelection) => AddStep("create visualiser", () => Child = visualiser = new PathControlPointVisualiser<Slider>(slider, allowSelection)
         {
             Anchor = Anchor.Centre,
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
index 7e7d653dbd..56dc16dd95 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
@@ -56,6 +56,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             pathVersion = hitObject.Path.Version.GetBoundCopy();
             pathVersion.BindValueChanged(_ => Scheduler.AddOnce(updateConnectingPath));
 
+            hitObject.StackHeightBindable.BindValueChanged(_ => updateConnectingPath());
+
             updateConnectingPath();
         }
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
index e741d67e3b..ee306fb6d7 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -105,6 +105,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             hitObjectScale = hitObject.ScaleBindable.GetBoundCopy();
             hitObjectScale.BindValueChanged(_ => updateMarkerDisplay());
 
+            hitObject.StackHeightBindable.BindValueChanged(_ => updateMarkerDisplay());
+
             IsSelected.BindValueChanged(_ => updateMarkerDisplay());
 
             updateMarkerDisplay();

From 86def7e263ff0bc811a9f7cd4b51c4d7ee1d7129 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?=
 <32929093+honguyenminh@users.noreply.github.com>
Date: Sun, 31 Mar 2024 16:00:47 +0700
Subject: [PATCH 523/930] Change editor rotate button disabled tooltip text

Co-authored-by: Dean Herbert <pe@ppy.sh>
---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index 70441b33dd..da50233920 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             };
             selectionCentreButton.Selected.DisabledChanged += isDisabled =>
             {
-                selectionCentreButton.TooltipText = isDisabled ? "We can't rotate a circle around itself! Can we?" : string.Empty;
+                selectionCentreButton.TooltipText = isDisabled ? "Select more than one circles to perform rotation." : string.Empty;
             };
         }
 

From 19f0caa0f363427d0df39e5f9eb7e34c822f2699 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Sun, 31 Mar 2024 13:39:19 -0300
Subject: [PATCH 524/930] Fix wrong formatting in array creation

---
 .../Editor/TestScenePathControlPointVisualiser.cs              | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
index 0c12e6fb21..335ccb5280 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
@@ -177,7 +177,8 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         {
             createVisualiser(true);
 
-            Vector2[] points = [
+            Vector2[] points =
+            [
                 new Vector2(200),
                 new Vector2(300),
                 new Vector2(500, 300),

From 7615c71efef1742e2c19620086964474d03a69f4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 1 Apr 2024 15:28:20 +0900
Subject: [PATCH 525/930] Fix inspection

---
 .../Editor/TestScenePathControlPointVisualiser.cs              | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
index 335ccb5280..0ca30e00bc 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
@@ -199,8 +199,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         {
             createVisualiser(true);
 
-            Vector2 connectionPosition = default!;
-
+            Vector2 connectionPosition;
             addControlPointStep(connectionPosition = new Vector2(300));
             addControlPointStep(new Vector2(600));
 

From 099ad22a92658f8bc016a1abe72fb2b13fb99da6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 1 Apr 2024 15:31:34 +0900
Subject: [PATCH 526/930] Use local bindable instead

Binding events directly to an external bindable will cause that
bindable to hold a permanent reference to the current object.

We use `GetBoundCopy()` or otherwise a local bindable + `.BindTo()` to create a
weak-referenced copy of the target bindable. When the local bindable's
lifetime expires, so does the external bindable's reference to it.
---
 .../Sliders/Components/PathControlPointConnectionPiece.cs     | 4 +++-
 .../Blueprints/Sliders/Components/PathControlPointPiece.cs    | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
index 56dc16dd95..9b3d8fc7a7 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
@@ -28,6 +28,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         private IBindable<Vector2> hitObjectPosition;
         private IBindable<int> pathVersion;
+        private IBindable<int> stackHeight;
 
         public PathControlPointConnectionPiece(T hitObject, int controlPointIndex)
         {
@@ -56,7 +57,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             pathVersion = hitObject.Path.Version.GetBoundCopy();
             pathVersion.BindValueChanged(_ => Scheduler.AddOnce(updateConnectingPath));
 
-            hitObject.StackHeightBindable.BindValueChanged(_ => updateConnectingPath());
+            stackHeight = hitObject.StackHeightBindable.GetBoundCopy();
+            stackHeight.BindValueChanged(_ => updateConnectingPath());
 
             updateConnectingPath();
         }
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
index ee306fb6d7..c6e05d3ca3 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -48,6 +48,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         private IBindable<Vector2> hitObjectPosition;
         private IBindable<float> hitObjectScale;
+        private IBindable<int> stackHeight;
 
         public PathControlPointPiece(T hitObject, PathControlPoint controlPoint)
         {
@@ -105,7 +106,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             hitObjectScale = hitObject.ScaleBindable.GetBoundCopy();
             hitObjectScale.BindValueChanged(_ => updateMarkerDisplay());
 
-            hitObject.StackHeightBindable.BindValueChanged(_ => updateMarkerDisplay());
+            stackHeight = hitObject.StackHeightBindable.GetBoundCopy();
+            stackHeight.BindValueChanged(_ => updateMarkerDisplay());
 
             IsSelected.BindValueChanged(_ => updateMarkerDisplay());
 

From d12a2e7df7131fea37974bbb0707705cc2f0e977 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 1 Apr 2024 17:02:02 +0900
Subject: [PATCH 527/930] Replace schedule with SequenceEqual()

---
 osu.Game/Screens/Select/FilterControl.cs | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 7b8b5393bd..0bfd927234 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -218,12 +219,16 @@ namespace osu.Game.Screens.Select
             maximumStars.ValueChanged += _ => updateCriteria();
 
             ruleset.BindValueChanged(_ => updateCriteria());
-            mods.BindValueChanged(_ =>
+            mods.BindValueChanged(m =>
             {
-                // Mods are updated once by the mod select overlay when song select is entered, regardless of if there are any mods.
+                // Mods are updated once by the mod select overlay when song select is entered,
+                // regardless of if there are any mods or any changes have taken place.
                 // Updating the criteria here so early triggers a re-ordering of panels on song select, via... some mechanism.
-                // Todo: Investigate/fix the above and remove this schedule.
-                Scheduler.AddOnce(updateCriteria);
+                // Todo: Investigate/fix and potentially remove this.
+                if (m.NewValue.SequenceEqual(m.OldValue))
+                    return;
+
+                updateCriteria();
             });
 
             groupMode.BindValueChanged(_ => updateCriteria());

From 8e0ca11d1cca1571b0d0efd61e0322b618333e5d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 1 Apr 2024 17:02:32 +0900
Subject: [PATCH 528/930] Fully qualify LegacyBeatmapConversionDifficultyInfo

---
 osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs | 3 ---
 osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs            | 3 ++-
 osu.Game.Rulesets.Mania/ManiaRuleset.cs                   | 2 +-
 3 files changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
index bed04a882f..39ee3d209b 100644
--- a/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
+++ b/osu.Game.Rulesets.Mania/Beatmaps/ManiaBeatmapConverter.cs
@@ -98,9 +98,6 @@ namespace osu.Game.Rulesets.Mania.Beatmaps
             }
         }
 
-        public static int GetColumnCount(IBeatmapInfo beatmapInfo, IReadOnlyList<Mod>? mods = null)
-            => GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo), mods);
-
         public static int GetColumnCount(LegacyBeatmapConversionDifficultyInfo difficulty, IReadOnlyList<Mod>? mods = null)
         {
             var converter = new ManiaBeatmapConverter(null, difficulty, new ManiaRuleset());
diff --git a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
index 07ed3ebd63..ea7eb5b8f0 100644
--- a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
+++ b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
@@ -4,6 +4,7 @@
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Filter;
 using osu.Game.Rulesets.Mania.Beatmaps;
+using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
 
@@ -15,7 +16,7 @@ namespace osu.Game.Rulesets.Mania
 
         public bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria)
         {
-            return !keys.HasFilter || keys.IsInRange(ManiaBeatmapConverter.GetColumnCount(beatmapInfo, criteria.Mods));
+            return !keys.HasFilter || keys.IsInRange(ManiaBeatmapConverter.GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo), criteria.Mods));
         }
 
         public bool TryParseCustomKeywordCriteria(string key, Operator op, string value)
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 77168dca68..b5614e2b56 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Rulesets.Mania
         public override DifficultySection CreateEditorDifficultySection() => new ManiaDifficultySection();
 
         public int GetKeyCount(IBeatmapInfo beatmapInfo, IReadOnlyList<Mod>? mods = null)
-            => ManiaBeatmapConverter.GetColumnCount(beatmapInfo, mods);
+            => ManiaBeatmapConverter.GetColumnCount(LegacyBeatmapConversionDifficultyInfo.FromBeatmapInfo(beatmapInfo), mods);
     }
 
     public enum PlayfieldType

From 4806ea54f1a55c1220c0772d2b385f674a06661d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 1 Apr 2024 17:22:50 +0900
Subject: [PATCH 529/930] Only optimise Catmull segments in osu ruleset

---
 osu.Game.Rulesets.Osu/Objects/Slider.cs |  2 +-
 osu.Game/Rulesets/Objects/SliderPath.cs | 25 +++++++++++++++++++++++--
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Objects/Slider.cs b/osu.Game.Rulesets.Osu/Objects/Slider.cs
index 203e829180..cc3ffd376e 100644
--- a/osu.Game.Rulesets.Osu/Objects/Slider.cs
+++ b/osu.Game.Rulesets.Osu/Objects/Slider.cs
@@ -41,7 +41,7 @@ namespace osu.Game.Rulesets.Osu.Objects
 
         public Vector2 StackedPositionAt(double t) => StackedPosition + this.CurvePositionAt(t);
 
-        private readonly SliderPath path = new SliderPath();
+        private readonly SliderPath path = new SliderPath { OptimiseCatmull = true };
 
         public SliderPath Path
         {
diff --git a/osu.Game/Rulesets/Objects/SliderPath.cs b/osu.Game/Rulesets/Objects/SliderPath.cs
index 5398d6c45f..e8e769e3fa 100644
--- a/osu.Game/Rulesets/Objects/SliderPath.cs
+++ b/osu.Game/Rulesets/Objects/SliderPath.cs
@@ -134,6 +134,24 @@ namespace osu.Game.Rulesets.Objects
             }
         }
 
+        private bool optimiseCatmull;
+
+        /// <summary>
+        /// Whether to optimise Catmull path segments, usually resulting in removing bulbs around stacked knots.
+        /// </summary>
+        /// <remarks>
+        /// This changes the path shape and should therefore not be used.
+        /// </remarks>
+        public bool OptimiseCatmull
+        {
+            get => optimiseCatmull;
+            set
+            {
+                optimiseCatmull = value;
+                invalidate();
+            }
+        }
+
         /// <summary>
         /// Computes the slider path until a given progress that ranges from 0 (beginning of the slider)
         /// to 1 (end of the slider) and stores the generated path in the given list.
@@ -280,7 +298,7 @@ namespace osu.Game.Rulesets.Objects
                     calculatedPath.Add(segmentVertices[0]);
                 else if (segmentVertices.Length > 1)
                 {
-                    List<Vector2> subPath = calculateSubPath(segmentVertices, segmentType, ref optimisedLength);
+                    List<Vector2> subPath = calculateSubPath(segmentVertices, segmentType);
 
                     // Skip the first vertex if it is the same as the last vertex from the previous segment
                     bool skipFirst = calculatedPath.Count > 0 && subPath.Count > 0 && calculatedPath.Last() == subPath[0];
@@ -300,7 +318,7 @@ namespace osu.Game.Rulesets.Objects
             }
         }
 
-        private static List<Vector2> calculateSubPath(ReadOnlySpan<Vector2> subControlPoints, PathType type, ref double optimisedLength)
+        private List<Vector2> calculateSubPath(ReadOnlySpan<Vector2> subControlPoints, PathType type)
         {
             switch (type.Type)
             {
@@ -325,6 +343,9 @@ namespace osu.Game.Rulesets.Objects
                 {
                     List<Vector2> subPath = PathApproximator.CatmullToPiecewiseLinear(subControlPoints);
 
+                    if (!OptimiseCatmull)
+                        return subPath;
+
                     // At draw time, osu!stable optimises paths by only keeping piecewise segments that are 6px apart.
                     // For the most part we don't care about this optimisation, and its additional heuristics are hard to reproduce in every implementation.
                     //

From ed5dd5c8cd100f99223a20360e10e52668c64edb Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Apr 2024 13:04:34 +0800
Subject: [PATCH 530/930] Bind using local bindables to avoid potentially event
 pollution

---
 osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
index 3e2cbe9d60..9499bacade 100644
--- a/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
+++ b/osu.Game.Rulesets.Osu/Edit/TransformToolboxGroup.cs
@@ -22,6 +22,9 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private EditorToolButton rotateButton = null!;
 
+        private Bindable<bool> canRotatePlayfieldOrigin = null!;
+        private Bindable<bool> canRotateSelectionOrigin = null!;
+
         public SelectionRotationHandler RotationHandler { get; init; } = null!;
 
         public TransformToolboxGroup()
@@ -52,8 +55,11 @@ namespace osu.Game.Rulesets.Osu.Edit
             base.LoadComplete();
 
             // aggregate two values into canRotate
-            RotationHandler.CanRotatePlayfieldOrigin.BindValueChanged(_ => updateCanRotateAggregate());
-            RotationHandler.CanRotateSelectionOrigin.BindValueChanged(_ => updateCanRotateAggregate());
+            canRotatePlayfieldOrigin = RotationHandler.CanRotatePlayfieldOrigin.GetBoundCopy();
+            canRotatePlayfieldOrigin.BindValueChanged(_ => updateCanRotateAggregate());
+
+            canRotateSelectionOrigin = RotationHandler.CanRotateSelectionOrigin.GetBoundCopy();
+            canRotateSelectionOrigin.BindValueChanged(_ => updateCanRotateAggregate());
 
             void updateCanRotateAggregate()
             {

From eca242c1c73567433a25e34e075740b35ec7119d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 2 Apr 2024 13:17:16 +0800
Subject: [PATCH 531/930] Change tooltip text slightly

---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index da50233920..caf02d1dda 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             };
             selectionCentreButton.Selected.DisabledChanged += isDisabled =>
             {
-                selectionCentreButton.TooltipText = isDisabled ? "Select more than one circles to perform rotation." : string.Empty;
+                selectionCentreButton.TooltipText = isDisabled ? "Select more than one objects to perform selection-based rotation." : string.Empty;
             };
         }
 

From 6642702fa94e1819ec13243d87a6626c88e88a1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nguy=C3=AAn=20Minh=20H=E1=BB=93?=
 <32929093+honguyenminh@users.noreply.github.com>
Date: Tue, 2 Apr 2024 12:36:44 +0700
Subject: [PATCH 532/930] Update plurals in editor rotate button tooltip

Co-authored-by: Joseph Madamba <madamba.joehu@outlook.com>
---
 osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
index caf02d1dda..88c3d7414b 100644
--- a/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
+++ b/osu.Game.Rulesets.Osu/Edit/PreciseRotationPopover.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Rulesets.Osu.Edit
             };
             selectionCentreButton.Selected.DisabledChanged += isDisabled =>
             {
-                selectionCentreButton.TooltipText = isDisabled ? "Select more than one objects to perform selection-based rotation." : string.Empty;
+                selectionCentreButton.TooltipText = isDisabled ? "Select more than one object to perform selection-based rotation." : string.Empty;
             };
         }
 

From 2a2a372595a7a64dc1b2fe660e6f053e4522cd1e Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 2 Apr 2024 07:45:27 -0300
Subject: [PATCH 533/930] Check if `blueprint` is in `SelectionBlueprints`
 before changing its depth

---
 .../Editor/TestSceneObjectMerging.cs          | 132 ++++++++++++++++++
 .../Compose/Components/BlueprintContainer.cs  |   4 +-
 2 files changed, 135 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
index 3d35ab79f7..2da4c83a42 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
@@ -231,6 +231,138 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 (pos: circle2.Position, pathType: null)));
         }
 
+        [Test]
+        public void TestMergeSliderSliderSameStartTime()
+        {
+            Slider? slider1 = null;
+            SliderPath? slider1Path = null;
+            Slider? slider2 = null;
+
+            AddStep("select two sliders", () =>
+            {
+                slider1 = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider);
+                slider1Path = new SliderPath(slider1.Path.ControlPoints.Select(p => new PathControlPoint(p.Position, p.Type)).ToArray(), slider1.Path.ExpectedDistance.Value);
+                slider2 = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider && h.StartTime > slider1.StartTime);
+                EditorClock.Seek(slider1.StartTime);
+                EditorBeatmap.SelectedHitObjects.AddRange([slider1, slider2]);
+            });
+
+            AddStep("move sliders to the same start time", () =>
+            {
+                slider2!.StartTime = slider1!.StartTime;
+            });
+
+            mergeSelection();
+
+            AddAssert("slider created", () =>
+            {
+                if (slider1 is null || slider2 is null || slider1Path is null)
+                    return false;
+
+                var controlPoints1 = slider1Path.ControlPoints;
+                var controlPoints2 = slider2.Path.ControlPoints;
+                (Vector2, PathType?)[] args = new (Vector2, PathType?)[controlPoints1.Count + controlPoints2.Count - 1];
+
+                for (int i = 0; i < controlPoints1.Count - 1; i++)
+                {
+                    args[i] = (controlPoints1[i].Position + slider1.Position, controlPoints1[i].Type);
+                }
+
+                for (int i = 0; i < controlPoints2.Count; i++)
+                {
+                    args[i + controlPoints1.Count - 1] = (controlPoints2[i].Position + controlPoints1[^1].Position + slider1.Position, controlPoints2[i].Type);
+                }
+
+                return sliderCreatedFor(args);
+            });
+
+            AddAssert("samples exist", sliderSampleExist);
+
+            AddAssert("merged slider matches first slider", () =>
+            {
+                var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
+                return slider1 is not null && mergedSlider.HeadCircle.Samples.SequenceEqual(slider1.HeadCircle.Samples)
+                                           && mergedSlider.TailCircle.Samples.SequenceEqual(slider1.TailCircle.Samples)
+                                           && mergedSlider.Samples.SequenceEqual(slider1.Samples);
+            });
+
+            AddAssert("slider end is at same completion for last slider", () =>
+            {
+                if (slider1Path is null || slider2 is null)
+                    return false;
+
+                var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
+                return Precision.AlmostEquals(mergedSlider.Path.Distance, slider1Path.CalculatedDistance + slider2.Path.Distance);
+            });
+        }
+
+        [Test]
+        public void TestMergeSliderSliderSameStartAndEndTime()
+        {
+            Slider? slider1 = null;
+            SliderPath? slider1Path = null;
+            Slider? slider2 = null;
+
+            AddStep("select two sliders", () =>
+            {
+                slider1 = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider);
+                slider1Path = new SliderPath(slider1.Path.ControlPoints.Select(p => new PathControlPoint(p.Position, p.Type)).ToArray(), slider1.Path.ExpectedDistance.Value);
+                slider2 = (Slider)EditorBeatmap.HitObjects.First(h => h is Slider && h.StartTime > slider1.StartTime);
+                EditorClock.Seek(slider1.StartTime);
+                EditorBeatmap.SelectedHitObjects.AddRange([slider1, slider2]);
+            });
+
+            AddStep("move sliders to the same start & end time", () =>
+            {
+                slider2!.StartTime = slider1!.StartTime;
+                slider2.Path = slider1.Path;
+            });
+
+            mergeSelection();
+
+            AddAssert("slider created", () =>
+            {
+                if (slider1 is null || slider2 is null || slider1Path is null)
+                    return false;
+
+                var controlPoints1 = slider1Path.ControlPoints;
+                var controlPoints2 = slider2.Path.ControlPoints;
+                (Vector2, PathType?)[] args = new (Vector2, PathType?)[controlPoints1.Count + controlPoints2.Count - 1];
+
+                for (int i = 0; i < controlPoints1.Count - 1; i++)
+                {
+                    args[i] = (controlPoints1[i].Position + slider1.Position, controlPoints1[i].Type);
+                }
+
+                for (int i = 0; i < controlPoints2.Count; i++)
+                {
+                    args[i + controlPoints1.Count - 1] = (controlPoints2[i].Position + controlPoints1[^1].Position + slider1.Position, controlPoints2[i].Type);
+                }
+
+                return sliderCreatedFor(args);
+            });
+
+            AddAssert("samples exist", sliderSampleExist);
+
+            AddAssert("merged slider matches first slider", () =>
+            {
+                var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
+                return slider1 is not null && mergedSlider.HeadCircle.Samples.SequenceEqual(slider1.HeadCircle.Samples)
+                                           && mergedSlider.TailCircle.Samples.SequenceEqual(slider1.TailCircle.Samples)
+                                           && mergedSlider.Samples.SequenceEqual(slider1.Samples);
+            });
+
+            AddAssert("slider end is at same completion for last slider", () =>
+            {
+                if (slider1Path is null || slider2 is null)
+                    return false;
+
+                var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
+                return Precision.AlmostEquals(mergedSlider.Path.Distance, slider1Path.CalculatedDistance + slider2.Path.Distance);
+            });
+        }
+
+
         private void mergeSelection()
         {
             AddStep("merge selection", () =>
diff --git a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
index 2d6e234e57..c66be90605 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BlueprintContainer.cs
@@ -512,7 +512,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         protected virtual void OnBlueprintDeselected(SelectionBlueprint<T> blueprint)
         {
-            SelectionBlueprints.ChangeChildDepth(blueprint, 0);
+            if (SelectionBlueprints.Contains(blueprint))
+                SelectionBlueprints.ChangeChildDepth(blueprint, 0);
+
             SelectionHandler.HandleDeselected(blueprint);
         }
 

From 9315aefe41a48501aa6ad222df849d0dd9b3dc89 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 2 Apr 2024 08:48:01 -0300
Subject: [PATCH 534/930] Fix remove additional blank line

---
 osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
index 2da4c83a42..76982b05a7 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
@@ -362,7 +362,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             });
         }
 
-
         private void mergeSelection()
         {
             AddStep("merge selection", () =>

From 94cbe1838fff6ce48d01fccea2ba14ac9c5b2067 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 3 Apr 2024 01:50:39 +0800
Subject: [PATCH 535/930] Replace usages of `is null` with `== null`

---
 .../Editor/TestSceneObjectMerging.cs               | 14 +++++++-------
 .../Editor/TestSceneSliderSplitting.cs             |  6 +++---
 .../Blueprints/Sliders/SliderSelectionBlueprint.cs |  2 +-
 osu.Game/Overlays/Mods/ModSelectOverlay.cs         |  2 +-
 .../Objects/Legacy/ConvertHitObjectParser.cs       |  2 +-
 osu.Game/Rulesets/Objects/PathControlPoint.cs      |  2 +-
 osu.Game/Rulesets/Objects/SliderPathExtensions.cs  |  4 ++--
 osu.Game/Rulesets/UI/ModIcon.cs                    |  2 +-
 8 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
index 76982b05a7..dfe950c01e 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneObjectMerging.cs
@@ -68,7 +68,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider created", () =>
             {
-                if (circle1 is null || circle2 is null || slider is null)
+                if (circle1 == null || circle2 == null || slider == null)
                     return false;
 
                 var controlPoints = slider.Path.ControlPoints;
@@ -111,7 +111,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider created", () =>
             {
-                if (slider1 is null || slider2 is null || slider1Path is null)
+                if (slider1 == null || slider2 == null || slider1Path == null)
                     return false;
 
                 var controlPoints1 = slider1Path.ControlPoints;
@@ -143,7 +143,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider end is at same completion for last slider", () =>
             {
-                if (slider1Path is null || slider2 is null)
+                if (slider1Path == null || slider2 == null)
                     return false;
 
                 var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
@@ -256,7 +256,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider created", () =>
             {
-                if (slider1 is null || slider2 is null || slider1Path is null)
+                if (slider1 == null || slider2 == null || slider1Path == null)
                     return false;
 
                 var controlPoints1 = slider1Path.ControlPoints;
@@ -288,7 +288,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider end is at same completion for last slider", () =>
             {
-                if (slider1Path is null || slider2 is null)
+                if (slider1Path == null || slider2 == null)
                     return false;
 
                 var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
@@ -322,7 +322,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider created", () =>
             {
-                if (slider1 is null || slider2 is null || slider1Path is null)
+                if (slider1 == null || slider2 == null || slider1Path == null)
                     return false;
 
                 var controlPoints1 = slider1Path.ControlPoints;
@@ -354,7 +354,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddAssert("slider end is at same completion for last slider", () =>
             {
-                if (slider1Path is null || slider2 is null)
+                if (slider1Path == null || slider2 == null)
                     return false;
 
                 var mergedSlider = (Slider)EditorBeatmap.SelectedHitObjects.First();
diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSplitting.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSplitting.cs
index 6c7733e68a..d68cbe6265 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSplitting.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneSliderSplitting.cs
@@ -178,7 +178,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
 
             AddStep("add hitsounds", () =>
             {
-                if (slider is null) return;
+                if (slider == null) return;
 
                 sample = new HitSampleInfo("hitwhistle", HitSampleInfo.BANK_SOFT, volume: 70);
                 slider.Samples.Add(sample.With());
@@ -228,7 +228,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         {
             AddStep($"move mouse to control point {index}", () =>
             {
-                if (slider is null || visualiser is null) return;
+                if (slider == null || visualiser == null) return;
 
                 Vector2 position = slider.Path.ControlPoints[index].Position + slider.Position;
                 InputManager.MoveMouseTo(visualiser.Pieces[0].Parent!.ToScreenSpace(position));
@@ -239,7 +239,7 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
         {
             AddStep($"click context menu item \"{contextMenuText}\"", () =>
             {
-                if (visualiser is null) return;
+                if (visualiser == null) return;
 
                 MenuItem? item = visualiser.ContextMenuItems?.FirstOrDefault(menuItem => menuItem.Text.Value == contextMenuText);
 
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 4d2b980c23..2da462caf4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -311,7 +311,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
             foreach (var splitPoint in controlPointsToSplitAt)
             {
-                if (splitPoint == controlPoints[0] || splitPoint == controlPoints[^1] || splitPoint.Type is null)
+                if (splitPoint == controlPoints[0] || splitPoint == controlPoints[^1] || splitPoint.Type == null)
                     continue;
 
                 // Split off the section of slider before this control point so the remaining control points to split are in the latter part of the slider.
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 53c24dc828..3325cfe407 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -781,7 +781,7 @@ namespace osu.Game.Overlays.Mods
         /// </remarks>>
         public bool OnPressed(KeyBindingPressEvent<PlatformAction> e)
         {
-            if (e.Repeat || e.Action != PlatformAction.SelectAll || SelectAllModsButton is null)
+            if (e.Repeat || e.Action != PlatformAction.SelectAll || SelectAllModsButton == null)
                 return false;
 
             SelectAllModsButton.TriggerClick();
diff --git a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
index 283a59b7ed..66b3033f90 100644
--- a/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/ConvertHitObjectParser.cs
@@ -347,7 +347,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             // Edge-case rules (to match stable).
             if (type == PathType.PERFECT_CURVE)
             {
-                int endPointLength = endPoint is null ? 0 : 1;
+                int endPointLength = endPoint == null ? 0 : 1;
 
                 if (vertices.Length + endPointLength != 3)
                     type = PathType.BEZIER;
diff --git a/osu.Game/Rulesets/Objects/PathControlPoint.cs b/osu.Game/Rulesets/Objects/PathControlPoint.cs
index 1f8e63b269..32245e9080 100644
--- a/osu.Game/Rulesets/Objects/PathControlPoint.cs
+++ b/osu.Game/Rulesets/Objects/PathControlPoint.cs
@@ -77,7 +77,7 @@ namespace osu.Game.Rulesets.Objects
 
         public bool Equals(PathControlPoint other) => Position == other?.Position && Type == other.Type;
 
-        public override string ToString() => type is null
+        public override string ToString() => type == null
             ? $"Position={Position}"
             : $"Position={Position}, Type={type}";
     }
diff --git a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
index 29b34ae4f0..c03d3646da 100644
--- a/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
+++ b/osu.Game/Rulesets/Objects/SliderPathExtensions.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Rulesets.Objects
         {
             var controlPoints = sliderPath.ControlPoints;
 
-            var inheritedLinearPoints = controlPoints.Where(p => sliderPath.PointsInSegment(p)[0].Type == PathType.LINEAR && p.Type is null).ToList();
+            var inheritedLinearPoints = controlPoints.Where(p => sliderPath.PointsInSegment(p)[0].Type == PathType.LINEAR && p.Type == null).ToList();
 
             // Inherited points after a linear point, as well as the first control point if it inherited,
             // should be treated as linear points, so their types are temporarily changed to linear.
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Objects
             inheritedLinearPoints.ForEach(p => p.Type = null);
 
             // Recalculate middle perfect curve control points at the end of the slider path.
-            if (controlPoints.Count >= 3 && controlPoints[^3].Type == PathType.PERFECT_CURVE && controlPoints[^2].Type is null && segmentEnds.Any())
+            if (controlPoints.Count >= 3 && controlPoints[^3].Type == PathType.PERFECT_CURVE && controlPoints[^2].Type == null && segmentEnds.Any())
             {
                 double lastSegmentStart = segmentEnds.Length > 1 ? segmentEnds[^2] : 0;
                 double lastSegmentEnd = segmentEnds[^1];
diff --git a/osu.Game/Rulesets/UI/ModIcon.cs b/osu.Game/Rulesets/UI/ModIcon.cs
index d1776c5c0b..5d9fafd60c 100644
--- a/osu.Game/Rulesets/UI/ModIcon.cs
+++ b/osu.Game/Rulesets/UI/ModIcon.cs
@@ -177,7 +177,7 @@ namespace osu.Game.Rulesets.UI
             modAcronym.Text = value.Acronym;
             modIcon.Icon = value.Icon ?? FontAwesome.Solid.Question;
 
-            if (value.Icon is null)
+            if (value.Icon == null)
             {
                 modIcon.FadeOut();
                 modAcronym.FadeIn();

From b5adcf2e0e8f94056af1f868d3fcc1baf37f08c0 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 3 Apr 2024 17:32:02 +0900
Subject: [PATCH 536/930] Fix SpectatorClient holding references to Player

---
 osu.Game/Online/Spectator/SpectatorClient.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Online/Spectator/SpectatorClient.cs b/osu.Game/Online/Spectator/SpectatorClient.cs
index 07ee9115d6..fb7a3d13ca 100644
--- a/osu.Game/Online/Spectator/SpectatorClient.cs
+++ b/osu.Game/Online/Spectator/SpectatorClient.cs
@@ -248,6 +248,9 @@ namespace osu.Game.Online.Spectator
 
                 isPlaying = false;
                 currentBeatmap = null;
+                currentScore = null;
+                currentScoreProcessor = null;
+                currentScoreToken = null;
 
                 if (state.HasPassed)
                     currentState.State = SpectatedUserState.Passed;

From ce68f6adb76c909af038284621d410e720beae61 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 3 Apr 2024 17:46:26 +0900
Subject: [PATCH 537/930] Fix SkinEditor binding event to external bindable

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index d3af928907..ac9649bcba 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -52,6 +52,7 @@ namespace osu.Game.Overlays.SkinEditor
         private OsuTextFlowContainer headerText = null!;
 
         private Bindable<Skin> currentSkin = null!;
+        private Bindable<string> clipboardContent = null!;
 
         [Resolved]
         private OsuGame? game { get; set; }
@@ -243,7 +244,8 @@ namespace osu.Game.Overlays.SkinEditor
                 canCopy.Value = canCut.Value = SelectedComponents.Any();
             }, true);
 
-            clipboard.Content.BindValueChanged(content => canPaste.Value = !string.IsNullOrEmpty(content.NewValue), true);
+            clipboardContent = clipboard.Content.GetBoundCopy();
+            clipboardContent.BindValueChanged(content => canPaste.Value = !string.IsNullOrEmpty(content.NewValue), true);
 
             Show();
 

From 05fe8968d88f763621afe3042d665afaa8934331 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Apr 2024 11:39:12 +0200
Subject: [PATCH 538/930] Only interact with clipboard via bound copy

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index ac9649bcba..619eac8f4a 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -66,9 +66,6 @@ namespace osu.Game.Overlays.SkinEditor
         [Resolved]
         private RealmAccess realm { get; set; } = null!;
 
-        [Resolved]
-        private EditorClipboard clipboard { get; set; } = null!;
-
         [Resolved]
         private SkinEditorOverlay? skinEditorOverlay { get; set; }
 
@@ -114,7 +111,7 @@ namespace osu.Game.Overlays.SkinEditor
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(EditorClipboard clipboard)
         {
             RelativeSizeAxes = Axes.Both;
 
@@ -225,6 +222,8 @@ namespace osu.Game.Overlays.SkinEditor
                     }
                 }
             };
+
+            clipboardContent = clipboard.Content.GetBoundCopy();
         }
 
         protected override void LoadComplete()
@@ -244,7 +243,6 @@ namespace osu.Game.Overlays.SkinEditor
                 canCopy.Value = canCut.Value = SelectedComponents.Any();
             }, true);
 
-            clipboardContent = clipboard.Content.GetBoundCopy();
             clipboardContent.BindValueChanged(content => canPaste.Value = !string.IsNullOrEmpty(content.NewValue), true);
 
             Show();
@@ -497,7 +495,7 @@ namespace osu.Game.Overlays.SkinEditor
 
         protected void Copy()
         {
-            clipboard.Content.Value = JsonConvert.SerializeObject(SelectedComponents.Cast<Drawable>().Select(s => s.CreateSerialisedInfo()).ToArray());
+            clipboardContent.Value = JsonConvert.SerializeObject(SelectedComponents.Cast<Drawable>().Select(s => s.CreateSerialisedInfo()).ToArray());
         }
 
         protected void Clone()
@@ -517,7 +515,7 @@ namespace osu.Game.Overlays.SkinEditor
 
             changeHandler?.BeginChange();
 
-            var drawableInfo = JsonConvert.DeserializeObject<SerialisedDrawableInfo[]>(clipboard.Content.Value);
+            var drawableInfo = JsonConvert.DeserializeObject<SerialisedDrawableInfo[]>(clipboardContent.Value);
 
             if (drawableInfo == null)
                 return;

From 16276dfcd6ce5c35d50fa0c63877ff293c2bbdd0 Mon Sep 17 00:00:00 2001
From: Mafalda Fernandes <mafalda.m.fernandes@tecnico.ulisboa.pt>
Date: Mon, 1 Apr 2024 19:21:05 +0100
Subject: [PATCH 539/930] Fix #27105: Mod search box doesnt track external
 focus changes

In the Mod selection area, the search bar's focus could be changed by pressing TAB.
However, when clicking outside of the search bar, the focus would be killed but two TABs were required to get the focus back on the search bar.
This happened because the action of clicking in an empty area would trigger the search bar to change its appearence, but not its internal state.
In my solution, I made the OnClick function aware of the search bar's state, so it would not only change its appearance, but also its state.
Now, after clicking in an empty area, there is only needed one TAB to select the search box again, as expected.
---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 3325cfe407..5ca26c739e 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -420,7 +420,7 @@ namespace osu.Game.Overlays.Mods
                 yield return new ColumnDimContainer(new ModPresetColumn
                 {
                     Margin = new MarginPadding { Right = 10 }
-                });
+                }, this);
             }
 
             yield return createModColumnContent(ModType.DifficultyReduction);
@@ -438,7 +438,7 @@ namespace osu.Game.Overlays.Mods
                 column.Margin = new MarginPadding { Right = 10 };
             });
 
-            return new ColumnDimContainer(column);
+            return new ColumnDimContainer(column, this);
         }
 
         private void createLocalMods()
@@ -899,13 +899,17 @@ namespace osu.Game.Overlays.Mods
             [Resolved]
             private OsuColour colours { get; set; } = null!;
 
-            public ColumnDimContainer(ModSelectColumn column)
+            private ModSelectOverlay modSelectOverlayInstance;
+
+            public ColumnDimContainer(ModSelectColumn column, ModSelectOverlay modSelectOverlay)
             {
                 AutoSizeAxes = Axes.X;
                 RelativeSizeAxes = Axes.Y;
 
                 Child = Column = column;
                 column.Active.BindTo(Active);
+
+                this.modSelectOverlayInstance = modSelectOverlay;
             }
 
             [BackgroundDependencyLoader]
@@ -953,7 +957,7 @@ namespace osu.Game.Overlays.Mods
                     RequestScroll?.Invoke(this);
 
                 // Killing focus is done here because it's the only feasible place on ModSelectOverlay you can click on without triggering any action.
-                Scheduler.Add(() => GetContainingInputManager().ChangeFocus(null));
+                modSelectOverlayInstance.setTextBoxFocus(false);
 
                 return true;
             }

From 524a5815bc3bf0842e6161efe7719abea550713f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Apr 2024 16:11:23 +0200
Subject: [PATCH 540/930] Add test coverage

---
 .../Gameplay/TestSceneStoryboardWithIntro.cs  | 89 +++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs
new file mode 100644
index 0000000000..502a0de616
--- /dev/null
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs
@@ -0,0 +1,89 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Testing;
+using osu.Game.Beatmaps;
+using osu.Game.Configuration;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Objects;
+using osu.Game.Screens.Play;
+using osu.Game.Storyboards;
+using osuTK;
+
+namespace osu.Game.Tests.Visual.Gameplay
+{
+    public partial class TestSceneStoryboardWithIntro : PlayerTestScene
+    {
+        protected override bool HasCustomSteps => true;
+        protected override bool AllowFail => true;
+
+        protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
+
+        protected override IBeatmap CreateBeatmap(RulesetInfo ruleset)
+        {
+            var beatmap = new Beatmap();
+            beatmap.HitObjects.Add(new HitCircle { StartTime = firstObjectStartTime });
+            return beatmap;
+        }
+
+        protected override WorkingBeatmap CreateWorkingBeatmap(IBeatmap beatmap, Storyboard? storyboard = null)
+        {
+            return base.CreateWorkingBeatmap(beatmap, createStoryboard(storyboardStartTime));
+        }
+
+        private Storyboard createStoryboard(double startTime)
+        {
+            var storyboard = new Storyboard();
+            var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
+            sprite.TimelineGroup.Alpha.Add(Easing.None, startTime, 0, 0, 1);
+            storyboard.GetLayer("Background").Add(sprite);
+            return storyboard;
+        }
+
+        private double firstObjectStartTime;
+        private double storyboardStartTime;
+
+        [SetUpSteps]
+        public override void SetUpSteps()
+        {
+            base.SetUpSteps();
+            AddStep("enable storyboard", () => LocalConfig.SetValue(OsuSetting.ShowStoryboard, true));
+            AddStep("set dim level to 0", () => LocalConfig.SetValue<double>(OsuSetting.DimLevel, 0));
+            AddStep("reset first hitobject time", () => firstObjectStartTime = 0);
+            AddStep("reset storyboard start time", () => storyboardStartTime = 0);
+        }
+
+        [TestCase(-5000, 0)]
+        [TestCase(-5000, 30000)]
+        public void TestStoryboardSingleSkip(double storyboardStart, double firstObject)
+        {
+            AddStep($"set storyboard start time to {storyboardStart}", () => storyboardStartTime = storyboardStart);
+            AddStep($"set first object start time to {firstObject}", () => firstObjectStartTime = firstObject);
+            CreateTest();
+
+            AddStep("skip", () => InputManager.Key(osuTK.Input.Key.Space));
+            AddAssert("skip performed", () => Player.ChildrenOfType<SkipOverlay>().Any(s => s.SkipCount == 1));
+            AddUntilStep("gameplay clock advanced", () => Player.GameplayClockContainer.CurrentTime, () => Is.GreaterThanOrEqualTo(firstObject - 2000));
+        }
+
+        [Test]
+        public void TestStoryboardDoubleSkip()
+        {
+            AddStep("set storyboard start time to -11000", () => storyboardStartTime = -11000);
+            AddStep("set first object start time to 11000", () => firstObjectStartTime = 11000);
+            CreateTest();
+
+            AddStep("skip", () => InputManager.Key(osuTK.Input.Key.Space));
+            AddAssert("skip performed", () => Player.ChildrenOfType<SkipOverlay>().Any(s => s.SkipCount == 1));
+            AddUntilStep("gameplay clock advanced", () => Player.GameplayClockContainer.CurrentTime, () => Is.GreaterThanOrEqualTo(0));
+
+            AddStep("skip", () => InputManager.Key(osuTK.Input.Key.Space));
+            AddAssert("skip performed", () => Player.ChildrenOfType<SkipOverlay>().Any(s => s.SkipCount == 2));
+            AddUntilStep("gameplay clock advanced", () => Player.GameplayClockContainer.CurrentTime, () => Is.GreaterThanOrEqualTo(9000));
+        }
+    }
+}

From 9d54f1a09270b9d9758a2df837c958476e6ec16b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 3 Apr 2024 16:12:20 +0200
Subject: [PATCH 541/930] Fix some maps requiring multiple intro skips that
 weren't there on stable

Closes https://github.com/ppy/osu/issues/25633.

The reason why that particular beatmap did not have a double skip
on stable is here:

    https://github.com/peppy/osu-stable-reference/blob/e53980dd76857ee899f66ce519ba1597e7874f28/osu!/GameModes/Play/Player.cs#L1761-L1770

The particular place of interest is the `leadInTime < 10000` check.
If `leadInTime < 10000`, then `leadIn == leadInTime`, and it turns out
that `AudioEngine.Time` will always be more than or equal to `leadIn`,
because it's also the gameplay start time:

    https://github.com/peppy/osu-stable-reference/blob/e53980dd76857ee899f66ce519ba1597e7874f28/osu!/GameModes/Play/Player.cs#L2765

This essentially means that if the `leadInTime` is less than 10000,
that particular check is just dead. So a double skip can only occur
if the gameplay starts at time -10000 or earlier due to the storyboard.
---
 osu.Game/Screens/Play/MasterGameplayClockContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
index 93bdcb1cab..b2f0ae5561 100644
--- a/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
+++ b/osu.Game/Screens/Play/MasterGameplayClockContainer.cs
@@ -124,7 +124,7 @@ namespace osu.Game.Screens.Play
 
             double skipTarget = skipTargetTime - MINIMUM_SKIP_TIME;
 
-            if (GameplayClock.CurrentTime < 0 && skipTarget > 6000)
+            if (StartTime < -10000 && GameplayClock.CurrentTime < 0 && skipTarget > 6000)
                 // double skip exception for storyboards with very long intros
                 skipTarget = 0;
 

From 8e00368f7cf7a4be473d18316ca4fe56080918eb Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 3 Apr 2024 11:30:14 -0300
Subject: [PATCH 542/930] Add custom message in the case of a invalid
 beatmap_hash

---
 osu.Game/Screens/Play/SubmittingPlayer.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 62226c46dd..ce8260a52f 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -152,6 +152,10 @@ namespace osu.Game.Screens.Play
                                 Logger.Log($"Please ensure that you are using the latest version of the official game releases.\n\n{whatWillHappen}", level: LogLevel.Important);
                                 break;
 
+                            case @"invalid beatmap hash":
+                                Logger.Log($"A new version of this beatmapset is available please update. \n\n{whatWillHappen}", level: LogLevel.Important);
+                                break;
+
                             case @"expired token":
                                 Logger.Log($"Your system clock is set incorrectly. Please check your system time, date and timezone.\n\n{whatWillHappen}", level: LogLevel.Important);
                                 break;

From 9e92ebaa437c8adbbd2a406e8a493f8443d9d05d Mon Sep 17 00:00:00 2001
From: Arthur Araujo <90941580+64ArthurAraujo@users.noreply.github.com>
Date: Wed, 3 Apr 2024 19:15:22 -0300
Subject: [PATCH 543/930] Make message more general

Co-authored-by: Walavouchey <36758269+Walavouchey@users.noreply.github.com>
---
 osu.Game/Screens/Play/SubmittingPlayer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index ce8260a52f..8ccfd039ec 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -153,7 +153,7 @@ namespace osu.Game.Screens.Play
                                 break;
 
                             case @"invalid beatmap hash":
-                                Logger.Log($"A new version of this beatmapset is available please update. \n\n{whatWillHappen}", level: LogLevel.Important);
+                                Logger.Log($"This beatmap does not match the online version. Please update or redownload it.\n\n{whatWillHappen}", level: LogLevel.Important);
                                 break;
 
                             case @"expired token":

From 9521c1e3e42e4c73fd94f840ce41585ff0552570 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Apr 2024 14:31:40 +0800
Subject: [PATCH 544/930] Update hit error metre to use new icons

- [ ] Depends on https://github.com/ppy/osu-resources/pull/317.
---
 osu.Game/Graphics/OsuIcon.cs                              | 8 ++++++++
 .../Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs   | 4 ++--
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/OsuIcon.cs b/osu.Game/Graphics/OsuIcon.cs
index 3cd10b1315..32e780f11c 100644
--- a/osu.Game/Graphics/OsuIcon.cs
+++ b/osu.Game/Graphics/OsuIcon.cs
@@ -175,6 +175,8 @@ namespace osu.Game.Graphics
         public static IconUsage EditorSelect => get(OsuIconMapping.EditorSelect);
         public static IconUsage EditorSound => get(OsuIconMapping.EditorSound);
         public static IconUsage EditorWhistle => get(OsuIconMapping.EditorWhistle);
+        public static IconUsage Tortoise => get(OsuIconMapping.Tortoise);
+        public static IconUsage Hare => get(OsuIconMapping.Hare);
 
         private static IconUsage get(OsuIconMapping glyph) => new IconUsage((char)glyph, FONT_NAME);
 
@@ -380,6 +382,12 @@ namespace osu.Game.Graphics
 
             [Description(@"Editor/whistle")]
             EditorWhistle,
+
+            [Description(@"tortoise")]
+            Tortoise,
+
+            [Description(@"hare")]
+            Hare,
         }
 
         public class OsuIconStore : ITextureStore, ITexturedGlyphLookupStore
diff --git a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
index 443863fb2f..a71a46ec2a 100644
--- a/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
+++ b/osu.Game/Screens/Play/HUD/HitErrorMeters/BarHitErrorMeter.cs
@@ -303,13 +303,13 @@ namespace osu.Game.Screens.Play.HUD.HitErrorMeters
                     labelEarly.Child = new SpriteIcon
                     {
                         Size = new Vector2(icon_size),
-                        Icon = FontAwesome.Solid.ShippingFast,
+                        Icon = OsuIcon.Hare
                     };
 
                     labelLate.Child = new SpriteIcon
                     {
                         Size = new Vector2(icon_size),
-                        Icon = FontAwesome.Solid.Bicycle,
+                        Icon = OsuIcon.Tortoise
                     };
 
                     break;

From cd474de61f963c924d42291a8872ae7c6ffa0988 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 15:55:05 +0900
Subject: [PATCH 545/930] Update osu.Framework package

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 4901f30d8a..2d7a9d2652 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.306.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.329.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 0e091dbd37..cb691bf317 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.321.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 6b63bfa1e2..b2e3fc0779 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.306.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.329.0" />
   </ItemGroup>
 </Project>

From 10d1308a0a1b69a463be814639425b4967191689 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 4 Apr 2024 15:05:59 +0800
Subject: [PATCH 546/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 0e091dbd37..feaf47b809 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.306.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.321.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.404.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From fb8fb4f34e2e7ef325248aaf264f8035a05795fc Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 16:43:26 +0900
Subject: [PATCH 547/930] Disable Discord URI registration on macOS for now

---
 osu.Desktop/DiscordRichPresence.cs | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 6e8554d617..7553924d1b 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -6,6 +6,7 @@ using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
 using Newtonsoft.Json;
+using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
@@ -78,9 +79,13 @@ namespace osu.Desktop
             client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Message} ({e.Code})", LoggingTarget.Network, LogLevel.Error);
 
             // A URI scheme is required to support game invitations, as well as informing Discord of the game executable path to support launching the game when a user clicks on join/spectate.
-            client.RegisterUriScheme();
-            client.Subscribe(EventType.Join);
-            client.OnJoin += onJoin;
+            // The library doesn't properly support URI registration when ran from an app bundle on macOS.
+            if (!RuntimeInfo.IsApple)
+            {
+                client.RegisterUriScheme();
+                client.Subscribe(EventType.Join);
+                client.OnJoin += onJoin;
+            }
 
             config.BindWith(OsuSetting.DiscordRichPresence, privacyMode);
 

From 7b92c725b1e4004d1e082989522906335efe4859 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 5 Apr 2024 14:45:49 +0900
Subject: [PATCH 548/930] Revert "Merge pull request #27454 from
 EVAST9919/sb-lifetime-improvements"

This reverts commit 0881e7c8c1f003416cc37507ce6448f74e9d1a7f, reversing
changes made to 29a37e35852649c2f88b6c917b2921950c9e2dd9.
---
 osu.Game/Storyboards/CommandTimelineGroup.cs | 41 +++++++++++++-
 osu.Game/Storyboards/StoryboardSprite.cs     | 58 +-------------------
 2 files changed, 41 insertions(+), 58 deletions(-)

diff --git a/osu.Game/Storyboards/CommandTimelineGroup.cs b/osu.Game/Storyboards/CommandTimelineGroup.cs
index c899cf77d3..0b96db6861 100644
--- a/osu.Game/Storyboards/CommandTimelineGroup.cs
+++ b/osu.Game/Storyboards/CommandTimelineGroup.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Graphics;
@@ -45,10 +46,32 @@ namespace osu.Game.Storyboards
         }
 
         [JsonIgnore]
-        public double CommandsStartTime => timelines.Min(static t => t.StartTime);
+        public double CommandsStartTime
+        {
+            get
+            {
+                double min = double.MaxValue;
+
+                for (int i = 0; i < timelines.Length; i++)
+                    min = Math.Min(min, timelines[i].StartTime);
+
+                return min;
+            }
+        }
 
         [JsonIgnore]
-        public double CommandsEndTime => timelines.Max(static t => t.EndTime);
+        public double CommandsEndTime
+        {
+            get
+            {
+                double max = double.MinValue;
+
+                for (int i = 0; i < timelines.Length; i++)
+                    max = Math.Max(max, timelines[i].EndTime);
+
+                return max;
+            }
+        }
 
         [JsonIgnore]
         public double CommandsDuration => CommandsEndTime - CommandsStartTime;
@@ -60,7 +83,19 @@ namespace osu.Game.Storyboards
         public virtual double EndTime => CommandsEndTime;
 
         [JsonIgnore]
-        public bool HasCommands => timelines.Any(static t => t.HasCommands);
+        public bool HasCommands
+        {
+            get
+            {
+                for (int i = 0; i < timelines.Length; i++)
+                {
+                    if (timelines[i].HasCommands)
+                        return true;
+                }
+
+                return false;
+            }
+        }
 
         public virtual IEnumerable<CommandTimeline<T>.TypedCommand> GetCommands<T>(CommandTimelineSelector<T> timelineSelector, double offset = 0)
         {
diff --git a/osu.Game/Storyboards/StoryboardSprite.cs b/osu.Game/Storyboards/StoryboardSprite.cs
index 4992ae128d..982185d51b 100644
--- a/osu.Game/Storyboards/StoryboardSprite.cs
+++ b/osu.Game/Storyboards/StoryboardSprite.cs
@@ -85,23 +85,12 @@ namespace osu.Game.Storyboards
         {
             get
             {
-                double latestEndTime = double.MaxValue;
-
-                // Ignore the whole setup if there are loops. In theory they can be handled here too, however the logic will be overly complex.
-                if (loops.Count == 0)
-                {
-                    // Take the minimum time of all the potential "death" reasons.
-                    latestEndTime = calculateOptimisedEndTime(TimelineGroup);
-                }
-
-                // If the logic above fails to find anything or discarded by the fact that there are loops present, latestEndTime will be double.MaxValue
-                // and thus conservativeEndTime will be used.
-                double conservativeEndTime = TimelineGroup.EndTime;
+                double latestEndTime = TimelineGroup.EndTime;
 
                 foreach (var l in loops)
-                    conservativeEndTime = Math.Max(conservativeEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
+                    latestEndTime = Math.Max(latestEndTime, l.StartTime + l.CommandsDuration * l.TotalIterations);
 
-                return Math.Min(latestEndTime, conservativeEndTime);
+                return latestEndTime;
             }
         }
 
@@ -205,47 +194,6 @@ namespace osu.Game.Storyboards
             return commands;
         }
 
-        private static double calculateOptimisedEndTime(CommandTimelineGroup timelineGroup)
-        {
-            // Here we are starting from maximum value and trying to minimise the end time on each step.
-            // There are few solid guesses we can make using which sprite's end time can be minimised: alpha = 0, scale = 0, colour.a = 0.
-            double[] deathTimes =
-            {
-                double.MaxValue, // alpha
-                double.MaxValue, // colour alpha
-                double.MaxValue, // scale
-                double.MaxValue, // scale x
-                double.MaxValue, // scale y
-            };
-
-            // The loops below are following the same pattern.
-            // We could be using TimelineGroup.EndValue here, however it's possible to have multiple commands with 0 value in a row
-            // so we are saving the earliest of them.
-            foreach (var alphaCommand in timelineGroup.Alpha.Commands)
-            {
-                if (alphaCommand.EndValue == 0)
-                    // commands are ordered by the start time, however end time may vary. Save the earliest.
-                    deathTimes[0] = Math.Min(alphaCommand.EndTime, deathTimes[0]);
-                else
-                    // If value isn't 0 (sprite becomes visible again), revert the saved state.
-                    deathTimes[0] = double.MaxValue;
-            }
-
-            foreach (var colourCommand in timelineGroup.Colour.Commands)
-                deathTimes[1] = colourCommand.EndValue.A == 0 ? Math.Min(colourCommand.EndTime, deathTimes[1]) : double.MaxValue;
-
-            foreach (var scaleCommand in timelineGroup.Scale.Commands)
-                deathTimes[2] = scaleCommand.EndValue == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[2]) : double.MaxValue;
-
-            foreach (var scaleCommand in timelineGroup.VectorScale.Commands)
-            {
-                deathTimes[3] = scaleCommand.EndValue.X == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[3]) : double.MaxValue;
-                deathTimes[4] = scaleCommand.EndValue.Y == 0 ? Math.Min(scaleCommand.EndTime, deathTimes[4]) : double.MaxValue;
-            }
-
-            return deathTimes.Min();
-        }
-
         public override string ToString()
             => $"{Path}, {Origin}, {InitialPosition}";
 

From fefcd17db90150b8cd18079270a47cf173f96f47 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 8 Apr 2024 22:00:05 +0900
Subject: [PATCH 549/930] Fix gameplay PP counter not matching results screen

---
 .../Difficulty/DifficultyCalculator.cs        | 28 ++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 00c90bd317..5973a83fd3 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -108,9 +108,18 @@ namespace osu.Game.Rulesets.Difficulty
             var skills = CreateSkills(Beatmap, playableMods, clockRate);
             var progressiveBeatmap = new ProgressiveCalculationBeatmap(Beatmap);
 
+            // There is a one-to-many relationship between the hitobjects in the beatmap and the "difficulty hitobjects".
+            // Each iteration of the loop bellow will add at most one hitobject to the progressive beatmap,
+            // representing the most-parenting hitobject - the hitobject from the original beatmap.
+            Dictionary<HitObject, HitObject> hitObjectParentLinks =
+                createHitObjectParentLinks(Beatmap)
+                    .ToDictionary(k => k.obj, k => k.mostParentingObject);
+
             foreach (var hitObject in getDifficultyHitObjects())
             {
-                progressiveBeatmap.HitObjects.Add(hitObject.BaseObject);
+                HitObject parent = hitObjectParentLinks[hitObject.BaseObject];
+                if (progressiveBeatmap.HitObjects.Count == 0 || parent != progressiveBeatmap.HitObjects[^1])
+                    progressiveBeatmap.HitObjects.Add(parent);
 
                 foreach (var skill in skills)
                 {
@@ -122,6 +131,23 @@ namespace osu.Game.Rulesets.Difficulty
             }
 
             return attribs;
+
+            static IEnumerable<(HitObject obj, HitObject mostParentingObject)> createHitObjectParentLinks(IBeatmap beatmap)
+            {
+                foreach (var link in createNestedLinks(beatmap.HitObjects, null))
+                    yield return link;
+
+                static IEnumerable<(HitObject obj, HitObject mostParentingObject)> createNestedLinks(IReadOnlyList<HitObject> objects, [CanBeNull] HitObject parent)
+                {
+                    foreach (var o in objects)
+                    {
+                        yield return (o, parent ?? o);
+
+                        foreach (var n in createNestedLinks(o.NestedHitObjects, parent ?? o))
+                            yield return n;
+                    }
+                }
+            }
         }
 
         /// <summary>

From 7d8fe5117834aeb296cd6be28a89effa2bb9083f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 8 Apr 2024 23:25:45 +0900
Subject: [PATCH 550/930] Fix possible crash due to race in DiscordRichPresence

---
 osu.Desktop/DiscordRichPresence.cs | 22 ++++++++++++++++------
 1 file changed, 16 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 7553924d1b..ed9d4ca2d2 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -36,8 +36,6 @@ namespace osu.Desktop
         [Resolved]
         private IBindable<RulesetInfo> ruleset { get; set; } = null!;
 
-        private IBindable<APIUser> user = null!;
-
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
@@ -50,9 +48,11 @@ namespace osu.Desktop
         [Resolved]
         private MultiplayerClient multiplayerClient { get; set; } = null!;
 
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
         private readonly IBindable<UserStatus?> status = new Bindable<UserStatus?>();
         private readonly IBindable<UserActivity> activity = new Bindable<UserActivity>();
-
         private readonly Bindable<DiscordRichPresenceMode> privacyMode = new Bindable<DiscordRichPresenceMode>();
 
         private readonly RichPresence presence = new RichPresence
@@ -65,8 +65,10 @@ namespace osu.Desktop
             },
         };
 
+        private IBindable<APIUser>? user;
+
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load()
         {
             client = new DiscordRpcClient(client_id)
             {
@@ -87,6 +89,13 @@ namespace osu.Desktop
                 client.OnJoin += onJoin;
             }
 
+            client.Initialize();
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
             config.BindWith(OsuSetting.DiscordRichPresence, privacyMode);
 
             user = api.LocalUser.GetBoundCopy();
@@ -104,8 +113,6 @@ namespace osu.Desktop
             activity.BindValueChanged(_ => schedulePresenceUpdate());
             privacyMode.BindValueChanged(_ => schedulePresenceUpdate());
             multiplayerClient.RoomUpdated += onRoomUpdated;
-
-            client.Initialize();
         }
 
         private void onReady(object _, ReadyMessage __)
@@ -146,6 +153,9 @@ namespace osu.Desktop
 
         private void updatePresence(bool hideIdentifiableInformation)
         {
+            if (user == null)
+                return;
+
             // user activity
             if (activity.Value != null)
             {

From 14c26926f328c646ee3d7d4ec28f6199976238f8 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Tue, 9 Apr 2024 09:55:50 +0200
Subject: [PATCH 551/930] Upgrade to SDL3

---
 osu.Desktop/OsuGameDesktop.cs | 11 ++++++-----
 osu.Desktop/Program.cs        | 25 ++++++++++++++-----------
 2 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 2b232db274..e8783c997a 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -22,7 +22,7 @@ using osu.Game.IPC;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Performance;
 using osu.Game.Utils;
-using SDL2;
+using SDL;
 
 namespace osu.Desktop
 {
@@ -161,7 +161,7 @@ namespace osu.Desktop
             host.Window.Title = Name;
         }
 
-        protected override BatteryInfo CreateBatteryInfo() => new SDL2BatteryInfo();
+        protected override BatteryInfo CreateBatteryInfo() => new SDL3BatteryInfo();
 
         protected override void Dispose(bool isDisposing)
         {
@@ -170,13 +170,14 @@ namespace osu.Desktop
             archiveImportIPCChannel?.Dispose();
         }
 
-        private class SDL2BatteryInfo : BatteryInfo
+        private unsafe class SDL3BatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel
             {
                 get
                 {
-                    SDL.SDL_GetPowerInfo(out _, out int percentage);
+                    int percentage;
+                    SDL3.SDL_GetPowerInfo(null, &percentage);
 
                     if (percentage == -1)
                         return null;
@@ -185,7 +186,7 @@ namespace osu.Desktop
                 }
             }
 
-            public override bool OnBattery => SDL.SDL_GetPowerInfo(out _, out _) == SDL.SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
+            public override bool OnBattery => SDL3.SDL_GetPowerInfo(null, null) == SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
         }
     }
 }
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 2d7ec5aa5f..29b05a402f 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -13,7 +13,7 @@ using osu.Framework.Platform;
 using osu.Game;
 using osu.Game.IPC;
 using osu.Game.Tournament;
-using SDL2;
+using SDL;
 using Squirrel;
 
 namespace osu.Desktop
@@ -52,16 +52,19 @@ namespace osu.Desktop
                 // See https://www.mongodb.com/docs/realm/sdk/dotnet/compatibility/
                 if (windowsVersion.Major < 6 || (windowsVersion.Major == 6 && windowsVersion.Minor <= 2))
                 {
-                    // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
-                    // disabling it ourselves.
-                    // We could also better detect compatibility mode if required:
-                    // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
-                    SDL.SDL_ShowSimpleMessageBox(SDL.SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
-                        "Your operating system is too old to run osu!",
-                        "This version of osu! requires at least Windows 8.1 to run.\n"
-                        + "Please upgrade your operating system or consider using an older version of osu!.\n\n"
-                        + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!", IntPtr.Zero);
-                    return;
+                    unsafe
+                    {
+                        // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
+                        // disabling it ourselves.
+                        // We could also better detect compatibility mode if required:
+                        // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
+                        SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
+                            "Your operating system is too old to run osu!"u8,
+                            "This version of osu! requires at least Windows 8.1 to run.\n"u8
+                            + "Please upgrade your operating system or consider using an older version of osu!.\n\n"u8
+                            + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!"u8, null);
+                        return;
+                    }
                 }
 
                 setupSquirrel();

From 6cb5bffdfc07cbd17abe6bd4ddf01148d975d928 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 10 Apr 2024 13:03:37 +0800
Subject: [PATCH 552/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 61ad2a4f5a..3ea756a8b8 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.404.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From 3e8ddbd2a9d49173139dd06f709693d0999f456e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 11 Apr 2024 11:33:16 +0800
Subject: [PATCH 553/930] Add new entries to dotsettings (Rider 2024.1)

---
 osu.sln.DotSettings | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 452f90ecea..dd71744bf0 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -774,9 +774,19 @@ See the LICENCE file in the repository root for full licence text.&#xD;
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=PrivateStaticReadonly/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=StaticReadonly/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=TypeParameters/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=15b5b1f1_002D457c_002D4ca6_002Db278_002D5615aedc07d3/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static" AccessRightKinds="Private" Description="Static readonly fields (private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="READONLY_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=236f7aa5_002D7b06_002D43ca_002Dbf2a_002D9b31bfcff09a/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Private" Description="Constant fields (private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="CONSTANT_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=2c62818f_002D621b_002D4425_002Dadc9_002D78611099bfcb/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Any" Description="Type parameters"&gt;&lt;ElementKinds&gt;&lt;Kind Name="TYPE_PARAMETER" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=4a98fdf6_002D7d98_002D4f5a_002Dafeb_002Dea44ad98c70c/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Instance" AccessRightKinds="Private" Description="Instance fields (private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="FIELD" /&gt;&lt;Kind Name="READONLY_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb"&gt;&lt;ExtraRule Prefix="_" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=669e5282_002Dfb4b_002D4e90_002D91e7_002D07d269d04b60/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Protected, ProtectedInternal, Internal, Public, PrivateProtected" Description="Constant fields (not private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="CONSTANT_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=76f79b1e_002Dece7_002D4df2_002Da322_002D1bd7fea25eb7/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Any" Description="Local functions"&gt;&lt;ElementKinds&gt;&lt;Kind Name="LOCAL_FUNCTION" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=8b8504e3_002Df0be_002D4c14_002D9103_002Dc732f2bddc15/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Any" Description="Enum members"&gt;&lt;ElementKinds&gt;&lt;Kind Name="ENUM_MEMBER" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="False" Prefix="" Suffix="" Style="AaBb" /&gt;&lt;/Policy&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=9d1af99b_002Dbefe_002D48a4_002D9eb3_002D661384e29869/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static, Instance" AccessRightKinds="Private" Description="private methods"&gt;&lt;ElementKinds&gt;&lt;Kind Name="ASYNC_METHOD" /&gt;&lt;Kind Name="METHOD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=9ffbe43b_002Dc610_002D411b_002D9839_002D1416a146d9b0/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static, Instance" AccessRightKinds="Protected, ProtectedInternal, Internal, Public" Description="internal/protected/public methods"&gt;&lt;ElementKinds&gt;&lt;Kind Name="ASYNC_METHOD" /&gt;&lt;Kind Name="METHOD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;&lt;/Policy&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=a4c2df6c_002Db202_002D48d5_002Db077_002De678cb548c25/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static, Instance" AccessRightKinds="Private" Description="private properties"&gt;&lt;ElementKinds&gt;&lt;Kind Name="PROPERTY" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=a4f433b8_002Dabcd_002D4e55_002Da08f_002D82e78cef0f0c/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Any" AccessRightKinds="Any" Description="Local constants"&gt;&lt;ElementKinds&gt;&lt;Kind Name="LOCAL_CONSTANT" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aa_bb" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=c873eafb_002Dd57f_002D481d_002D8c93_002D77f6863c2f88/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static" AccessRightKinds="Protected, ProtectedInternal, Internal, Public, PrivateProtected" Description="Static readonly fields (not private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="READONLY_FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AA_BB" /&gt;&lt;/Policy&gt;</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=f9fce829_002De6f4_002D4cb2_002D80f1_002D5497c44f51df/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static" AccessRightKinds="Private" Description="Static fields (private)"&gt;&lt;ElementKinds&gt;&lt;Kind Name="FIELD" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;&lt;/Policy&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/UserRules/=fd562728_002Dc23d_002D417f_002Da19f_002D9d854247fbea/@EntryIndexedValue">&lt;Policy&gt;&lt;Descriptor Staticness="Static, Instance" AccessRightKinds="Protected, ProtectedInternal, Internal, Public" Description="internal/protected/public properties"&gt;&lt;ElementKinds&gt;&lt;Kind Name="PROPERTY" /&gt;&lt;/ElementKinds&gt;&lt;/Descriptor&gt;&lt;Policy Inspect="True" Prefix="" Suffix="" Style="AaBb" /&gt;&lt;/Policy&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/JavaScriptNaming/UserRules/=JS_005FBLOCK_005FSCOPE_005FCONSTANT/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/JavaScriptNaming/UserRules/=JS_005FBLOCK_005FSCOPE_005FFUNCTION/@EntryIndexedValue">&lt;Policy Inspect="True" Prefix="" Suffix="" Style="aaBb" /&gt;</s:String>
@@ -841,6 +851,7 @@ See the LICENCE file in the repository root for full licence text.&#xD;
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002ECSharpPlaceAttributeOnSameLineMigration/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateBlankLinesAroundFieldToBlankLinesAroundProperty/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EMigrateThisQualifierSettings/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/Environment/SettingsMigration/IsMigratorApplied/=JetBrains_002EReSharper_002EPsi_002ECSharp_002ECodeStyle_002ESettingsUpgrade_002EPredefinedNamingRulesToUserRulesUpgrade/@EntryIndexedValue">True</s:Boolean>
 	<s:String x:Key="/Default/Environment/UnitTesting/NUnitProvider/SetCurrentDirectoryTo/@EntryValue">TestFolder</s:String>
 	<s:Boolean x:Key="/Default/PatternsAndTemplates/LiveTemplates/Template/=28A2A5FC43E07C488A4BC7430879479E/@KeyIndexDefined">True</s:Boolean>
 	<s:Boolean x:Key="/Default/PatternsAndTemplates/LiveTemplates/Template/=28A2A5FC43E07C488A4BC7430879479E/Applicability/=Live/@EntryIndexedValue">True</s:Boolean>

From f5555b9fa4f82564b2fa17c41aa0af91ab9e177b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 11 Apr 2024 16:53:04 +0900
Subject: [PATCH 554/930] Also add potentially missed intermediate parents

---
 osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 5973a83fd3..084ead30c9 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -117,9 +117,11 @@ namespace osu.Game.Rulesets.Difficulty
 
             foreach (var hitObject in getDifficultyHitObjects())
             {
+                // Add hitobjects between the original and progressive beatmap until the current hitobject's parent appears in the progressive beatmap.
+                // This covers cases where hitobjects aren't assigned "difficulty" representations because they don't meaningfully contribute to the calculations.
                 HitObject parent = hitObjectParentLinks[hitObject.BaseObject];
-                if (progressiveBeatmap.HitObjects.Count == 0 || parent != progressiveBeatmap.HitObjects[^1])
-                    progressiveBeatmap.HitObjects.Add(parent);
+                while (progressiveBeatmap.HitObjects.LastOrDefault() != parent)
+                    progressiveBeatmap.HitObjects.Add(Beatmap.HitObjects[progressiveBeatmap.HitObjects.Count]);
 
                 foreach (var skill in skills)
                 {

From bf63ba3f82a367033d21f001c45d0951a36c38c4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 11 Apr 2024 17:56:34 +0900
Subject: [PATCH 555/930] Add test

---
 .../TestSceneTimedDifficultyCalculation.cs    | 191 ++++++++++++++++++
 1 file changed, 191 insertions(+)
 create mode 100644 osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs

diff --git a/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
new file mode 100644
index 0000000000..b0b06ce292
--- /dev/null
+++ b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
@@ -0,0 +1,191 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets;
+using osu.Game.Rulesets.Difficulty;
+using osu.Game.Rulesets.Difficulty.Preprocessing;
+using osu.Game.Rulesets.Difficulty.Skills;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Rulesets.UI;
+using osu.Game.Tests.Beatmaps;
+
+namespace osu.Game.Tests.NonVisual
+{
+    [TestFixture]
+    public class TestSceneTimedDifficultyCalculation
+    {
+        [Test]
+        public void TestAttributesGeneratedForAllNonSkippedObjects()
+        {
+            var beatmap = new Beatmap<TestHitObject>
+            {
+                HitObjects =
+                {
+                    new TestHitObject(),
+                    new TestHitObject { Nested = 1 },
+                    new TestHitObject(),
+                }
+            };
+
+            List<TimedDifficultyAttributes> attribs = new TestDifficultyCalculator(new TestWorkingBeatmap(beatmap)).CalculateTimed();
+
+            Assert.That(attribs.Count, Is.EqualTo(4));
+            assertEquals(attribs[0], beatmap.HitObjects[0]);
+            assertEquals(attribs[1], beatmap.HitObjects[0], beatmap.HitObjects[1]);
+            assertEquals(attribs[2], beatmap.HitObjects[0], beatmap.HitObjects[1]); // From the nested object.
+            assertEquals(attribs[3], beatmap.HitObjects[0], beatmap.HitObjects[1], beatmap.HitObjects[2]);
+        }
+
+        [Test]
+        public void TestAttributesNotGeneratedForSkippedObjects()
+        {
+            var beatmap = new Beatmap<TestHitObject>
+            {
+                HitObjects =
+                {
+                    // The first object is usually skipped in all implementations
+                    new TestHitObject { Skip = true },
+                    // An intermediate skipped object.
+                    new TestHitObject { Skip = true },
+                    new TestHitObject(),
+                }
+            };
+
+            List<TimedDifficultyAttributes> attribs = new TestDifficultyCalculator(new TestWorkingBeatmap(beatmap)).CalculateTimed();
+
+            Assert.That(attribs.Count, Is.EqualTo(1));
+            assertEquals(attribs[0], beatmap.HitObjects[0], beatmap.HitObjects[1], beatmap.HitObjects[2]);
+        }
+
+        [Test]
+        public void TestNestedObjectOnlyAddsParentOnce()
+        {
+            var beatmap = new Beatmap<TestHitObject>
+            {
+                HitObjects =
+                {
+                    new TestHitObject { Skip = true, Nested = 2 },
+                }
+            };
+
+            List<TimedDifficultyAttributes> attribs = new TestDifficultyCalculator(new TestWorkingBeatmap(beatmap)).CalculateTimed();
+
+            Assert.That(attribs.Count, Is.EqualTo(2));
+            assertEquals(attribs[0], beatmap.HitObjects[0]);
+            assertEquals(attribs[1], beatmap.HitObjects[0]);
+        }
+
+        private void assertEquals(TimedDifficultyAttributes attribs, params HitObject[] expected)
+        {
+            Assert.That(((TestDifficultyAttributes)attribs.Attributes).Objects, Is.EquivalentTo(expected));
+        }
+
+        private class TestHitObject : HitObject
+        {
+            /// <summary>
+            /// Whether to skip generating a difficulty representation for this object.
+            /// </summary>
+            public bool Skip { get; set; }
+
+            /// <summary>
+            /// Whether to generate nested difficulty representations for this object, and if so, how many.
+            /// </summary>
+            public int Nested { get; set; }
+
+            protected override void CreateNestedHitObjects(CancellationToken cancellationToken)
+            {
+                for (int i = 0; i < Nested; i++)
+                    AddNested(new TestHitObject());
+            }
+        }
+
+        private class TestRuleset : Ruleset
+        {
+            public override IEnumerable<Mod> GetModsFor(ModType type) => Enumerable.Empty<Mod>();
+
+            public override DrawableRuleset CreateDrawableRulesetWith(IBeatmap beatmap, IReadOnlyList<Mod>? mods = null) => throw new NotImplementedException();
+
+            public override IBeatmapConverter CreateBeatmapConverter(IBeatmap beatmap) => new PassThroughBeatmapConverter(beatmap);
+
+            public override DifficultyCalculator CreateDifficultyCalculator(IWorkingBeatmap beatmap) => new TestDifficultyCalculator(beatmap);
+
+            public override string Description => string.Empty;
+            public override string ShortName => string.Empty;
+
+            private class PassThroughBeatmapConverter : IBeatmapConverter
+            {
+                public event Action<HitObject, IEnumerable<HitObject>>? ObjectConverted
+                {
+                    add { }
+                    remove { }
+                }
+
+                public IBeatmap Beatmap { get; }
+
+                public PassThroughBeatmapConverter(IBeatmap beatmap)
+                {
+                    Beatmap = beatmap;
+                }
+
+                public bool CanConvert() => true;
+
+                public IBeatmap Convert(CancellationToken cancellationToken = default) => Beatmap;
+            }
+        }
+
+        private class TestDifficultyCalculator : DifficultyCalculator
+        {
+            public TestDifficultyCalculator(IWorkingBeatmap beatmap)
+                : base(new TestRuleset().RulesetInfo, beatmap)
+            {
+            }
+
+            protected override DifficultyAttributes CreateDifficultyAttributes(IBeatmap beatmap, Mod[] mods, Skill[] skills, double clockRate)
+                => new TestDifficultyAttributes { Objects = beatmap.HitObjects.ToArray() };
+
+            protected override IEnumerable<DifficultyHitObject> CreateDifficultyHitObjects(IBeatmap beatmap, double clockRate)
+            {
+                List<DifficultyHitObject> objects = new List<DifficultyHitObject>();
+
+                foreach (var obj in beatmap.HitObjects.OfType<TestHitObject>())
+                {
+                    if (!obj.Skip)
+                        objects.Add(new DifficultyHitObject(obj, obj, clockRate, objects, objects.Count));
+
+                    foreach (var nested in obj.NestedHitObjects)
+                        objects.Add(new DifficultyHitObject(nested, nested, clockRate, objects, objects.Count));
+                }
+
+                return objects;
+            }
+
+            protected override Skill[] CreateSkills(IBeatmap beatmap, Mod[] mods, double clockRate) => new Skill[] { new PassThroughSkill(mods) };
+
+            private class PassThroughSkill : Skill
+            {
+                public PassThroughSkill(Mod[] mods)
+                    : base(mods)
+                {
+                }
+
+                public override void Process(DifficultyHitObject current)
+                {
+                }
+
+                public override double DifficultyValue() => 1;
+            }
+        }
+
+        private class TestDifficultyAttributes : DifficultyAttributes
+        {
+            public HitObject[] Objects = Array.Empty<HitObject>();
+        }
+    }
+}

From 19cc847be6dd9674ac374d3bfef7e9a295f08e9f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 11 Apr 2024 23:40:40 +0900
Subject: [PATCH 556/930] Implement a less failure-prone method

---
 .../TestSceneTimedDifficultyCalculation.cs    | 33 ++++++++++++----
 .../Difficulty/DifficultyCalculator.cs        | 39 +++++--------------
 2 files changed, 35 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
index b0b06ce292..4c32d3bf1c 100644
--- a/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
+++ b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
@@ -28,9 +28,13 @@ namespace osu.Game.Tests.NonVisual
             {
                 HitObjects =
                 {
-                    new TestHitObject(),
-                    new TestHitObject { Nested = 1 },
-                    new TestHitObject(),
+                    new TestHitObject { StartTime = 1 },
+                    new TestHitObject
+                    {
+                        StartTime = 2,
+                        Nested = 1
+                    },
+                    new TestHitObject { StartTime = 3 },
                 }
             };
 
@@ -51,10 +55,18 @@ namespace osu.Game.Tests.NonVisual
                 HitObjects =
                 {
                     // The first object is usually skipped in all implementations
-                    new TestHitObject { Skip = true },
+                    new TestHitObject
+                    {
+                        StartTime = 1,
+                        Skip = true
+                    },
                     // An intermediate skipped object.
-                    new TestHitObject { Skip = true },
-                    new TestHitObject(),
+                    new TestHitObject
+                    {
+                        StartTime = 2,
+                        Skip = true
+                    },
+                    new TestHitObject { StartTime = 3 },
                 }
             };
 
@@ -71,7 +83,12 @@ namespace osu.Game.Tests.NonVisual
             {
                 HitObjects =
                 {
-                    new TestHitObject { Skip = true, Nested = 2 },
+                    new TestHitObject
+                    {
+                        StartTime = 1,
+                        Skip = true,
+                        Nested = 2
+                    },
                 }
             };
 
@@ -102,7 +119,7 @@ namespace osu.Game.Tests.NonVisual
             protected override void CreateNestedHitObjects(CancellationToken cancellationToken)
             {
                 for (int i = 0; i < Nested; i++)
-                    AddNested(new TestHitObject());
+                    AddNested(new TestHitObject { StartTime = StartTime + 0.1 * i });
             }
         }
 
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 084ead30c9..5d608deae2 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -108,20 +108,18 @@ namespace osu.Game.Rulesets.Difficulty
             var skills = CreateSkills(Beatmap, playableMods, clockRate);
             var progressiveBeatmap = new ProgressiveCalculationBeatmap(Beatmap);
 
-            // There is a one-to-many relationship between the hitobjects in the beatmap and the "difficulty hitobjects".
-            // Each iteration of the loop bellow will add at most one hitobject to the progressive beatmap,
-            // representing the most-parenting hitobject - the hitobject from the original beatmap.
-            Dictionary<HitObject, HitObject> hitObjectParentLinks =
-                createHitObjectParentLinks(Beatmap)
-                    .ToDictionary(k => k.obj, k => k.mostParentingObject);
-
             foreach (var hitObject in getDifficultyHitObjects())
             {
-                // Add hitobjects between the original and progressive beatmap until the current hitobject's parent appears in the progressive beatmap.
-                // This covers cases where hitobjects aren't assigned "difficulty" representations because they don't meaningfully contribute to the calculations.
-                HitObject parent = hitObjectParentLinks[hitObject.BaseObject];
-                while (progressiveBeatmap.HitObjects.LastOrDefault() != parent)
-                    progressiveBeatmap.HitObjects.Add(Beatmap.HitObjects[progressiveBeatmap.HitObjects.Count]);
+                // Implementations expect the progressive beatmap to only contain top-level objects from the original beatmap.
+                // At the same time, we also need to consider the possibility DHOs may not be generated for any given object,
+                // so we'll add all remaining objects up to the current point in time to the progressive beatmap.
+                for (int i = progressiveBeatmap.HitObjects.Count; i < Beatmap.HitObjects.Count; i++)
+                {
+                    if (Beatmap.HitObjects[i].StartTime > hitObject.BaseObject.StartTime)
+                        break;
+
+                    progressiveBeatmap.HitObjects.Add(Beatmap.HitObjects[i]);
+                }
 
                 foreach (var skill in skills)
                 {
@@ -133,23 +131,6 @@ namespace osu.Game.Rulesets.Difficulty
             }
 
             return attribs;
-
-            static IEnumerable<(HitObject obj, HitObject mostParentingObject)> createHitObjectParentLinks(IBeatmap beatmap)
-            {
-                foreach (var link in createNestedLinks(beatmap.HitObjects, null))
-                    yield return link;
-
-                static IEnumerable<(HitObject obj, HitObject mostParentingObject)> createNestedLinks(IReadOnlyList<HitObject> objects, [CanBeNull] HitObject parent)
-                {
-                    foreach (var o in objects)
-                    {
-                        yield return (o, parent ?? o);
-
-                        foreach (var n in createNestedLinks(o.NestedHitObjects, parent ?? o))
-                            yield return n;
-                    }
-                }
-            }
         }
 
         /// <summary>

From e9b319f4c6e43d2488cf4ebee2c9d56f7f828b70 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 12 Apr 2024 00:11:54 +0900
Subject: [PATCH 557/930] Ensure all remaining objects are added in the last
 iteration

---
 .../TestSceneTimedDifficultyCalculation.cs    | 27 +++++++++++++++++++
 .../Difficulty/DifficultyCalculator.cs        |  9 ++++---
 2 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
index 4c32d3bf1c..1a75f735ef 100644
--- a/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
+++ b/osu.Game.Tests/NonVisual/TestSceneTimedDifficultyCalculation.cs
@@ -99,6 +99,33 @@ namespace osu.Game.Tests.NonVisual
             assertEquals(attribs[1], beatmap.HitObjects[0]);
         }
 
+        [Test]
+        public void TestSkippedLastObjectAddedInLastIteration()
+        {
+            var beatmap = new Beatmap<TestHitObject>
+            {
+                HitObjects =
+                {
+                    new TestHitObject { StartTime = 1 },
+                    new TestHitObject
+                    {
+                        StartTime = 2,
+                        Skip = true
+                    },
+                    new TestHitObject
+                    {
+                        StartTime = 3,
+                        Skip = true
+                    },
+                }
+            };
+
+            List<TimedDifficultyAttributes> attribs = new TestDifficultyCalculator(new TestWorkingBeatmap(beatmap)).CalculateTimed();
+
+            Assert.That(attribs.Count, Is.EqualTo(1));
+            assertEquals(attribs[0], beatmap.HitObjects[0], beatmap.HitObjects[1], beatmap.HitObjects[2]);
+        }
+
         private void assertEquals(TimedDifficultyAttributes attribs, params HitObject[] expected)
         {
             Assert.That(((TestDifficultyAttributes)attribs.Attributes).Objects, Is.EquivalentTo(expected));
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 5d608deae2..1599dff8d9 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -107,15 +107,16 @@ namespace osu.Game.Rulesets.Difficulty
 
             var skills = CreateSkills(Beatmap, playableMods, clockRate);
             var progressiveBeatmap = new ProgressiveCalculationBeatmap(Beatmap);
+            var difficultyObjects = getDifficultyHitObjects().ToArray();
 
-            foreach (var hitObject in getDifficultyHitObjects())
+            foreach (var obj in difficultyObjects)
             {
                 // Implementations expect the progressive beatmap to only contain top-level objects from the original beatmap.
                 // At the same time, we also need to consider the possibility DHOs may not be generated for any given object,
                 // so we'll add all remaining objects up to the current point in time to the progressive beatmap.
                 for (int i = progressiveBeatmap.HitObjects.Count; i < Beatmap.HitObjects.Count; i++)
                 {
-                    if (Beatmap.HitObjects[i].StartTime > hitObject.BaseObject.StartTime)
+                    if (obj != difficultyObjects[^1] && Beatmap.HitObjects[i].StartTime > obj.BaseObject.StartTime)
                         break;
 
                     progressiveBeatmap.HitObjects.Add(Beatmap.HitObjects[i]);
@@ -124,10 +125,10 @@ namespace osu.Game.Rulesets.Difficulty
                 foreach (var skill in skills)
                 {
                     cancellationToken.ThrowIfCancellationRequested();
-                    skill.Process(hitObject);
+                    skill.Process(obj);
                 }
 
-                attribs.Add(new TimedDifficultyAttributes(hitObject.EndTime * clockRate, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
+                attribs.Add(new TimedDifficultyAttributes(obj.EndTime * clockRate, CreateDifficultyAttributes(progressiveBeatmap, playableMods, skills, clockRate)));
             }
 
             return attribs;

From 8b2017be453fb03905bc857bd117c2555cb05e69 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 12 Apr 2024 01:02:40 +0900
Subject: [PATCH 558/930] Update Sentry to fix iOS build

---
 osu.Game/Utils/SentryLogger.cs | 2 +-
 osu.Game/osu.Game.csproj       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 61622a7122..896f4daf33 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Utils
             localUser = user.GetBoundCopy();
             localUser.BindValueChanged(u =>
             {
-                SentrySdk.ConfigureScope(scope => scope.User = new User
+                SentrySdk.ConfigureScope(scope => scope.User = new SentryUser
                 {
                     Username = u.NewValue.Username,
                     Id = u.NewValue.Id.ToString(),
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 3ea756a8b8..21b5bc60a5 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -37,7 +37,7 @@
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
-    <PackageReference Include="Sentry" Version="3.41.3" />
+    <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />
     <PackageReference Include="NUnit" Version="3.14.0" />

From 3ec93745a45127a204b1b25df81784bc1392ac2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Apr 2024 01:07:52 +0800
Subject: [PATCH 559/930] Fix test failures due to sentry oversight

---
 osu.Game/Utils/SentryLogger.cs | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Utils/SentryLogger.cs b/osu.Game/Utils/SentryLogger.cs
index 896f4daf33..8d3e5fb834 100644
--- a/osu.Game/Utils/SentryLogger.cs
+++ b/osu.Game/Utils/SentryLogger.cs
@@ -39,12 +39,13 @@ namespace osu.Game.Utils
         public SentryLogger(OsuGame game)
         {
             this.game = game;
+
+            if (!game.IsDeployedBuild || !game.CreateEndpoints().WebsiteRootUrl.EndsWith(@".ppy.sh", StringComparison.Ordinal))
+                return;
+
             sentrySession = SentrySdk.Init(options =>
             {
-                // Not setting the dsn will completely disable sentry.
-                if (game.IsDeployedBuild && game.CreateEndpoints().WebsiteRootUrl.EndsWith(@".ppy.sh", StringComparison.Ordinal))
-                    options.Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2";
-
+                options.Dsn = "https://ad9f78529cef40ac874afb95a9aca04e@sentry.ppy.sh/2";
                 options.AutoSessionTracking = true;
                 options.IsEnvironmentUser = false;
                 options.IsGlobalModeEnabled = true;
@@ -59,6 +60,9 @@ namespace osu.Game.Utils
 
         public void AttachUser(IBindable<APIUser> user)
         {
+            if (sentrySession == null)
+                return;
+
             Debug.Assert(localUser == null);
 
             localUser = user.GetBoundCopy();

From c0dce94f1593ef13d3d9bb214d2ef32331da1f07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Apr 2024 16:24:46 +0800
Subject: [PATCH 560/930] Fix newly placed items in skin editor not getting
 correct anchor placement

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index 619eac8f4a..bc929177d1 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -454,6 +454,7 @@ namespace osu.Game.Overlays.SkinEditor
             }
 
             SelectedComponents.Add(component);
+            SkinSelectionHandler.ApplyClosestAnchor(drawableComponent);
             return true;
         }
 
@@ -666,8 +667,6 @@ namespace osu.Game.Overlays.SkinEditor
 
                 SelectedComponents.Clear();
                 placeComponent(sprite, false);
-
-                SkinSelectionHandler.ApplyClosestAnchor(sprite);
             });
 
             return Task.CompletedTask;

From c7f3a599c98f49e821e5790a436ff508e90ce097 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Sat, 13 Apr 2024 13:17:06 +0900
Subject: [PATCH 561/930] Fix crash when entering multiplayer on macOS

---
 osu.Desktop/DiscordRichPresence.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index ed9d4ca2d2..f1c796d0cd 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -205,7 +205,9 @@ namespace osu.Desktop
                     Password = room.Settings.Password,
                 };
 
-                presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
+                if (client.HasRegisteredUriScheme)
+                    presence.Secrets.JoinSecret = JsonConvert.SerializeObject(roomSecret);
+
                 // discord cannot handle both secrets and buttons at the same time, so we need to choose something.
                 // the multiplayer room seems more important.
                 presence.Buttons = null;

From feb9b5bdb8a74e566e35d00ce23e492f129b6f05 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sat, 13 Apr 2024 13:42:57 +0300
Subject: [PATCH 562/930] Make traceable pp match HD

---
 .../Difficulty/OsuPerformanceCalculator.cs             | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index 4771bce280..e7e9308eb5 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -118,8 +118,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             }
             else if (score.Mods.Any(h => h is OsuModTraceable))
             {
-                // Default 2% increase and another is scaled by AR
-                aimValue *= 1.02 + 0.02 * (12.0 - attributes.ApproachRate);
+                // The same as HD, placeholder bonus
+                aimValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
 
             // We assume 15% of sliders in a map are difficult since there's no way to tell from the performance calculator.
@@ -174,8 +174,8 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             }
             else if (score.Mods.Any(h => h is OsuModTraceable))
             {
-                // More reward for speed because speed on Traceable is annoying
-                speedValue *= 1.04 + 0.06 * (12.0 - attributes.ApproachRate);
+                // The same as HD, placeholder bonus
+                speedValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
 
             // Calculate accuracy assuming the worst case scenario
@@ -225,7 +225,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             else if (score.Mods.Any(m => m is OsuModHidden))
                 accuracyValue *= 1.08;
             else if (score.Mods.Any(m => m is OsuModTraceable))
-                accuracyValue *= 1.02 + 0.01 * (12.0 - attributes.ApproachRate);
+                accuracyValue *= 1.08;
 
             if (score.Mods.Any(m => m is OsuModFlashlight))
                 accuracyValue *= 1.02;

From 4a21ff97263ac0219905e7a4fc51b8d5e1c55705 Mon Sep 17 00:00:00 2001
From: Givikap120 <givikap120@gmail.com>
Date: Sat, 13 Apr 2024 13:59:09 +0300
Subject: [PATCH 563/930] removed duplication

---
 .../Difficulty/OsuPerformanceCalculator.cs     | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
index e7e9308eb5..18a4b8be0c 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/OsuPerformanceCalculator.cs
@@ -111,16 +111,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
 
             if (score.Mods.Any(m => m is OsuModBlinds))
                 aimValue *= 1.3 + (totalHits * (0.0016 / (1 + 2 * effectiveMissCount)) * Math.Pow(accuracy, 16)) * (1 - 0.003 * attributes.DrainRate * attributes.DrainRate);
-            else if (score.Mods.Any(h => h is OsuModHidden))
+            else if (score.Mods.Any(m => m is OsuModHidden || m is OsuModTraceable))
             {
                 // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
                 aimValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
-            else if (score.Mods.Any(h => h is OsuModTraceable))
-            {
-                // The same as HD, placeholder bonus
-                aimValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
-            }
 
             // We assume 15% of sliders in a map are difficult since there's no way to tell from the performance calculator.
             double estimateDifficultSliders = attributes.SliderCount * 0.15;
@@ -167,16 +162,11 @@ namespace osu.Game.Rulesets.Osu.Difficulty
                 // Increasing the speed value by object count for Blinds isn't ideal, so the minimum buff is given.
                 speedValue *= 1.12;
             }
-            else if (score.Mods.Any(m => m is OsuModHidden))
+            else if (score.Mods.Any(m => m is OsuModHidden || m is OsuModTraceable))
             {
                 // We want to give more reward for lower AR when it comes to aim and HD. This nerfs high AR and buffs lower AR.
                 speedValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
             }
-            else if (score.Mods.Any(h => h is OsuModTraceable))
-            {
-                // The same as HD, placeholder bonus
-                speedValue *= 1.0 + 0.04 * (12.0 - attributes.ApproachRate);
-            }
 
             // Calculate accuracy assuming the worst case scenario
             double relevantTotalDiff = totalHits - attributes.SpeedNoteCount;
@@ -222,9 +212,7 @@ namespace osu.Game.Rulesets.Osu.Difficulty
             // Increasing the accuracy value by object count for Blinds isn't ideal, so the minimum buff is given.
             if (score.Mods.Any(m => m is OsuModBlinds))
                 accuracyValue *= 1.14;
-            else if (score.Mods.Any(m => m is OsuModHidden))
-                accuracyValue *= 1.08;
-            else if (score.Mods.Any(m => m is OsuModTraceable))
+            else if (score.Mods.Any(m => m is OsuModHidden || m is OsuModTraceable))
                 accuracyValue *= 1.08;
 
             if (score.Mods.Any(m => m is OsuModFlashlight))

From 5a8b8908dd5ba8064f87d803fb1308340139582a Mon Sep 17 00:00:00 2001
From: Loreos7 <i_lariyhj@mail.ru>
Date: Sat, 13 Apr 2024 14:53:51 +0300
Subject: [PATCH 564/930] fix missing underscore

---
 osu.Game/Screens/Play/SubmittingPlayer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/SubmittingPlayer.cs b/osu.Game/Screens/Play/SubmittingPlayer.cs
index 8ccfd039ec..6c5f7fab9e 100644
--- a/osu.Game/Screens/Play/SubmittingPlayer.cs
+++ b/osu.Game/Screens/Play/SubmittingPlayer.cs
@@ -152,7 +152,7 @@ namespace osu.Game.Screens.Play
                                 Logger.Log($"Please ensure that you are using the latest version of the official game releases.\n\n{whatWillHappen}", level: LogLevel.Important);
                                 break;
 
-                            case @"invalid beatmap hash":
+                            case @"invalid beatmap_hash":
                                 Logger.Log($"This beatmap does not match the online version. Please update or redownload it.\n\n{whatWillHappen}", level: LogLevel.Important);
                                 break;
 

From 9833dd955f8c09ff8455ab499257ac044362414c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Vaj=C4=8F=C3=A1k?= <ondrej@vajdak.cz>
Date: Sun, 14 Apr 2024 01:30:59 +0200
Subject: [PATCH 565/930] Fix toolbar volume bar masking

---
 osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 5da0056787..718789e3c7 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.Toolbar
 {
     public partial class ToolbarMusicButton : ToolbarOverlayToggleButton
     {
-        private Circle volumeBar;
+        private Box volumeBar;
 
         protected override Anchor TooltipAnchor => Anchor.TopRight;
 
@@ -45,14 +45,15 @@ namespace osu.Game.Overlays.Toolbar
                 Height = IconContainer.Height,
                 Margin = new MarginPadding { Horizontal = 2.5f },
                 Masking = true,
-                Children = new[]
+                CornerRadius = 3f,
+                Children = new Drawable[]
                 {
                     new Circle
                     {
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4.White.Opacity(0.25f),
                     },
-                    volumeBar = new Circle
+                    volumeBar = new Box
                     {
                         RelativeSizeAxes = Axes.Both,
                         Height = 0f,

From ed6680a61d535849beb78bd26738e55172e2aabc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Vaj=C4=8F=C3=A1k?= <ondrej@vajdak.cz>
Date: Sun, 14 Apr 2024 15:10:05 +0200
Subject: [PATCH 566/930] Fixed type inconsistency and rounding

---
 osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
index 718789e3c7..51b95b7d32 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarMusicButton.cs
@@ -37,7 +37,7 @@ namespace osu.Game.Overlays.Toolbar
             StateContainer = music;
 
             Flow.Padding = new MarginPadding { Horizontal = Toolbar.HEIGHT / 4 };
-            Flow.Add(volumeDisplay = new Container
+            Flow.Add(volumeDisplay = new CircularContainer
             {
                 Anchor = Anchor.CentreLeft,
                 Origin = Anchor.CentreLeft,
@@ -45,10 +45,9 @@ namespace osu.Game.Overlays.Toolbar
                 Height = IconContainer.Height,
                 Margin = new MarginPadding { Horizontal = 2.5f },
                 Masking = true,
-                CornerRadius = 3f,
-                Children = new Drawable[]
+                Children = new[]
                 {
-                    new Circle
+                    new Box
                     {
                         RelativeSizeAxes = Axes.Both,
                         Colour = Color4.White.Opacity(0.25f),

From f282152f996b3e15dffa9ae7564c1e09788430dd Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 14 Apr 2024 15:53:29 -0700
Subject: [PATCH 567/930] Enable NRT to `ScoreManager`

---
 .../Database/BackgroundDataStoreProcessor.cs   | 17 ++++++++++-------
 osu.Game/Scoring/ScoreManager.cs               | 18 ++++++++----------
 osu.Game/Screens/Play/SaveFailedScoreButton.cs |  2 +-
 3 files changed, 19 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Database/BackgroundDataStoreProcessor.cs b/osu.Game/Database/BackgroundDataStoreProcessor.cs
index 872194aa1d..52336c0242 100644
--- a/osu.Game/Database/BackgroundDataStoreProcessor.cs
+++ b/osu.Game/Database/BackgroundDataStoreProcessor.cs
@@ -287,14 +287,17 @@ namespace osu.Game.Database
                 {
                     var score = scoreManager.Query(s => s.ID == id);
 
-                    scoreManager.PopulateMaximumStatistics(score);
-
-                    // Can't use async overload because we're not on the update thread.
-                    // ReSharper disable once MethodHasAsyncOverload
-                    realmAccess.Write(r =>
+                    if (score != null)
                     {
-                        r.Find<ScoreInfo>(id)!.MaximumStatisticsJson = JsonConvert.SerializeObject(score.MaximumStatistics);
-                    });
+                        scoreManager.PopulateMaximumStatistics(score);
+
+                        // Can't use async overload because we're not on the update thread.
+                        // ReSharper disable once MethodHasAsyncOverload
+                        realmAccess.Write(r =>
+                        {
+                            r.Find<ScoreInfo>(id)!.MaximumStatisticsJson = JsonConvert.SerializeObject(score.MaximumStatistics);
+                        });
+                    }
 
                     ++processedCount;
                 }
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 1ee99e9e93..1cdf4b0c13 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
@@ -28,7 +26,7 @@ namespace osu.Game.Scoring
     public class ScoreManager : ModelManager<ScoreInfo>, IModelImporter<ScoreInfo>
     {
         private readonly Func<BeatmapManager> beatmaps;
-        private readonly OsuConfigManager configManager;
+        private readonly OsuConfigManager? configManager;
         private readonly ScoreImporter scoreImporter;
         private readonly LegacyScoreExporter scoreExporter;
 
@@ -43,7 +41,7 @@ namespace osu.Game.Scoring
         }
 
         public ScoreManager(RulesetStore rulesets, Func<BeatmapManager> beatmaps, Storage storage, RealmAccess realm, IAPIProvider api,
-                            OsuConfigManager configManager = null)
+                            OsuConfigManager? configManager = null)
             : base(storage, realm)
         {
             this.beatmaps = beatmaps;
@@ -67,7 +65,7 @@ namespace osu.Game.Scoring
         /// </summary>
         /// <param name="query">The query.</param>
         /// <returns>The first result for the provided query, or null if no results were found.</returns>
-        public ScoreInfo Query(Expression<Func<ScoreInfo, bool>> query)
+        public ScoreInfo? Query(Expression<Func<ScoreInfo, bool>> query)
         {
             return Realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
@@ -104,7 +102,7 @@ namespace osu.Game.Scoring
             /// </summary>
             /// <param name="score">The <see cref="ScoreInfo"/> to provide the total score of.</param>
             /// <param name="configManager">The config.</param>
-            public TotalScoreBindable(ScoreInfo score, OsuConfigManager configManager)
+            public TotalScoreBindable(ScoreInfo score, OsuConfigManager? configManager)
             {
                 configManager?.BindWith(OsuSetting.ScoreDisplayMode, scoringMode);
                 scoringMode.BindValueChanged(mode => Value = score.GetDisplayScore(mode.NewValue), true);
@@ -126,7 +124,7 @@ namespace osu.Game.Scoring
             }
         }
 
-        public void Delete([CanBeNull] Expression<Func<ScoreInfo, bool>> filter = null, bool silent = false)
+        public void Delete(Expression<Func<ScoreInfo, bool>>? filter = null, bool silent = false)
         {
             Realm.Run(r =>
             {
@@ -165,9 +163,9 @@ namespace osu.Game.Scoring
 
         public Task Export(ScoreInfo score) => scoreExporter.ExportAsync(score.ToLive(Realm));
 
-        public Task<Live<ScoreInfo>> ImportAsUpdate(ProgressNotification notification, ImportTask task, ScoreInfo original) => scoreImporter.ImportAsUpdate(notification, task, original);
+        public Task<Live<ScoreInfo>?> ImportAsUpdate(ProgressNotification notification, ImportTask task, ScoreInfo original) => scoreImporter.ImportAsUpdate(notification, task, original);
 
-        public Live<ScoreInfo> Import(ScoreInfo item, ArchiveReader archive = null, ImportParameters parameters = default, CancellationToken cancellationToken = default) =>
+        public Live<ScoreInfo>? Import(ScoreInfo item, ArchiveReader? archive = null, ImportParameters parameters = default, CancellationToken cancellationToken = default) =>
             scoreImporter.ImportModel(item, archive, parameters, cancellationToken);
 
         /// <summary>
@@ -182,7 +180,7 @@ namespace osu.Game.Scoring
 
         #region Implementation of IPresentImports<ScoreInfo>
 
-        public Action<IEnumerable<Live<ScoreInfo>>> PresentImport
+        public Action<IEnumerable<Live<ScoreInfo>>>? PresentImport
         {
             set => scoreImporter.PresentImport = value;
         }
diff --git a/osu.Game/Screens/Play/SaveFailedScoreButton.cs b/osu.Game/Screens/Play/SaveFailedScoreButton.cs
index ef27aac1b9..4f665b87e8 100644
--- a/osu.Game/Screens/Play/SaveFailedScoreButton.cs
+++ b/osu.Game/Screens/Play/SaveFailedScoreButton.cs
@@ -137,7 +137,7 @@ namespace osu.Game.Screens.Play
         {
             if (state.NewValue != DownloadState.LocallyAvailable) return;
 
-            scoreManager.Export(importedScore);
+            if (importedScore != null) scoreManager.Export(importedScore);
 
             this.state.ValueChanged -= exportWhenReady;
         }

From ed8b59632561cfbbfa7e949daa4709660cc3356d Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 14 Apr 2024 16:22:58 -0700
Subject: [PATCH 568/930] Fix replay export not working correctly from online
 leaderboards

---
 osu.Game/OsuGame.cs                           | 19 ++---------
 osu.Game/Scoring/ScoreManager.cs              | 34 +++++++++++++++++--
 .../Screens/Ranking/ReplayDownloadButton.cs   |  4 ++-
 3 files changed, 36 insertions(+), 21 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 732d5f867c..bcf12b308d 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -706,24 +706,9 @@ namespace osu.Game
         {
             Logger.Log($"Beginning {nameof(PresentScore)} with score {score}");
 
-            // The given ScoreInfo may have missing properties if it was retrieved from online data. Re-retrieve it from the database
-            // to ensure all the required data for presenting a replay are present.
-            ScoreInfo databasedScoreInfo = null;
+            ScoreInfo databasedScoreInfo = ScoreManager.GetDatabasedScoreInfo(score);
 
-            if (score.OnlineID > 0)
-                databasedScoreInfo = ScoreManager.Query(s => s.OnlineID == score.OnlineID);
-
-            if (score.LegacyOnlineID > 0)
-                databasedScoreInfo ??= ScoreManager.Query(s => s.LegacyOnlineID == score.LegacyOnlineID);
-
-            if (score is ScoreInfo scoreInfo)
-                databasedScoreInfo ??= ScoreManager.Query(s => s.Hash == scoreInfo.Hash);
-
-            if (databasedScoreInfo == null)
-            {
-                Logger.Log("The requested score could not be found locally.", LoggingTarget.Information);
-                return;
-            }
+            if (databasedScoreInfo == null) return;
 
             var databasedScore = ScoreManager.GetScore(databasedScoreInfo);
 
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 1cdf4b0c13..f699e32ac7 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -8,8 +8,8 @@ using System.Linq;
 using System.Linq.Expressions;
 using System.Threading;
 using System.Threading.Tasks;
-using JetBrains.Annotations;
 using osu.Framework.Bindables;
+using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Beatmaps;
 using osu.Game.Configuration;
@@ -70,6 +70,34 @@ namespace osu.Game.Scoring
             return Realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
+        /// <summary>
+        /// Re-retrieve a given <see cref="IScoreInfo"/> from the database to ensure all the required data for presenting / exporting a replay are present.
+        /// </summary>
+        /// <param name="originalScoreInfo">The <see cref="IScoreInfo"/> to attempt querying on.</param>
+        /// <returns>The databased score info. Null if the score on the database cannot be found.</returns>
+        /// <remarks>Can be used when the <see cref="IScoreInfo"/> was retrieved from online data, as it may have missing properties.</remarks>
+        public ScoreInfo? GetDatabasedScoreInfo(IScoreInfo originalScoreInfo)
+        {
+            ScoreInfo? databasedScoreInfo = null;
+
+            if (originalScoreInfo.OnlineID > 0)
+                databasedScoreInfo = Query(s => s.OnlineID == originalScoreInfo.OnlineID);
+
+            if (originalScoreInfo.LegacyOnlineID > 0)
+                databasedScoreInfo ??= Query(s => s.LegacyOnlineID == originalScoreInfo.LegacyOnlineID);
+
+            if (originalScoreInfo is ScoreInfo scoreInfo)
+                databasedScoreInfo ??= Query(s => s.Hash == scoreInfo.Hash);
+
+            if (databasedScoreInfo == null)
+            {
+                Logger.Log("The requested score could not be found locally.", LoggingTarget.Information);
+                return null;
+            }
+
+            return databasedScoreInfo;
+        }
+
         /// <summary>
         /// Retrieves a bindable that represents the total score of a <see cref="ScoreInfo"/>.
         /// </summary>
@@ -78,7 +106,7 @@ namespace osu.Game.Scoring
         /// </remarks>
         /// <param name="score">The <see cref="ScoreInfo"/> to retrieve the bindable for.</param>
         /// <returns>The bindable containing the total score.</returns>
-        public Bindable<long> GetBindableTotalScore([NotNull] ScoreInfo score) => new TotalScoreBindable(score, configManager);
+        public Bindable<long> GetBindableTotalScore(ScoreInfo score) => new TotalScoreBindable(score, configManager);
 
         /// <summary>
         /// Retrieves a bindable that represents the formatted total score string of a <see cref="ScoreInfo"/>.
@@ -88,7 +116,7 @@ namespace osu.Game.Scoring
         /// </remarks>
         /// <param name="score">The <see cref="ScoreInfo"/> to retrieve the bindable for.</param>
         /// <returns>The bindable containing the formatted total score string.</returns>
-        public Bindable<string> GetBindableTotalScoreString([NotNull] ScoreInfo score) => new TotalScoreStringBindable(GetBindableTotalScore(score));
+        public Bindable<string> GetBindableTotalScoreString(ScoreInfo score) => new TotalScoreStringBindable(GetBindableTotalScore(score));
 
         /// <summary>
         /// Provides the total score of a <see cref="ScoreInfo"/>. Responds to changes in the currently-selected <see cref="ScoringMode"/>.
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index df5f9c7a8a..9bacfc5ed3 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -147,7 +147,9 @@ namespace osu.Game.Screens.Ranking
         {
             if (state.NewValue != DownloadState.LocallyAvailable) return;
 
-            scoreManager.Export(Score.Value);
+            ScoreInfo? databasedScoreInfo = scoreManager.GetDatabasedScoreInfo(Score.Value);
+
+            if (databasedScoreInfo != null) scoreManager.Export(databasedScoreInfo);
 
             State.ValueChanged -= exportWhenReady;
         }

From 8506da725dcf0aac225bd6ab5c230fb0150827e3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 15 Apr 2024 11:49:47 +0200
Subject: [PATCH 569/930] Add failing test

---
 .../TestSceneExpandedPanelMiddleContent.cs        | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
index 9f7726313a..02a321d22f 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneExpandedPanelMiddleContent.cs
@@ -104,6 +104,21 @@ namespace osu.Game.Tests.Visual.Ranking
             });
         }
 
+        [Test]
+        public void TestPPNotShownAsProvisionalIfClassicModIsPresentDueToLegacyScore()
+        {
+            AddStep("show example score", () =>
+            {
+                var score = TestResources.CreateTestScoreInfo(createTestBeatmap(new RealmUser()));
+                score.PP = 400;
+                score.Mods = score.Mods.Append(new OsuModClassic()).ToArray();
+                score.IsLegacyScore = true;
+                showPanel(score);
+            });
+
+            AddAssert("pp display faded out", () => this.ChildrenOfType<PerformanceStatistic>().Single().Alpha == 1);
+        }
+
         [Test]
         public void TestWithDefaultDate()
         {

From 7c4c8ee75c746620f955f1fbb2b1e43f26badf4a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 15 Apr 2024 11:53:03 +0200
Subject: [PATCH 570/930] Fix stable scores showing with faded out pp display
 due to classic mod presence

---
 .../Expanded/Statistics/PerformanceStatistic.cs    | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 0a9c68eafc..8366f8d7ef 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -4,6 +4,7 @@
 #nullable disable
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
 using System.Threading.Tasks;
@@ -17,6 +18,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Scoring;
 using osu.Game.Localisation;
+using osu.Game.Rulesets.Mods;
 
 namespace osu.Game.Screens.Ranking.Expanded.Statistics
 {
@@ -74,7 +76,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
                     Alpha = 0.5f;
                     TooltipText = ResultsScreenStrings.NoPPForUnrankedBeatmaps;
                 }
-                else if (scoreInfo.Mods.Any(m => !m.Ranked))
+                else if (hasUnrankedMods(scoreInfo))
                 {
                     Alpha = 0.5f;
                     TooltipText = ResultsScreenStrings.NoPPForUnrankedMods;
@@ -87,6 +89,16 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
             }
         }
 
+        private static bool hasUnrankedMods(ScoreInfo scoreInfo)
+        {
+            IEnumerable<Mod> modsToCheck = scoreInfo.Mods;
+
+            if (scoreInfo.IsLegacyScore)
+                modsToCheck = modsToCheck.Where(m => m is not ModClassic);
+
+            return modsToCheck.Any(m => !m.Ranked);
+        }
+
         public override void Appear()
         {
             base.Appear();

From fe7df808b6065dcbb405f7775fdaaa0d5a441f52 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Apr 2024 21:07:08 +0900
Subject: [PATCH 571/930] Add tests

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index ce241f3676..e03ffd48f1 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -29,6 +29,7 @@ using osu.Game.Overlays.Dialog;
 using osu.Game.Overlays.Mods;
 using osu.Game.Overlays.Notifications;
 using osu.Game.Rulesets;
+using osu.Game.Rulesets.Mania.Mods;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
@@ -1147,6 +1148,62 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddAssert("filter text cleared", () => songSelect!.FilterControl.ChildrenOfType<FilterControl.FilterControlTextBox>().First().Text, () => Is.Empty);
         }
 
+        [Test]
+        public void TestNonFilterableModChange()
+        {
+            addRulesetImportStep(0);
+
+            createSongSelect();
+
+            // Mod that is guaranteed to never re-filter.
+            AddStep("add non-filterable mod", () => SelectedMods.Value = new Mod[] { new OsuModCinema() });
+            AddAssert("filter count is 1", () => songSelect!.FilterCount, () => Is.EqualTo(1));
+
+            // Removing the mod should still not re-filter.
+            AddStep("remove non-filterable mod", () => SelectedMods.Value = Array.Empty<Mod>());
+            AddAssert("filter count is 1", () => songSelect!.FilterCount, () => Is.EqualTo(1));
+        }
+
+        [Test]
+        public void TestFilterableModChange()
+        {
+            addRulesetImportStep(3);
+
+            createSongSelect();
+
+            // Change to mania ruleset.
+            AddStep("filter to mania ruleset", () => Ruleset.Value = rulesets.AvailableRulesets.First(r => r.OnlineID == 3));
+            AddAssert("filter count is 2", () => songSelect!.FilterCount, () => Is.EqualTo(2));
+
+            // Apply a mod, but this should NOT re-filter because there's no search text.
+            AddStep("add filterable mod", () => SelectedMods.Value = new Mod[] { new ManiaModKey3() });
+            AddAssert("filter count is 2", () => songSelect!.FilterCount, () => Is.EqualTo(2));
+
+            // Set search text. Should re-filter.
+            AddStep("set search text to match mods", () => songSelect!.FilterControl.CurrentTextSearch.Value = "keys=3");
+            AddAssert("filter count is 3", () => songSelect!.FilterCount, () => Is.EqualTo(3));
+
+            // Change filterable mod. Should re-filter.
+            AddStep("change new filterable mod", () => SelectedMods.Value = new Mod[] { new ManiaModKey5() });
+            AddAssert("filter count is 4", () => songSelect!.FilterCount, () => Is.EqualTo(4));
+
+            // Add non-filterable mod. Should NOT re-filter.
+            AddStep("apply non-filterable mod", () => SelectedMods.Value = new Mod[] { new ManiaModNoFail(), new ManiaModKey5() });
+            AddAssert("filter count is 4", () => songSelect!.FilterCount, () => Is.EqualTo(4));
+
+            // Remove filterable mod. Should re-filter.
+            AddStep("remove filterable mod", () => SelectedMods.Value = new Mod[] { new ManiaModNoFail() });
+            AddAssert("filter count is 5", () => songSelect!.FilterCount, () => Is.EqualTo(5));
+
+            // Remove non-filterable mod. Should NOT re-filter.
+            AddStep("remove filterable mod", () => SelectedMods.Value = Array.Empty<Mod>());
+            AddAssert("filter count is 5", () => songSelect!.FilterCount, () => Is.EqualTo(5));
+
+            // Add filterable mod. Should re-filter.
+            AddStep("add filterable mod", () => SelectedMods.Value = new Mod[] { new ManiaModKey3() });
+            AddAssert("filter count is 6", () => songSelect!.FilterCount, () => Is.EqualTo(6));
+        }
+
         private void waitForInitialSelection()
         {
             AddUntilStep("wait for initial selection", () => !Beatmap.IsDefault);

From 343b3ba0e614dcfd68e9f3b6046b7d119776c95e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 15 Apr 2024 21:07:36 +0900
Subject: [PATCH 572/930] Don't re-filter unless mods may change the filter

---
 .../ManiaFilterCriteria.cs                    | 20 +++++++++++++++++++
 .../NonVisual/Filtering/FilterMatchingTest.cs |  5 +++++
 .../Filtering/FilterQueryParserTest.cs        |  5 +++++
 .../Rulesets/Filter/IRulesetFilterCriteria.cs | 10 ++++++++++
 osu.Game/Screens/Select/FilterControl.cs      | 13 ++++++------
 5 files changed, 47 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
index ea7eb5b8f0..8c6efbc72d 100644
--- a/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
+++ b/osu.Game.Rulesets.Mania/ManiaFilterCriteria.cs
@@ -1,9 +1,14 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Filter;
 using osu.Game.Rulesets.Mania.Beatmaps;
+using osu.Game.Rulesets.Mania.Mods;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
@@ -30,5 +35,20 @@ namespace osu.Game.Rulesets.Mania
 
             return false;
         }
+
+        public bool FilterMayChangeFromMods(ValueChangedEvent<IReadOnlyList<Mod>> mods)
+        {
+            if (keys.HasFilter)
+            {
+                // Interpreting as the Mod type is required for equality comparison.
+                HashSet<Mod> oldSet = mods.OldValue.OfType<ManiaKeyMod>().AsEnumerable<Mod>().ToHashSet();
+                HashSet<Mod> newSet = mods.NewValue.OfType<ManiaKeyMod>().AsEnumerable<Mod>().ToHashSet();
+
+                if (!oldSet.SetEquals(newSet))
+                    return true;
+            }
+
+            return false;
+        }
     }
 }
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
index 78d8eabba7..10e0e46f4c 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterMatchingTest.cs
@@ -1,10 +1,13 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
 using NUnit.Framework;
+using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Filter;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
@@ -311,6 +314,8 @@ namespace osu.Game.Tests.NonVisual.Filtering
 
             public bool Matches(BeatmapInfo beatmapInfo, FilterCriteria criteria) => match;
             public bool TryParseCustomKeywordCriteria(string key, Operator op, string value) => false;
+
+            public bool FilterMayChangeFromMods(ValueChangedEvent<IReadOnlyList<Mod>> mods) => false;
         }
     }
 }
diff --git a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
index b0ceed45b9..7897b3d8c0 100644
--- a/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
+++ b/osu.Game.Tests/NonVisual/Filtering/FilterQueryParserTest.cs
@@ -2,10 +2,13 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Filter;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Carousel;
 using osu.Game.Screens.Select.Filter;
@@ -514,6 +517,8 @@ namespace osu.Game.Tests.NonVisual.Filtering
 
                 return false;
             }
+
+            public bool FilterMayChangeFromMods(ValueChangedEvent<IReadOnlyList<Mod>> mods) => false;
         }
 
         private static readonly object[] correct_date_query_examples =
diff --git a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
index f926b04db4..c374fe315d 100644
--- a/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
+++ b/osu.Game/Rulesets/Filter/IRulesetFilterCriteria.cs
@@ -1,7 +1,10 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Collections.Generic;
+using osu.Framework.Bindables;
 using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Select;
 using osu.Game.Screens.Select.Filter;
 
@@ -52,5 +55,12 @@ namespace osu.Game.Rulesets.Filter
         /// while ignored criteria are included in <see cref="FilterCriteria.SearchText"/>.
         /// </returns>
         bool TryParseCustomKeywordCriteria(string key, Operator op, string value);
+
+        /// <summary>
+        /// Whether to reapply the filter as a result of the given change in applied mods.
+        /// </summary>
+        /// <param name="mods">The change in mods.</param>
+        /// <returns>Whether the filter should be re-applied.</returns>
+        bool FilterMayChangeFromMods(ValueChangedEvent<IReadOnlyList<Mod>> mods);
     }
 }
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 0bfd927234..73c122dda6 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -7,6 +7,7 @@ using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
 using System.Linq;
+using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -49,15 +50,14 @@ namespace osu.Game.Screens.Select
         }
 
         private OsuTabControl<SortMode> sortTabs;
-
         private Bindable<SortMode> sortMode;
-
         private Bindable<GroupMode> groupMode;
-
         private FilterControlTextBox searchTextBox;
-
         private CollectionDropdown collectionDropdown;
 
+        [CanBeNull]
+        private FilterCriteria currentCriteria;
+
         public FilterCriteria CreateCriteria()
         {
             string query = searchTextBox.Text;
@@ -228,7 +228,8 @@ namespace osu.Game.Screens.Select
                 if (m.NewValue.SequenceEqual(m.OldValue))
                     return;
 
-                updateCriteria();
+                if (currentCriteria?.RulesetCriteria?.FilterMayChangeFromMods(m) == true)
+                    updateCriteria();
             });
 
             groupMode.BindValueChanged(_ => updateCriteria());
@@ -263,7 +264,7 @@ namespace osu.Game.Screens.Select
         private readonly Bindable<double> minimumStars = new BindableDouble();
         private readonly Bindable<double> maximumStars = new BindableDouble();
 
-        private void updateCriteria() => FilterChanged?.Invoke(CreateCriteria());
+        private void updateCriteria() => FilterChanged?.Invoke(currentCriteria = CreateCriteria());
 
         protected override bool OnClick(ClickEvent e) => true;
 

From 7e4782d4b1aeec427ea41d3a5d3bfe5d25a2f1f4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Apr 2024 09:50:51 +0800
Subject: [PATCH 573/930] Allow nested high performance sessions

Mostly just for safety, since I noticed this would pretty much fall over
in this scenario until now.
---
 .../HighPerformanceSessionManager.cs          | 22 +++++++++++++++----
 1 file changed, 18 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/Performance/HighPerformanceSessionManager.cs b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
index eb2b3be5b9..058d247aee 100644
--- a/osu.Desktop/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
@@ -11,16 +11,24 @@ namespace osu.Desktop.Performance
 {
     public class HighPerformanceSessionManager : IHighPerformanceSessionManager
     {
+        private int activeSessions;
+
         private GCLatencyMode originalGCMode;
 
         public IDisposable BeginSession()
         {
-            enableHighPerformanceSession();
-            return new InvokeOnDisposal<HighPerformanceSessionManager>(this, static m => m.disableHighPerformanceSession());
+            enterSession();
+            return new InvokeOnDisposal<HighPerformanceSessionManager>(this, static m => m.exitSession());
         }
 
-        private void enableHighPerformanceSession()
+        private void enterSession()
         {
+            if (Interlocked.Increment(ref activeSessions) > 1)
+            {
+                Logger.Log($"High performance session requested ({activeSessions} others already running)");
+                return;
+            }
+
             Logger.Log("Starting high performance session");
 
             originalGCMode = GCSettings.LatencyMode;
@@ -30,8 +38,14 @@ namespace osu.Desktop.Performance
             GC.Collect(0);
         }
 
-        private void disableHighPerformanceSession()
+        private void exitSession()
         {
+            if (Interlocked.Decrement(ref activeSessions) > 0)
+            {
+                Logger.Log($"High performance session finished ({activeSessions} others remain)");
+                return;
+            }
+
             Logger.Log("Ending high performance session");
 
             if (GCSettings.LatencyMode == GCLatencyMode.LowLatency)

From d89edd2b4f52fe776c77a66a414c1dcd2472bede Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Apr 2024 09:51:43 +0800
Subject: [PATCH 574/930] Expose high performance session state

---
 osu.Desktop/Performance/HighPerformanceSessionManager.cs | 3 +++
 osu.Game/Performance/IHighPerformanceSessionManager.cs   | 5 +++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Desktop/Performance/HighPerformanceSessionManager.cs b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
index 058d247aee..34762de04d 100644
--- a/osu.Desktop/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Runtime;
+using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Logging;
 using osu.Game.Performance;
@@ -11,6 +12,8 @@ namespace osu.Desktop.Performance
 {
     public class HighPerformanceSessionManager : IHighPerformanceSessionManager
     {
+        public bool IsSessionActive => activeSessions > 0;
+
         private int activeSessions;
 
         private GCLatencyMode originalGCMode;
diff --git a/osu.Game/Performance/IHighPerformanceSessionManager.cs b/osu.Game/Performance/IHighPerformanceSessionManager.cs
index d3d1fda8fc..cc995e4942 100644
--- a/osu.Game/Performance/IHighPerformanceSessionManager.cs
+++ b/osu.Game/Performance/IHighPerformanceSessionManager.cs
@@ -14,6 +14,11 @@ namespace osu.Game.Performance
     /// </summary>
     public interface IHighPerformanceSessionManager
     {
+        /// <summary>
+        /// Whether a high performance session is currently active.
+        /// </summary>
+        bool IsSessionActive { get; }
+
         /// <summary>
         /// Start a new high performance session.
         /// </summary>

From a651cb8d507c8720a83db85acef9738107046461 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Apr 2024 09:51:58 +0800
Subject: [PATCH 575/930] Stop background processing from running when inside a
 high performance session

---
 osu.Game/Database/BackgroundDataStoreProcessor.cs | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/BackgroundDataStoreProcessor.cs b/osu.Game/Database/BackgroundDataStoreProcessor.cs
index 872194aa1d..f3b37f608c 100644
--- a/osu.Game/Database/BackgroundDataStoreProcessor.cs
+++ b/osu.Game/Database/BackgroundDataStoreProcessor.cs
@@ -16,6 +16,7 @@ using osu.Game.Extensions;
 using osu.Game.Online.API;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Notifications;
+using osu.Game.Performance;
 using osu.Game.Rulesets;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
@@ -51,6 +52,9 @@ namespace osu.Game.Database
         [Resolved]
         private ILocalUserPlayInfo? localUserPlayInfo { get; set; }
 
+        [Resolved]
+        private IHighPerformanceSessionManager? highPerformanceSessionManager { get; set; }
+
         [Resolved]
         private INotificationOverlay? notificationOverlay { get; set; }
 
@@ -493,7 +497,9 @@ namespace osu.Game.Database
 
         private void sleepIfRequired()
         {
-            while (localUserPlayInfo?.IsPlaying.Value == true)
+            // Importantly, also sleep if high performance session is active.
+            // If we don't do this, memory usage can become runaway due to GC running in a more lenient mode.
+            while (localUserPlayInfo?.IsPlaying.Value == true || highPerformanceSessionManager?.IsSessionActive == true)
             {
                 Logger.Log("Background processing sleeping due to active gameplay...");
                 Thread.Sleep(TimeToSleepDuringGameplay);

From 67cfcddc7727fb5a735cff9ce3dab8d0bae0e004 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 15 Apr 2024 20:18:24 -0700
Subject: [PATCH 576/930] Use another beatmap query to not depend on databased
 score info

---
 osu.Game/OsuGame.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index bcf12b308d..6a29767a8e 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -718,7 +718,7 @@ namespace osu.Game
                 return;
             }
 
-            var databasedBeatmap = BeatmapManager.QueryBeatmap(b => b.ID == databasedScoreInfo.BeatmapInfo.ID);
+            var databasedBeatmap = BeatmapManager.QueryBeatmap(b => b.OnlineID == score.Beatmap.OnlineID);
 
             if (databasedBeatmap == null)
             {

From 514e316b49ad9721e0e7997d02fc14dae3c86504 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 15 Apr 2024 20:48:51 -0700
Subject: [PATCH 577/930] Make `getDatabasedScoreInfo()` private and move to
 `GetScore()` and `Export()`

---
 osu.Game/OsuGame.cs                              |  6 ++----
 osu.Game/Scoring/ScoreManager.cs                 | 16 +++++++++++++---
 osu.Game/Screens/Ranking/ReplayDownloadButton.cs |  4 +---
 3 files changed, 16 insertions(+), 10 deletions(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 6a29767a8e..ccdf9d151f 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -706,11 +706,9 @@ namespace osu.Game
         {
             Logger.Log($"Beginning {nameof(PresentScore)} with score {score}");
 
-            ScoreInfo databasedScoreInfo = ScoreManager.GetDatabasedScoreInfo(score);
+            var databasedScore = ScoreManager.GetScore(score);
 
-            if (databasedScoreInfo == null) return;
-
-            var databasedScore = ScoreManager.GetScore(databasedScoreInfo);
+            if (databasedScore == null) return;
 
             if (databasedScore.Replay == null)
             {
diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index f699e32ac7..3f6c6ee49d 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -58,7 +58,12 @@ namespace osu.Game.Scoring
             };
         }
 
-        public Score GetScore(ScoreInfo score) => scoreImporter.GetScore(score);
+        public Score? GetScore(IScoreInfo scoreInfo)
+        {
+            ScoreInfo? databasedScoreInfo = getDatabasedScoreInfo(scoreInfo);
+
+            return databasedScoreInfo == null ? null : scoreImporter.GetScore(databasedScoreInfo);
+        }
 
         /// <summary>
         /// Perform a lookup query on available <see cref="ScoreInfo"/>s.
@@ -76,7 +81,7 @@ namespace osu.Game.Scoring
         /// <param name="originalScoreInfo">The <see cref="IScoreInfo"/> to attempt querying on.</param>
         /// <returns>The databased score info. Null if the score on the database cannot be found.</returns>
         /// <remarks>Can be used when the <see cref="IScoreInfo"/> was retrieved from online data, as it may have missing properties.</remarks>
-        public ScoreInfo? GetDatabasedScoreInfo(IScoreInfo originalScoreInfo)
+        private ScoreInfo? getDatabasedScoreInfo(IScoreInfo originalScoreInfo)
         {
             ScoreInfo? databasedScoreInfo = null;
 
@@ -189,7 +194,12 @@ namespace osu.Game.Scoring
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, ImportTask[] tasks, ImportParameters parameters = default) => scoreImporter.Import(notification, tasks);
 
-        public Task Export(ScoreInfo score) => scoreExporter.ExportAsync(score.ToLive(Realm));
+        public Task? Export(ScoreInfo scoreInfo)
+        {
+            ScoreInfo? databasedScoreInfo = getDatabasedScoreInfo(scoreInfo);
+
+            return databasedScoreInfo == null ? null : scoreExporter.ExportAsync(databasedScoreInfo.ToLive(Realm));
+        }
 
         public Task<Live<ScoreInfo>?> ImportAsUpdate(ProgressNotification notification, ImportTask task, ScoreInfo original) => scoreImporter.ImportAsUpdate(notification, task, original);
 
diff --git a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
index 9bacfc5ed3..df5f9c7a8a 100644
--- a/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
+++ b/osu.Game/Screens/Ranking/ReplayDownloadButton.cs
@@ -147,9 +147,7 @@ namespace osu.Game.Screens.Ranking
         {
             if (state.NewValue != DownloadState.LocallyAvailable) return;
 
-            ScoreInfo? databasedScoreInfo = scoreManager.GetDatabasedScoreInfo(Score.Value);
-
-            if (databasedScoreInfo != null) scoreManager.Export(databasedScoreInfo);
+            scoreManager.Export(Score.Value);
 
             State.ValueChanged -= exportWhenReady;
         }

From c7b1524b9ff6d4294b09eb2c3fc4fc4f04881a8f Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 16 Apr 2024 05:25:52 -0300
Subject: [PATCH 578/930] Add new audio samples

---
 .../Resources/Samples/test-sample.ogg           | Bin 0 -> 36347 bytes
 .../Resources/Samples/test-sample.webm          | Bin 0 -> 34247 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 osu.Game.Tests/Resources/Samples/test-sample.ogg
 create mode 100644 osu.Game.Tests/Resources/Samples/test-sample.webm

diff --git a/osu.Game.Tests/Resources/Samples/test-sample.ogg b/osu.Game.Tests/Resources/Samples/test-sample.ogg
new file mode 100644
index 0000000000000000000000000000000000000000..b33119cfaf89615cece2655a30c95c82127093ee
GIT binary patch
literal 36347
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

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Resources/Samples/test-sample.webm b/osu.Game.Tests/Resources/Samples/test-sample.webm
new file mode 100644
index 0000000000000000000000000000000000000000..3964d248f4dc6fc0f84a6f3f4fcfe9db97461efa
GIT binary patch
literal 34247
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

literal 0
HcmV?d00001


From 926424d8ea68b1b3eb7439faaff64e5e9afc8d5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 16 Apr 2024 16:37:11 +0800
Subject: [PATCH 579/930] Update HighPerformanceSessionManager.cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Desktop/Performance/HighPerformanceSessionManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Desktop/Performance/HighPerformanceSessionManager.cs b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
index 34762de04d..0df87ab007 100644
--- a/osu.Desktop/Performance/HighPerformanceSessionManager.cs
+++ b/osu.Desktop/Performance/HighPerformanceSessionManager.cs
@@ -28,7 +28,7 @@ namespace osu.Desktop.Performance
         {
             if (Interlocked.Increment(ref activeSessions) > 1)
             {
-                Logger.Log($"High performance session requested ({activeSessions} others already running)");
+                Logger.Log($"High performance session requested ({activeSessions} running in total)");
                 return;
             }
 

From 9ef27104ce50c5844004659b3782d984f3c05c8f Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 16 Apr 2024 06:15:21 -0300
Subject: [PATCH 580/930] Add checks for audio formats

---
 .../Checks/CheckHitsoundsFormatTest.cs        |  96 +++++++++++++++++
 .../Editing/Checks/CheckSongFormatTest.cs     | 100 ++++++++++++++++++
 osu.Game/Rulesets/Edit/BeatmapVerifier.cs     |   2 +
 .../Edit/Checks/CheckHitsoundsFormat.cs       |  93 ++++++++++++++++
 .../Rulesets/Edit/Checks/CheckSongFormat.cs   |  81 ++++++++++++++
 5 files changed, 372 insertions(+)
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
 create mode 100644 osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
 create mode 100644 osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs

diff --git a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
new file mode 100644
index 0000000000..912a7468f5
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
@@ -0,0 +1,96 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.IO;
+using System.Linq;
+using ManagedBass;
+using Moq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Resources;
+using osuTK.Audio;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public class CheckHitsoundsFormatTest
+    {
+        private CheckHitsoundsFormat check = null!;
+
+        private IBeatmap beatmap = null!;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckHitsoundsFormat();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = { CheckTestHelpers.CreateMockFile("wav") }
+                    }
+                }
+            };
+
+            // 0 = No output device. This still allows decoding.
+            if (!Bass.Init(0) && Bass.LastError != Errors.Already)
+                throw new AudioException("Could not initialize Bass.");
+        }
+
+        [Test]
+        public void TestMP3Audio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample-cut.mp3"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckHitsoundsFormat.IssueTemplateIncorrectFormat);
+            }
+        }
+
+        [Test]
+        public void TestOGGAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample.ogg"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
+        [Test]
+        public void TestWAVAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/hitsound-delay.wav"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
+        [Test]
+        public void TestWEBMAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample.webm"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckHitsoundsFormat.IssueTemplateFormatUnsupported);
+            }
+        }
+
+        private BeatmapVerifierContext getContext(Stream? resourceStream)
+        {
+            var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
+            mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(resourceStream);
+
+            return new BeatmapVerifierContext(beatmap, mockWorkingBeatmap.Object);
+        }
+    }
+}
diff --git a/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
new file mode 100644
index 0000000000..acbf25ebad
--- /dev/null
+++ b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
@@ -0,0 +1,100 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.IO;
+using System.Linq;
+using ManagedBass;
+using Moq;
+using NUnit.Framework;
+using osu.Game.Beatmaps;
+using osu.Game.Rulesets.Edit;
+using osu.Game.Rulesets.Edit.Checks;
+using osu.Game.Rulesets.Objects;
+using osu.Game.Tests.Beatmaps;
+using osu.Game.Tests.Resources;
+using osuTK.Audio;
+
+namespace osu.Game.Tests.Editing.Checks
+{
+    [TestFixture]
+    public partial class CheckSongFormatTest
+    {
+        private CheckSongFormat check = null!;
+
+        private IBeatmap beatmap = null!;
+
+        [SetUp]
+        public void Setup()
+        {
+            check = new CheckSongFormat();
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = { CheckTestHelpers.CreateMockFile("mp3") }
+                    }
+                }
+            };
+
+            // 0 = No output device. This still allows decoding.
+            if (!Bass.Init(0) && Bass.LastError != Errors.Already)
+                throw new AudioException("Could not initialize Bass.");
+        }
+
+        [Test]
+        public void TestMP3Audio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample-cut.mp3"))
+            {
+                beatmap.Metadata.AudioFile = "abc123.mp3";
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
+        [Test]
+        public void TestOGGAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample.ogg"))
+            {
+                beatmap.Metadata.AudioFile = "abc123.mp3";
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
+        [Test]
+        public void TestWAVAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/hitsound-delay.wav"))
+            {
+                beatmap.Metadata.AudioFile = "abc123.mp3";
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckSongFormat.IssueTemplateIncorrectFormat);
+            }
+        }
+
+        [Test]
+        public void TestWEBMAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/test-sample.webm"))
+            {
+                beatmap.Metadata.AudioFile = "abc123.mp3";
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckSongFormat.IssueTemplateFormatUnsupported);
+            }
+        }
+
+        private BeatmapVerifierContext getContext(Stream? resourceStream)
+        {
+            var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
+            mockWorkingBeatmap.Setup(w => w.GetStream(It.IsAny<string>())).Returns(resourceStream);
+
+            return new BeatmapVerifierContext(beatmap, mockWorkingBeatmap.Object);
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
index 7d3c7d0b2f..a9681e13ba 100644
--- a/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
+++ b/osu.Game/Rulesets/Edit/BeatmapVerifier.cs
@@ -28,6 +28,8 @@ namespace osu.Game.Rulesets.Edit
             new CheckTooShortAudioFiles(),
             new CheckAudioInVideo(),
             new CheckDelayedHitsounds(),
+            new CheckSongFormat(),
+            new CheckHitsoundsFormat(),
 
             // Files
             new CheckZeroByteFiles(),
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
new file mode 100644
index 0000000000..e490a23963
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -0,0 +1,93 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using ManagedBass;
+using osu.Framework.Audio.Callbacks;
+using osu.Game.Beatmaps;
+using osu.Game.Extensions;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckHitsoundsFormat : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Audio, "Checks for hitsound formats.");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateFormatUnsupported(this),
+            new IssueTemplateIncorrectFormat(this),
+        };
+
+        private IEnumerable<ChannelType> allowedFormats => new ChannelType[]
+        {
+            ChannelType.WavePCM,
+            ChannelType.WaveFloat,
+            ChannelType.OGG,
+            ChannelType.Wave | ChannelType.OGG,
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+            var audioFile = beatmapSet?.GetFile(context.Beatmap.Metadata.AudioFile);
+
+            if (beatmapSet == null) yield break;
+
+            foreach (var file in beatmapSet.Files)
+            {
+                if (audioFile != null && file.File == audioFile.File) continue;
+
+                using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
+                {
+                    if (data == null)
+                        continue;
+
+                    var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
+                    int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
+
+                    // If the format is not supported by BASS
+                    if (decodeStream == 0)
+                    {
+                        if (AudioCheckUtils.HasAudioExtension(file.Filename) && probablyHasAudioData(data))
+                            yield return new IssueTemplateFormatUnsupported(this).Create(file.Filename);
+
+                        continue;
+                    }
+
+                    var audioInfo = Bass.ChannelGetInfo(decodeStream);
+
+                    if (!allowedFormats.Contains(audioInfo.ChannelType))
+                    {
+                        yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename, audioInfo.ChannelType.ToString());
+                    }
+                }
+            }
+        }
+
+        private bool probablyHasAudioData(Stream data) => data.Length > 100;
+
+        public class IssueTemplateFormatUnsupported : IssueTemplate
+        {
+            public IssueTemplateFormatUnsupported(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is using a unsupported format; Use wav or ogg for hitsounds.")
+            {
+            }
+
+            public Issue Create(string file) => new Issue(this, file);
+        }
+
+        public class IssueTemplateIncorrectFormat : IssueTemplate
+        {
+            public IssueTemplateIncorrectFormat(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}); Use wav or ogg for hitsounds.")
+            {
+            }
+
+            public Issue Create(string file, string format) => new Issue(this, file, format);
+        }
+    }
+}
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
new file mode 100644
index 0000000000..4162bf20a3
--- /dev/null
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -0,0 +1,81 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using ManagedBass;
+using osu.Framework.Audio.Callbacks;
+using osu.Game.Beatmaps;
+using osu.Game.Extensions;
+using osu.Game.Rulesets.Edit.Checks.Components;
+
+namespace osu.Game.Rulesets.Edit.Checks
+{
+    public class CheckSongFormat : ICheck
+    {
+        public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Audio, "Checks for song formats.");
+
+        public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
+        {
+            new IssueTemplateFormatUnsupported(this),
+            new IssueTemplateIncorrectFormat(this),
+        };
+
+        private IEnumerable<ChannelType> allowedFormats => new ChannelType[]
+        {
+            ChannelType.MP3,
+            ChannelType.OGG,
+        };
+
+        public IEnumerable<Issue> Run(BeatmapVerifierContext context)
+        {
+            var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
+            var audioFile = beatmapSet?.GetFile(context.Beatmap.Metadata.AudioFile);
+
+            if (beatmapSet == null) yield break;
+            if (audioFile == null) yield break;
+
+            using (Stream data = context.WorkingBeatmap.GetStream(audioFile.File.GetStoragePath()))
+            {
+                if (data == null || data.Length <= 0) yield break;
+
+                var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
+                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
+
+                // If the format is not supported by BASS
+                if (decodeStream == 0)
+                {
+                    yield return new IssueTemplateFormatUnsupported(this).Create(audioFile.Filename);
+                    yield break;
+                }
+
+                var audioInfo = Bass.ChannelGetInfo(decodeStream);
+
+                if (!allowedFormats.Contains(audioInfo.ChannelType))
+                    yield return new IssueTemplateIncorrectFormat(this).Create(audioFile.Filename, audioInfo.ChannelType.ToString());
+            }
+        }
+
+        public class IssueTemplateFormatUnsupported : IssueTemplate
+        {
+            public IssueTemplateFormatUnsupported(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is using a unsupported format; Use mp3 or ogg for the song's audio.")
+            {
+            }
+
+            public Issue Create(string file) => new Issue(this, file);
+        }
+
+        public class IssueTemplateIncorrectFormat : IssueTemplate
+        {
+            public IssueTemplateIncorrectFormat(ICheck check)
+                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}); Use mp3 or ogg for the song's audio.")
+            {
+            }
+
+            public Issue Create(string file, string format) => new Issue(this, file, format);
+        }
+    }
+}

From c32d99250f1dce9d3bed129fd19d1ea7d9a02d22 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Tue, 16 Apr 2024 06:53:55 -0300
Subject: [PATCH 581/930] Deal with corrupt audio files

This removes the corrupt file check from CheckTooShortAudioFiles and makes the audio formats checks deal with it instead to avoid redundant messages.
---
 .../Checks/CheckHitsoundsFormatTest.cs        | 11 +++++++++
 .../Editing/Checks/CheckSongFormatTest.cs     | 12 ++++++++++
 .../Checks/CheckTooShortAudioFilesTest.cs     | 12 ----------
 .../Edit/Checks/CheckHitsoundsFormat.cs       |  2 +-
 .../Rulesets/Edit/Checks/CheckSongFormat.cs   |  2 +-
 .../Edit/Checks/CheckTooShortAudioFiles.cs    | 24 +------------------
 6 files changed, 26 insertions(+), 37 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
index 912a7468f5..f85a296c74 100644
--- a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
@@ -85,6 +85,17 @@ namespace osu.Game.Tests.Editing.Checks
             }
         }
 
+        [Test]
+        public void TestCorruptAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/corrupt.wav"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckHitsoundsFormat.IssueTemplateFormatUnsupported);
+            }
+        }
+
         private BeatmapVerifierContext getContext(Stream? resourceStream)
         {
             var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
diff --git a/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
index acbf25ebad..0755fdd8ac 100644
--- a/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
@@ -89,6 +89,18 @@ namespace osu.Game.Tests.Editing.Checks
             }
         }
 
+        [Test]
+        public void TestCorruptAudio()
+        {
+            using (var resourceStream = TestResources.OpenResource("Samples/corrupt.wav"))
+            {
+                beatmap.Metadata.AudioFile = "abc123.mp3";
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(1));
+                Assert.That(issues.Single().Template is CheckSongFormat.IssueTemplateFormatUnsupported);
+            }
+        }
+
         private BeatmapVerifierContext getContext(Stream? resourceStream)
         {
             var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
diff --git a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
index 4918369460..b646e63955 100644
--- a/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckTooShortAudioFilesTest.cs
@@ -95,18 +95,6 @@ namespace osu.Game.Tests.Editing.Checks
             }
         }
 
-        [Test]
-        public void TestCorruptAudioFile()
-        {
-            using (var resourceStream = TestResources.OpenResource("Samples/corrupt.wav"))
-            {
-                var issues = check.Run(getContext(resourceStream)).ToList();
-
-                Assert.That(issues, Has.Count.EqualTo(1));
-                Assert.That(issues.Single().Template is CheckTooShortAudioFiles.IssueTemplateBadFormat);
-            }
-        }
-
         private BeatmapVerifierContext getContext(Stream? resourceStream)
         {
             var mockWorkingBeatmap = new Mock<TestWorkingBeatmap>(beatmap, null, null);
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index e490a23963..f65b89fc01 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateFormatUnsupported : IssueTemplate
         {
             public IssueTemplateFormatUnsupported(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is using a unsupported format; Use wav or ogg for hitsounds.")
+                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format; Use wav or ogg for hitsounds.")
             {
             }
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
index 4162bf20a3..ae90dd96d5 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateFormatUnsupported : IssueTemplate
         {
             public IssueTemplateFormatUnsupported(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is using a unsupported format; Use mp3 or ogg for the song's audio.")
+                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format; Use mp3 or ogg for the song's audio.")
             {
             }
 
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
index 32a3aa5ad9..3f85926e04 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckTooShortAudioFiles.cs
@@ -13,14 +13,12 @@ namespace osu.Game.Rulesets.Edit.Checks
     public class CheckTooShortAudioFiles : ICheck
     {
         private const int ms_threshold = 25;
-        private const int min_bytes_threshold = 100;
 
         public CheckMetadata Metadata => new CheckMetadata(CheckCategory.Audio, "Too short audio files");
 
         public IEnumerable<IssueTemplate> PossibleTemplates => new IssueTemplate[]
         {
             new IssueTemplateTooShort(this),
-            new IssueTemplateBadFormat(this)
         };
 
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
@@ -39,15 +37,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                         var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
                         int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
 
-                        if (decodeStream == 0)
-                        {
-                            // If the file is not likely to be properly parsed by Bass, we don't produce Error issues about it.
-                            // Image files and audio files devoid of audio data both fail, for example, but neither would be issues in this check.
-                            if (AudioCheckUtils.HasAudioExtension(file.Filename) && probablyHasAudioData(data))
-                                yield return new IssueTemplateBadFormat(this).Create(file.Filename);
-
-                            continue;
-                        }
+                        if (decodeStream == 0) continue;
 
                         long length = Bass.ChannelGetLength(decodeStream);
                         double ms = Bass.ChannelBytes2Seconds(decodeStream, length) * 1000;
@@ -60,8 +50,6 @@ namespace osu.Game.Rulesets.Edit.Checks
             }
         }
 
-        private bool probablyHasAudioData(Stream data) => data.Length > min_bytes_threshold;
-
         public class IssueTemplateTooShort : IssueTemplate
         {
             public IssueTemplateTooShort(ICheck check)
@@ -71,15 +59,5 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             public Issue Create(string filename, double ms) => new Issue(this, filename, ms, ms_threshold);
         }
-
-        public class IssueTemplateBadFormat : IssueTemplate
-        {
-            public IssueTemplateBadFormat(ICheck check)
-                : base(check, IssueType.Error, "Could not check whether \"{0}\" is too short (code \"{1}\").")
-            {
-            }
-
-            public Issue Create(string filename) => new Issue(this, filename, Bass.LastError);
-        }
     }
 }

From c4bf03e6400d5047d2ebf916a7bd532334fff19c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 16 Apr 2024 12:42:12 +0200
Subject: [PATCH 582/930] Add failing test

---
 .../TestSceneResume.cs                        | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 osu.Game.Rulesets.Osu.Tests/TestSceneResume.cs

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneResume.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneResume.cs
new file mode 100644
index 0000000000..023016c32d
--- /dev/null
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneResume.cs
@@ -0,0 +1,69 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
+using osu.Game.Screens.Play;
+using osu.Game.Tests.Visual;
+using osuTK;
+using osuTK.Input;
+
+namespace osu.Game.Rulesets.Osu.Tests
+{
+    public partial class TestSceneResume : PlayerTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new OsuRuleset();
+
+        protected override TestPlayer CreatePlayer(Ruleset ruleset) => new TestPlayer(true, false, AllowBackwardsSeeks);
+
+        [Test]
+        public void TestPauseViaKeyboard()
+        {
+            AddStep("move mouse to center", () => InputManager.MoveMouseTo(Player.ScreenSpaceDrawQuad.Centre));
+            AddUntilStep("wait for gameplay start", () => Player.LocalUserPlaying.Value);
+            AddStep("press escape", () => InputManager.PressKey(Key.Escape));
+            AddUntilStep("wait for pause overlay", () => Player.ChildrenOfType<PauseOverlay>().Single().State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddStep("release escape", () => InputManager.ReleaseKey(Key.Escape));
+            AddStep("resume", () =>
+            {
+                InputManager.Key(Key.Down);
+                InputManager.Key(Key.Space);
+            });
+            AddUntilStep("pause overlay present", () => Player.DrawableRuleset.ResumeOverlay.State.Value, () => Is.EqualTo(Visibility.Visible));
+        }
+
+        [Test]
+        public void TestPauseViaKeyboardWhenMouseOutsidePlayfield()
+        {
+            AddStep("move mouse outside playfield", () => InputManager.MoveMouseTo(Player.DrawableRuleset.Playfield.ScreenSpaceDrawQuad.BottomRight + new Vector2(1)));
+            AddUntilStep("wait for gameplay start", () => Player.LocalUserPlaying.Value);
+            AddStep("press escape", () => InputManager.PressKey(Key.Escape));
+            AddUntilStep("wait for pause overlay", () => Player.ChildrenOfType<PauseOverlay>().Single().State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddStep("release escape", () => InputManager.ReleaseKey(Key.Escape));
+            AddStep("resume", () =>
+            {
+                InputManager.Key(Key.Down);
+                InputManager.Key(Key.Space);
+            });
+            AddUntilStep("pause overlay present", () => Player.DrawableRuleset.ResumeOverlay.State.Value, () => Is.EqualTo(Visibility.Visible));
+        }
+
+        [Test]
+        public void TestPauseViaKeyboardWhenMouseOutsideScreen()
+        {
+            AddStep("move mouse outside playfield", () => InputManager.MoveMouseTo(new Vector2(-20)));
+            AddUntilStep("wait for gameplay start", () => Player.LocalUserPlaying.Value);
+            AddStep("press escape", () => InputManager.PressKey(Key.Escape));
+            AddUntilStep("wait for pause overlay", () => Player.ChildrenOfType<PauseOverlay>().Single().State.Value, () => Is.EqualTo(Visibility.Visible));
+            AddStep("release escape", () => InputManager.ReleaseKey(Key.Escape));
+            AddStep("resume", () =>
+            {
+                InputManager.Key(Key.Down);
+                InputManager.Key(Key.Space);
+            });
+            AddUntilStep("pause overlay not present", () => Player.DrawableRuleset.ResumeOverlay.State.Value, () => Is.EqualTo(Visibility.Hidden));
+        }
+    }
+}

From f9873968a5f06fa355b074f834fad8e9579a3ab7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 16 Apr 2024 13:37:12 +0200
Subject: [PATCH 583/930] Apply NRT in `OsuResumeOverlay`

---
 osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
index adc7bd97ff..19d8a94f0a 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
@@ -19,12 +17,12 @@ namespace osu.Game.Rulesets.Osu.UI
 {
     public partial class OsuResumeOverlay : ResumeOverlay
     {
-        private Container cursorScaleContainer;
-        private OsuClickToResumeCursor clickToResumeCursor;
+        private Container cursorScaleContainer = null!;
+        private OsuClickToResumeCursor clickToResumeCursor = null!;
 
-        private OsuCursorContainer localCursorContainer;
+        private OsuCursorContainer? localCursorContainer;
 
-        public override CursorContainer LocalCursor => State.Value == Visibility.Visible ? localCursorContainer : null;
+        public override CursorContainer? LocalCursor => State.Value == Visibility.Visible ? localCursorContainer : null;
 
         protected override LocalisableString Message => "Click the orange cursor to resume";
 
@@ -71,8 +69,8 @@ namespace osu.Game.Rulesets.Osu.UI
         {
             public override bool HandlePositionalInput => true;
 
-            public Action ResumeRequested;
-            private Container scaleTransitionContainer;
+            public Action? ResumeRequested;
+            private Container scaleTransitionContainer = null!;
 
             public OsuClickToResumeCursor()
             {

From e5e345712efea6467ae895219cad53a461403672 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 16 Apr 2024 13:24:30 +0200
Subject: [PATCH 584/930] Fix resume overlay not appearing after pausing inside
 window but outside of actual playfield area

Related to https://github.com/ppy/osu/discussions/27871 (although does
not actually fix the issue with the pause button, _if_ it is to be
considered an issue - the problem there is that the gameplay cursor
gets hidden, so the other condition in the modified check takes over).

Regressed in
https://github.com/ppy/osu/commit/bce3bd55e5a863e52f41598c306a248a79638843.
Reasoning for breakage is silent change in `this` when moving the
`Contains()` check (`DrawableRuleset` will encompass screen bounds,
while `OsuResumeOverlay` is only as big as the actual playfield).
---
 osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
index 19d8a94f0a..a04ea80640 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuResumeOverlay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Rulesets.Osu.UI.Cursor;
+using osu.Game.Rulesets.UI;
 using osu.Game.Screens.Play;
 using osuTK.Graphics;
 
@@ -26,6 +27,9 @@ namespace osu.Game.Rulesets.Osu.UI
 
         protected override LocalisableString Message => "Click the orange cursor to resume";
 
+        [Resolved]
+        private DrawableRuleset? drawableRuleset { get; set; }
+
         [BackgroundDependencyLoader]
         private void load()
         {
@@ -38,7 +42,7 @@ namespace osu.Game.Rulesets.Osu.UI
         protected override void PopIn()
         {
             // Can't display if the cursor is outside the window.
-            if (GameplayCursor.LastFrameState == Visibility.Hidden || !Contains(GameplayCursor.ActiveCursor.ScreenSpaceDrawQuad.Centre))
+            if (GameplayCursor.LastFrameState == Visibility.Hidden || drawableRuleset?.Contains(GameplayCursor.ActiveCursor.ScreenSpaceDrawQuad.Centre) == false)
             {
                 Resume();
                 return;

From 6c943681b0518848b5ace9755835e16996c505aa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 16 Apr 2024 16:07:56 +0200
Subject: [PATCH 585/930] Fix preview tracks playing after their owning overlay
 has hidden

RFC. Closes https://github.com/ppy/osu/issues/27883.

The idea here is that `PopOut()` is called _when the hide is requested_,
so once an overlay trigger would hide, the overlay would
`StopAnyPlaying()`, but because of async load things, the actual track
would start playing after that but before the overlay has fully hidden.
(That last part is significant because after the overlay has fully
hidden, schedules save the day.)

Due to the loose coupling between `PreviewTrackManager` and
`IPreviewTrackOwner` there's really no easy way to handle this locally
to the usages of the preview tracks. Heck, `PreviewTrackManager` doesn't
really know which preview track owner is to be considered _present_ at
any time, it just kinda works on vibes based on DI until the owner tells
all of its preview tracks to stop.

This solution causes the preview tracks to stop a little bit later but
maybe that's fine? Just trying to not overthink the issue is all.

No tests because this is going to suck to test automatically while it is
pretty easy to test manually (got it in a few tries on master).

The issue also mentions that the track can sometimes resume playing
after the overlay is pulled up again, but I don't see that as a problem
necessarily, and even if it was, it's not going to be that easy to
address due to the aforementioned loose coupling - to fix that, play
buttons would have to know who is the current preview track owner and
cancel schedules upon determining that their preview track owner has
gone away.
---
 osu.Game/Overlays/WaveOverlayContainer.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/WaveOverlayContainer.cs b/osu.Game/Overlays/WaveOverlayContainer.cs
index 0295ff467a..7744db5dd5 100644
--- a/osu.Game/Overlays/WaveOverlayContainer.cs
+++ b/osu.Game/Overlays/WaveOverlayContainer.cs
@@ -40,10 +40,12 @@ namespace osu.Game.Overlays
 
         protected override void PopOut()
         {
-            base.PopOut();
-
             Waves.Hide();
-            this.FadeOut(WaveContainer.DISAPPEAR_DURATION, Easing.InQuint);
+            this.FadeOut(WaveContainer.DISAPPEAR_DURATION, Easing.InQuint)
+                // base call is responsible for stopping preview tracks.
+                // delay it until the fade has concluded to ensure that nothing inside the overlay has triggered
+                // another preview track playback in the meantime, leaving an "orphaned" preview playing.
+                .OnComplete(_ => base.PopOut());
         }
     }
 }

From a386068ed3cdad2b7f3009780c7e6f7709778119 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 08:51:53 +0200
Subject: [PATCH 586/930] Add `ScoreInfo.TotalScoreWithoutMods`

---
 osu.Game/Database/RealmAccess.cs |  3 ++-
 osu.Game/Scoring/ScoreInfo.cs    | 11 +++++++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 167d170c81..12a71f3510 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -91,8 +91,9 @@ namespace osu.Game.Database
         /// 38   2023-12-10    Add EndTimeObjectCount and TotalObjectCount to BeatmapInfo.
         /// 39   2023-12-19    Migrate any EndTimeObjectCount and TotalObjectCount values of 0 to -1 to better identify non-calculated values.
         /// 40   2023-12-21    Add ScoreInfo.Version to keep track of which build scores were set on.
+        /// 41   2024-04-17    Add ScoreInfo.TotalScoreWithoutMods for future mod multiplier rebalances.
         /// </summary>
-        private const int schema_version = 40;
+        private const int schema_version = 41;
 
         /// <summary>
         /// Lock object which is held during <see cref="BlockAllOperations"/> sections, blocking realm retrieval during blocking periods.
diff --git a/osu.Game/Scoring/ScoreInfo.cs b/osu.Game/Scoring/ScoreInfo.cs
index fd98107792..92c18c9c1e 100644
--- a/osu.Game/Scoring/ScoreInfo.cs
+++ b/osu.Game/Scoring/ScoreInfo.cs
@@ -65,8 +65,19 @@ namespace osu.Game.Scoring
 
         public bool DeletePending { get; set; }
 
+        /// <summary>
+        /// The total number of points awarded for the score.
+        /// </summary>
         public long TotalScore { get; set; }
 
+        /// <summary>
+        /// The total number of points awarded for the score without including mod multipliers.
+        /// </summary>
+        /// <remarks>
+        /// The purpose of this property is to enable future lossless rebalances of mod multipliers.
+        /// </remarks>
+        public long TotalScoreWithoutMods { get; set; }
+
         /// <summary>
         /// The version of processing applied to calculate total score as stored in the database.
         /// If this does not match <see cref="LegacyScoreEncoder.LATEST_VERSION"/>,

From 6b0d577f0bb3943cc66cd5bff118b52315ea7418 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 08:52:27 +0200
Subject: [PATCH 587/930] Add backmigration of `TotalScoreWithoutMods` for
 existing scores

---
 osu.Game/Database/RealmAccess.cs | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 12a71f3510..ee8eb4491b 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -1109,6 +1109,19 @@ namespace osu.Game.Database
                         }
                     }
 
+                    break;
+
+                case 41:
+                    foreach (var score in migration.NewRealm.All<ScoreInfo>())
+                    {
+                        double modMultiplier = 1;
+
+                        foreach (var mod in score.Mods)
+                            modMultiplier *= mod.ScoreMultiplier;
+
+                        score.TotalScoreWithoutMods = (long)Math.Round(score.TotalScore / modMultiplier);
+                    }
+
                     break;
             }
 

From e0178802b81f5a62ad0ddb8ed02cab7d98d5ebd5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 08:52:47 +0200
Subject: [PATCH 588/930] Populate `TotalScoreWithoutMods` on scores set
 locally

---
 osu.Game/Rulesets/Scoring/ScoreProcessor.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
index 9d12daad04..70d7f0fe37 100644
--- a/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/ScoreProcessor.cs
@@ -56,6 +56,14 @@ namespace osu.Game.Rulesets.Scoring
         /// </summary>
         public readonly BindableLong TotalScore = new BindableLong { MinValue = 0 };
 
+        /// <summary>
+        /// The total number of points awarded for the score without including mod multipliers.
+        /// </summary>
+        /// <remarks>
+        /// The purpose of this property is to enable future lossless rebalances of mod multipliers.
+        /// </remarks>
+        public readonly BindableLong TotalScoreWithoutMods = new BindableLong { MinValue = 0 };
+
         /// <summary>
         /// The current accuracy.
         /// </summary>
@@ -363,7 +371,8 @@ namespace osu.Game.Rulesets.Scoring
             double comboProgress = maximumComboPortion > 0 ? currentComboPortion / maximumComboPortion : 1;
             double accuracyProcess = maximumAccuracyJudgementCount > 0 ? (double)currentAccuracyJudgementCount / maximumAccuracyJudgementCount : 1;
 
-            TotalScore.Value = (long)Math.Round(ComputeTotalScore(comboProgress, accuracyProcess, currentBonusPortion) * scoreMultiplier);
+            TotalScoreWithoutMods.Value = (long)Math.Round(ComputeTotalScore(comboProgress, accuracyProcess, currentBonusPortion));
+            TotalScore.Value = (long)Math.Round(TotalScoreWithoutMods.Value * scoreMultiplier);
         }
 
         private void updateRank()
@@ -446,6 +455,7 @@ namespace osu.Game.Rulesets.Scoring
                 score.MaximumStatistics[result] = MaximumResultCounts.GetValueOrDefault(result);
 
             // Populate total score after everything else.
+            score.TotalScoreWithoutMods = TotalScoreWithoutMods.Value;
             score.TotalScore = TotalScore.Value;
         }
 

From 2f1a4cdaa4d46c0dfd230f618c57563cee6bb654 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 09:08:15 +0200
Subject: [PATCH 589/930] Export and import `TotalScoreWithoutMods` to replays
 (or recalculate if it missing)

---
 .../Formats/LegacyScoreDecoderTest.cs         | 74 +++++++++++++++++++
 osu.Game/Database/RealmAccess.cs              |  9 +--
 .../Legacy/LegacyReplaySoloScoreInfo.cs       |  4 +
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs | 15 ++++
 4 files changed, 94 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 43e471320e..2f8cb9a3b3 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -412,6 +412,80 @@ namespace osu.Game.Tests.Beatmaps.Formats
             });
         }
 
+        [Test]
+        public void TestTotalScoreWithoutModsReadIfPresent()
+        {
+            var ruleset = new OsuRuleset().RulesetInfo;
+
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
+            scoreInfo.Mods = new Mod[]
+            {
+                new OsuModDoubleTime { SpeedChange = { Value = 1.1 } }
+            };
+            scoreInfo.OnlineID = 123123;
+            scoreInfo.ClientVersion = "2023.1221.0";
+            scoreInfo.TotalScoreWithoutMods = 1_000_000;
+            scoreInfo.TotalScore = 1_020_000;
+
+            var beatmap = new TestBeatmap(ruleset);
+            var score = new Score
+            {
+                ScoreInfo = scoreInfo,
+                Replay = new Replay
+                {
+                    Frames = new List<ReplayFrame>
+                    {
+                        new OsuReplayFrame(2000, OsuPlayfield.BASE_SIZE / 2, OsuAction.LeftButton)
+                    }
+                }
+            };
+
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
+
+            Assert.Multiple(() =>
+            {
+                Assert.That(decodedAfterEncode.ScoreInfo.TotalScoreWithoutMods, Is.EqualTo(1_000_000));
+                Assert.That(decodedAfterEncode.ScoreInfo.TotalScore, Is.EqualTo(1_020_000));
+            });
+        }
+
+        [Test]
+        public void TestTotalScoreWithoutModsBackwardsPopulatedIfMissing()
+        {
+            var ruleset = new OsuRuleset().RulesetInfo;
+
+            var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
+            scoreInfo.Mods = new Mod[]
+            {
+                new OsuModDoubleTime { SpeedChange = { Value = 1.1 } }
+            };
+            scoreInfo.OnlineID = 123123;
+            scoreInfo.ClientVersion = "2023.1221.0";
+            scoreInfo.TotalScoreWithoutMods = 0;
+            scoreInfo.TotalScore = 1_020_000;
+
+            var beatmap = new TestBeatmap(ruleset);
+            var score = new Score
+            {
+                ScoreInfo = scoreInfo,
+                Replay = new Replay
+                {
+                    Frames = new List<ReplayFrame>
+                    {
+                        new OsuReplayFrame(2000, OsuPlayfield.BASE_SIZE / 2, OsuAction.LeftButton)
+                    }
+                }
+            };
+
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
+
+            Assert.Multiple(() =>
+            {
+                Assert.That(decodedAfterEncode.ScoreInfo.TotalScoreWithoutMods, Is.EqualTo(1_000_000));
+                Assert.That(decodedAfterEncode.ScoreInfo.TotalScore, Is.EqualTo(1_020_000));
+            });
+        }
+
         private static Score encodeThenDecode(int beatmapVersion, Score score, TestBeatmap beatmap)
         {
             var encodeStream = new MemoryStream();
diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index ee8eb4491b..c075c3d82b 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -1113,14 +1113,7 @@ namespace osu.Game.Database
 
                 case 41:
                     foreach (var score in migration.NewRealm.All<ScoreInfo>())
-                    {
-                        double modMultiplier = 1;
-
-                        foreach (var mod in score.Mods)
-                            modMultiplier *= mod.ScoreMultiplier;
-
-                        score.TotalScoreWithoutMods = (long)Math.Round(score.TotalScore / modMultiplier);
-                    }
+                        LegacyScoreDecoder.PopulateTotalScoreWithoutMods(score);
 
                     break;
             }
diff --git a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
index afdcef1d21..c11e18462a 100644
--- a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
+++ b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
@@ -38,6 +38,9 @@ namespace osu.Game.Scoring.Legacy
         [JsonProperty("client_version")]
         public string ClientVersion = string.Empty;
 
+        [JsonProperty("total_score_without_mods")]
+        public long? TotalScoreWithoutMods { get; set; }
+
         public static LegacyReplaySoloScoreInfo FromScore(ScoreInfo score) => new LegacyReplaySoloScoreInfo
         {
             OnlineID = score.OnlineID,
@@ -45,6 +48,7 @@ namespace osu.Game.Scoring.Legacy
             Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             ClientVersion = score.ClientVersion,
+            TotalScoreWithoutMods = score.TotalScoreWithoutMods > 0 ? score.TotalScoreWithoutMods : null,
         };
     }
 }
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 65e2c02655..2358c0dfec 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -129,6 +129,11 @@ namespace osu.Game.Scoring.Legacy
                         score.ScoreInfo.MaximumStatistics = readScore.MaximumStatistics;
                         score.ScoreInfo.Mods = readScore.Mods.Select(m => m.ToMod(currentRuleset)).ToArray();
                         score.ScoreInfo.ClientVersion = readScore.ClientVersion;
+
+                        if (readScore.TotalScoreWithoutMods is long totalScoreWithoutMods)
+                            score.ScoreInfo.TotalScoreWithoutMods = totalScoreWithoutMods;
+                        else
+                            PopulateTotalScoreWithoutMods(score.ScoreInfo);
                     });
                 }
             }
@@ -237,6 +242,16 @@ namespace osu.Game.Scoring.Legacy
 #pragma warning restore CS0618
         }
 
+        public static void PopulateTotalScoreWithoutMods(ScoreInfo score)
+        {
+            double modMultiplier = 1;
+
+            foreach (var mod in score.Mods)
+                modMultiplier *= mod.ScoreMultiplier;
+
+            score.TotalScoreWithoutMods = (long)Math.Round(score.TotalScore / modMultiplier);
+        }
+
         private void readLegacyReplay(Replay replay, StreamReader reader)
         {
             float lastTime = beatmapOffset;

From 18bb81e7a7e4de6cf15ce0674ae44ef9f041ff84 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 09:11:47 +0200
Subject: [PATCH 590/930] Populate total score without mods when performing
 standardised score migration

---
 osu.Game/Database/StandardisedScoreMigrationTools.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Database/StandardisedScoreMigrationTools.cs b/osu.Game/Database/StandardisedScoreMigrationTools.cs
index 6f2f8d64fa..7d09ebdb40 100644
--- a/osu.Game/Database/StandardisedScoreMigrationTools.cs
+++ b/osu.Game/Database/StandardisedScoreMigrationTools.cs
@@ -16,6 +16,7 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Scoring;
+using osu.Game.Scoring.Legacy;
 
 namespace osu.Game.Database
 {
@@ -248,6 +249,7 @@ namespace osu.Game.Database
             score.Accuracy = computeAccuracy(score, scoreProcessor);
             score.Rank = computeRank(score, scoreProcessor);
             score.TotalScore = convertFromLegacyTotalScore(score, ruleset, beatmap);
+            LegacyScoreDecoder.PopulateTotalScoreWithoutMods(score);
         }
 
         /// <summary>

From e11e9fe14ff41af53eb6ccbbf9eb79952d045989 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 17 Apr 2024 09:15:50 +0200
Subject: [PATCH 591/930] Add `TotalScoreWithoutMods` to `SoloScoreInfo`

End goal being storing it server-side.
---
 osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs b/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
index 64caddb2fc..36f1311f9d 100644
--- a/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
+++ b/osu.Game/Online/API/Requests/Responses/SoloScoreInfo.cs
@@ -33,6 +33,9 @@ namespace osu.Game.Online.API.Requests.Responses
         [JsonProperty("total_score")]
         public long TotalScore { get; set; }
 
+        [JsonProperty("total_score_without_mods")]
+        public long TotalScoreWithoutMods { get; set; }
+
         [JsonProperty("accuracy")]
         public double Accuracy { get; set; }
 
@@ -206,6 +209,7 @@ namespace osu.Game.Online.API.Requests.Responses
                 Ruleset = new RulesetInfo { OnlineID = RulesetID },
                 Passed = Passed,
                 TotalScore = TotalScore,
+                TotalScoreWithoutMods = TotalScoreWithoutMods,
                 LegacyTotalScore = LegacyTotalScore,
                 Accuracy = Accuracy,
                 MaxCombo = MaxCombo,
@@ -239,6 +243,7 @@ namespace osu.Game.Online.API.Requests.Responses
         {
             Rank = score.Rank,
             TotalScore = score.TotalScore,
+            TotalScoreWithoutMods = score.TotalScoreWithoutMods,
             Accuracy = score.Accuracy,
             PP = score.PP,
             MaxCombo = score.MaxCombo,

From 03e13ddc3095e8713a90dab9bb5f672b0ae75d4d Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Wed, 17 Apr 2024 17:10:19 +0900
Subject: [PATCH 592/930] Globally silence Discord RPC registration failures

---
 osu.Desktop/DiscordRichPresence.cs | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index f1c796d0cd..74ebd38f2c 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -6,7 +6,6 @@ using System.Text;
 using DiscordRPC;
 using DiscordRPC.Message;
 using Newtonsoft.Json;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
@@ -80,14 +79,20 @@ namespace osu.Desktop
             client.OnReady += onReady;
             client.OnError += (_, e) => Logger.Log($"An error occurred with Discord RPC Client: {e.Message} ({e.Code})", LoggingTarget.Network, LogLevel.Error);
 
-            // A URI scheme is required to support game invitations, as well as informing Discord of the game executable path to support launching the game when a user clicks on join/spectate.
-            // The library doesn't properly support URI registration when ran from an app bundle on macOS.
-            if (!RuntimeInfo.IsApple)
+            try
             {
                 client.RegisterUriScheme();
                 client.Subscribe(EventType.Join);
                 client.OnJoin += onJoin;
             }
+            catch (Exception ex)
+            {
+                // This is known to fail in at least the following sandboxed environments:
+                // - macOS (when packaged as an app bundle)
+                // - flatpak (see: https://github.com/flathub/sh.ppy.osu/issues/170)
+                // There is currently no better way to do this offered by Discord, so the best we can do is simply ignore it for now.
+                Logger.Log($"Failed to register Discord URI scheme: {ex}");
+            }
 
             client.Initialize();
         }

From 2a3ae6bce178124e65ca14d8ea62e82a6aa05ded Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 02:34:41 +0300
Subject: [PATCH 593/930] Update all `TabItem` implementations to play select
 sample on `OnActivatedByUser`

---
 .../Graphics/UserInterface/OsuTabControl.cs   | 24 ++++++++++++-------
 .../Graphics/UserInterface/PageTabControl.cs  | 14 ++++++++++-
 .../BeatmapListingCardSizeTabControl.cs       | 12 ++++++++--
 .../Overlays/BeatmapListing/FilterTabItem.cs  | 12 ++++++++--
 .../OverlayPanelDisplayStyleControl.cs        | 14 ++++++++++-
 osu.Game/Overlays/OverlayRulesetTabItem.cs    | 14 ++++++++++-
 osu.Game/Overlays/OverlayStreamItem.cs        | 12 ++++++++--
 osu.Game/Overlays/OverlayTabControl.cs        | 14 ++++++++++-
 .../Toolbar/ToolbarRulesetSelector.cs         |  4 ----
 .../Toolbar/ToolbarRulesetTabButton.cs        | 12 ++++++++++
 .../Match/Components/MatchTypePicker.cs       | 11 +++++++--
 11 files changed, 119 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index f24977927f..5ce384c53c 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -8,6 +8,8 @@ using System.Linq;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
@@ -143,13 +145,6 @@ namespace osu.Game.Graphics.UserInterface
                     FadeUnhovered();
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                if (accentColour == default)
-                    AccentColour = colours.Blue;
-            }
-
             public OsuTabItem(T value)
                 : base(value)
             {
@@ -196,10 +191,21 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
             }
 
+            private Sample selectSample;
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours, AudioManager audio)
+            {
+                if (accentColour == default)
+                    AccentColour = colours.Blue;
+
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override void OnActivated()
             {
                 Text.Font = Text.Font.With(weight: FontWeight.Bold);
@@ -211,6 +217,8 @@ namespace osu.Game.Graphics.UserInterface
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
                 FadeUnhovered();
             }
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageTabControl.cs b/osu.Game/Graphics/UserInterface/PageTabControl.cs
index 2fe8acfbd5..44c659f945 100644
--- a/osu.Game/Graphics/UserInterface/PageTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/PageTabControl.cs
@@ -7,6 +7,8 @@ using System;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
@@ -53,6 +55,8 @@ namespace osu.Game.Graphics.UserInterface
                 }
             }
 
+            private Sample selectSample = null!;
+
             public PageTabItem(T value)
                 : base(value)
             {
@@ -78,12 +82,18 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
 
                 Active.BindValueChanged(active => Text.Font = Text.Font.With(Typeface.Torus, weight: active.NewValue ? FontWeight.Bold : FontWeight.Medium), true);
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected virtual LocalisableString CreateText() => (Value as Enum)?.GetLocalisableDescription() ?? Value.ToString();
 
             protected override bool OnHover(HoverEvent e)
@@ -112,6 +122,8 @@ namespace osu.Game.Graphics.UserInterface
             protected override void OnActivated() => slideActive();
 
             protected override void OnDeactivated() => slideInactive();
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
index 9cd0031e3d..63a533c92e 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
@@ -5,6 +5,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -47,13 +49,15 @@ namespace osu.Game.Overlays.BeatmapListing
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
 
+            private Sample selectSample = null!;
+
             public TabItem(BeatmapCardSize value)
                 : base(value)
             {
             }
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(AudioManager audio)
             {
                 AutoSizeAxes = Axes.Both;
                 Masking = true;
@@ -79,8 +83,10 @@ namespace osu.Game.Overlays.BeatmapListing
                             Icon = getIconForCardSize(Value)
                         }
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
+
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             private static IconUsage getIconForCardSize(BeatmapCardSize cardSize)
@@ -111,6 +117,8 @@ namespace osu.Game.Overlays.BeatmapListing
                     updateState();
             }
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             protected override void OnDeactivated()
             {
                 if (IsLoaded)
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index 831cf812ff..89bf61dd18 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -5,6 +5,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -24,13 +26,15 @@ namespace osu.Game.Overlays.BeatmapListing
 
         private OsuSpriteText text;
 
+        private Sample selectSample = null!;
+
         public FilterTabItem(T value)
             : base(value)
         {
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
             AutoSizeAxes = Axes.Both;
             AddRangeInternal(new Drawable[]
@@ -40,10 +44,12 @@ namespace osu.Game.Overlays.BeatmapListing
                     Font = OsuFont.GetFont(size: 13, weight: FontWeight.Regular),
                     Text = LabelFor(Value)
                 },
-                new HoverClickSounds(HoverSampleSet.TabSelect)
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
+
+            selectSample = audio.Samples.Get(@"UI/tabselect-select");
         }
 
         protected override void LoadComplete()
@@ -71,6 +77,8 @@ namespace osu.Game.Overlays.BeatmapListing
 
         protected override void OnDeactivated() => UpdateState();
 
+        protected override void OnActivatedByUser() => selectSample.Play();
+
         /// <summary>
         /// Returns the label text to be used for the supplied <paramref name="value"/>.
         /// </summary>
diff --git a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
index d7d6bd4a2a..c2bea0ed91 100644
--- a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
+++ b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
@@ -11,6 +11,8 @@ using osuTK;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osuTK.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
@@ -65,6 +67,8 @@ namespace osu.Game.Overlays
 
             private readonly SpriteIcon icon;
 
+            private Sample selectSample = null!;
+
             public PanelDisplayTabItem(OverlayPanelDisplayStyle value)
                 : base(value)
             {
@@ -78,14 +82,22 @@ namespace osu.Game.Overlays
                         RelativeSizeAxes = Axes.Both,
                         FillMode = FillMode.Fit
                     },
-                    new HoverClickSounds()
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 });
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override void OnActivated() => updateState();
 
             protected override void OnDeactivated() => updateState();
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             protected override bool OnHover(HoverEvent e)
             {
                 updateState();
diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 6d318820b3..b245486adf 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -10,6 +10,8 @@ using osu.Game.Rulesets;
 using osuTK.Graphics;
 using osuTK;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
@@ -39,6 +41,8 @@ namespace osu.Game.Overlays
 
         public LocalisableString TooltipText => Value.Name;
 
+        private Sample selectSample = null!;
+
         public OverlayRulesetTabItem(RulesetInfo value)
             : base(value)
         {
@@ -59,12 +63,18 @@ namespace osu.Game.Overlays
                         Icon = value.CreateInstance().CreateIcon(),
                     },
                 },
-                new HoverClickSounds()
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
         }
 
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            selectSample = audio.Samples.Get(@"UI/tabselect-select");
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -90,6 +100,8 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
+        protected override void OnActivatedByUser() => selectSample.Play();
+
         private void updateState()
         {
             AccentColour = Enabled.Value ? getActiveColour() : colourProvider.Foreground1;
diff --git a/osu.Game/Overlays/OverlayStreamItem.cs b/osu.Game/Overlays/OverlayStreamItem.cs
index 45181c13e4..f0ae0b41fc 100644
--- a/osu.Game/Overlays/OverlayStreamItem.cs
+++ b/osu.Game/Overlays/OverlayStreamItem.cs
@@ -11,6 +11,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osuTK.Graphics;
@@ -49,8 +51,10 @@ namespace osu.Game.Overlays
             Margin = new MarginPadding(PADDING);
         }
 
+        private Sample selectSample;
+
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, OsuColour colours)
+        private void load(OverlayColourProvider colourProvider, OsuColour colours, AudioManager audio)
         {
             AddRange(new Drawable[]
             {
@@ -87,9 +91,11 @@ namespace osu.Game.Overlays
                     CollapsedSize = 2,
                     Expanded = true
                 },
-                new HoverClickSounds()
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
+            selectSample = audio.Samples.Get(@"UI/tabselect-select");
+
             SelectedItem.BindValueChanged(_ => updateState(), true);
         }
 
@@ -105,6 +111,8 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
+        protected override void OnActivatedByUser() => selectSample.Play();
+
         protected override bool OnHover(HoverEvent e)
         {
             updateState();
diff --git a/osu.Game/Overlays/OverlayTabControl.cs b/osu.Game/Overlays/OverlayTabControl.cs
index 884e31868f..a27caa13f1 100644
--- a/osu.Game/Overlays/OverlayTabControl.cs
+++ b/osu.Game/Overlays/OverlayTabControl.cs
@@ -4,6 +4,8 @@
 #nullable disable
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
@@ -80,6 +82,8 @@ namespace osu.Game.Overlays
                 }
             }
 
+            private Sample selectSample = null!;
+
             public OverlayTabItem(T value)
                 : base(value)
             {
@@ -101,10 +105,16 @@ namespace osu.Game.Overlays
                         ExpandedSize = 5f,
                         CollapsedSize = 0
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override bool OnHover(HoverEvent e)
             {
                 base.OnHover(e);
@@ -136,6 +146,8 @@ namespace osu.Game.Overlays
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
             }
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             private void updateState()
             {
                 if (Active.Value)
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index 723c24597a..518152e455 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
@@ -88,10 +88,6 @@ namespace osu.Game.Overlays.Toolbar
             if (SelectedTab != null)
             {
                 ModeButtonLine.MoveToX(SelectedTab.DrawPosition.X, !hasInitialPosition ? 0 : 500, Easing.OutElasticQuarter);
-
-                if (hasInitialPosition)
-                    selectionSamples[SelectedTab.Value.ShortName]?.Play();
-
                 hasInitialPosition = true;
             }
         }
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
index 3287ac6eaa..0315bede64 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -17,6 +19,8 @@ namespace osu.Game.Overlays.Toolbar
     {
         private readonly RulesetButton ruleset;
 
+        private Sample? selectSample;
+
         public ToolbarRulesetTabButton(RulesetInfo value)
             : base(value)
         {
@@ -34,10 +38,18 @@ namespace osu.Game.Overlays.Toolbar
             ruleset.SetIcon(rInstance.CreateIcon());
         }
 
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            selectSample = audio.Samples.Get($@"UI/ruleset-select-{Value.ShortName}");
+        }
+
         protected override void OnActivated() => ruleset.Active = true;
 
         protected override void OnDeactivated() => ruleset.Active = false;
 
+        protected override void OnActivatedByUser() => selectSample?.Play();
+
         private partial class RulesetButton : ToolbarButton
         {
             protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds();
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
index 995fce085e..477336e8ea 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
@@ -4,6 +4,8 @@
 #nullable disable
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -78,14 +80,17 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                             },
                         },
                     },
-                    new HoverClickSounds(),
+                    new HoverSounds(HoverSampleSet.TabSelect),
                 };
             }
 
+            private Sample selectSample;
+
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OsuColour colours, AudioManager audio)
             {
                 selection.Colour = colours.Yellow;
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             protected override bool OnHover(HoverEvent e)
@@ -109,6 +114,8 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
             {
                 selection.FadeOut(transition_duration, Easing.OutQuint);
             }
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }

From 50a21fb7273489f682b680877ad69200a2d4c227 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 02:38:39 +0300
Subject: [PATCH 594/930] Change `ToolbarRulesetSelector` to use `SelectItem`
 to trigger new sound feedback path

---
 osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index 518152e455..d49c340ed4 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
@@ -3,11 +3,8 @@
 
 #nullable disable
 
-using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -24,8 +21,6 @@ namespace osu.Game.Overlays.Toolbar
     {
         protected Drawable ModeButtonLine { get; private set; }
 
-        private readonly Dictionary<string, Sample> selectionSamples = new Dictionary<string, Sample>();
-
         public ToolbarRulesetSelector()
         {
             RelativeSizeAxes = Axes.Y;
@@ -33,7 +28,7 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             AddRangeInternal(new[]
             {
@@ -59,9 +54,6 @@ namespace osu.Game.Overlays.Toolbar
                     }
                 },
             });
-
-            foreach (var ruleset in Rulesets.AvailableRulesets)
-                selectionSamples[ruleset.ShortName] = audio.Samples.Get($"UI/ruleset-select-{ruleset.ShortName}");
         }
 
         protected override void LoadComplete()
@@ -117,7 +109,7 @@ namespace osu.Game.Overlays.Toolbar
 
                 RulesetInfo found = Rulesets.AvailableRulesets.ElementAtOrDefault(requested);
                 if (found != null)
-                    Current.Value = found;
+                    SelectItem(found);
                 return true;
             }
 

From 42892acc1adaf8be01897de0c4e5fef7b6319a4d Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 02:42:24 +0300
Subject: [PATCH 595/930] Fix multiple selection filter tab items no longer
 playing sounds

These tab items are not managed by a `TabControl`, activation events are manually served by the class itself toggling `Active` when clicked.
---
 .../BeatmapSearchMultipleSelectionFilterRow.cs              | 1 +
 osu.Game/Overlays/BeatmapListing/FilterTabItem.cs           | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index e59beb43ff..0a4c2b1e21 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -129,6 +129,7 @@ namespace osu.Game.Overlays.BeatmapListing
             {
                 base.OnClick(e);
                 Active.Toggle();
+                SelectSample.Play();
                 return true;
             }
         }
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index 89bf61dd18..ee188d34ce 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -26,7 +26,7 @@ namespace osu.Game.Overlays.BeatmapListing
 
         private OsuSpriteText text;
 
-        private Sample selectSample = null!;
+        protected Sample SelectSample { get; private set; } = null!;
 
         public FilterTabItem(T value)
             : base(value)
@@ -49,7 +49,7 @@ namespace osu.Game.Overlays.BeatmapListing
 
             Enabled.Value = true;
 
-            selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            SelectSample = audio.Samples.Get(@"UI/tabselect-select");
         }
 
         protected override void LoadComplete()
@@ -77,7 +77,7 @@ namespace osu.Game.Overlays.BeatmapListing
 
         protected override void OnDeactivated() => UpdateState();
 
-        protected override void OnActivatedByUser() => selectSample.Play();
+        protected override void OnActivatedByUser() => SelectSample.Play();
 
         /// <summary>
         /// Returns the label text to be used for the supplied <paramref name="value"/>.

From 9e692686760ea1f00cf661bc011da18e8b4b43a0 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 02:48:32 +0300
Subject: [PATCH 596/930] Change editor screen selection logic to use
 `SelectItem` for sound feedback

---
 osu.Game/Screens/Edit/Editor.cs | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index c1f6c02301..37f4b4f5be 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -372,7 +372,7 @@ namespace osu.Game.Screens.Edit
                                     }
                                 }
                             },
-                            new EditorScreenSwitcherControl
+                            screenSwitcher = new EditorScreenSwitcherControl
                             {
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,
@@ -662,23 +662,23 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorComposeMode:
-                    Mode.Value = EditorScreenMode.Compose;
+                    screenSwitcher.SelectItem(EditorScreenMode.Compose);
                     return true;
 
                 case GlobalAction.EditorDesignMode:
-                    Mode.Value = EditorScreenMode.Design;
+                    screenSwitcher.SelectItem(EditorScreenMode.Design);
                     return true;
 
                 case GlobalAction.EditorTimingMode:
-                    Mode.Value = EditorScreenMode.Timing;
+                    screenSwitcher.SelectItem(EditorScreenMode.Timing);
                     return true;
 
                 case GlobalAction.EditorSetupMode:
-                    Mode.Value = EditorScreenMode.SongSetup;
+                    screenSwitcher.SelectItem(EditorScreenMode.SongSetup);
                     return true;
 
                 case GlobalAction.EditorVerifyMode:
-                    Mode.Value = EditorScreenMode.Verify;
+                    screenSwitcher.SelectItem(EditorScreenMode.Verify);
                     return true;
 
                 case GlobalAction.EditorTestGameplay:
@@ -959,6 +959,8 @@ namespace osu.Game.Screens.Edit
         [CanBeNull]
         private ScheduledDelegate playbackDisabledDebounce;
 
+        private EditorScreenSwitcherControl screenSwitcher;
+
         private void updateSampleDisabledState()
         {
             bool shouldDisableSamples = clock.SeekingOrStopped.Value

From 24e8b88320af93d257674452178e878253ccb4fc Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 03:00:27 +0300
Subject: [PATCH 597/930] Add inline comment to the custom implementation of
 multiple-selection tab items

---
 .../BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs  | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index 0a4c2b1e21..4bd25f6561 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -128,6 +128,9 @@ namespace osu.Game.Overlays.BeatmapListing
             protected override bool OnClick(ClickEvent e)
             {
                 base.OnClick(e);
+
+                // this tab item implementation is not managed by a TabControl,
+                // therefore we have to manually update Active state and play select sound when this tab item is clicked.
                 Active.Toggle();
                 SelectSample.Play();
                 return true;

From a7e043bdbe3b145b5e33c392e06061e9e71fc7b2 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 17 Apr 2024 03:08:29 +0300
Subject: [PATCH 598/930] Fix beatmap rulest selector playing sound for initial
 ruleset selection

---
 osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
index 426fbcdb8d..29744f27fc 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 // propagate value to tab items first to enable only available rulesets.
                 beatmapSet.Value = value;
 
-                SelectTab(TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value));
+                Current.Value = TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value)?.Value;
             }
         }
 

From 8d94f8d995cd34c2f9d7d6ab68a169b7e554c0f4 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 17 Apr 2024 08:14:19 -0300
Subject: [PATCH 599/930] Remove `BassFlags.Prescan` and free the decodeStream

---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 7 ++++---
 osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs      | 4 +++-
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index f65b89fc01..c71c7b0ef3 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                         continue;
 
                     var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
-                    int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
+                    int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
 
                     // If the format is not supported by BASS
                     if (decodeStream == 0)
@@ -61,9 +61,10 @@ namespace osu.Game.Rulesets.Edit.Checks
                     var audioInfo = Bass.ChannelGetInfo(decodeStream);
 
                     if (!allowedFormats.Contains(audioInfo.ChannelType))
-                    {
                         yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename, audioInfo.ChannelType.ToString());
-                    }
+
+
+                    Bass.StreamFree(decodeStream);
                 }
             }
         }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
index ae90dd96d5..9ed1350f56 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                 if (data == null || data.Length <= 0) yield break;
 
                 var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
-                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode | BassFlags.Prescan, fileCallbacks.Callbacks, fileCallbacks.Handle);
+                int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
 
                 // If the format is not supported by BASS
                 if (decodeStream == 0)
@@ -55,6 +55,8 @@ namespace osu.Game.Rulesets.Edit.Checks
 
                 if (!allowedFormats.Contains(audioInfo.ChannelType))
                     yield return new IssueTemplateIncorrectFormat(this).Create(audioFile.Filename, audioInfo.ChannelType.ToString());
+
+                Bass.StreamFree(decodeStream);
             }
         }
 

From ac03856ebdb8f8ffff860879263f16ab2564756b Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Wed, 17 Apr 2024 08:22:05 -0300
Subject: [PATCH 600/930] Fix test methods names

---
 osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs | 8 ++++----
 osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs      | 8 ++++----
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs     | 1 -
 3 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
index f85a296c74..9a806f6cb7 100644
--- a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestMP3Audio()
+        public void TestMp3Audio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample-cut.mp3"))
             {
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestOGGAudio()
+        public void TestOggAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample.ogg"))
             {
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestWAVAudio()
+        public void TestWavAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/hitsound-delay.wav"))
             {
@@ -75,7 +75,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestWEBMAudio()
+        public void TestWebmAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample.webm"))
             {
diff --git a/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
index 0755fdd8ac..98a4e1f9e9 100644
--- a/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckSongFormatTest.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestMP3Audio()
+        public void TestMp3Audio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample-cut.mp3"))
             {
@@ -55,7 +55,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestOGGAudio()
+        public void TestOggAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample.ogg"))
             {
@@ -66,7 +66,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestWAVAudio()
+        public void TestWavAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/hitsound-delay.wav"))
             {
@@ -78,7 +78,7 @@ namespace osu.Game.Tests.Editing.Checks
         }
 
         [Test]
-        public void TestWEBMAudio()
+        public void TestWebmAudio()
         {
             using (var resourceStream = TestResources.OpenResource("Samples/test-sample.webm"))
             {
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index c71c7b0ef3..3343d07f25 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -63,7 +63,6 @@ namespace osu.Game.Rulesets.Edit.Checks
                     if (!allowedFormats.Contains(audioInfo.ChannelType))
                         yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename, audioInfo.ChannelType.ToString());
 
-
                     Bass.StreamFree(decodeStream);
                 }
             }

From f92833b588577f6e55f53948f97a8ed284867fb0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Apr 2024 12:02:49 +0800
Subject: [PATCH 601/930] Add ability to quick exit from results screen

---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index e579c3fe51..f28b9b2554 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -191,6 +191,16 @@ namespace osu.Game.Screens.Ranking
                 });
             }
 
+            AddInternal(new HotkeyExitOverlay
+            {
+                Action = () =>
+                {
+                    if (!this.IsCurrentScreen()) return;
+
+                    this.Exit();
+                },
+            });
+
             if (player != null && AllowRetry)
             {
                 buttons.Add(new RetryButton { Width = 300 });

From d08b1e5ae7a413c3ec6a958b1bc592e20baf6c8e Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 17 Apr 2024 21:18:54 -0700
Subject: [PATCH 602/930] Add xmldoc to `GetScore()` and `Export()` and remove
 xmldoc from private `getDatabasedScoreInfo()`

---
 osu.Game/Scoring/ScoreManager.cs | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 3f6c6ee49d..b6bb637537 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -58,6 +58,15 @@ namespace osu.Game.Scoring
             };
         }
 
+        /// <summary>
+        /// Retrieve a <see cref="Score"/> from a given <see cref="IScoreInfo"/>.
+        /// </summary>
+        /// <param name="scoreInfo">The <see cref="IScoreInfo"/> to convert.</param>
+        /// <returns>The <see cref="Score"/>. Null if the score on the database cannot be found.</returns>
+        /// <remarks>
+        /// The <see cref="IScoreInfo"/> is re-retrieved from the database to ensure all the required data
+        /// for retrieving a replay are present (may have missing properties if it was retrieved from online data).
+        /// </remarks>
         public Score? GetScore(IScoreInfo scoreInfo)
         {
             ScoreInfo? databasedScoreInfo = getDatabasedScoreInfo(scoreInfo);
@@ -75,12 +84,6 @@ namespace osu.Game.Scoring
             return Realm.Run(r => r.All<ScoreInfo>().FirstOrDefault(query)?.Detach());
         }
 
-        /// <summary>
-        /// Re-retrieve a given <see cref="IScoreInfo"/> from the database to ensure all the required data for presenting / exporting a replay are present.
-        /// </summary>
-        /// <param name="originalScoreInfo">The <see cref="IScoreInfo"/> to attempt querying on.</param>
-        /// <returns>The databased score info. Null if the score on the database cannot be found.</returns>
-        /// <remarks>Can be used when the <see cref="IScoreInfo"/> was retrieved from online data, as it may have missing properties.</remarks>
         private ScoreInfo? getDatabasedScoreInfo(IScoreInfo originalScoreInfo)
         {
             ScoreInfo? databasedScoreInfo = null;
@@ -194,6 +197,15 @@ namespace osu.Game.Scoring
 
         public Task<IEnumerable<Live<ScoreInfo>>> Import(ProgressNotification notification, ImportTask[] tasks, ImportParameters parameters = default) => scoreImporter.Import(notification, tasks);
 
+        /// <summary>
+        /// Export a replay from a given <see cref="IScoreInfo"/>.
+        /// </summary>
+        /// <param name="scoreInfo">The <see cref="IScoreInfo"/> to export.</param>
+        /// <returns>The <see cref="Task"/>. Null if the score on the database cannot be found.</returns>
+        /// <remarks>
+        /// The <see cref="IScoreInfo"/> is re-retrieved from the database to ensure all the required data
+        /// for exporting a replay are present (may have missing properties if it was retrieved from online data).
+        /// </remarks>
         public Task? Export(ScoreInfo scoreInfo)
         {
             ScoreInfo? databasedScoreInfo = getDatabasedScoreInfo(scoreInfo);

From 46e2cfdba526d77106d1eff41ec5e542ac7e8bca Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 18 Apr 2024 18:33:30 +0800
Subject: [PATCH 603/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 2d7a9d2652..bf02a5d8e2 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.418.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 61ad2a4f5a..f279dc00cc 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.418.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.404.0" />
     <PackageReference Include="Sentry" Version="3.41.3" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index b2e3fc0779..4f973dbeb9 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.418.0" />
   </ItemGroup>
 </Project>

From a41ae99dd7e8f39c909a3519cce1817469b139a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 19 Apr 2024 15:14:52 +0800
Subject: [PATCH 604/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index bf02a5d8e2..c61977cfa3 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.418.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.419.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 4155d8c529..a336dff977 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.418.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.419.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 4f973dbeb9..6389172fe7 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.418.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.419.0" />
   </ItemGroup>
 </Project>

From 362a7b2c7735fa753e81c7075dba38b4d634e1be Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Apr 2024 18:03:13 +0900
Subject: [PATCH 605/930] Remove unused members from
 GameplaySkinComponentLookup

---
 osu.Game.Rulesets.Catch/CatchSkinComponentLookup.cs | 4 ----
 osu.Game.Rulesets.Mania/ManiaSkinComponentLookup.cs | 4 ----
 osu.Game.Rulesets.Osu/OsuSkinComponentLookup.cs     | 4 ----
 osu.Game.Rulesets.Taiko/TaikoSkinComponentLookup.cs | 4 ----
 osu.Game/Skinning/GameplaySkinComponentLookup.cs    | 3 ---
 5 files changed, 19 deletions(-)

diff --git a/osu.Game.Rulesets.Catch/CatchSkinComponentLookup.cs b/osu.Game.Rulesets.Catch/CatchSkinComponentLookup.cs
index 149aae1cb4..596b102ac5 100644
--- a/osu.Game.Rulesets.Catch/CatchSkinComponentLookup.cs
+++ b/osu.Game.Rulesets.Catch/CatchSkinComponentLookup.cs
@@ -11,9 +11,5 @@ namespace osu.Game.Rulesets.Catch
             : base(component)
         {
         }
-
-        protected override string RulesetPrefix => "catch"; // todo: use CatchRuleset.SHORT_NAME;
-
-        protected override string ComponentName => Component.ToString().ToLowerInvariant();
     }
 }
diff --git a/osu.Game.Rulesets.Mania/ManiaSkinComponentLookup.cs b/osu.Game.Rulesets.Mania/ManiaSkinComponentLookup.cs
index 44120e16e6..046d1c5b34 100644
--- a/osu.Game.Rulesets.Mania/ManiaSkinComponentLookup.cs
+++ b/osu.Game.Rulesets.Mania/ManiaSkinComponentLookup.cs
@@ -15,10 +15,6 @@ namespace osu.Game.Rulesets.Mania
             : base(component)
         {
         }
-
-        protected override string RulesetPrefix => ManiaRuleset.SHORT_NAME;
-
-        protected override string ComponentName => Component.ToString().ToLowerInvariant();
     }
 
     public enum ManiaSkinComponents
diff --git a/osu.Game.Rulesets.Osu/OsuSkinComponentLookup.cs b/osu.Game.Rulesets.Osu/OsuSkinComponentLookup.cs
index 81d5811f85..3b3653e1ba 100644
--- a/osu.Game.Rulesets.Osu/OsuSkinComponentLookup.cs
+++ b/osu.Game.Rulesets.Osu/OsuSkinComponentLookup.cs
@@ -11,9 +11,5 @@ namespace osu.Game.Rulesets.Osu
             : base(component)
         {
         }
-
-        protected override string RulesetPrefix => OsuRuleset.SHORT_NAME;
-
-        protected override string ComponentName => Component.ToString().ToLowerInvariant();
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/TaikoSkinComponentLookup.cs b/osu.Game.Rulesets.Taiko/TaikoSkinComponentLookup.cs
index c35971e9fd..8841c3d3ca 100644
--- a/osu.Game.Rulesets.Taiko/TaikoSkinComponentLookup.cs
+++ b/osu.Game.Rulesets.Taiko/TaikoSkinComponentLookup.cs
@@ -11,9 +11,5 @@ namespace osu.Game.Rulesets.Taiko
             : base(component)
         {
         }
-
-        protected override string RulesetPrefix => TaikoRuleset.SHORT_NAME;
-
-        protected override string ComponentName => Component.ToString().ToLowerInvariant();
     }
 }
diff --git a/osu.Game/Skinning/GameplaySkinComponentLookup.cs b/osu.Game/Skinning/GameplaySkinComponentLookup.cs
index ec159873f8..c317a17e21 100644
--- a/osu.Game/Skinning/GameplaySkinComponentLookup.cs
+++ b/osu.Game/Skinning/GameplaySkinComponentLookup.cs
@@ -24,8 +24,5 @@ namespace osu.Game.Skinning
         {
             Component = component;
         }
-
-        protected virtual string RulesetPrefix => string.Empty;
-        protected virtual string ComponentName => Component.ToString();
     }
 }

From 9d04b44a8872663476798264d8ab91943768f0da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 19 Apr 2024 11:04:05 +0200
Subject: [PATCH 606/930] Add failing test case

---
 .../UserInterface/TestSceneModSelectOverlay.cs  | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 6c75530a6e..8ddbd84890 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -612,6 +612,23 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("search text box unfocused", () => !modSelectOverlay.SearchTextBox.HasFocus);
         }
 
+        [Test]
+        public void TestSearchBoxFocusToggleRespondsToExternalChanges()
+        {
+            AddStep("text search does not start active", () => configManager.SetValue(OsuSetting.ModSelectTextSearchStartsActive, false));
+            createScreen();
+
+            AddUntilStep("search text box not focused", () => !modSelectOverlay.SearchTextBox.HasFocus);
+
+            AddStep("press tab", () => InputManager.Key(Key.Tab));
+            AddAssert("search text box focused", () => modSelectOverlay.SearchTextBox.HasFocus);
+
+            AddStep("unfocus search text box externally", () => InputManager.ChangeFocus(null));
+
+            AddStep("press tab", () => InputManager.Key(Key.Tab));
+            AddAssert("search text box focused", () => modSelectOverlay.SearchTextBox.HasFocus);
+        }
+
         [Test]
         public void TestTextSearchDoesNotBlockCustomisationPanelKeyboardInteractions()
         {

From 2dcbb823ef327f947547ed8f74990e74d021712d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 19 Apr 2024 11:08:34 +0200
Subject: [PATCH 607/930] Use textbox focus state directly rather than trying
 to track it independently

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 5ca26c739e..47362c0003 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -143,8 +143,6 @@ namespace osu.Game.Overlays.Mods
         protected ShearedToggleButton? CustomisationButton { get; private set; }
         protected SelectAllModsButton? SelectAllModsButton { get; set; }
 
-        private bool textBoxShouldFocus;
-
         private Sample? columnAppearSample;
 
         private WorkingBeatmap? beatmap;
@@ -542,7 +540,7 @@ namespace osu.Game.Overlays.Mods
             if (customisationVisible.Value)
                 SearchTextBox.KillFocus();
             else
-                setTextBoxFocus(textBoxShouldFocus);
+                setTextBoxFocus(textSearchStartsActive.Value);
         }
 
         /// <summary>
@@ -798,15 +796,13 @@ namespace osu.Game.Overlays.Mods
                 return false;
 
             // TODO: should probably eventually support typical platform search shortcuts (`Ctrl-F`, `/`)
-            setTextBoxFocus(!textBoxShouldFocus);
+            setTextBoxFocus(!SearchTextBox.HasFocus);
             return true;
         }
 
-        private void setTextBoxFocus(bool keepFocus)
+        private void setTextBoxFocus(bool focus)
         {
-            textBoxShouldFocus = keepFocus;
-
-            if (textBoxShouldFocus)
+            if (focus)
                 SearchTextBox.TakeFocus();
             else
                 SearchTextBox.KillFocus();

From 509862490e88f5ebea63005e23463336cb43f9d3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 19 Apr 2024 11:11:18 +0200
Subject: [PATCH 608/930] Revert unnecessary changes

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 47362c0003..25293e8e20 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -418,7 +418,7 @@ namespace osu.Game.Overlays.Mods
                 yield return new ColumnDimContainer(new ModPresetColumn
                 {
                     Margin = new MarginPadding { Right = 10 }
-                }, this);
+                });
             }
 
             yield return createModColumnContent(ModType.DifficultyReduction);
@@ -436,7 +436,7 @@ namespace osu.Game.Overlays.Mods
                 column.Margin = new MarginPadding { Right = 10 };
             });
 
-            return new ColumnDimContainer(column, this);
+            return new ColumnDimContainer(column);
         }
 
         private void createLocalMods()
@@ -895,17 +895,13 @@ namespace osu.Game.Overlays.Mods
             [Resolved]
             private OsuColour colours { get; set; } = null!;
 
-            private ModSelectOverlay modSelectOverlayInstance;
-
-            public ColumnDimContainer(ModSelectColumn column, ModSelectOverlay modSelectOverlay)
+            public ColumnDimContainer(ModSelectColumn column)
             {
                 AutoSizeAxes = Axes.X;
                 RelativeSizeAxes = Axes.Y;
 
                 Child = Column = column;
                 column.Active.BindTo(Active);
-
-                this.modSelectOverlayInstance = modSelectOverlay;
             }
 
             [BackgroundDependencyLoader]
@@ -953,7 +949,7 @@ namespace osu.Game.Overlays.Mods
                     RequestScroll?.Invoke(this);
 
                 // Killing focus is done here because it's the only feasible place on ModSelectOverlay you can click on without triggering any action.
-                modSelectOverlayInstance.setTextBoxFocus(false);
+                Scheduler.Add(() => GetContainingInputManager().ChangeFocus(null));
 
                 return true;
             }

From eac9dededfb59ab668cedc0e788aef11532cf152 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <90941580+64ArthurAraujo@users.noreply.github.com>
Date: Fri, 19 Apr 2024 07:20:59 -0300
Subject: [PATCH 609/930] Use periods instead of semicolons
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index 3343d07f25..d716f5ba3c 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateFormatUnsupported : IssueTemplate
         {
             public IssueTemplateFormatUnsupported(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format; Use wav or ogg for hitsounds.")
+                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format. Use wav or ogg for hitsounds.")
             {
             }
 
@@ -83,7 +83,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateIncorrectFormat : IssueTemplate
         {
             public IssueTemplateIncorrectFormat(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}); Use wav or ogg for hitsounds.")
+                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}). Use wav or ogg for hitsounds.")
             {
             }
 

From 68e86b5105fae6a4dd72bada15774b4ad2a052e0 Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Fri, 19 Apr 2024 07:38:55 -0300
Subject: [PATCH 610/930] Remove unsued import and add a blankline before
 `yield break;`

---
 osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
index 9ed1350f56..7dd469833e 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -48,6 +47,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                 if (decodeStream == 0)
                 {
                     yield return new IssueTemplateFormatUnsupported(this).Create(audioFile.Filename);
+
                     yield break;
                 }
 

From 92b85beff6735e83f3324427478833d0b62d504d Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Fri, 19 Apr 2024 08:01:23 -0300
Subject: [PATCH 611/930] Remove `ChannelType` from messages

---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 6 +++---
 osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs      | 8 ++++----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index d716f5ba3c..184311b1c3 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                     var audioInfo = Bass.ChannelGetInfo(decodeStream);
 
                     if (!allowedFormats.Contains(audioInfo.ChannelType))
-                        yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename, audioInfo.ChannelType.ToString());
+                        yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename);
 
                     Bass.StreamFree(decodeStream);
                 }
@@ -83,11 +83,11 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateIncorrectFormat : IssueTemplate
         {
             public IssueTemplateIncorrectFormat(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}). Use wav or ogg for hitsounds.")
+                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format. Use wav or ogg for hitsounds.")
             {
             }
 
-            public Issue Create(string file, string format) => new Issue(this, file, format);
+            public Issue Create(string file) => new Issue(this, file);
         }
     }
 }
diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
index 7dd469833e..0cb54709af 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Rulesets.Edit.Checks
                 var audioInfo = Bass.ChannelGetInfo(decodeStream);
 
                 if (!allowedFormats.Contains(audioInfo.ChannelType))
-                    yield return new IssueTemplateIncorrectFormat(this).Create(audioFile.Filename, audioInfo.ChannelType.ToString());
+                    yield return new IssueTemplateIncorrectFormat(this).Create(audioFile.Filename);
 
                 Bass.StreamFree(decodeStream);
             }
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateFormatUnsupported : IssueTemplate
         {
             public IssueTemplateFormatUnsupported(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format; Use mp3 or ogg for the song's audio.")
+                : base(check, IssueType.Problem, "\"{0}\" may be corrupt or using a unsupported audio format. Use mp3 or ogg for the song's audio.")
             {
             }
 
@@ -73,11 +73,11 @@ namespace osu.Game.Rulesets.Edit.Checks
         public class IssueTemplateIncorrectFormat : IssueTemplate
         {
             public IssueTemplateIncorrectFormat(ICheck check)
-                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format ({1}); Use mp3 or ogg for the song's audio.")
+                : base(check, IssueType.Problem, "\"{0}\" is using a incorrect format. Use mp3 or ogg for the song's audio.")
             {
             }
 
-            public Issue Create(string file, string format) => new Issue(this, file, format);
+            public Issue Create(string file) => new Issue(this, file);
         }
     }
 }

From ddc1b90ee1836662e788e02f266992cecad91e91 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Apr 2024 20:36:24 +0900
Subject: [PATCH 612/930] Remove unused method

---
 .../Skinning/ISerialisableDrawableContainer.cs    |  5 -----
 osu.Game/Skinning/SkinComponentsContainer.cs      | 15 ---------------
 2 files changed, 20 deletions(-)

diff --git a/osu.Game/Skinning/ISerialisableDrawableContainer.cs b/osu.Game/Skinning/ISerialisableDrawableContainer.cs
index a19c8c5162..57ea75bc7e 100644
--- a/osu.Game/Skinning/ISerialisableDrawableContainer.cs
+++ b/osu.Game/Skinning/ISerialisableDrawableContainer.cs
@@ -30,11 +30,6 @@ namespace osu.Game.Skinning
         /// </summary>
         void Reload();
 
-        /// <summary>
-        /// Reload this target from the provided skinnable information.
-        /// </summary>
-        void Reload(SerialisedDrawableInfo[] skinnableInfo);
-
         /// <summary>
         /// Add a new skinnable component to this target.
         /// </summary>
diff --git a/osu.Game/Skinning/SkinComponentsContainer.cs b/osu.Game/Skinning/SkinComponentsContainer.cs
index adf0a288b4..02ba43fd39 100644
--- a/osu.Game/Skinning/SkinComponentsContainer.cs
+++ b/osu.Game/Skinning/SkinComponentsContainer.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
 using osu.Framework.Bindables;
@@ -44,20 +43,6 @@ namespace osu.Game.Skinning
             Lookup = lookup;
         }
 
-        public void Reload(SerialisedDrawableInfo[] skinnableInfo)
-        {
-            var drawables = new List<Drawable>();
-
-            foreach (var i in skinnableInfo)
-                drawables.Add(i.CreateInstance());
-
-            Reload(new Container
-            {
-                RelativeSizeAxes = Axes.Both,
-                Children = drawables,
-            });
-        }
-
         public void Reload() => Reload(CurrentSkin.GetDrawableComponent(Lookup) as Container);
 
         public void Reload(Container? componentsContainer)

From bac70da1a1a12ddae4769da8ead2374ed6932311 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 19 Apr 2024 21:40:02 +0900
Subject: [PATCH 613/930] Give SerialisedDrawableInfo sane defaults

---
 osu.Game/Skinning/SerialisedDrawableInfo.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Skinning/SerialisedDrawableInfo.cs b/osu.Game/Skinning/SerialisedDrawableInfo.cs
index 2d6113ff70..ac1aa80d29 100644
--- a/osu.Game/Skinning/SerialisedDrawableInfo.cs
+++ b/osu.Game/Skinning/SerialisedDrawableInfo.cs
@@ -34,15 +34,15 @@ namespace osu.Game.Skinning
 
         public float Rotation { get; set; }
 
-        public Vector2 Scale { get; set; }
+        public Vector2 Scale { get; set; } = Vector2.One;
 
         public float? Width { get; set; }
 
         public float? Height { get; set; }
 
-        public Anchor Anchor { get; set; }
+        public Anchor Anchor { get; set; } = Anchor.TopLeft;
 
-        public Anchor Origin { get; set; }
+        public Anchor Origin { get; set; } = Anchor.TopLeft;
 
         /// <inheritdoc cref="ISerialisableDrawable.UsesFixedAnchor"/>
         public bool UsesFixedAnchor { get; set; }

From 4cffc39dffde5e14172df2693e71eebb4f3964ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 20 Apr 2024 04:53:31 +0800
Subject: [PATCH 614/930] Don't require hold for quick exit at results screen

---
 osu.Game/Screens/Ranking/ResultsScreen.cs | 19 +++++++++----------
 1 file changed, 9 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index f28b9b2554..ebb0530046 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -191,16 +191,6 @@ namespace osu.Game.Screens.Ranking
                 });
             }
 
-            AddInternal(new HotkeyExitOverlay
-            {
-                Action = () =>
-                {
-                    if (!this.IsCurrentScreen()) return;
-
-                    this.Exit();
-                },
-            });
-
             if (player != null && AllowRetry)
             {
                 buttons.Add(new RetryButton { Width = 300 });
@@ -400,6 +390,15 @@ namespace osu.Game.Screens.Ranking
 
             switch (e.Action)
             {
+                case GlobalAction.QuickExit:
+                    if (this.IsCurrentScreen())
+                    {
+                        this.Exit();
+                        return true;
+                    }
+
+                    break;
+
                 case GlobalAction.Select:
                     StatisticsPanel.ToggleVisibility();
                     return true;

From 722fa228cedfb81726dcc08e7b2baa4c524fb958 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sun, 21 Apr 2024 17:40:35 +0300
Subject: [PATCH 615/930] Don't consider editor table content for input

---
 osu.Game/Screens/Edit/EditorTable.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Screens/Edit/EditorTable.cs b/osu.Game/Screens/Edit/EditorTable.cs
index e5dc540b06..49b41fac21 100644
--- a/osu.Game/Screens/Edit/EditorTable.cs
+++ b/osu.Game/Screens/Edit/EditorTable.cs
@@ -30,6 +30,10 @@ namespace osu.Game.Screens.Edit
 
         protected readonly FillFlowContainer<RowBackground> BackgroundFlow;
 
+        // We can avoid potentially thousands of objects being added to the input sub-tree since item selection is being handled by the BackgroundFlow
+        // and no items in the underlying table are clickable.
+        protected override bool ShouldBeConsideredForInput(Drawable child) => base.ShouldBeConsideredForInput(child) && child == BackgroundFlow;
+
         protected EditorTable()
         {
             RelativeSizeAxes = Axes.X;

From 1d3fd65d86f517805f573517ad7650d1a89277af Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Mon, 22 Apr 2024 07:02:49 +0300
Subject: [PATCH 616/930] Adjust execution order

---
 osu.Game/Screens/Edit/EditorTable.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/EditorTable.cs b/osu.Game/Screens/Edit/EditorTable.cs
index 49b41fac21..4d8393e829 100644
--- a/osu.Game/Screens/Edit/EditorTable.cs
+++ b/osu.Game/Screens/Edit/EditorTable.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Screens.Edit
 
         // We can avoid potentially thousands of objects being added to the input sub-tree since item selection is being handled by the BackgroundFlow
         // and no items in the underlying table are clickable.
-        protected override bool ShouldBeConsideredForInput(Drawable child) => base.ShouldBeConsideredForInput(child) && child == BackgroundFlow;
+        protected override bool ShouldBeConsideredForInput(Drawable child) => child == BackgroundFlow && base.ShouldBeConsideredForInput(child);
 
         protected EditorTable()
         {

From 40c48f903bdfdb0f11809c5aeea268aec198fbb6 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Apr 2024 14:58:45 +0900
Subject: [PATCH 617/930] Add failing test

---
 .../TestSceneCursorTrail.cs                   | 31 +++++++++++++++----
 .../Skinning/Legacy/LegacyCursorTrail.cs      | 16 +++++-----
 2 files changed, 33 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
index 421a32b9eb..afb0246b21 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
@@ -5,6 +5,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Sample;
@@ -13,6 +14,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Rendering;
 using osu.Framework.Graphics.Textures;
+using osu.Framework.Testing;
 using osu.Framework.Testing.Input;
 using osu.Game.Audio;
 using osu.Game.Rulesets.Osu.Skinning.Legacy;
@@ -70,6 +72,22 @@ namespace osu.Game.Rulesets.Osu.Tests
             });
         }
 
+        [Test]
+        public void TestLegacyDisjointCursorTrailViaNoCursor()
+        {
+            createTest(() =>
+            {
+                var skinContainer = new LegacySkinContainer(renderer, false, false);
+                var legacyCursorTrail = new LegacyCursorTrail(skinContainer);
+
+                skinContainer.Child = legacyCursorTrail;
+
+                return skinContainer;
+            });
+
+            AddAssert("trail is disjoint", () => this.ChildrenOfType<LegacyCursorTrail>().Single().DisjointTrail, () => Is.True);
+        }
+
         private void createTest(Func<Drawable> createContent) => AddStep("create trail", () =>
         {
             Clear();
@@ -87,11 +105,13 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             private readonly IRenderer renderer;
             private readonly bool disjoint;
+            private readonly bool provideCursor;
 
-            public LegacySkinContainer(IRenderer renderer, bool disjoint)
+            public LegacySkinContainer(IRenderer renderer, bool disjoint, bool provideCursor = true)
             {
                 this.renderer = renderer;
                 this.disjoint = disjoint;
+                this.provideCursor = provideCursor;
 
                 RelativeSizeAxes = Axes.Both;
             }
@@ -102,12 +122,11 @@ namespace osu.Game.Rulesets.Osu.Tests
             {
                 switch (componentName)
                 {
-                    case "cursortrail":
-                        var tex = new Texture(renderer.WhitePixel);
+                    case "cursor":
+                        return provideCursor ? new Texture(renderer.WhitePixel) : null;
 
-                        if (disjoint)
-                            tex.ScaleAdjust = 1 / 25f;
-                        return tex;
+                    case "cursortrail":
+                        return new Texture(renderer.WhitePixel);
 
                     case "cursormiddle":
                         return disjoint ? null : renderer.WhitePixel;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
index af71e2a5d9..4ebafd0c4b 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
@@ -18,7 +18,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         private readonly ISkin skin;
         private const double disjoint_trail_time_separation = 1000 / 60.0;
 
-        private bool disjointTrail;
+        public bool DisjointTrail { get; private set; }
         private double lastTrailTime;
 
         private IBindable<float> cursorSize = null!;
@@ -36,9 +36,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             cursorSize = config.GetBindable<float>(OsuSetting.GameplayCursorSize).GetBoundCopy();
 
             Texture = skin.GetTexture("cursortrail");
-            disjointTrail = skin.GetTexture("cursormiddle") == null;
+            DisjointTrail = skin.GetTexture("cursormiddle") == null;
 
-            if (disjointTrail)
+            if (DisjointTrail)
             {
                 bool centre = skin.GetConfig<OsuSkinConfiguration, bool>(OsuSkinConfiguration.CursorCentre)?.Value ?? true;
 
@@ -57,19 +57,19 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
             }
         }
 
-        protected override double FadeDuration => disjointTrail ? 150 : 500;
+        protected override double FadeDuration => DisjointTrail ? 150 : 500;
         protected override float FadeExponent => 1;
 
-        protected override bool InterpolateMovements => !disjointTrail;
+        protected override bool InterpolateMovements => !DisjointTrail;
 
         protected override float IntervalMultiplier => 1 / Math.Max(cursorSize.Value, 1);
-        protected override bool AvoidDrawingNearCursor => !disjointTrail;
+        protected override bool AvoidDrawingNearCursor => !DisjointTrail;
 
         protected override void Update()
         {
             base.Update();
 
-            if (!disjointTrail || !currentPosition.HasValue)
+            if (!DisjointTrail || !currentPosition.HasValue)
                 return;
 
             if (Time.Current - lastTrailTime >= disjoint_trail_time_separation)
@@ -81,7 +81,7 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
         protected override bool OnMouseMove(MouseMoveEvent e)
         {
-            if (!disjointTrail)
+            if (!DisjointTrail)
                 return base.OnMouseMove(e);
 
             currentPosition = e.ScreenSpaceMousePosition;

From 0170c04baf447abd9a4f986bcc169f940e92f9d4 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Mon, 22 Apr 2024 15:00:09 +0900
Subject: [PATCH 618/930] Fix `cursormiddle` not using the same source as
 `cursor`

---
 osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
index 4ebafd0c4b..da52956719 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
@@ -31,12 +31,14 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
         }
 
         [BackgroundDependencyLoader]
-        private void load(OsuConfigManager config)
+        private void load(OsuConfigManager config, ISkinSource skinSource)
         {
             cursorSize = config.GetBindable<float>(OsuSetting.GameplayCursorSize).GetBoundCopy();
 
             Texture = skin.GetTexture("cursortrail");
-            DisjointTrail = skin.GetTexture("cursormiddle") == null;
+
+            var cursorProvider = skinSource.FindProvider(s => s.GetTexture("cursor") != null);
+            DisjointTrail = cursorProvider?.GetTexture("cursormiddle") == null;
 
             if (DisjointTrail)
             {

From fb1d20bd39605eca96837d2d8e9b2cc394800cba Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Apr 2024 15:07:11 +0800
Subject: [PATCH 619/930] Comment in some clarification

---
 .../TestSceneCursorTrail.cs                        | 14 +++++++-------
 .../Skinning/Legacy/LegacyCursorTrail.cs           |  3 +++
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
index afb0246b21..4db66fde4b 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneCursorTrail.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             createTest(() =>
             {
-                var skinContainer = new LegacySkinContainer(renderer, false);
+                var skinContainer = new LegacySkinContainer(renderer, provideMiddle: false);
                 var legacyCursorTrail = new LegacyCursorTrail(skinContainer);
 
                 skinContainer.Child = legacyCursorTrail;
@@ -63,7 +63,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             createTest(() =>
             {
-                var skinContainer = new LegacySkinContainer(renderer, true);
+                var skinContainer = new LegacySkinContainer(renderer, provideMiddle: true);
                 var legacyCursorTrail = new LegacyCursorTrail(skinContainer);
 
                 skinContainer.Child = legacyCursorTrail;
@@ -77,7 +77,7 @@ namespace osu.Game.Rulesets.Osu.Tests
         {
             createTest(() =>
             {
-                var skinContainer = new LegacySkinContainer(renderer, false, false);
+                var skinContainer = new LegacySkinContainer(renderer, provideMiddle: false, provideCursor: false);
                 var legacyCursorTrail = new LegacyCursorTrail(skinContainer);
 
                 skinContainer.Child = legacyCursorTrail;
@@ -104,13 +104,13 @@ namespace osu.Game.Rulesets.Osu.Tests
         private partial class LegacySkinContainer : Container, ISkinSource
         {
             private readonly IRenderer renderer;
-            private readonly bool disjoint;
+            private readonly bool provideMiddle;
             private readonly bool provideCursor;
 
-            public LegacySkinContainer(IRenderer renderer, bool disjoint, bool provideCursor = true)
+            public LegacySkinContainer(IRenderer renderer, bool provideMiddle, bool provideCursor = true)
             {
                 this.renderer = renderer;
-                this.disjoint = disjoint;
+                this.provideMiddle = provideMiddle;
                 this.provideCursor = provideCursor;
 
                 RelativeSizeAxes = Axes.Both;
@@ -129,7 +129,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                         return new Texture(renderer.WhitePixel);
 
                     case "cursormiddle":
-                        return disjoint ? null : renderer.WhitePixel;
+                        return provideMiddle ? null : renderer.WhitePixel;
                 }
 
                 return null;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
index da52956719..ca0002d8c0 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Legacy/LegacyCursorTrail.cs
@@ -37,6 +37,9 @@ namespace osu.Game.Rulesets.Osu.Skinning.Legacy
 
             Texture = skin.GetTexture("cursortrail");
 
+            // Cursor and cursor trail components are sourced from potentially different skin sources.
+            // Stable always chooses cursor trail disjoint behaviour based on the cursor texture lookup source, so we need to fetch where that occurred.
+            // See https://github.com/peppy/osu-stable-reference/blob/3ea48705eb67172c430371dcfc8a16a002ed0d3d/osu!/Graphics/Skinning/SkinManager.cs#L269
             var cursorProvider = skinSource.FindProvider(s => s.GetTexture("cursor") != null);
             DisjointTrail = cursorProvider?.GetTexture("cursormiddle") == null;
 

From 49563f4e5bc9ce3ea72b5645456a6d0e8af6a89c Mon Sep 17 00:00:00 2001
From: Arthur Araujo <arthur.araujo@tutanota.com>
Date: Mon, 22 Apr 2024 04:44:38 -0300
Subject: [PATCH 620/930] Use bitwise to check hitsound formats

---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index 184311b1c3..9779696e4b 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -3,7 +3,6 @@
 
 using System.Collections.Generic;
 using System.IO;
-using System.Linq;
 using ManagedBass;
 using osu.Framework.Audio.Callbacks;
 using osu.Game.Beatmaps;
@@ -22,14 +21,6 @@ namespace osu.Game.Rulesets.Edit.Checks
             new IssueTemplateIncorrectFormat(this),
         };
 
-        private IEnumerable<ChannelType> allowedFormats => new ChannelType[]
-        {
-            ChannelType.WavePCM,
-            ChannelType.WaveFloat,
-            ChannelType.OGG,
-            ChannelType.Wave | ChannelType.OGG,
-        };
-
         public IEnumerable<Issue> Run(BeatmapVerifierContext context)
         {
             var beatmapSet = context.Beatmap.BeatmapInfo.BeatmapSet;
@@ -60,7 +51,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
                     var audioInfo = Bass.ChannelGetInfo(decodeStream);
 
-                    if (!allowedFormats.Contains(audioInfo.ChannelType))
+                    if ((audioInfo.ChannelType & ChannelType.Wave) == 0 && audioInfo.ChannelType != ChannelType.OGG)
                         yield return new IssueTemplateIncorrectFormat(this).Create(file.Filename);
 
                     Bass.StreamFree(decodeStream);

From 09b0f3005e28cb2248ddb206b80d3eb3a94c6e2b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Apr 2024 10:15:56 +0200
Subject: [PATCH 621/930] Apply generic math-related changes

---
 osu.Game/Graphics/UserInterface/ExpandableSlider.cs      | 8 ++++----
 osu.Game/Graphics/UserInterface/OsuSliderBar.cs          | 9 +++++----
 osu.Game/Graphics/UserInterface/RoundedSliderBar.cs      | 5 +++--
 osu.Game/Graphics/UserInterface/ShearedSliderBar.cs      | 5 +++--
 osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs   | 4 ++--
 .../Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs   | 8 ++++----
 osu.Game/Overlays/Settings/Sections/SizeSlider.cs        | 3 ++-
 osu.Game/Overlays/Settings/SettingsPercentageSlider.cs   | 4 ++--
 osu.Game/Overlays/Settings/SettingsSlider.cs             | 6 +++---
 .../Edit/Timing/IndeterminateSliderWithTextBoxInput.cs   | 8 ++++----
 osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs  | 4 ++--
 11 files changed, 34 insertions(+), 30 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index 121a1eef49..a7a8561b94 100644
--- a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -18,7 +18,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandable, IHasCurrentValue<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
         where TSlider : RoundedSliderBar<T>, new()
     {
         private readonly OsuSpriteText label;
@@ -129,7 +129,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T> : ExpandableSlider<T, RoundedSliderBar<T>>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 191a7ca246..9cb6356cab 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -15,7 +16,7 @@ using osu.Game.Utils;
 namespace osu.Game.Graphics.UserInterface
 {
     public abstract partial class OsuSliderBar<T> : SliderBar<T>, IHasTooltip
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         public bool PlaySamplesOnAdjust { get; set; } = true;
 
@@ -85,11 +86,11 @@ namespace osu.Game.Graphics.UserInterface
         private LocalisableString getTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
-                return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
+                return int.CreateTruncating(value).ToString("N0");
 
-            double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
+            double floatValue = double.CreateTruncating(value);
 
-            decimal decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), max_decimal_digits);
+            decimal decimalPrecision = normalise(decimal.CreateTruncating(CurrentNumber.Precision), max_decimal_digits);
 
             // Find the number of significant digits (we could have less than 5 after normalize())
             int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
diff --git a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
index 0981881ead..56047173bb 100644
--- a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osuTK;
+using System.Numerics;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -11,11 +11,12 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class RoundedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         protected readonly Nub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
index 60a6670492..0df1c1d204 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osuTK;
+using System.Numerics;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -12,11 +12,12 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
 using static osu.Game.Graphics.UserInterface.ShearedNub;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class ShearedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         protected readonly ShearedNub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
index 4585d3a4c9..4912a21fab 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
@@ -1,14 +1,14 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class LabelledSliderBar<TNumber> : LabelledComponent<SettingsSlider<TNumber>, TNumber>
-        where TNumber : struct, IEquatable<TNumber>, IComparable<TNumber>, IConvertible
+        where TNumber : struct, INumber<TNumber>, IMinMaxValue<TNumber>
     {
         public LabelledSliderBar()
             : base(true)
diff --git a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
index e5ba7f61bf..abd828e98f 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,12 +10,12 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class SliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -138,7 +138,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         {
             if (updatingFromTextBox) return;
 
-            decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
+            decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
             textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index c73831d8d1..14ef58ff88 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
@@ -12,7 +13,7 @@ namespace osu.Game.Overlays.Settings.Sections
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
     public partial class SizeSlider<T> : RoundedSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
+        where T : struct, INumber<T>, IMinMaxValue<T>, IFormattable
     {
         public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
index fa59d18de1..d7a09d3392 100644
--- a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
@@ -13,7 +13,7 @@ namespace osu.Game.Overlays.Settings
     /// Mostly provided for convenience of use with <see cref="SettingSourceAttribute"/>.
     /// </summary>
     public partial class SettingsPercentageSlider<TValue> : SettingsSlider<TValue>
-        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
+        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
     {
         protected override Drawable CreateControl() => ((RoundedSliderBar<TValue>)base.CreateControl()).With(sliderBar => sliderBar.DisplayAsPercentage = true);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index 6c81fece13..2460d78099 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
@@ -9,12 +9,12 @@ using osu.Game.Graphics.UserInterface;
 namespace osu.Game.Overlays.Settings
 {
     public partial class SettingsSlider<T> : SettingsSlider<T, RoundedSliderBar<T>>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
     }
 
     public partial class SettingsSlider<TValue, TSlider> : SettingsItem<TValue>
-        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
+        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
         where TSlider : RoundedSliderBar<TValue>, new()
     {
         protected override Drawable CreateControl() => new TSlider
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 151d469415..26f374ba85 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -12,7 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Edit.Timing
     /// by providing an "indeterminate state".
     /// </summary>
     public partial class IndeterminateSliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T?>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -136,7 +136,7 @@ namespace osu.Game.Screens.Edit.Timing
                 slider.Current.Value = nonNullValue;
 
                 // use the value from the slider to ensure that any precision/min/max set on it via the initial indeterminate value have been applied correctly.
-                decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
+                decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
                 textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
                 textBox.PlaceholderText = string.Empty;
             }
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 88b778fafb..1fc1155c0b 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
@@ -11,7 +11,7 @@ using osu.Game.Overlays.Settings;
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public partial class PlayerSliderBar<T> : SettingsSlider<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         public RoundedSliderBar<T> Bar => (RoundedSliderBar<T>)Control;
 

From 1bcf835d227ce3899d1e16ff16cfba4a9c08dcd6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Apr 2024 10:25:46 +0200
Subject: [PATCH 622/930] Remove redundant array type specification

---
 osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
index 0cb54709af..dd01fe110a 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckSongFormat.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Rulesets.Edit.Checks
             new IssueTemplateIncorrectFormat(this),
         };
 
-        private IEnumerable<ChannelType> allowedFormats => new ChannelType[]
+        private IEnumerable<ChannelType> allowedFormats => new[]
         {
             ChannelType.MP3,
             ChannelType.OGG,

From ceeb9b081903dab467a5659595f6746403ccc845 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Apr 2024 10:27:30 +0200
Subject: [PATCH 623/930] Use explicit reference equality check

---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index 9779696e4b..728567b490 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -30,7 +30,7 @@ namespace osu.Game.Rulesets.Edit.Checks
 
             foreach (var file in beatmapSet.Files)
             {
-                if (audioFile != null && file.File == audioFile.File) continue;
+                if (audioFile != null && ReferenceEquals(file.File, audioFile.File)) continue;
 
                 using (Stream data = context.WorkingBeatmap.GetStream(file.File.GetStoragePath()))
                 {

From b28bf4d2ecf2dbc6b11b01ffdca5ae6adbcaecaa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Apr 2024 10:43:20 +0200
Subject: [PATCH 624/930] Add test covering non-audio file formats not being
 checked

---
 .../Checks/CheckHitsoundsFormatTest.cs        | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
index 9a806f6cb7..cb1cf21734 100644
--- a/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
+++ b/osu.Game.Tests/Editing/Checks/CheckHitsoundsFormatTest.cs
@@ -85,6 +85,27 @@ namespace osu.Game.Tests.Editing.Checks
             }
         }
 
+        [Test]
+        public void TestNotAnAudioFile()
+        {
+            beatmap = new Beatmap<HitObject>
+            {
+                BeatmapInfo = new BeatmapInfo
+                {
+                    BeatmapSet = new BeatmapSetInfo
+                    {
+                        Files = { CheckTestHelpers.CreateMockFile("png") }
+                    }
+                }
+            };
+
+            using (var resourceStream = TestResources.OpenResource("Textures/test-image.png"))
+            {
+                var issues = check.Run(getContext(resourceStream)).ToList();
+                Assert.That(issues, Has.Count.EqualTo(0));
+            }
+        }
+
         [Test]
         public void TestCorruptAudio()
         {

From 70a5288a6859dae28f7870f338e82cbbdcf4c1fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 22 Apr 2024 10:45:09 +0200
Subject: [PATCH 625/930] Do not attempt to pass files that don't look like
 audio to BASS

---
 osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
index 728567b490..9b6a861358 100644
--- a/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
+++ b/osu.Game/Rulesets/Edit/Checks/CheckHitsoundsFormat.cs
@@ -37,14 +37,16 @@ namespace osu.Game.Rulesets.Edit.Checks
                     if (data == null)
                         continue;
 
+                    if (!AudioCheckUtils.HasAudioExtension(file.Filename) || !probablyHasAudioData(data))
+                        continue;
+
                     var fileCallbacks = new FileCallbacks(new DataStreamFileProcedures(data));
                     int decodeStream = Bass.CreateStream(StreamSystem.NoBuffer, BassFlags.Decode, fileCallbacks.Callbacks, fileCallbacks.Handle);
 
                     // If the format is not supported by BASS
                     if (decodeStream == 0)
                     {
-                        if (AudioCheckUtils.HasAudioExtension(file.Filename) && probablyHasAudioData(data))
-                            yield return new IssueTemplateFormatUnsupported(this).Create(file.Filename);
+                        yield return new IssueTemplateFormatUnsupported(this).Create(file.Filename);
 
                         continue;
                     }

From 4ae9f81c73f39828e4e812cc362bacbda2656c9f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Apr 2024 18:43:15 +0800
Subject: [PATCH 626/930] Apply transforms to storyboard videos

This requires that they are a `StoryboardSprite` for simplicity. Luckily
this works just fine.
---
 .../Beatmaps/Formats/LegacyStoryboardDecoder.cs   |  2 +-
 osu.Game/Storyboards/StoryboardVideo.cs           | 15 +++++----------
 2 files changed, 6 insertions(+), 11 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
index 6689f087cb..b5d9ad1194 100644
--- a/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyStoryboardDecoder.cs
@@ -114,7 +114,7 @@ namespace osu.Game.Beatmaps.Formats
                         if (!OsuGameBase.VIDEO_EXTENSIONS.Contains(Path.GetExtension(path).ToLowerInvariant()))
                             break;
 
-                        storyboard.GetLayer("Video").Add(new StoryboardVideo(path, offset));
+                        storyboard.GetLayer("Video").Add(storyboardSprite = new StoryboardVideo(path, offset));
                         break;
                     }
 
diff --git a/osu.Game/Storyboards/StoryboardVideo.cs b/osu.Game/Storyboards/StoryboardVideo.cs
index 8c11e19a06..bd1b933b6f 100644
--- a/osu.Game/Storyboards/StoryboardVideo.cs
+++ b/osu.Game/Storyboards/StoryboardVideo.cs
@@ -3,23 +3,18 @@
 
 using osu.Framework.Graphics;
 using osu.Game.Storyboards.Drawables;
+using osuTK;
 
 namespace osu.Game.Storyboards
 {
-    public class StoryboardVideo : IStoryboardElement
+    public class StoryboardVideo : StoryboardSprite
     {
-        public string Path { get; }
-
-        public bool IsDrawable => true;
-
-        public double StartTime { get; }
-
         public StoryboardVideo(string path, double offset)
+            : base(path, Anchor.Centre, Vector2.Zero)
         {
-            Path = path;
-            StartTime = offset;
+            TimelineGroup.Alpha.Add(Easing.None, offset, offset, 0, 1);
         }
 
-        public Drawable CreateDrawable() => new DrawableStoryboardVideo(this);
+        public override Drawable CreateDrawable() => new DrawableStoryboardVideo(this);
     }
 }

From c43c383abf5d05caa5827b23b1fd53f61cff5b55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Apr 2024 18:43:34 +0800
Subject: [PATCH 627/930] Allow storboard videos to take on no-relative size
 when specified by a mapper

---
 .../Drawables/DrawableStoryboardVideo.cs           | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index 9a5db4bb39..98cb01d5f3 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -23,7 +23,17 @@ namespace osu.Game.Storyboards.Drawables
         {
             Video = video;
 
-            RelativeSizeAxes = Axes.Both;
+            // In osu-stable, a mapper can add a scale command for a storyboard.
+            // This allows scaling based on the video's absolute size.
+            //
+            // If not specified we take up the full available space.
+            bool useRelative = !video.TimelineGroup.Scale.HasCommands;
+
+            RelativeSizeAxes = useRelative ? Axes.Both : Axes.None;
+            AutoSizeAxes = useRelative ? Axes.None : Axes.Both;
+
+            Anchor = Anchor.Centre;
+            Origin = Anchor.Centre;
         }
 
         [BackgroundDependencyLoader(true)]
@@ -36,7 +46,7 @@ namespace osu.Game.Storyboards.Drawables
 
             InternalChild = drawableVideo = new Video(stream, false)
             {
-                RelativeSizeAxes = Axes.Both,
+                RelativeSizeAxes = RelativeSizeAxes,
                 FillMode = FillMode.Fill,
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,

From 9e7182acf0cfa3fc658758b78af4dc7378cef536 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Apr 2024 18:45:02 +0800
Subject: [PATCH 628/930] Remove unused DI beatmap paramater

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index 98cb01d5f3..ca2c7b774c 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -2,12 +2,10 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Graphics.Video;
-using osu.Game.Beatmaps;
 
 namespace osu.Game.Storyboards.Drawables
 {
@@ -37,7 +35,7 @@ namespace osu.Game.Storyboards.Drawables
         }
 
         [BackgroundDependencyLoader(true)]
-        private void load(IBindable<WorkingBeatmap> beatmap, TextureStore textureStore)
+        private void load(TextureStore textureStore)
         {
             var stream = textureStore.GetStream(Video.Path);
 

From 2eda56ff0859a0e0fe44e59d2b7f936139dcc94b Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 22 Apr 2024 11:15:50 -0700
Subject: [PATCH 629/930] Revert beatmap query change

---
 osu.Game/OsuGame.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index ccdf9d151f..98533a5c82 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -716,7 +716,7 @@ namespace osu.Game
                 return;
             }
 
-            var databasedBeatmap = BeatmapManager.QueryBeatmap(b => b.OnlineID == score.Beatmap.OnlineID);
+            var databasedBeatmap = BeatmapManager.QueryBeatmap(b => b.ID == databasedScore.ScoreInfo.BeatmapInfo.ID);
 
             if (databasedBeatmap == null)
             {

From a59bf6d373cfdc234261fc1ce2d489803bd35f14 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 22 Apr 2024 11:17:27 -0700
Subject: [PATCH 630/930] Improve xmldoc wording

---
 osu.Game/Scoring/ScoreManager.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index b6bb637537..f37ee2b101 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Scoring
         /// Retrieve a <see cref="Score"/> from a given <see cref="IScoreInfo"/>.
         /// </summary>
         /// <param name="scoreInfo">The <see cref="IScoreInfo"/> to convert.</param>
-        /// <returns>The <see cref="Score"/>. Null if the score on the database cannot be found.</returns>
+        /// <returns>The <see cref="Score"/>. Null if the score cannot be found in the database.</returns>
         /// <remarks>
         /// The <see cref="IScoreInfo"/> is re-retrieved from the database to ensure all the required data
         /// for retrieving a replay are present (may have missing properties if it was retrieved from online data).
@@ -201,7 +201,7 @@ namespace osu.Game.Scoring
         /// Export a replay from a given <see cref="IScoreInfo"/>.
         /// </summary>
         /// <param name="scoreInfo">The <see cref="IScoreInfo"/> to export.</param>
-        /// <returns>The <see cref="Task"/>. Null if the score on the database cannot be found.</returns>
+        /// <returns>The <see cref="Task"/>. Null if the score cannot be found in the database.</returns>
         /// <remarks>
         /// The <see cref="IScoreInfo"/> is re-retrieved from the database to ensure all the required data
         /// for exporting a replay are present (may have missing properties if it was retrieved from online data).

From 35eddf35c5651b883a65e955a750ddd2c05b47be Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 22 Apr 2024 11:22:39 -0700
Subject: [PATCH 631/930] Return `Task.CompletedTask` instead of `null`

---
 osu.Game/Scoring/ScoreManager.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index f37ee2b101..1ba5c7d4cf 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -201,16 +201,16 @@ namespace osu.Game.Scoring
         /// Export a replay from a given <see cref="IScoreInfo"/>.
         /// </summary>
         /// <param name="scoreInfo">The <see cref="IScoreInfo"/> to export.</param>
-        /// <returns>The <see cref="Task"/>. Null if the score cannot be found in the database.</returns>
+        /// <returns>The <see cref="Task"/>. Return <see cref="Task.CompletedTask"/> if the score cannot be found in the database.</returns>
         /// <remarks>
         /// The <see cref="IScoreInfo"/> is re-retrieved from the database to ensure all the required data
         /// for exporting a replay are present (may have missing properties if it was retrieved from online data).
         /// </remarks>
-        public Task? Export(ScoreInfo scoreInfo)
+        public Task Export(ScoreInfo scoreInfo)
         {
             ScoreInfo? databasedScoreInfo = getDatabasedScoreInfo(scoreInfo);
 
-            return databasedScoreInfo == null ? null : scoreExporter.ExportAsync(databasedScoreInfo.ToLive(Realm));
+            return databasedScoreInfo == null ? Task.CompletedTask : scoreExporter.ExportAsync(databasedScoreInfo.ToLive(Realm));
         }
 
         public Task<Live<ScoreInfo>?> ImportAsUpdate(ProgressNotification notification, ImportTask task, ScoreInfo original) => scoreImporter.ImportAsUpdate(notification, task, original);

From 49154c0e231c25f78c849ecf7180b4240b9e0145 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 22 Apr 2024 11:23:38 -0700
Subject: [PATCH 632/930] Fix code quality

---
 osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs       | 2 +-
 .../Visual/UserInterface/TestSceneDeleteLocalScore.cs           | 2 +-
 osu.Game/Screens/Play/Player.cs                                 | 1 +
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 6590339311..004d1de116 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -170,7 +170,7 @@ namespace osu.Game.Tests.Visual.Navigation
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo,
                     User = new GuestUser(),
-                }).Value;
+                })!.Value;
             });
 
             AddAssert($"import {i} succeeded", () => imported != null);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
index 529874b71e..e2fe10fa74 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneDeleteLocalScore.cs
@@ -104,7 +104,7 @@ namespace osu.Game.Tests.Visual.UserInterface
                         Files = { new RealmNamedFileUsage(new RealmFile { Hash = $"{i}" }, string.Empty) }
                     };
 
-                    importedScores.Add(scoreManager.Import(score).Value);
+                    importedScores.Add(scoreManager.Import(score)!.Value);
                 }
             });
         });
diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 4fcc52bc5d..3a80caf259 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -1200,6 +1200,7 @@ namespace osu.Game.Screens.Play
             var importableScore = score.ScoreInfo.DeepClone();
 
             var imported = scoreManager.Import(importableScore, replayReader);
+            Debug.Assert(imported != null);
 
             imported.PerformRead(s =>
             {

From 50afd48812aaf7e4deb437855202836280c93339 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 22 Apr 2024 23:04:56 +0800
Subject: [PATCH 633/930] Add manual test coverage of storyboard videos

---
 .../TestSceneDrawableStoryboardSprite.cs      | 98 ++++++++++++++-----
 1 file changed, 75 insertions(+), 23 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 32693c2bb2..6ac112cc5f 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -10,6 +10,7 @@ using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.IEnumerableExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.IO.Stores;
 using osu.Framework.Testing;
@@ -40,7 +41,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("disallow all lookups", () =>
             {
                 storyboard.UseSkinSprites = false;
-                storyboard.AlwaysProvideTexture = false;
+                storyboard.ProvideResources = false;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -55,7 +56,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow storyboard lookup", () =>
             {
                 storyboard.UseSkinSprites = false;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -67,13 +68,47 @@ namespace osu.Game.Tests.Visual.Gameplay
             assertStoryboardSourced();
         }
 
+        [TestCase(false)]
+        [TestCase(true)]
+        public void TestVideo(bool scaleTransformProvided)
+        {
+            AddStep("allow storyboard lookup", () =>
+            {
+                storyboard.ProvideResources = true;
+            });
+
+            AddStep("create video", () => SetContents(_ =>
+            {
+                var layer = storyboard.GetLayer("Video");
+
+                var sprite = new StoryboardVideo("Videos/test-video.mp4", Time.Current);
+
+                sprite.AddLoop(Time.Current, 100).Alpha.Add(Easing.None, 0, 10000, 1, 1);
+
+                if (scaleTransformProvided)
+                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current, Time.Current, 1, 1);
+
+                layer.Elements.Clear();
+                layer.Add(sprite);
+
+                return new Container
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Children = new Drawable[]
+                    {
+                        storyboard.CreateDrawable()
+                    }
+                };
+            }));
+        }
+
         [Test]
         public void TestSkinLookupPreferredOverStoryboard()
         {
             AddStep("allow all lookups", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -91,7 +126,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow skin lookup", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = false;
+                storyboard.ProvideResources = false;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -109,7 +144,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow all lookups", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -127,7 +162,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow all lookups", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -142,7 +177,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow all lookups", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -156,7 +191,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddStep("allow all lookups", () =>
             {
                 storyboard.UseSkinSprites = true;
-                storyboard.AlwaysProvideTexture = true;
+                storyboard.ProvideResources = true;
             });
 
             AddStep("create sprites", () => SetContents(_ => createSprite(lookup_name, Anchor.TopLeft, Vector2.Zero)));
@@ -170,7 +205,7 @@ namespace osu.Game.Tests.Visual.Gameplay
             AddAssert("origin back", () => sprites.All(s => s.Origin == Anchor.TopLeft));
         }
 
-        private DrawableStoryboard createSprite(string lookupName, Anchor origin, Vector2 initialPosition)
+        private Drawable createSprite(string lookupName, Anchor origin, Vector2 initialPosition)
         {
             var layer = storyboard.GetLayer("Background");
 
@@ -180,7 +215,14 @@ namespace osu.Game.Tests.Visual.Gameplay
             layer.Elements.Clear();
             layer.Add(sprite);
 
-            return storyboard.CreateDrawable().With(s => s.RelativeSizeAxes = Axes.Both);
+            return new Container
+            {
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
+                {
+                    storyboard.CreateDrawable()
+                }
+            };
         }
 
         private void assertStoryboardSourced()
@@ -202,42 +244,52 @@ namespace osu.Game.Tests.Visual.Gameplay
                 return new TestDrawableStoryboard(this, mods);
             }
 
-            public bool AlwaysProvideTexture { get; set; }
+            public bool ProvideResources { get; set; }
 
-            public override string GetStoragePathFromStoryboardPath(string path) => AlwaysProvideTexture ? path : string.Empty;
+            public override string GetStoragePathFromStoryboardPath(string path) => ProvideResources ? path : string.Empty;
 
             private partial class TestDrawableStoryboard : DrawableStoryboard
             {
-                private readonly bool alwaysProvideTexture;
+                private readonly bool provideResources;
 
                 public TestDrawableStoryboard(TestStoryboard storyboard, IReadOnlyList<Mod>? mods)
                     : base(storyboard, mods)
                 {
-                    alwaysProvideTexture = storyboard.AlwaysProvideTexture;
+                    provideResources = storyboard.ProvideResources;
                 }
 
-                protected override IResourceStore<byte[]> CreateResourceLookupStore() => alwaysProvideTexture
-                    ? new AlwaysReturnsTextureStore()
+                protected override IResourceStore<byte[]> CreateResourceLookupStore() => provideResources
+                    ? new ResourcesTextureStore()
                     : new ResourceStore<byte[]>();
 
-                internal class AlwaysReturnsTextureStore : IResourceStore<byte[]>
+                internal class ResourcesTextureStore : IResourceStore<byte[]>
                 {
-                    private const string test_image = "Resources/Textures/test-image.png";
-
                     private readonly DllResourceStore store;
 
-                    public AlwaysReturnsTextureStore()
+                    public ResourcesTextureStore()
                     {
                         store = TestResources.GetStore();
                     }
 
                     public void Dispose() => store.Dispose();
 
-                    public byte[] Get(string name) => store.Get(test_image);
+                    public byte[] Get(string name) => store.Get(map(name));
 
-                    public Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = new CancellationToken()) => store.GetAsync(test_image, cancellationToken);
+                    public Task<byte[]> GetAsync(string name, CancellationToken cancellationToken = new CancellationToken()) => store.GetAsync(map(name), cancellationToken);
 
-                    public Stream GetStream(string name) => store.GetStream(test_image);
+                    public Stream GetStream(string name) => store.GetStream(map(name));
+
+                    private string map(string name)
+                    {
+                        switch (name)
+                        {
+                            case lookup_name:
+                                return "Resources/Textures/test-image.png";
+
+                            default:
+                                return $"Resources/{name}";
+                        }
+                    }
 
                     public IEnumerable<string> GetAvailableResources() => store.GetAvailableResources();
                 }

From 7eeac0f3b90d34d71a8e2d7390b4a0310b89288b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 17:34:52 +0800
Subject: [PATCH 634/930] Fix incorrect xmldoc
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index ca2c7b774c..848699a4d2 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Storyboards.Drawables
         {
             Video = video;
 
-            // In osu-stable, a mapper can add a scale command for a storyboard.
+            // In osu-stable, a mapper can add a scale command for a storyboard video.
             // This allows scaling based on the video's absolute size.
             //
             // If not specified we take up the full available space.

From 17ca29c2c6e0e5f141f5393923a511cfa2d61437 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 17:37:37 +0800
Subject: [PATCH 635/930] Actually apply transforms to the video

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index 848699a4d2..f2454be190 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -50,6 +50,8 @@ namespace osu.Game.Storyboards.Drawables
                 Origin = Anchor.Centre,
                 Alpha = 0,
             };
+
+            Video.ApplyTransforms(drawableVideo);
         }
 
         protected override void LoadComplete()

From a978518a74c362016d2aeb39d4a8f1fdcb78a28d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Apr 2024 12:32:52 +0200
Subject: [PATCH 636/930] Add failing tests

---
 .../Settings/TestSceneKeyBindingPanel.cs      | 44 ++++++++++++++++++-
 1 file changed, 42 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs b/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs
index 57c9770c9a..86008a56a4 100644
--- a/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs
+++ b/osu.Game.Tests/Visual/Settings/TestSceneKeyBindingPanel.cs
@@ -296,7 +296,7 @@ namespace osu.Game.Tests.Visual.Settings
         }
 
         [Test]
-        public void TestBindingConflictResolvedByRollback()
+        public void TestBindingConflictResolvedByRollbackViaMouse()
         {
             AddStep("reset taiko section to default", () =>
             {
@@ -315,7 +315,7 @@ namespace osu.Game.Tests.Visual.Settings
         }
 
         [Test]
-        public void TestBindingConflictResolvedByOverwrite()
+        public void TestBindingConflictResolvedByOverwriteViaMouse()
         {
             AddStep("reset taiko section to default", () =>
             {
@@ -333,6 +333,46 @@ namespace osu.Game.Tests.Visual.Settings
             checkBinding("Left (rim)", "M1");
         }
 
+        [Test]
+        public void TestBindingConflictResolvedByRollbackViaKeyboard()
+        {
+            AddStep("reset taiko & global sections to default", () =>
+            {
+                panel.ChildrenOfType<VariantBindingsSubsection>().First(section => new TaikoRuleset().RulesetInfo.Equals(section.Ruleset))
+                     .ChildrenOfType<ResetButton>().Single().TriggerClick();
+
+                panel.ChildrenOfType<ResetButton>().First().TriggerClick();
+            });
+            AddStep("move mouse to centre", () => InputManager.MoveMouseTo(panel.ScreenSpaceDrawQuad.Centre));
+            scrollToAndStartBinding("Left (rim)");
+            AddStep("attempt to bind M1 to two keys", () => InputManager.Click(MouseButton.Left));
+
+            AddUntilStep("wait for popover", () => panel.ChildrenOfType<KeyBindingConflictPopover>().SingleOrDefault(), () => Is.Not.Null);
+            AddStep("press Esc", () => InputManager.Key(Key.Escape));
+            checkBinding("Left (centre)", "M1");
+            checkBinding("Left (rim)", "M2");
+        }
+
+        [Test]
+        public void TestBindingConflictResolvedByOverwriteViaKeyboard()
+        {
+            AddStep("reset taiko & global sections to default", () =>
+            {
+                panel.ChildrenOfType<VariantBindingsSubsection>().First(section => new TaikoRuleset().RulesetInfo.Equals(section.Ruleset))
+                     .ChildrenOfType<ResetButton>().Single().TriggerClick();
+
+                panel.ChildrenOfType<ResetButton>().First().TriggerClick();
+            });
+            AddStep("move mouse to centre", () => InputManager.MoveMouseTo(panel.ScreenSpaceDrawQuad.Centre));
+            scrollToAndStartBinding("Left (rim)");
+            AddStep("attempt to bind M1 to two keys", () => InputManager.Click(MouseButton.Left));
+
+            AddUntilStep("wait for popover", () => panel.ChildrenOfType<KeyBindingConflictPopover>().SingleOrDefault(), () => Is.Not.Null);
+            AddStep("press Enter", () => InputManager.Key(Key.Enter));
+            checkBinding("Left (centre)", InputSettingsStrings.ActionHasNoKeyBinding.ToString());
+            checkBinding("Left (rim)", "M1");
+        }
+
         [Test]
         public void TestBindingConflictCausedByResetToDefaultOfSingleRow()
         {

From 1e0db1ab9f676ffb781afe7d151c2d6d95126329 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Apr 2024 12:44:16 +0200
Subject: [PATCH 637/930] Allow confirming keybinding overwrite on conflict via
 "select" binding

---
 .../Sections/Input/KeyBindingConflictPopover.cs       | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingConflictPopover.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingConflictPopover.cs
index 60d1bd31be..05aeb0b810 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingConflictPopover.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingConflictPopover.cs
@@ -152,6 +152,17 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             newPreview.IsChosen.Value = applyNewButton.IsHovered;
         }
 
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            if (e.Action == GlobalAction.Select && !e.Repeat)
+            {
+                applyNew();
+                return true;
+            }
+
+            return base.OnPressed(e);
+        }
+
         private partial class ConflictingKeyBindingPreview : CompositeDrawable
         {
             private readonly object action;

From 564dec7a142b8fe3bf6729b9223bc490df18b5c7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 19:21:55 +0800
Subject: [PATCH 638/930] Add test coverage of transforms actually being
 applied to video

---
 .../Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs     | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index 6ac112cc5f..fc52d749b3 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -86,7 +86,10 @@ namespace osu.Game.Tests.Visual.Gameplay
                 sprite.AddLoop(Time.Current, 100).Alpha.Add(Easing.None, 0, 10000, 1, 1);
 
                 if (scaleTransformProvided)
-                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current, Time.Current, 1, 1);
+                {
+                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current, Time.Current + 1000, 1, 2);
+                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current + 1000, Time.Current + 2000, 2, 1);
+                }
 
                 layer.Elements.Clear();
                 layer.Add(sprite);

From f7626aba1821f5f346dfa36a06438836bbc819ea Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Apr 2024 13:36:12 +0200
Subject: [PATCH 639/930] Fix mod select overlay columns not displaying
 properly sometimes

Closes https://github.com/ppy/osu/issues/26504.

As far as I can tell the issue is basically another manifestation of
https://github.com/ppy/osu-framework/issues/5129, i.e. presence
overrides causing dropped invalidations and thus completely bogus
hierarchy state. The fix is to raise the appropriate invalidation
manually.
---
 osu.Game/Overlays/Mods/ModColumn.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModColumn.cs b/osu.Game/Overlays/Mods/ModColumn.cs
index df33c78ea4..e9f21338bd 100644
--- a/osu.Game/Overlays/Mods/ModColumn.cs
+++ b/osu.Game/Overlays/Mods/ModColumn.cs
@@ -69,6 +69,7 @@ namespace osu.Game.Overlays.Mods
         private Task? latestLoadTask;
         private ModPanel[]? latestLoadedPanels;
         internal bool ItemsLoaded => latestLoadTask?.IsCompleted == true && allPanelsLoaded;
+        private bool? wasPresent;
 
         private bool allPanelsLoaded
         {
@@ -192,6 +193,15 @@ namespace osu.Game.Overlays.Mods
         {
             base.Update();
 
+            // we override `IsPresent` to include the scheduler's pending task state to make async loads work correctly when columns are masked away
+            // (see description of https://github.com/ppy/osu/pull/19783).
+            // however, because of that we must also ensure that we signal correct invalidations (https://github.com/ppy/osu-framework/issues/5129).
+            // failing to do so causes columns to be stuck in "present" mode despite actually not being present themselves.
+            // this works because `Update()` will always run after a scheduler update, which is what causes the presence state change responsible for the failure.
+            if (wasPresent != null && wasPresent != IsPresent)
+                Invalidate(Invalidation.Presence);
+            wasPresent = IsPresent;
+
             if (selectionDelay == initial_multiple_selection_delay || Time.Current - lastSelection >= selectionDelay)
             {
                 if (pendingSelectionOperations.TryDequeue(out var dequeuedAction))

From 804b1b0d884da13b1a79a31ffd09e23a16bffbe8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 20:54:44 +0800
Subject: [PATCH 640/930] Fix settings colour scheme wrong when viewing
 gameplay from skin editor button

Closes https://github.com/ppy/osu/issues/27949.
---
 osu.Game/Screens/Play/Player.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Screens/Play/Player.cs b/osu.Game/Screens/Play/Player.cs
index 3a80caf259..42ff1d74f3 100644
--- a/osu.Game/Screens/Play/Player.cs
+++ b/osu.Game/Screens/Play/Player.cs
@@ -101,6 +101,11 @@ namespace osu.Game.Screens.Play
         /// </summary>
         public IBindable<bool> ShowingOverlayComponents = new Bindable<bool>();
 
+        // Should match PlayerLoader for consistency. Cached here for the rare case we push a Player
+        // without the loading screen (one such usage is the skin editor's scene library).
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
         [Resolved]
         private ScoreManager scoreManager { get; set; }
 

From 436203a8c12093c076a9d4e5d01264ad9ce26f55 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 21:32:32 +0800
Subject: [PATCH 641/930] Add a chevron to distinguish editor menus with
 submenus

---
 .../Edit/Components/Menus/EditorMenuBar.cs    | 24 +++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index 0e125d0ec0..152bcee214 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -184,6 +185,17 @@ namespace osu.Game.Screens.Edit.Components.Menus
                 {
                 }
 
+                private bool hasSubmenu => Item.Items.Any();
+
+                protected override TextContainer CreateTextContainer() => base.CreateTextContainer().With(c =>
+                {
+                    c.Padding = new MarginPadding
+                    {
+                        // Add some padding for the chevron below.
+                        Right = hasSubmenu ? 5 : 0,
+                    };
+                });
+
                 [BackgroundDependencyLoader]
                 private void load(OverlayColourProvider colourProvider)
                 {
@@ -191,6 +203,18 @@ namespace osu.Game.Screens.Edit.Components.Menus
                     BackgroundColourHover = colourProvider.Background1;
 
                     Foreground.Padding = new MarginPadding { Vertical = 2 };
+
+                    if (hasSubmenu)
+                    {
+                        AddInternal(new SpriteIcon
+                        {
+                            Margin = new MarginPadding(6),
+                            Size = new Vector2(8),
+                            Icon = FontAwesome.Solid.ChevronRight,
+                            Anchor = Anchor.CentreRight,
+                            Origin = Anchor.CentreRight,
+                        });
+                    }
                 }
             }
         }

From 602b16f533dd5e578025144d025dc3a9c7336fa7 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 22:03:32 +0800
Subject: [PATCH 642/930] Fix fade-in no longer working on videos

---
 .../Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs      | 2 --
 osu.Game/Storyboards/StoryboardVideo.cs                       | 4 +++-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index fc52d749b3..8fa2c9922e 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -83,8 +83,6 @@ namespace osu.Game.Tests.Visual.Gameplay
 
                 var sprite = new StoryboardVideo("Videos/test-video.mp4", Time.Current);
 
-                sprite.AddLoop(Time.Current, 100).Alpha.Add(Easing.None, 0, 10000, 1, 1);
-
                 if (scaleTransformProvided)
                 {
                     sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current, Time.Current + 1000, 1, 2);
diff --git a/osu.Game/Storyboards/StoryboardVideo.cs b/osu.Game/Storyboards/StoryboardVideo.cs
index bd1b933b6f..5573162d26 100644
--- a/osu.Game/Storyboards/StoryboardVideo.cs
+++ b/osu.Game/Storyboards/StoryboardVideo.cs
@@ -12,7 +12,9 @@ namespace osu.Game.Storyboards
         public StoryboardVideo(string path, double offset)
             : base(path, Anchor.Centre, Vector2.Zero)
         {
-            TimelineGroup.Alpha.Add(Easing.None, offset, offset, 0, 1);
+            // This is just required to get a valid StartTime based on the incoming offset.
+            // Actual fades are handled inside DrawableStoryboardVideo for now.
+            TimelineGroup.Alpha.Add(Easing.None, offset, offset, 0, 0);
         }
 
         public override Drawable CreateDrawable() => new DrawableStoryboardVideo(this);

From d0edf72a0c384004f7e6fbb252d368af3fa14cdf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 23 Apr 2024 22:04:28 +0800
Subject: [PATCH 643/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index c61977cfa3..97dfe5d9f7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.419.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.423.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index a336dff977..40958f3785 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.419.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.423.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 6389172fe7..66347acdf0 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.419.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.423.0" />
   </ItemGroup>
 </Project>

From 787e60f70649d5346c1916332ff74cab0518f959 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Apr 2024 18:37:15 +0200
Subject: [PATCH 644/930] Fix `LegacyDrainingHealthProcessor` drain rate
 computation diverging to infinity

---
 osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
index 7cee5ebecf..25c5b3643a 100644
--- a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
@@ -129,6 +129,13 @@ namespace osu.Game.Rulesets.Scoring
                     OnIterationFail?.Invoke($"FAILED drop {testDrop}: recovery too low ({recovery} < {hpRecoveryAvailable})");
                 }
 
+                if (!fail && double.IsInfinity(HpMultiplierNormal))
+                {
+                    OnIterationSuccess?.Invoke("Drain computation algorithm diverged to infinity. PASSING with zero drop, resetting HP multiplier to 1.");
+                    HpMultiplierNormal = 1;
+                    return 0;
+                }
+
                 if (!fail)
                 {
                     OnIterationSuccess?.Invoke($"PASSED drop {testDrop}");

From cbbf2dd1584da084293db3afe4bd4e6108e5f7e2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 23 Apr 2024 18:58:40 +0200
Subject: [PATCH 645/930] Fix `DifficultyBindable` bound desync between
 `maxValue` and `CurrentNumber.MaxValue`

---
 osu.Game/Rulesets/Mods/DifficultyBindable.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Mods/DifficultyBindable.cs b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
index a207048882..5f6fd21860 100644
--- a/osu.Game/Rulesets/Mods/DifficultyBindable.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mods
             }
         }
 
-        private float maxValue;
+        private float maxValue = 10; // matches default max value of `CurrentNumber`
 
         public float MaxValue
         {

From 16fdd4e08d81cfc00ddc1a6d370fdece195c3461 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 24 Apr 2024 09:01:31 +0800
Subject: [PATCH 646/930] Add ability to show beatmap source using skin
 editor's beatmap attribute text

As per https://github.com/ppy/osu/discussions/27955.
---
 osu.Game/Localisation/EditorSetupStrings.cs   | 32 +++++++++++++------
 .../Components/BeatmapAttributeText.cs        |  3 ++
 2 files changed, 26 insertions(+), 9 deletions(-)

diff --git a/osu.Game/Localisation/EditorSetupStrings.cs b/osu.Game/Localisation/EditorSetupStrings.cs
index eff6f9e6b8..350517734f 100644
--- a/osu.Game/Localisation/EditorSetupStrings.cs
+++ b/osu.Game/Localisation/EditorSetupStrings.cs
@@ -42,7 +42,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "If enabled, an &quot;Are you ready? 3, 2, 1, GO!&quot; countdown will be inserted at the beginning of the beatmap, assuming there is enough time to do so."
         /// </summary>
-        public static LocalisableString CountdownDescription => new TranslatableString(getKey(@"countdown_description"), @"If enabled, an ""Are you ready? 3, 2, 1, GO!"" countdown will be inserted at the beginning of the beatmap, assuming there is enough time to do so.");
+        public static LocalisableString CountdownDescription => new TranslatableString(getKey(@"countdown_description"),
+            @"If enabled, an ""Are you ready? 3, 2, 1, GO!"" countdown will be inserted at the beginning of the beatmap, assuming there is enough time to do so.");
 
         /// <summary>
         /// "Countdown speed"
@@ -52,7 +53,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "If the countdown sounds off-time, use this to make it appear one or more beats early."
         /// </summary>
-        public static LocalisableString CountdownOffsetDescription => new TranslatableString(getKey(@"countdown_offset_description"), @"If the countdown sounds off-time, use this to make it appear one or more beats early.");
+        public static LocalisableString CountdownOffsetDescription =>
+            new TranslatableString(getKey(@"countdown_offset_description"), @"If the countdown sounds off-time, use this to make it appear one or more beats early.");
 
         /// <summary>
         /// "Countdown offset"
@@ -67,7 +69,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Allows storyboards to use the full screen space, rather than be confined to a 4:3 area."
         /// </summary>
-        public static LocalisableString WidescreenSupportDescription => new TranslatableString(getKey(@"widescreen_support_description"), @"Allows storyboards to use the full screen space, rather than be confined to a 4:3 area.");
+        public static LocalisableString WidescreenSupportDescription =>
+            new TranslatableString(getKey(@"widescreen_support_description"), @"Allows storyboards to use the full screen space, rather than be confined to a 4:3 area.");
 
         /// <summary>
         /// "Epilepsy warning"
@@ -77,7 +80,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Recommended if the storyboard or video contain scenes with rapidly flashing colours."
         /// </summary>
-        public static LocalisableString EpilepsyWarningDescription => new TranslatableString(getKey(@"epilepsy_warning_description"), @"Recommended if the storyboard or video contain scenes with rapidly flashing colours.");
+        public static LocalisableString EpilepsyWarningDescription =>
+            new TranslatableString(getKey(@"epilepsy_warning_description"), @"Recommended if the storyboard or video contain scenes with rapidly flashing colours.");
 
         /// <summary>
         /// "Letterbox during breaks"
@@ -87,7 +91,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Adds horizontal letterboxing to give a cinematic look during breaks."
         /// </summary>
-        public static LocalisableString LetterboxDuringBreaksDescription => new TranslatableString(getKey(@"letterbox_during_breaks_description"), @"Adds horizontal letterboxing to give a cinematic look during breaks.");
+        public static LocalisableString LetterboxDuringBreaksDescription =>
+            new TranslatableString(getKey(@"letterbox_during_breaks_description"), @"Adds horizontal letterboxing to give a cinematic look during breaks.");
 
         /// <summary>
         /// "Samples match playback rate"
@@ -97,7 +102,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "When enabled, all samples will speed up or slow down when rate-changing mods are enabled."
         /// </summary>
-        public static LocalisableString SamplesMatchPlaybackRateDescription => new TranslatableString(getKey(@"samples_match_playback_rate_description"), @"When enabled, all samples will speed up or slow down when rate-changing mods are enabled.");
+        public static LocalisableString SamplesMatchPlaybackRateDescription => new TranslatableString(getKey(@"samples_match_playback_rate_description"),
+            @"When enabled, all samples will speed up or slow down when rate-changing mods are enabled.");
 
         /// <summary>
         /// "The size of all hit objects"
@@ -117,7 +123,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "The harshness of hit windows and difficulty of special objects (ie. spinners)"
         /// </summary>
-        public static LocalisableString OverallDifficultyDescription => new TranslatableString(getKey(@"overall_difficulty_description"), @"The harshness of hit windows and difficulty of special objects (ie. spinners)");
+        public static LocalisableString OverallDifficultyDescription =>
+            new TranslatableString(getKey(@"overall_difficulty_description"), @"The harshness of hit windows and difficulty of special objects (ie. spinners)");
 
         /// <summary>
         /// "Tick Rate"
@@ -127,7 +134,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Determines how many &quot;ticks&quot; are generated within long hit objects. A tick rate of 1 will generate ticks on each beat, 2 would be twice per beat, etc."
         /// </summary>
-        public static LocalisableString TickRateDescription => new TranslatableString(getKey(@"tick_rate_description"), @"Determines how many ""ticks"" are generated within long hit objects. A tick rate of 1 will generate ticks on each beat, 2 would be twice per beat, etc.");
+        public static LocalisableString TickRateDescription => new TranslatableString(getKey(@"tick_rate_description"),
+            @"Determines how many ""ticks"" are generated within long hit objects. A tick rate of 1 will generate ticks on each beat, 2 would be twice per beat, etc.");
 
         /// <summary>
         /// "Base Velocity"
@@ -137,7 +145,8 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "The base velocity of the beatmap, affecting things like slider velocity and scroll speed in some rulesets."
         /// </summary>
-        public static LocalisableString BaseVelocityDescription => new TranslatableString(getKey(@"base_velocity_description"), @"The base velocity of the beatmap, affecting things like slider velocity and scroll speed in some rulesets.");
+        public static LocalisableString BaseVelocityDescription => new TranslatableString(getKey(@"base_velocity_description"),
+            @"The base velocity of the beatmap, affecting things like slider velocity and scroll speed in some rulesets.");
 
         /// <summary>
         /// "Metadata"
@@ -159,6 +168,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Creator => new TranslatableString(getKey(@"creator"), @"Creator");
 
+        /// <summary>
+        /// "Source"
+        /// </summary>
+        public static LocalisableString Source => new TranslatableString(getKey(@"source"), @"Source");
+
         /// <summary>
         /// "Difficulty Name"
         /// </summary>
diff --git a/osu.Game/Skinning/Components/BeatmapAttributeText.cs b/osu.Game/Skinning/Components/BeatmapAttributeText.cs
index 52c439a624..5c5e509fb2 100644
--- a/osu.Game/Skinning/Components/BeatmapAttributeText.cs
+++ b/osu.Game/Skinning/Components/BeatmapAttributeText.cs
@@ -48,6 +48,7 @@ namespace osu.Game.Skinning.Components
             [BeatmapAttribute.Artist] = EditorSetupStrings.Artist,
             [BeatmapAttribute.DifficultyName] = EditorSetupStrings.DifficultyHeader,
             [BeatmapAttribute.Creator] = EditorSetupStrings.Creator,
+            [BeatmapAttribute.Source] = EditorSetupStrings.Source,
             [BeatmapAttribute.Length] = ArtistStrings.TracklistLength.ToTitle(),
             [BeatmapAttribute.RankedStatus] = BeatmapDiscussionsStrings.IndexFormBeatmapsetStatusDefault,
             [BeatmapAttribute.BPM] = BeatmapsetsStrings.ShowStatsBpm,
@@ -88,6 +89,7 @@ namespace osu.Game.Skinning.Components
             valueDictionary[BeatmapAttribute.Artist] = new RomanisableString(workingBeatmap.BeatmapInfo.Metadata.ArtistUnicode, workingBeatmap.BeatmapInfo.Metadata.Artist);
             valueDictionary[BeatmapAttribute.DifficultyName] = workingBeatmap.BeatmapInfo.DifficultyName;
             valueDictionary[BeatmapAttribute.Creator] = workingBeatmap.BeatmapInfo.Metadata.Author.Username;
+            valueDictionary[BeatmapAttribute.Source] = workingBeatmap.BeatmapInfo.Metadata.Source;
             valueDictionary[BeatmapAttribute.Length] = TimeSpan.FromMilliseconds(workingBeatmap.BeatmapInfo.Length).ToFormattedDuration();
             valueDictionary[BeatmapAttribute.RankedStatus] = workingBeatmap.BeatmapInfo.Status.GetLocalisableDescription();
             valueDictionary[BeatmapAttribute.BPM] = workingBeatmap.BeatmapInfo.BPM.ToLocalisableString(@"F2");
@@ -132,6 +134,7 @@ namespace osu.Game.Skinning.Components
         StarRating,
         Title,
         Artist,
+        Source,
         DifficultyName,
         Creator,
         Length,

From f97c519451e0b17c95309f2d78bbddd30614e5c9 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 24 Apr 2024 00:19:10 -0700
Subject: [PATCH 647/930] Add chevron to distinguish all menus with submenus

---
 .../UserInterface/DrawableOsuMenuItem.cs      | 23 +++++++++++++++++++
 .../Edit/Components/Menus/EditorMenuBar.cs    | 23 -------------------
 2 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
index 2f2cb7e5f8..06ef75cf58 100644
--- a/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableOsuMenuItem.cs
@@ -3,6 +3,7 @@
 
 #nullable disable
 
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -12,6 +13,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Sprites;
+using osuTK;
 using osuTK.Graphics;
 
 namespace osu.Game.Graphics.UserInterface
@@ -40,6 +42,27 @@ namespace osu.Game.Graphics.UserInterface
             AddInternal(hoverClickSounds = new HoverClickSounds());
 
             updateTextColour();
+
+            bool hasSubmenu = Item.Items.Any();
+
+            // Only add right chevron if direction of menu items is vertical (i.e. width is relative size, see `DrawableMenuItem.SetFlowDirection()`).
+            if (hasSubmenu && RelativeSizeAxes == Axes.X)
+            {
+                AddInternal(new SpriteIcon
+                {
+                    Margin = new MarginPadding(6),
+                    Size = new Vector2(8),
+                    Icon = FontAwesome.Solid.ChevronRight,
+                    Anchor = Anchor.CentreRight,
+                    Origin = Anchor.CentreRight,
+                });
+
+                text.Padding = new MarginPadding
+                {
+                    // Add some padding for the chevron above.
+                    Right = 5,
+                };
+            }
         }
 
         protected override void LoadComplete()
diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index 152bcee214..c410c2519b 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -185,17 +185,6 @@ namespace osu.Game.Screens.Edit.Components.Menus
                 {
                 }
 
-                private bool hasSubmenu => Item.Items.Any();
-
-                protected override TextContainer CreateTextContainer() => base.CreateTextContainer().With(c =>
-                {
-                    c.Padding = new MarginPadding
-                    {
-                        // Add some padding for the chevron below.
-                        Right = hasSubmenu ? 5 : 0,
-                    };
-                });
-
                 [BackgroundDependencyLoader]
                 private void load(OverlayColourProvider colourProvider)
                 {
@@ -203,18 +192,6 @@ namespace osu.Game.Screens.Edit.Components.Menus
                     BackgroundColourHover = colourProvider.Background1;
 
                     Foreground.Padding = new MarginPadding { Vertical = 2 };
-
-                    if (hasSubmenu)
-                    {
-                        AddInternal(new SpriteIcon
-                        {
-                            Margin = new MarginPadding(6),
-                            Size = new Vector2(8),
-                            Icon = FontAwesome.Solid.ChevronRight,
-                            Anchor = Anchor.CentreRight,
-                            Origin = Anchor.CentreRight,
-                        });
-                    }
                 }
             }
         }

From 5f463b81a8ecc883ed8040cacf70139e11b042dd Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 24 Apr 2024 00:22:20 -0700
Subject: [PATCH 648/930] Remove hardcoded chevrons in test

---
 osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs
index 7b80549854..2a2f267fc8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneContextMenu.cs
@@ -77,21 +77,21 @@ namespace osu.Game.Tests.Visual.UserInterface
                 new OsuMenuItem(@"Some option"),
                 new OsuMenuItem(@"Highlighted option", MenuItemType.Highlighted),
                 new OsuMenuItem(@"Another option"),
-                new OsuMenuItem(@"Nested option >")
+                new OsuMenuItem(@"Nested option")
                 {
                     Items = new MenuItem[]
                     {
                         new OsuMenuItem(@"Sub-One"),
                         new OsuMenuItem(@"Sub-Two"),
                         new OsuMenuItem(@"Sub-Three"),
-                        new OsuMenuItem(@"Sub-Nested option >")
+                        new OsuMenuItem(@"Sub-Nested option")
                         {
                             Items = new MenuItem[]
                             {
                                 new OsuMenuItem(@"Double Sub-One"),
                                 new OsuMenuItem(@"Double Sub-Two"),
                                 new OsuMenuItem(@"Double Sub-Three"),
-                                new OsuMenuItem(@"Sub-Sub-Nested option >")
+                                new OsuMenuItem(@"Sub-Sub-Nested option")
                                 {
                                     Items = new MenuItem[]
                                     {

From 4f7c9f297068b5ec27aaa3d34e8176d6e0e7fe1a Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 24 Apr 2024 01:00:03 -0700
Subject: [PATCH 649/930] Remove unused using

---
 osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
index c410c2519b..0e125d0ec0 100644
--- a/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
+++ b/osu.Game/Screens/Edit/Components/Menus/EditorMenuBar.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;

From 72726809cb6cdd53fb3f01d13b2438d323c47e72 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Wed, 24 Apr 2024 09:47:41 -0700
Subject: [PATCH 650/930] Ignore autogenerated .idea android file

---
 .gitignore | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 525b3418cd..11fee27f28 100644
--- a/.gitignore
+++ b/.gitignore
@@ -340,4 +340,5 @@ inspectcode
 # Fody (pulled in by Realm) - schema file
 FodyWeavers.xsd
 
-.idea/.idea.osu.Desktop/.idea/misc.xml
\ No newline at end of file
+.idea/.idea.osu.Desktop/.idea/misc.xml
+.idea/.idea.osu.Android/.idea/deploymentTargetDropDown.xml

From 94275f148e4eb523fbf4247503c7e072f66ef780 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 09:01:47 +0200
Subject: [PATCH 651/930] Fix adding slider control points via context menu not
 undoing correctly

Closes https://github.com/ppy/osu/issues/27985.
---
 .../Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs    | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
index 2da462caf4..49fdf12d60 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/SliderSelectionBlueprint.cs
@@ -403,7 +403,12 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders
 
         public override MenuItem[] ContextMenuItems => new MenuItem[]
         {
-            new OsuMenuItem("Add control point", MenuItemType.Standard, () => addControlPoint(rightClickPosition)),
+            new OsuMenuItem("Add control point", MenuItemType.Standard, () =>
+            {
+                changeHandler?.BeginChange();
+                addControlPoint(rightClickPosition);
+                changeHandler?.EndChange();
+            }),
             new OsuMenuItem("Convert to stream", MenuItemType.Destructive, convertToStream),
         };
 

From da953b34a721540e266b33d495ce11525bf1c8fe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 09:52:26 +0200
Subject: [PATCH 652/930] Apply nullability annotations to `ResultsScreen` &
 inheritors

---
 .../Visual/Ranking/TestSceneResultsScreen.cs  |  2 +-
 .../MultiplayerTeamResultsScreen.cs           |  8 ++--
 .../Spectate/MultiSpectatorResultsScreen.cs   |  6 +--
 .../Playlists/PlaylistsResultsScreen.cs       | 35 +++++++---------
 osu.Game/Screens/Ranking/ResultsScreen.cs     | 42 +++++++++----------
 osu.Game/Screens/Ranking/SoloResultsScreen.cs |  4 +-
 6 files changed, 43 insertions(+), 54 deletions(-)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
index ffc5dbc8fb..fca1d0f82a 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneResultsScreen.cs
@@ -424,7 +424,7 @@ namespace osu.Game.Tests.Visual.Ranking
                     scores.Add(score);
                 }
 
-                scoresCallback?.Invoke(scores);
+                scoresCallback.Invoke(scores);
 
                 return null;
             }
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
index a8c513603c..ab83860ba7 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/MultiplayerTeamResultsScreen.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -28,8 +26,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
     {
         private readonly SortedDictionary<int, BindableLong> teamScores;
 
-        private Container winnerBackground;
-        private Drawable winnerText;
+        private Container winnerBackground = null!;
+        private Drawable winnerText = null!;
 
         public MultiplayerTeamResultsScreen(ScoreInfo score, long roomId, PlaylistItem playlistItem, SortedDictionary<int, BindableLong> teamScores)
             : base(score, roomId, playlistItem)
@@ -41,7 +39,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer
         }
 
         [Resolved]
-        private OsuColour colours { get; set; }
+        private OsuColour colours { get; set; } = null!;
 
         [BackgroundDependencyLoader]
         private void load()
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorResultsScreen.cs
index 2afc187e40..c240bbea0c 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorResultsScreen.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using osu.Game.Online.API;
@@ -25,8 +23,8 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             Scheduler.AddDelayed(() => StatisticsPanel.ToggleVisibility(), 1000);
         }
 
-        protected override APIRequest FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
+        protected override APIRequest? FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
 
-        protected override APIRequest FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
+        protected override APIRequest? FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
index add7aee8cd..fdb83b5ae8 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/PlaylistsResultsScreen.cs
@@ -1,13 +1,10 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -25,23 +22,23 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         private readonly long roomId;
         private readonly PlaylistItem playlistItem;
 
-        protected LoadingSpinner LeftSpinner { get; private set; }
-        protected LoadingSpinner CentreSpinner { get; private set; }
-        protected LoadingSpinner RightSpinner { get; private set; }
+        protected LoadingSpinner LeftSpinner { get; private set; } = null!;
+        protected LoadingSpinner CentreSpinner { get; private set; } = null!;
+        protected LoadingSpinner RightSpinner { get; private set; } = null!;
 
-        private MultiplayerScores higherScores;
-        private MultiplayerScores lowerScores;
+        private MultiplayerScores? higherScores;
+        private MultiplayerScores? lowerScores;
 
         [Resolved]
-        private IAPIProvider api { get; set; }
+        private IAPIProvider api { get; set; } = null!;
 
         [Resolved]
-        private ScoreManager scoreManager { get; set; }
+        private ScoreManager scoreManager { get; set; } = null!;
 
         [Resolved]
-        private RulesetStore rulesets { get; set; }
+        private RulesetStore rulesets { get; set; } = null!;
 
-        public PlaylistsResultsScreen([CanBeNull] ScoreInfo score, long roomId, PlaylistItem playlistItem)
+        public PlaylistsResultsScreen(ScoreInfo? score, long roomId, PlaylistItem playlistItem)
             : base(score)
         {
             this.roomId = roomId;
@@ -123,11 +120,11 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             return userScoreReq;
         }
 
-        protected override APIRequest FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback)
+        protected override APIRequest? FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback)
         {
             Debug.Assert(direction == 1 || direction == -1);
 
-            MultiplayerScores pivot = direction == -1 ? higherScores : lowerScores;
+            MultiplayerScores? pivot = direction == -1 ? higherScores : lowerScores;
 
             if (pivot?.Cursor == null)
                 return null;
@@ -147,7 +144,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <param name="scoresCallback">The callback to perform with the resulting scores.</param>
         /// <param name="pivot">An optional score pivot to retrieve scores around. Can be null to retrieve scores from the highest score.</param>
         /// <returns>The indexing <see cref="APIRequest"/>.</returns>
-        private APIRequest createIndexRequest(Action<IEnumerable<ScoreInfo>> scoresCallback, [CanBeNull] MultiplayerScores pivot = null)
+        private APIRequest createIndexRequest(Action<IEnumerable<ScoreInfo>> scoresCallback, MultiplayerScores? pivot = null)
         {
             var indexReq = pivot != null
                 ? new IndexPlaylistScoresRequest(roomId, playlistItem.ID, pivot.Cursor, pivot.Params)
@@ -180,7 +177,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <param name="callback">The callback to invoke with the final <see cref="ScoreInfo"/>s.</param>
         /// <param name="scores">The <see cref="MultiplayerScore"/>s that were retrieved from <see cref="APIRequest"/>s.</param>
         /// <param name="pivot">An optional pivot around which the scores were retrieved.</param>
-        private void performSuccessCallback([NotNull] Action<IEnumerable<ScoreInfo>> callback, [NotNull] List<MultiplayerScore> scores, [CanBeNull] MultiplayerScores pivot = null) => Schedule(() =>
+        private void performSuccessCallback(Action<IEnumerable<ScoreInfo>> callback, List<MultiplayerScore> scores, MultiplayerScores? pivot = null) => Schedule(() =>
         {
             var scoreInfos = scores.Select(s => s.CreateScoreInfo(scoreManager, rulesets, playlistItem, Beatmap.Value.BeatmapInfo)).OrderByTotalScore().ToArray();
 
@@ -201,7 +198,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
             hideLoadingSpinners(pivot);
         });
 
-        private void hideLoadingSpinners([CanBeNull] MultiplayerScores pivot = null)
+        private void hideLoadingSpinners(MultiplayerScores? pivot = null)
         {
             CentreSpinner.Hide();
 
@@ -217,7 +214,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <param name="scores">The <see cref="MultiplayerScores"/> to set positions on.</param>
         /// <param name="pivot">The pivot.</param>
         /// <param name="increment">The amount to increment the pivot position by for each <see cref="MultiplayerScore"/> in <paramref name="scores"/>.</param>
-        private void setPositions([NotNull] MultiplayerScores scores, [CanBeNull] MultiplayerScores pivot, int increment)
+        private void setPositions(MultiplayerScores scores, MultiplayerScores? pivot, int increment)
             => setPositions(scores, pivot?.Scores[^1].Position ?? 0, increment);
 
         /// <summary>
@@ -226,7 +223,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         /// <param name="scores">The <see cref="MultiplayerScores"/> to set positions on.</param>
         /// <param name="pivotPosition">The pivot position.</param>
         /// <param name="increment">The amount to increment the pivot position by for each <see cref="MultiplayerScore"/> in <paramref name="scores"/>.</param>
-        private void setPositions([NotNull] MultiplayerScores scores, int pivotPosition, int increment)
+        private void setPositions(MultiplayerScores scores, int pivotPosition, int increment)
         {
             foreach (var s in scores.Scores)
             {
diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index ebb0530046..1c3518909d 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -1,12 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
 using osu.Framework.Audio.Sample;
@@ -45,25 +42,24 @@ namespace osu.Game.Screens.Ranking
 
         protected override OverlayActivation InitialOverlayActivationMode => OverlayActivation.UserTriggered;
 
-        public readonly Bindable<ScoreInfo> SelectedScore = new Bindable<ScoreInfo>();
+        public readonly Bindable<ScoreInfo?> SelectedScore = new Bindable<ScoreInfo?>();
 
-        [CanBeNull]
-        public readonly ScoreInfo Score;
+        public readonly ScoreInfo? Score;
 
-        protected ScorePanelList ScorePanelList { get; private set; }
+        protected ScorePanelList ScorePanelList { get; private set; } = null!;
 
-        protected VerticalScrollContainer VerticalScrollContent { get; private set; }
-
-        [Resolved(CanBeNull = true)]
-        private Player player { get; set; }
+        protected VerticalScrollContainer VerticalScrollContent { get; private set; } = null!;
 
         [Resolved]
-        private IAPIProvider api { get; set; }
+        private Player? player { get; set; }
 
-        protected StatisticsPanel StatisticsPanel { get; private set; }
+        [Resolved]
+        private IAPIProvider api { get; set; } = null!;
 
-        private Drawable bottomPanel;
-        private Container<ScorePanel> detachedPanelContainer;
+        protected StatisticsPanel StatisticsPanel { get; private set; } = null!;
+
+        private Drawable bottomPanel = null!;
+        private Container<ScorePanel> detachedPanelContainer = null!;
 
         private bool lastFetchCompleted;
 
@@ -84,9 +80,9 @@ namespace osu.Game.Screens.Ranking
         /// </summary>
         public bool ShowUserStatistics { get; init; }
 
-        private Sample popInSample;
+        private Sample? popInSample;
 
-        protected ResultsScreen([CanBeNull] ScoreInfo score)
+        protected ResultsScreen(ScoreInfo? score)
         {
             Score = score;
 
@@ -182,11 +178,11 @@ namespace osu.Game.Screens.Ranking
                 Scheduler.AddDelayed(() => OverlayActivationMode.Value = OverlayActivation.All, shouldFlair ? AccuracyCircle.TOTAL_DURATION + 1000 : 0);
             }
 
-            if (AllowWatchingReplay)
+            if (SelectedScore.Value != null && AllowWatchingReplay)
             {
                 buttons.Add(new ReplayDownloadButton(SelectedScore.Value)
                 {
-                    Score = { BindTarget = SelectedScore },
+                    Score = { BindTarget = SelectedScore! },
                     Width = 300
                 });
             }
@@ -225,7 +221,7 @@ namespace osu.Game.Screens.Ranking
 
             if (lastFetchCompleted)
             {
-                APIRequest nextPageRequest = null;
+                APIRequest? nextPageRequest = null;
 
                 if (ScorePanelList.IsScrolledToStart)
                     nextPageRequest = FetchNextPage(-1, fetchScoresCallback);
@@ -245,7 +241,7 @@ namespace osu.Game.Screens.Ranking
         /// </summary>
         /// <param name="scoresCallback">A callback which should be called when fetching is completed. Scheduling is not required.</param>
         /// <returns>An <see cref="APIRequest"/> responsible for the fetch operation. This will be queued and performed automatically.</returns>
-        protected virtual APIRequest FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
+        protected virtual APIRequest? FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
 
         /// <summary>
         /// Performs a fetch of the next page of scores. This is invoked every frame until a non-null <see cref="APIRequest"/> is returned.
@@ -253,7 +249,7 @@ namespace osu.Game.Screens.Ranking
         /// <param name="direction">The fetch direction. -1 to fetch scores greater than the current start of the list, and 1 to fetch scores lower than the current end of the list.</param>
         /// <param name="scoresCallback">A callback which should be called when fetching is completed. Scheduling is not required.</param>
         /// <returns>An <see cref="APIRequest"/> responsible for the fetch operation. This will be queued and performed automatically.</returns>
-        protected virtual APIRequest FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
+        protected virtual APIRequest? FetchNextPage(int direction, Action<IEnumerable<ScoreInfo>> scoresCallback) => null;
 
         /// <summary>
         /// Creates the <see cref="Statistics.StatisticsPanel"/> to be used to display extended information about scores.
@@ -327,7 +323,7 @@ namespace osu.Game.Screens.Ranking
                 panel.Alpha = 0;
         }
 
-        private ScorePanel detachedPanel;
+        private ScorePanel? detachedPanel;
 
         private void onStatisticsStateChanged(ValueChangedEvent<Visibility> state)
         {
diff --git a/osu.Game/Screens/Ranking/SoloResultsScreen.cs b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
index ee0251b5ac..33b4bf976b 100644
--- a/osu.Game/Screens/Ranking/SoloResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/SoloResultsScreen.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Screens.Ranking
         {
         }
 
-        protected override APIRequest? FetchScores(Action<IEnumerable<ScoreInfo>>? scoresCallback)
+        protected override APIRequest? FetchScores(Action<IEnumerable<ScoreInfo>> scoresCallback)
         {
             Debug.Assert(Score != null);
 
@@ -35,7 +35,7 @@ namespace osu.Game.Screens.Ranking
                 return null;
 
             getScoreRequest = new GetScoresRequest(Score.BeatmapInfo, Score.Ruleset);
-            getScoreRequest.Success += r => scoresCallback?.Invoke(r.Scores.Where(s => !s.MatchesOnlineID(Score)).Select(s => s.ToScoreInfo(rulesets, Beatmap.Value.BeatmapInfo)));
+            getScoreRequest.Success += r => scoresCallback.Invoke(r.Scores.Where(s => !s.MatchesOnlineID(Score)).Select(s => s.ToScoreInfo(rulesets, Beatmap.Value.BeatmapInfo)));
             return getScoreRequest;
         }
 

From 9e919b784d99e80371bcdab948eeb80346b4892a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 11:19:29 +0200
Subject: [PATCH 653/930] Add test case covering ignoring non-basic results

---
 .../Ranking/TestSceneHitEventTimingDistributionGraph.cs   | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
index 325a535731..3e38b66029 100644
--- a/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
+++ b/osu.Game.Tests/Visual/Ranking/TestSceneHitEventTimingDistributionGraph.cs
@@ -82,6 +82,14 @@ namespace osu.Game.Tests.Visual.Ranking
             }).ToList());
         }
 
+        [Test]
+        public void TestNonBasicHitResultsAreIgnored()
+        {
+            createTest(CreateDistributedHitEvents(0, 50)
+                       .Select(h => new HitEvent(h.TimeOffset, 1.0, h.TimeOffset > 0 ? HitResult.Ok : HitResult.LargeTickHit, placeholder_object, placeholder_object, null))
+                       .ToList());
+        }
+
         [Test]
         public void TestMultipleWindowsOfHitResult()
         {

From b250a924b19687d626737c78dffbd6e692859d92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 11:20:07 +0200
Subject: [PATCH 654/930] Do not show non-basic results in timing distribution
 graph

Closes https://github.com/ppy/osu/issues/24274.

Bit of an ad-hoc resolution but maybe fine? This basically proposes to
bypass the problem described in the issue by just not showing tick hits
at all on the distribution graph.
---
 .../Ranking/Statistics/HitEventTimingDistributionGraph.cs       | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
index 1260ec2339..47807a8346 100644
--- a/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
+++ b/osu.Game/Screens/Ranking/Statistics/HitEventTimingDistributionGraph.cs
@@ -59,7 +59,7 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// <param name="hitEvents">The <see cref="HitEvent"/>s to display the timing distribution of.</param>
         public HitEventTimingDistributionGraph(IReadOnlyList<HitEvent> hitEvents)
         {
-            this.hitEvents = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit()).ToList();
+            this.hitEvents = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsBasic() && e.Result.IsHit()).ToList();
             bins = Enumerable.Range(0, total_timing_distribution_bins).Select(_ => new Dictionary<HitResult, int>()).ToArray<IDictionary<HitResult, int>>();
         }
 

From d2e9c33b6a34442a0b3e1bead88eac96d20c53e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 12:49:25 +0200
Subject: [PATCH 655/930] Add failing test case

---
 .../Editing/TestSceneDifficultyDelete.cs      | 44 +++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
index 12e00c4485..0f99270a9b 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
@@ -12,6 +12,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Screens.Edit;
 using osu.Game.Storyboards;
 using osu.Game.Tests.Beatmaps.IO;
 using osuTK.Input;
@@ -83,6 +84,49 @@ namespace osu.Game.Tests.Visual.Editing
             }
         }
 
+        [Test]
+        public void TestDeleteDifficultyWithPendingChanges()
+        {
+            Guid deletedDifficultyID = Guid.Empty;
+            int countBeforeDeletion = 0;
+            string beatmapSetHashBefore = string.Empty;
+
+            AddUntilStep("wait for editor to load", () => Editor?.ReadyForUse == true);
+
+            AddStep("store selected difficulty", () =>
+            {
+                deletedDifficultyID = EditorBeatmap.BeatmapInfo.ID;
+                countBeforeDeletion = Beatmap.Value.BeatmapSetInfo.Beatmaps.Count;
+                beatmapSetHashBefore = Beatmap.Value.BeatmapSetInfo.Hash;
+            });
+
+            AddStep("make change to difficulty", () =>
+            {
+                EditorBeatmap.BeginChange();
+                EditorBeatmap.BeatmapInfo.DifficultyName = "changin' things";
+                EditorBeatmap.EndChange();
+            });
+
+            AddStep("click File", () => this.ChildrenOfType<DrawableOsuMenuItem>().First().TriggerClick());
+
+            AddStep("click delete", () => getDeleteMenuItem().TriggerClick());
+            AddUntilStep("wait for dialog", () => DialogOverlay.CurrentDialog != null);
+            AddAssert("dialog is deletion confirmation dialog", () => DialogOverlay.CurrentDialog, Is.InstanceOf<DeleteDifficultyConfirmationDialog>);
+            AddStep("confirm", () => InputManager.Key(Key.Number1));
+
+            AddUntilStep("no next dialog", () => DialogOverlay.CurrentDialog == null);
+            AddUntilStep("switched to different difficulty",
+                () => this.ChildrenOfType<EditorBeatmap>().SingleOrDefault() != null && EditorBeatmap.BeatmapInfo.ID != deletedDifficultyID);
+
+            AddAssert($"difficulty is unattached from set",
+                () => Beatmap.Value.BeatmapSetInfo.Beatmaps.Select(b => b.ID), () => Does.Not.Contain(deletedDifficultyID));
+            AddAssert("beatmap set difficulty count decreased by one",
+                () => Beatmap.Value.BeatmapSetInfo.Beatmaps.Count, () => Is.EqualTo(countBeforeDeletion - 1));
+            AddAssert("set hash changed", () => Beatmap.Value.BeatmapSetInfo.Hash, () => Is.Not.EqualTo(beatmapSetHashBefore));
+            AddAssert($"difficulty is deleted from realm",
+                () => Realm.Run(r => r.Find<BeatmapInfo>(deletedDifficultyID)), () => Is.Null);
+        }
+
         private DrawableOsuMenuItem getDeleteMenuItem() => this.ChildrenOfType<DrawableOsuMenuItem>()
                                                                .Single(item => item.ChildrenOfType<SpriteText>().Any(text => text.Text.ToString().StartsWith("Delete", StringComparison.Ordinal)));
     }

From 19d006d8182812710bffd94d26a4fb2512c101cd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 12:51:30 +0200
Subject: [PATCH 656/930] Fix deleting modified difficulty via editor leaving
 user in broken state

Closes https://github.com/ppy/osu/issues/22783.

If the difficulty being edited has unsaved changes, the editor exit flow
would prompt for save *after* the deletion method has run. This is
undesirable from a UX standpoint, and also leaves the user in a broken
state.

Thus, just fake an update of the last saved hash of the beatmap to fool
the editor into thinking that it's not dirty, so that the exit flow will
not show a save dialog.
---
 osu.Game/Screens/Edit/Editor.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 37f4b4f5be..980c613311 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -1088,6 +1088,13 @@ namespace osu.Game.Screens.Edit
 
                 var difficultiesBeforeDeletion = groupedOrderedBeatmaps.SelectMany(g => g).ToList();
 
+                // if the difficulty being currently deleted has unsaved changes,
+                // the editor exit flow would prompt for save *after* this method has done its thing.
+                // this is generally undesirable and also ends up leaving the user in a broken state.
+                // therefore, just update the last saved hash to make the exit flow think the deleted beatmap is not dirty,
+                // so that it will not show the save dialog on exit.
+                updateLastSavedHash();
+
                 beatmapManager.DeleteDifficultyImmediately(difficultyToDelete);
 
                 int deletedIndex = difficultiesBeforeDeletion.IndexOf(difficultyToDelete);

From c1107d2797ae807d33cdefff3edd54459781919d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 25 Apr 2024 14:31:13 +0200
Subject: [PATCH 657/930] Fully refetch working beatmap when entering editor

Closes https://github.com/ppy/osu/issues/21794.

I'm not actually super sure as to what the exact mode of failure is
here, but it's 99% to do with working beatmap cache invalidation. Likely
this can be even considered as another case of
https://github.com/ppy/osu/issues/21357, but because this is a one-liner
"fix," I'm PRing it anyways.

The issue is confusing to understand when working with the swap scenario
given in the issue, but it's a little easier to understand when
performing the following:

1. Have a beatmap set with 2 difficulties. Let's call them "A" and "B".
2. From song select, without ever exiting to main menu, edit "A". Change
   the difficulty name to "AA". Save and exit back to song select; do
   not exit out to main menu.
3. From song select, edit "B". Change the difficulty name to "BB". Save
   and exit back to song select.
4. The difficulty names will be "A" and "BB".

Basically what I *think* is causing this, is the fact that even though
editor invalidates the working beatmap by refetching it afresh on exit,
song select is blissfully unaware of this, and continues working with
its own `BeatmapInfo` instances which have backlinks to
`BeatmapSetInfo`.

When editing the first of the two difficulties and then the second,
the editing of the first one only invalidates the first one rather than
the entire set, and the second difficulty continues to have a stale
reference to the first one via the beatmap set, and as such ends up
overwriting the changes from the first save when passed into the editor
and modified again.
---
 osu.Game/Screens/Select/SongSelect.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 15469fad5b..16879d0cf0 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -425,7 +425,7 @@ namespace osu.Game.Screens.Select
             if (!AllowEditing)
                 throw new InvalidOperationException($"Attempted to edit when {nameof(AllowEditing)} is disabled");
 
-            Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo ?? beatmapInfoNoDebounce);
+            Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo ?? beatmapInfoNoDebounce, true);
             this.Push(new EditorLoader());
         }
 

From 1756da0dda45363e89c9e3aaf3a70fb32356977d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Apr 2024 21:14:09 +0800
Subject: [PATCH 658/930] Fix redundant string interpolations

---
 osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs b/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
index 0f99270a9b..d4bd77642c 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneDifficultyDelete.cs
@@ -118,12 +118,12 @@ namespace osu.Game.Tests.Visual.Editing
             AddUntilStep("switched to different difficulty",
                 () => this.ChildrenOfType<EditorBeatmap>().SingleOrDefault() != null && EditorBeatmap.BeatmapInfo.ID != deletedDifficultyID);
 
-            AddAssert($"difficulty is unattached from set",
+            AddAssert("difficulty is unattached from set",
                 () => Beatmap.Value.BeatmapSetInfo.Beatmaps.Select(b => b.ID), () => Does.Not.Contain(deletedDifficultyID));
             AddAssert("beatmap set difficulty count decreased by one",
                 () => Beatmap.Value.BeatmapSetInfo.Beatmaps.Count, () => Is.EqualTo(countBeforeDeletion - 1));
             AddAssert("set hash changed", () => Beatmap.Value.BeatmapSetInfo.Hash, () => Is.Not.EqualTo(beatmapSetHashBefore));
-            AddAssert($"difficulty is deleted from realm",
+            AddAssert("difficulty is deleted from realm",
                 () => Realm.Run(r => r.Find<BeatmapInfo>(deletedDifficultyID)), () => Is.Null);
         }
 

From 387fcb87819f15dbaa4c8d10423ea0d6bd01b6db Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 25 Apr 2024 21:31:36 +0800
Subject: [PATCH 659/930] Add a brief inline comment to make sure we don't undo
 the fix

---
 osu.Game/Screens/Select/SongSelect.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 16879d0cf0..6225534e95 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -425,6 +425,7 @@ namespace osu.Game.Screens.Select
             if (!AllowEditing)
                 throw new InvalidOperationException($"Attempted to edit when {nameof(AllowEditing)} is disabled");
 
+            // Forced refetch is important here to guarantee correct invalidation across all difficulties.
             Beatmap.Value = beatmaps.GetWorkingBeatmap(beatmapInfo ?? beatmapInfoNoDebounce, true);
             this.Push(new EditorLoader());
         }

From e0e790fa9412368ff7b414791348476f05e28f2f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Apr 2024 14:44:44 +0800
Subject: [PATCH 660/930] Fix a couple of xmldoc typos

---
 osu.Game/OsuGameBase.cs                                         | 2 +-
 .../OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index fb7a238c46..0122afb239 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -94,7 +94,7 @@ namespace osu.Game
         public const int SAMPLE_DEBOUNCE_TIME = 20;
 
         /// <summary>
-        /// The maximum volume at which audio tracks should playback. This can be set lower than 1 to create some head-room for sound effects.
+        /// The maximum volume at which audio tracks should play back at. This can be set lower than 1 to create some head-room for sound effects.
         /// </summary>
         private const double global_track_volume_adjust = 0.8;
 
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
index fd61b60fe4..5ff52be8bc 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
@@ -130,7 +130,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         }
 
         /// <summary>
-        /// Updates the catchup states of all player clocks clocks.
+        /// Updates the catchup states of all player clocks.
         /// </summary>
         private void updatePlayerCatchup()
         {

From 21d65568651a2760891dd3b2c5c6d55c1c99a688 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Apr 2024 15:29:59 +0800
Subject: [PATCH 661/930] Remove managed clocks from `SpectatorSyncManager` on
 gameplay completion / abort

---
 .../Multiplayer/Spectate/MultiSpectatorScreen.cs    | 13 +++++++++++--
 .../Multiplayer/Spectate/SpectatorSyncManager.cs    |  1 +
 osu.Game/Screens/Spectate/SpectatorScreen.cs        |  7 +++++++
 3 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
index e2159f0e3b..cb00763e6b 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/MultiSpectatorScreen.cs
@@ -244,10 +244,19 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
             playerArea.LoadScore(spectatorGameplayState.Score);
         });
 
-        protected override void FailGameplay(int userId)
+        protected override void FailGameplay(int userId) => Schedule(() =>
         {
             // We probably want to visualise this in the future.
-        }
+
+            var instance = instances.Single(i => i.UserId == userId);
+            syncManager.RemoveManagedClock(instance.SpectatorPlayerClock);
+        });
+
+        protected override void PassGameplay(int userId) => Schedule(() =>
+        {
+            var instance = instances.Single(i => i.UserId == userId);
+            syncManager.RemoveManagedClock(instance.SpectatorPlayerClock);
+        });
 
         protected override void QuitGameplay(int userId) => Schedule(() =>
         {
diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
index 5ff52be8bc..9eb448d9d0 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
@@ -76,6 +76,7 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         public void RemoveManagedClock(SpectatorPlayerClock clock)
         {
             playerClocks.Remove(clock);
+            Logger.Log($"Removing managed clock from {nameof(SpectatorSyncManager)} ({playerClocks.Count} remain)");
             clock.IsRunning = false;
         }
 
diff --git a/osu.Game/Screens/Spectate/SpectatorScreen.cs b/osu.Game/Screens/Spectate/SpectatorScreen.cs
index c4aef3c878..ddc638b7c5 100644
--- a/osu.Game/Screens/Spectate/SpectatorScreen.cs
+++ b/osu.Game/Screens/Spectate/SpectatorScreen.cs
@@ -135,6 +135,7 @@ namespace osu.Game.Screens.Spectate
 
                 case SpectatedUserState.Passed:
                     markReceivedAllFrames(userId);
+                    PassGameplay(userId);
                     break;
 
                 case SpectatedUserState.Failed:
@@ -233,6 +234,12 @@ namespace osu.Game.Screens.Spectate
         /// <param name="spectatorGameplayState">The gameplay state.</param>
         protected abstract void StartGameplay(int userId, SpectatorGameplayState spectatorGameplayState);
 
+        /// <summary>
+        /// Fired when a user passes gameplay.
+        /// </summary>
+        /// <param name="userId">The user which passed.</param>
+        protected virtual void PassGameplay(int userId) { }
+
         /// <summary>
         /// Quits gameplay for a user.
         /// Thread safety is not guaranteed – should be scheduled as required.

From fb2d28f7e03aba53ae905b906fcea30da9a9c4ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 26 Apr 2024 15:30:26 +0800
Subject: [PATCH 662/930] Fix audio being paused in a spectator session when
 all players finish playing

---
 .../OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs   | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
index 9eb448d9d0..1638102089 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Spectate/SpectatorSyncManager.cs
@@ -177,7 +177,9 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Spectate
         /// </summary>
         private void updateMasterState()
         {
-            MasterClockState newState = playerClocks.Any(s => !s.IsCatchingUp) ? MasterClockState.Synchronised : MasterClockState.TooFarAhead;
+            // Clocks are removed as players complete the beatmap.
+            // Once there are no clocks we want to make sure the track plays out to the end.
+            MasterClockState newState = playerClocks.Count == 0 || playerClocks.Any(s => !s.IsCatchingUp) ? MasterClockState.Synchronised : MasterClockState.TooFarAhead;
 
             if (masterState == newState)
                 return;

From 694e3900dbd849bf5638efc8e8dbeec9cf57faf0 Mon Sep 17 00:00:00 2001
From: Taevas <67872932+TTTaevas@users.noreply.github.com>
Date: Sat, 27 Apr 2024 23:43:27 +0200
Subject: [PATCH 663/930] Add missing space in setup wizard

---
 osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
index b19a9c6c99..983cb0bbb4 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenImportFromStable.cs
@@ -128,6 +128,7 @@ namespace osu.Game.Overlays.FirstRunSetup
             if (available)
             {
                 copyInformation.Text = FirstRunOverlayImportFromStableScreenStrings.DataMigrationNoExtraSpace;
+                copyInformation.AddText(@" "); // just to ensure correct spacing
                 copyInformation.AddLink(FirstRunOverlayImportFromStableScreenStrings.LearnAboutHardLinks, LinkAction.OpenWiki, @"Client/Release_stream/Lazer/File_storage#via-hard-links");
             }
             else if (!RuntimeInfo.IsDesktop)

From 48c608e0169a1f9280f75fb3bdc0eadaa3466976 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 18 Mar 2024 12:22:23 -0700
Subject: [PATCH 664/930] Make player width a const

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index ab99370603..1145ebaa2f 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -33,6 +33,7 @@ namespace osu.Game.Overlays
         public LocalisableString Title => NowPlayingStrings.HeaderTitle;
         public LocalisableString Description => NowPlayingStrings.HeaderDescription;
 
+        private const float player_width = 400;
         private const float player_height = 130;
         private const float transition_length = 800;
         private const float progress_height = 10;
@@ -70,7 +71,7 @@ namespace osu.Game.Overlays
 
         public NowPlayingOverlay()
         {
-            Width = 400;
+            Width = player_width;
             Margin = new MarginPadding(margin);
         }
 
@@ -319,15 +320,15 @@ namespace osu.Game.Overlays
                     switch (direction)
                     {
                         case TrackChangeDirection.Next:
-                            newBackground.Position = new Vector2(400, 0);
+                            newBackground.Position = new Vector2(player_width, 0);
                             newBackground.MoveToX(0, 500, Easing.OutCubic);
-                            background.MoveToX(-400, 500, Easing.OutCubic);
+                            background.MoveToX(-player_width, 500, Easing.OutCubic);
                             break;
 
                         case TrackChangeDirection.Prev:
-                            newBackground.Position = new Vector2(-400, 0);
+                            newBackground.Position = new Vector2(-player_width, 0);
                             newBackground.MoveToX(0, 500, Easing.OutCubic);
-                            background.MoveToX(400, 500, Easing.OutCubic);
+                            background.MoveToX(player_width, 500, Easing.OutCubic);
                             break;
                     }
 

From d4951a093fd9746c1ac885a8af13874dfc5390a8 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Mon, 18 Mar 2024 12:24:02 -0700
Subject: [PATCH 665/930] Scroll now playing overlay text when overflowing

---
 .../TestSceneNowPlayingOverlay.cs             |  20 +++-
 osu.Game/Overlays/NowPlayingOverlay.cs        | 100 +++++++++++++++++-
 2 files changed, 115 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
index d07b90025f..40e0d9250d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
@@ -6,6 +6,7 @@
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
+using osu.Game.Beatmaps;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Osu;
 
@@ -22,8 +23,6 @@ namespace osu.Game.Tests.Visual.UserInterface
         [BackgroundDependencyLoader]
         private void load()
         {
-            Beatmap.Value = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo);
-
             nowPlayingOverlay = new NowPlayingOverlay
             {
                 Origin = Anchor.Centre,
@@ -37,9 +36,26 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestShowHideDisable()
         {
+            AddStep(@"set beatmap", () => Beatmap.Value = CreateWorkingBeatmap(new OsuRuleset().RulesetInfo));
             AddStep(@"show", () => nowPlayingOverlay.Show());
             AddToggleStep(@"toggle beatmap lock", state => Beatmap.Disabled = state);
             AddStep(@"hide", () => nowPlayingOverlay.Hide());
         }
+
+        [Test]
+        public void TestLongMetadata()
+        {
+            AddStep(@"set beatmap", () => Beatmap.Value = CreateWorkingBeatmap(new Beatmap
+            {
+                Metadata =
+                {
+                    Artist = "very very very very very very very very very very very long artist",
+                    ArtistUnicode = "very very very very very very very very very very very long artist",
+                    Title = "very very very very very very very very very very very long title",
+                    TitleUnicode = "very very very very very very very very very very very long title",
+                }
+            }));
+            AddStep(@"show", () => nowPlayingOverlay.Show());
+        }
     }
 }
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 1145ebaa2f..be405257ca 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -6,6 +6,7 @@ using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -48,7 +49,7 @@ namespace osu.Game.Overlays
         private IconButton nextButton = null!;
         private IconButton playlistButton = null!;
 
-        private SpriteText title = null!, artist = null!;
+        private ScrollingTextContainer title = null!, artist = null!;
 
         private PlaylistOverlay? playlist;
 
@@ -102,7 +103,7 @@ namespace osu.Game.Overlays
                             Children = new[]
                             {
                                 background = Empty(),
-                                title = new OsuSpriteText
+                                title = new ScrollingTextContainer
                                 {
                                     Origin = Anchor.BottomCentre,
                                     Anchor = Anchor.TopCentre,
@@ -111,7 +112,7 @@ namespace osu.Game.Overlays
                                     Colour = Color4.White,
                                     Text = @"Nothing to play",
                                 },
-                                artist = new OsuSpriteText
+                                artist = new ScrollingTextContainer
                                 {
                                     Origin = Anchor.TopCentre,
                                     Anchor = Anchor.TopCentre,
@@ -470,5 +471,98 @@ namespace osu.Game.Overlays
                 base.OnHoverLost(e);
             }
         }
+
+        private partial class ScrollingTextContainer : CompositeDrawable
+        {
+            private const float initial_move_delay = 1000;
+            private const float pixels_per_second = 50;
+
+            private LocalisableString text;
+            private OsuSpriteText mainSpriteText = null!;
+            private OsuSpriteText fillerSpriteText = null!;
+
+            public LocalisableString Text
+            {
+                get => text;
+                set
+                {
+                    text = value;
+                    Schedule(updateText);
+                }
+            }
+
+            public FontUsage Font
+            {
+                set =>
+                    Schedule(() =>
+                    {
+                        mainSpriteText.Font = value;
+                        fillerSpriteText.Font = value;
+
+                        updateText();
+                    });
+            }
+
+            public ScrollingTextContainer()
+            {
+                AutoSizeAxes = Axes.Both;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                InternalChild = new FillFlowContainer<OsuSpriteText>
+                {
+                    AutoSizeAxes = Axes.Both,
+                    Direction = FillDirection.Horizontal,
+                    Children = new[]
+                    {
+                        mainSpriteText = new OsuSpriteText { Padding = new MarginPadding { Horizontal = margin } },
+                        fillerSpriteText = new OsuSpriteText { Padding = new MarginPadding { Horizontal = margin }, Alpha = 0 },
+                    }
+                };
+            }
+
+            private void updateText()
+            {
+                mainSpriteText.Text = text;
+                fillerSpriteText.Alpha = 0;
+
+                ClearTransforms();
+                X = 0;
+
+                float textOverflowWidth = mainSpriteText.Width - player_width;
+
+                if (textOverflowWidth > 0)
+                {
+                    fillerSpriteText.Alpha = 1;
+                    fillerSpriteText.Text = text;
+
+                    float initialX;
+                    float targetX;
+
+                    if (Anchor.HasFlagFast(Anchor.x0))
+                    {
+                        initialX = 0;
+                        targetX = -mainSpriteText.Width;
+                    }
+                    else if (Anchor.HasFlagFast(Anchor.x1))
+                    {
+                        initialX = (textOverflowWidth + mainSpriteText.Width) / 2;
+                        targetX = (textOverflowWidth - mainSpriteText.Width) / 2;
+                    }
+                    else // Anchor.x2
+                    {
+                        initialX = textOverflowWidth + mainSpriteText.Width;
+                        targetX = textOverflowWidth;
+                    }
+
+                    this.MoveToX(initialX)
+                        .Delay(initial_move_delay)
+                        .MoveToX(targetX, mainSpriteText.Width * 1000 / pixels_per_second)
+                        .Loop();
+                }
+            }
+        }
     }
 }

From b262497083ccef7d72b9c838d37bf13706ee4faf Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 28 Apr 2024 19:07:39 +0800
Subject: [PATCH 666/930] Check realm file can be written to before attempting
 further initialisation

Rather than creating a "corrupt" realm file in such cases, the game will
now refuse to start. This behaviour is usually what we want. In most
cases a second click on the game will start it successfully (the
previous instance's file handles are still doing stuff, or windows
defender is being silly).

Closes https://github.com/ppy/osu/issues/28018.
---
 osu.Game/Database/RealmAccess.cs | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 167d170c81..4bc7ec4979 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -300,6 +300,21 @@ namespace osu.Game.Database
 
         private Realm prepareFirstRealmAccess()
         {
+            // Before attempting to initialise realm, make sure the realm file isn't locked and has correct permissions.
+            //
+            // This is to avoid failures like:
+            // Realms.Exceptions.RealmException: SetEndOfFile() failed: unknown error (1224)
+            //
+            // which can occur due to file handles still being open by a previous instance.
+            if (storage.Exists(Filename))
+            {
+                // If this fails we allow it to block game startup.
+                // It's better than any alternative we can offer.
+                using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
+                {
+                }
+            }
+
             string newerVersionFilename = $"{Filename.Replace(realm_extension, string.Empty)}_newer_version{realm_extension}";
 
             // Attempt to recover a newer database version if available.
@@ -321,7 +336,7 @@ namespace osu.Game.Database
                 {
                     Logger.Error(e, "Your local database is too new to work with this version of osu!. Please close osu! and install the latest release to recover your data.");
 
-                    // If a newer version database already exists, don't backup again. We can presume that the first backup is the one we care about.
+                    // If a newer version database already exists, don't create another backup. We can presume that the first backup is the one we care about.
                     if (!storage.Exists(newerVersionFilename))
                         createBackup(newerVersionFilename);
                 }

From a4bc5a8fc9059e2f13d736965e8cc52eff95f7ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 10:35:37 +0800
Subject: [PATCH 667/930] Use helper method for backup retry attempts

---
 osu.Game/Database/RealmAccess.cs | 32 +++++++++-----------------------
 1 file changed, 9 insertions(+), 23 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 4bc7ec4979..b5faa898e7 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -35,6 +35,7 @@ using osu.Game.Rulesets.Mods;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Skinning;
+using osu.Game.Utils;
 using osuTK.Input;
 using Realms;
 using Realms.Exceptions;
@@ -1157,33 +1158,18 @@ namespace osu.Game.Database
         {
             Logger.Log($"Creating full realm database backup at {backupFilename}", LoggingTarget.Database);
 
-            int attempts = 10;
-
-            while (true)
+            FileUtils.AttemptOperation(() =>
             {
-                try
+                using (var source = storage.GetStream(Filename, mode: FileMode.Open))
                 {
-                    using (var source = storage.GetStream(Filename, mode: FileMode.Open))
-                    {
-                        // source may not exist.
-                        if (source == null)
-                            return;
+                    // source may not exist.
+                    if (source == null)
+                        return;
 
-                        using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
-                            source.CopyTo(destination);
-                    }
-
-                    return;
+                    using (var destination = storage.GetStream(backupFilename, FileAccess.Write, FileMode.CreateNew))
+                        source.CopyTo(destination);
                 }
-                catch (IOException)
-                {
-                    if (attempts-- <= 0)
-                        throw;
-
-                    // file may be locked during use.
-                    Thread.Sleep(500);
-                }
-            }
+            }, 20);
         }
 
         /// <summary>

From 1c1ee22aa70cfa3e92786fba7a208f2af08a2e69 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 10:36:49 +0800
Subject: [PATCH 668/930] Add retry attempts to hopefully fix windows tests
 runs

---
 osu.Game/Database/RealmAccess.cs | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index b5faa898e7..31ae22178f 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -311,9 +311,12 @@ namespace osu.Game.Database
             {
                 // If this fails we allow it to block game startup.
                 // It's better than any alternative we can offer.
-                using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
+                FileUtils.AttemptOperation(() =>
                 {
-                }
+                    using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
+                    {
+                    }
+                });
             }
 
             string newerVersionFilename = $"{Filename.Replace(realm_extension, string.Empty)}_newer_version{realm_extension}";

From a3d239c11aa85215b3565171de2b580b8b1c8411 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 18:48:07 +0800
Subject: [PATCH 669/930] Remove unused method

---
 osu.Game/Database/RealmArchiveModelImporter.cs | 10 ----------
 1 file changed, 10 deletions(-)

diff --git a/osu.Game/Database/RealmArchiveModelImporter.cs b/osu.Game/Database/RealmArchiveModelImporter.cs
index bc4954c6ea..0014e246dc 100644
--- a/osu.Game/Database/RealmArchiveModelImporter.cs
+++ b/osu.Game/Database/RealmArchiveModelImporter.cs
@@ -449,16 +449,6 @@ namespace osu.Game.Database
             return reader.Name.ComputeSHA2Hash();
         }
 
-        /// <summary>
-        /// Create all required <see cref="File"/>s for the provided archive, adding them to the global file store.
-        /// </summary>
-        private List<RealmNamedFileUsage> createFileInfos(ArchiveReader reader, RealmFileStore files, Realm realm)
-        {
-            var fileInfos = new List<RealmNamedFileUsage>();
-
-            return fileInfos;
-        }
-
         private IEnumerable<(string original, string shortened)> getShortenedFilenames(ArchiveReader reader)
         {
             string prefix = reader.Filenames.GetCommonPrefix();

From 45c2327509911032984c863acb912406c44075fa Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Apr 2024 13:00:22 +0200
Subject: [PATCH 670/930] Apply adjustments after framework-side
 `FriendlyGameName` changes

---
 osu.Desktop/Program.cs  |  6 +++++-
 osu.Game/OsuGameBase.cs | 12 +++++++-----
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 29b05a402f..d8364fc6e6 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -107,7 +107,11 @@ namespace osu.Desktop
                 }
             }
 
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null }))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions
+                   {
+                       IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null,
+                       FriendlyGameName = OsuGameBase.GAME_NAME,
+                   }))
             {
                 if (!host.IsPrimaryInstance)
                 {
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 0122afb239..5533ee8337 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -75,6 +75,12 @@ namespace osu.Game
     {
         public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv", ".mpg", ".wmv", ".m4v" };
 
+#if DEBUG
+        public const string GAME_NAME = "osu! (development)";
+#else
+        public const string GAME_NAME = "osu!";
+#endif
+
         public const string OSU_PROTOCOL = "osu://";
 
         public const string CLIENT_STREAM_NAME = @"lazer";
@@ -241,11 +247,7 @@ namespace osu.Game
 
         public OsuGameBase()
         {
-            Name = @"osu!";
-
-#if DEBUG
-            Name += " (development)";
-#endif
+            Name = GAME_NAME;
 
             allowableExceptions = UnhandledExceptionsBeforeCrash;
         }

From 9fc56f1cc7e916a7c41f7073be25b47642860df3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Apr 2024 13:07:36 +0200
Subject: [PATCH 671/930] Apply adjustments after migration of android to SDL3

---
 osu.Android/AndroidJoystickSettings.cs | 76 --------------------
 osu.Android/AndroidMouseSettings.cs    | 97 --------------------------
 osu.Android/OsuGameAndroid.cs          | 22 ------
 3 files changed, 195 deletions(-)
 delete mode 100644 osu.Android/AndroidJoystickSettings.cs
 delete mode 100644 osu.Android/AndroidMouseSettings.cs

diff --git a/osu.Android/AndroidJoystickSettings.cs b/osu.Android/AndroidJoystickSettings.cs
deleted file mode 100644
index bf69461f0d..0000000000
--- a/osu.Android/AndroidJoystickSettings.cs
+++ /dev/null
@@ -1,76 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Localisation;
-using osu.Game.Localisation;
-using osu.Game.Overlays.Settings;
-
-namespace osu.Android
-{
-    public partial class AndroidJoystickSettings : SettingsSubsection
-    {
-        protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
-
-        private readonly AndroidJoystickHandler joystickHandler;
-
-        private readonly Bindable<bool> enabled = new BindableBool(true);
-
-        private SettingsSlider<float> deadzoneSlider = null!;
-
-        private Bindable<float> handlerDeadzone = null!;
-
-        private Bindable<float> localDeadzone = null!;
-
-        public AndroidJoystickSettings(AndroidJoystickHandler joystickHandler)
-        {
-            this.joystickHandler = joystickHandler;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            // use local bindable to avoid changing enabled state of game host's bindable.
-            handlerDeadzone = joystickHandler.DeadzoneThreshold.GetBoundCopy();
-            localDeadzone = handlerDeadzone.GetUnboundCopy();
-
-            Children = new Drawable[]
-            {
-                new SettingsCheckbox
-                {
-                    LabelText = CommonStrings.Enabled,
-                    Current = enabled
-                },
-                deadzoneSlider = new SettingsSlider<float>
-                {
-                    LabelText = JoystickSettingsStrings.DeadzoneThreshold,
-                    KeyboardStep = 0.01f,
-                    DisplayAsPercentage = true,
-                    Current = localDeadzone,
-                },
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            enabled.BindTo(joystickHandler.Enabled);
-            enabled.BindValueChanged(e => deadzoneSlider.Current.Disabled = !e.NewValue, true);
-
-            handlerDeadzone.BindValueChanged(val =>
-            {
-                bool disabled = localDeadzone.Disabled;
-
-                localDeadzone.Disabled = false;
-                localDeadzone.Value = val.NewValue;
-                localDeadzone.Disabled = disabled;
-            }, true);
-
-            localDeadzone.BindValueChanged(val => handlerDeadzone.Value = val.NewValue);
-        }
-    }
-}
diff --git a/osu.Android/AndroidMouseSettings.cs b/osu.Android/AndroidMouseSettings.cs
deleted file mode 100644
index fd01b11164..0000000000
--- a/osu.Android/AndroidMouseSettings.cs
+++ /dev/null
@@ -1,97 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using Android.OS;
-using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Localisation;
-using osu.Game.Configuration;
-using osu.Game.Localisation;
-using osu.Game.Overlays.Settings;
-using osu.Game.Overlays.Settings.Sections.Input;
-
-namespace osu.Android
-{
-    public partial class AndroidMouseSettings : SettingsSubsection
-    {
-        private readonly AndroidMouseHandler mouseHandler;
-
-        protected override LocalisableString Header => MouseSettingsStrings.Mouse;
-
-        private Bindable<double> handlerSensitivity = null!;
-
-        private Bindable<double> localSensitivity = null!;
-
-        private Bindable<bool> relativeMode = null!;
-
-        public AndroidMouseSettings(AndroidMouseHandler mouseHandler)
-        {
-            this.mouseHandler = mouseHandler;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager osuConfig)
-        {
-            // use local bindable to avoid changing enabled state of game host's bindable.
-            handlerSensitivity = mouseHandler.Sensitivity.GetBoundCopy();
-            localSensitivity = handlerSensitivity.GetUnboundCopy();
-
-            relativeMode = mouseHandler.UseRelativeMode.GetBoundCopy();
-
-            // High precision/pointer capture is only available on Android 8.0 and up
-            if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
-            {
-                AddRange(new Drawable[]
-                {
-                    new SettingsCheckbox
-                    {
-                        LabelText = MouseSettingsStrings.HighPrecisionMouse,
-                        TooltipText = MouseSettingsStrings.HighPrecisionMouseTooltip,
-                        Current = relativeMode,
-                        Keywords = new[] { @"raw", @"input", @"relative", @"cursor", @"captured", @"pointer" },
-                    },
-                    new MouseSettings.SensitivitySetting
-                    {
-                        LabelText = MouseSettingsStrings.CursorSensitivity,
-                        Current = localSensitivity,
-                    },
-                });
-            }
-
-            AddRange(new Drawable[]
-            {
-                new SettingsCheckbox
-                {
-                    LabelText = MouseSettingsStrings.DisableMouseWheelVolumeAdjust,
-                    TooltipText = MouseSettingsStrings.DisableMouseWheelVolumeAdjustTooltip,
-                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableWheel),
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = MouseSettingsStrings.DisableClicksDuringGameplay,
-                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableButtons),
-                },
-            });
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            relativeMode.BindValueChanged(relative => localSensitivity.Disabled = !relative.NewValue, true);
-
-            handlerSensitivity.BindValueChanged(val =>
-            {
-                bool disabled = localSensitivity.Disabled;
-
-                localSensitivity.Disabled = false;
-                localSensitivity.Value = val.NewValue;
-                localSensitivity.Disabled = disabled;
-            }, true);
-
-            localSensitivity.BindValueChanged(val => handlerSensitivity.Value = val.NewValue);
-        }
-    }
-}
diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index 52cfb67f42..a235913ef3 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.cs
@@ -5,13 +5,9 @@ using System;
 using Android.App;
 using Microsoft.Maui.Devices;
 using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
 using osu.Framework.Extensions.ObjectExtensions;
-using osu.Framework.Input.Handlers;
 using osu.Framework.Platform;
 using osu.Game;
-using osu.Game.Overlays.Settings;
-using osu.Game.Overlays.Settings.Sections.Input;
 using osu.Game.Updater;
 using osu.Game.Utils;
 
@@ -88,24 +84,6 @@ namespace osu.Android
 
         protected override BatteryInfo CreateBatteryInfo() => new AndroidBatteryInfo();
 
-        public override SettingsSubsection CreateSettingsSubsectionFor(InputHandler handler)
-        {
-            switch (handler)
-            {
-                case AndroidMouseHandler mh:
-                    return new AndroidMouseSettings(mh);
-
-                case AndroidJoystickHandler jh:
-                    return new AndroidJoystickSettings(jh);
-
-                case AndroidTouchHandler th:
-                    return new TouchSettings(th);
-
-                default:
-                    return base.CreateSettingsSubsectionFor(handler);
-            }
-        }
-
         private class AndroidBatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel => Battery.ChargeLevel;

From fa3aeca09d8656ec76ae9e0401047b4f5f15646a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Apr 2024 14:06:02 +0200
Subject: [PATCH 672/930] Add failing test for skins not saving on change

---
 .../TestSceneSkinEditorNavigation.cs          | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
index 9c180d43da..38fb2846aa 100644
--- a/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestSceneSkinEditorNavigation.cs
@@ -3,6 +3,7 @@
 
 #nullable disable
 
+using System;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -321,6 +322,30 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("nested input disabled", () => ((Player)Game.ScreenStack.CurrentScreen).ChildrenOfType<PassThroughInputManager>().All(manager => !manager.UseParentInput));
         }
 
+        [Test]
+        public void TestSkinSavesOnChange()
+        {
+            advanceToSongSelect();
+            openSkinEditor();
+
+            Guid editedSkinId = Guid.Empty;
+            AddStep("save skin id", () => editedSkinId = Game.Dependencies.Get<SkinManager>().CurrentSkinInfo.Value.ID);
+            AddStep("add skinnable component", () =>
+            {
+                skinEditor.ChildrenOfType<SkinComponentToolbox.ToolboxComponentButton>().First().TriggerClick();
+            });
+
+            AddStep("change to triangles skin", () => Game.Dependencies.Get<SkinManager>().SetSkinFromConfiguration(SkinInfo.TRIANGLES_SKIN.ToString()));
+            AddUntilStep("components loaded", () => Game.ChildrenOfType<SkinComponentsContainer>().All(c => c.ComponentsLoaded));
+            // sort of implicitly relies on song select not being skinnable.
+            // TODO: revisit if the above ever changes
+            AddUntilStep("skin changed", () => !skinEditor.ChildrenOfType<SkinBlueprint>().Any());
+
+            AddStep("change back to modified skin", () => Game.Dependencies.Get<SkinManager>().SetSkinFromConfiguration(editedSkinId.ToString()));
+            AddUntilStep("components loaded", () => Game.ChildrenOfType<SkinComponentsContainer>().All(c => c.ComponentsLoaded));
+            AddUntilStep("changes saved", () => skinEditor.ChildrenOfType<SkinBlueprint>().Any());
+        }
+
         private void advanceToSongSelect()
         {
             PushAndConfirm(() => songSelect = new TestPlaySongSelect());

From f78abf801c2f2d9af66bc6baa71c0a0c6ec52406 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 29 Apr 2024 14:06:23 +0200
Subject: [PATCH 673/930] Autosave edited skin on change

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index bc929177d1..690c6b35e3 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -255,8 +255,11 @@ namespace osu.Game.Overlays.SkinEditor
             // schedule ensures this only happens when the skin editor is visible.
             // also avoid some weird endless recursion / bindable feedback loop (something to do with tracking skins across three different bindable types).
             // probably something which will be factored out in a future database refactor so not too concerning for now.
-            currentSkin.BindValueChanged(_ =>
+            currentSkin.BindValueChanged(val =>
             {
+                if (val.OldValue != null && hasBegunMutating)
+                    save(val.OldValue);
+
                 hasBegunMutating = false;
                 Scheduler.AddOnce(skinChanged);
             }, true);
@@ -537,7 +540,9 @@ namespace osu.Game.Overlays.SkinEditor
 
         protected void Redo() => changeHandler?.RestoreState(1);
 
-        public void Save(bool userTriggered = true)
+        public void Save(bool userTriggered = true) => save(currentSkin.Value);
+
+        private void save(Skin skin, bool userTriggered = true)
         {
             if (!hasBegunMutating)
                 return;
@@ -551,11 +556,11 @@ namespace osu.Game.Overlays.SkinEditor
                 return;
 
             foreach (var t in targetContainers)
-                currentSkin.Value.UpdateDrawableTarget(t);
+                skin.UpdateDrawableTarget(t);
 
             // In the case the save was user triggered, always show the save message to make them feel confident.
-            if (skins.Save(skins.CurrentSkin.Value) || userTriggered)
-                onScreenDisplay?.Display(new SkinEditorToast(ToastStrings.SkinSaved, currentSkin.Value.SkinInfo.ToString() ?? "Unknown"));
+            if (skins.Save(skin) || userTriggered)
+                onScreenDisplay?.Display(new SkinEditorToast(ToastStrings.SkinSaved, skin.SkinInfo.ToString() ?? "Unknown"));
         }
 
         protected override bool OnHover(HoverEvent e) => true;

From 85c085e5879d59fea0533c78261bf8b111d878c3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 23:22:25 +0800
Subject: [PATCH 674/930] Reduce startup volume

Constant complaints about startup volume mean we should reduce it
further and let users adjust as they see fit.
---
 osu.Game/OsuGame.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/OsuGame.cs b/osu.Game/OsuGame.cs
index 98533a5c82..7c89314014 100644
--- a/osu.Game/OsuGame.cs
+++ b/osu.Game/OsuGame.cs
@@ -841,7 +841,10 @@ namespace osu.Game
             {
                 // General expectation that osu! starts in fullscreen by default (also gives the most predictable performance).
                 // However, macOS is bound to have issues when using exclusive fullscreen as it takes full control away from OS, therefore borderless is default there.
-                { FrameworkSetting.WindowMode, RuntimeInfo.OS == RuntimeInfo.Platform.macOS ? WindowMode.Borderless : WindowMode.Fullscreen }
+                { FrameworkSetting.WindowMode, RuntimeInfo.OS == RuntimeInfo.Platform.macOS ? WindowMode.Borderless : WindowMode.Fullscreen },
+                { FrameworkSetting.VolumeUniversal, 0.6 },
+                { FrameworkSetting.VolumeMusic, 0.6 },
+                { FrameworkSetting.VolumeEffect, 0.6 },
             };
         }
 

From fd3f4a9e7b30560c6270845af4a77ae1ed8073ec Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 22:26:44 +0800
Subject: [PATCH 675/930] Preserve storyboard events when saving a beatmap in
 the editor

Until we have full encoding support for storyboards, this stop-gap
measure ensures that storyboards don't just disappear from existence.
---
 .../Beatmaps/Formats/LegacyBeatmapEncoderTest.cs  | 15 +++++++++++++++
 osu.Game/Beatmaps/Beatmap.cs                      |  2 ++
 osu.Game/Beatmaps/BeatmapConverter.cs             |  1 +
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 14 ++++++++++++++
 osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs |  3 +++
 osu.Game/Beatmaps/IBeatmap.cs                     |  6 ++++++
 .../Rulesets/Difficulty/DifficultyCalculator.cs   |  2 ++
 osu.Game/Screens/Edit/EditorBeatmap.cs            |  2 ++
 osu.Game/Tests/Beatmaps/TestBeatmap.cs            |  1 +
 9 files changed, 46 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index e847b61fbe..ef30f020ce 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -37,6 +37,21 @@ namespace osu.Game.Tests.Beatmaps.Formats
 
         private static IEnumerable<string> allBeatmaps = beatmaps_resource_store.GetAvailableResources().Where(res => res.EndsWith(".osu", StringComparison.Ordinal));
 
+        [Test]
+        public void TestUnsupportedStoryboardEvents()
+        {
+            const string name = "Resources/storyboard_only_video.osu";
+
+            var decoded = decodeFromLegacy(beatmaps_resource_store.GetStream(name), name);
+            var decodedAfterEncode = decodeFromLegacy(encodeToLegacy(decoded), name);
+
+            Assert.That(decoded.beatmap.UnhandledEventLines.Count, Is.EqualTo(1));
+            Assert.That(decoded.beatmap.UnhandledEventLines.Single(), Is.EqualTo("Video,0,\"video.avi\""));
+
+            Assert.That(decodedAfterEncode.beatmap.UnhandledEventLines.Count, Is.EqualTo(1));
+            Assert.That(decodedAfterEncode.beatmap.UnhandledEventLines.Single(), Is.EqualTo("Video,0,\"video.avi\""));
+        }
+
         [TestCaseSource(nameof(allBeatmaps))]
         public void TestEncodeDecodeStability(string name)
         {
diff --git a/osu.Game/Beatmaps/Beatmap.cs b/osu.Game/Beatmaps/Beatmap.cs
index 6db9febf36..ae77e4adcf 100644
--- a/osu.Game/Beatmaps/Beatmap.cs
+++ b/osu.Game/Beatmaps/Beatmap.cs
@@ -63,6 +63,8 @@ namespace osu.Game.Beatmaps
 
         public List<BreakPeriod> Breaks { get; set; } = new List<BreakPeriod>();
 
+        public List<string> UnhandledEventLines { get; set; } = new List<string>();
+
         [JsonIgnore]
         public double TotalBreakTime => Breaks.Sum(b => b.Duration);
 
diff --git a/osu.Game/Beatmaps/BeatmapConverter.cs b/osu.Game/Beatmaps/BeatmapConverter.cs
index c7c244bf0e..b68c80d4b3 100644
--- a/osu.Game/Beatmaps/BeatmapConverter.cs
+++ b/osu.Game/Beatmaps/BeatmapConverter.cs
@@ -66,6 +66,7 @@ namespace osu.Game.Beatmaps
             beatmap.ControlPointInfo = original.ControlPointInfo;
             beatmap.HitObjects = convertHitObjects(original.HitObjects, original, cancellationToken).OrderBy(s => s.StartTime).ToList();
             beatmap.Breaks = original.Breaks;
+            beatmap.UnhandledEventLines = original.UnhandledEventLines;
 
             return beatmap;
         }
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 386dada328..7407c3590f 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -420,6 +420,10 @@ namespace osu.Game.Beatmaps.Formats
             if (!Enum.TryParse(split[0], out LegacyEventType type))
                 throw new InvalidDataException($@"Unknown event type: {split[0]}");
 
+            // Until we have full storyboard encoder coverage, let's track any lines which aren't handled
+            // and store them to a temporary location such that they aren't lost on editor save / export.
+            bool lineSupportedByEncoder = false;
+
             switch (type)
             {
                 case LegacyEventType.Sprite:
@@ -427,7 +431,11 @@ namespace osu.Game.Beatmaps.Formats
                     // In some older beatmaps, it is not present and replaced by a storyboard-level background instead.
                     // Allow the first sprite (by file order) to act as the background in such cases.
                     if (string.IsNullOrEmpty(beatmap.BeatmapInfo.Metadata.BackgroundFile))
+                    {
                         beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[3]);
+                        lineSupportedByEncoder = true;
+                    }
+
                     break;
 
                 case LegacyEventType.Video:
@@ -439,12 +447,14 @@ namespace osu.Game.Beatmaps.Formats
                     if (!OsuGameBase.VIDEO_EXTENSIONS.Contains(Path.GetExtension(filename).ToLowerInvariant()))
                     {
                         beatmap.BeatmapInfo.Metadata.BackgroundFile = filename;
+                        lineSupportedByEncoder = true;
                     }
 
                     break;
 
                 case LegacyEventType.Background:
                     beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[2]);
+                    lineSupportedByEncoder = true;
                     break;
 
                 case LegacyEventType.Break:
@@ -452,8 +462,12 @@ namespace osu.Game.Beatmaps.Formats
                     double end = Math.Max(start, getOffsetTime(Parsing.ParseDouble(split[2])));
 
                     beatmap.Breaks.Add(new BreakPeriod(start, end));
+                    lineSupportedByEncoder = true;
                     break;
             }
+
+            if (!lineSupportedByEncoder)
+                beatmap.UnhandledEventLines.Add(line);
         }
 
         private void handleTimingPoint(string line)
diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
index 290d29090a..186b565c39 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapEncoder.cs
@@ -156,6 +156,9 @@ namespace osu.Game.Beatmaps.Formats
 
             foreach (var b in beatmap.Breaks)
                 writer.WriteLine(FormattableString.Invariant($"{(int)LegacyEventType.Break},{b.StartTime},{b.EndTime}"));
+
+            foreach (string l in beatmap.UnhandledEventLines)
+                writer.WriteLine(l);
         }
 
         private void handleControlPoints(TextWriter writer)
diff --git a/osu.Game/Beatmaps/IBeatmap.cs b/osu.Game/Beatmaps/IBeatmap.cs
index 6fe494ca0f..5cc38e5b84 100644
--- a/osu.Game/Beatmaps/IBeatmap.cs
+++ b/osu.Game/Beatmaps/IBeatmap.cs
@@ -42,6 +42,12 @@ namespace osu.Game.Beatmaps
         /// </summary>
         List<BreakPeriod> Breaks { get; }
 
+        /// <summary>
+        /// All lines from the [Events] section which aren't handled in the encoding process yet.
+        /// These lines shoule be written out to the beatmap file on save or export.
+        /// </summary>
+        List<string> UnhandledEventLines { get; }
+
         /// <summary>
         /// Total amount of break time in the beatmap.
         /// </summary>
diff --git a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
index 1599dff8d9..d37cfc28b9 100644
--- a/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
+++ b/osu.Game/Rulesets/Difficulty/DifficultyCalculator.cs
@@ -330,6 +330,8 @@ namespace osu.Game.Rulesets.Difficulty
             }
 
             public List<BreakPeriod> Breaks => baseBeatmap.Breaks;
+            public List<string> UnhandledEventLines => baseBeatmap.UnhandledEventLines;
+
             public double TotalBreakTime => baseBeatmap.TotalBreakTime;
             public IEnumerable<BeatmapStatistic> GetStatistics() => baseBeatmap.GetStatistics();
             public double GetMostCommonBeatLength() => baseBeatmap.GetMostCommonBeatLength();
diff --git a/osu.Game/Screens/Edit/EditorBeatmap.cs b/osu.Game/Screens/Edit/EditorBeatmap.cs
index dc1fda13f4..7a3ea474fb 100644
--- a/osu.Game/Screens/Edit/EditorBeatmap.cs
+++ b/osu.Game/Screens/Edit/EditorBeatmap.cs
@@ -174,6 +174,8 @@ namespace osu.Game.Screens.Edit
 
         public List<BreakPeriod> Breaks => PlayableBeatmap.Breaks;
 
+        public List<string> UnhandledEventLines => PlayableBeatmap.UnhandledEventLines;
+
         public double TotalBreakTime => PlayableBeatmap.TotalBreakTime;
 
         public IReadOnlyList<HitObject> HitObjects => PlayableBeatmap.HitObjects;
diff --git a/osu.Game/Tests/Beatmaps/TestBeatmap.cs b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
index ff670e1232..de7bcfcfaa 100644
--- a/osu.Game/Tests/Beatmaps/TestBeatmap.cs
+++ b/osu.Game/Tests/Beatmaps/TestBeatmap.cs
@@ -27,6 +27,7 @@ namespace osu.Game.Tests.Beatmaps
             BeatmapInfo = baseBeatmap.BeatmapInfo;
             ControlPointInfo = baseBeatmap.ControlPointInfo;
             Breaks = baseBeatmap.Breaks;
+            UnhandledEventLines = baseBeatmap.UnhandledEventLines;
 
             if (withHitObjects)
                 HitObjects = baseBeatmap.HitObjects;

From 19897c4c074fbca635b9bdbee66f4fb6e368a126 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 00:50:40 +0800
Subject: [PATCH 676/930] Add testing for actual presence of video after
 encode-decode

---
 .../Beatmaps/Formats/LegacyBeatmapEncoderTest.cs       | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
index ef30f020ce..b931896898 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapEncoderTest.cs
@@ -25,6 +25,7 @@ using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Taiko;
 using osu.Game.Skinning;
+using osu.Game.Storyboards;
 using osu.Game.Tests.Resources;
 using osuTK;
 
@@ -43,13 +44,14 @@ namespace osu.Game.Tests.Beatmaps.Formats
             const string name = "Resources/storyboard_only_video.osu";
 
             var decoded = decodeFromLegacy(beatmaps_resource_store.GetStream(name), name);
-            var decodedAfterEncode = decodeFromLegacy(encodeToLegacy(decoded), name);
-
             Assert.That(decoded.beatmap.UnhandledEventLines.Count, Is.EqualTo(1));
             Assert.That(decoded.beatmap.UnhandledEventLines.Single(), Is.EqualTo("Video,0,\"video.avi\""));
 
-            Assert.That(decodedAfterEncode.beatmap.UnhandledEventLines.Count, Is.EqualTo(1));
-            Assert.That(decodedAfterEncode.beatmap.UnhandledEventLines.Single(), Is.EqualTo("Video,0,\"video.avi\""));
+            var memoryStream = encodeToLegacy(decoded);
+
+            var storyboard = new LegacyStoryboardDecoder().Decode(new LineBufferedReader(memoryStream));
+            StoryboardLayer video = storyboard.Layers.Single(l => l.Name == "Video");
+            Assert.That(video.Elements.Count, Is.EqualTo(1));
         }
 
         [TestCaseSource(nameof(allBeatmaps))]

From b455e793dd7f3e3d8a75c57d3304e326ad75ab32 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 01:14:58 +0800
Subject: [PATCH 677/930] Add test coverage of reading japanese file from
 stable export

---
 .../Resources/Archives/japanese-filename.osz      | Bin 0 -> 816 bytes
 .../Skins/TestSceneBeatmapSkinResources.cs        |   9 +++++++++
 2 files changed, 9 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/Archives/japanese-filename.osz

diff --git a/osu.Game.Tests/Resources/Archives/japanese-filename.osz b/osu.Game.Tests/Resources/Archives/japanese-filename.osz
new file mode 100644
index 0000000000000000000000000000000000000000..4825c88179bb6d351f8766c4b4a17d89a50a0af5
GIT binary patch
literal 816
zcmWIWW@Zs#U|`^2h!mU`q3R&=>KG#fg9S4KgE~+&v8W`oxI{r$p(L{;CsjeCAhn>N
zQd1#1B{MB8Gr2UUq%u}7zqqtE$Twfgk!SDvE&mhyz6c0KtqLn{p1`k?5n%4SG|X~_
zq;qWB%&F-L3-|Av$Ji9IP_8Vz?)<mvZRSUMqb4|S<=E4<WZT}l*sE91TYow6VBYJj
z4I4%BRF58(+G@oh%wqj53Mkc6=>6l9$IN{%u3jy@@gwDM_XQ!-4SBL=Gq(H^vf-L=
zV2#=f&b>E1+utqUHH)o#=}nekr+MwyH_96w(h~b(9of?+SUZ{N{WHcJVor1JMF{!y
z^l7MlV4E$*^K)rOxocg=1h*|qB_gzEzU@0{_Qm~*-SyCKZ%#b!7r1tG&6n9pOx&FF
zjOWU{nsUGW!EE)(YvndDstaBXusi-?MzPEKRKCI$(K)wcV{H}Px#FUubWY^N2(96i
zHe2D!GA;1E@A`$Z{a>y|D@afIk(6KbB}~WceY!H+r+CGM|1_$OxQWe6pYkGc_WKup
ztdcTYblDB|_o?<yX8jzJktM76I&OQti~PwoUiadDrghu72JYP>b4qr)&hc$rPbw$9
zS+L<l>$&g2#wlFe7?$5&$@yl&)v2%MRPC{zeJOZuv_kp3n)O!39UpCeI%+XL{y*z`
zsQUWj2j9i-(+qxFe|N_7X(!)n+McOjta<rAYXC4QZ~-Hofx!Tn6u=B9!3m^GiV~Bv
z_43oxaVz5hD(hJ}ts0_=k;#|=cglj8tN@{iO=kh#AVYDx5n(7d6N-y*YXi9%q0I=W
V4dDY;HjoT65FP^35kNTx1^_=)9*Y0~

literal 0
HcmV?d00001

diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index d9212386c3..b566e892cd 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -21,6 +21,15 @@ namespace osu.Game.Tests.Skins
         [Resolved]
         private BeatmapManager beatmaps { get; set; } = null!;
 
+        [Test]
+        public void TestRetrieveJapaneseFilename()
+        {
+            IWorkingBeatmap beatmap = null!;
+
+            AddStep("import beatmap", () => beatmap = importBeatmapFromArchives(@"japanese-filename.osz"));
+            AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
+        }
+
         [Test]
         public void TestRetrieveOggAudio()
         {

From 97da47f69ca90fe35dad7914b04e97c7363e7df4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 01:27:45 +0800
Subject: [PATCH 678/930] Add test coverage of reading japanese filename after
 exporting

---
 .../Skins/TestSceneBeatmapSkinResources.cs    | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index b566e892cd..e0922c52f7 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.IO;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio.Track;
@@ -12,6 +13,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.Tests.Resources;
 using osu.Game.Tests.Visual;
+using MemoryStream = System.IO.MemoryStream;
 
 namespace osu.Game.Tests.Skins
 {
@@ -25,9 +27,23 @@ namespace osu.Game.Tests.Skins
         public void TestRetrieveJapaneseFilename()
         {
             IWorkingBeatmap beatmap = null!;
+            MemoryStream outStream = null!;
 
+            // Ensure importer encoding is correct
             AddStep("import beatmap", () => beatmap = importBeatmapFromArchives(@"japanese-filename.osz"));
             AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
+
+            // Ensure exporter encoding is correct (round trip)
+            AddStep("export", () =>
+            {
+                outStream = new MemoryStream();
+
+                new LegacyBeatmapExporter(LocalStorage)
+                    .ExportToStream((BeatmapSetInfo)beatmap.BeatmapInfo.BeatmapSet!, outStream, null);
+            });
+
+            AddStep("import beatmap again", () => beatmap = importBeatmapFromStream(outStream));
+            AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
         }
 
         [Test]
@@ -54,6 +70,12 @@ namespace osu.Game.Tests.Skins
             AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"spinner-osu")) != null);
         }
 
+        private IWorkingBeatmap importBeatmapFromStream(Stream stream)
+        {
+            var imported = beatmaps.Import(new ImportTask(stream, "filename.osz")).GetResultSafely();
+            return imported.AsNonNull().PerformRead(s => beatmaps.GetWorkingBeatmap(s.Beatmaps[0]));
+        }
+
         private IWorkingBeatmap importBeatmapFromArchives(string filename)
         {
             var imported = beatmaps.Import(new ImportTask(TestResources.OpenResource($@"Archives/{filename}"), filename)).GetResultSafely();

From c8f7f2215b4c9b3bcb5df8fdc46b7f906890dd2c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 29 Apr 2024 18:49:17 +0800
Subject: [PATCH 679/930] Force encoding to Shift-JIS for archive filenames
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

After way too much time investigating this, the encoding situation is
not great right now.

- Stable sets the "default code page" to be used for encoding filenames
to Shift-JIS (932):
https://github.com/peppy/osu-stable-reference/blob/c29ebd7fc52113013fb4ac2db230699d81e1fe2c/osu!/GameBase.cs#L3099
- Lazer does nothing (therefore using UTF-8).

When importing to lazer, stable files are assumed to be UTF-8. This
means that the linked beatmaps don't work correctly. Forcing lazer to
decompress *and* compress using Shift-JIS will fix this.

Here's a rough idea of how things look for japanese character filenames
in current `master`:

| | stable | lazer |
|--------|--------|--------|
| export encoding | shift-jis | utf8 |
| utf8 [bit flag](https://superuser.com/a/1507988) set | ❌ | ❌ |
| import stable export osz | ✅  | ❌ |
| import lazer export osz | ❌ | ✅ |
| windows unzip | ❌ | ❌ |
| macos unzip | ✅ | ✅ |

and after this change

| | stable | lazer |
|--------|--------|--------|
| export encoding | shift-jis | shift-jis |
| utf8 [bit flag](https://superuser.com/a/1507988) set | ❌ | ❌ |
| import stable export osz | ✅  | ✅ |
| import lazer export osz | ✅ | ✅ |
| windows unzip | ❌ | ❌ |
| macos unzip | ✅ | ✅ |

A future endeavour to improve compatibility would be to look at setting
the utf8 flag in lazer, switching the default to utf8, and ensuring the
stable supports this flag (I don't believe it does right now).
---
 osu.Game/Database/LegacyArchiveExporter.cs |  6 +++++-
 osu.Game/IO/Archives/ZipArchiveReader.cs   | 24 +++++++++++++++++++++-
 2 files changed, 28 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Database/LegacyArchiveExporter.cs b/osu.Game/Database/LegacyArchiveExporter.cs
index 9805207591..1d9d252220 100644
--- a/osu.Game/Database/LegacyArchiveExporter.cs
+++ b/osu.Game/Database/LegacyArchiveExporter.cs
@@ -7,6 +7,7 @@ using System.Threading;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
 using osu.Game.Extensions;
+using osu.Game.IO.Archives;
 using osu.Game.Overlays.Notifications;
 using Realms;
 using SharpCompress.Common;
@@ -29,7 +30,10 @@ namespace osu.Game.Database
 
         public override void ExportToStream(TModel model, Stream outputStream, ProgressNotification? notification, CancellationToken cancellationToken = default)
         {
-            using (var writer = new ZipWriter(outputStream, new ZipWriterOptions(CompressionType.Deflate)))
+            using (var writer = new ZipWriter(outputStream, new ZipWriterOptions(CompressionType.Deflate)
+                   {
+                       ArchiveEncoding = ZipArchiveReader.DEFAULT_ENCODING
+                   }))
             {
                 int i = 0;
                 int fileCount = model.Files.Count();
diff --git a/osu.Game/IO/Archives/ZipArchiveReader.cs b/osu.Game/IO/Archives/ZipArchiveReader.cs
index cc5c65d184..6bb2a314e7 100644
--- a/osu.Game/IO/Archives/ZipArchiveReader.cs
+++ b/osu.Game/IO/Archives/ZipArchiveReader.cs
@@ -7,23 +7,45 @@ using System.Buffers;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
+using System.Text;
 using Microsoft.Toolkit.HighPerformance;
 using osu.Framework.IO.Stores;
 using SharpCompress.Archives.Zip;
+using SharpCompress.Common;
+using SharpCompress.Readers;
 using SixLabors.ImageSharp.Memory;
 
 namespace osu.Game.IO.Archives
 {
     public sealed class ZipArchiveReader : ArchiveReader
     {
+        /// <summary>
+        /// Archives created by osu!stable still write out as Shift-JIS.
+        /// We want to force this fallback rather than leave it up to the library/system.
+        /// In the future we may want to change exports to set the zip UTF-8 flag and use that instead.
+        /// </summary>
+        public static readonly ArchiveEncoding DEFAULT_ENCODING;
+
         private readonly Stream archiveStream;
         private readonly ZipArchive archive;
 
+        static ZipArchiveReader()
+        {
+            // Required to support rare code pages.
+            Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
+
+            DEFAULT_ENCODING = new ArchiveEncoding(Encoding.GetEncoding(932), Encoding.GetEncoding(932));
+        }
+
         public ZipArchiveReader(Stream archiveStream, string name = null)
             : base(name)
         {
             this.archiveStream = archiveStream;
-            archive = ZipArchive.Open(archiveStream);
+
+            archive = ZipArchive.Open(archiveStream, new ReaderOptions
+            {
+                ArchiveEncoding = DEFAULT_ENCODING
+            });
         }
 
         public override Stream GetStream(string name)

From a8416f3572bfa143c6019322365211fb0df1837b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 12:39:18 +0800
Subject: [PATCH 680/930] Move `exists` check inside retry operation

Might help?
---
 osu.Game/Database/RealmAccess.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 31ae22178f..465d7b15a7 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -307,17 +307,17 @@ namespace osu.Game.Database
             // Realms.Exceptions.RealmException: SetEndOfFile() failed: unknown error (1224)
             //
             // which can occur due to file handles still being open by a previous instance.
-            if (storage.Exists(Filename))
+            //
+            // If this fails we allow it to block game startup. It's better than any alternative we can offer.
+            FileUtils.AttemptOperation(() =>
             {
-                // If this fails we allow it to block game startup.
-                // It's better than any alternative we can offer.
-                FileUtils.AttemptOperation(() =>
+                if (storage.Exists(Filename))
                 {
                     using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
                     {
                     }
-                });
-            }
+                }
+            });
 
             string newerVersionFilename = $"{Filename.Replace(realm_extension, string.Empty)}_newer_version{realm_extension}";
 

From 0bfad74907be51a9755e43cad6f44db372b57f21 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 14:09:29 +0800
Subject: [PATCH 681/930] Move realm error handling to avoid triggering in test
 scenarios

---
 osu.Game/Database/RealmAccess.cs | 38 +++++++++++++++++---------------
 1 file changed, 20 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 465d7b15a7..057bbe02e6 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -301,24 +301,6 @@ namespace osu.Game.Database
 
         private Realm prepareFirstRealmAccess()
         {
-            // Before attempting to initialise realm, make sure the realm file isn't locked and has correct permissions.
-            //
-            // This is to avoid failures like:
-            // Realms.Exceptions.RealmException: SetEndOfFile() failed: unknown error (1224)
-            //
-            // which can occur due to file handles still being open by a previous instance.
-            //
-            // If this fails we allow it to block game startup. It's better than any alternative we can offer.
-            FileUtils.AttemptOperation(() =>
-            {
-                if (storage.Exists(Filename))
-                {
-                    using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
-                    {
-                    }
-                }
-            });
-
             string newerVersionFilename = $"{Filename.Replace(realm_extension, string.Empty)}_newer_version{realm_extension}";
 
             // Attempt to recover a newer database version if available.
@@ -346,6 +328,26 @@ namespace osu.Game.Database
                 }
                 else
                 {
+                    // This error can occur due to file handles still being open by a previous instance.
+                    // If this is the case, rather than assuming the realm file is corrupt, block game startup.
+                    if (e.Message.StartsWith("SetEndOfFile() failed", StringComparison.Ordinal))
+                    {
+                        // This will throw if the realm file is not available for write access after 5 seconds.
+                        FileUtils.AttemptOperation(() =>
+                        {
+                            if (storage.Exists(Filename))
+                            {
+                                using (var _ = storage.GetStream(Filename, FileAccess.ReadWrite))
+                                {
+                                }
+                            }
+                        }, 20);
+
+                        // If the above eventually succeeds, try and continue startup as per normal.
+                        // This may throw again but let's allow it to, and block startup.
+                        return getRealmInstance();
+                    }
+
                     Logger.Error(e, "Realm startup failed with unrecoverable error; starting with a fresh database. A backup of your database has been made.");
                     createBackup($"{Filename.Replace(realm_extension, string.Empty)}_{DateTimeOffset.UtcNow.ToUnixTimeSeconds()}_corrupt{realm_extension}");
                 }

From ba9f4e4baff591cc4b35787216edfa4d88ccabc1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 16:08:30 +0800
Subject: [PATCH 682/930] Don't skip lines in beatmap decoding

Was added in cc76c58f5f250151bb85ad5efa3f6ce008f0cbb0 without any
specific reasoning. Likely not required (and will fix some storyboard
elements inside `.osu` files from not being correctly saved).
---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 7407c3590f..84f3c0d82a 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -167,8 +167,6 @@ namespace osu.Game.Beatmaps.Formats
             beatmapInfo.SamplesMatchPlaybackRate = false;
         }
 
-        protected override bool ShouldSkipLine(string line) => base.ShouldSkipLine(line) || line.StartsWith(' ') || line.StartsWith('_');
-
         protected override void ParseLine(Beatmap beatmap, Section section, string line)
         {
             switch (section)

From a3213fc36dd23f835db6cac300b1963948757e75 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 21:40:04 +0800
Subject: [PATCH 683/930] Change `.olz` to use UTF-8 encoding

---
 osu.Game/Database/BeatmapExporter.cs       | 2 ++
 osu.Game/Database/LegacyArchiveExporter.cs | 8 +++++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/BeatmapExporter.cs b/osu.Game/Database/BeatmapExporter.cs
index f37c57dea5..01ef09d3d7 100644
--- a/osu.Game/Database/BeatmapExporter.cs
+++ b/osu.Game/Database/BeatmapExporter.cs
@@ -17,6 +17,8 @@ namespace osu.Game.Database
         {
         }
 
+        protected override bool UseFixedEncoding => false;
+
         protected override string FileExtension => @".olz";
     }
 }
diff --git a/osu.Game/Database/LegacyArchiveExporter.cs b/osu.Game/Database/LegacyArchiveExporter.cs
index 1d9d252220..b0e5304ffd 100644
--- a/osu.Game/Database/LegacyArchiveExporter.cs
+++ b/osu.Game/Database/LegacyArchiveExporter.cs
@@ -3,6 +3,7 @@
 
 using System.IO;
 using System.Linq;
+using System.Text;
 using System.Threading;
 using osu.Framework.Logging;
 using osu.Framework.Platform;
@@ -23,6 +24,11 @@ namespace osu.Game.Database
     public abstract class LegacyArchiveExporter<TModel> : LegacyExporter<TModel>
         where TModel : RealmObject, IHasNamedFiles, IHasGuidPrimaryKey
     {
+        /// <summary>
+        /// Whether to always use Shift-JIS encoding for archive filenames (like osu!stable did).
+        /// </summary>
+        protected virtual bool UseFixedEncoding => true;
+
         protected LegacyArchiveExporter(Storage storage)
             : base(storage)
         {
@@ -32,7 +38,7 @@ namespace osu.Game.Database
         {
             using (var writer = new ZipWriter(outputStream, new ZipWriterOptions(CompressionType.Deflate)
                    {
-                       ArchiveEncoding = ZipArchiveReader.DEFAULT_ENCODING
+                       ArchiveEncoding = UseFixedEncoding ? ZipArchiveReader.DEFAULT_ENCODING : new ArchiveEncoding(Encoding.UTF8, Encoding.UTF8)
                    }))
             {
                 int i = 0;

From 6a7e2dc258a5cb4d2ea2a72b022cf75eec32186e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 30 Apr 2024 21:47:03 +0800
Subject: [PATCH 684/930] Fix formatting

---
 osu.Game/Database/LegacyArchiveExporter.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Database/LegacyArchiveExporter.cs b/osu.Game/Database/LegacyArchiveExporter.cs
index b0e5304ffd..e4d3ed4681 100644
--- a/osu.Game/Database/LegacyArchiveExporter.cs
+++ b/osu.Game/Database/LegacyArchiveExporter.cs
@@ -36,10 +36,12 @@ namespace osu.Game.Database
 
         public override void ExportToStream(TModel model, Stream outputStream, ProgressNotification? notification, CancellationToken cancellationToken = default)
         {
-            using (var writer = new ZipWriter(outputStream, new ZipWriterOptions(CompressionType.Deflate)
-                   {
-                       ArchiveEncoding = UseFixedEncoding ? ZipArchiveReader.DEFAULT_ENCODING : new ArchiveEncoding(Encoding.UTF8, Encoding.UTF8)
-                   }))
+            var zipWriterOptions = new ZipWriterOptions(CompressionType.Deflate)
+            {
+                ArchiveEncoding = UseFixedEncoding ? ZipArchiveReader.DEFAULT_ENCODING : new ArchiveEncoding(Encoding.UTF8, Encoding.UTF8)
+            };
+
+            using (var writer = new ZipWriter(outputStream, zipWriterOptions))
             {
                 int i = 0;
                 int fileCount = model.Files.Count();

From 38e239a435409e66cb1ccde05696b17afe2eae71 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 30 Apr 2024 16:07:37 +0200
Subject: [PATCH 685/930] Expand test to cover both legacy and non-legacy
 export paths

---
 .../Skins/TestSceneBeatmapSkinResources.cs    | 25 ++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
index e0922c52f7..5086b64433 100644
--- a/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
+++ b/osu.Game.Tests/Skins/TestSceneBeatmapSkinResources.cs
@@ -24,7 +24,7 @@ namespace osu.Game.Tests.Skins
         private BeatmapManager beatmaps { get; set; } = null!;
 
         [Test]
-        public void TestRetrieveJapaneseFilename()
+        public void TestRetrieveAndLegacyExportJapaneseFilename()
         {
             IWorkingBeatmap beatmap = null!;
             MemoryStream outStream = null!;
@@ -46,6 +46,29 @@ namespace osu.Game.Tests.Skins
             AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
         }
 
+        [Test]
+        public void TestRetrieveAndNonLegacyExportJapaneseFilename()
+        {
+            IWorkingBeatmap beatmap = null!;
+            MemoryStream outStream = null!;
+
+            // Ensure importer encoding is correct
+            AddStep("import beatmap", () => beatmap = importBeatmapFromArchives(@"japanese-filename.osz"));
+            AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
+
+            // Ensure exporter encoding is correct (round trip)
+            AddStep("export", () =>
+            {
+                outStream = new MemoryStream();
+
+                new BeatmapExporter(LocalStorage)
+                    .ExportToStream((BeatmapSetInfo)beatmap.BeatmapInfo.BeatmapSet!, outStream, null);
+            });
+
+            AddStep("import beatmap again", () => beatmap = importBeatmapFromStream(outStream));
+            AddAssert("sample is non-null", () => beatmap.Skin.GetSample(new SampleInfo(@"見本")) != null);
+        }
+
         [Test]
         public void TestRetrieveOggAudio()
         {

From ff108416d86a920dbe9f652898c59b263f2379a1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 May 2024 00:05:14 +0800
Subject: [PATCH 686/930] Fix incorrect background being loaded due to async
 race

If the API login (and thus user set) completed between `load` and
`LoadComplete`, the re-fetch on user change would not yet be hooked up,
causing an incorrect default background to be used instead.

Of note, moving this out of async load doesn't really affect load
performance as the bulk of the load operation is already scheduled and
`LoadComponentAsync`ed anyway
---
 osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
index a552b22c11..090e006671 100644
--- a/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
+++ b/osu.Game/Screens/Backgrounds/BackgroundScreenDefault.cs
@@ -56,10 +56,6 @@ namespace osu.Game.Screens.Backgrounds
             introSequence = config.GetBindable<IntroSequence>(OsuSetting.IntroSequence);
 
             AddInternal(seasonalBackgroundLoader);
-
-            // Load first background asynchronously as part of BDL load.
-            currentDisplay = RNG.Next(0, background_count);
-            Next();
         }
 
         protected override void LoadComplete()
@@ -73,6 +69,9 @@ namespace osu.Game.Screens.Backgrounds
             introSequence.ValueChanged += _ => Scheduler.AddOnce(next);
             seasonalBackgroundLoader.SeasonalBackgroundChanged += () => Scheduler.AddOnce(next);
 
+            currentDisplay = RNG.Next(0, background_count);
+            Next();
+
             // helper function required for AddOnce usage.
             void next() => Next();
         }

From 44091b1f352273c36f7545bfe44eaaeb0ef19003 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 May 2024 17:33:03 +0800
Subject: [PATCH 687/930] Fix some lines still getting forgotten about

---
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  | 75 ++++++++++---------
 1 file changed, 38 insertions(+), 37 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 84f3c0d82a..3ecc29bd02 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -415,53 +415,54 @@ namespace osu.Game.Beatmaps.Formats
         {
             string[] split = line.Split(',');
 
-            if (!Enum.TryParse(split[0], out LegacyEventType type))
-                throw new InvalidDataException($@"Unknown event type: {split[0]}");
 
             // Until we have full storyboard encoder coverage, let's track any lines which aren't handled
             // and store them to a temporary location such that they aren't lost on editor save / export.
             bool lineSupportedByEncoder = false;
 
-            switch (type)
+            if (Enum.TryParse(split[0], out LegacyEventType type))
             {
-                case LegacyEventType.Sprite:
-                    // Generally, the background is the first thing defined in a beatmap file.
-                    // In some older beatmaps, it is not present and replaced by a storyboard-level background instead.
-                    // Allow the first sprite (by file order) to act as the background in such cases.
-                    if (string.IsNullOrEmpty(beatmap.BeatmapInfo.Metadata.BackgroundFile))
-                    {
-                        beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[3]);
+                switch (type)
+                {
+                    case LegacyEventType.Sprite:
+                        // Generally, the background is the first thing defined in a beatmap file.
+                        // In some older beatmaps, it is not present and replaced by a storyboard-level background instead.
+                        // Allow the first sprite (by file order) to act as the background in such cases.
+                        if (string.IsNullOrEmpty(beatmap.BeatmapInfo.Metadata.BackgroundFile))
+                        {
+                            beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[3]);
+                            lineSupportedByEncoder = true;
+                        }
+
+                        break;
+
+                    case LegacyEventType.Video:
+                        string filename = CleanFilename(split[2]);
+
+                        // Some very old beatmaps had incorrect type specifications for their backgrounds (ie. using 1 for VIDEO
+                        // instead of 0 for BACKGROUND). To handle this gracefully, check the file extension against known supported
+                        // video extensions and handle similar to a background if it doesn't match.
+                        if (!OsuGameBase.VIDEO_EXTENSIONS.Contains(Path.GetExtension(filename).ToLowerInvariant()))
+                        {
+                            beatmap.BeatmapInfo.Metadata.BackgroundFile = filename;
+                            lineSupportedByEncoder = true;
+                        }
+
+                        break;
+
+                    case LegacyEventType.Background:
+                        beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[2]);
                         lineSupportedByEncoder = true;
-                    }
+                        break;
 
-                    break;
+                    case LegacyEventType.Break:
+                        double start = getOffsetTime(Parsing.ParseDouble(split[1]));
+                        double end = Math.Max(start, getOffsetTime(Parsing.ParseDouble(split[2])));
 
-                case LegacyEventType.Video:
-                    string filename = CleanFilename(split[2]);
-
-                    // Some very old beatmaps had incorrect type specifications for their backgrounds (ie. using 1 for VIDEO
-                    // instead of 0 for BACKGROUND). To handle this gracefully, check the file extension against known supported
-                    // video extensions and handle similar to a background if it doesn't match.
-                    if (!OsuGameBase.VIDEO_EXTENSIONS.Contains(Path.GetExtension(filename).ToLowerInvariant()))
-                    {
-                        beatmap.BeatmapInfo.Metadata.BackgroundFile = filename;
+                        beatmap.Breaks.Add(new BreakPeriod(start, end));
                         lineSupportedByEncoder = true;
-                    }
-
-                    break;
-
-                case LegacyEventType.Background:
-                    beatmap.BeatmapInfo.Metadata.BackgroundFile = CleanFilename(split[2]);
-                    lineSupportedByEncoder = true;
-                    break;
-
-                case LegacyEventType.Break:
-                    double start = getOffsetTime(Parsing.ParseDouble(split[1]));
-                    double end = Math.Max(start, getOffsetTime(Parsing.ParseDouble(split[2])));
-
-                    beatmap.Breaks.Add(new BreakPeriod(start, end));
-                    lineSupportedByEncoder = true;
-                    break;
+                        break;
+                }
             }
 
             if (!lineSupportedByEncoder)

From 67c0d7590a93a07cc642ecd1b03f70d6768f4638 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 May 2024 19:31:39 +0800
Subject: [PATCH 688/930] Decrease alpha of delayed resume overlay as count
 approaches zero

Allows better visibility of playfield underneath it.
---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 147d48ae02..32cdabcf98 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -170,6 +170,8 @@ namespace osu.Game.Screens.Play
             countdownProgress.Progress = amountTimePassed;
             countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 
+            Alpha = 0.2f + 0.8f * newCount / 3f;
+
             if (countdownCount != newCount)
             {
                 if (newCount > 0)

From 87e814e2019d0480d638f2287f2392ec14e7a1ea Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 May 2024 19:34:42 +0800
Subject: [PATCH 689/930] Fix incorrect xmldoc and adjust colour provider to
 match `Player`

---
 osu.Game/Rulesets/UI/DrawableRuleset.cs       | 2 +-
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 5 +++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Rulesets/UI/DrawableRuleset.cs b/osu.Game/Rulesets/UI/DrawableRuleset.cs
index a422761800..a28b2716cb 100644
--- a/osu.Game/Rulesets/UI/DrawableRuleset.cs
+++ b/osu.Game/Rulesets/UI/DrawableRuleset.cs
@@ -529,7 +529,7 @@ namespace osu.Game.Rulesets.UI
         public ResumeOverlay ResumeOverlay { get; protected set; }
 
         /// <summary>
-        /// Whether the <see cref="ResumeOverlay"/> should be used to return the user's cursor position to its previous location after a pause.
+        /// Whether a <see cref="ResumeOverlay"/> should be displayed on resuming after a pause.
         /// </summary>
         /// <remarks>
         /// Defaults to <c>true</c>.
diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 32cdabcf98..3202a524a8 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -24,8 +24,9 @@ namespace osu.Game.Screens.Play
     /// </summary>
     public partial class DelayedResumeOverlay : ResumeOverlay
     {
-        // todo: this shouldn't define its own colour provider, but nothing in Player screen does, so let's do that for now.
-        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Blue);
+        // todo: this shouldn't define its own colour provider, but nothing in DrawableRuleset guarantees this, so let's do it locally for now.
+        // (of note, Player does cache one but any test which uses a DrawableRuleset without Player will fail without this).
+        private readonly OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
 
         private const float outer_size = 200;
         private const float inner_size = 150;

From b8209b92f61d1a4098ccf0a42c36c7b7aceeb473 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 1 May 2024 19:49:45 +0800
Subject: [PATCH 690/930] Add delay before delayed resume starts

It was previously a bit sudden after dismissing the pause screen. Now
there's a short delay before the actual countdown begins.
---
 osu.Game/Screens/Play/DelayedResumeOverlay.cs | 33 ++++++++++---------
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Play/DelayedResumeOverlay.cs b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
index 3202a524a8..8acb94a5af 100644
--- a/osu.Game/Screens/Play/DelayedResumeOverlay.cs
+++ b/osu.Game/Screens/Play/DelayedResumeOverlay.cs
@@ -11,7 +11,6 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
-using osu.Framework.Threading;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
@@ -35,9 +34,10 @@ namespace osu.Game.Screens.Play
 
         private const double countdown_time = 2000;
 
+        private const int total_count = 3;
+
         protected override LocalisableString Message => string.Empty;
 
-        private ScheduledDelegate? scheduledResume;
         private int? countdownCount;
         private double countdownStartTime;
         private bool countdownComplete;
@@ -121,21 +121,17 @@ namespace osu.Game.Screens.Play
             innerContent.FadeIn().ScaleTo(Vector2.Zero).Then().ScaleTo(Vector2.One, 400, Easing.OutElasticHalf);
             countdownComponents.FadeOut().Delay(50).FadeTo(1, 100);
 
+            countdownProgress.Progress = 0;
+
             // Reset states for various components.
             countdownBackground.FadeIn();
             countdownText.FadeIn();
+            countdownText.Text = string.Empty;
             countdownProgress.FadeIn().ScaleTo(1);
 
             countdownComplete = false;
             countdownCount = null;
-            countdownStartTime = Time.Current;
-
-            scheduledResume?.Cancel();
-            scheduledResume = Scheduler.AddDelayed(() =>
-            {
-                countdownComplete = true;
-                Resume();
-            }, countdown_time);
+            countdownStartTime = Time.Current + 200;
         }
 
         protected override void PopOut()
@@ -153,8 +149,6 @@ namespace osu.Game.Screens.Play
             }
             else
                 countdownProgress.FadeOut();
-
-            scheduledResume?.Cancel();
         }
 
         protected override void Update()
@@ -165,13 +159,16 @@ namespace osu.Game.Screens.Play
 
         private void updateCountdown()
         {
-            double amountTimePassed = Math.Min(countdown_time, Time.Current - countdownStartTime) / countdown_time;
-            int newCount = 3 - (int)Math.Floor(amountTimePassed * 3);
+            if (State.Value == Visibility.Hidden || countdownComplete || Time.Current < countdownStartTime)
+                return;
+
+            double amountTimePassed = Math.Clamp((Time.Current - countdownStartTime) / countdown_time, 0, countdown_time);
+            int newCount = Math.Clamp(total_count - (int)Math.Floor(amountTimePassed * total_count), 0, total_count);
 
             countdownProgress.Progress = amountTimePassed;
             countdownProgress.InnerRadius = progress_stroke_width / progress_size / countdownProgress.Scale.X;
 
-            Alpha = 0.2f + 0.8f * newCount / 3f;
+            Alpha = 0.2f + 0.8f * newCount / total_count;
 
             if (countdownCount != newCount)
             {
@@ -194,6 +191,12 @@ namespace osu.Game.Screens.Play
             }
 
             countdownCount = newCount;
+
+            if (countdownCount == 0)
+            {
+                countdownComplete = true;
+                Resume();
+            }
         }
     }
 }

From f0eef329139f0dbe25fb0aa5ee534b33386f466f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 1 May 2024 15:21:39 +0200
Subject: [PATCH 691/930] Fix code quality inspection

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 3ecc29bd02..6fa78fa8e6 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -415,7 +415,6 @@ namespace osu.Game.Beatmaps.Formats
         {
             string[] split = line.Split(',');
 
-
             // Until we have full storyboard encoder coverage, let's track any lines which aren't handled
             // and store them to a temporary location such that they aren't lost on editor save / export.
             bool lineSupportedByEncoder = false;

From 981a19f6a5c6a9b2d9ef904e9644ac82af5e7007 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:17:50 +0300
Subject: [PATCH 692/930] Disable naming inspections in p/invoke code

---
 osu.Desktop/NVAPI.cs                             | 3 +++
 osu.Desktop/Windows/WindowsAssociationManager.cs | 5 +++++
 2 files changed, 8 insertions(+)

diff --git a/osu.Desktop/NVAPI.cs b/osu.Desktop/NVAPI.cs
index 554f89a847..c1622e7cc1 100644
--- a/osu.Desktop/NVAPI.cs
+++ b/osu.Desktop/NVAPI.cs
@@ -489,6 +489,7 @@ namespace osu.Desktop
         public static uint Stride => (uint)Marshal.SizeOf(typeof(NvApplication)) | (2 << 16);
     }
 
+    // ReSharper disable InconsistentNaming
     internal enum NvStatus
     {
         OK = 0, // Success. Request is completed.
@@ -738,4 +739,6 @@ namespace osu.Desktop
         OGL_THREAD_CONTROL_NUM_VALUES = 2,
         OGL_THREAD_CONTROL_DEFAULT = 0
     }
+
+    // ReSharper restore InconsistentNaming
 }
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index 11b5c19ca1..e4c070934e 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -163,6 +163,8 @@ namespace osu.Desktop.Windows
         [DllImport("Shell32.dll")]
         private static extern void SHChangeNotify(EventId wEventId, Flags uFlags, IntPtr dwItem1, IntPtr dwItem2);
 
+        // ReSharper disable InconsistentNaming
+
         private enum EventId
         {
             /// <summary>
@@ -174,9 +176,12 @@ namespace osu.Desktop.Windows
 
         private enum Flags : uint
         {
+            // ReSharper disable once InconsistentNaming
             SHCNF_IDLIST = 0x0000
         }
 
+        // ReSharper restore InconsistentNaming
+
         #endregion
 
         private record FileAssociation(string Extension, LocalisableString Description, string IconPath)

From 02be275554beed4e450c8eca29d1cf979890d489 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:20:20 +0300
Subject: [PATCH 693/930] Disable naming inspections in country/language enums

---
 osu.Game/Localisation/Language.cs | 2 ++
 osu.Game/Users/CountryCode.cs     | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index 711e95486f..e946779cba 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.cs
@@ -4,6 +4,8 @@
 using System.ComponentModel;
 using JetBrains.Annotations;
 
+// ReSharper disable InconsistentNaming
+
 namespace osu.Game.Localisation
 {
     [UsedImplicitly(ImplicitUseTargetFlags.WithMembers)]
diff --git a/osu.Game/Users/CountryCode.cs b/osu.Game/Users/CountryCode.cs
index edaa1562c7..6a0ed63648 100644
--- a/osu.Game/Users/CountryCode.cs
+++ b/osu.Game/Users/CountryCode.cs
@@ -6,6 +6,8 @@ using JetBrains.Annotations;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 
+// ReSharper disable InconsistentNaming
+
 namespace osu.Game.Users
 {
     /// <summary>

From 2fd8950b2135edde3d63431ea68e25f951a93b5b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:22:08 +0300
Subject: [PATCH 694/930] Disable inconsistent naming in some fields of
 `LegacyManiaSkinConfigurationLookup`

---
 osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs b/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs
index cacca0de23..1550fc8a47 100644
--- a/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs
+++ b/osu.Game/Skinning/LegacyManiaSkinConfigurationLookup.cs
@@ -67,7 +67,10 @@ namespace osu.Game.Skinning
         LeftStageImage,
         RightStageImage,
         BottomStageImage,
+
+        // ReSharper disable once InconsistentNaming
         Hit300g,
+
         Hit300,
         Hit200,
         Hit100,

From 97fc2a5473854b403525bcc028aaf24711af58ec Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:20:57 +0300
Subject: [PATCH 695/930] Disable inconsistent naming in some fields of
 `ScoreRank`

---
 osu.Game/Scoring/ScoreRank.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Scoring/ScoreRank.cs b/osu.Game/Scoring/ScoreRank.cs
index 327e4191d7..957cfc9b95 100644
--- a/osu.Game/Scoring/ScoreRank.cs
+++ b/osu.Game/Scoring/ScoreRank.cs
@@ -35,6 +35,7 @@ namespace osu.Game.Scoring
 
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.RankSH))]
         [Description(@"S+")]
+        // ReSharper disable once InconsistentNaming
         SH,
 
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.RankX))]
@@ -43,6 +44,7 @@ namespace osu.Game.Scoring
 
         [LocalisableDescription(typeof(BeatmapsStrings), nameof(BeatmapsStrings.RankXH))]
         [Description(@"SS+")]
+        // ReSharper disable once InconsistentNaming
         XH,
     }
 }

From 16bae4f0046f0c9bde8cdadb2a96f535c0904744 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:22:42 +0300
Subject: [PATCH 696/930] Update naming of enum fields in `StartMode`

---
 .../Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs  | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
index 66acd6d1b0..5446211ced 100644
--- a/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
+++ b/osu.Game/Screens/OnlinePlay/Multiplayer/Match/MultiplayerMatchSettingsOverlay.cs
@@ -486,16 +486,16 @@ namespace osu.Game.Screens.OnlinePlay.Multiplayer.Match
             Off = 0,
 
             [Description("30 seconds")]
-            Seconds_30 = 30,
+            Seconds30 = 30,
 
             [Description("1 minute")]
-            Seconds_60 = 60,
+            Seconds60 = 60,
 
             [Description("3 minutes")]
-            Seconds_180 = 180,
+            Seconds180 = 180,
 
             [Description("5 minutes")]
-            Seconds_300 = 300
+            Seconds300 = 300
         }
     }
 }

From e8a63813953ac17f3f646fe02dcfdf6f404cb158 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:22:52 +0300
Subject: [PATCH 697/930] Update naming of enum fields in `ObjType`

---
 osu.Game/IO/Legacy/SerializationReader.cs | 76 +++++++++++------------
 osu.Game/IO/Legacy/SerializationWriter.cs | 40 ++++++------
 2 files changed, 58 insertions(+), 58 deletions(-)

diff --git a/osu.Game/IO/Legacy/SerializationReader.cs b/osu.Game/IO/Legacy/SerializationReader.cs
index 2d3d5bffd5..fc61b028a4 100644
--- a/osu.Game/IO/Legacy/SerializationReader.cs
+++ b/osu.Game/IO/Legacy/SerializationReader.cs
@@ -123,58 +123,58 @@ namespace osu.Game.IO.Legacy
 
             switch (t)
             {
-                case ObjType.boolType:
+                case ObjType.BoolType:
                     return ReadBoolean();
 
-                case ObjType.byteType:
+                case ObjType.ByteType:
                     return ReadByte();
 
-                case ObjType.uint16Type:
+                case ObjType.UInt16Type:
                     return ReadUInt16();
 
-                case ObjType.uint32Type:
+                case ObjType.UInt32Type:
                     return ReadUInt32();
 
-                case ObjType.uint64Type:
+                case ObjType.UInt64Type:
                     return ReadUInt64();
 
-                case ObjType.sbyteType:
+                case ObjType.SByteType:
                     return ReadSByte();
 
-                case ObjType.int16Type:
+                case ObjType.Int16Type:
                     return ReadInt16();
 
-                case ObjType.int32Type:
+                case ObjType.Int32Type:
                     return ReadInt32();
 
-                case ObjType.int64Type:
+                case ObjType.Int64Type:
                     return ReadInt64();
 
-                case ObjType.charType:
+                case ObjType.CharType:
                     return ReadChar();
 
-                case ObjType.stringType:
+                case ObjType.StringType:
                     return base.ReadString();
 
-                case ObjType.singleType:
+                case ObjType.SingleType:
                     return ReadSingle();
 
-                case ObjType.doubleType:
+                case ObjType.DoubleType:
                     return ReadDouble();
 
-                case ObjType.decimalType:
+                case ObjType.DecimalType:
                     return ReadDecimal();
 
-                case ObjType.dateTimeType:
+                case ObjType.DateTimeType:
                     return ReadDateTime();
 
-                case ObjType.byteArrayType:
+                case ObjType.ByteArrayType:
                     return ReadByteArray();
 
-                case ObjType.charArrayType:
+                case ObjType.CharArrayType:
                     return ReadCharArray();
 
-                case ObjType.otherType:
+                case ObjType.OtherType:
                     throw new IOException("Deserialization of arbitrary type is not supported.");
 
                 default:
@@ -185,25 +185,25 @@ namespace osu.Game.IO.Legacy
 
     public enum ObjType : byte
     {
-        nullType,
-        boolType,
-        byteType,
-        uint16Type,
-        uint32Type,
-        uint64Type,
-        sbyteType,
-        int16Type,
-        int32Type,
-        int64Type,
-        charType,
-        stringType,
-        singleType,
-        doubleType,
-        decimalType,
-        dateTimeType,
-        byteArrayType,
-        charArrayType,
-        otherType,
-        ILegacySerializableType
+        NullType,
+        BoolType,
+        ByteType,
+        UInt16Type,
+        UInt32Type,
+        UInt64Type,
+        SByteType,
+        Int16Type,
+        Int32Type,
+        Int64Type,
+        CharType,
+        StringType,
+        SingleType,
+        DoubleType,
+        DecimalType,
+        DateTimeType,
+        ByteArrayType,
+        CharArrayType,
+        OtherType,
+        LegacySerializableType
     }
 }
diff --git a/osu.Game/IO/Legacy/SerializationWriter.cs b/osu.Game/IO/Legacy/SerializationWriter.cs
index 10572a6478..afe86cd096 100644
--- a/osu.Game/IO/Legacy/SerializationWriter.cs
+++ b/osu.Game/IO/Legacy/SerializationWriter.cs
@@ -34,11 +34,11 @@ namespace osu.Game.IO.Legacy
         {
             if (str == null)
             {
-                Write((byte)ObjType.nullType);
+                Write((byte)ObjType.NullType);
             }
             else
             {
-                Write((byte)ObjType.stringType);
+                Write((byte)ObjType.StringType);
                 base.Write(str);
             }
         }
@@ -125,94 +125,94 @@ namespace osu.Game.IO.Legacy
         {
             if (obj == null)
             {
-                Write((byte)ObjType.nullType);
+                Write((byte)ObjType.NullType);
             }
             else
             {
                 switch (obj)
                 {
                     case bool boolObj:
-                        Write((byte)ObjType.boolType);
+                        Write((byte)ObjType.BoolType);
                         Write(boolObj);
                         break;
 
                     case byte byteObj:
-                        Write((byte)ObjType.byteType);
+                        Write((byte)ObjType.ByteType);
                         Write(byteObj);
                         break;
 
                     case ushort ushortObj:
-                        Write((byte)ObjType.uint16Type);
+                        Write((byte)ObjType.UInt16Type);
                         Write(ushortObj);
                         break;
 
                     case uint uintObj:
-                        Write((byte)ObjType.uint32Type);
+                        Write((byte)ObjType.UInt32Type);
                         Write(uintObj);
                         break;
 
                     case ulong ulongObj:
-                        Write((byte)ObjType.uint64Type);
+                        Write((byte)ObjType.UInt64Type);
                         Write(ulongObj);
                         break;
 
                     case sbyte sbyteObj:
-                        Write((byte)ObjType.sbyteType);
+                        Write((byte)ObjType.SByteType);
                         Write(sbyteObj);
                         break;
 
                     case short shortObj:
-                        Write((byte)ObjType.int16Type);
+                        Write((byte)ObjType.Int16Type);
                         Write(shortObj);
                         break;
 
                     case int intObj:
-                        Write((byte)ObjType.int32Type);
+                        Write((byte)ObjType.Int32Type);
                         Write(intObj);
                         break;
 
                     case long longObj:
-                        Write((byte)ObjType.int64Type);
+                        Write((byte)ObjType.Int64Type);
                         Write(longObj);
                         break;
 
                     case char charObj:
-                        Write((byte)ObjType.charType);
+                        Write((byte)ObjType.CharType);
                         base.Write(charObj);
                         break;
 
                     case string stringObj:
-                        Write((byte)ObjType.stringType);
+                        Write((byte)ObjType.StringType);
                         base.Write(stringObj);
                         break;
 
                     case float floatObj:
-                        Write((byte)ObjType.singleType);
+                        Write((byte)ObjType.SingleType);
                         Write(floatObj);
                         break;
 
                     case double doubleObj:
-                        Write((byte)ObjType.doubleType);
+                        Write((byte)ObjType.DoubleType);
                         Write(doubleObj);
                         break;
 
                     case decimal decimalObj:
-                        Write((byte)ObjType.decimalType);
+                        Write((byte)ObjType.DecimalType);
                         Write(decimalObj);
                         break;
 
                     case DateTime dateTimeObj:
-                        Write((byte)ObjType.dateTimeType);
+                        Write((byte)ObjType.DateTimeType);
                         Write(dateTimeObj);
                         break;
 
                     case byte[] byteArray:
-                        Write((byte)ObjType.byteArrayType);
+                        Write((byte)ObjType.ByteArrayType);
                         base.Write(byteArray);
                         break;
 
                     case char[] charArray:
-                        Write((byte)ObjType.charArrayType);
+                        Write((byte)ObjType.CharArrayType);
                         base.Write(charArray);
                         break;
 

From 9dc1a58ce7a4fb00a973a3ce4498b5bff8164e16 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 17:23:27 +0300
Subject: [PATCH 698/930] Add few abbreviations from existing enums to appease
 naming inspection

---
 osu.sln.DotSettings | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index dd71744bf0..51af281ac6 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -340,6 +340,7 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=API/@EntryIndexedValue">API</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=ARGB/@EntryIndexedValue">ARGB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=BPM/@EntryIndexedValue">BPM</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=DDKK/@EntryIndexedValue">DDKK</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=EF/@EntryIndexedValue">EF</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=FPS/@EntryIndexedValue">FPS</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=GC/@EntryIndexedValue">GC</s:String>
@@ -357,6 +358,8 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=IP/@EntryIndexedValue">IP</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=IPC/@EntryIndexedValue">IPC</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=JIT/@EntryIndexedValue">JIT</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=KDDK/@EntryIndexedValue">KDDK</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=KKDD/@EntryIndexedValue">KKDD</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=LTRB/@EntryIndexedValue">LTRB</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=MD/@EntryIndexedValue">MD5</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=NS/@EntryIndexedValue">NS</s:String>
@@ -375,6 +378,7 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=QAT/@EntryIndexedValue">QAT</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=BNG/@EntryIndexedValue">BNG</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=UI/@EntryIndexedValue">UI</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=WIP/@EntryIndexedValue">WIP</s:String>
 	<s:Boolean x:Key="/Default/CodeStyle/Naming/CSharpNaming/ApplyAutoDetectedRules/@EntryValue">False</s:Boolean>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/PredefinedNamingRules/=EnumMember/@EntryIndexedValue">HINT</s:String>
 	<s:String x:Key="/Default/CodeStyle/CSharpFileLayoutPatterns/Pattern/@EntryValue">&lt;?xml version="1.0" encoding="utf-16"?&gt;&#xD;

From 30fd40efd16a651a6c00b5c89289a85ffcbe546b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 21:18:56 +0300
Subject: [PATCH 699/930] Avoid disable/restore pairs

---
 osu.Desktop/NVAPI.cs                             | 9 ++++++---
 osu.Desktop/Windows/WindowsAssociationManager.cs | 8 +++-----
 osu.Game/Localisation/Language.cs                | 4 ++--
 osu.Game/Users/CountryCode.cs                    | 4 ++--
 4 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/osu.Desktop/NVAPI.cs b/osu.Desktop/NVAPI.cs
index c1622e7cc1..0b09613ba0 100644
--- a/osu.Desktop/NVAPI.cs
+++ b/osu.Desktop/NVAPI.cs
@@ -489,7 +489,7 @@ namespace osu.Desktop
         public static uint Stride => (uint)Marshal.SizeOf(typeof(NvApplication)) | (2 << 16);
     }
 
-    // ReSharper disable InconsistentNaming
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvStatus
     {
         OK = 0, // Success. Request is completed.
@@ -612,6 +612,7 @@ namespace osu.Desktop
         FIRMWARE_REVISION_NOT_SUPPORTED = -200, // The device's firmware is not supported.
     }
 
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvSystemType
     {
         UNKNOWN = 0,
@@ -619,6 +620,7 @@ namespace osu.Desktop
         DESKTOP = 2
     }
 
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvGpuType
     {
         UNKNOWN = 0,
@@ -626,6 +628,7 @@ namespace osu.Desktop
         DGPU = 2, // Discrete
     }
 
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvSettingID : uint
     {
         OGL_AA_LINE_GAMMA_ID = 0x2089BF6C,
@@ -718,6 +721,7 @@ namespace osu.Desktop
         INVALID_SETTING_ID = 0xFFFFFFFF
     }
 
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvShimSetting : uint
     {
         SHIM_RENDERING_MODE_INTEGRATED = 0x00000000,
@@ -732,6 +736,7 @@ namespace osu.Desktop
         SHIM_RENDERING_MODE_DEFAULT = SHIM_RENDERING_MODE_AUTO_SELECT
     }
 
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     internal enum NvThreadControlSetting : uint
     {
         OGL_THREAD_CONTROL_ENABLE = 0x00000001,
@@ -739,6 +744,4 @@ namespace osu.Desktop
         OGL_THREAD_CONTROL_NUM_VALUES = 2,
         OGL_THREAD_CONTROL_DEFAULT = 0
     }
-
-    // ReSharper restore InconsistentNaming
 }
diff --git a/osu.Desktop/Windows/WindowsAssociationManager.cs b/osu.Desktop/Windows/WindowsAssociationManager.cs
index e4c070934e..b32c01433d 100644
--- a/osu.Desktop/Windows/WindowsAssociationManager.cs
+++ b/osu.Desktop/Windows/WindowsAssociationManager.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Diagnostics.CodeAnalysis;
 using System.IO;
 using System.Runtime.InteropServices;
 using System.Runtime.Versioning;
@@ -163,8 +164,7 @@ namespace osu.Desktop.Windows
         [DllImport("Shell32.dll")]
         private static extern void SHChangeNotify(EventId wEventId, Flags uFlags, IntPtr dwItem1, IntPtr dwItem2);
 
-        // ReSharper disable InconsistentNaming
-
+        [SuppressMessage("ReSharper", "InconsistentNaming")]
         private enum EventId
         {
             /// <summary>
@@ -174,14 +174,12 @@ namespace osu.Desktop.Windows
             SHCNE_ASSOCCHANGED = 0x08000000
         }
 
+        [SuppressMessage("ReSharper", "InconsistentNaming")]
         private enum Flags : uint
         {
-            // ReSharper disable once InconsistentNaming
             SHCNF_IDLIST = 0x0000
         }
 
-        // ReSharper restore InconsistentNaming
-
         #endregion
 
         private record FileAssociation(string Extension, LocalisableString Description, string IconPath)
diff --git a/osu.Game/Localisation/Language.cs b/osu.Game/Localisation/Language.cs
index e946779cba..4e1fc3a474 100644
--- a/osu.Game/Localisation/Language.cs
+++ b/osu.Game/Localisation/Language.cs
@@ -2,12 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using System.Diagnostics.CodeAnalysis;
 using JetBrains.Annotations;
 
-// ReSharper disable InconsistentNaming
-
 namespace osu.Game.Localisation
 {
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     [UsedImplicitly(ImplicitUseTargetFlags.WithMembers)]
     public enum Language
     {
diff --git a/osu.Game/Users/CountryCode.cs b/osu.Game/Users/CountryCode.cs
index 6a0ed63648..59fcd5d625 100644
--- a/osu.Game/Users/CountryCode.cs
+++ b/osu.Game/Users/CountryCode.cs
@@ -2,18 +2,18 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.ComponentModel;
+using System.Diagnostics.CodeAnalysis;
 using JetBrains.Annotations;
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 
-// ReSharper disable InconsistentNaming
-
 namespace osu.Game.Users
 {
     /// <summary>
     /// Matches `osu_countries` database table.
     /// </summary>
     [JsonConverter(typeof(StringEnumConverter))]
+    [SuppressMessage("ReSharper", "InconsistentNaming")]
     [UsedImplicitly(ImplicitUseTargetFlags.WithMembers)]
     public enum CountryCode
     {

From eb45a406e153e9f533f51efaa95d30bb5bc0abe8 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 23:00:24 +0300
Subject: [PATCH 700/930] Add failing test case

---
 .../Formats/LegacyScoreEncoderTest.cs         | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
index 806f538249..1e57bd76cf 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreEncoderTest.cs
@@ -20,7 +20,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
         [TestCase(1, 3)]
         [TestCase(1, 0)]
         [TestCase(0, 3)]
-        public void CatchMergesFruitAndDropletMisses(int missCount, int largeTickMissCount)
+        public void TestCatchMergesFruitAndDropletMisses(int missCount, int largeTickMissCount)
         {
             var ruleset = new CatchRuleset().RulesetInfo;
             var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);
@@ -41,7 +41,22 @@ namespace osu.Game.Tests.Beatmaps.Formats
         }
 
         [Test]
-        public void ScoreWithMissIsNotPerfect()
+        public void TestFailPreserved()
+        {
+            var ruleset = new OsuRuleset().RulesetInfo;
+            var scoreInfo = TestResources.CreateTestScoreInfo();
+            var beatmap = new TestBeatmap(ruleset);
+
+            scoreInfo.Rank = ScoreRank.F;
+
+            var score = new Score { ScoreInfo = scoreInfo };
+            var decodedAfterEncode = encodeThenDecode(LegacyBeatmapDecoder.LATEST_VERSION, score, beatmap);
+
+            Assert.That(decodedAfterEncode.ScoreInfo.Rank, Is.EqualTo(ScoreRank.F));
+        }
+
+        [Test]
+        public void TestScoreWithMissIsNotPerfect()
         {
             var ruleset = new OsuRuleset().RulesetInfo;
             var scoreInfo = TestResources.CreateTestScoreInfo(ruleset);

From 0106f1fe3ead4d5bdbef25c1e0262b3988131894 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 23:31:23 +0300
Subject: [PATCH 701/930] Preserve score rank on encode/decode

---
 osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs | 6 ++++++
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs        | 5 +++++
 2 files changed, 11 insertions(+)

diff --git a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
index afdcef1d21..32c18b3af2 100644
--- a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
+++ b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
+using Newtonsoft.Json.Converters;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Scoring;
@@ -38,6 +39,10 @@ namespace osu.Game.Scoring.Legacy
         [JsonProperty("client_version")]
         public string ClientVersion = string.Empty;
 
+        [JsonProperty("rank")]
+        [JsonConverter(typeof(StringEnumConverter))]
+        public ScoreRank? Rank;
+
         public static LegacyReplaySoloScoreInfo FromScore(ScoreInfo score) => new LegacyReplaySoloScoreInfo
         {
             OnlineID = score.OnlineID,
@@ -45,6 +50,7 @@ namespace osu.Game.Scoring.Legacy
             Statistics = score.Statistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             ClientVersion = score.ClientVersion,
+            Rank = score.Rank,
         };
     }
 }
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index 65e2c02655..b0d7087ed1 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -40,6 +40,7 @@ namespace osu.Game.Scoring.Legacy
             };
 
             WorkingBeatmap workingBeatmap;
+            ScoreRank? decodedRank = null;
 
             using (SerializationReader sr = new SerializationReader(stream))
             {
@@ -129,6 +130,7 @@ namespace osu.Game.Scoring.Legacy
                         score.ScoreInfo.MaximumStatistics = readScore.MaximumStatistics;
                         score.ScoreInfo.Mods = readScore.Mods.Select(m => m.ToMod(currentRuleset)).ToArray();
                         score.ScoreInfo.ClientVersion = readScore.ClientVersion;
+                        decodedRank = readScore.Rank;
                     });
                 }
             }
@@ -140,6 +142,9 @@ namespace osu.Game.Scoring.Legacy
 
             StandardisedScoreMigrationTools.UpdateFromLegacy(score.ScoreInfo, workingBeatmap);
 
+            if (decodedRank != null)
+                score.ScoreInfo.Rank = decodedRank.Value;
+
             // before returning for database import, we must restore the database-sourced BeatmapInfo.
             // if not, the clone operation in GetPlayableBeatmap will cause a dereference and subsequent database exception.
             score.ScoreInfo.BeatmapInfo = workingBeatmap.BeatmapInfo;

From 4ffeb5b469b86bdfbf80dde018fc3c9d32ec4e4b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 1 May 2024 23:57:21 +0300
Subject: [PATCH 702/930] Resolve post-merge-conflict issues

---
 .../Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs      | 4 ++--
 .../Visual/Gameplay/TestSceneStoryboardWithIntro.cs           | 2 +-
 osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs     | 2 +-
 osu.Game/Storyboards/StoryboardVideo.cs                       | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
index dd6f833ec5..800857c973 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneDrawableStoryboardSprite.cs
@@ -85,8 +85,8 @@ namespace osu.Game.Tests.Visual.Gameplay
 
                 if (scaleTransformProvided)
                 {
-                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current, Time.Current + 1000, 1, 2);
-                    sprite.TimelineGroup.Scale.Add(Easing.None, Time.Current + 1000, Time.Current + 2000, 2, 1);
+                    sprite.Commands.AddScale(Easing.None, Time.Current, Time.Current + 1000, 1, 2);
+                    sprite.Commands.AddScale(Easing.None, Time.Current + 1000, Time.Current + 2000, 2, 1);
                 }
 
                 layer.Elements.Clear();
diff --git a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs
index 502a0de616..ee6a6938a9 100644
--- a/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs
+++ b/osu.Game.Tests/Visual/Gameplay/TestSceneStoryboardWithIntro.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Tests.Visual.Gameplay
         {
             var storyboard = new Storyboard();
             var sprite = new StoryboardSprite("unknown", Anchor.TopLeft, Vector2.Zero);
-            sprite.TimelineGroup.Alpha.Add(Easing.None, startTime, 0, 0, 1);
+            sprite.Commands.AddAlpha(Easing.None, startTime, 0, 0, 1);
             storyboard.GetLayer("Background").Add(sprite);
             return storyboard;
         }
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index f2454be190..08c9459042 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -25,7 +25,7 @@ namespace osu.Game.Storyboards.Drawables
             // This allows scaling based on the video's absolute size.
             //
             // If not specified we take up the full available space.
-            bool useRelative = !video.TimelineGroup.Scale.HasCommands;
+            bool useRelative = !video.Commands.Scale.Any();
 
             RelativeSizeAxes = useRelative ? Axes.Both : Axes.None;
             AutoSizeAxes = useRelative ? Axes.None : Axes.Both;
diff --git a/osu.Game/Storyboards/StoryboardVideo.cs b/osu.Game/Storyboards/StoryboardVideo.cs
index 5573162d26..14189a1a6c 100644
--- a/osu.Game/Storyboards/StoryboardVideo.cs
+++ b/osu.Game/Storyboards/StoryboardVideo.cs
@@ -14,7 +14,7 @@ namespace osu.Game.Storyboards
         {
             // This is just required to get a valid StartTime based on the incoming offset.
             // Actual fades are handled inside DrawableStoryboardVideo for now.
-            TimelineGroup.Alpha.Add(Easing.None, offset, offset, 0, 0);
+            Commands.AddAlpha(Easing.None, offset, offset, 0, 0);
         }
 
         public override Drawable CreateDrawable() => new DrawableStoryboardVideo(this);

From 6d6f165884ab31f4aec606bae0ce6ee3eba4f9fd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 2 May 2024 00:00:56 +0300
Subject: [PATCH 703/930] Make video sprites flippable and vector-scalable to
 fix type constraint errors

Stable supports these on videos already from a quick read on code (since videos are generally a subclass of sprites).
---
 .../Drawables/DrawableStoryboardVideo.cs      | 69 ++++++++++++++++++-
 1 file changed, 67 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
index 08c9459042..329564a345 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardVideo.cs
@@ -1,11 +1,16 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.IO;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Graphics.Video;
+using osu.Framework.Utils;
+using osuTK;
 
 namespace osu.Game.Storyboards.Drawables
 {
@@ -13,7 +18,7 @@ namespace osu.Game.Storyboards.Drawables
     {
         public readonly StoryboardVideo Video;
 
-        private Video? drawableVideo;
+        private DrawableVideo? drawableVideo;
 
         public override bool RemoveWhenNotAlive => false;
 
@@ -42,7 +47,7 @@ namespace osu.Game.Storyboards.Drawables
             if (stream == null)
                 return;
 
-            InternalChild = drawableVideo = new Video(stream, false)
+            InternalChild = drawableVideo = new DrawableVideo(stream, false)
             {
                 RelativeSizeAxes = RelativeSizeAxes,
                 FillMode = FillMode.Fill,
@@ -70,5 +75,65 @@ namespace osu.Game.Storyboards.Drawables
                     drawableVideo.FadeOut(500);
             }
         }
+
+        private partial class DrawableVideo : Video, IFlippable, IVectorScalable
+        {
+            private bool flipH;
+
+            public bool FlipH
+            {
+                get => flipH;
+                set
+                {
+                    if (flipH == value)
+                        return;
+
+                    flipH = value;
+                    Invalidate(Invalidation.MiscGeometry);
+                }
+            }
+
+            private bool flipV;
+
+            public bool FlipV
+            {
+                get => flipV;
+                set
+                {
+                    if (flipV == value)
+                        return;
+
+                    flipV = value;
+                    Invalidate(Invalidation.MiscGeometry);
+                }
+            }
+
+            private Vector2 vectorScale = Vector2.One;
+
+            public Vector2 VectorScale
+            {
+                get => vectorScale;
+                set
+                {
+                    if (vectorScale == value)
+                        return;
+
+                    if (!Validation.IsFinite(value)) throw new ArgumentException($@"{nameof(VectorScale)} must be finite, but is {value}.");
+
+                    vectorScale = value;
+                    Invalidate(Invalidation.MiscGeometry);
+                }
+            }
+
+            protected override Vector2 DrawScale
+                => new Vector2(FlipH ? -base.DrawScale.X : base.DrawScale.X, FlipV ? -base.DrawScale.Y : base.DrawScale.Y) * VectorScale;
+
+            public override Anchor Origin => StoryboardExtensions.AdjustOrigin(base.Origin, VectorScale, FlipH, FlipV);
+
+            public DrawableVideo(Stream stream, bool startAtCurrentTime = true)
+                : base(stream, startAtCurrentTime)
+            {
+            }
+        }
     }
 }

From b1aff91bba0d9aefdfb09d0e40e0b79673a691f3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 2 May 2024 00:31:48 +0300
Subject: [PATCH 704/930] Use throw helper methods
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Bartłomiej Dach <dach.bartlomiej@gmail.com>
---
 osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
index a886998679..fe334ad608 100644
--- a/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
+++ b/osu.Game/Storyboards/Commands/StoryboardLoopingGroup.cs
@@ -23,7 +23,7 @@ namespace osu.Game.Storyboards.Commands
         /// <param name="repeatCount">The number of times the loop should repeat. Should be greater than zero. Zero means a single playback.</param>
         public StoryboardLoopingGroup(double startTime, int repeatCount)
         {
-            if (repeatCount < 0) throw new ArgumentException("Repeat count must be zero or above.", nameof(repeatCount));
+            ArgumentOutOfRangeException.ThrowIfNegative(repeatCount);
 
             loopStartTime = startTime;
             TotalIterations = repeatCount + 1;

From 1eac34667d8c91679889475d17c8030e3bb85171 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 May 2024 08:02:55 +0200
Subject: [PATCH 705/930] Fix test failure

---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 43e471320e..383c08c10f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -352,6 +352,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 [HitResult.Great] = 200,
                 [HitResult.LargeTickHit] = 1,
             };
+            scoreInfo.Rank = ScoreRank.A;
 
             var beatmap = new TestBeatmap(ruleset);
             var score = new Score

From f9ef689492775d7c419fc1640621fe6cdf9f79e1 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 2 May 2024 15:36:40 +0800
Subject: [PATCH 706/930] Don't hide playfield layer with HUD

---
 osu.Game/Screens/Play/HUDOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 2ec2a011a6..9d7a05bc90 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -171,7 +171,7 @@ namespace osu.Game.Screens.Play
                 },
             };
 
-            hideTargets = new List<Drawable> { mainComponents, playfieldComponents, topRightElements };
+            hideTargets = new List<Drawable> { mainComponents, topRightElements };
 
             if (rulesetComponents != null)
                 hideTargets.Add(rulesetComponents);

From 093c25539cd85911f4a06ba780e647737c7ac676 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 May 2024 13:59:40 +0200
Subject: [PATCH 707/930] Add failing test case

---
 .../Editor/TestSceneOsuEditorGrids.cs         | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
index d14e593587..b720eb148b 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
+using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Osu.Edit;
 using osu.Game.Rulesets.Osu.Edit.Blueprints.HitCircles;
 using osu.Game.Tests.Visual;
@@ -54,6 +55,30 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddUntilStep("distance snap grid hidden", () => !this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
         }
 
+        [Test]
+        public void TestDistanceSnapAdjustDoesNotHideTheGrid()
+        {
+            double distanceSnap = double.PositiveInfinity;
+
+            AddStep("enable distance snap grid", () => InputManager.Key(Key.T));
+
+            AddStep("select second object", () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.ElementAt(1)));
+            AddUntilStep("distance snap grid visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+            AddStep("store distance snap", () => distanceSnap = this.ChildrenOfType<IDistanceSnapProvider>().First().DistanceSpacingMultiplier.Value);
+
+            AddStep("increase distance", () =>
+            {
+                InputManager.PressKey(Key.AltLeft);
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.ScrollVerticalBy(1);
+                InputManager.ReleaseKey(Key.ControlLeft);
+                InputManager.ReleaseKey(Key.AltLeft);
+            });
+
+            AddUntilStep("distance snap increased", () => this.ChildrenOfType<IDistanceSnapProvider>().First().DistanceSpacingMultiplier.Value, () => Is.GreaterThan(distanceSnap));
+            AddUntilStep("distance snap grid still visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+        }
+
         [Test]
         public void TestGridSnapMomentaryToggle()
         {

From 14658824e712a9aea3d1e6697d169a6e0b873201 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 May 2024 14:11:44 +0200
Subject: [PATCH 708/930] Adjust distance snap grid momentary toggle logic to
 not hide it on spacing adjust

---
 .../Rulesets/Edit/ComposerDistanceSnapProvider.cs  | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
index 62ad2ce7e9..b9850a94a3 100644
--- a/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
+++ b/osu.Game/Rulesets/Edit/ComposerDistanceSnapProvider.cs
@@ -63,6 +63,7 @@ namespace osu.Game.Rulesets.Edit
         public readonly Bindable<TernaryState> DistanceSnapToggle = new Bindable<TernaryState>();
 
         private bool distanceSnapMomentary;
+        private TernaryState? distanceSnapStateBeforeMomentaryToggle;
 
         private EditorToolboxGroup? toolboxGroup;
 
@@ -213,10 +214,19 @@ namespace osu.Game.Rulesets.Edit
         {
             bool altPressed = key.AltPressed;
 
-            if (altPressed != distanceSnapMomentary)
+            if (altPressed && !distanceSnapMomentary)
             {
-                distanceSnapMomentary = altPressed;
+                distanceSnapStateBeforeMomentaryToggle = DistanceSnapToggle.Value;
                 DistanceSnapToggle.Value = DistanceSnapToggle.Value == TernaryState.False ? TernaryState.True : TernaryState.False;
+                distanceSnapMomentary = true;
+            }
+
+            if (!altPressed && distanceSnapMomentary)
+            {
+                Debug.Assert(distanceSnapStateBeforeMomentaryToggle != null);
+                DistanceSnapToggle.Value = distanceSnapStateBeforeMomentaryToggle.Value;
+                distanceSnapStateBeforeMomentaryToggle = null;
+                distanceSnapMomentary = false;
             }
         }
 

From 6000ffed2a7eb000efb4ea045055d620be2dcbbd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 May 2024 14:15:46 +0200
Subject: [PATCH 709/930] Add extended test coverage for intended behaviour

---
 .../Editor/TestSceneOsuEditorGrids.cs         | 37 ++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
index b720eb148b..5798869210 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestSceneOsuEditorGrids.cs
@@ -53,10 +53,17 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddUntilStep("distance snap grid visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
             AddStep("release alt", () => InputManager.ReleaseKey(Key.AltLeft));
             AddUntilStep("distance snap grid hidden", () => !this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+
+            AddStep("enable distance snap grid", () => InputManager.Key(Key.T));
+            AddUntilStep("distance snap grid visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+            AddStep("hold alt", () => InputManager.PressKey(Key.AltLeft));
+            AddUntilStep("distance snap grid hidden", () => !this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+            AddStep("release alt", () => InputManager.ReleaseKey(Key.AltLeft));
+            AddUntilStep("distance snap grid visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
         }
 
         [Test]
-        public void TestDistanceSnapAdjustDoesNotHideTheGrid()
+        public void TestDistanceSnapAdjustDoesNotHideTheGridIfStartingEnabled()
         {
             double distanceSnap = double.PositiveInfinity;
 
@@ -79,6 +86,34 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             AddUntilStep("distance snap grid still visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
         }
 
+        [Test]
+        public void TestDistanceSnapAdjustShowsGridMomentarilyIfStartingDisabled()
+        {
+            double distanceSnap = double.PositiveInfinity;
+
+            AddStep("select second object", () => EditorBeatmap.SelectedHitObjects.Add(EditorBeatmap.HitObjects.ElementAt(1)));
+            AddUntilStep("distance snap grid hidden", () => !this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+            AddStep("store distance snap", () => distanceSnap = this.ChildrenOfType<IDistanceSnapProvider>().First().DistanceSpacingMultiplier.Value);
+
+            AddStep("start increasing distance", () =>
+            {
+                InputManager.PressKey(Key.AltLeft);
+                InputManager.PressKey(Key.ControlLeft);
+            });
+
+            AddUntilStep("distance snap grid visible", () => this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+
+            AddStep("finish increasing distance", () =>
+            {
+                InputManager.ScrollVerticalBy(1);
+                InputManager.ReleaseKey(Key.ControlLeft);
+                InputManager.ReleaseKey(Key.AltLeft);
+            });
+
+            AddUntilStep("distance snap increased", () => this.ChildrenOfType<IDistanceSnapProvider>().First().DistanceSpacingMultiplier.Value, () => Is.GreaterThan(distanceSnap));
+            AddUntilStep("distance snap hidden in the end", () => !this.ChildrenOfType<OsuDistanceSnapGrid>().Any());
+        }
+
         [Test]
         public void TestGridSnapMomentaryToggle()
         {

From 802666e621254fc4574f6c6db7fec2a1dd9f9548 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 2 May 2024 16:08:09 +0200
Subject: [PATCH 710/930] Update local metadata lookup cache more often

As proposed in
https://github.com/ppy/osu/issues/27332#issuecomment-1962308306.
---
 .../LocalCachedBeatmapMetadataSource.cs       | 55 ++++++++++++++++---
 1 file changed, 48 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/LocalCachedBeatmapMetadataSource.cs b/osu.Game/Beatmaps/LocalCachedBeatmapMetadataSource.cs
index 3f93c32283..27bc803449 100644
--- a/osu.Game/Beatmaps/LocalCachedBeatmapMetadataSource.cs
+++ b/osu.Game/Beatmaps/LocalCachedBeatmapMetadataSource.cs
@@ -44,11 +44,34 @@ namespace osu.Game.Beatmaps
 
             this.storage = storage;
 
-            // avoid downloading / using cache for unit tests.
-            if (!DebugUtils.IsNUnitRunning && !storage.Exists(cache_database_name))
+            if (shouldFetchCache())
                 prepareLocalCache();
         }
 
+        private bool shouldFetchCache()
+        {
+            // avoid downloading / using cache for unit tests.
+            if (DebugUtils.IsNUnitRunning)
+                return false;
+
+            if (!storage.Exists(cache_database_name))
+            {
+                log(@"Fetching local cache because it does not exist.");
+                return true;
+            }
+
+            // periodically update the cache to include newer beatmaps.
+            var fileInfo = new FileInfo(storage.GetFullPath(cache_database_name));
+
+            if (fileInfo.LastWriteTime < DateTime.Now.AddMonths(-1))
+            {
+                log($@"Refetching local cache because it was last written to on {fileInfo.LastWriteTime}.");
+                return true;
+            }
+
+            return false;
+        }
+
         public bool Available =>
             // no download in progress.
             cacheDownloadRequest == null
@@ -124,6 +147,8 @@ namespace osu.Game.Beatmaps
 
         private void prepareLocalCache()
         {
+            bool isRefetch = storage.Exists(cache_database_name);
+
             string cacheFilePath = storage.GetFullPath(cache_database_name);
             string compressedCacheFilePath = $@"{cacheFilePath}.bz2";
 
@@ -132,9 +157,15 @@ namespace osu.Game.Beatmaps
             cacheDownloadRequest.Failed += ex =>
             {
                 File.Delete(compressedCacheFilePath);
-                File.Delete(cacheFilePath);
 
-                Logger.Log($@"{nameof(BeatmapUpdaterMetadataLookup)}'s online cache download failed: {ex}", LoggingTarget.Database);
+                // don't clobber the cache when refetching if the download didn't succeed. seems excessive.
+                // consequently, also null the download request to allow the existing cache to be used (see `Available`).
+                if (isRefetch)
+                    cacheDownloadRequest = null;
+                else
+                    File.Delete(cacheFilePath);
+
+                log($@"Online cache download failed: {ex}");
             };
 
             cacheDownloadRequest.Finished += () =>
@@ -143,15 +174,22 @@ namespace osu.Game.Beatmaps
                 {
                     using (var stream = File.OpenRead(cacheDownloadRequest.Filename))
                     using (var outStream = File.OpenWrite(cacheFilePath))
-                    using (var bz2 = new BZip2Stream(stream, CompressionMode.Decompress, false))
-                        bz2.CopyTo(outStream);
+                    {
+                        // ensure to clobber any and all existing data to avoid accidental corruption.
+                        outStream.SetLength(0);
+
+                        using (var bz2 = new BZip2Stream(stream, CompressionMode.Decompress, false))
+                            bz2.CopyTo(outStream);
+                    }
 
                     // set to null on completion to allow lookups to begin using the new source
                     cacheDownloadRequest = null;
+                    log(@"Local cache fetch completed successfully.");
                 }
                 catch (Exception ex)
                 {
-                    Logger.Log($@"{nameof(LocalCachedBeatmapMetadataSource)}'s online cache extraction failed: {ex}", LoggingTarget.Database);
+                    log($@"Online cache extraction failed: {ex}");
+                    // at this point clobber the cache regardless of whether we're refetching, because by this point who knows what state the cache file is in.
                     File.Delete(cacheFilePath);
                 }
                 finally
@@ -173,6 +211,9 @@ namespace osu.Game.Beatmaps
             });
         }
 
+        private static void log(string message)
+            => Logger.Log($@"[{nameof(LocalCachedBeatmapMetadataSource)}] {message}", LoggingTarget.Database);
+
         private void logForModel(BeatmapSetInfo set, string message) =>
             RealmArchiveModelImporter<BeatmapSetInfo>.LogForModel(set, $@"[{nameof(LocalCachedBeatmapMetadataSource)}] {message}");
 

From f534c4aadab0a274674bd5b077e4acea797f177e Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Thu, 2 May 2024 18:42:35 +0200
Subject: [PATCH 711/930] Initial implementation

---
 .../Input/Bindings/GlobalActionContainer.cs   |  8 ++
 .../GlobalActionKeyBindingStrings.cs          | 10 ++
 osu.Game/Screens/Select/SongSelect.cs         | 97 ++++++++++++++++++-
 3 files changed, 113 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 296232d9ea..ff7d9f0a6d 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -134,6 +134,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
             new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
             new KeyBinding(InputKey.BackSpace, GlobalAction.DeselectAllMods),
+            new KeyBinding(InputKey.PageUp, GlobalAction.IncreaseSpeed), // Not working with minus and other keys....
+            new KeyBinding(InputKey.PageDown, GlobalAction.DecreaseSpeed),
         };
 
         public IEnumerable<KeyBinding> AudioControlKeyBindings => new[]
@@ -364,5 +366,11 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorToggleRotateControl))]
         EditorToggleRotateControl,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.IncreaseSpeed))]
+        IncreaseSpeed,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DecreaseSpeed))]
+        DecreaseSpeed,
     }
 }
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index 8356c480dd..40fe4064ed 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -349,6 +349,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString EditorToggleRotateControl => new TranslatableString(getKey(@"editor_toggle_rotate_control"), @"Toggle rotate control");
 
+        /// <summary>
+        /// "Increase Speed"
+        /// </summary>
+        public static LocalisableString IncreaseSpeed => new TranslatableString(getKey(@"increase_speed"), @"Increase Speed");
+
+        /// <summary>
+        /// "Decrease Speed"
+        /// </summary>
+        public static LocalisableString DecreaseSpeed => new TranslatableString(getKey(@"decrease_speed"), @"Decrease Speed");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 34ee0ae4e8..f2036f017d 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -755,7 +755,95 @@ namespace osu.Game.Screens.Select
 
             return false;
         }
-
+        public void IncreaseSpeed()
+        {
+            // find way of grabbing all types of ModSpeedAdjust
+            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod.Acronym == "DT" || pair.Mod.Acronym == "NC" || pair.Mod.Acronym == "HT" || pair.Mod.Acronym == "DC");
+            var stateDoubleTime = ModSelect.AllAvailableMods.First(pair => pair.Mod.Acronym == "DT");
+            bool oneActive = false;
+            double newRate = 1.05d;
+            foreach (var state in rateAdjustStates)
+            {
+                ModRateAdjust mod = (ModRateAdjust)state.Mod;
+                if (state.Active.Value)
+                {
+                    oneActive = true;
+                    newRate = mod.SpeedChange.Value + 0.05d;
+                    if (mod.Acronym == "DT" || mod.Acronym == "NC")
+                    {
+                        mod.SpeedChange.Value = newRate;
+                        return;
+                    }
+                    else
+                    {
+                        if (newRate == 1.0d)
+                        {
+                            state.Active.Value = false;
+                        }
+                        if (newRate > 1d)
+                        {
+                            state.Active.Value = false;
+                            stateDoubleTime.Active.Value = true;
+                            ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
+                            return;
+                        }
+                        if (newRate < 1d)
+                        {
+                            mod.SpeedChange.Value = newRate;
+                        }
+                    }
+                }
+            }
+            if (!oneActive)
+            {
+                stateDoubleTime.Active.Value = true;
+                ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
+            }
+        }
+        public void DecreaseSpeed()
+        {
+            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod.Acronym == "DT" || pair.Mod.Acronym == "NC" || pair.Mod.Acronym == "HT" || pair.Mod.Acronym == "DC");
+            var stateHalfTime = ModSelect.AllAvailableMods.First(pair => pair.Mod.Acronym == "HT");
+            bool oneActive = false;
+            double newRate = 0.95d;
+            foreach (var state in rateAdjustStates)
+            {
+                ModRateAdjust mod = (ModRateAdjust)state.Mod;
+                if (state.Active.Value)
+                {
+                    oneActive = true;
+                    newRate = mod.SpeedChange.Value - 0.05d;
+                    if (mod.Acronym == "HT" || mod.Acronym == "DC")
+                    {
+                        mod.SpeedChange.Value = newRate;
+                        return;
+                    }
+                    else
+                    {
+                        if (newRate == 1.0d)
+                        {
+                            state.Active.Value = false;
+                        }
+                        if (newRate < 1d)
+                        {
+                            state.Active.Value = false;
+                            stateHalfTime.Active.Value = true;
+                            ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
+                            return;
+                        }
+                        if (newRate > 1d)
+                        {
+                            mod.SpeedChange.Value = newRate;
+                        }
+                    }
+                }
+            }
+            if (!oneActive)
+            {
+                stateHalfTime.Active.Value = true;
+                ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
+            }
+        }
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -955,12 +1043,17 @@ namespace osu.Game.Screens.Select
                 return false;
 
             if (!this.IsCurrentScreen()) return false;
-
             switch (e.Action)
             {
                 case GlobalAction.Select:
                     FinaliseSelection();
                     return true;
+                case GlobalAction.IncreaseSpeed:
+                    IncreaseSpeed();
+                    return true;
+                case GlobalAction.DecreaseSpeed:
+                    DecreaseSpeed();
+                    return true;
             }
 
             return false;

From 5c21a0330addcf81db97e7ec157510d894cbd6a0 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Thu, 2 May 2024 19:05:07 +0200
Subject: [PATCH 712/930] F1 also does not work with minus in song select, same
 behaviour

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index ff7d9f0a6d..204ecb9061 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -134,7 +134,7 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
             new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
             new KeyBinding(InputKey.BackSpace, GlobalAction.DeselectAllMods),
-            new KeyBinding(InputKey.PageUp, GlobalAction.IncreaseSpeed), // Not working with minus and other keys....
+            new KeyBinding(InputKey.PageUp, GlobalAction.IncreaseSpeed),
             new KeyBinding(InputKey.PageDown, GlobalAction.DecreaseSpeed),
         };
 

From 7527ddbc6865c35e26a7c4deef850e0d4e93d786 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Thu, 2 May 2024 19:05:43 +0200
Subject: [PATCH 713/930] Comment, make code more readable, functions are now
 private

---
 osu.Game/Screens/Select/SongSelect.cs | 133 ++++++++++++--------------
 1 file changed, 60 insertions(+), 73 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index f2036f017d..5de4a7a9a3 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -755,93 +755,80 @@ namespace osu.Game.Screens.Select
 
             return false;
         }
-        public void IncreaseSpeed()
+        private void increaseSpeed()
         {
-            // find way of grabbing all types of ModSpeedAdjust
-            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod.Acronym == "DT" || pair.Mod.Acronym == "NC" || pair.Mod.Acronym == "HT" || pair.Mod.Acronym == "DC");
-            var stateDoubleTime = ModSelect.AllAvailableMods.First(pair => pair.Mod.Acronym == "DT");
-            bool oneActive = false;
-            double newRate = 1.05d;
-            foreach (var state in rateAdjustStates)
-            {
-                ModRateAdjust mod = (ModRateAdjust)state.Mod;
-                if (state.Active.Value)
-                {
-                    oneActive = true;
-                    newRate = mod.SpeedChange.Value + 0.05d;
-                    if (mod.Acronym == "DT" || mod.Acronym == "NC")
-                    {
-                        mod.SpeedChange.Value = newRate;
-                        return;
-                    }
-                    else
-                    {
-                        if (newRate == 1.0d)
-                        {
-                            state.Active.Value = false;
-                        }
-                        if (newRate > 1d)
-                        {
-                            state.Active.Value = false;
-                            stateDoubleTime.Active.Value = true;
-                            ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
-                            return;
-                        }
-                        if (newRate < 1d)
-                        {
-                            mod.SpeedChange.Value = newRate;
-                        }
-                    }
-                }
-            }
-            if (!oneActive)
+            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
+            var stateDoubleTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModDoubleTime);
+            bool rateModActive = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust && pair.Active.Value).Count() > 0;
+            double stepSize = 0.05d;
+            double newRate = 1d + stepSize;
+            // If no mod rateAdjust mod is currently active activate DoubleTime with speed newRate
+            if (!rateModActive)
             {
                 stateDoubleTime.Active.Value = true;
                 ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
+                return;
             }
-        }
-        public void DecreaseSpeed()
-        {
-            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod.Acronym == "DT" || pair.Mod.Acronym == "NC" || pair.Mod.Acronym == "HT" || pair.Mod.Acronym == "DC");
-            var stateHalfTime = ModSelect.AllAvailableMods.First(pair => pair.Mod.Acronym == "HT");
-            bool oneActive = false;
-            double newRate = 0.95d;
+            // Find current active rateAdjust mod and modify speed, enable DoubleTime if necessary
             foreach (var state in rateAdjustStates)
             {
                 ModRateAdjust mod = (ModRateAdjust)state.Mod;
-                if (state.Active.Value)
+                if (!state.Active.Value) continue;
+                newRate = mod.SpeedChange.Value + stepSize;
+                if (mod.Acronym == "DT" || mod.Acronym == "NC")
+                    mod.SpeedChange.Value = newRate;
+                else
                 {
-                    oneActive = true;
-                    newRate = mod.SpeedChange.Value - 0.05d;
-                    if (mod.Acronym == "HT" || mod.Acronym == "DC")
+                    if (newRate == 1.0d)
+                        state.Active.Value = false;
+                    if (newRate > 1d)
                     {
+                        state.Active.Value = false;
+                        stateDoubleTime.Active.Value = true;
+                        ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
+                        break;
+                    }
+                    if (newRate < 1d)
                         mod.SpeedChange.Value = newRate;
-                        return;
-                    }
-                    else
-                    {
-                        if (newRate == 1.0d)
-                        {
-                            state.Active.Value = false;
-                        }
-                        if (newRate < 1d)
-                        {
-                            state.Active.Value = false;
-                            stateHalfTime.Active.Value = true;
-                            ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
-                            return;
-                        }
-                        if (newRate > 1d)
-                        {
-                            mod.SpeedChange.Value = newRate;
-                        }
-                    }
                 }
             }
-            if (!oneActive)
+        }
+        private void decreaseSpeed()
+        {
+            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
+            var stateHalfTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModHalfTime);
+            bool rateModActive = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust && pair.Active.Value).Count() > 0;
+            double stepSize = 0.05d;
+            double newRate = 1d - stepSize;
+            // If no mod rateAdjust mod is currently active activate HalfTime with speed newRate
+            if (!rateModActive)
             {
                 stateHalfTime.Active.Value = true;
                 ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
+                return;
+            }
+            // Find current active rateAdjust mod and modify speed, enable HalfTime if necessary
+            foreach (var state in rateAdjustStates)
+            {
+                ModRateAdjust mod = (ModRateAdjust)state.Mod;
+                if (!state.Active.Value) continue;
+                newRate = mod.SpeedChange.Value - stepSize;
+                if (mod.Acronym == "HT" || mod.Acronym == "DC")
+                    mod.SpeedChange.Value = newRate;
+                else
+                {
+                    if (newRate == 1.0d)
+                        state.Active.Value = false;
+                    if (newRate < 1d)
+                    {
+                        state.Active.Value = false;
+                        stateHalfTime.Active.Value = true;
+                        ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
+                        break;
+                    }
+                    if (newRate > 1d)
+                        mod.SpeedChange.Value = newRate;
+                }
             }
         }
         protected override void Dispose(bool isDisposing)
@@ -1049,10 +1036,10 @@ namespace osu.Game.Screens.Select
                     FinaliseSelection();
                     return true;
                 case GlobalAction.IncreaseSpeed:
-                    IncreaseSpeed();
+                    increaseSpeed();
                     return true;
                 case GlobalAction.DecreaseSpeed:
-                    DecreaseSpeed();
+                    decreaseSpeed();
                     return true;
             }
 

From 588badf29216782699ae359700d6449e82638187 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Thu, 2 May 2024 19:22:39 +0200
Subject: [PATCH 714/930] Fix Formatting

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index f6bc002e32..5dacb6db4d 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -416,7 +416,7 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DecreaseSpeed))]
         DecreaseSpeed,
-        
+
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.IncreaseOffset))]
         IncreaseOffset,
 

From 4b5ea6bd0bc46cf37612efa0de3c81f3d4fe52bc Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Thu, 2 May 2024 19:41:00 +0200
Subject: [PATCH 715/930] Fix Code Inspection

---
 osu.Game/Screens/Select/SongSelect.cs | 36 +++++++++++++++++++++------
 1 file changed, 28 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 73ce029d3f..de0f24aa90 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -808,13 +808,15 @@ namespace osu.Game.Screens.Select
 
             return false;
         }
+
         private void increaseSpeed()
         {
             var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
             var stateDoubleTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModDoubleTime);
-            bool rateModActive = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust && pair.Active.Value).Count() > 0;
-            double stepSize = 0.05d;
-            double newRate = 1d + stepSize;
+            bool rateModActive = ModSelect.AllAvailableMods.Count(pair => pair.Mod is ModRateAdjust && pair.Active.Value) > 0;
+            const double stepsize = 0.05d;
+            double newRate = 1d + stepsize;
+
             // If no mod rateAdjust mod is currently active activate DoubleTime with speed newRate
             if (!rateModActive)
             {
@@ -822,18 +824,23 @@ namespace osu.Game.Screens.Select
                 ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
                 return;
             }
+
             // Find current active rateAdjust mod and modify speed, enable DoubleTime if necessary
             foreach (var state in rateAdjustStates)
             {
                 ModRateAdjust mod = (ModRateAdjust)state.Mod;
+
                 if (!state.Active.Value) continue;
-                newRate = mod.SpeedChange.Value + stepSize;
+
+                newRate = mod.SpeedChange.Value + stepsize;
+
                 if (mod.Acronym == "DT" || mod.Acronym == "NC")
                     mod.SpeedChange.Value = newRate;
                 else
                 {
                     if (newRate == 1.0d)
                         state.Active.Value = false;
+
                     if (newRate > 1d)
                     {
                         state.Active.Value = false;
@@ -841,18 +848,21 @@ namespace osu.Game.Screens.Select
                         ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
                         break;
                     }
+
                     if (newRate < 1d)
                         mod.SpeedChange.Value = newRate;
                 }
             }
         }
+
         private void decreaseSpeed()
         {
             var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
             var stateHalfTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModHalfTime);
-            bool rateModActive = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust && pair.Active.Value).Count() > 0;
-            double stepSize = 0.05d;
-            double newRate = 1d - stepSize;
+            bool rateModActive = ModSelect.AllAvailableMods.Count(pair => pair.Mod is ModRateAdjust && pair.Active.Value) > 0;
+            const double stepsize = 0.05d;
+            double newRate = 1d - stepsize;
+
             // If no mod rateAdjust mod is currently active activate HalfTime with speed newRate
             if (!rateModActive)
             {
@@ -860,18 +870,23 @@ namespace osu.Game.Screens.Select
                 ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
                 return;
             }
+
             // Find current active rateAdjust mod and modify speed, enable HalfTime if necessary
             foreach (var state in rateAdjustStates)
             {
                 ModRateAdjust mod = (ModRateAdjust)state.Mod;
+
                 if (!state.Active.Value) continue;
-                newRate = mod.SpeedChange.Value - stepSize;
+
+                newRate = mod.SpeedChange.Value - stepsize;
+
                 if (mod.Acronym == "HT" || mod.Acronym == "DC")
                     mod.SpeedChange.Value = newRate;
                 else
                 {
                     if (newRate == 1.0d)
                         state.Active.Value = false;
+
                     if (newRate < 1d)
                     {
                         state.Active.Value = false;
@@ -879,11 +894,13 @@ namespace osu.Game.Screens.Select
                         ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
                         break;
                     }
+
                     if (newRate > 1d)
                         mod.SpeedChange.Value = newRate;
                 }
             }
         }
+
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -1086,14 +1103,17 @@ namespace osu.Game.Screens.Select
                 return false;
 
             if (!this.IsCurrentScreen()) return false;
+
             switch (e.Action)
             {
                 case GlobalAction.Select:
                     FinaliseSelection();
                     return true;
+
                 case GlobalAction.IncreaseSpeed:
                     increaseSpeed();
                     return true;
+
                 case GlobalAction.DecreaseSpeed:
                     decreaseSpeed();
                     return true;

From 2f075e32479542e8b3dc0abd0ae3c93c4f0dae9f Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 May 2024 17:01:40 -0700
Subject: [PATCH 716/930] Apply half margin of tolerance on both sides before
 text scrolls

---
 .../TestSceneNowPlayingOverlay.cs             | 22 ++++++++++++++-----
 osu.Game/Overlays/NowPlayingOverlay.cs        |  4 +++-
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
index 40e0d9250d..1670741cbd 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
@@ -45,16 +45,28 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestLongMetadata()
         {
-            AddStep(@"set beatmap", () => Beatmap.Value = CreateWorkingBeatmap(new Beatmap
+            AddStep(@"set metadata within tolerance", () => Beatmap.Value = CreateWorkingBeatmap(new Beatmap
             {
                 Metadata =
                 {
-                    Artist = "very very very very very very very very very very very long artist",
-                    ArtistUnicode = "very very very very very very very very very very very long artist",
-                    Title = "very very very very very very very very very very very long title",
-                    TitleUnicode = "very very very very very very very very very very very long title",
+                    Artist = "very very very very very very very very very very verry long artist",
+                    ArtistUnicode = "very very very very very very very very very very verry long artist",
+                    Title = "very very very very very verry long title",
+                    TitleUnicode = "very very very very very verry long title",
                 }
             }));
+
+            AddStep(@"set metadata outside bounds", () => Beatmap.Value = CreateWorkingBeatmap(new Beatmap
+            {
+                Metadata =
+                {
+                    Artist = "very very very very very very very very very very verrry long artist",
+                    ArtistUnicode = "very very very very very very very very very very verrry long artist",
+                    Title = "very very very very very verrry long title",
+                    TitleUnicode = "very very very very very verrry long title",
+                }
+            }));
+
             AddStep(@"show", () => nowPlayingOverlay.Show());
         }
     }
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index be405257ca..b1f72fd792 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -9,6 +9,7 @@ using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
@@ -533,7 +534,8 @@ namespace osu.Game.Overlays
 
                 float textOverflowWidth = mainSpriteText.Width - player_width;
 
-                if (textOverflowWidth > 0)
+                // apply half margin of tolerance on both sides before the text scrolls
+                if (textOverflowWidth > margin)
                 {
                     fillerSpriteText.Alpha = 1;
                     fillerSpriteText.Text = text;

From 269077f85496142f470b3fce4306ac33ac8216ea Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 May 2024 17:04:22 -0700
Subject: [PATCH 717/930] Only support centre anchors

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 20 ++------------------
 1 file changed, 2 insertions(+), 18 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index b1f72fd792..7329a3b404 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -540,24 +540,8 @@ namespace osu.Game.Overlays
                     fillerSpriteText.Alpha = 1;
                     fillerSpriteText.Text = text;
 
-                    float initialX;
-                    float targetX;
-
-                    if (Anchor.HasFlagFast(Anchor.x0))
-                    {
-                        initialX = 0;
-                        targetX = -mainSpriteText.Width;
-                    }
-                    else if (Anchor.HasFlagFast(Anchor.x1))
-                    {
-                        initialX = (textOverflowWidth + mainSpriteText.Width) / 2;
-                        targetX = (textOverflowWidth - mainSpriteText.Width) / 2;
-                    }
-                    else // Anchor.x2
-                    {
-                        initialX = textOverflowWidth + mainSpriteText.Width;
-                        targetX = textOverflowWidth;
-                    }
+                    float initialX = (textOverflowWidth + mainSpriteText.Width) / 2;
+                    float targetX = (textOverflowWidth - mainSpriteText.Width) / 2;
 
                     this.MoveToX(initialX)
                         .Delay(initial_move_delay)

From 381ddb067618abb7b7cfceed944669e346b1bdf3 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 May 2024 17:05:12 -0700
Subject: [PATCH 718/930] Fix weird formatting

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 7329a3b404..1488f59246 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -494,14 +494,13 @@ namespace osu.Game.Overlays
 
             public FontUsage Font
             {
-                set =>
-                    Schedule(() =>
-                    {
-                        mainSpriteText.Font = value;
-                        fillerSpriteText.Font = value;
+                set => Schedule(() =>
+                {
+                    mainSpriteText.Font = value;
+                    fillerSpriteText.Font = value;
 
-                        updateText();
-                    });
+                    updateText();
+                });
             }
 
             public ScrollingTextContainer()

From c15a68507152b0710b90a4fa947cb5b994258bf9 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 May 2024 17:07:49 -0700
Subject: [PATCH 719/930] Remove unused usings

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 1488f59246..8f97ce50cc 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -6,10 +6,8 @@ using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
-using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;

From aa4d16bdb873d7296b899cee7b7491ffdf5cd6ab Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 12:13:52 +0800
Subject: [PATCH 720/930] Fix beatmap listing cards being far too large

---
 osu.Game/Overlays/BeatmapListingOverlay.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Overlays/BeatmapListingOverlay.cs b/osu.Game/Overlays/BeatmapListingOverlay.cs
index a645683c5f..9b2f26e8ae 100644
--- a/osu.Game/Overlays/BeatmapListingOverlay.cs
+++ b/osu.Game/Overlays/BeatmapListingOverlay.cs
@@ -198,6 +198,7 @@ namespace osu.Game.Overlays
         {
             c.Anchor = Anchor.TopCentre;
             c.Origin = Anchor.TopCentre;
+            c.Scale = new Vector2(0.8f);
         })).ToArray();
 
         private static ReverseChildIDFillFlowContainer<BeatmapCard> createCardContainerFor(IEnumerable<BeatmapCard> newCards)

From 3249ecee2731f49f95d8095e4bb96371d301e4a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 12:31:19 +0800
Subject: [PATCH 721/930] Fix chat overlay being far too large

---
 osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs | 4 ++--
 osu.Game/Overlays/Chat/ChatLine.cs                    | 2 +-
 osu.Game/Overlays/Chat/ChatTextBar.cs                 | 9 ++++++---
 osu.Game/Overlays/ChatOverlay.cs                      | 3 +--
 4 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
index 87b1f4ef01..e8c251e7fd 100644
--- a/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
+++ b/osu.Game/Overlays/Chat/ChannelList/ChannelListItem.cs
@@ -49,7 +49,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
         [BackgroundDependencyLoader]
         private void load()
         {
-            Height = 30;
+            Height = 25;
             RelativeSizeAxes = Axes.X;
 
             Children = new Drawable[]
@@ -87,7 +87,7 @@ namespace osu.Game.Overlays.Chat.ChannelList
                                 Anchor = Anchor.CentreLeft,
                                 Origin = Anchor.CentreLeft,
                                 Text = Channel.Name,
-                                Font = OsuFont.Torus.With(size: 17, weight: FontWeight.SemiBold),
+                                Font = OsuFont.Torus.With(size: 14, weight: FontWeight.SemiBold),
                                 Colour = colourProvider.Light3,
                                 Margin = new MarginPadding { Bottom = 2 },
                                 RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/Chat/ChatLine.cs b/osu.Game/Overlays/Chat/ChatLine.cs
index bbc3ee5bf4..9bcca3ac9d 100644
--- a/osu.Game/Overlays/Chat/ChatLine.cs
+++ b/osu.Game/Overlays/Chat/ChatLine.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Overlays.Chat
 
         public IReadOnlyCollection<Drawable> DrawableContentFlow => drawableContentFlow;
 
-        protected virtual float FontSize => 20;
+        protected virtual float FontSize => 14;
 
         protected virtual float Spacing => 15;
 
diff --git a/osu.Game/Overlays/Chat/ChatTextBar.cs b/osu.Game/Overlays/Chat/ChatTextBar.cs
index 16a8d14b10..0a42363279 100644
--- a/osu.Game/Overlays/Chat/ChatTextBar.cs
+++ b/osu.Game/Overlays/Chat/ChatTextBar.cs
@@ -19,6 +19,8 @@ namespace osu.Game.Overlays.Chat
 {
     public partial class ChatTextBar : Container
     {
+        public const float HEIGHT = 40;
+
         public readonly BindableBool ShowSearch = new BindableBool();
 
         public event Action<string>? OnChatMessageCommitted;
@@ -45,7 +47,7 @@ namespace osu.Game.Overlays.Chat
         private void load(OverlayColourProvider colourProvider)
         {
             RelativeSizeAxes = Axes.X;
-            Height = 60;
+            Height = HEIGHT;
 
             Children = new Drawable[]
             {
@@ -76,7 +78,7 @@ namespace osu.Game.Overlays.Chat
                                 Child = chattingText = new TruncatingSpriteText
                                 {
                                     MaxWidth = chatting_text_width - padding * 2,
-                                    Font = OsuFont.Torus.With(size: 20),
+                                    Font = OsuFont.Torus,
                                     Colour = colourProvider.Background1,
                                     Anchor = Anchor.CentreRight,
                                     Origin = Anchor.CentreRight,
@@ -91,7 +93,7 @@ namespace osu.Game.Overlays.Chat
                                     Icon = FontAwesome.Solid.Search,
                                     Origin = Anchor.CentreRight,
                                     Anchor = Anchor.CentreRight,
-                                    Size = new Vector2(20),
+                                    Size = new Vector2(OsuFont.DEFAULT_FONT_SIZE),
                                     Margin = new MarginPadding { Right = 2 },
                                 },
                             },
@@ -101,6 +103,7 @@ namespace osu.Game.Overlays.Chat
                                 Padding = new MarginPadding { Right = padding },
                                 Child = chatTextBox = new ChatTextBox
                                 {
+                                    FontSize = OsuFont.DEFAULT_FONT_SIZE,
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
                                     RelativeSizeAxes = Axes.X,
diff --git a/osu.Game/Overlays/ChatOverlay.cs b/osu.Game/Overlays/ChatOverlay.cs
index 8f3b7031c2..b11483e678 100644
--- a/osu.Game/Overlays/ChatOverlay.cs
+++ b/osu.Game/Overlays/ChatOverlay.cs
@@ -55,7 +55,6 @@ namespace osu.Game.Overlays
         private const int transition_length = 500;
         private const float top_bar_height = 40;
         private const float side_bar_width = 190;
-        private const float chat_bar_height = 60;
 
         protected override string PopInSampleName => @"UI/overlay-big-pop-in";
         protected override string PopOutSampleName => @"UI/overlay-big-pop-out";
@@ -136,7 +135,7 @@ namespace osu.Game.Overlays
                                     Padding = new MarginPadding
                                     {
                                         Left = side_bar_width,
-                                        Bottom = chat_bar_height,
+                                        Bottom = ChatTextBar.HEIGHT,
                                     },
                                     Children = new Drawable[]
                                     {

From 058bd5ced66d8d6937f77d41f3e4704089177530 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 13:38:27 +0800
Subject: [PATCH 722/930] Stop using visually noisy `bg4` for default
 backgrounds

This has always really annoyed me.
---
 osu.Game/Beatmaps/DummyWorkingBeatmap.cs | 2 +-
 osu.Game/Overlays/NowPlayingOverlay.cs   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
index d254945a51..35067f4055 100644
--- a/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
+++ b/osu.Game/Beatmaps/DummyWorkingBeatmap.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Beatmaps
 
         protected override IBeatmap GetBeatmap() => new Beatmap();
 
-        public override Texture GetBackground() => textures?.Get(@"Backgrounds/bg4");
+        public override Texture GetBackground() => textures?.Get(@"Backgrounds/bg2");
 
         protected override Track GetBeatmapTrack() => GetVirtualTrack();
 
diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index ab99370603..7e4f4f4e9b 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -422,7 +422,7 @@ namespace osu.Game.Overlays
             [BackgroundDependencyLoader]
             private void load(LargeTextureStore textures)
             {
-                sprite.Texture = beatmap.GetBackground() ?? textures.Get(@"Backgrounds/bg4");
+                sprite.Texture = beatmap.GetBackground() ?? textures.Get(@"Backgrounds/bg2");
             }
         }
 

From c1e9b6d4cae0793de9bc15cc055808db4995b1a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 13:42:56 +0800
Subject: [PATCH 723/930] Fix beatmap backgrounds loading default briefly
 before final display

Due to the way `ModelBackedDrawable` works, the default starts to get
loaded even though a final `Beatmap` has been set. This avoids loading
the default fallback unless a beatmap has been set (and has no
background itself).
---
 .../Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs    | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index 0bb60847e5..f067af5360 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -52,6 +52,9 @@ namespace osu.Game.Beatmaps.Drawables
 
         private Drawable getDrawableForModel(IBeatmapInfo? model)
         {
+            if (model == null)
+                return Empty();
+
             // prefer online cover where available.
             if (model?.BeatmapSet is IBeatmapSetOnlineInfo online)
                 return new OnlineBeatmapSetCover(online, beatmapSetCoverType);

From c21b7c7df994fa6a00a3edf7bc79653035bbaa8c Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Thu, 2 May 2024 22:46:42 -0700
Subject: [PATCH 724/930] Use `IsLoaded` instead of `Schedule`

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 35 ++++++++++++++++++++------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 8f97ce50cc..744d32ff7e 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -476,29 +476,35 @@ namespace osu.Game.Overlays
             private const float initial_move_delay = 1000;
             private const float pixels_per_second = 50;
 
-            private LocalisableString text;
             private OsuSpriteText mainSpriteText = null!;
             private OsuSpriteText fillerSpriteText = null!;
 
+            private LocalisableString text;
+
             public LocalisableString Text
             {
                 get => text;
                 set
                 {
                     text = value;
-                    Schedule(updateText);
+
+                    if (IsLoaded)
+                        updateText();
                 }
             }
 
+            private FontUsage font = OsuFont.Default;
+
             public FontUsage Font
             {
-                set => Schedule(() =>
+                get => font;
+                set
                 {
-                    mainSpriteText.Font = value;
-                    fillerSpriteText.Font = value;
+                    font = value;
 
-                    updateText();
-                });
+                    if (IsLoaded)
+                        updateFontAndText();
+                }
             }
 
             public ScrollingTextContainer()
@@ -521,6 +527,21 @@ namespace osu.Game.Overlays
                 };
             }
 
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+
+                updateFontAndText();
+            }
+
+            private void updateFontAndText()
+            {
+                mainSpriteText.Font = font;
+                fillerSpriteText.Font = font;
+
+                updateText();
+            }
+
             private void updateText()
             {
                 mainSpriteText.Text = text;

From c935d3bf6c12e0b6cd5e9213dcd9f3d68c27b22b Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 14:00:28 +0800
Subject: [PATCH 725/930] Reduce font size in channel listing too

---
 osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
index 9c85c73ee4..466f8b2f5d 100644
--- a/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
+++ b/osu.Game/Overlays/Chat/Listing/ChannelListingItem.cs
@@ -44,7 +44,7 @@ namespace osu.Game.Overlays.Chat.Listing
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        private const float text_size = 18;
+        private const float text_size = 14;
         private const float icon_size = 14;
 
         private const float vertical_margin = 1.5f;

From d1a50ff85bbfb4a502bd4df25a53d93386d7f920 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 08:11:00 +0200
Subject: [PATCH 726/930] Remove redundant conditional access

---
 .../Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
index f067af5360..6f71fa90b8 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableBeatmapBackgroundSprite.cs
@@ -56,7 +56,7 @@ namespace osu.Game.Beatmaps.Drawables
                 return Empty();
 
             // prefer online cover where available.
-            if (model?.BeatmapSet is IBeatmapSetOnlineInfo online)
+            if (model.BeatmapSet is IBeatmapSetOnlineInfo online)
                 return new OnlineBeatmapSetCover(online, beatmapSetCoverType);
 
             if (model is BeatmapInfo localModel)

From 42e49067e55ddb232d6fe1af0af44234a772f5fc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 17:10:59 +0800
Subject: [PATCH 727/930] Move `Room.Status` updates to a common location

---
 osu.Game/Online/Rooms/GetRoomsRequest.cs      | 19 +++++++++++++++++++
 osu.Game/Online/Rooms/Room.cs                 |  6 ++----
 .../Lounge/Components/RoomStatusPill.cs       | 12 +-----------
 .../Screens/OnlinePlay/OnlinePlayComposite.cs |  3 +++
 4 files changed, 25 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Online/Rooms/GetRoomsRequest.cs b/osu.Game/Online/Rooms/GetRoomsRequest.cs
index 7feb709acb..bfb2629c64 100644
--- a/osu.Game/Online/Rooms/GetRoomsRequest.cs
+++ b/osu.Game/Online/Rooms/GetRoomsRequest.cs
@@ -1,10 +1,12 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
 using System.Collections.Generic;
 using osu.Framework.IO.Network;
 using osu.Game.Extensions;
 using osu.Game.Online.API;
+using osu.Game.Online.Rooms.RoomStatuses;
 using osu.Game.Screens.OnlinePlay.Lounge.Components;
 
 namespace osu.Game.Online.Rooms
@@ -33,6 +35,23 @@ namespace osu.Game.Online.Rooms
             return req;
         }
 
+        protected override void PostProcess()
+        {
+            base.PostProcess();
+
+            if (Response != null)
+            {
+                // API doesn't populate status so let's do it here.
+                foreach (var room in Response)
+                {
+                    if (room.EndDate.Value != null && DateTimeOffset.Now >= room.EndDate.Value)
+                        room.Status.Value = new RoomStatusEnded();
+                    else
+                        room.Status.Value = new RoomStatusOpen();
+                }
+            }
+        }
+
         protected override string Target => "rooms";
     }
 }
diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 8f346c4057..23c77f8773 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -111,8 +111,9 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("current_user_score")]
         public readonly Bindable<PlaylistAggregateScore> UserScore = new Bindable<PlaylistAggregateScore>();
 
+        [Cached]
         [JsonProperty("has_password")]
-        public readonly BindableBool HasPassword = new BindableBool();
+        public readonly Bindable<bool> HasPassword = new Bindable<bool>();
 
         [Cached]
         [JsonProperty("recent_participants")]
@@ -201,9 +202,6 @@ namespace osu.Game.Online.Rooms
             CurrentPlaylistItem.Value = other.CurrentPlaylistItem.Value;
             AutoSkip.Value = other.AutoSkip.Value;
 
-            if (EndDate.Value != null && DateTimeOffset.Now >= EndDate.Value)
-                Status.Value = new RoomStatusEnded();
-
             other.RemoveExpiredPlaylistItems();
 
             if (!Playlist.SequenceEqual(other.Playlist))
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs
index aae82b6721..96d698a184 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/Components/RoomStatusPill.cs
@@ -1,13 +1,11 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Game.Graphics;
 using osu.Game.Online.Rooms;
-using osu.Game.Online.Rooms.RoomStatuses;
 
 namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 {
@@ -36,18 +34,10 @@ namespace osu.Game.Screens.OnlinePlay.Lounge.Components
 
         private void updateDisplay()
         {
-            RoomStatus status = getDisplayStatus();
+            RoomStatus status = Status.Value;
 
             Pill.Background.FadeColour(status.GetAppropriateColour(colours), 100);
             TextFlow.Text = status.Message;
         }
-
-        private RoomStatus getDisplayStatus()
-        {
-            if (EndDate.Value < DateTimeOffset.Now)
-                return new RoomStatusEnded();
-
-            return Status.Value;
-        }
     }
 }
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index ff536a65c4..83df1c6161 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -77,6 +77,9 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         public Bindable<string> Password { get; private set; }
 
+        [Resolved(typeof(Room))]
+        public Bindable<bool> HasPassword { get; private set; }
+
         [Resolved(typeof(Room))]
         protected Bindable<TimeSpan?> Duration { get; private set; }
 

From 7141177966c82ffa6f9e947687422f45645c4966 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 3 May 2024 17:11:29 +0800
Subject: [PATCH 728/930] Better signify private rooms by showing a different
 status pill design

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs   |  2 +-
 osu.Game/Online/Rooms/GetRoomsRequest.cs           |  2 ++
 .../Rooms/RoomStatuses/RoomStatusOpenPrivate.cs    | 14 ++++++++++++++
 3 files changed, 17 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpenPrivate.cs

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index bbf0e3697a..871fbc15b3 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -396,7 +396,7 @@ namespace osu.Game.Online.Multiplayer
                 switch (state)
                 {
                     case MultiplayerRoomState.Open:
-                        APIRoom.Status.Value = new RoomStatusOpen();
+                        APIRoom.Status.Value = APIRoom.HasPassword.Value ? new RoomStatusOpenPrivate() : new RoomStatusOpen();
                         break;
 
                     case MultiplayerRoomState.Playing:
diff --git a/osu.Game/Online/Rooms/GetRoomsRequest.cs b/osu.Game/Online/Rooms/GetRoomsRequest.cs
index bfb2629c64..1b5e08c729 100644
--- a/osu.Game/Online/Rooms/GetRoomsRequest.cs
+++ b/osu.Game/Online/Rooms/GetRoomsRequest.cs
@@ -46,6 +46,8 @@ namespace osu.Game.Online.Rooms
                 {
                     if (room.EndDate.Value != null && DateTimeOffset.Now >= room.EndDate.Value)
                         room.Status.Value = new RoomStatusEnded();
+                    else if (room.HasPassword.Value)
+                        room.Status.Value = new RoomStatusOpenPrivate();
                     else
                         room.Status.Value = new RoomStatusOpen();
                 }
diff --git a/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpenPrivate.cs b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpenPrivate.cs
new file mode 100644
index 0000000000..d71e706c76
--- /dev/null
+++ b/osu.Game/Online/Rooms/RoomStatuses/RoomStatusOpenPrivate.cs
@@ -0,0 +1,14 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Graphics;
+using osuTK.Graphics;
+
+namespace osu.Game.Online.Rooms.RoomStatuses
+{
+    public class RoomStatusOpenPrivate : RoomStatus
+    {
+        public override string Message => "Open (Private)";
+        public override Color4 GetAppropriateColour(OsuColour colours) => colours.GreenDark;
+    }
+}

From f57818f5a2245d2b2b27a19555fc65f7e5575ac1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 11:25:50 +0200
Subject: [PATCH 729/930] Add visual test coverage of private room status

---
 osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
index 4ffccdbf0e..98242e2d92 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoom.cs
@@ -69,8 +69,9 @@ namespace osu.Game.Tests.Visual.Multiplayer
                         }),
                         createLoungeRoom(new Room
                         {
-                            Name = { Value = "Multiplayer room" },
-                            Status = { Value = new RoomStatusOpen() },
+                            Name = { Value = "Private room" },
+                            Status = { Value = new RoomStatusOpenPrivate() },
+                            HasPassword = { Value = true },
                             EndDate = { Value = DateTimeOffset.Now.AddDays(1) },
                             Type = { Value = MatchType.HeadToHead },
                             Playlist =

From 221b4cd599df85d23212519a8a68bec8bb1e7797 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 11:36:18 +0200
Subject: [PATCH 730/930] Remove unused cache

---
 osu.Game/Online/Rooms/Room.cs                      | 1 -
 osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs | 3 ---
 2 files changed, 4 deletions(-)

diff --git a/osu.Game/Online/Rooms/Room.cs b/osu.Game/Online/Rooms/Room.cs
index 23c77f8773..5abf5034d9 100644
--- a/osu.Game/Online/Rooms/Room.cs
+++ b/osu.Game/Online/Rooms/Room.cs
@@ -111,7 +111,6 @@ namespace osu.Game.Online.Rooms
         [JsonProperty("current_user_score")]
         public readonly Bindable<PlaylistAggregateScore> UserScore = new Bindable<PlaylistAggregateScore>();
 
-        [Cached]
         [JsonProperty("has_password")]
         public readonly Bindable<bool> HasPassword = new Bindable<bool>();
 
diff --git a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
index 83df1c6161..ff536a65c4 100644
--- a/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
+++ b/osu.Game/Screens/OnlinePlay/OnlinePlayComposite.cs
@@ -77,9 +77,6 @@ namespace osu.Game.Screens.OnlinePlay
         [Resolved(typeof(Room))]
         public Bindable<string> Password { get; private set; }
 
-        [Resolved(typeof(Room))]
-        public Bindable<bool> HasPassword { get; private set; }
-
         [Resolved(typeof(Room))]
         protected Bindable<TimeSpan?> Duration { get; private set; }
 

From 7d31af6f16f3ecbc6d04051bad0a2b5284cb9326 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 11:34:42 +0200
Subject: [PATCH 731/930] Fix room status not updating when password is changed
 while inside the room

---
 osu.Game/Online/Multiplayer/MultiplayerClient.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game/Online/Multiplayer/MultiplayerClient.cs b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
index 871fbc15b3..77ede1fd35 100644
--- a/osu.Game/Online/Multiplayer/MultiplayerClient.cs
+++ b/osu.Game/Online/Multiplayer/MultiplayerClient.cs
@@ -816,6 +816,7 @@ namespace osu.Game.Online.Multiplayer
             Room.Settings = settings;
             APIRoom.Name.Value = Room.Settings.Name;
             APIRoom.Password.Value = Room.Settings.Password;
+            APIRoom.Status.Value = string.IsNullOrEmpty(Room.Settings.Password) ? new RoomStatusOpen() : new RoomStatusOpenPrivate();
             APIRoom.Type.Value = Room.Settings.MatchType;
             APIRoom.QueueMode.Value = Room.Settings.QueueMode;
             APIRoom.AutoStartDuration.Value = Room.Settings.AutoStartDuration;

From 1b7652e60d37d496c9c1f01a984e22b743904d35 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 13:47:10 +0200
Subject: [PATCH 732/930] Add failing tests

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 192 ++++++++++++++++++++
 1 file changed, 192 insertions(+)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index ebbc329b9d..eb2c098ab8 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -15,6 +15,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Database;
 using osu.Game.IO.Archives;
 using osu.Game.Online.API;
+using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
@@ -23,6 +24,7 @@ using osu.Game.Rulesets.Scoring;
 using osu.Game.Scoring;
 using osu.Game.Tests.Beatmaps.IO;
 using osu.Game.Tests.Resources;
+using osu.Game.Users;
 
 namespace osu.Game.Tests.Scores.IO
 {
@@ -284,6 +286,196 @@ namespace osu.Game.Tests.Scores.IO
             }
         }
 
+        [Test]
+        public void TestUserLookedUpForOnlineScore()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host, true);
+
+                    var api = (DummyAPIAccess)osu.API;
+                    api.HandleRequest = req =>
+                    {
+                        switch (req)
+                        {
+                            case GetUserRequest userRequest:
+                                userRequest.TriggerSuccess(new APIUser
+                                {
+                                    Username = "Test user",
+                                    CountryCode = CountryCode.JP,
+                                    Id = 1234
+                                });
+                                return true;
+
+                            default:
+                                return false;
+                        }
+                    };
+
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
+                    var toImport = new ScoreInfo
+                    {
+                        Rank = ScoreRank.B,
+                        TotalScore = 987654,
+                        Accuracy = 0.8,
+                        MaxCombo = 500,
+                        Combo = 250,
+                        User = new APIUser { Username = "Test user" },
+                        Date = DateTimeOffset.Now,
+                        OnlineID = 12345,
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                        BeatmapInfo = beatmap.Beatmaps.First()
+                    };
+
+                    var imported = LoadScoreIntoOsu(osu, toImport);
+
+                    Assert.AreEqual(toImport.Rank, imported.Rank);
+                    Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
+                    Assert.AreEqual(toImport.Accuracy, imported.Accuracy);
+                    Assert.AreEqual(toImport.MaxCombo, imported.MaxCombo);
+                    Assert.AreEqual(toImport.User.Username, imported.User.Username);
+                    Assert.AreEqual(toImport.Date, imported.Date);
+                    Assert.AreEqual(toImport.OnlineID, imported.OnlineID);
+                    Assert.AreEqual(toImport.User.Username, imported.RealmUser.Username);
+                    Assert.AreEqual(1234, imported.RealmUser.OnlineID);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
+        [Test]
+        public void TestUserLookedUpForLegacyOnlineScore()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host, true);
+
+                    var api = (DummyAPIAccess)osu.API;
+                    api.HandleRequest = req =>
+                    {
+                        switch (req)
+                        {
+                            case GetUserRequest userRequest:
+                                userRequest.TriggerSuccess(new APIUser
+                                {
+                                    Username = "Test user",
+                                    CountryCode = CountryCode.JP,
+                                    Id = 1234
+                                });
+                                return true;
+
+                            default:
+                                return false;
+                        }
+                    };
+
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
+                    var toImport = new ScoreInfo
+                    {
+                        Rank = ScoreRank.B,
+                        TotalScore = 987654,
+                        Accuracy = 0.8,
+                        MaxCombo = 500,
+                        Combo = 250,
+                        User = new APIUser { Username = "Test user" },
+                        Date = DateTimeOffset.Now,
+                        LegacyOnlineID = 12345,
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                        BeatmapInfo = beatmap.Beatmaps.First()
+                    };
+
+                    var imported = LoadScoreIntoOsu(osu, toImport);
+
+                    Assert.AreEqual(toImport.Rank, imported.Rank);
+                    Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
+                    Assert.AreEqual(toImport.Accuracy, imported.Accuracy);
+                    Assert.AreEqual(toImport.MaxCombo, imported.MaxCombo);
+                    Assert.AreEqual(toImport.User.Username, imported.User.Username);
+                    Assert.AreEqual(toImport.Date, imported.Date);
+                    Assert.AreEqual(toImport.OnlineID, imported.OnlineID);
+                    Assert.AreEqual(toImport.User.Username, imported.RealmUser.Username);
+                    Assert.AreEqual(1234, imported.RealmUser.OnlineID);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
+        [Test]
+        public void TestUserNotLookedUpForOfflineScore()
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host, true);
+
+                    var api = (DummyAPIAccess)osu.API;
+                    api.HandleRequest = req =>
+                    {
+                        switch (req)
+                        {
+                            case GetUserRequest userRequest:
+                                userRequest.TriggerSuccess(new APIUser
+                                {
+                                    Username = "Test user",
+                                    CountryCode = CountryCode.JP,
+                                    Id = 1234
+                                });
+                                return true;
+
+                            default:
+                                return false;
+                        }
+                    };
+
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
+                    var toImport = new ScoreInfo
+                    {
+                        Rank = ScoreRank.B,
+                        TotalScore = 987654,
+                        Accuracy = 0.8,
+                        MaxCombo = 500,
+                        Combo = 250,
+                        User = new APIUser { Username = "Test user" },
+                        Date = DateTimeOffset.Now,
+                        OnlineID = -1,
+                        LegacyOnlineID = -1,
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                        BeatmapInfo = beatmap.Beatmaps.First()
+                    };
+
+                    var imported = LoadScoreIntoOsu(osu, toImport);
+
+                    Assert.AreEqual(toImport.Rank, imported.Rank);
+                    Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
+                    Assert.AreEqual(toImport.Accuracy, imported.Accuracy);
+                    Assert.AreEqual(toImport.MaxCombo, imported.MaxCombo);
+                    Assert.AreEqual(toImport.User.Username, imported.User.Username);
+                    Assert.AreEqual(toImport.Date, imported.Date);
+                    Assert.AreEqual(toImport.OnlineID, imported.OnlineID);
+                    Assert.AreEqual(toImport.User.Username, imported.RealmUser.Username);
+                    Assert.That(imported.RealmUser.OnlineID, Is.LessThanOrEqualTo(1));
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         public static ScoreInfo LoadScoreIntoOsu(OsuGameBase osu, ScoreInfo score, ArchiveReader archive = null)
         {
             // clone to avoid attaching the input score to realm.

From afb491dff064967f4ccc6fe18f26e94e9322c570 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 13:48:06 +0200
Subject: [PATCH 733/930] Do not perform username lookups for scores without an
 online ID

---
 osu.Game/Scoring/ScoreImporter.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Scoring/ScoreImporter.cs b/osu.Game/Scoring/ScoreImporter.cs
index 768c28cc38..4ae8e51f6d 100644
--- a/osu.Game/Scoring/ScoreImporter.cs
+++ b/osu.Game/Scoring/ScoreImporter.cs
@@ -127,6 +127,9 @@ namespace osu.Game.Scoring
             if (model.RealmUser.OnlineID == APIUser.SYSTEM_USER_ID)
                 return;
 
+            if (model.OnlineID < 0 && model.LegacyOnlineID <= 0)
+                return;
+
             string username = model.RealmUser.Username;
 
             if (usernameLookupCache.TryGetValue(username, out var existing))

From a23d25e0a15c5ac6f3ab8565d3e4b2733501ff81 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 14:27:34 +0200
Subject: [PATCH 734/930] Fix `BeatmapAttributeText` breaking due to enum
 serialisation woes

---
 osu.Game/Skinning/Components/BeatmapAttributeText.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Skinning/Components/BeatmapAttributeText.cs b/osu.Game/Skinning/Components/BeatmapAttributeText.cs
index 5c5e509fb2..c467b2e946 100644
--- a/osu.Game/Skinning/Components/BeatmapAttributeText.cs
+++ b/osu.Game/Skinning/Components/BeatmapAttributeText.cs
@@ -125,6 +125,8 @@ namespace osu.Game.Skinning.Components
         protected override void SetFont(FontUsage font) => text.Font = font.With(size: 40);
     }
 
+    // WARNING: DO NOT ADD ANY VALUES TO THIS ENUM ANYWHERE ELSE THAN AT THE END.
+    // Doing so will break existing user skins.
     public enum BeatmapAttribute
     {
         CircleSize,
@@ -134,11 +136,11 @@ namespace osu.Game.Skinning.Components
         StarRating,
         Title,
         Artist,
-        Source,
         DifficultyName,
         Creator,
         Length,
         RankedStatus,
         BPM,
+        Source,
     }
 }

From e0e7e123bf7d052b074d1cbfbda82e6678a5d3cb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Brandst=C3=B6tter?= <jonas.brandstoetter@gmx.at>
Date: Fri, 3 May 2024 16:57:31 +0200
Subject: [PATCH 735/930] Keep menus open when clicking a stateful item with
 CTRL held

---
 .../UserInterface/DrawableStatefulMenuItem.cs        | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index 5af275c9e7..d63aaf2053 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
@@ -4,6 +4,7 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Input;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
@@ -19,6 +20,17 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override TextContainer CreateTextContainer() => new ToggleTextContainer(Item);
 
+        private InputManager inputManager = null!;
+
+        public override bool CloseMenuOnClick => !inputManager.CurrentState.Keyboard.ControlPressed;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            inputManager = GetContainingInputManager();
+        }
+
         private partial class ToggleTextContainer : TextContainer
         {
             private readonly StatefulMenuItem menuItem;

From 0b61e2cd421d2bd8468fc836c23d93dfd07d429c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 12 Apr 2024 15:52:36 +0800
Subject: [PATCH 736/930] Use closest origin along with closest anchor

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs    |  2 +-
 .../SkinEditor/SkinSelectionHandler.cs        | 35 ++++++++++++-------
 2 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index 690c6b35e3..5bf28ae79b 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -457,7 +457,7 @@ namespace osu.Game.Overlays.SkinEditor
             }
 
             SelectedComponents.Add(component);
-            SkinSelectionHandler.ApplyClosestAnchor(drawableComponent);
+            SkinSelectionHandler.ApplyClosestAnchorOrigin(drawableComponent);
             return true;
         }
 
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index cf6fb60636..f41bad4716 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -204,15 +204,20 @@ namespace osu.Game.Overlays.SkinEditor
 
                 drawable.Position += drawable.ScreenSpaceDeltaToParentSpace(moveEvent.ScreenSpaceDelta);
 
-                if (item.UsesFixedAnchor) continue;
-
-                ApplyClosestAnchor(drawable);
+                if (!item.UsesFixedAnchor)
+                    ApplyClosestAnchorOrigin(drawable);
             }
 
             return true;
         }
 
-        public static void ApplyClosestAnchor(Drawable drawable) => applyAnchor(drawable, getClosestAnchor(drawable));
+        public static void ApplyClosestAnchorOrigin(Drawable drawable)
+        {
+            var closest = getClosestAnchor(drawable);
+
+            applyAnchor(drawable, closest);
+            applyOrigin(drawable, closest);
+        }
 
         protected override void OnSelectionChanged()
         {
@@ -325,15 +330,10 @@ namespace osu.Game.Overlays.SkinEditor
             {
                 var drawable = (Drawable)item;
 
-                if (origin == drawable.Origin) continue;
+                applyOrigin(drawable, origin);
 
-                var previousOrigin = drawable.OriginPosition;
-                drawable.Origin = origin;
-                drawable.Position += drawable.OriginPosition - previousOrigin;
-
-                if (item.UsesFixedAnchor) continue;
-
-                ApplyClosestAnchor(drawable);
+                if (item.UsesFixedAnchor)
+                    ApplyClosestAnchorOrigin(drawable);
             }
 
             OnOperationEnded();
@@ -368,7 +368,7 @@ namespace osu.Game.Overlays.SkinEditor
             foreach (var item in SelectedItems)
             {
                 item.UsesFixedAnchor = false;
-                ApplyClosestAnchor((Drawable)item);
+                ApplyClosestAnchorOrigin((Drawable)item);
             }
 
             OnOperationEnded();
@@ -414,6 +414,15 @@ namespace osu.Game.Overlays.SkinEditor
             drawable.Position -= drawable.AnchorPosition - previousAnchor;
         }
 
+        private static void applyOrigin(Drawable drawable, Anchor origin)
+        {
+            if (origin == drawable.Origin) return;
+
+            var previousOrigin = drawable.OriginPosition;
+            drawable.Origin = origin;
+            drawable.Position += drawable.OriginPosition - previousOrigin;
+        }
+
         private static void adjustScaleFromAnchor(ref Vector2 scale, Anchor reference)
         {
             // cancel out scale in axes we don't care about (based on which drag handle was used).

From e7ca02ffde25da718116566947f8d7b09e7ba961 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 May 2024 13:28:33 +0800
Subject: [PATCH 737/930] Fix position changing when origin updates during a
 drag

---
 osu.Game/Overlays/SkinEditor/SkinBlueprint.cs        | 4 +++-
 osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs | 6 +++---
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinBlueprint.cs b/osu.Game/Overlays/SkinEditor/SkinBlueprint.cs
index 8f8d899fad..6b59d940cc 100644
--- a/osu.Game/Overlays/SkinEditor/SkinBlueprint.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinBlueprint.cs
@@ -40,7 +40,9 @@ namespace osu.Game.Overlays.SkinEditor
 
         public override bool Contains(Vector2 screenSpacePos) => drawableQuad.Contains(screenSpacePos);
 
-        public override Vector2 ScreenSpaceSelectionPoint => drawable.ToScreenSpace(drawable.OriginPosition);
+        public override Vector2 ScreenSpaceSelectionPoint =>
+            // Important to use a stable position (not based on origin) as origin may be automatically updated during drag operations.
+            drawable.ScreenSpaceDrawQuad.Centre;
 
         protected override bool ReceivePositionalInputAtSubTree(Vector2 screenSpacePos) =>
             drawableQuad.Contains(screenSpacePos);
diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index f41bad4716..680cc02311 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -202,10 +202,10 @@ namespace osu.Game.Overlays.SkinEditor
                 var item = c.Item;
                 Drawable drawable = (Drawable)item;
 
-                drawable.Position += drawable.ScreenSpaceDeltaToParentSpace(moveEvent.ScreenSpaceDelta);
-
                 if (!item.UsesFixedAnchor)
                     ApplyClosestAnchorOrigin(drawable);
+
+                drawable.Position += drawable.ScreenSpaceDeltaToParentSpace(moveEvent.ScreenSpaceDelta);
             }
 
             return true;
@@ -332,7 +332,7 @@ namespace osu.Game.Overlays.SkinEditor
 
                 applyOrigin(drawable, origin);
 
-                if (item.UsesFixedAnchor)
+                if (!item.UsesFixedAnchor)
                     ApplyClosestAnchorOrigin(drawable);
             }
 

From 2cb367fdce2a04181bb71e0c2545e07ae975f6e0 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 4 May 2024 13:29:05 +0800
Subject: [PATCH 738/930] Disable "origin" menu when in "Closest" placement
 mode

---
 .../Overlays/SkinEditor/SkinSelectionHandler.cs     | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index 680cc02311..8b9e6436b1 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -23,6 +23,8 @@ namespace osu.Game.Overlays.SkinEditor
 {
     public partial class SkinSelectionHandler : SelectionHandler<ISerialisableDrawable>
     {
+        private OsuMenuItem originMenu = null!;
+
         [Resolved]
         private SkinEditor skinEditor { get; set; } = null!;
 
@@ -248,10 +250,15 @@ namespace osu.Game.Overlays.SkinEditor
                         .ToArray()
             };
 
-            yield return new OsuMenuItem("Origin")
+            yield return originMenu = new OsuMenuItem("Origin");
+
+            closestItem.State.BindValueChanged(s =>
             {
-                Items = createAnchorItems((d, o) => ((Drawable)d).Origin == o, applyOrigins).ToArray()
-            };
+                // For UX simplicity, origin should only be user-editable when "closest" anchor mode is disabled.
+                originMenu.Items = s.NewValue == TernaryState.True
+                    ? Array.Empty<MenuItem>()
+                    : createAnchorItems((d, o) => ((Drawable)d).Origin == o, applyOrigins).ToArray();
+            }, true);
 
             yield return new OsuMenuItemSpacer();
 

From b35f2c99e64e67b21fea9c272de843c9aa41c51d Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Sat, 4 May 2024 18:43:04 +0800
Subject: [PATCH 739/930] add failed test

---
 .../UserInterface/TestSceneModPresetPanel.cs  | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
index c79cbd3691..d0303b3849 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
@@ -123,6 +123,34 @@ namespace osu.Game.Tests.Visual.UserInterface
             assertSelectedModsEquivalentTo(new Mod[] { new OsuModTouchDevice(), new OsuModHardRock(), new OsuModDoubleTime { SpeedChange = { Value = 1.5 } } });
         }
 
+        [Test]
+        public void TestActivatingPresetWithAutoplayWhenSystemModEnabled()
+        {
+            ModPresetPanel? panel = null;
+
+            AddStep("create panel", () => Child = panel = new ModPresetPanel(new ModPreset
+            {
+                Name = "Autoplay include",
+                Description = "no way",
+                Mods = new Mod[]
+                {
+                    new OsuModAutoplay()
+                },
+                Ruleset = new OsuRuleset().RulesetInfo
+            }.ToLiveUnmanaged())
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                Width = 0.5f
+            });
+
+            AddStep("Add touch device to selected mod", () => SelectedMods.Value = new Mod[] { new OsuModTouchDevice() });
+            AddStep("activate panel", () => panel.AsNonNull().TriggerClick());
+
+            // touch device should be removed due to incompatible with autoplay.
+            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutoplay() });
+        }
+
         private void assertSelectedModsEquivalentTo(IEnumerable<Mod> mods)
             => AddAssert("selected mods changed correctly", () => new HashSet<Mod>(SelectedMods.Value).SetEquals(mods));
 

From f9be9ed479555a355be8bc3673540ce312fbf39e Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Sat, 4 May 2024 18:44:47 +0800
Subject: [PATCH 740/930] remove incompatible system mods before enable preset

---
 osu.Game/Overlays/Mods/ModPresetPanel.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModPresetPanel.cs b/osu.Game/Overlays/Mods/ModPresetPanel.cs
index 3982abeba7..ca7e64957f 100644
--- a/osu.Game/Overlays/Mods/ModPresetPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPresetPanel.cs
@@ -55,7 +55,8 @@ namespace osu.Game.Overlays.Mods
 
         protected override void Select()
         {
-            var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System);
+            var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System
+                                                                     && !mod.IncompatibleMods.Any(t => Preset.Value.Mods.Any(m => m.GetType() == t)));
             // will also have the side effect of activating the preset (see `updateActiveState()`).
             selectedMods.Value = Preset.Value.Mods.Concat(selectedSystemMods).ToArray();
         }

From 6af30a3d45ef7d4a971082be060407778c148a4b Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Sat, 4 May 2024 20:02:35 +0800
Subject: [PATCH 741/930] add test for non-td system mod

---
 .../Visual/UserInterface/TestSceneModPresetPanel.cs      | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
index d0303b3849..9a141e0df0 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
@@ -149,6 +149,15 @@ namespace osu.Game.Tests.Visual.UserInterface
 
             // touch device should be removed due to incompatible with autoplay.
             assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutoplay() });
+
+            AddStep("deactivate panel", () => panel.AsNonNull().TriggerClick());
+            assertSelectedModsEquivalentTo(Array.Empty<Mod>());
+
+            // just for test purpose
+            AddStep("Add score v2 to selected mod", () => SelectedMods.Value = new Mod[] { new ModScoreV2() });
+            AddStep("activate panel", () => panel.AsNonNull().TriggerClick());
+
+            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutoplay(), new ModScoreV2() });
         }
 
         private void assertSelectedModsEquivalentTo(IEnumerable<Mod> mods)

From fe30ca3d397b774eb8ab8eafe576a5d42b383b83 Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Sat, 4 May 2024 20:11:59 +0800
Subject: [PATCH 742/930] fix linq logic

---
 osu.Game/Overlays/Mods/ModPresetPanel.cs | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModPresetPanel.cs b/osu.Game/Overlays/Mods/ModPresetPanel.cs
index ca7e64957f..9f5dda4a75 100644
--- a/osu.Game/Overlays/Mods/ModPresetPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPresetPanel.cs
@@ -55,8 +55,10 @@ namespace osu.Game.Overlays.Mods
 
         protected override void Select()
         {
-            var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System
-                                                                     && !mod.IncompatibleMods.Any(t => Preset.Value.Mods.Any(m => m.GetType() == t)));
+            var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System &&
+                                                                     !mod.IncompatibleMods.Any(t => Preset.Value.Mods.Any(t.IsInstanceOfType)));
+
+
             // will also have the side effect of activating the preset (see `updateActiveState()`).
             selectedMods.Value = Preset.Value.Mods.Concat(selectedSystemMods).ToArray();
         }

From 1f92f1d19b15a652e580f0531b0a70f7a5788c94 Mon Sep 17 00:00:00 2001
From: cdwcgt <cdwcgt@cdwcgt.top>
Date: Sat, 4 May 2024 20:41:36 +0800
Subject: [PATCH 743/930] remove blank line

nt
---
 osu.Game/Overlays/Mods/ModPresetPanel.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Overlays/Mods/ModPresetPanel.cs b/osu.Game/Overlays/Mods/ModPresetPanel.cs
index 9f5dda4a75..450c684e54 100644
--- a/osu.Game/Overlays/Mods/ModPresetPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPresetPanel.cs
@@ -58,7 +58,6 @@ namespace osu.Game.Overlays.Mods
             var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System &&
                                                                      !mod.IncompatibleMods.Any(t => Preset.Value.Mods.Any(t.IsInstanceOfType)));
 
-
             // will also have the side effect of activating the preset (see `updateActiveState()`).
             selectedMods.Value = Preset.Value.Mods.Concat(selectedSystemMods).ToArray();
         }

From 21917218ce17a2f3422b1e34e4d2ea42de0cb52d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Brandst=C3=B6tter?= <jonas.brandstoetter@gmx.at>
Date: Sat, 4 May 2024 16:00:22 +0200
Subject: [PATCH 744/930] No longer keep menu open when CTRL is held

---
 .../Graphics/UserInterface/DrawableStatefulMenuItem.cs | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index d63aaf2053..000a2f9f91 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
@@ -2,9 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
-using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
-using osu.Framework.Input;
+using osu.Framework.Graphics;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
@@ -20,15 +19,8 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override TextContainer CreateTextContainer() => new ToggleTextContainer(Item);
 
-        private InputManager inputManager = null!;
-
-        public override bool CloseMenuOnClick => !inputManager.CurrentState.Keyboard.ControlPressed;
-
-        protected override void LoadComplete()
         {
-            base.LoadComplete();
 
-            inputManager = GetContainingInputManager();
         }
 
         private partial class ToggleTextContainer : TextContainer

From c62952ea3afd2d81ba3f703491525c5249b79cac Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Brandst=C3=B6tter?= <jonas.brandstoetter@gmx.at>
Date: Sat, 4 May 2024 16:01:31 +0200
Subject: [PATCH 745/930] Invoke the registered Action when a stateful item is
 right clicked

---
 .../Graphics/UserInterface/DrawableStatefulMenuItem.cs | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index 000a2f9f91..0c4e575621 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
@@ -4,6 +4,8 @@
 using osu.Framework.Bindables;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics;
+using osu.Framework.Input.Events;
+using osuTK.Input;
 using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
@@ -19,8 +21,16 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override TextContainer CreateTextContainer() => new ToggleTextContainer(Item);
 
+        protected override bool OnMouseDown(MouseDownEvent e)
         {
+            if (!IsActionable)
+                return true;
 
+            if (e.Button != MouseButton.Right)
+                return true;
+
+            Item.Action.Value?.Invoke();
+            return true;
         }
 
         private partial class ToggleTextContainer : TextContainer

From 78d6f24fcae2e11c1c5fe7ba148fe4dd15f4a3b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Brandst=C3=B6tter?= <jonas.brandstoetter@gmx.at>
Date: Sat, 4 May 2024 16:25:19 +0200
Subject: [PATCH 746/930] Add Test

---
 .../TestSceneStatefulMenuItem.cs              | 45 +++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs
index 88187f1808..63497040db 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneStatefulMenuItem.cs
@@ -114,6 +114,51 @@ namespace osu.Game.Tests.Visual.UserInterface
                 => AddAssert($"state is {expected}", () => state.Value == expected);
         }
 
+        [Test]
+        public void TestItemRespondsToRightClick()
+        {
+            OsuMenu menu = null;
+
+            Bindable<TernaryState> state = new Bindable<TernaryState>(TernaryState.Indeterminate);
+
+            AddStep("create menu", () =>
+            {
+                state.Value = TernaryState.Indeterminate;
+
+                Child = menu = new OsuMenu(Direction.Vertical, true)
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Items = new[]
+                    {
+                        new TernaryStateToggleMenuItem("First"),
+                        new TernaryStateToggleMenuItem("Second") { State = { BindTarget = state } },
+                        new TernaryStateToggleMenuItem("Third") { State = { Value = TernaryState.True } },
+                    }
+                };
+            });
+
+            checkState(TernaryState.Indeterminate);
+
+            click();
+            checkState(TernaryState.True);
+
+            click();
+            checkState(TernaryState.False);
+
+            AddStep("change state via bindable", () => state.Value = TernaryState.True);
+
+            void click() =>
+                AddStep("click", () =>
+                {
+                    InputManager.MoveMouseTo(menu.ScreenSpaceDrawQuad.Centre);
+                    InputManager.Click(MouseButton.Right);
+                });
+
+            void checkState(TernaryState expected)
+                => AddAssert($"state is {expected}", () => state.Value == expected);
+        }
+
         [Test]
         public void TestCustomState()
         {

From b1696db9c87d59fd047aa3b94c2b34577e68c593 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jonas=20Brandst=C3=B6tter?= <jonas.brandstoetter@gmx.at>
Date: Sat, 4 May 2024 16:32:18 +0200
Subject: [PATCH 747/930] Reorder imports with `dotnet format`

---
 osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index 0c4e575621..8ed52593a7 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
@@ -2,11 +2,11 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Bindables;
-using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
-using osuTK.Input;
 using osuTK;
+using osuTK.Input;
 
 namespace osu.Game.Graphics.UserInterface
 {

From cf313cd67f3c1a89b77edd90c94a73a5794e31d7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 May 2024 21:53:48 +0300
Subject: [PATCH 748/930] Use single path to display slider control point
 connections

---
 .../TestScenePathControlPointVisualiser.cs    | 35 ----------------
 ...Piece.cs => PathControlPointConnection.cs} | 42 +++++--------------
 .../Components/PathControlPointVisualiser.cs  | 29 +------------
 3 files changed, 11 insertions(+), 95 deletions(-)
 rename osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/{PathControlPointConnectionPiece.cs => PathControlPointConnection.cs} (51%)

diff --git a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
index 0ca30e00bc..9af028fd8c 100644
--- a/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu.Tests/Editor/TestScenePathControlPointVisualiser.cs
@@ -30,23 +30,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
             slider.ApplyDefaults(new ControlPointInfo(), new BeatmapDifficulty());
         });
 
-        [Test]
-        public void TestAddOverlappingControlPoints()
-        {
-            createVisualiser(true);
-
-            addControlPointStep(new Vector2(200));
-            addControlPointStep(new Vector2(300));
-            addControlPointStep(new Vector2(300));
-            addControlPointStep(new Vector2(500, 300));
-
-            AddAssert("last connection displayed", () =>
-            {
-                var lastConnection = visualiser.Connections.Last(c => c.ControlPoint.Position == new Vector2(300));
-                return lastConnection.DrawWidth > 50;
-            });
-        }
-
         [Test]
         public void TestPerfectCurveTooManyPoints()
         {
@@ -194,24 +177,6 @@ namespace osu.Game.Rulesets.Osu.Tests.Editor
                 addAssertPointPositionChanged(points, i);
         }
 
-        [Test]
-        public void TestStackingUpdatesConnectionPosition()
-        {
-            createVisualiser(true);
-
-            Vector2 connectionPosition;
-            addControlPointStep(connectionPosition = new Vector2(300));
-            addControlPointStep(new Vector2(600));
-
-            // Apply a big number in stacking so the person running the test can clearly see if it fails
-            AddStep("apply stacking", () => slider.StackHeightBindable.Value += 10);
-
-            AddAssert($"Connection at {connectionPosition} changed",
-                () => visualiser.Connections[0].Position,
-                () => !Is.EqualTo(connectionPosition)
-            );
-        }
-
         private void addAssertPointPositionChanged(Vector2[] points, int index)
         {
             AddAssert($"Point at {points.ElementAt(index)} changed",
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnection.cs
similarity index 51%
rename from osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
rename to osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnection.cs
index 9b3d8fc7a7..5706ed4baf 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnectionPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointConnection.cs
@@ -4,10 +4,7 @@
 #nullable disable
 
 using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Lines;
-using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Types;
 using osu.Game.Rulesets.Osu.Objects;
 using osuTK;
@@ -15,36 +12,21 @@ using osuTK;
 namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 {
     /// <summary>
-    /// A visualisation of the line between two <see cref="PathControlPointPiece{T}"/>s.
+    /// A visualisation of the lines between <see cref="PathControlPointPiece{T}"/>s.
     /// </summary>
-    /// <typeparam name="T">The type of <see cref="OsuHitObject"/> which this <see cref="PathControlPointConnectionPiece{T}"/> visualises.</typeparam>
-    public partial class PathControlPointConnectionPiece<T> : CompositeDrawable where T : OsuHitObject, IHasPath
+    /// <typeparam name="T">The type of <see cref="OsuHitObject"/> which this <see cref="PathControlPointConnection{T}"/> visualises.</typeparam>
+    public partial class PathControlPointConnection<T> : SmoothPath where T : OsuHitObject, IHasPath
     {
-        public readonly PathControlPoint ControlPoint;
-
-        private readonly Path path;
         private readonly T hitObject;
-        public int ControlPointIndex { get; set; }
 
         private IBindable<Vector2> hitObjectPosition;
         private IBindable<int> pathVersion;
         private IBindable<int> stackHeight;
 
-        public PathControlPointConnectionPiece(T hitObject, int controlPointIndex)
+        public PathControlPointConnection(T hitObject)
         {
             this.hitObject = hitObject;
-            ControlPointIndex = controlPointIndex;
-
-            Origin = Anchor.Centre;
-            AutoSizeAxes = Axes.Both;
-
-            ControlPoint = hitObject.Path.ControlPoints[controlPointIndex];
-
-            InternalChild = path = new SmoothPath
-            {
-                Anchor = Anchor.Centre,
-                PathRadius = 1
-            };
+            PathRadius = 1;
         }
 
         protected override void LoadComplete()
@@ -68,18 +50,14 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         /// </summary>
         private void updateConnectingPath()
         {
-            Position = hitObject.StackedPosition + ControlPoint.Position;
+            Position = hitObject.StackedPosition;
 
-            path.ClearVertices();
+            ClearVertices();
 
-            int nextIndex = ControlPointIndex + 1;
-            if (nextIndex == 0 || nextIndex >= hitObject.Path.ControlPoints.Count)
-                return;
+            foreach (var controlPoint in hitObject.Path.ControlPoints)
+                AddVertex(controlPoint.Position);
 
-            path.AddVertex(Vector2.Zero);
-            path.AddVertex(hitObject.Path.ControlPoints[nextIndex].Position - ControlPoint.Position);
-
-            path.OriginPosition = path.PositionInBoundingBox(Vector2.Zero);
+            OriginPosition = PositionInBoundingBox(Vector2.Zero);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index b2d1709531..7212de322d 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -37,7 +37,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => true; // allow context menu to appear outside of the playfield.
 
         internal readonly Container<PathControlPointPiece<T>> Pieces;
-        internal readonly Container<PathControlPointConnectionPiece<T>> Connections;
 
         private readonly IBindableList<PathControlPoint> controlPoints = new BindableList<PathControlPoint>();
         private readonly T hitObject;
@@ -63,7 +62,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
             InternalChildren = new Drawable[]
             {
-                Connections = new Container<PathControlPointConnectionPiece<T>> { RelativeSizeAxes = Axes.Both },
+                new PathControlPointConnection<T>(hitObject),
                 Pieces = new Container<PathControlPointPiece<T>> { RelativeSizeAxes = Axes.Both }
             };
         }
@@ -185,17 +184,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 case NotifyCollectionChangedAction.Add:
                     Debug.Assert(e.NewItems != null);
 
-                    // If inserting in the path (not appending),
-                    // update indices of existing connections after insert location
-                    if (e.NewStartingIndex < Pieces.Count)
-                    {
-                        foreach (var connection in Connections)
-                        {
-                            if (connection.ControlPointIndex >= e.NewStartingIndex)
-                                connection.ControlPointIndex += e.NewItems.Count;
-                        }
-                    }
-
                     for (int i = 0; i < e.NewItems.Count; i++)
                     {
                         var point = (PathControlPoint)e.NewItems[i];
@@ -209,8 +197,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                             d.DragInProgress = DragInProgress;
                             d.DragEnded = DragEnded;
                         }));
-
-                        Connections.Add(new PathControlPointConnectionPiece<T>(hitObject, e.NewStartingIndex + i));
                     }
 
                     break;
@@ -222,19 +208,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                     {
                         foreach (var piece in Pieces.Where(p => p.ControlPoint == point).ToArray())
                             piece.RemoveAndDisposeImmediately();
-                        foreach (var connection in Connections.Where(c => c.ControlPoint == point).ToArray())
-                            connection.RemoveAndDisposeImmediately();
-                    }
-
-                    // If removing before the end of the path,
-                    // update indices of connections after remove location
-                    if (e.OldStartingIndex < Pieces.Count)
-                    {
-                        foreach (var connection in Connections)
-                        {
-                            if (connection.ControlPointIndex >= e.OldStartingIndex)
-                                connection.ControlPointIndex -= e.OldItems.Count;
-                        }
                     }
 
                     break;

From e319a3e885e9ae7d545c70a274ecad87220f62c7 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 4 May 2024 22:07:08 +0300
Subject: [PATCH 749/930] Don't perform masking updates in
 PathControlPointVisualiser

---
 .../Sliders/Components/PathControlPointVisualiser.cs           | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index 7212de322d..836d348ff4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -77,6 +77,9 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             controlPoints.BindTo(hitObject.Path.ControlPoints);
         }
 
+        // Generally all the control points are within the visible area all the time.
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => true;
+
         /// <summary>
         /// Handles correction of invalid path types.
         /// </summary>

From 9e7712740b2d881c14bb8f0872e124d95436fe0a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sun, 5 May 2024 23:32:24 +0800
Subject: [PATCH 750/930] Refactor for legibility

---
 .../Graphics/UserInterface/DrawableStatefulMenuItem.cs | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
index 8ed52593a7..686c490930 100644
--- a/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
+++ b/osu.Game/Graphics/UserInterface/DrawableStatefulMenuItem.cs
@@ -23,13 +23,11 @@ namespace osu.Game.Graphics.UserInterface
 
         protected override bool OnMouseDown(MouseDownEvent e)
         {
-            if (!IsActionable)
-                return true;
+            // Right mouse button is a special case where we allow actioning without dismissing the menu.
+            // This is achieved by not calling `Clicked` (as done by the base implementation in OnClick).
+            if (IsActionable && e.Button == MouseButton.Right)
+                Item.Action.Value?.Invoke();
 
-            if (e.Button != MouseButton.Right)
-                return true;
-
-            Item.Action.Value?.Invoke();
             return true;
         }
 

From 848e497c94d1d0a440cc74b05dfa441f19dfb40b Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 5 May 2024 21:32:25 +0300
Subject: [PATCH 751/930] Add "HP" to the abbreviations list

---
 osu.sln.DotSettings | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.sln.DotSettings b/osu.sln.DotSettings
index 51af281ac6..08eb264aab 100644
--- a/osu.sln.DotSettings
+++ b/osu.sln.DotSettings
@@ -347,6 +347,7 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=GL/@EntryIndexedValue">GL</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=GLSL/@EntryIndexedValue">GLSL</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HID/@EntryIndexedValue">HID</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HP/@EntryIndexedValue">HP</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HSL/@EntryIndexedValue">HSL</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HSPA/@EntryIndexedValue">HSPA</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HSV/@EntryIndexedValue">HSV</s:String>

From 1665c5e0e1e3e3434cd98c0f0075362b0e7ea5a5 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 5 May 2024 14:41:48 -0700
Subject: [PATCH 752/930] Use existing `AutomaticallyDownloadMissingBeatmaps`
 localisation on solo spectator screen

---
 osu.Game/Screens/Play/SoloSpectatorScreen.cs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/SoloSpectatorScreen.cs b/osu.Game/Screens/Play/SoloSpectatorScreen.cs
index 2db751402c..95eb2d4376 100644
--- a/osu.Game/Screens/Play/SoloSpectatorScreen.cs
+++ b/osu.Game/Screens/Play/SoloSpectatorScreen.cs
@@ -16,6 +16,7 @@ using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics.UserInterfaceV2;
+using osu.Game.Localisation;
 using osu.Game.Online.API;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -138,7 +139,7 @@ namespace osu.Game.Screens.Play
                             },
                             automaticDownload = new SettingsCheckbox
                             {
-                                LabelText = "Automatically download beatmaps",
+                                LabelText = OnlineSettingsStrings.AutomaticallyDownloadMissingBeatmaps,
                                 Current = config.GetBindable<bool>(OsuSetting.AutomaticallyDownloadMissingBeatmaps),
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,

From eb92e8de370d5fff1407c64527b3760d6b63ac82 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 5 May 2024 15:15:14 -0700
Subject: [PATCH 753/930] Edit title/artist unicode values and add unicode
 toggle in test

---
 .../UserInterface/TestSceneNowPlayingOverlay.cs     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
index 1670741cbd..d84089fb6f 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneNowPlayingOverlay.cs
@@ -5,6 +5,7 @@
 
 using NUnit.Framework;
 using osu.Framework.Allocation;
+using osu.Framework.Configuration;
 using osu.Framework.Graphics;
 using osu.Game.Beatmaps;
 using osu.Game.Overlays;
@@ -21,8 +22,10 @@ namespace osu.Game.Tests.Visual.UserInterface
         private NowPlayingOverlay nowPlayingOverlay;
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(FrameworkConfigManager frameworkConfig)
         {
+            AddToggleStep("toggle unicode", v => frameworkConfig.SetValue(FrameworkSetting.ShowUnicode, v));
+
             nowPlayingOverlay = new NowPlayingOverlay
             {
                 Origin = Anchor.Centre,
@@ -50,9 +53,9 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Metadata =
                 {
                     Artist = "very very very very very very very very very very verry long artist",
-                    ArtistUnicode = "very very very very very very very very very very verry long artist",
+                    ArtistUnicode = "very very very very very very very very very very verry long artist unicode",
                     Title = "very very very very very verry long title",
-                    TitleUnicode = "very very very very very verry long title",
+                    TitleUnicode = "very very very very very verry long title unicode",
                 }
             }));
 
@@ -61,9 +64,9 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Metadata =
                 {
                     Artist = "very very very very very very very very very very verrry long artist",
-                    ArtistUnicode = "very very very very very very very very very very verrry long artist",
+                    ArtistUnicode = "not very long artist unicode",
                     Title = "very very very very very verrry long title",
-                    TitleUnicode = "very very very very very verrry long title",
+                    TitleUnicode = "not very long title unicode",
                 }
             }));
 

From 359238395f273686b611ac87f5ae1ceef1072a04 Mon Sep 17 00:00:00 2001
From: Joseph Madamba <madamba.joehu@outlook.com>
Date: Sun, 5 May 2024 15:17:03 -0700
Subject: [PATCH 754/930] Fix now playing overlay text scroll breaking when
 toggling metadata language setting

---
 osu.Game/Overlays/NowPlayingOverlay.cs | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/osu.Game/Overlays/NowPlayingOverlay.cs b/osu.Game/Overlays/NowPlayingOverlay.cs
index 29052ace8e..76c8c237d5 100644
--- a/osu.Game/Overlays/NowPlayingOverlay.cs
+++ b/osu.Game/Overlays/NowPlayingOverlay.cs
@@ -5,6 +5,7 @@ using System;
 using System.Threading;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
+using osu.Framework.Configuration;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
@@ -479,6 +480,11 @@ namespace osu.Game.Overlays
             private OsuSpriteText mainSpriteText = null!;
             private OsuSpriteText fillerSpriteText = null!;
 
+            private Bindable<bool> showUnicode = null!;
+
+            [Resolved]
+            private FrameworkConfigManager frameworkConfig { get; set; } = null!;
+
             private LocalisableString text;
 
             public LocalisableString Text
@@ -531,6 +537,9 @@ namespace osu.Game.Overlays
             {
                 base.LoadComplete();
 
+                showUnicode = frameworkConfig.GetBindable<bool>(FrameworkSetting.ShowUnicode);
+                showUnicode.BindValueChanged(_ => updateText());
+
                 updateFontAndText();
             }
 

From 12cd3bbe1c79d7f2134ed79f03cb1e8005086d99 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 May 2024 11:34:37 +0800
Subject: [PATCH 755/930] Fix incorrect scale handling due to selection point
 changes

---
 osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index 8b9e6436b1..75bb77fa73 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -139,7 +139,7 @@ namespace osu.Game.Overlays.SkinEditor
                 var drawableItem = (Drawable)b.Item;
 
                 // each drawable's relative position should be maintained in the scaled quad.
-                var screenPosition = b.ScreenSpaceSelectionPoint;
+                var screenPosition = drawableItem.ToScreenSpace(drawableItem.OriginPosition);
 
                 var relativePositionInOriginal =
                     new Vector2(

From 4c7e6b125cdc889b12039b8b4048ab09afc963b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 08:49:30 +0200
Subject: [PATCH 756/930] Add clarification comment

---
 osu.Game/Overlays/Mods/ModPresetPanel.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModPresetPanel.cs b/osu.Game/Overlays/Mods/ModPresetPanel.cs
index 450c684e54..568ca5ecc9 100644
--- a/osu.Game/Overlays/Mods/ModPresetPanel.cs
+++ b/osu.Game/Overlays/Mods/ModPresetPanel.cs
@@ -55,6 +55,9 @@ namespace osu.Game.Overlays.Mods
 
         protected override void Select()
         {
+            // this implicitly presumes that if a system mod declares incompatibility with a non-system mod,
+            // the non-system mod should take precedence.
+            // if this assumption is ever broken, this should be reconsidered.
             var selectedSystemMods = selectedMods.Value.Where(mod => mod.Type == ModType.System &&
                                                                      !mod.IncompatibleMods.Any(t => Preset.Value.Mods.Any(t.IsInstanceOfType)));
 

From cb4af794161d325143e4ba4421774f746137b51f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 08:53:41 +0200
Subject: [PATCH 757/930] Touch up test case

---
 .../UserInterface/TestSceneModPresetPanel.cs     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
index 9a141e0df0..f87d8e0d2b 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModPresetPanel.cs
@@ -124,17 +124,17 @@ namespace osu.Game.Tests.Visual.UserInterface
         }
 
         [Test]
-        public void TestActivatingPresetWithAutoplayWhenSystemModEnabled()
+        public void TestSystemModsNotPreservedIfIncompatibleWithPresetMods()
         {
             ModPresetPanel? panel = null;
 
             AddStep("create panel", () => Child = panel = new ModPresetPanel(new ModPreset
             {
-                Name = "Autoplay include",
+                Name = "Autopilot included",
                 Description = "no way",
                 Mods = new Mod[]
                 {
-                    new OsuModAutoplay()
+                    new OsuModAutopilot()
                 },
                 Ruleset = new OsuRuleset().RulesetInfo
             }.ToLiveUnmanaged())
@@ -144,20 +144,20 @@ namespace osu.Game.Tests.Visual.UserInterface
                 Width = 0.5f
             });
 
-            AddStep("Add touch device to selected mod", () => SelectedMods.Value = new Mod[] { new OsuModTouchDevice() });
+            AddStep("Add touch device to selected mods", () => SelectedMods.Value = new Mod[] { new OsuModTouchDevice() });
             AddStep("activate panel", () => panel.AsNonNull().TriggerClick());
 
-            // touch device should be removed due to incompatible with autoplay.
-            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutoplay() });
+            // touch device should be removed due to incompatibility with autopilot.
+            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutopilot() });
 
             AddStep("deactivate panel", () => panel.AsNonNull().TriggerClick());
             assertSelectedModsEquivalentTo(Array.Empty<Mod>());
 
-            // just for test purpose
+            // just for test purposes, can't/shouldn't happen in reality
             AddStep("Add score v2 to selected mod", () => SelectedMods.Value = new Mod[] { new ModScoreV2() });
             AddStep("activate panel", () => panel.AsNonNull().TriggerClick());
 
-            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutoplay(), new ModScoreV2() });
+            assertSelectedModsEquivalentTo(new Mod[] { new OsuModAutopilot(), new ModScoreV2() });
         }
 
         private void assertSelectedModsEquivalentTo(IEnumerable<Mod> mods)

From cf87e9cd40008cedba6f0e183f5c07bf0978643f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 11:22:56 +0200
Subject: [PATCH 758/930] Do not show integration settings on mobile

Closes https://github.com/ppy/osu/issues/28097.

The settings weren't actually doing anything at all there anyway.
---
 osu.Game/Overlays/Settings/Sections/OnlineSection.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/Settings/Sections/OnlineSection.cs b/osu.Game/Overlays/Settings/Sections/OnlineSection.cs
index 1484f2c756..6593eb69fa 100644
--- a/osu.Game/Overlays/Settings/Sections/OnlineSection.cs
+++ b/osu.Game/Overlays/Settings/Sections/OnlineSection.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using osu.Framework;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Localisation;
@@ -25,8 +26,10 @@ namespace osu.Game.Overlays.Settings.Sections
             {
                 new WebSettings(),
                 new AlertsAndPrivacySettings(),
-                new IntegrationSettings()
             };
+
+            if (RuntimeInfo.IsDesktop)
+                Add(new IntegrationSettings());
         }
     }
 }

From f066026503b4f50377fe3eca5ee55f1261ff00f2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 11:55:49 +0200
Subject: [PATCH 759/930] Fix sizing of gameplay preview in skin editor not
 updating on scaling mode change

Closes https://github.com/ppy/osu/issues/28115.
---
 osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs b/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
index 2f4820e207..748e9c6c0b 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Primitives;
 using osu.Framework.Input;
 using osu.Framework.Input.Bindings;
 using osu.Framework.Input.Events;
+using osu.Framework.Layout;
 using osu.Framework.Screens;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
@@ -30,7 +31,6 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Select;
 using osu.Game.Users;
 using osu.Game.Utils;
-using osuTK;
 
 namespace osu.Game.Overlays.SkinEditor
 {
@@ -70,12 +70,14 @@ namespace osu.Game.Overlays.SkinEditor
         private OsuScreen? lastTargetScreen;
         private InvokeOnDisposal? nestedInputManagerDisable;
 
-        private Vector2 lastDrawSize;
+        private LayoutValue drawSizeLayout;
 
         public SkinEditorOverlay(ScalingContainer scalingContainer)
         {
             this.scalingContainer = scalingContainer;
             RelativeSizeAxes = Axes.Both;
+
+            AddLayout(drawSizeLayout = new LayoutValue(Invalidation.DrawSize));
         }
 
         [BackgroundDependencyLoader]
@@ -199,10 +201,10 @@ namespace osu.Game.Overlays.SkinEditor
         {
             base.Update();
 
-            if (game.DrawSize != lastDrawSize)
+            if (!drawSizeLayout.IsValid)
             {
-                lastDrawSize = game.DrawSize;
                 updateScreenSizing();
+                drawSizeLayout.Validate();
             }
         }
 

From 353a07f7a5fa4a24c3d91b545defda6f8128efe0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 12:23:11 +0200
Subject: [PATCH 760/930] Fix code quality inspection

---
 osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs b/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
index 748e9c6c0b..571f99bd08 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditorOverlay.cs
@@ -70,7 +70,7 @@ namespace osu.Game.Overlays.SkinEditor
         private OsuScreen? lastTargetScreen;
         private InvokeOnDisposal? nestedInputManagerDisable;
 
-        private LayoutValue drawSizeLayout;
+        private readonly LayoutValue drawSizeLayout;
 
         public SkinEditorOverlay(ScalingContainer scalingContainer)
         {

From 4d9ccdc3b2391463355d297387c12181f72a6fc2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 13:23:41 +0200
Subject: [PATCH 761/930] Encode user ID to replays

---
 osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
index 32c18b3af2..b71d9d916e 100644
--- a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
+++ b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
@@ -43,6 +43,9 @@ namespace osu.Game.Scoring.Legacy
         [JsonConverter(typeof(StringEnumConverter))]
         public ScoreRank? Rank;
 
+        [JsonProperty("user_id")]
+        public int UserID = -1;
+
         public static LegacyReplaySoloScoreInfo FromScore(ScoreInfo score) => new LegacyReplaySoloScoreInfo
         {
             OnlineID = score.OnlineID,
@@ -51,6 +54,7 @@ namespace osu.Game.Scoring.Legacy
             MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             ClientVersion = score.ClientVersion,
             Rank = score.Rank,
+            UserID = score.UserID,
         };
     }
 }

From 554ead0d9dd596a01bf55ab36c72f8eb346f81bf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 3 May 2024 13:34:02 +0200
Subject: [PATCH 762/930] Decode user ID from score if available

---
 .../Beatmaps/Formats/LegacyScoreDecoderTest.cs           | 9 +++++++++
 osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs            | 2 ++
 2 files changed, 11 insertions(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index 383c08c10f..cc7b37e6a8 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -14,6 +14,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO.Legacy;
+using osu.Game.Models;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
@@ -31,6 +32,7 @@ using osu.Game.Rulesets.Taiko;
 using osu.Game.Scoring;
 using osu.Game.Scoring.Legacy;
 using osu.Game.Tests.Resources;
+using osu.Game.Users;
 
 namespace osu.Game.Tests.Beatmaps.Formats
 {
@@ -224,6 +226,12 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 new OsuModDoubleTime { SpeedChange = { Value = 1.1 } }
             };
             scoreInfo.OnlineID = 123123;
+            scoreInfo.RealmUser = new RealmUser
+            {
+                Username = "spaceman_atlas",
+                OnlineID = 3035836,
+                CountryCode = CountryCode.PL
+            };
             scoreInfo.ClientVersion = "2023.1221.0";
 
             var beatmap = new TestBeatmap(ruleset);
@@ -248,6 +256,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(decodedAfterEncode.ScoreInfo.MaximumStatistics, Is.EqualTo(scoreInfo.MaximumStatistics));
                 Assert.That(decodedAfterEncode.ScoreInfo.Mods, Is.EqualTo(scoreInfo.Mods));
                 Assert.That(decodedAfterEncode.ScoreInfo.ClientVersion, Is.EqualTo("2023.1221.0"));
+                Assert.That(decodedAfterEncode.ScoreInfo.RealmUser.OnlineID, Is.EqualTo(3035836));
             });
         }
 
diff --git a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
index b0d7087ed1..00e294fdcd 100644
--- a/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
+++ b/osu.Game/Scoring/Legacy/LegacyScoreDecoder.cs
@@ -131,6 +131,8 @@ namespace osu.Game.Scoring.Legacy
                         score.ScoreInfo.Mods = readScore.Mods.Select(m => m.ToMod(currentRuleset)).ToArray();
                         score.ScoreInfo.ClientVersion = readScore.ClientVersion;
                         decodedRank = readScore.Rank;
+                        if (readScore.UserID > 1)
+                            score.ScoreInfo.RealmUser.OnlineID = readScore.UserID;
                     });
                 }
             }

From bd869b6cdcd41c3406022fb784f54fe2fdebf849 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 13:24:24 +0200
Subject: [PATCH 763/930] Add failing tests for looking up users by online ID
 if present when importing scores

---
 osu.Game.Tests/Scores/IO/ImportScoreTest.cs | 82 ++++++++++++++++++++-
 1 file changed, 79 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
index eb2c098ab8..9c72804a6b 100644
--- a/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
+++ b/osu.Game.Tests/Scores/IO/ImportScoreTest.cs
@@ -287,7 +287,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public void TestUserLookedUpForOnlineScore()
+        public void TestUserLookedUpByUsernameForOnlineScoreIfUserIDMissing()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -301,6 +301,9 @@ namespace osu.Game.Tests.Scores.IO
                         switch (req)
                         {
                             case GetUserRequest userRequest:
+                                if (userRequest.Lookup != "Test user")
+                                    return false;
+
                                 userRequest.TriggerSuccess(new APIUser
                                 {
                                     Username = "Test user",
@@ -350,7 +353,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public void TestUserLookedUpForLegacyOnlineScore()
+        public void TestUserLookedUpByUsernameForLegacyOnlineScore()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -364,6 +367,9 @@ namespace osu.Game.Tests.Scores.IO
                         switch (req)
                         {
                             case GetUserRequest userRequest:
+                                if (userRequest.Lookup != "Test user")
+                                    return false;
+
                                 userRequest.TriggerSuccess(new APIUser
                                 {
                                     Username = "Test user",
@@ -413,7 +419,7 @@ namespace osu.Game.Tests.Scores.IO
         }
 
         [Test]
-        public void TestUserNotLookedUpForOfflineScore()
+        public void TestUserNotLookedUpForOfflineScoreIfUserIDMissing()
         {
             using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
             {
@@ -427,6 +433,9 @@ namespace osu.Game.Tests.Scores.IO
                         switch (req)
                         {
                             case GetUserRequest userRequest:
+                                if (userRequest.Lookup != "Test user")
+                                    return false;
+
                                 userRequest.TriggerSuccess(new APIUser
                                 {
                                     Username = "Test user",
@@ -476,6 +485,73 @@ namespace osu.Game.Tests.Scores.IO
             }
         }
 
+        [Test]
+        public void TestUserLookedUpByOnlineIDIfPresent([Values] bool isOnlineScore)
+        {
+            using (HeadlessGameHost host = new CleanRunHeadlessGameHost())
+            {
+                try
+                {
+                    var osu = LoadOsuIntoHost(host, true);
+
+                    var api = (DummyAPIAccess)osu.API;
+                    api.HandleRequest = req =>
+                    {
+                        switch (req)
+                        {
+                            case GetUserRequest userRequest:
+                                if (userRequest.Lookup != "5555")
+                                    return false;
+
+                                userRequest.TriggerSuccess(new APIUser
+                                {
+                                    Username = "Some other guy",
+                                    CountryCode = CountryCode.DE,
+                                    Id = 5555
+                                });
+                                return true;
+
+                            default:
+                                return false;
+                        }
+                    };
+
+                    var beatmap = BeatmapImportHelper.LoadOszIntoOsu(osu, TestResources.GetQuickTestBeatmapForImport()).GetResultSafely();
+
+                    var toImport = new ScoreInfo
+                    {
+                        Rank = ScoreRank.B,
+                        TotalScore = 987654,
+                        Accuracy = 0.8,
+                        MaxCombo = 500,
+                        Combo = 250,
+                        User = new APIUser { Id = 5555 },
+                        Date = DateTimeOffset.Now,
+                        Ruleset = new OsuRuleset().RulesetInfo,
+                        BeatmapInfo = beatmap.Beatmaps.First()
+                    };
+                    if (isOnlineScore)
+                        toImport.OnlineID = 12345;
+
+                    var imported = LoadScoreIntoOsu(osu, toImport);
+
+                    Assert.AreEqual(toImport.Rank, imported.Rank);
+                    Assert.AreEqual(toImport.TotalScore, imported.TotalScore);
+                    Assert.AreEqual(toImport.Accuracy, imported.Accuracy);
+                    Assert.AreEqual(toImport.MaxCombo, imported.MaxCombo);
+                    Assert.AreEqual(toImport.Date, imported.Date);
+                    Assert.AreEqual(toImport.OnlineID, imported.OnlineID);
+                    Assert.AreEqual("Some other guy", imported.RealmUser.Username);
+                    Assert.AreEqual(5555, imported.RealmUser.OnlineID);
+                    Assert.AreEqual(CountryCode.DE, imported.RealmUser.CountryCode);
+                }
+                finally
+                {
+                    host.Exit();
+                }
+            }
+        }
+
         public static ScoreInfo LoadScoreIntoOsu(OsuGameBase osu, ScoreInfo score, ArchiveReader archive = null)
         {
             // clone to avoid attaching the input score to realm.

From abfb2c00bcaaf071b264f82e5205350ec7a5edf4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 13:24:34 +0200
Subject: [PATCH 764/930] Look up users by ID if available when importing
 scores

---
 osu.Game/Scoring/ScoreImporter.cs | 71 ++++++++++++++++++++++++++-----
 1 file changed, 61 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Scoring/ScoreImporter.cs b/osu.Game/Scoring/ScoreImporter.cs
index 4ae8e51f6d..69c53af16f 100644
--- a/osu.Game/Scoring/ScoreImporter.cs
+++ b/osu.Game/Scoring/ScoreImporter.cs
@@ -103,6 +103,14 @@ namespace osu.Game.Scoring
         }
 
         // Very naive local caching to improve performance of large score imports (where the username is usually the same for most or all scores).
+
+        // TODO: `UserLookupCache` cannot currently be used here because of async foibles.
+        // It only supports lookups by user ID (username would require web changes), and even then the ID lookups cannot be used.
+        // That is because that component provides an async interface, and async functions cannot be consumed safely here due to the rigid structure of `RealmArchiveModelImporter`.
+        // The importer has two paths, one async and one sync; the async path runs the sync path in a task.
+        // This means that sometimes `PostImport()` is called from a sync context, and sometimes from an async one, whilst itself being a sync method.
+        // That in turn makes `.GetResultSafely()` not callable inside `PostImport()`, as it will throw when called from an async context,
+        private readonly Dictionary<int, APIUser> idLookupCache = new Dictionary<int, APIUser>();
         private readonly Dictionary<string, APIUser> usernameLookupCache = new Dictionary<string, APIUser>();
 
         protected override void PostImport(ScoreInfo model, Realm realm, ImportParameters parameters)
@@ -127,24 +135,34 @@ namespace osu.Game.Scoring
             if (model.RealmUser.OnlineID == APIUser.SYSTEM_USER_ID)
                 return;
 
-            if (model.OnlineID < 0 && model.LegacyOnlineID <= 0)
-                return;
-
-            string username = model.RealmUser.Username;
-
-            if (usernameLookupCache.TryGetValue(username, out var existing))
+            if (model.RealmUser.OnlineID > 1)
             {
-                model.User = existing;
+                model.User = lookupUserById(model.RealmUser.OnlineID) ?? model.User;
                 return;
             }
 
-            var userRequest = new GetUserRequest(username);
+            if (model.OnlineID < 0 && model.LegacyOnlineID <= 0)
+                return;
+
+            model.User = lookupUserByName(model.RealmUser.Username) ?? model.User;
+        }
+
+        private APIUser? lookupUserById(int id)
+        {
+            if (idLookupCache.TryGetValue(id, out var existing))
+            {
+                return existing;
+            }
+
+            var userRequest = new GetUserRequest(id);
 
             api.Perform(userRequest);
 
             if (userRequest.Response is APIUser user)
             {
-                usernameLookupCache.TryAdd(username, new APIUser
+                APIUser cachedUser;
+
+                idLookupCache.TryAdd(id, cachedUser = new APIUser
                 {
                     // Because this is a permanent cache, let's only store the pieces we're interested in,
                     // rather than the full API response. If we start to store more than these three fields
@@ -154,8 +172,41 @@ namespace osu.Game.Scoring
                     CountryCode = user.CountryCode,
                 });
 
-                model.User = user;
+                return cachedUser;
             }
+
+            return null;
+        }
+
+        private APIUser? lookupUserByName(string username)
+        {
+            if (usernameLookupCache.TryGetValue(username, out var existing))
+            {
+                return existing;
+            }
+
+            var userRequest = new GetUserRequest(username);
+
+            api.Perform(userRequest);
+
+            if (userRequest.Response is APIUser user)
+            {
+                APIUser cachedUser;
+
+                usernameLookupCache.TryAdd(username, cachedUser = new APIUser
+                {
+                    // Because this is a permanent cache, let's only store the pieces we're interested in,
+                    // rather than the full API response. If we start to store more than these three fields
+                    // in realm, this should be undone.
+                    Id = user.Id,
+                    Username = user.Username,
+                    CountryCode = user.CountryCode,
+                });
+
+                return cachedUser;
+            }
+
+            return null;
         }
     }
 }

From 9c6968c13a2c6a1a0392649dddd1c0cfb7828f1a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 6 May 2024 16:29:03 +0200
Subject: [PATCH 765/930] Use `score.User.OnlineID` instead of `score.UserID`

You'd hope that they'd be the same thing, but
post-https://github.com/ppy/osu-server-spectator/pull/230 it turns out
that cannot be guaranteed, so just attempt to use `User` in the encoder
consistently everywhere...
---
 osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
index b71d9d916e..60bec687f4 100644
--- a/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
+++ b/osu.Game/Scoring/Legacy/LegacyReplaySoloScoreInfo.cs
@@ -54,7 +54,7 @@ namespace osu.Game.Scoring.Legacy
             MaximumStatistics = score.MaximumStatistics.Where(kvp => kvp.Value != 0).ToDictionary(),
             ClientVersion = score.ClientVersion,
             Rank = score.Rank,
-            UserID = score.UserID,
+            UserID = score.User.OnlineID,
         };
     }
 }

From a694f4625309667534c4a76e794ce0728c4b5b7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erik=20Wolfschl=C3=A4ger?= <e.wolfschlaeger@gmail.com>
Date: Mon, 6 May 2024 18:10:58 +0200
Subject: [PATCH 766/930] Add new localisable strings

---
 .../DeleteConfirmationContentStrings.cs       | 47 +++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 osu.Game/Localisation/DeleteConfirmationContentStrings.cs

diff --git a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
new file mode 100644
index 0000000000..26b7133456
--- /dev/null
+++ b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
@@ -0,0 +1,47 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class DeleteConfirmationContentStrings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.DeleteConfirmationContent";
+
+        /// <summary>
+        /// "All beatmaps?"
+        /// </summary>
+        public static LocalisableString Beatmaps => new TranslatableString(getKey(@"beatmaps"), @"All beatmaps?");
+
+        /// <summary>
+        /// "All beatmaps videos? This cannot be undone!"
+        /// </summary>
+        public static LocalisableString BeatmapVideos => new TranslatableString(getKey(@"beatmap_videos"), @"All beatmaps videos? This cannot be undone!");
+
+        /// <summary>
+        /// "All skins? This cannot be undone!"
+        /// </summary>
+        public static LocalisableString Skins => new TranslatableString(getKey(@"skins"), @"All skins? This cannot be undone!");
+
+        /// <summary>
+        /// "All collections? This cannot be undone!"
+        /// </summary>
+        public static LocalisableString Collections => new TranslatableString(getKey(@"collections"), @"All collections? This cannot be undone!");
+
+        /// <summary>
+        /// "All scores? This cannot be undone!"
+        /// </summary>
+        public static LocalisableString Scores => new TranslatableString(getKey(@"collections"), @"All scores? This cannot be undone!");
+
+        /// <summary>
+        /// "All mod presets?"
+        /// </summary>
+        public static LocalisableString ModPresets => new TranslatableString(getKey(@"mod_presets"), @"All mod presets?");
+
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+
+    }
+}

From 32444e0e30f10e4baadc6aac971c2f66f0bfbce1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erik=20Wolfschl=C3=A4ger?= <e.wolfschlaeger@gmail.com>
Date: Mon, 6 May 2024 18:11:40 +0200
Subject: [PATCH 767/930] Make deletion confirmation content less confusing

---
 .../Sections/Maintenance/BeatmapSettings.cs      |  6 +++---
 .../Sections/Maintenance/CollectionsSettings.cs  |  2 +-
 .../Maintenance/MassDeleteConfirmationDialog.cs  |  5 +++--
 .../MassVideoDeleteConfirmationDialog.cs         | 16 ----------------
 .../Sections/Maintenance/ModPresetSettings.cs    |  2 +-
 .../Sections/Maintenance/ScoreSettings.cs        |  2 +-
 .../Sections/Maintenance/SkinSettings.cs         |  2 +-
 7 files changed, 10 insertions(+), 25 deletions(-)
 delete mode 100644 osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs

diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/BeatmapSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/BeatmapSettings.cs
index 4b1836ed86..d0a8fc7d2c 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/BeatmapSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/BeatmapSettings.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     {
                         deleteBeatmapsButton.Enabled.Value = false;
                         Task.Run(() => beatmaps.Delete()).ContinueWith(_ => Schedule(() => deleteBeatmapsButton.Enabled.Value = true));
-                    }));
+                    }, DeleteConfirmationContentStrings.Beatmaps));
                 }
             });
 
@@ -40,11 +40,11 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 Text = MaintenanceSettingsStrings.DeleteAllBeatmapVideos,
                 Action = () =>
                 {
-                    dialogOverlay?.Push(new MassVideoDeleteConfirmationDialog(() =>
+                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(() =>
                     {
                         deleteBeatmapVideosButton.Enabled.Value = false;
                         Task.Run(beatmaps.DeleteAllVideos).ContinueWith(_ => Schedule(() => deleteBeatmapVideosButton.Enabled.Value = true));
-                    }));
+                    }, DeleteConfirmationContentStrings.BeatmapVideos));
                 }
             });
             AddRange(new Drawable[]
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
index b373535a8b..b1c44aa93c 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/CollectionsSettings.cs
@@ -29,7 +29,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                 Text = MaintenanceSettingsStrings.DeleteAllCollections,
                 Action = () =>
                 {
-                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(deleteAllCollections));
+                    dialogOverlay?.Push(new MassDeleteConfirmationDialog(deleteAllCollections, DeleteConfirmationContentStrings.Collections));
                 }
             });
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
index 99ef62d94b..7ead815fe9 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/MassDeleteConfirmationDialog.cs
@@ -2,15 +2,16 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using osu.Framework.Localisation;
 using osu.Game.Overlays.Dialog;
 
 namespace osu.Game.Overlays.Settings.Sections.Maintenance
 {
     public partial class MassDeleteConfirmationDialog : DangerousActionDialog
     {
-        public MassDeleteConfirmationDialog(Action deleteAction)
+        public MassDeleteConfirmationDialog(Action deleteAction, LocalisableString deleteContent)
         {
-            BodyText = "Everything?";
+            BodyText = deleteContent;
             DangerousAction = deleteAction;
         }
     }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
deleted file mode 100644
index 6312e09b3e..0000000000
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/MassVideoDeleteConfirmationDialog.cs
+++ /dev/null
@@ -1,16 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using System;
-
-namespace osu.Game.Overlays.Settings.Sections.Maintenance
-{
-    public partial class MassVideoDeleteConfirmationDialog : MassDeleteConfirmationDialog
-    {
-        public MassVideoDeleteConfirmationDialog(Action deleteAction)
-            : base(deleteAction)
-        {
-            BodyText = "All beatmap videos? This cannot be undone!";
-        }
-    }
-}
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
index f0d6d10e51..9c55308abe 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/ModPresetSettings.cs
@@ -42,7 +42,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                         {
                             deleteAllButton.Enabled.Value = false;
                             Task.Run(deleteAllModPresets).ContinueWith(t => Schedule(onAllModPresetsDeleted, t));
-                        }));
+                        }, DeleteConfirmationContentStrings.ModPresets));
                     }
                 },
                 undeleteButton = new SettingsButton
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/ScoreSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/ScoreSettings.cs
index c6f4f1e1a5..235f239c7c 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/ScoreSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/ScoreSettings.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     {
                         deleteScoresButton.Enabled.Value = false;
                         Task.Run(() => scores.Delete()).ContinueWith(_ => Schedule(() => deleteScoresButton.Enabled.Value = true));
-                    }));
+                    }, DeleteConfirmationContentStrings.Scores));
                 }
             });
         }
diff --git a/osu.Game/Overlays/Settings/Sections/Maintenance/SkinSettings.cs b/osu.Game/Overlays/Settings/Sections/Maintenance/SkinSettings.cs
index c3ac49af6d..e962118a36 100644
--- a/osu.Game/Overlays/Settings/Sections/Maintenance/SkinSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Maintenance/SkinSettings.cs
@@ -27,7 +27,7 @@ namespace osu.Game.Overlays.Settings.Sections.Maintenance
                     {
                         deleteSkinsButton.Enabled.Value = false;
                         Task.Run(() => skins.Delete()).ContinueWith(_ => Schedule(() => deleteSkinsButton.Enabled.Value = true));
-                    }));
+                    }, DeleteConfirmationContentStrings.Skins));
                 }
             });
         }

From 12522d9ae5dc1ef36055a7698518231f8a74ebbd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erik=20Wolfschl=C3=A4ger?= <e.wolfschlaeger@gmail.com>
Date: Mon, 6 May 2024 18:29:46 +0200
Subject: [PATCH 768/930] Fix formatting issues

---
 osu.Game/Localisation/DeleteConfirmationContentStrings.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
index 26b7133456..d9e90675f7 100644
--- a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
+++ b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-
 using osu.Framework.Localisation;
 
 namespace osu.Game.Localisation
@@ -40,8 +39,6 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ModPresets => new TranslatableString(getKey(@"mod_presets"), @"All mod presets?");
 
-
         private static string getKey(string key) => $@"{prefix}:{key}";
-
     }
 }

From f824bd14414e9e37af05a9dba130c02c7aa5a62d Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Mon, 6 May 2024 21:52:03 +0200
Subject: [PATCH 769/930] Fix `userTriggered` not being passed to private
 helper

---
 osu.Game/Overlays/SkinEditor/SkinEditor.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinEditor.cs b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
index 5bf28ae79b..67fd6a9550 100644
--- a/osu.Game/Overlays/SkinEditor/SkinEditor.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinEditor.cs
@@ -540,7 +540,7 @@ namespace osu.Game.Overlays.SkinEditor
 
         protected void Redo() => changeHandler?.RestoreState(1);
 
-        public void Save(bool userTriggered = true) => save(currentSkin.Value);
+        public void Save(bool userTriggered = true) => save(currentSkin.Value, userTriggered);
 
         private void save(Skin skin, bool userTriggered = true)
         {

From 91c684151a740005e24c3c52ff188772489b5171 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 May 2024 14:16:25 +0800
Subject: [PATCH 770/930] Update bundled beatmaps

---
 .../Drawables/BundledBeatmapDownloader.cs     | 504 +++++++++++-------
 1 file changed, 312 insertions(+), 192 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
index 21ab1b78ea..3aa34a5580 100644
--- a/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
+++ b/osu.Game/Beatmaps/Drawables/BundledBeatmapDownloader.cs
@@ -6,6 +6,7 @@
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
+using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using System.Text.RegularExpressions;
 using osu.Framework.Allocation;
@@ -21,6 +22,8 @@ using osu.Game.Utils;
 
 namespace osu.Game.Beatmaps.Drawables
 {
+    [SuppressMessage("ReSharper", "StringLiteralTypo")]
+    [SuppressMessage("ReSharper", "CommentTypo")]
     public partial class BundledBeatmapDownloader : CompositeDrawable
     {
         private readonly bool shouldPostNotifications;
@@ -50,7 +53,7 @@ namespace osu.Game.Beatmaps.Drawables
             {
                 queueDownloads(always_bundled_beatmaps);
 
-                queueDownloads(bundled_osu, 8);
+                queueDownloads(bundled_osu, 6);
                 queueDownloads(bundled_taiko, 3);
                 queueDownloads(bundled_catch, 3);
                 queueDownloads(bundled_mania, 3);
@@ -128,6 +131,26 @@ namespace osu.Game.Beatmaps.Drawables
             }
         }
 
+        /*
+         * criteria for bundled maps (managed by pishifat)
+         *
+         *  auto:
+         *  - licensed song
+         *  - includes ENHI diffs
+         *  - between 60s and 240s
+         *
+         *  manual:
+         *  - bg is explicitly permitted as okay to use. lots of artists say some variation of "it's ok for personal use/non-commercial use/with credit"
+         *    (which is prob fine when maps are presented as user-generated content), but for a new osu! player, it's easy to assume bundled maps are
+         *     commercial content like other rhythm games, so it's best to be cautious about using not-explicitly-permitted artwork.
+         *
+         *  - no ai/thirst bgs
+         *  - no controversial/explicit song content or titles
+         *  - no repeating bundled songs (within each mode)
+         *  - no songs that are relatively low production value
+         *  - no songs with limited accessibility (annoying high pitch vocals, noise rock, etc)
+         */
+
         private const string tutorial_filename = "1011011 nekodex - new beginnings.osz";
 
         /// <summary>
@@ -135,215 +158,312 @@ namespace osu.Game.Beatmaps.Drawables
         /// </summary>
         private static readonly string[] always_bundled_beatmaps =
         {
-            // This thing is 40mb, I'm not sure we want it here...
+            // winner of https://osu.ppy.sh/home/news/2013-09-06-osu-monthly-beatmapping-contest-1
+            @"123593 Rostik - Liquid (Paul Rosenthal Remix).osz",
+            // winner of https://osu.ppy.sh/home/news/2013-10-28-monthly-beatmapping-contest-2-submissions-open
+            @"140662 cYsmix feat. Emmy - Tear Rain.osz",
+            // winner of https://osu.ppy.sh/home/news/2013-12-15-monthly-beatmapping-contest-3-submissions-open
+            @"151878 Chasers - Lost.osz",
+            // winner of https://osu.ppy.sh/home/news/2014-02-14-monthly-beatmapping-contest-4-submissions-now
+            @"163112 Kuba Oms - My Love.osz",
+            // winner of https://osu.ppy.sh/home/news/2014-05-07-monthly-beatmapping-contest-5-submissions-now
+            @"190390 Rameses B - Flaklypa.osz",
+            // winner of https://osu.ppy.sh/home/news/2014-09-24-monthly-beatmapping-contest-7
+            @"241526 Soleily - Renatus.osz",
+            // winner of https://osu.ppy.sh/home/news/2015-02-11-monthly-beatmapping-contest-8
+            @"299224 raja - the light.osz",
+            // winner of https://osu.ppy.sh/home/news/2015-04-13-monthly-beatmapping-contest-9-taiko-only
+            @"319473 Furries in a Blender - Storm World.osz",
+            // winner of https://osu.ppy.sh/home/news/2015-06-15-monthly-beatmapping-contest-10-ctb-only
+            @"342751 Hylian Lemon - Foresight Is for Losers.osz",
+            // winner of https://osu.ppy.sh/home/news/2015-08-22-monthly-beatmapping-contest-11-mania-only
+            @"385056 Toni Leys - Dragon Valley (Toni Leys Remix feat. Esteban Bellucci).osz",
+            // winner of https://osu.ppy.sh/home/news/2016-03-04-beatmapping-contest-12-osu
+            @"456054 IAHN - Candy Luv (Short Ver.).osz",
+            // winner of https://osu.ppy.sh/home/news/2020-11-30-a-labour-of-love
+            // (this thing is 40mb, I'm not sure if we want it here...)
             @"1388906 Raphlesia & BilliumMoto - My Love.osz",
-            // Winner of Triangles mapping competition: https://osu.ppy.sh/home/news/2022-10-06-results-triangles
+            // winner of https://osu.ppy.sh/home/news/2022-05-31-triangles
             @"1841885 cYsmix - triangles.osz",
+            // winner of https://osu.ppy.sh/home/news/2023-02-01-twin-trials-contest-beatmapping-phase
+            @"1971987 James Landino - Aresene's Bazaar.osz",
         };
 
         private static readonly string[] bundled_osu =
         {
-            "682286 Yuyoyuppe - Emerald Galaxy.osz",
-            "682287 baker - For a Dead Girl+.osz",
-            "682289 Hige Driver - I Wanna Feel Your Love (feat. shully).osz",
-            "682290 Hige Driver - Miracle Sugite Yabai (feat. shully).osz",
-            "682416 Hige Driver - Palette.osz",
-            "682595 baker - Kimi ga Kimi ga -vocanico remix-.osz",
-            "716211 yuki. - Spring Signal.osz",
-            "716213 dark cat - BUBBLE TEA (feat. juu & cinders).osz",
-            "716215 LukHash - CLONED.osz",
-            "716219 IAHN - Snowdrop.osz",
-            "716249 *namirin - Senaka Awase no Kuukyo (with Kakichoco).osz",
-            "716390 sakuraburst - SHA.osz",
-            "716441 Fractal Dreamers - Paradigm Shift.osz",
-            "729808 Thaehan - Leprechaun.osz",
-            "751771 Cranky - Hanaarashi.osz",
-            "751772 Cranky - Ran.osz",
-            "751773 Cranky - Feline, the White....osz",
-            "751774 Function Phantom - Variable.osz",
-            "751779 Rin - Daishibyo set 14 ~ Sado no Futatsuiwa.osz",
-            "751782 Fractal Dreamers - Fata Morgana.osz",
-            "751785 Cranky - Chandelier - King.osz",
-            "751846 Fractal Dreamers - Celestial Horizon.osz",
-            "751866 Rin - Moriya set 08 ReEdit ~ Youkai no Yama.osz",
-            "751894 Fractal Dreamers - Blue Haven.osz",
-            "751896 Cranky - Rave 2 Rave.osz",
-            "751932 Cranky - La fuite des jours.osz",
-            "751972 Cranky - CHASER.osz",
-            "779173 Thaehan - Superpower.osz",
-            "780932 VINXIS - A Centralized View.osz",
-            "785572 S3RL - I'll See You Again (feat. Chi Chi).osz",
-            "785650 yuki. feat. setsunan - Hello! World.osz",
-            "785677 Dictate - Militant.osz",
-            "785731 S3RL - Catchit (Radio Edit).osz",
-            "785774 LukHash - GLITCH.osz",
-            "786498 Trial & Error - Tokoyami no keiyaku KEGARETA-SHOUJO feat. GUMI.osz",
-            "789374 Pulse - LP.osz",
-            "789528 James Portland - Sky.osz",
-            "789529 Lexurus - Gravity.osz",
-            "789544 Andromedik - Invasion.osz",
-            "789905 Gourski x Himmes - Silence.osz",
-            "791667 cYsmix - Babaroque (Short Ver.).osz",
-            "791798 cYsmix - Behind the Walls.osz",
-            "791845 cYsmix - Little Knight.osz",
-            "792241 cYsmix - Eden.osz",
-            "792396 cYsmix - The Ballad of a Mindless Girl.osz",
-            "795432 Phonetic - Journey.osz",
-            "831322 DJ'TEKINA//SOMETHING - Hidamari no Uta.osz",
-            "847764 Cranky - Crocus.osz",
-            "847776 Culprate & Joe Ford - Gaucho.osz",
-            "847812 J. Pachelbel - Canon (Cranky Remix).osz",
-            "847900 Cranky - Time Alter.osz",
-            "847930 LukHash - 8BIT FAIRY TALE.osz",
-            "848003 Culprate - Aurora.osz",
-            "848068 nanobii - popsicle beach.osz",
-            "848090 Trial & Error - DAI*TAN SENSATION feat. Nanahira, Mii, Aitsuki Nakuru (Short Ver.).osz",
-            "848259 Culprate & Skorpion - Jester.osz",
-            "848976 Dictate - Treason.osz",
-            "851543 Culprate - Florn.osz",
-            "864748 Thaehan - Angry Birds Epic (Remix).osz",
-            "873667 OISHII - ONIGIRI FREEWAY.osz",
-            "876227 Culprate, Keota & Sophie Meiers - Mechanic Heartbeat.osz",
-            "880487 cYsmix - Peer Gynt.osz",
-            "883088 Wisp X - Somewhere I'd Rather Be.osz",
-            "891333 HyuN - White Aura.osz",
-            "891334 HyuN - Wild Card.osz",
-            "891337 HyuN feat. LyuU - Cross Over.osz",
-            "891338 HyuN & Ritoru - Apocalypse in Love.osz",
-            "891339 HyuN feat. Ato - Asu wa Ame ga Yamukara.osz",
-            "891345 HyuN - Infinity Heaven.osz",
-            "891348 HyuN - Guitian.osz",
-            "891356 HyuN - Legend of Genesis.osz",
-            "891366 HyuN - Illusion of Inflict.osz",
-            "891417 HyuN feat. Yu-A - My life is for you.osz",
-            "891441 HyuN - You'Re aRleAdY dEAd.osz",
-            "891632 HyuN feat. YURI - Disorder.osz",
-            "891712 HyuN - Tokyo's Starlight.osz",
-            "901091 *namirin - Ciel etoile.osz",
-            "916990 *namirin - Koishiteiku Planet.osz",
-            "929284 tieff - Sense of Nostalgia.osz",
-            "933940 Ben Briggs - Yes (Maybe).osz",
-            "934415 Ben Briggs - Fearless Living.osz",
-            "934627 Ben Briggs - New Game Plus.osz",
-            "934666 Ben Briggs - Wave Island.osz",
-            "936126 siromaru + cranky - conflict.osz",
-            "940377 onumi - ARROGANCE.osz",
-            "940597 tieff - Take Your Swimsuit.osz",
-            "941085 tieff - Our Story.osz",
-            "949297 tieff - Sunflower.osz",
-            "952380 Ben Briggs - Why Are We Yelling.osz",
-            "954272 *namirin - Kanzen Shouri*Esper Girl.osz",
-            "955866 KIRA & Heartbreaker - B.B.F (feat. Hatsune Miku & Kagamine Rin).osz",
-            "961320 Kuba Oms - All In All.osz",
-            "964553 The Flashbulb - You Take the World's Weight Away.osz",
-            "965651 Fractal Dreamers - Ad Astra.osz",
-            "966225 The Flashbulb - Passage D.osz",
-            "966324 DJ'TEKINA//SOMETHING - Hidamari no Uta.osz",
-            "972810 James Landino & Kabuki - Birdsong.osz",
-            "972932 James Landino - Hide And Seek.osz",
-            "977276 The Flashbulb - Mellann.osz",
-            "981616 *namirin - Mizutamari Tobikoete (with Nanahira).osz",
-            "985788 Loki - Wizard's Tower.osz",
-            "996628 OISHII - ONIGIRI FREEWAY.osz",
-            "996898 HyuN - White Aura.osz",
-            "1003554 yuki. - Nadeshiko Sensation.osz",
-            "1014936 Thaehan - Bwa !.osz",
-            "1019827 UNDEAD CORPORATION - Sad Dream.osz",
-            "1020213 Creo - Idolize.osz",
-            "1021450 Thaehan - Chiptune & Baroque.osz",
+            @"682286 Yuyoyuppe - Emerald Galaxy.osz",
+            @"682287 baker - For a Dead Girl+.osz",
+            @"682595 baker - Kimi ga Kimi ga -vocanico remix-.osz",
+            @"1048705 Thaehan - Never Give Up.osz",
+            @"1050185 Carpool Tunnel - Hooked Again.osz",
+            @"1052846 Carpool Tunnel - Impressions.osz",
+            @"1062477 Ricky Montgomery - Line Without a Hook.osz",
+            @"1081119 Celldweller - Pulsar.osz",
+            @"1086289 Frums - 24eeev0-$.osz",
+            @"1133317 PUP - Free At Last.osz",
+            @"1171188 PUP - Full Blown Meltdown.osz",
+            @"1177043 PUP - My Life Is Over And I Couldn't Be Happier.osz",
+            @"1250387 Circle of Dust - Humanarchy (Cut Ver.).osz",
+            @"1255411 Wisp X - Somewhere I'd Rather Be.osz",
+            @"1320298 nekodex - Little Drummer Girl.osz",
+            @"1323877 Masahiro ""Godspeed"" Aoki - Blaze.osz",
+            @"1342280 Minagu feat. Aitsuki Nakuru - Theater Endroll.osz",
+            @"1356447 SECONDWALL - Boku wa Boku de shika Nakute.osz",
+            @"1368054 SECONDWALL - Shooting Star.osz",
+            @"1398580 La priere - Senjou no Utahime.osz",
+            @"1403962 m108 - Sunflower.osz",
+            @"1405913 fiend - FEVER DREAM (feat. yzzyx).osz",
+            @"1409184 Omoi - Hey William (New Translation).osz",
+            @"1413418 URBANGARDE - KAMING OUT (Cut Ver.).osz",
+            @"1417793 P4koo (NONE) - Sogaikan Utopia.osz",
+            @"1428384 DUAL ALTER WORLD - Veracila.osz",
+            @"1442963 PUP - DVP.osz",
+            @"1460370 Sound Souler - Empty Stars.osz",
+            @"1485184 Koven - Love Wins Again.osz",
+            @"1496811 T & Sugah - Wicked Days (Cut Ver.).osz",
+            @"1501511 Masahiro ""Godspeed"" Aoki - Frostbite (Cut Ver.).osz",
+            @"1511518 T & Sugah X Zazu - Lost On My Own (Cut Ver.).osz",
+            @"1516617 wotoha - Digital Life Hacker.osz",
+            @"1524273 Michael Cera Palin - Admiral.osz",
+            @"1564234 P4koo - Fly High (feat. rerone).osz",
+            @"1572918 Lexurus - Take Me Away (Cut Ver.).osz",
+            @"1577313 Kurubukko - The 84th Flight.osz",
+            @"1587839 Amidst - Droplet.osz",
+            @"1595193 BlackY - Sakura Ranman Cleopatra.osz",
+            @"1667560 xi - FREEDOM DiVE.osz",
+            @"1668789 City Girl - L2M (feat. Kelsey Kuan).osz",
+            @"1672934 xi - Parousia.osz",
+            @"1673457 Boom Kitty - Any Other Way (feat. Ivy Marie).osz",
+            @"1685122 xi - Time files.osz",
+            @"1689372 NIWASHI - Y.osz",
+            @"1729551 JOYLESS - Dream.osz",
+            @"1742868 Ritorikal - Synergy.osz",
+            @"1757511 KINEMA106 - KARASU.osz",
+            @"1778169 Ricky Montgomery - Cabo.osz",
+            @"1848184 FRASER EDWARDS - Ruination.osz",
+            @"1862574 Pegboard Nerds - Try This (Cut Ver.).osz",
+            @"1873680 happy30 - You spin my world.osz",
+            @"1890055 A.SAKA - Mutsuki Akari no Yuki.osz",
+            @"1911933 Marmalade butcher - Waltz for Chroma (feat. Natsushiro Takaaki).osz",
+            @"1940007 Mili - Ga1ahad and Scientific Witchery.osz",
+            @"1948970 Shadren - You're Here Forever.osz",
+            @"1967856 Annabel - alpine blue.osz",
+            @"1969316 Silentroom - NULCTRL.osz",
+            @"1978614 Krimek - Idyllic World.osz",
+            @"1991315 Feint - Tower Of Heaven (You Are Slaves) (Cut Ver.).osz",
+            @"1997470 tephe - Genjitsu Escape.osz",
+            @"1999116 soowamisu - .vaporcore.osz",
+            @"2010589 Junk - Yellow Smile (bms edit).osz",
+            @"2022054 Yokomin - STINGER.osz",
+            @"2025686 Aice room - For U.osz",
+            @"2035357 C-Show feat. Ishizawa Yukari - Border Line.osz",
+            @"2039403 SECONDWALL - Freedom.osz",
+            @"2046487 Rameses B - Against the Grain (feat. Veela).osz",
+            @"2052201 ColBreakz & Vizzen - Remember.osz",
+            @"2055535 Sephid - Thunderstrike 1988.osz",
+            @"2057584 SAMString - Ataraxia.osz",
+            @"2067270 Blue Stahli - The Fall.osz",
+            @"2075039 garlagan - Skyless.osz",
+            @"2079089 Hamu feat. yuiko - Innocent Letter.osz",
+            @"2082895 FATE GEAR - Heart's Grave.osz",
+            @"2085974 HoneyComeBear - Twilight.osz",
+            @"2094934 F.O.O.L & Laura Brehm - Waking Up.osz",
+            @"2097481 Mameyudoufu - Wave feat. Aitsuki Nakuru.osz",
+            @"2106075 MYUKKE. - The 89's Momentum.osz",
+            @"2117392 t+pazolite & Komiya Mao - Elustametat.osz",
+            @"2123533 LeaF - Calamity Fortune.osz",
+            @"2143876 Alkome - Your Voice.osz",
+            @"2145826 Sephid - Cross-D Skyline.osz",
+            @"2153172 Emiru no Aishita Tsukiyo ni Dai San Gensou Kyoku wo - Eternal Bliss.osz",
         };
 
         private static readonly string[] bundled_taiko =
         {
-            "707824 Fractal Dreamers - Fortuna Redux.osz",
-            "789553 Cranky - Ran.osz",
-            "827822 Function Phantom - Neuronecia.osz",
-            "847323 Nakanojojo - Bittersweet (feat. Kuishinboakachan a.k.a Kiato).osz",
-            "847433 Trial & Error - Tokoyami no keiyaku KEGARETA-SHOUJO feat. GUMI.osz",
-            "847576 dark cat - hot chocolate.osz",
-            "847957 Wisp X - Final Moments.osz",
-            "876282 VINXIS - Greetings.osz",
-            "876648 Thaehan - Angry Birds Epic (Remix).osz",
-            "877069 IAHN - Transform (Original Mix).osz",
-            "877496 Thaehan - Leprechaun.osz",
-            "877935 Thaehan - Overpowered.osz",
-            "878344 yuki. - Be Your Light.osz",
-            "918446 VINXIS - Facade.osz",
-            "918903 LukHash - Ghosts.osz",
-            "919251 *namirin - Hitokoto no Kyori.osz",
-            "919704 S3RL - I Will Pick You Up (feat. Tamika).osz",
-            "921535 SOOOO - Raven Haven.osz",
-            "927206 *namirin - Kanzen Shouri*Esper Girl.osz",
-            "927544 Camellia feat. Nanahira - Kansoku Eisei.osz",
-            "930806 Nakanojojo - Pararara (feat. Amekoya).osz",
-            "931741 Camellia - Quaoar.osz",
-            "935699 Rin - Mythic set ~ Heart-Stirring Urban Legends.osz",
-            "935732 Thaehan - Yuujou.osz",
-            "941145 Function Phantom - Euclid.osz",
-            "942334 Dictate - Cauldron.osz",
-            "946540 nanobii - astral blast.osz",
-            "948844 Rin - Kishinjou set 01 ~ Mist Lake.osz",
-            "949122 Wisp X - Petal.osz",
-            "951618 Rin - Kishinjou set 02 ~ Mermaid from the Uncharted Land.osz",
-            "957412 Rin - Lunatic set 16 ~ The Space Shrine Maiden Returns Home.osz",
-            "961335 Thaehan - Insert Coin.osz",
-            "965178 The Flashbulb - DIDJ PVC.osz",
-            "966087 The Flashbulb - Creep.osz",
-            "966277 The Flashbulb - Amen Iraq.osz",
-            "966407 LukHash - ROOM 12.osz",
-            "966451 The Flashbulb - Six Acid Strings.osz",
-            "972301 BilliumMoto - four veiled stars.osz",
-            "973173 nanobii - popsicle beach.osz",
-            "973954 BilliumMoto - Rocky Buinne (Short Ver.).osz",
-            "975435 BilliumMoto - life flashes before weeb eyes.osz",
-            "978759 L. V. Beethoven - Moonlight Sonata (Cranky Remix).osz",
-            "982559 BilliumMoto - HDHR.osz",
-            "984361 The Flashbulb - Ninedump.osz",
-            "1023681 Inferi - The Ruin of Mankind.osz",
-            "1034358 ALEPH - The Evil Spirit.osz",
-            "1037567 ALEPH - Scintillations.osz",
+            "1048153 Chroma - [@__@].osz",
+            "1229307 Venetian Snares - Shaky Sometimes.osz",
+            "1236083 meganeko - Sirius A (osu! edit).osz",
+            "1248594 Noisia - Anomaly.osz",
+            "1272851 siqlo - One Way Street.osz",
+            "1290736 Kola Kid - good old times.osz",
+            "1318825 SECONDWALL - Light.osz",
+            "1320872 MYUKKE. - The 89's Momentum.osz",
+            "1337389 cute girls doing cute things - Main Heroine.osz",
+            "1397782 Reku Mochizuki - Yorixiro.osz",
+            "1407228 II-L - VANGUARD-1.osz",
+            "1422686 II-L - VANGUARD-2.osz",
+            "1429217 Street - Phi.osz",
+            "1442235 2ToneDisco x Cosmicosmo - Shoelaces (feat. Puniden).osz",
+            "1447478 Cres. - End Time.osz",
+            "1449942 m108 - Crescent Sakura.osz",
+            "1463778 MuryokuP - A tree without a branch.osz",
+            "1465152 fiend - Fever Dream (feat. yzzyx).osz",
+            "1472397 MYUKKE. - Boudica.osz",
+            "1488148 Aoi vs. siqlo - Hacktivism.osz",
+            "1522733 wotoha - Digital Life Hacker.osz",
+            "1540010 Marmalade butcher - Floccinaucinihilipilification.osz",
+            "1584690 MYUKKE. - AKKERA-COUNTRY-BOY.osz",
+            "1608857 BLOOD STAIN CHILD - S.O.P.H.I.A.osz",
+            "1609365 Reku Mochizuki - Faith of Eastward.osz",
+            "1622545 METAROOM - I - DINKI THE STARGUIDE.osz",
+            "1629336 METAROOM - PINK ORIGINS.osz",
+            "1644680 Neko Hacker - Pictures feat. 4s4ki.osz",
+            "1650835 RiraN - Ready For The Madness.osz",
+            "1661508 PTB10 - Starfall.osz",
+            "1671987 xi - World Fragments II.osz",
+            "1703065 tokiwa - wasurena feat. Sennzai.osz",
+            "1703527 tokiwa feat. Nakamura Sanso - Kotodama Refrain.osz",
+            "1704340 A-One feat. Shihori - Magic Girl !!.osz",
+            "1712783 xi - Parousia.osz",
+            "1718774 Harumaki Gohan - Suisei ni Nareta nara.osz",
+            "1719687 EmoCosine - Love Kills U.osz",
+            "1733940 WHITEFISTS feat. Sennzai - Paralyzed Ash.osz",
+            "1734692 EmoCosine - Cutter.osz",
+            "1739529 luvlxckdown - tbh i dont like being social.osz",
+            "1756970 Kurubukko vs. yukitani - Minamichita EVOLVED.osz",
+            "1762209 Marmalade butcher - Immortality Math Club.osz",
+            "1765720 ZxNX - FORTALiCE.osz",
+            "1786165 NILFRUITS - Arandano.osz",
+            "1787258 SAMString - Night Fighter.osz",
+            "1791462 ZxNX - Schadenfreude.osz",
+            "1793821 Kobaryo - The Lightning Sword.osz",
+            "1796440 kuru x miraie - re:start.osz",
+            "1799285 Origami Angel - 666 Flags.osz",
+            "1812415 nanobii - Rainbow Road.osz",
+            "1814682 NIWASHI - Y.osz",
+            "1818361 meganeko - Feral (osu! edit).osz",
+            "1818924 fiend - Disconnect.osz",
+            "1838730 Pegboard Nerds - Disconnected.osz",
+            "1854710 Blaster & Extra Terra - Spacecraft (Cut Ver.).osz",
+            "1859322 Hino Isuka - Delightness Brightness.osz",
+            "1884102 Maduk - Go (feat. Lachi) (Cut Ver.).osz",
+            "1884578 Neko Hacker - People People feat. Nanahira.osz",
+            "1897902 uma vs. Morimori Atsushi - Re: End of a Dream.osz",
+            "1905582 KINEMA106 - Fly Away (Cut Ver.).osz",
+            "1934686 ARForest - Rainbow Magic!!.osz",
+            "1963076 METAROOM - S.N.U.F.F.Y.osz",
+            "1968973 Stars Hollow - Out the Sunroof..osz",
+            "1971951 James Landino - Shiba Paradise.osz",
+            "1972518 Toromaru - Sleight of Hand.osz",
+            "1982302 KINEMA106 - INVITE.osz",
+            "1983475 KNOWER - The Government Knows.osz",
+            "2010165 Junk - Yellow Smile (bms edit).osz",
+            "2022737 Andora - Euphoria (feat. WaMi).osz",
+            "2025023 tephe - Genjitsu Escape.osz",
+            "2052754 P4koo - 8th:Planet ~Re:search~.osz",
+            "2054122 Raimukun - Myths Orbis.osz",
+            "2121470 Raimukun - Nyarlathotep's Dreamland.osz",
+            "2122284 Agressor Bunx - Tornado (Cut Ver.).osz",
+            "2125034 Agressor Bunx - Acid Mirage (Cut Ver.).osz",
+            "2136263 Se-U-Ra - Cris Fortress.osz",
         };
 
         private static readonly string[] bundled_catch =
         {
-            "554256 Helblinde - When Time Sleeps.osz",
-            "693123 yuki. - Nadeshiko Sensation.osz",
-            "767009 OISHII - PIZZA PLAZA.osz",
-            "767346 Thaehan - Bwa !.osz",
-            "815162 VINXIS - Greetings.osz",
-            "840964 cYsmix - Breeze.osz",
-            "932657 Wisp X - Eventide.osz",
-            "933700 onumi - CONFUSION PART ONE.osz",
-            "933984 onumi - PERSONALITY.osz",
-            "934785 onumi - FAKE.osz",
-            "936545 onumi - REGRET PART ONE.osz",
-            "943803 Fractal Dreamers - Everything for a Dream.osz",
-            "943876 S3RL - I Will Pick You Up (feat. Tamika).osz",
-            "946773 Trial & Error - DREAMING COLOR (Short Ver.).osz",
-            "955808 Trial & Error - Tokoyami no keiyaku KEGARETA-SHOUJO feat. GUMI (Short Ver.).osz",
-            "957808 Fractal Dreamers - Module_410.osz",
-            "957842 antiPLUR - One Life Left to Live.osz",
-            "965730 The Flashbulb - Lawn Wake IV (Black).osz",
-            "966240 Creo - Challenger.osz",
-            "968232 Rin - Lunatic set 15 ~ The Moon as Seen from the Shrine.osz",
-            "972302 VINXIS - A Centralized View.osz",
-            "972887 HyuN - Illusion of Inflict.osz",
-            "1008600 LukHash - WHEN AN ANGEL DIES.osz",
-            "1032103 LukHash - H8 U.osz",
+            @"693123 yuki. - Nadeshiko Sensation.osz",
+            @"833719 FOLiACETATE - Heterochromia Iridis.osz",
+            @"981762 siromaru + cranky - conflict.osz",
+            @"1008600 LukHash - WHEN AN ANGEL DIES.osz",
+            @"1071294 dark cat - pursuit of happiness.osz",
+            @"1102115 meganeko - Nova.osz",
+            @"1115500 Chopin - Etude Op. 25, No. 12 (meganeko Remix).osz",
+            @"1128274 LeaF - Wizdomiot.osz",
+            @"1141049 HyuN feat. JeeE - Fallen Angel.osz",
+            @"1148215 Zekk - Fluctuation.osz",
+            @"1151833 ginkiha - nightfall.osz",
+            @"1158124 PUP - Dark Days.osz",
+            @"1184890 IAHN - Transform (Original Mix).osz",
+            @"1195922 Disasterpeace - Home.osz",
+            @"1197461 MIMI - Nanimo nai Youna.osz",
+            @"1197924 Camellia feat. Nanahira - Looking For A New Adventure.osz",
+            @"1203594 ginkiha - Anemoi.osz",
+            @"1211572 MIMI - Lapis Lazuli.osz",
+            @"1231601 Lime - Harmony.osz",
+            @"1240162 P4koo - 8th:Planet ~Re:search~.osz",
+            @"1246000 Zekk - Calling.osz",
+            @"1249928 Thaehan - Yuujou.osz",
+            @"1258751 Umeboshi Chazuke - ICHIBANBOSHI*ROCKET.osz",
+            @"1264818 Umeboshi Chazuke - Panic! Pop'n! Picnic! (2019 REMASTER).osz",
+            @"1280183 IAHN - Mad Halloween.osz",
+            @"1303201 Umeboshi Chazuke - Run*2 Run To You!!.osz",
+            @"1328918 Kobaryo - Theme for Psychopath Justice.osz",
+            @"1338215 Lime - Renai Syndrome.osz",
+            @"1338796 uma vs. Morimori Atsushi - Re:End of a Dream.osz",
+            @"1340492 MYUKKE. - The 89's Momentum.osz",
+            @"1393933 Mastermind (xi+nora2r) - Dreadnought.osz",
+            @"1400205 m108 - XIII Charlotte.osz",
+            @"1471328 Lime - Chronomia.osz",
+            @"1503591 Origami Angel - The Title Track.osz",
+            @"1524173 litmus* as Ester - Krave.osz",
+            @"1541235 Getty vs. DJ DiA - Grayed Out -Antifront-.osz",
+            @"1554250 Shawn Wasabi - Otter Pop (feat. Hollis).osz",
+            @"1583461 Sound Souler - Absent Color.osz",
+            @"1638487 tokiwa - wasurena feat. Sennzai.osz",
+            @"1698949 ZxNX - Schadenfreude.osz",
+            @"1704324 xi - Time files.osz",
+            @"1756405 Fractal Dreamers - Kingdom of Silence.osz",
+            @"1769575 cYsmix - Peer Gynt.osz",
+            @"1770054 Ardolf - Split.osz",
+            @"1772648 in love with a ghost - interdimensional portal leading to a cute place feat. snail's house.osz",
+            @"1776379 in love with a ghost - i thought we were lovers w/ basil.osz",
+            @"1779476 URBANGARDE - KIMI WA OKUMAGASO.osz",
+            @"1789435 xi - Parousia.osz",
+            @"1794190 Se-U-Ra - The Endless for Traveler.osz",
+            @"1799889 Waterflame - Ricochet Love.osz",
+            @"1816401 Gram vs. Yooh - Apocalypse.osz",
+            @"1826327 -45 - Total Eclipse of The Sun.osz",
+            @"1830796 xi - Halcyon.osz",
+            @"1924231 Mili - Nine Point Eight.osz",
+            @"1952903 Cres. - End Time.osz",
+            @"1970946 Good Kid - Slingshot.osz",
+            @"1982063 linear ring - enchanted love.osz",
+            @"2000438 Toromaru - Erinyes.osz",
+            @"2124277 II-L - VANGUARD-3.osz",
+            @"2147529 Nashimoto Ui - AaAaAaAAaAaAAa (Cut Ver.).osz",
         };
 
         private static readonly string[] bundled_mania =
         {
-            "943516 antiPLUR - Clockwork Spooks.osz",
-            "946394 VINXIS - Three Times The Original Charm.osz",
-            "966408 antiPLUR - One Life Left to Live.osz",
-            "971561 antiPLUR - Runengon.osz",
-            "983864 James Landino - Shiba Island.osz",
-            "989512 BilliumMoto - 1xMISS.osz",
-            "994104 James Landino - Reaction feat. Slyleaf.osz",
-            "1003217 nekodex - circles!.osz",
-            "1009907 James Landino & Kabuki - Birdsong.osz",
-            "1015169 Thaehan - Insert Coin.osz",
+            @"1008419 BilliumMoto - Four Veiled Stars.osz",
+            @"1025170 Frums - We Want To Run.osz",
+            @"1092856 F-777 - Viking Arena.osz",
+            @"1139247 O2i3 - Heart Function.osz",
+            @"1154007 LeaF - ATHAZA.osz",
+            @"1170054 Zekk - Fallen.osz",
+            @"1212132 Street - Koiyamai (TV Size).osz",
+            @"1226466 Se-U-Ra - Elif to Shiro Kura no Yoru -Called-.osz",
+            @"1247210 Frums - Credits.osz",
+            @"1254196 ARForest - Regret.osz",
+            @"1258829 Umeboshi Chazuke - Cineraria.osz",
+            @"1300398 ARForest - The Last Page.osz",
+            @"1305627 Frums - Star of the COME ON!!.osz",
+            @"1348806 Se-U-Ra - LOA2.osz",
+            @"1375449 yuki. - Nadeshiko Sensation.osz",
+            @"1448292 Cres. - End Time.osz",
+            @"1479741 Reku Mochizuki - FORViDDEN ENERZY -Fataldoze-.osz",
+            @"1494747 Fractal Dreamers - Whispers from a Distant Star.osz",
+            @"1505336 litmus* - Rush-More.osz",
+            @"1508963 ARForest - Rainbow Magic!!.osz",
+            @"1727126 Chroma - Strange Inventor.osz",
+            @"1737101 ZxNX - FORTALiCE.osz",
+            @"1740952 Sobrem x Silentroom - Random.osz",
+            @"1756251 Plum - Mad Piano Party.osz",
+            @"1909163 Frums - theyaremanycolors.osz",
+            @"1916285 siromaru + cranky - conflict.osz",
+            @"1948972 Ardolf - Split.osz",
+            @"1957138 GLORYHAMMER - Rise Of The Chaos Wizards.osz",
+            @"1972411 James Landino - Shiba Paradise.osz",
+            @"1978179 Andora - Flicker (feat. RANASOL).osz",
+            @"1987180 cygnus - The Evolution of War.osz",
+            @"1994458 tephe - Genjitsu Escape.osz",
+            @"1999339 Aice room - Nyan Nyan Dive (EmoCosine Remix).osz",
+            @"2015361 HoneyComeBear - Rainy Girl.osz",
+            @"2028108 HyuN - Infinity Heaven.osz",
+            @"2055329 miraie & blackwinterwells - facade.osz",
+            @"2069877 Sephid - Thunderstrike 1988.osz",
+            @"2119716 Aethoro - Snowy.osz",
+            @"2120379 Synthion - VIVIDVELOCITY.osz",
+            @"2124805 Frums (unknown ""lambda"") - 19ZZ.osz",
+            @"2127811 Wiklund - Joy of Living (Cut Ver.).osz",
         };
     }
 }

From 1d6915478f485998a47e6926bd3927dd533d1309 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 May 2024 14:26:49 +0800
Subject: [PATCH 771/930] Add message letting users know that beatmaps are
 donwloading in the background

---
 .../FirstRunSetupBeatmapScreenStrings.cs         |  5 +++++
 .../Overlays/FirstRunSetup/ScreenBeatmaps.cs     | 16 ++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
index a77ee066e4..50a417312d 100644
--- a/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
+++ b/osu.Game/Localisation/FirstRunSetupBeatmapScreenStrings.cs
@@ -39,6 +39,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString BundledButton => new TranslatableString(getKey(@"bundled_button"), @"Get recommended beatmaps");
 
+        /// <summary>
+        /// "Beatmaps will be downloaded in the background. You can continue with setup while this happens!"
+        /// </summary>
+        public static LocalisableString DownloadingInBackground => new TranslatableString(getKey(@"downloading_in_background"), @"Beatmaps will be downloaded in the background. You can continue with setup while this happens!");
+
         /// <summary>
         /// "You can also obtain more beatmaps from the main menu &quot;browse&quot; button at any time."
         /// </summary>
diff --git a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
index 385695f669..da60951ab6 100644
--- a/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
+++ b/osu.Game/Overlays/FirstRunSetup/ScreenBeatmaps.cs
@@ -15,6 +15,7 @@ using osu.Game.Graphics.Containers;
 using osu.Game.Localisation;
 using osu.Game.Online;
 using osuTK;
+using osuTK.Graphics;
 using Realms;
 
 namespace osu.Game.Overlays.FirstRunSetup
@@ -25,6 +26,8 @@ namespace osu.Game.Overlays.FirstRunSetup
         private ProgressRoundedButton downloadBundledButton = null!;
         private ProgressRoundedButton downloadTutorialButton = null!;
 
+        private OsuTextFlowContainer downloadInBackgroundText = null!;
+
         private OsuTextFlowContainer currentlyLoadedBeatmaps = null!;
 
         private BundledBeatmapDownloader? tutorialDownloader;
@@ -100,6 +103,15 @@ namespace osu.Game.Overlays.FirstRunSetup
                     Text = FirstRunSetupBeatmapScreenStrings.BundledButton,
                     Action = downloadBundled
                 },
+                downloadInBackgroundText = new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
+                {
+                    Colour = OverlayColourProvider.Light2,
+                    Alpha = 0,
+                    TextAnchor = Anchor.TopCentre,
+                    Text = FirstRunSetupBeatmapScreenStrings.DownloadingInBackground,
+                    RelativeSizeAxes = Axes.X,
+                    AutoSizeAxes = Axes.Y
+                },
                 new OsuTextFlowContainer(cp => cp.Font = OsuFont.Default.With(size: CONTENT_FONT_SIZE))
                 {
                     Colour = OverlayColourProvider.Content1,
@@ -169,6 +181,10 @@ namespace osu.Game.Overlays.FirstRunSetup
             if (bundledDownloader != null)
                 return;
 
+            downloadInBackgroundText
+                .FlashColour(Color4.White, 500)
+                .FadeIn(200);
+
             bundledDownloader = new BundledBeatmapDownloader(false);
 
             AddInternal(bundledDownloader);

From 0ddd3cbdc5cba5ccc60e72ed97ebe07629915249 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 7 May 2024 17:02:25 +0800
Subject: [PATCH 772/930] Randomise which menu content is shown on arriving at
 the menu

---
 osu.Game/Screens/Menu/OnlineMenuBanner.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/OnlineMenuBanner.cs b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
index 6f98b73939..b9d269c82a 100644
--- a/osu.Game/Screens/Menu/OnlineMenuBanner.cs
+++ b/osu.Game/Screens/Menu/OnlineMenuBanner.cs
@@ -13,6 +13,7 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.Textures;
 using osu.Framework.Input.Events;
 using osu.Framework.Threading;
+using osu.Framework.Utils;
 using osu.Game.Graphics.Containers;
 using osu.Game.Online.API.Requests;
 using osu.Game.Online.API.Requests.Responses;
@@ -111,7 +112,9 @@ namespace osu.Game.Screens.Menu
 
                 content.AddRange(loaded);
 
-                displayIndex = -1;
+                // Many users don't spend much time at the main menu, so let's randomise where in the
+                // carousel of available images we start at to give each a fair chance.
+                displayIndex = RNG.Next(0, images.NewValue.Images.Length) - 1;
                 showNext();
             }, (cancellationTokenSource ??= new CancellationTokenSource()).Token);
         }

From ab2677d913552b5d381c91675d8bf6628853585e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Erik=20Wolfschl=C3=A4ger?= <e.wolfschlaeger@gmail.com>
Date: Tue, 7 May 2024 17:15:49 +0200
Subject: [PATCH 773/930] Changed default delete confirmation content strings
 for better translatability

---
 .../DeleteConfirmationContentStrings.cs       | 24 +++++++++----------
 .../DeleteConfirmationDialogStrings.cs        |  4 ++--
 2 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
index d9e90675f7..563fbf5654 100644
--- a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
+++ b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
@@ -10,34 +10,34 @@ namespace osu.Game.Localisation
         private const string prefix = @"osu.Game.Resources.Localisation.DeleteConfirmationContent";
 
         /// <summary>
-        /// "All beatmaps?"
+        /// "Are you sure you want to delete all beatmaps?"
         /// </summary>
-        public static LocalisableString Beatmaps => new TranslatableString(getKey(@"beatmaps"), @"All beatmaps?");
+        public static LocalisableString Beatmaps => new TranslatableString(getKey(@"beatmaps"), @"Are you sure you want to delete all beatmaps?");
 
         /// <summary>
-        /// "All beatmaps videos? This cannot be undone!"
+        /// "Are you sure you want to delete all beatmaps videos? This cannot be undone!"
         /// </summary>
-        public static LocalisableString BeatmapVideos => new TranslatableString(getKey(@"beatmap_videos"), @"All beatmaps videos? This cannot be undone!");
+        public static LocalisableString BeatmapVideos => new TranslatableString(getKey(@"beatmap_videos"), @"Are you sure you want to delete all beatmaps videos? This cannot be undone!");
 
         /// <summary>
-        /// "All skins? This cannot be undone!"
+        /// "Are you sure you want to delete all skins? This cannot be undone!"
         /// </summary>
-        public static LocalisableString Skins => new TranslatableString(getKey(@"skins"), @"All skins? This cannot be undone!");
+        public static LocalisableString Skins => new TranslatableString(getKey(@"skins"), @"Are you sure you want to delete all skins? This cannot be undone!");
 
         /// <summary>
-        /// "All collections? This cannot be undone!"
+        /// "Are you sure you want to delete all collections? This cannot be undone!"
         /// </summary>
-        public static LocalisableString Collections => new TranslatableString(getKey(@"collections"), @"All collections? This cannot be undone!");
+        public static LocalisableString Collections => new TranslatableString(getKey(@"collections"), @"Are you sure you want to delete all collections? This cannot be undone!");
 
         /// <summary>
-        /// "All scores? This cannot be undone!"
+        /// "Are you sure you want to delete all scores? This cannot be undone!"
         /// </summary>
-        public static LocalisableString Scores => new TranslatableString(getKey(@"collections"), @"All scores? This cannot be undone!");
+        public static LocalisableString Scores => new TranslatableString(getKey(@"collections"), @"Are you sure you want to delete all scores? This cannot be undone!");
 
         /// <summary>
-        /// "All mod presets?"
+        /// "Are you sure you want to delete all mod presets?"
         /// </summary>
-        public static LocalisableString ModPresets => new TranslatableString(getKey(@"mod_presets"), @"All mod presets?");
+        public static LocalisableString ModPresets => new TranslatableString(getKey(@"mod_presets"), @"Are you sure you want to delete all mod presets?");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
diff --git a/osu.Game/Localisation/DeleteConfirmationDialogStrings.cs b/osu.Game/Localisation/DeleteConfirmationDialogStrings.cs
index 33738fe95e..25997eadd3 100644
--- a/osu.Game/Localisation/DeleteConfirmationDialogStrings.cs
+++ b/osu.Game/Localisation/DeleteConfirmationDialogStrings.cs
@@ -10,9 +10,9 @@ namespace osu.Game.Localisation
         private const string prefix = @"osu.Game.Resources.Localisation.DeleteConfirmationDialog";
 
         /// <summary>
-        /// "Confirm deletion of"
+        /// "Caution"
         /// </summary>
-        public static LocalisableString HeaderText => new TranslatableString(getKey(@"header_text"), @"Confirm deletion of");
+        public static LocalisableString HeaderText => new TranslatableString(getKey(@"header_text"), @"Caution");
 
         /// <summary>
         /// "Yes. Go for it."

From 7551cf01d18a4e924ae9720417fa1797e8b38db5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 8 May 2024 09:45:52 +0200
Subject: [PATCH 774/930] Fix test failure

---
 osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
index cc7b37e6a8..8ca141bb4f 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyScoreDecoderTest.cs
@@ -14,7 +14,7 @@ using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Formats;
 using osu.Game.Beatmaps.Legacy;
 using osu.Game.IO.Legacy;
-using osu.Game.Models;
+using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Replays;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Catch;
@@ -226,10 +226,10 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 new OsuModDoubleTime { SpeedChange = { Value = 1.1 } }
             };
             scoreInfo.OnlineID = 123123;
-            scoreInfo.RealmUser = new RealmUser
+            scoreInfo.User = new APIUser
             {
                 Username = "spaceman_atlas",
-                OnlineID = 3035836,
+                Id = 3035836,
                 CountryCode = CountryCode.PL
             };
             scoreInfo.ClientVersion = "2023.1221.0";

From 88b20b357ae0d6ac5d1549981ec07e9a3f731cee Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 May 2024 14:38:10 +0800
Subject: [PATCH 775/930] Increase padding around text in dialogs

---
 osu.Game/Overlays/Dialog/PopupDialog.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Dialog/PopupDialog.cs b/osu.Game/Overlays/Dialog/PopupDialog.cs
index 4ac37a63e2..a23c394c9f 100644
--- a/osu.Game/Overlays/Dialog/PopupDialog.cs
+++ b/osu.Game/Overlays/Dialog/PopupDialog.cs
@@ -210,7 +210,7 @@ namespace osu.Game.Overlays.Dialog
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
                                     TextAnchor = Anchor.TopCentre,
-                                    Padding = new MarginPadding { Horizontal = 5 },
+                                    Padding = new MarginPadding { Horizontal = 15 },
                                 },
                                 body = new OsuTextFlowContainer(t => t.Font = t.Font.With(size: 18))
                                 {
@@ -219,7 +219,7 @@ namespace osu.Game.Overlays.Dialog
                                     TextAnchor = Anchor.TopCentre,
                                     RelativeSizeAxes = Axes.X,
                                     AutoSizeAxes = Axes.Y,
-                                    Padding = new MarginPadding { Horizontal = 5 },
+                                    Padding = new MarginPadding { Horizontal = 15 },
                                 },
                                 buttonsContainer = new FillFlowContainer<PopupDialogButton>
                                 {

From 3b8b56cbcbdb0365a03231aa151efb0050c12ebf Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 9 May 2024 20:18:53 +0900
Subject: [PATCH 776/930] Apply required changes after framework masking
 updates

---
 .../Sliders/Components/PathControlPointVisualiser.cs           | 2 +-
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs                       | 3 +--
 osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs                   | 3 +--
 osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs      | 2 +-
 osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs       | 3 +--
 osu.Game/Rulesets/UI/FrameStabilityContainer.cs                | 2 +-
 .../Edit/Compose/Components/Timeline/TimelineTickDisplay.cs    | 3 +--
 7 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index 836d348ff4..afc2d407e9 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         }
 
         // Generally all the control points are within the visible area all the time.
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => true;
+        public override bool UpdateSubTreeMasking() => true;
 
         /// <summary>
         /// Handles correction of invalid path types.
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 4933eb4041..93c3450904 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -8,7 +8,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Primitives;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
@@ -37,7 +36,7 @@ namespace osu.Game.Rulesets.Osu.UI
 
         // For osu! gameplay, everything is always on screen.
         // Skipping masking calculations improves performance in intense beatmaps (ie. https://osu.ppy.sh/beatmapsets/150945#osu/372245)
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         public SmokeContainer Smoke { get; }
         public FollowPointRenderer FollowPoints { get; }
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index 0510f08068..bdcb341fb4 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Primitives;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Judgements;
@@ -345,7 +344,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         {
             public void Add(Drawable proxy) => AddInternal(proxy);
 
-            public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds)
+            public override bool UpdateSubTreeMasking()
             {
                 // DrawableHitObject disables masking.
                 // Hitobject content is proxied and unproxied based on hit status and the IsMaskedAway value could get stuck because of this.
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
index 3a2db4fc71..111dede815 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Tournament.Screens.Ladder
 
         protected override bool ComputeIsMaskedAway(RectangleF maskingBounds) => false;
 
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         protected override void OnDrag(DragEvent e)
         {
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index de05219212..3ce6cc3cef 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -15,7 +15,6 @@ using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -632,7 +631,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         #endregion
 
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         protected override void UpdateAfterChildren()
         {
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index b49924762e..c4feb249f4 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.UI
                     break;
 
                 base.UpdateSubTree();
-                UpdateSubTreeMasking(this, ScreenSpaceDrawQuad.AABBFloat);
+                UpdateSubTreeMasking();
             } while (state == PlaybackState.RequiresCatchUp && stopwatch.ElapsedMilliseconds < max_catchup_milliseconds);
 
             return true;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index c3adb43032..e16c8519e5 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -20,7 +19,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     public partial class TimelineTickDisplay : TimelinePart<PointVisualisation>
     {
         // With current implementation every tick in the sub-tree should be visible, no need to check whether they are masked away.
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         [Resolved]
         private EditorBeatmap beatmap { get; set; } = null!;

From c4d6318c0d0026bb5b581fb198aded74376de775 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 May 2024 22:12:09 +0800
Subject: [PATCH 777/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 97dfe5d9f7..e20ac2e0b7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.423.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.509.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 40958f3785..e784e4e0b2 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.423.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 66347acdf0..103ef50e0c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.423.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.509.0" />
   </ItemGroup>
 </Project>

From de05998421b2c04d669bf08897e6fd82e49d1815 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 9 May 2024 22:17:00 +0800
Subject: [PATCH 778/930] Avoid weird codestyle rules

---
 osu.Desktop/Program.cs | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index d8364fc6e6..23e56cdce9 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -107,11 +107,13 @@ namespace osu.Desktop
                 }
             }
 
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions
-                   {
-                       IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null,
-                       FriendlyGameName = OsuGameBase.GAME_NAME,
-                   }))
+            var hostOptions = new HostOptions
+            {
+                IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null,
+                FriendlyGameName = OsuGameBase.GAME_NAME,
+            };
+
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, hostOptions))
             {
                 if (!host.IsPrimaryInstance)
                 {

From 6b91b4abf41660fb030f2d593df28159442cf145 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Wed, 8 May 2024 03:58:10 +0300
Subject: [PATCH 779/930] Add simple implementation for extended mods display
 in new footer design

---
 .../TestSceneFooterButtonModsV2.cs            | 120 +++++++++
 osu.Game/Screens/Play/HUD/ModDisplay.cs       |   7 +-
 .../Select/FooterV2/FooterButtonModsV2.cs     | 249 +++++++++++++++++-
 .../Screens/Select/FooterV2/FooterButtonV2.cs | 126 ++++-----
 4 files changed, 436 insertions(+), 66 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
new file mode 100644
index 0000000000..7e8bba6573
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
@@ -0,0 +1,120 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Rulesets.Osu.Mods;
+using osu.Game.Screens.Select.FooterV2;
+using osu.Game.Utils;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    public partial class TestSceneFooterButtonModsV2 : OsuTestScene
+    {
+        private readonly TestFooterButtonModsV2 footerButtonMods;
+
+        [Cached]
+        private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
+
+        public TestSceneFooterButtonModsV2()
+        {
+            Add(footerButtonMods = new TestFooterButtonModsV2
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.CentreLeft,
+                X = -100,
+                Action = () => { },
+            });
+        }
+
+        [Test]
+        public void TestDisplay()
+        {
+            AddStep("one mod", () => changeMods(new List<Mod> { new OsuModHidden() }));
+            AddStep("two mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock() }));
+            AddStep("three mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime() }));
+            AddStep("four mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic() }));
+            AddStep("five mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() }));
+
+            AddStep("clear mods", () => changeMods(Array.Empty<Mod>()));
+            AddWaitStep("wait", 3);
+            AddStep("one mod", () => changeMods(new List<Mod> { new OsuModHidden() }));
+
+            AddStep("clear mods", () => changeMods(Array.Empty<Mod>()));
+            AddWaitStep("wait", 3);
+            AddStep("five mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() }));
+        }
+
+        [Test]
+        public void TestIncrementMultiplier()
+        {
+            var hiddenMod = new Mod[] { new OsuModHidden() };
+            AddStep(@"Add Hidden", () => changeMods(hiddenMod));
+            AddAssert(@"Check Hidden multiplier", () => assertModsMultiplier(hiddenMod));
+
+            var hardRockMod = new Mod[] { new OsuModHardRock() };
+            AddStep(@"Add HardRock", () => changeMods(hardRockMod));
+            AddAssert(@"Check HardRock multiplier", () => assertModsMultiplier(hardRockMod));
+
+            var doubleTimeMod = new Mod[] { new OsuModDoubleTime() };
+            AddStep(@"Add DoubleTime", () => changeMods(doubleTimeMod));
+            AddAssert(@"Check DoubleTime multiplier", () => assertModsMultiplier(doubleTimeMod));
+
+            var multipleIncrementMods = new Mod[] { new OsuModDoubleTime(), new OsuModHidden(), new OsuModHardRock() };
+            AddStep(@"Add multiple Mods", () => changeMods(multipleIncrementMods));
+            AddAssert(@"Check multiple mod multiplier", () => assertModsMultiplier(multipleIncrementMods));
+        }
+
+        [Test]
+        public void TestDecrementMultiplier()
+        {
+            var easyMod = new Mod[] { new OsuModEasy() };
+            AddStep(@"Add Easy", () => changeMods(easyMod));
+            AddAssert(@"Check Easy multiplier", () => assertModsMultiplier(easyMod));
+
+            var noFailMod = new Mod[] { new OsuModNoFail() };
+            AddStep(@"Add NoFail", () => changeMods(noFailMod));
+            AddAssert(@"Check NoFail multiplier", () => assertModsMultiplier(noFailMod));
+
+            var multipleDecrementMods = new Mod[] { new OsuModEasy(), new OsuModNoFail() };
+            AddStep(@"Add Multiple Mods", () => changeMods(multipleDecrementMods));
+            AddAssert(@"Check multiple mod multiplier", () => assertModsMultiplier(multipleDecrementMods));
+        }
+
+        [Test]
+        public void TestUnrankedBadge()
+        {
+            AddStep(@"Add unranked mod", () => changeMods(new[] { new OsuModDeflate() }));
+            AddUntilStep("Unranked badge shown", () => footerButtonMods.UnrankedBadge.Alpha == 1);
+            AddStep(@"Clear selected mod", () => changeMods(Array.Empty<Mod>()));
+            AddUntilStep("Unranked badge not shown", () => footerButtonMods.UnrankedBadge.Alpha == 0);
+        }
+
+        private void changeMods(IReadOnlyList<Mod> mods)
+        {
+            footerButtonMods.Current.Value = mods;
+        }
+
+        private bool assertModsMultiplier(IEnumerable<Mod> mods)
+        {
+            double multiplier = mods.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier);
+            string expectedValue = ModUtils.FormatScoreMultiplier(multiplier).ToString();
+
+            return expectedValue == footerButtonMods.MultiplierText.Current.Value;
+        }
+
+        private partial class TestFooterButtonModsV2 : FooterButtonModsV2
+        {
+            public new Container UnrankedBadge => base.UnrankedBadge;
+            public new OsuSpriteText MultiplierText => base.MultiplierText;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Play/HUD/ModDisplay.cs b/osu.Game/Screens/Play/HUD/ModDisplay.cs
index ba948b516e..75db720603 100644
--- a/osu.Game/Screens/Play/HUD/ModDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/ModDisplay.cs
@@ -20,6 +20,7 @@ namespace osu.Game.Screens.Play.HUD
     /// </summary>
     public partial class ModDisplay : CompositeDrawable, IHasCurrentValue<IReadOnlyList<Mod>>
     {
+        private readonly bool showExtendedInformation;
         private const int fade_duration = 1000;
 
         public ExpansionMode ExpansionMode = ExpansionMode.ExpandOnHover;
@@ -39,8 +40,10 @@ namespace osu.Game.Screens.Play.HUD
 
         private readonly FillFlowContainer<ModIcon> iconsContainer;
 
-        public ModDisplay()
+        public ModDisplay(bool showExtendedInformation = true)
         {
+            this.showExtendedInformation = showExtendedInformation;
+
             AutoSizeAxes = Axes.Both;
 
             InternalChild = iconsContainer = new ReverseChildIDFillFlowContainer<ModIcon>
@@ -64,7 +67,7 @@ namespace osu.Game.Screens.Play.HUD
             iconsContainer.Clear();
 
             foreach (Mod mod in mods.NewValue.AsOrdered())
-                iconsContainer.Add(new ModIcon(mod) { Scale = new Vector2(0.6f) });
+                iconsContainer.Add(new ModIcon(mod, showExtendedInformation: showExtendedInformation) { Scale = new Vector2(0.6f) });
 
             appearTransform();
         }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index b8c9f0b34b..f9d923ddcf 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -1,20 +1,261 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.LocalisationExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Effects;
+using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
+using osu.Framework.Graphics.UserInterface;
+using osu.Game.Configuration;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Localisation;
+using osu.Game.Overlays;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Play.HUD;
+using osu.Game.Utils;
+using osuTK;
+using osuTK.Graphics;
 
 namespace osu.Game.Screens.Select.FooterV2
 {
-    public partial class FooterButtonModsV2 : FooterButtonV2
+    public partial class FooterButtonModsV2 : FooterButtonV2, IHasCurrentValue<IReadOnlyList<Mod>>
     {
-        [BackgroundDependencyLoader]
-        private void load(OsuColour colour)
+        // todo: see https://github.com/ppy/osu-framework/issues/3271
+        private const float torus_scale_factor = 1.2f;
+
+        private readonly BindableWithCurrent<IReadOnlyList<Mod>> current = new BindableWithCurrent<IReadOnlyList<Mod>>(Array.Empty<Mod>());
+
+        public Bindable<IReadOnlyList<Mod>> Current
         {
+            get => current.Current;
+            set => current.Current = value;
+        }
+
+        private Container modDisplayBar = null!;
+
+        protected Container UnrankedBadge { get; private set; } = null!;
+
+        private ModDisplay modDisplay = null!;
+        private OsuSpriteText modCountText = null!;
+
+        protected OsuSpriteText MultiplierText { get; private set; } = null!;
+
+        [Resolved]
+        private OsuColour colours { get; set; } = null!;
+
+        [Resolved]
+        private OverlayColourProvider colourProvider { get; set; } = null!;
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            const float bar_shear_width = 7f;
+            const float bar_height = 37f;
+            const float display_rel_width = 0.65f;
+
+            var barShear = new Vector2(bar_shear_width / bar_height, 0);
+
             Text = "Mods";
             Icon = FontAwesome.Solid.ExchangeAlt;
-            AccentColour = colour.Lime1;
+            AccentColour = colours.Lime1;
+
+            AddRange(new[]
+            {
+                UnrankedBadge = new Container
+                {
+                    Position = new Vector2(BUTTON_WIDTH + 5f, -5f),
+                    Depth = float.MaxValue,
+                    Origin = Anchor.BottomLeft,
+                    Shear = barShear,
+                    CornerRadius = CORNER_RADIUS,
+                    AutoSizeAxes = Axes.Both,
+                    Masking = true,
+                    BorderColour = Color4.White,
+                    BorderThickness = 2f,
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = colours.Red2,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new OsuSpriteText
+                        {
+                            Shear = -barShear,
+                            Text = ModSelectOverlayStrings.Unranked.ToUpper(),
+                            Margin = new MarginPadding { Horizontal = 15, Vertical = 5 },
+                            Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
+                            Colour = Color4.Black,
+                        }
+                    }
+                },
+                modDisplayBar = new Container
+                {
+                    Y = -5f,
+                    Depth = float.MaxValue,
+                    Origin = Anchor.BottomLeft,
+                    Shear = barShear,
+                    CornerRadius = CORNER_RADIUS,
+                    Size = new Vector2(BUTTON_WIDTH, bar_height),
+                    Masking = true,
+                    EdgeEffect = new EdgeEffectParameters
+                    {
+                        Type = EdgeEffectType.Shadow,
+                        Radius = 4,
+                        // Figma says 50% opacity, but it does not match up visually if taken at face value, and looks bad.
+                        Colour = Colour4.Black.Opacity(0.25f),
+                        Offset = new Vector2(0, 2),
+                    },
+                    Children = new Drawable[]
+                    {
+                        new Box
+                        {
+                            Colour = colourProvider.Background4,
+                            RelativeSizeAxes = Axes.Both,
+                        },
+                        new Container
+                        {
+                            Anchor = Anchor.CentreRight,
+                            Origin = Anchor.CentreRight,
+                            RelativeSizeAxes = Axes.Both,
+                            Width = 1f - display_rel_width,
+                            Masking = true,
+                            Child = MultiplierText = new OsuSpriteText
+                            {
+                                Anchor = Anchor.Centre,
+                                Origin = Anchor.Centre,
+                                Shear = -barShear,
+                                Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold)
+                            }
+                        },
+                        new Container
+                        {
+                            CornerRadius = CORNER_RADIUS,
+                            RelativeSizeAxes = Axes.Both,
+                            Width = display_rel_width,
+                            Masking = true,
+                            Children = new Drawable[]
+                            {
+                                new Box
+                                {
+                                    Colour = colourProvider.Background3,
+                                    RelativeSizeAxes = Axes.Both,
+                                },
+                                modDisplay = new ModDisplay(showExtendedInformation: false)
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Shear = -barShear,
+                                    Scale = new Vector2(0.6f),
+                                    Current = { Value = new List<Mod> { new ModCinema() } },
+                                    ExpansionMode = ExpansionMode.AlwaysContracted,
+                                },
+                                modCountText = new OsuSpriteText
+                                {
+                                    Anchor = Anchor.Centre,
+                                    Origin = Anchor.Centre,
+                                    Shear = -barShear,
+                                    Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
+                                }
+                            }
+                        },
+                    }
+                },
+            });
+        }
+
+        private ModSettingChangeTracker? modSettingChangeTracker;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            Current.BindValueChanged(m =>
+            {
+                modSettingChangeTracker?.Dispose();
+
+                updateDisplay();
+
+                if (m.NewValue != null)
+                {
+                    modSettingChangeTracker = new ModSettingChangeTracker(m.NewValue);
+                    modSettingChangeTracker.SettingChanged += _ => updateDisplay();
+                }
+            }, true);
+
+            FinishTransforms(true);
+        }
+
+        private const double duration = 240;
+        private const Easing easing = Easing.OutQuint;
+
+        private void updateDisplay()
+        {
+            if (Current.Value.Count == 0)
+            {
+                modDisplayBar.MoveToY(20, duration, easing);
+                modDisplayBar.FadeOut(duration, easing);
+                modDisplay.FadeOut(duration, easing);
+                modCountText.FadeOut(duration, easing);
+
+                UnrankedBadge.MoveToY(20, duration, easing);
+                UnrankedBadge.FadeOut(duration, easing);
+
+                // add delay to let unranked indicator hide first before resizing the button back to its original width.
+                this.Delay(duration).ResizeWidthTo(BUTTON_WIDTH, duration, easing);
+            }
+            else
+            {
+                if (Current.Value.Count >= 5)
+                {
+                    modCountText.Text = $"{Current.Value.Count} MODS";
+                    modCountText.FadeIn(duration, easing);
+                    modDisplay.FadeOut(duration, easing);
+                }
+                else
+                {
+                    modDisplay.Current.Value = Current.Value;
+                    modDisplay.FadeIn(duration, easing);
+                    modCountText.FadeOut(duration, easing);
+                }
+
+                if (Current.Value.Any(m => !m.Ranked))
+                {
+                    UnrankedBadge.MoveToX(BUTTON_WIDTH + 5, duration, easing);
+                    UnrankedBadge.FadeIn(duration, easing);
+
+                    this.ResizeWidthTo(BUTTON_WIDTH + UnrankedBadge.DrawWidth + 10, duration, easing);
+                }
+                else
+                {
+                    UnrankedBadge.MoveToX(BUTTON_WIDTH + 5 - UnrankedBadge.DrawWidth, duration, easing);
+                    UnrankedBadge.FadeOut(duration, easing);
+
+                    this.ResizeWidthTo(BUTTON_WIDTH, duration, easing);
+                }
+
+                modDisplayBar.MoveToY(-5, duration, Easing.OutQuint);
+                UnrankedBadge.MoveToY(-5, duration, easing);
+                modDisplayBar.FadeIn(duration, easing);
+            }
+
+            double multiplier = Current.Value?.Aggregate(1.0, (current, mod) => current * mod.ScoreMultiplier) ?? 1;
+            MultiplierText.Text = ModUtils.FormatScoreMultiplier(multiplier);
+
+            if (multiplier > 1)
+                MultiplierText.FadeColour(colours.Red1, duration, easing);
+            else if (multiplier < 1)
+                MultiplierText.FadeColour(colours.Lime1, duration, easing);
+            else
+                MultiplierText.FadeColour(Color4.White, duration, easing);
         }
     }
 }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
index 2f5046d2bb..a7bd1b8abd 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
@@ -24,17 +24,18 @@ namespace osu.Game.Screens.Select.FooterV2
 {
     public partial class FooterButtonV2 : OsuClickableContainer, IKeyBindingHandler<GlobalAction>
     {
-        private const int button_height = 90;
-        private const int button_width = 140;
-        private const int corner_radius = 10;
         private const int transition_length = 500;
 
         // This should be 12 by design, but an extra allowance is added due to the corner radius specification.
         public const float SHEAR_WIDTH = 13.5f;
 
+        public const int CORNER_RADIUS = 10;
+        public const int BUTTON_HEIGHT = 90;
+        public const int BUTTON_WIDTH = 140;
+
         public Bindable<Visibility> OverlayState = new Bindable<Visibility>();
 
-        protected static readonly Vector2 SHEAR = new Vector2(SHEAR_WIDTH / button_height, 0);
+        protected static readonly Vector2 BUTTON_SHEAR = new Vector2(SHEAR_WIDTH / BUTTON_HEIGHT, 0);
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
@@ -70,68 +71,73 @@ namespace osu.Game.Screens.Select.FooterV2
 
         public FooterButtonV2()
         {
-            EdgeEffect = new EdgeEffectParameters
-            {
-                Type = EdgeEffectType.Shadow,
-                Radius = 4,
-                // Figma says 50% opacity, but it does not match up visually if taken at face value, and looks bad.
-                Colour = Colour4.Black.Opacity(0.25f),
-                Offset = new Vector2(0, 2),
-            };
-            Shear = SHEAR;
-            Size = new Vector2(button_width, button_height);
-            Masking = true;
-            CornerRadius = corner_radius;
-            Children = new Drawable[]
-            {
-                backgroundBox = new Box
-                {
-                    RelativeSizeAxes = Axes.Both
-                },
+            Size = new Vector2(BUTTON_WIDTH, BUTTON_HEIGHT);
+            Margin = new MarginPadding { Horizontal = SHEAR_WIDTH / 2f };
 
-                // For elements that should not be sheared.
-                new Container
+            Child = new Container
+            {
+                EdgeEffect = new EdgeEffectParameters
                 {
-                    Anchor = Anchor.CentreLeft,
-                    Origin = Anchor.CentreLeft,
-                    Shear = -SHEAR,
-                    RelativeSizeAxes = Axes.Both,
-                    Children = new Drawable[]
-                    {
-                        TextContainer = new Container
-                        {
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre,
-                            Y = 42,
-                            AutoSizeAxes = Axes.Both,
-                            Child = text = new OsuSpriteText
-                            {
-                                // figma design says the size is 16, but due to the issues with font sizes 19 matches better
-                                Font = OsuFont.TorusAlternate.With(size: 19),
-                                AlwaysPresent = true
-                            }
-                        },
-                        icon = new SpriteIcon
-                        {
-                            Y = 12,
-                            Size = new Vector2(20),
-                            Anchor = Anchor.TopCentre,
-                            Origin = Anchor.TopCentre
-                        },
-                    }
+                    Type = EdgeEffectType.Shadow,
+                    Radius = 4,
+                    // Figma says 50% opacity, but it does not match up visually if taken at face value, and looks bad.
+                    Colour = Colour4.Black.Opacity(0.25f),
+                    Offset = new Vector2(0, 2),
                 },
-                new Container
+                Shear = BUTTON_SHEAR,
+                Masking = true,
+                CornerRadius = CORNER_RADIUS,
+                RelativeSizeAxes = Axes.Both,
+                Children = new Drawable[]
                 {
-                    Shear = -SHEAR,
-                    Anchor = Anchor.BottomCentre,
-                    Origin = Anchor.Centre,
-                    Y = -corner_radius,
-                    Size = new Vector2(120, 6),
-                    Masking = true,
-                    CornerRadius = 3,
-                    Child = bar = new Box
+                    backgroundBox = new Box
                     {
+                        RelativeSizeAxes = Axes.Both
+                    },
+                    // For elements that should not be sheared.
+                    new Container
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Shear = -BUTTON_SHEAR,
                         RelativeSizeAxes = Axes.Both,
+                        Children = new Drawable[]
+                        {
+                            TextContainer = new Container
+                            {
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre,
+                                Y = 42,
+                                AutoSizeAxes = Axes.Both,
+                                Child = text = new OsuSpriteText
+                                {
+                                    // figma design says the size is 16, but due to the issues with font sizes 19 matches better
+                                    Font = OsuFont.TorusAlternate.With(size: 19),
+                                    AlwaysPresent = true
+                                }
+                            },
+                            icon = new SpriteIcon
+                            {
+                                Y = 12,
+                                Size = new Vector2(20),
+                                Anchor = Anchor.TopCentre,
+                                Origin = Anchor.TopCentre
+                            },
+                        }
+                    },
+                    new Container
+                    {
+                        Shear = -BUTTON_SHEAR,
+                        Anchor = Anchor.BottomCentre,
+                        Origin = Anchor.Centre,
+                        Y = -CORNER_RADIUS,
+                        Size = new Vector2(120, 6),
+                        Masking = true,
+                        CornerRadius = 3,
+                        Child = bar = new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                        }
                     }
                 }
             };

From d7b658ec76dff55ec15cd2751861fe04ef414668 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 02:21:06 +0300
Subject: [PATCH 780/930] Add similar test steps to song select footer test
 scene

---
 .../SongSelect/TestSceneSongSelectFooterV2.cs | 25 ++++++++++++++++++-
 1 file changed, 24 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
index 013bad55bc..0c7725db5a 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
@@ -1,6 +1,8 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System;
+using System.Collections.Generic;
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
@@ -10,7 +12,9 @@ using osu.Framework.Graphics.Cursor;
 using osu.Framework.Testing;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
+using osu.Game.Rulesets.Osu.Mods;
 using osu.Game.Screens.Select.FooterV2;
 using osuTK.Input;
 
@@ -47,7 +51,7 @@ namespace osu.Game.Tests.Visual.SongSelect
                 overlay = new DummyOverlay()
             };
 
-            footer.AddButton(modsButton = new FooterButtonModsV2(), overlay);
+            footer.AddButton(modsButton = new FooterButtonModsV2 { Current = SelectedMods }, overlay);
             footer.AddButton(randomButton = new FooterButtonRandomV2
             {
                 NextRandom = () => nextRandomCalled = true,
@@ -61,9 +65,28 @@ namespace osu.Game.Tests.Visual.SongSelect
         [SetUpSteps]
         public void SetUpSteps()
         {
+            AddStep("clear mods", () => SelectedMods.Value = Array.Empty<Mod>());
             AddStep("set beatmap", () => Beatmap.Value = CreateWorkingBeatmap(CreateBeatmap(new OsuRuleset().RulesetInfo)));
         }
 
+        [Test]
+        public void TestMods()
+        {
+            AddStep("one mod", () => SelectedMods.Value = new List<Mod> { new OsuModHidden() });
+            AddStep("two mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock() });
+            AddStep("three mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime() });
+            AddStep("four mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic() });
+            AddStep("five mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() });
+
+            AddStep("clear mods", () => SelectedMods.Value = Array.Empty<Mod>());
+            AddWaitStep("wait", 3);
+            AddStep("one mod", () => SelectedMods.Value = new List<Mod> { new OsuModHidden() });
+
+            AddStep("clear mods", () => SelectedMods.Value = Array.Empty<Mod>());
+            AddWaitStep("wait", 3);
+            AddStep("five mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() });
+        }
+
         [Test]
         public void TestShowOptions()
         {

From 49692e168eb8a7a72b93a6bb40f83f12575c4976 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 02:21:24 +0300
Subject: [PATCH 781/930] Fix `ModDisplay` expanding on load with "always
 contracted/expanded" modes

This is especially visible when reloading `SongSelectFooterV2` while multiple mods are already selected. The mods will appear expanded then contract.
---
 osu.Game/Screens/Play/HUD/ModDisplay.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/osu.Game/Screens/Play/HUD/ModDisplay.cs b/osu.Game/Screens/Play/HUD/ModDisplay.cs
index 75db720603..f8c8232d45 100644
--- a/osu.Game/Screens/Play/HUD/ModDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/ModDisplay.cs
@@ -60,6 +60,9 @@ namespace osu.Game.Screens.Play.HUD
             Current.BindValueChanged(updateDisplay, true);
 
             iconsContainer.FadeInFromZero(fade_duration, Easing.OutQuint);
+
+            if (ExpansionMode == ExpansionMode.AlwaysExpanded || ExpansionMode == ExpansionMode.AlwaysContracted)
+                FinishTransforms(true);
         }
 
         private void updateDisplay(ValueChangedEvent<IReadOnlyList<Mod>> mods)

From bff34a1c04f8151c053a1c32b31043b26f4e520c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 06:38:48 +0300
Subject: [PATCH 782/930] Add localisation and tooltip for mods count text

---
 .../SongSelect/TestSceneSongSelectFooterV2.cs |  6 ++
 .../TestSceneFooterButtonModsV2.cs            |  4 ++
 .../Localisation/FooterButtonModsV2Strings.cs | 19 ++++++
 .../Select/FooterV2/FooterButtonModsV2.cs     | 62 +++++++++++++++++--
 4 files changed, 87 insertions(+), 4 deletions(-)
 create mode 100644 osu.Game/Localisation/FooterButtonModsV2Strings.cs

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
index 0c7725db5a..93402e42ce 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
@@ -78,6 +78,12 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("four mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic() });
             AddStep("five mods", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() });
 
+            AddStep("modified", () => SelectedMods.Value = new List<Mod> { new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } });
+            AddStep("modified + one", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } });
+            AddStep("modified + two", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } });
+            AddStep("modified + three", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModClassic(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } });
+            AddStep("modified + four", () => SelectedMods.Value = new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModClassic(), new OsuModDifficultyAdjust(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } });
+
             AddStep("clear mods", () => SelectedMods.Value = Array.Empty<Mod>());
             AddWaitStep("wait", 3);
             AddStep("one mod", () => SelectedMods.Value = new List<Mod> { new OsuModHidden() });
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
index 7e8bba6573..af2eea6062 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
@@ -44,6 +44,10 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("four mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic() }));
             AddStep("five mods", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime(), new OsuModClassic(), new OsuModDifficultyAdjust() }));
 
+            AddStep("modified", () => changeMods(new List<Mod> { new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } }));
+            AddStep("modified + one", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } }));
+            AddStep("modified + two", () => changeMods(new List<Mod> { new OsuModHidden(), new OsuModHardRock(), new OsuModDoubleTime { SpeedChange = { Value = 1.2 } } }));
+
             AddStep("clear mods", () => changeMods(Array.Empty<Mod>()));
             AddWaitStep("wait", 3);
             AddStep("one mod", () => changeMods(new List<Mod> { new OsuModHidden() }));
diff --git a/osu.Game/Localisation/FooterButtonModsV2Strings.cs b/osu.Game/Localisation/FooterButtonModsV2Strings.cs
new file mode 100644
index 0000000000..2cb297d8ef
--- /dev/null
+++ b/osu.Game/Localisation/FooterButtonModsV2Strings.cs
@@ -0,0 +1,19 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Localisation;
+
+namespace osu.Game.Localisation
+{
+    public static class FooterButtonModsV2Strings
+    {
+        private const string prefix = @"osu.Game.Resources.Localisation.FooterButtonModsV2";
+
+        /// <summary>
+        /// "{0} mods"
+        /// </summary>
+        public static LocalisableString Mods(int count) => new TranslatableString(getKey(@"mods"), @"{0} mods", count);
+
+        private static string getKey(string key) => $@"{prefix}:{key}";
+    }
+}
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index f9d923ddcf..7beadd1576 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -9,12 +9,14 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.LocalisationExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
+using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
@@ -155,15 +157,16 @@ namespace osu.Game.Screens.Select.FooterV2
                                     Origin = Anchor.Centre,
                                     Shear = -barShear,
                                     Scale = new Vector2(0.6f),
-                                    Current = { Value = new List<Mod> { new ModCinema() } },
+                                    Current = { BindTarget = Current },
                                     ExpansionMode = ExpansionMode.AlwaysContracted,
                                 },
-                                modCountText = new OsuSpriteText
+                                modCountText = new ModCountText
                                 {
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
                                     Shear = -barShear,
                                     Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
+                                    Mods = { BindTarget = Current },
                                 }
                             }
                         },
@@ -216,13 +219,11 @@ namespace osu.Game.Screens.Select.FooterV2
             {
                 if (Current.Value.Count >= 5)
                 {
-                    modCountText.Text = $"{Current.Value.Count} MODS";
                     modCountText.FadeIn(duration, easing);
                     modDisplay.FadeOut(duration, easing);
                 }
                 else
                 {
-                    modDisplay.Current.Value = Current.Value;
                     modDisplay.FadeIn(duration, easing);
                     modCountText.FadeOut(duration, easing);
                 }
@@ -257,5 +258,58 @@ namespace osu.Game.Screens.Select.FooterV2
             else
                 MultiplierText.FadeColour(Color4.White, duration, easing);
         }
+
+        private partial class ModCountText : OsuSpriteText, IHasCustomTooltip<IReadOnlyList<Mod>>
+        {
+            public readonly Bindable<IReadOnlyList<Mod>> Mods = new Bindable<IReadOnlyList<Mod>>();
+
+            protected override void LoadComplete()
+            {
+                base.LoadComplete();
+                Mods.BindValueChanged(v => Text = FooterButtonModsV2Strings.Mods(v.NewValue.Count).ToUpper(), true);
+            }
+
+            public ITooltip<IReadOnlyList<Mod>> GetCustomTooltip() => new ModTooltip();
+
+            public IReadOnlyList<Mod>? TooltipContent => Mods.Value;
+
+            public partial class ModTooltip : VisibilityContainer, ITooltip<IReadOnlyList<Mod>>
+            {
+                private ModDisplay extendedModDisplay = null!;
+
+                [BackgroundDependencyLoader]
+                private void load(OverlayColourProvider colourProvider)
+                {
+                    AutoSizeAxes = Axes.Both;
+                    CornerRadius = CORNER_RADIUS;
+                    Masking = true;
+
+                    InternalChildren = new Drawable[]
+                    {
+                        new Box
+                        {
+                            RelativeSizeAxes = Axes.Both,
+                            Colour = colourProvider.Background5,
+                        },
+                        extendedModDisplay = new ModDisplay
+                        {
+                            Margin = new MarginPadding { Vertical = 2f, Horizontal = 10f },
+                            Scale = new Vector2(0.6f),
+                            ExpansionMode = ExpansionMode.AlwaysExpanded,
+                        },
+                    };
+                }
+
+                public void SetContent(IReadOnlyList<Mod> content)
+                {
+                    extendedModDisplay.Current.Value = content;
+                }
+
+                public void Move(Vector2 pos) => Position = pos;
+
+                protected override void PopIn() => this.FadeIn(240, Easing.OutQuint);
+                protected override void PopOut() => this.FadeOut(240, Easing.OutQuint);
+            }
+        }
     }
 }

From c1ea9d2c9fd5c63f1c43830870e74a0bb090139a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 06:39:06 +0300
Subject: [PATCH 783/930] Adjust unranked badge height

---
 osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index 7beadd1576..ba4abc4025 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -78,7 +78,8 @@ namespace osu.Game.Screens.Select.FooterV2
                     Origin = Anchor.BottomLeft,
                     Shear = barShear,
                     CornerRadius = CORNER_RADIUS,
-                    AutoSizeAxes = Axes.Both,
+                    AutoSizeAxes = Axes.X,
+                    Height = bar_height,
                     Masking = true,
                     BorderColour = Color4.White,
                     BorderThickness = 2f,
@@ -91,9 +92,12 @@ namespace osu.Game.Screens.Select.FooterV2
                         },
                         new OsuSpriteText
                         {
+                            Anchor = Anchor.Centre,
+                            Origin = Anchor.Centre,
                             Shear = -barShear,
                             Text = ModSelectOverlayStrings.Unranked.ToUpper(),
-                            Margin = new MarginPadding { Horizontal = 15, Vertical = 5 },
+                            Margin = new MarginPadding { Horizontal = 15 },
+                            UseFullGlyphHeight = false,
                             Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
                             Colour = Color4.Black,
                         }
@@ -135,6 +139,7 @@ namespace osu.Game.Screens.Select.FooterV2
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
                                 Shear = -barShear,
+                                UseFullGlyphHeight = false,
                                 Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold)
                             }
                         },

From 6ddf8f849805e203fbfb0469cce923c0e9af2f68 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 06:47:48 +0300
Subject: [PATCH 784/930] Few cleanups

---
 osu.Game/Screens/Play/HUD/ModDisplay.cs               |  2 +-
 .../Screens/Select/FooterV2/FooterButtonModsV2.cs     |  7 +++----
 osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs    | 11 +++++------
 osu.Game/Screens/Select/FooterV2/FooterV2.cs          |  2 +-
 4 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Play/HUD/ModDisplay.cs b/osu.Game/Screens/Play/HUD/ModDisplay.cs
index f8c8232d45..b37d41e7a2 100644
--- a/osu.Game/Screens/Play/HUD/ModDisplay.cs
+++ b/osu.Game/Screens/Play/HUD/ModDisplay.cs
@@ -20,7 +20,6 @@ namespace osu.Game.Screens.Play.HUD
     /// </summary>
     public partial class ModDisplay : CompositeDrawable, IHasCurrentValue<IReadOnlyList<Mod>>
     {
-        private readonly bool showExtendedInformation;
         private const int fade_duration = 1000;
 
         public ExpansionMode ExpansionMode = ExpansionMode.ExpandOnHover;
@@ -38,6 +37,7 @@ namespace osu.Game.Screens.Play.HUD
             }
         }
 
+        private readonly bool showExtendedInformation;
         private readonly FillFlowContainer<ModIcon> iconsContainer;
 
         public ModDisplay(bool showExtendedInformation = true)
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index ba4abc4025..bb259898ea 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -16,7 +16,6 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
-using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
@@ -61,7 +60,7 @@ namespace osu.Game.Screens.Select.FooterV2
         {
             const float bar_shear_width = 7f;
             const float bar_height = 37f;
-            const float display_rel_width = 0.65f;
+            const float mod_display_portion = 0.65f;
 
             var barShear = new Vector2(bar_shear_width / bar_height, 0);
 
@@ -132,7 +131,7 @@ namespace osu.Game.Screens.Select.FooterV2
                             Anchor = Anchor.CentreRight,
                             Origin = Anchor.CentreRight,
                             RelativeSizeAxes = Axes.Both,
-                            Width = 1f - display_rel_width,
+                            Width = 1f - mod_display_portion,
                             Masking = true,
                             Child = MultiplierText = new OsuSpriteText
                             {
@@ -147,7 +146,7 @@ namespace osu.Game.Screens.Select.FooterV2
                         {
                             CornerRadius = CORNER_RADIUS,
                             RelativeSizeAxes = Axes.Both,
-                            Width = display_rel_width,
+                            Width = mod_display_portion,
                             Masking = true,
                             Children = new Drawable[]
                             {
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
index a7bd1b8abd..2c841f6ae6 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
@@ -27,15 +27,15 @@ namespace osu.Game.Screens.Select.FooterV2
         private const int transition_length = 500;
 
         // This should be 12 by design, but an extra allowance is added due to the corner radius specification.
-        public const float SHEAR_WIDTH = 13.5f;
+        private const float shear_width = 13.5f;
 
-        public const int CORNER_RADIUS = 10;
-        public const int BUTTON_HEIGHT = 90;
-        public const int BUTTON_WIDTH = 140;
+        protected const int CORNER_RADIUS = 10;
+        protected const int BUTTON_HEIGHT = 90;
+        protected const int BUTTON_WIDTH = 140;
 
         public Bindable<Visibility> OverlayState = new Bindable<Visibility>();
 
-        protected static readonly Vector2 BUTTON_SHEAR = new Vector2(SHEAR_WIDTH / BUTTON_HEIGHT, 0);
+        protected static readonly Vector2 BUTTON_SHEAR = new Vector2(shear_width / BUTTON_HEIGHT, 0);
 
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
@@ -72,7 +72,6 @@ namespace osu.Game.Screens.Select.FooterV2
         public FooterButtonV2()
         {
             Size = new Vector2(BUTTON_WIDTH, BUTTON_HEIGHT);
-            Margin = new MarginPadding { Horizontal = SHEAR_WIDTH / 2f };
 
             Child = new Container
             {
diff --git a/osu.Game/Screens/Select/FooterV2/FooterV2.cs b/osu.Game/Screens/Select/FooterV2/FooterV2.cs
index 0529f0d082..370c28e2a5 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterV2.cs
@@ -72,7 +72,7 @@ namespace osu.Game.Screens.Select.FooterV2
                     Anchor = Anchor.BottomLeft,
                     Origin = Anchor.BottomLeft,
                     Direction = FillDirection.Horizontal,
-                    Spacing = new Vector2(-FooterButtonV2.SHEAR_WIDTH + 7, 0),
+                    Spacing = new Vector2(7, 0),
                     AutoSizeAxes = Axes.Both
                 }
             };

From e5b2023155006c15ecb7673d4395c612e400bce3 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 07:05:32 +0300
Subject: [PATCH 785/930] Remove unappealing fade transition between mod
 display and count text

Fading out the mod display looks quite ugly, since alpha is applied per mod sprite, introducing bad visual on the intersection between mods.
---
 .../Screens/Select/FooterV2/FooterButtonModsV2.cs   | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index bb259898ea..ed558d513b 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -221,16 +221,13 @@ namespace osu.Game.Screens.Select.FooterV2
             }
             else
             {
+                modDisplay.Hide();
+                modCountText.Hide();
+
                 if (Current.Value.Count >= 5)
-                {
-                    modCountText.FadeIn(duration, easing);
-                    modDisplay.FadeOut(duration, easing);
-                }
+                    modCountText.Show();
                 else
-                {
-                    modDisplay.FadeIn(duration, easing);
-                    modCountText.FadeOut(duration, easing);
-                }
+                    modDisplay.Show();
 
                 if (Current.Value.Any(m => !m.Ranked))
                 {

From f5ab9a7ff863a2f32870b6d517448b4c8a4b18c6 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 07:12:28 +0300
Subject: [PATCH 786/930] Make unranked indicator orange to match mod select
 overlay

---
 osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index ed558d513b..3937f1e42a 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -86,7 +86,7 @@ namespace osu.Game.Screens.Select.FooterV2
                     {
                         new Box
                         {
-                            Colour = colours.Red2,
+                            Colour = colours.Orange2,
                             RelativeSizeAxes = Axes.Both,
                         },
                         new OsuSpriteText

From 0392f7b04cfb913f5fe23ddc0da3726ffcbb7d80 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 07:36:59 +0300
Subject: [PATCH 787/930] Add tooltip to unranked indicator

---
 osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index 3937f1e42a..08b0407a79 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -14,6 +14,7 @@ using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Localisation;
 using osu.Game.Configuration;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
@@ -70,7 +71,7 @@ namespace osu.Game.Screens.Select.FooterV2
 
             AddRange(new[]
             {
-                UnrankedBadge = new Container
+                UnrankedBadge = new ContainerWithTooltip
                 {
                     Position = new Vector2(BUTTON_WIDTH + 5f, -5f),
                     Depth = float.MaxValue,
@@ -82,6 +83,7 @@ namespace osu.Game.Screens.Select.FooterV2
                     Masking = true,
                     BorderColour = Color4.White,
                     BorderThickness = 2f,
+                    TooltipText = ModSelectOverlayStrings.UnrankedExplanation,
                     Children = new Drawable[]
                     {
                         new Box
@@ -312,5 +314,10 @@ namespace osu.Game.Screens.Select.FooterV2
                 protected override void PopOut() => this.FadeOut(240, Easing.OutQuint);
             }
         }
+
+        private partial class ContainerWithTooltip : Container, IHasTooltip
+        {
+            public LocalisableString TooltipText { get; set; }
+        }
     }
 }

From b6d6a8940bfb15313b8787185f45463391a79f1f Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 08:24:39 +0300
Subject: [PATCH 788/930] Improve animation of new song select footer buttons

---
 .../Screens/Select/FooterV2/FooterButtonV2.cs | 66 +++++++++----------
 1 file changed, 31 insertions(+), 35 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
index 2c841f6ae6..21337327fa 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
@@ -24,8 +24,6 @@ namespace osu.Game.Screens.Select.FooterV2
 {
     public partial class FooterButtonV2 : OsuClickableContainer, IKeyBindingHandler<GlobalAction>
     {
-        private const int transition_length = 500;
-
         // This should be 12 by design, but an extra allowance is added due to the corner radius specification.
         private const float shear_width = 13.5f;
 
@@ -68,6 +66,7 @@ namespace osu.Game.Screens.Select.FooterV2
         protected Container TextContainer;
         private readonly Box bar;
         private readonly Box backgroundBox;
+        private readonly Box flashLayer;
 
         public FooterButtonV2()
         {
@@ -137,8 +136,15 @@ namespace osu.Game.Screens.Select.FooterV2
                         {
                             RelativeSizeAxes = Axes.Both,
                         }
-                    }
-                }
+                    },
+                    flashLayer = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Colour = Colour4.White.Opacity(0.9f),
+                        Blending = BlendingParameters.Additive,
+                        Alpha = 0,
+                    },
+                },
             };
         }
 
@@ -154,7 +160,15 @@ namespace osu.Game.Screens.Select.FooterV2
 
         public GlobalAction? Hotkey;
 
-        private bool handlingMouse;
+        protected override bool OnClick(ClickEvent e)
+        {
+            if (Enabled.Value)
+                Flash();
+
+            return base.OnClick(e);
+        }
+
+        protected virtual void Flash() => flashLayer.FadeOutFromOne(800, Easing.OutQuint);
 
         protected override bool OnHover(HoverEvent e)
         {
@@ -162,20 +176,6 @@ namespace osu.Game.Screens.Select.FooterV2
             return true;
         }
 
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            handlingMouse = true;
-            updateDisplay();
-            return base.OnMouseDown(e);
-        }
-
-        protected override void OnMouseUp(MouseUpEvent e)
-        {
-            handlingMouse = false;
-            updateDisplay();
-            base.OnMouseUp(e);
-        }
-
         protected override void OnHoverLost(HoverLostEvent e) => updateDisplay();
 
         public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
@@ -190,27 +190,23 @@ namespace osu.Game.Screens.Select.FooterV2
 
         private void updateDisplay()
         {
-            Color4 backgroundColour = colourProvider.Background3;
+            Color4 backgroundColour = OverlayState.Value == Visibility.Visible ? buttonAccentColour : colourProvider.Background3;
+            Color4 textColour = OverlayState.Value == Visibility.Visible ? colourProvider.Background6 : colourProvider.Content1;
+            Color4 accentColour = OverlayState.Value == Visibility.Visible ? colourProvider.Background6 : buttonAccentColour;
 
             if (!Enabled.Value)
-            {
-                backgroundColour = colourProvider.Background3.Darken(0.4f);
-            }
-            else
-            {
-                if (OverlayState.Value == Visibility.Visible)
-                    backgroundColour = buttonAccentColour.Darken(0.5f);
+                backgroundColour = backgroundColour.Darken(1f);
+            else if (IsHovered)
+                backgroundColour = backgroundColour.Lighten(0.2f);
 
-                if (IsHovered)
-                {
-                    backgroundColour = backgroundColour.Lighten(0.3f);
+            backgroundBox.FadeColour(backgroundColour, 150, Easing.OutQuint);
 
-                    if (handlingMouse)
-                        backgroundColour = backgroundColour.Lighten(0.3f);
-                }
-            }
+            if (!Enabled.Value)
+                textColour = textColour.Opacity(0.6f);
 
-            backgroundBox.FadeColour(backgroundColour, transition_length, Easing.OutQuint);
+            text.FadeColour(textColour, 150, Easing.OutQuint);
+            icon.FadeColour(accentColour, 150, Easing.OutQuint);
+            bar.FadeColour(accentColour, 150, Easing.OutQuint);
         }
     }
 }

From 09c52f03d8ea7ed896721a9ce629ec58d8d67e0c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Fri, 10 May 2024 08:25:16 +0300
Subject: [PATCH 789/930] Fix "options" button behaving weirdly when clicking
 on it while open

---
 .../Select/FooterV2/BeatmapOptionsPopover.cs  |  6 +--
 .../Select/FooterV2/FooterButtonOptionsV2.cs  | 43 ++++++++++---------
 2 files changed, 25 insertions(+), 24 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs b/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
index f81036f745..648f536bb1 100644
--- a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
+++ b/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
@@ -188,9 +188,9 @@ namespace osu.Game.Screens.Select.FooterV2
         protected override void UpdateState(ValueChangedEvent<Visibility> state)
         {
             base.UpdateState(state);
-
-            if (state.NewValue == Visibility.Hidden)
-                footerButton.IsActive.Value = false;
+            // intentionally scheduling to let the button have a chance whether the popover will hide from clicking the button or clicking outside
+            // see the "hidingFromClick" field in FooterButtonOptionsV2.
+            Schedule(() => footerButton.OverlayState.Value = state.NewValue);
         }
     }
 }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
index a1559d32dc..2ed8480b46 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
@@ -2,12 +2,12 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
+using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Input.Bindings;
 
@@ -15,7 +15,10 @@ namespace osu.Game.Screens.Select.FooterV2
 {
     public partial class FooterButtonOptionsV2 : FooterButtonV2, IHasPopover
     {
-        public readonly BindableBool IsActive = new BindableBool();
+        /// <summary>
+        /// True if the next click is for hiding the popover.
+        /// </summary>
+        private bool hidingFromClick;
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colour)
@@ -25,31 +28,29 @@ namespace osu.Game.Screens.Select.FooterV2
             AccentColour = colour.Purple1;
             Hotkey = GlobalAction.ToggleBeatmapOptions;
 
-            Action = () => IsActive.Toggle();
+            Action = () =>
+            {
+                if (OverlayState.Value == Visibility.Hidden && !hidingFromClick)
+                    this.ShowPopover();
+
+                hidingFromClick = false;
+            };
         }
 
-        protected override void LoadComplete()
+        protected override bool OnMouseDown(MouseDownEvent e)
         {
-            base.LoadComplete();
+            if (OverlayState.Value == Visibility.Visible)
+                hidingFromClick = true;
 
-            IsActive.BindValueChanged(active =>
-            {
-                OverlayState.Value = active.NewValue ? Visibility.Visible : Visibility.Hidden;
-            });
+            return base.OnMouseDown(e);
+        }
 
-            OverlayState.BindValueChanged(state =>
-            {
-                switch (state.NewValue)
-                {
-                    case Visibility.Hidden:
-                        this.HidePopover();
-                        break;
+        protected override void Flash()
+        {
+            if (hidingFromClick)
+                return;
 
-                    case Visibility.Visible:
-                        this.ShowPopover();
-                        break;
-                }
-            });
+            base.Flash();
         }
 
         public Popover GetPopover() => new BeatmapOptionsPopover(this);

From bc6f3b8cb41570e8a8d85491abcd5e75b096c064 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 13:48:08 +0800
Subject: [PATCH 790/930] Update iOS logo

---
 ...0-5cbe0121-ed68-414f-9ddc-dd993ac97e62.png | Bin 453879 -> 394881 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/osu.iOS/Assets.xcassets/AppIcon.appiconset/300076680-5cbe0121-ed68-414f-9ddc-dd993ac97e62.png b/osu.iOS/Assets.xcassets/AppIcon.appiconset/300076680-5cbe0121-ed68-414f-9ddc-dd993ac97e62.png
index 9287a71040091fb7a249018bff4133b91b12e1fc..7b62835cdcfa85d60814f17a89653e2b389a520f 100644
GIT binary patch
literal 394881
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

literal 453879
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%0DuE%i-Ir2-IY<L?d}8s#h9<N
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
K)~(TTivAB8ZcmZ`


From c25ed2cddde9764306fbbdcd490101eb6fb72aad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 14:12:32 +0800
Subject: [PATCH 791/930] Update desktop logo

---
 osu.Desktop/lazer.ico | Bin 76552 -> 76679 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/osu.Desktop/lazer.ico b/osu.Desktop/lazer.ico
index a3280f0de0b6a935309c84594e8b83cdb7d2e43f..24c1c29ba269aaeb38a9b9c604a1c364c986a753 100644
GIT binary patch
literal 76679
zcmaI61ymf()+jo-4esvl7Tn!kgA5MA-Q6X)2X_mQ013e@xI-X82MZ3vK!P)m@0@e*
zf7ZM2zFMohcWvKQwMx1+000L-1pHIr05kxVO8`Le73SgjcioW*07!eq(a`+6&Vma7
z+!De8aB%)Ze-))>h65yOYbs%)lcB$gVyY<1>;6Oi=Rrk&{g`>x*}r}e9b`0Q0Dw<v
z7*AG6uXP$5WnB#bAn4UZL<|7%@QR8!0swqpO`m`O0MUE^fY_s`OGo^bplxTYVy~eA
zV0(p80q}5m0EAZv?jI}hPXF@%AA7HwUJF7Q-2YI^;QtpD4p4^hKkz?{zCr><002Cn
zlfJQ!v4*;+jk_zCm94wA9an&>$3F}J@c_|R(ACbziYCC-#m!qZK!WaH9HOuAKWJ_`
znt!qQI7`qOYiQHRxqI2syy4>E;-Qm7r=g({_p-GY)s<KLkN9g%g3i&$$3v8x+uz@x
z%b%ai-OGWSS42dFn}?5^kB{?}gVQ_E&BrQ$)6JXy-%9?M9(g-&8!smhA18M=nt$|K
zS-boCNYK&!W9WaEfBR_{;PgM1+`Ru2)@y*=|4_Jjxp=t$zr=i;?Ef!f|4{xd_OH19
zZBG0jWun?n0d_7X@=mUHZr-o1N%9H45&xH&|AX>Bj{cXV@&8rwzbOB2NjY~HcP~8;
zD;qmW-v1c;FVuf=|Kqo)mY0*=Ym@%daR0FXAGrVUi*x_es{hr>|L($nVPE@D5?!48
ze~$-A^fE$xEdW3opdv4$9{_jO>yU0Y;d_{OuznkG$%6p22O-DNSUG|n^SawjIjfCT
z1#r<nPQR<3uYIo3j=7Op49k+mO)~Jvqs4b_&t@^jrBQ}wP#(gM9ux-I^K9L;UwXBu
z!nR>W-j|^*joqgP{&P3e`i2KH(^+HHVnY1xTaTvezTJYYZxR0gU+%GF`GM>N&>6GQ
znVA`doXfH&PH6moOU5>LKld|StkKk5O+T9)lEb$Q8l?j?ttsxQmMQ9q8<kk@seZa}
z*_R&$1qBAN-4~dq2;InF%ta5fBjE1(f%|m&oz*@0J}Crv)=O%sn_xvVlBM<52J!d)
z+#v~s911)W3``khz0bJ;h5+G4%Yj2}Nz_^4sxQINxhbBWDvwq39l=&-K=T0dBIuAS
ztmSE)&vt&VCFhV!3w4(2KJb2Z$yHUj4cQ(zO^{ESK8hn=Ks5}BNf}B;_unMc|Hm72
zM<C{1clD?Q^fJ3&tK|4e1G+lJ4=LE~U!aJCvl+;Q8y-jjR6_EfRu8E2WN3O%Eyl=x
z3IbZ>4h|__p7EYTp};Wl=x6&t<fjiE<~-=r@Flt7GE_DYjr*2yDZ1zZsP$@ZoFK&h
z+_A-q&`m2FS;GGgdxHOHn=9NQsOH+;VC)6{5oH?Dm`R)^P38`IaVFgXA?q|p@E~Om
z<T(mgw$9&LEpxDOTP-$6aAB~<>7$1UK{*It%tirwt*2aam}g`WYG(ChH%;5$reJkX
z-TS0B>Q{&R{+oZD!719M8R5oMauB5ZxhWC~qs~(<oqq{vXOP{9d&9!+)5gQ~Unrqx
zyZu{YH@Z6-JDT+b+c^$~5MpR)7A;NRDc5IYKg<CI{W9d2k94qnasS|p2mc96_Wn~Y
zOH6U@mF-Me<`eOORGS#PHs{&=Iavgyei5?dhX5&h7+T=UU-c{h%fAgVtMi}aLGIwj
zSFJE}(x}a`q=p2ijb^x?_O4FzdPZlv;e5|1gkI?GtGzFR0~Uiq`zBOR<fQN=3};=g
z%LC1Dozjd44=+kFf1LtXZa1!4vihwzkM_ORh1=E?nF*Rt1TG!h-fOnB7rdYO!YU=&
zvAAYmPn}Wl>(`rLkj_BC8-B4R`&;ggg1|vkhr_jvatT*ADHQA$$1${#mWgn~uvHwF
z%KFzxMc7y`@1&Z}EHe*zsg}ZK*ZMEqynTB=Qj0CEScq;ZwiL~SEnH8PG)K!EAlxk-
zGaWkXW(#1;ZAZ3b&A(|OT?s6TR-^cZBu{3(t1kR%-;#7%@=ccIFi2wykOpmW#y^;t
zI(k16tv~%haUmgUHVANZ|Iq)=lHP4&wb!o+kcMwUc19M3(LUA;mtR*ls1GB~{%#Hn
zg>H~p5(|ljb$yh4eD^k3C;GV#SpwnZho0-+O<@mmH?kD6RhCC+)nM<e#0G+>+cnt;
z@MyUtk}8!4C=Fl4r*9ZVkrK-dzm@<no_CQ}jF@jj01lTZj2&W~Ibp0)yI=@Wxg~$K
z*d%HevkkZkrySZO9YkX54H`z8-y-{UvVU7wCB+W&hBjRVCSM5pI&+sgHfm8jv2O=|
zM+o=1@mUvUYH@n3xj4hRc5D9jt@f06z<b`CId7EeuxrYHPeNnBk8ESFM0Xv2Kph#b
zj3RDeRGNuyH_Fv9H*z9BOGmhM`S*SS=`_^{4aK`_AqqFOua@+c9`Eh3TLN<`-o!<;
zA%?TSxNQ+dqIypC5!R2f-5-*4m3}X5_Orvj9&B^N3SBRF>+(uNzI_DuKU%-dgCpSu
z3x21jTqXZniHQmAOrGNdlY#}uo%*=AK5iD0L^v8EhmT|%@l<q5(k}`Q(C4fU4%`+=
zN1KaS0qAB0Q-*7{XbsJRf#e^OK5dst<zh_}@Su9HQb5i?JHH#(wz}ONlfRl(_pJI@
z!pT8I?!&oYN)2Q9=-Z2KpUHcw+2kk-1fQArVXpVod4~kscK+(8bK=mDx1qApFZFp6
zM-t$)lb)$U<R0XQv!Xa&1k3QY6x*R?7e~Yhu~lK-=13mx`1j<V&6A$i`Q%^_b?yLy
zMBq(2$<1sdYh=90jT0c->51!o<WEQPwS@f^D;xni5ED;rXms`0?Vq`}z+AVbGjPMI
zt>3^SO4<~xKs*kd+%RVl>#icSfUza&TQ)f7)N7dqdkejtuw3!&LwO#a>o^#*c<tEU
z#g&d4hk19$+O23agfK&dl7(Zdx#CSK<(G^%aa?gf46MG`g5)LjZu=r1DZI|dZyaZC
zXaLj2RDGMqw>Vf8Wcvyw!|P|(aRcgrzYq8bFK@gI2Qsaq?V|JNpgucfqzJAITw8(W
z>$d}xu5;$A{Y1eiA!jk~hosUSOdz=-K0j}<e+<1Htmo(3gazJPX2bHIXz!<Xf4;X2
zyAjzwH=<g-d5Nub-AkysU2C=RnDdOkynq6&<0MPZ7eEGmy^BC|A%a$Qd=<yv3b^Qs
zlLByls{2%sKY#%zC}~}R65icDK!}EP6rfd9wVIAaR!e%3aanHJ7Rd+5jgK5)aopo`
zK;aj+>dcUcmUEpGb9)zj*<H=K;nhJU#WncHOQeK^hy2d+VB4z}y-kJNXwyO@<cAY0
zd)oC&=sk5-zue2BnD5Dt!_*T^Scus5OzrwfR@ZvJ*Jsz0D~jl>?w(#nQiRQ=#}t03
zH5Sec9<sFlFV%T5Hh@)4SB50AcbJs2n3*cDLP<E$gJI@F6&+h#6v=p`4ugzih&k%}
z1L69ZL>b^qgo|zJ73p07&%l&$Th#juD$52ud+f{WY0yi}uq*8G!X@~!zk_p}$Bb$0
zGnn>%I~TUCf7z4!l<Q&sp}#<_5o^@ER73I!WuN<=GuGk4q3=;w>>9k}dSC8flN2uR
z93)Zr;fD+vb`T~jvS2jTrPMB3o<-6Q!rc44r%9cXi2ZfkvF78_$k?kR^IcRhNghcl
z+_-QLNkS|p2`O3D+fD#h8%Ylj78cN+1dt>wQbNvvdrSfe3E<hKoEC_bvbHblau!Vy
z@GpLY-Qn4JSS<AQnL6O@+o1J7Z;$*`q+RgBEM7SI$?N?389MwK`E(qDTW%iG_5*wT
zud7!)y#qUn7mHt(Ev2>$`~9olTZk^a(K=eDM97QO%I_n8BBQ+;11&*}*!2qs_k^WI
znn_Ttsou^qqoCMdj_S?+Efdm=S7uPM(K`8wV`|K#r}$N#L>y1P6D0&1T`~ytnxV3W
zkdqk$y&x29SY0nJK-9>oYlgu##9b1ESpFjZPJ=jb--q?S+sz-j?G7HKxhT`feVj1Z
zc>l2jf}17bjmF_}Vt~T!>okCHpEhN=s24IEdHLu0dTcGl5908LW5YQZJ4oZ!V7Mzz
z1~kAn139{QfS*StK{4C-PH)jV;PJ(ChE^NC&bgFf6z7zd#+Ow=Aoonvn4!C|9>2vS
zs_Jf(hKgPr-tn`aVP2***t`!9ceP`8G*Mu509hs&`IEk~P5Os;{>R_zJ@$ynYaAPo
z7wfjbi%yEM>|f+}Huo@<7p-L?_eo}?AAM|lAI6*@-i9#h$=6w-Xp_2>5~Edb75nM3
zo$&mq?Zeza=^l={(9vG=<yat|esnS1xzvxK7{PV~>SFjIkBJ@uoc)~$zJQ7ys476^
zn>sP-`j9j|VoS6ZIO`0WWREJQMA22j5j1tYk0gNHdqYBoXh%rFD1pEeV?;8Z!Kxe}
zME^5|bg(9seU55to#?W!kMiy%m@A$ZtOEB4*Ut*;uY1;H3DFZNJkr=()?vXW5ACOW
zU6oeHE%CmV*Gql~VuqbujZ%i+>?Xd^I}Lu{BvP`u?wk-bpNpFinc@k$3leQ%nIA|N
zR#mh?4C6Zg7(7_~b9XnyTtG8Z33E)D{|QG+lIsp>mcg~cM;Kg+q-KwVa_BM!J~yA>
za*U<<&VypayQmJMuNLO%9jFo~N5LXJ#@-vK*<lgFEWkYrZLvq7?rb~{eALJba)J~s
z-y1>u%ilaE4GFz(?1RK{r;DQb-}lqQUPrL=<)X`t6IqZcc`$Py#N%z?P3)T>8UK*t
zS)0%~{q1lv9N*hoS&3H6Ymc;J6erBaIuG-lH(YlQm3sW3--y)y3VH~*O+!{p>A?t5
znZq4-gj7FkCQ&nkDDW{CDgA7L%^CdJ)Oblk(O=tHe#ubTu^VcV3bn?61Nvcm#+D5%
zF=OO3^yH&~7<kapc@b&2X6|`+xBR!auwLfHxc}JiIMrX9+=o~Eecof6BA2Mr*oJ6Q
zMw`D_=E3alUpIkI*_O{ve}2)E-KDiJS%y}8lzMK^I_CXRN^u7a*nVdG>50j_C_KuK
zupMs!Uy<z{K^B>cSuD3C-6(E@m)bosC|07z7Wa<&FUkCFoY?~IFEGjhk5KwY>KLzB
zy`G3a(ZXJlgi_X_lJ(i{1*BReL5OZ<cHtk%$$km2Y$Ma?Qa#z>D4yXSx!bqQ;ybo^
zTn5{rO8(XC&ySf_0~_OoXuOn8!Y&)Kgq|`ZR)XZjeDl}!BVhV3+gbg`x&-#-4p&-X
zSD*Y;m!1VFS2veG_<Q%zw}|x_7H@8b1+1odKP()OlI$xSu=y}7B^hCLbqzP_+31sC
z`+#!sg(2d=qi1_rTQIOx*@#ckw<>-6iX{dt$W;ktOTlB{om5o3qBmes;3G1$U)0$D
zj-yqk^X>?NzFBH;n8gPN^I<%hRGI{ln>?mz6OJ1rpHP63!*sE7I9e*C^e>8Ae>Qon
zmg*o(=OsL>l05Pq?Yk$;gJstFXF2Gfgv*m;E@{o%G}y76>%pMIdYnbK9f)5z-ua1S
zLuA}}lY3`_@&0u6o;P7(ijXpQ;9ch5h*g3WAC;+VcjRun`TMK@VQmzbBFn(<_+h+e
z6fx%sEE_`wo<|3T1o~Qc4`ZRAM9d<OGWs!9V%WY_k2J}!9XPi+J4bjY{g{E{vp1Mo
z2!u1b2rwUSxdABxQWztLGKPLqYnz`C9!OmFbx^+CJ-g2J=Iv8ODxP6Hl|o_qe`XYS
z$QKPB`^vNDUiTe+Fxi(qDDkr@ssA&6_`|s$l$*-+G^j+Xa<AUI>DoI2->>`Oq$3qy
zH9+H50+RC=px;vMy+@Z4gVHF<(%O~9+Xjjutq~U$LY7WXwJ1xa_B4YC*7IT_&lOPd
zf3J|Eo4ZLJK(zg~Z`l(Zm!VNGD^eC4#Wl|TMUz2X_-2(&?N~>knH+UbDgYg=4{oXx
z&-XSS#XsDut2#1*1fCo&7iq2S*G8pMe9)r@EdJ6dKKy1g@7)^@-NNTS@kjXZ$U=7k
zqZwG-LNL!A>{GV=SolRnc1!n5srYhk$5ely%P;>Bt=n&pjSl<+q#Ho^A-As5V;%&b
zFaw7twdyEQQAyE_y~^RmsbnDpppw6RcCHn#hX<|-a2F2vE&W$Dmgb3d2p>QlOd6ia
zwPfR?xUtK(FElP$n+gW*7gQ}WFx|7ByZk`0($^V9DxVd9nh?^Iq}AT?h@MB5(E_dw
zR(~-%M8*m~F?YS}HkPnx-wOe76Fh%)m#3HZ?YAl-%m040odcWO@3)lfx2pb$Ww!Z8
z3-jV(Ym*xI)OlU%0B%GkJu%3@wP!nA-UI=Pii@#S+EY{p8%fB6R%ZT|JHXc<h}{$E
z#zDA=5#;MN4beA}z6|4b?Z*C6K)(OpKdEaqW;i0K#$px^VOd3E84wvN-;fcH3nhiS
z`6va#O~V|NoaHE6XRtLKuo=E5b;YyT#0oj1JfE-So^SyvFy8au!(@C1QoxvdT<-wA
zxz+jz*PriN#$gD7eh=~HY7?wQq8Mp^Q^Pf#LoXg4Ajk-uSl1)%+x}q}Gf{gg!TD<M
zHb05PQ$J^wP@X^{I4M3&6P7&o?ZY>^o!Sgk`;`@978l?ibDxis$WTOM*ydu(UMLh=
z;=q5Y8W*|*ZG4(b_|%k^o^H27DLC*GUt80&^{4c51Ol5<SH<q(KBUuQMQ10U=}JS>
zL@ciZ;eBA)aHnQjCNWmXF;~%hZQXO_zAbm06kWJ297!#FNA9(P(A+=F7EWUp5+B`p
zi(KLb$c-24hmt+Sy<V!Gtd589>%&<ow{VzI>Py+T4#2RqY8LV^e~XkMiX)LfIhS8-
z!XZMg=VII)CYz3jzu);wU35O1QzHzRi`oMicDY4O{=8T*cF6^i#N=i<l{Gyd7eF{o
zyL>RuPM}*8ieJQ2L&#BTK{CW?nk6)9T;ksG%h4R3JFz?iq^#oe)?fw6RRY&ShEtHe
zbJ4te-P`$^rg3Cjb5ThK%#_a=EX4p~QsEJdJaMxsg#|mr4s2ZBVO>Q|>=2Lfw#W@~
zZK^a(A!3L1#b=?f!%}~@zFhYD9}U+Kf33(iecg02zpjFQ;7>b*=MAYX#*E$&7_%-;
zxK8pH-%!uPqsx$w#V?EgA(`%)n@R5_Yj!s6OF=*y5LH>y7<F;Fl!!T>BHQjo`AH)B
zae9W<TuP*ay!lbKi|JLpt3BS29p`x>s<U?|WK%IEHt|`X*(88FW2goD*u)@+Qn#0)
z(&fI$H1#M(_&8|lNxo?MgL?FvY&6T0IS+GHC6A|sp?e4V&LVg*C1DE~Gd)z1ugi0Y
zrvyj)>uCqWe17SY^B77PWXn%E4vg0Wx~Xe_zTAfutnDO~plN?JYML6HD=s~J5~F^4
z=OQ`i`;^xAYc}K{apgt^%VMpdv|di)Il@7ErLo&baZ#{HqONF>k&*}57n5V4c{xUm
zQ~Iw0wOJ%n2)34A+;B^g1Ki2LnFg5Y;3i)t(gjp)B>mXvt5!r6v|~KxFa5Sv<>Vvy
z?O>b_5F+#GvB?`JHIg6KcTl<(i|(M9NCB<)vSPXr^QJr(vFKuXHSurQotrC8pOPB9
z1@ku+BSo;#GLg}ldPGAvojKM^a{u)dv~*FWud@HK<ICTpYtepg=ea$Jl5_7)rSNIQ
zUAH+G8ss?-Fn>j51xc8ge;>OF_5RWh_fbschwRm+qsfxNz)caQg~0meC-oDy(d#ch
zf67q!G2yC63|`(DDv(?fx2n|HMdl)$u95#-#skd-``CkPx3~YAKj}p&F+B9=!5sMD
zjrP^SNgIgzHs^ZP<~Lx6-f$>4wfh)M`!uxp=))4zJcPyFzX6+n0I;W3>?(X`Q})}j
zT8>rqT|oTDz5?UP_b;Z$lePG=DA7@bUgO8dMJ>sH7CIf!8$TxDxK(s!r-1Rzz7d6t
z*McJjQ*A<SbnO?gMp6`#=WvAgO+2A<-%rhik!m-NtZQ*38Q2jmuFxZQ9LEw8qL8zq
zONlJrtsB3z;#fy}%8|ZIWVb%KR#EGlyo@fn?(M6-g?-XHFPp_Q8^JEwU|)bSLVx@<
zs>1Eu1xBzXxxF+(&;DKptj*PSq`d=|J`7d9D5FG&y7l?p#rr=Sp9ar2@=tf=S)m>Y
zFC4HDNod~ULO=U!`l&7+&{2^zNgWqj%&{8=K$>4v3F6Dk#!Q<l^%I#td7yUk21|}~
zrD9_TUe79%QZws4Q!!7D{0<stU?wGyk&dd}<?2I{k2}VTFIy~5nQrtsK+tqb)Db0+
zA(<JfZ<W)0&}D>vgU>jW%CUpkV7HgS*CnV&p-t{%H02PrMgADGa8XKoHXuLdKX<`_
zI$cwWrVNC0&6StKY~sba$bS*q0hU#q1WT^@?=Cl->Xp{c#GvbzPPJ071gfi#M~%8<
zcU_@;cfWsa=(T_*w_R`S$O5TuW1`(AmT^(dnSltOsD6w4e$J<iAZ|uB*LW_lo8OD#
zgU}fuqRV99#pX!pcTFOCh<b9dHaQ*xLeCUB0Z!5bXEz_C22E`3IHt>|lD&KdsD!O4
z5p63d0P(4;EfAG>{)&niGd0tyq>occTZs;~5eK@>Q*b3qP9z#xol%GHEsP=T6qBs?
zefkAC+T@@k6J4uZ8@DomxP(^GPS%+z7UcJ#rv&G&=b3@jRbMhM{B7d3RQ8LKz7Yjk
zm-Pmr4ZsWH-IFILd3)I&ch}ov6n?69enU*{ex72ndu4A44D)+%?%lp@T9pu7+xBW3
z?rd|YwZWNRaMoUekzn|IDWjE9(no%lL?OIu5*kc$Qvo72<BFE6T?z5IAoujVlrA)K
zousr`U>GZxql*M$4w2=*ZsFfZ9%X)BmetAQN6$Y{R7oLzGDno9+nF8?#JMgF801iG
z;8=xY0m~v{$cp4yCaNRzct$9OEyj`HMLH;kT8#a?K{b?zWmBMVe{66uUYH0k44ED0
z0~i_crfh@6@0GT9PZ`2w2QFzY26QH|Ct&nBkDa!bykl`XXTJUo1UDcE%;ugtdppC*
zH1M~w*h6^ux8j%6%l3ktjEkr1PrqtM|Jq0vW_P{;6d*wk?G3?6+EiA5SQ(dCcV~+y
zj^q>wqz{QLaJ=jW_^RcZ`n!_J<&Z!gzZVuzgfCj)Y54kT=QwEE<Mom7`bj7>nPsr?
z8Ak@UScVz8d{UvzARth7f%uc0^ShT(BffcA=4;Lp{2Ruv1Lh*~`vv+Fy!a8g^*!j7
zpGU7FNF|)c6*L*AM$&6a*!Guc)CAw4oFdZ3$Awr(_ZRhC(!0AGJ?|qtC{$AR`;R6L
zN@c^`m$CcnAin<Q&;2EZb-2PSkCs#6reP0*Ekxqi<KE{6m@fv!kPjvf!|MLQoJRr6
zV?O<wP|VVEu@WSQpE{(n=g5w}4x(soKNEqS1F_wh#VD%%kgU7kS<^hqKLl~*8j$5G
z*bAb~0I8odweDrvnP;K|>^}E>UjbICLoi-K$&3%PC*FT%uUpL3i4q;LsF49<9wP@3
z`tqs}SlH>CS`j0OoKgrZ+1sN?GS3d&F}Nz}@e%qd0=^Lu^9z;|;zX8U-g#Q}YVWrY
zoZ{OCO9eP|KREPVT2tXe1;E?mFr#-yk_s<fqJDW6Mzyn(2u6|{_h|Q&*e{i^Rm-nA
zEmGB&*RDY`a{~^&a|5?vqYdYmo=1M|GXlN=z8~0OqH&_|B|Vea6;uH7CFUU<A*|8_
z$;&63_FZh(ac#{STz$Slp;W#dc7jq%n$pnNa^3wMibAE)NIRw=yz|ARVd6uN6qQ}H
z-+V-=pXld$vfuRUraxI1b|Qj*;+Lvtp=2IW<VFp6>}x^QDNd1#(a_p@5tF+xh|H|u
zQj|M7j}_FEOY1^uxrvXZPPniCc4ag*edP~-Hs5qyUcJ$Gig(lTk>Z3oFXr^Yy1G_>
z0P5g{g=W}$rMUYmT@5dulwf}>I}T7vuWb4P!#~9zK5g8S-UzUD!(syS{Ef;Mjxm1)
z(ydjuNhuUILgRVx(&w*^e9SH4<F7#Jbo}|X!q@w{#Vc3p#K5rc{p;ueTxP|RTqdst
zL|7FtW2JGw;&48LZQMA&om8F_rE?(Jfk0#V0mZ)bfO3+J-l>GK36a2hkiGaG`IN5!
zlT4w(Iwu1#$D=SUOFTqNG0<vmtj|lbVJQG!$djzJ<ZH)mrOnq<4Tf{*d$JX42(3xx
zfk$CDxtxM^t?ic$t<LniAxk4E{cV|o6^h4!L~B>XE4SBz4g6mY+$GlSJA%b(k(28C
z$uuy@qD%gS`2a*C$%_-L&C_T;QsE;HZXzQ3+bj9hYuX3E4+=DL+0H95iT&Njs(mS7
zq_ECGe|jPFK*qCY92)23AKpy#f?)I<h>Ax}_kU*N7`cuSRMx>Zd7Fiv>Xvh?ybMpX
zWLPs8XUcqN5|*9JM^ZifLA%*Do5?%~-aVOtW6#soR+lUpF4antGP0UzmRaK*`tzp{
z&e*Y<2>Cpwy`h@AW_I7hTVg?c@Du~ATwJTyLg==O1mLTEQh*)s^7-k#80#|>pF5Ut
zr8wO1{8+4C5$^P5?YQOZISGZEE!}ZGP>Hxj&?Yvv+{`y~Ldq+;ISmQx7(6*j9d4zK
zuGPB=lR58m@eMlpWL(x=S}5CD6IpDExz)o*F&gs%l<^$Ld65%!JecOT$$1ldjF7nw
z9u*9$Wd|-W^xmL4jSJ~nj@~h1b;YE0DLQBh$xFyFA?Ml<No*sUreTrkP9zyaj#;gU
z9pEcdAHH1Km*UFpfY|}h^e^-cJ|y4sRYqqN)YM4f{ua!J+$Z{--TDmaOCh((`R5%O
zqlZ|>-w<p3eT~-X^++Gmn|D~LC&u=apZb^YoSOVe{L%;`sG;<A)reV0XH1YZ49yuG
z6ZR=)xgH;jPHuzqY+^}P+A_g&**f_NzI6_-<){oGv=~Rd9~eMf@l~w_M(CqX#!3|%
zq*~4#3)UM$t;)zkwM7@`5#o!w6x9PNc#Cizd;}8)xLI~cQm@CkQ)sv-hM<lCL|Y{N
zO-7)5l&`yIWCpxR{@E-%=qRKLJ0{7xThqhRZ6fRVm=*A3R2?H}Uq|^e3mDoW@-ab(
z`DjHijhF3}{kMO<gk`58Uygr*o8244K1+C@ORU-U=~j+pV<D%0{aMF*Uw@FMzc3bd
z+vs}FuGIw>(!RRX76w^eEA>lB#p9%0J;9q)7y5;ZVR4s{>h{CG`QuX0$<!t_r7GJ~
ze9vs=SeZa~nD$My0J6)1kBu(y*E)$45l`i;y3)D%9LgZ1ArkMVTuiYFtU&ISv69yg
zjpOlR)w5E#mvtK{Cp+5F{|!X__;y9>D#rOL7Q;<?x1ASRIrT*M5g<o34(32k)A`o1
z#OG2m>v6=4>GTO*q?}N9?}o;g-L&2Mz*L1(WVM4gK(#dU!w)e;BiI?r`dMH7*Uvu*
z_Hplq-zAS#&861j@A7t#|1GRftYy@O6HyrC{`*uUj#N5%g;Z+fJCwH9t0C2Uo)_fh
z`ljc4sczwi&kVAn_P{JrAeS(K4-ncIogb9WvX(jCUL=fwCm?!aa$~<}Ns^6_%L+dk
zVfa%|o?}v^vAd9Gltg~WYm8srSX2uuj4!y}#22AYfp~Gu7y08&N<dZP>y0H)J|u_p
z4?C~ITRtulBHDy{8a}uzj^bb3R`ZX)K{lj{0KSc~4~Uqd$|IlF;g#&+MaZ>#{v!VN
zS+V_{y(O~1e31G)D0H)QDSlGA#>@4Sz*eM{NAQmVPLKWTL{!Ncrdy(sRv-S!VQ>1K
z*aIxAqxhlC{j~Or(F1as&W5l62`?FjQ91qv&TyZ#BRm}{+k?%{w=DZEPz^rYv5J`%
zJCf}lw%h0gP8Tm#6%vc&zIPrvF{LoR%^*%G*?SE|r%7F!dxKSOw=9HBYrZ8J+Ef+v
z=g)k_ZG@)vJ$5B^59KA(m4(a<@0pncGrmyUW^a^-eXr){QXy9Q^etM?@+J$?p67rB
z#tdYqeAhrpKs%ddHb*JH&dqCMlRo3n$L71szx{5^4)x8w!QSyEC*8gOet1C8VzJ&o
z0kU}!Wb(hbmztWJT<(>IcNV`Sj|tovUC*|#_9K(!cDmz`<;G1K($gyKDY}?>bp*yN
zxJF4j0*S4BvF_m6MLpPOz}0dyj;5)2v2qL-0TNbuMkfr^>;-o<Qz83#{vsjAQ}Xet
zdM<+N(z4lOK5~+?I$V4RAD0BP5{qRAwC-&Qq&%j4Ly)DvM&cCZS$!`*wXG((F3z?A
z(cqt-1e3%Um|c0-sgX(?i9Z{~tjp1kp4EpJz0<*&D%VvcOw086j(SH#udqDniLVRu
zmRf#U8fC9to0toI+fpip_Muq#FI<2?z^!J2zwC7(34ky`?1g(OTtBSKx8L;l@@k1A
zv()3qFP{586i_R08)@ZlNTp<~0NLr0vD%n)*)1H3GQyrX31OPgP>zRa23yN1Qbja2
z<%AbVpUdvSjSgOvbv9rhb1?(o$Tr=GvWehE94+WDw(s{sb$Pv4LL!BpUc?#7fY6PQ
z?l`u<o~(1&_?)oQNvu!Kue3?!btHuA>ZtfmI=+66;6(Im1W#~$E3MGyB=;Cf>PovU
z9;|WD8oN^wcF#@P8&E{N+HeyaRE!{-(EMIcif(JJC#pBFmg4#-Kt`eWSc?Y;|D5(A
z-BK7|Dop02GZ)^0Dv0Soi?EgB_wmmbRg_tDGe7@dm=Wl*#h%dP+WlLtw{(5`-s+`S
zyKkSH&n}wXgQ+m-&^DJXuRdRlSMXN;su-5WIj<KeTp$G|%)jS0?(C~9NQ2N*f2OLf
z$^4|KpTpJyQ`0P4$6<x%^mO>c7sVVDQ<Og8QsGF0%4WUt0b0jAN$^gTUHwg$dd9}b
zL!!@kD5M58sE-1C@QMnt7CL!oLY=E9Ayb+-zlz(aRBA(@6<ZkezWO_ArQ@tGF~^l~
zR`wgV=fdLU*mDa`KjIf%@>4}v!3CA?nuWI5Z0JPvSKqfzVwF}cl`-eBha7zf<14#4
z`C95c_Qw`<FhN;Nv=72ji!3Ewy5(c!>V`|-QhyFNcyV3IjdZ`GgiQ;rH-u$pjfFlR
zOLlcPSmscjhKXi%PNn%bSXlc4AGB8oKf4=r$?6eu-*xSIVnz+oBM!~!#BzxkFJRg&
znlNY5yj@6fP||2ejnVT;Qn*6@wlLTYCHWAFLU7>#H~!fy`OFut{zfSLhSa`N;pFFz
ziRZCkIrsNSLy#EM+-ukxM^V#4M&NS1vZxp6kzLv&+EwmGC`4_gZ|*mqJ}jLu8U0nN
zrMYWRIrSJDn<w%#ZLD5ewP$;zJ%cMj&7KTd!$s8jPA&C)gsqnv^z`>hqr;6(MpiiV
zyx0wWixW58^1<S-Qgq(yrV*h2{A=?GZnc1G-8W?B@aJWSIdgN#aydq?M(ts9$wlo!
z_3mkzmVj_kW&HdXw=ZWrBTgZoF`0{xa+p+l!1CgPXMjn)jR`onjprX%g8ZJf(HX7p
zOn>=yoq1%4&5ki#OtYvf362oof#u#GHE}5oB6m(pmk}x)WeN{OAis-6R_M(i-A%D6
zrVrMxnJ1+x#<q%eLZ0tBGr0wDem$|cf1{qgN-E1@R*Uk$=vn^FEwfa?`x6G4E}X6@
zKW)jq+%Q3}H|t90zA84f+YhhlF5f6oIiObVgd&vZfsP;Ujop3N-t<Xb@x!%}FG8>f
z^M@!8Sm)DrmPMW~D^DG1Vt0&Yl3qfw#<Rh7t?x24rEhEfCLwmva_O|tE9c-l*Y)M$
z<=Kg0G^?&BS>B+^R0RRcy#Kw48#ILp(PMI<mkm?%a0Gw=s(~NEFJ<#}lrQ^A{QkhU
zP&_6sbqMsHQ|UY>tg4(hbr_5!9>7LN74|?gav=fty&R(?m6V!LLy71fe^y~UB@-=a
zCk7$J`NI=ibchc(X<61AGf#2>IMKBcq+uS^MT0^d^LeZ3YL|f=gHCXp46y@)EL9LV
z#S+mPz34zT=j-QbwL3~P(wlGNX{`?xk1T5X!JHE}oN!@2zf;13cblS2lCLcS1jhNm
zV{^&A83lPW0A=o)m)CT)uTT11ec(sX+ttMWhfJ-_XPYsp!U)AWtU+mt_bWEi=q2Z8
zJRXP>hKwE#WbbkU<#4Wcmj*cnbkBPBcIiteJuY>X@Ns<{7RcV_>938#_nhU_uvehV
zpeThcVj9Gu2)_ii()B&EA`*op{%LkB=5Ad=YZslQ5s70q-Wi^_?;^2unxd8Cf<_hY
z;zbh~Iql91bH)guMIZ=`7dNX-H2CmRo+y~lzk%58&G|+bG0+KwF~5Cg%|i{F;=7jN
zE=<Y`38D$bP2qb2GP!AgGOE^&1DyxAJcJBD_qYeFP5oO?!z>=QMLBo;uDFxo(uabp
z2ez|d2~Q&zQ?Kiv@&Ve)^8?d*lUua!&#@JQDw6}OQ{5#GFDGfTkRxS33(}mow4DkF
zCF{Q9ARO+Mj-3?=qqz91iYcI&=EO0`8otRE>!&*@Qg<aKh+rF_&;Z=8u~4)&TwYQL
zBPnjXY=_i+)(bmD(Z2e4N`Ge%s((BapKONdI7#{w&B!|c%>@G>Xqb(Ds84)?J?ay?
z7Ek)Ga8-#m1DvB^R|5REpc`&4p<e<Nj`8}?XieP1KcW+Ej`MQVaWwXIXF3!7-apuE
z58lpoWQD(sYyL$b5i2UTV)Zb=LNzBspox{Dox4)3;a&G{c(Un-`D(!&IxcQ22?bLw
zUj)+FMf_lmMqS?ZZCUZ3>hLXlwaFUYTO*9RTC<5lWp;jvm~LSi4@~^VQcDt~fgI`k
z)QzZYq%!e>3`j=exdITY?!Fx!TboR>`4(9watQ^jenr{)1X4cjRFzsSa1`~j8=4C@
z{}s$Brp?1kRd`dRCN>0_U8)9Rc^G(hq8Fe1k$L&moSs2U;>-E59BpfI0elz-hST_v
zWVf?wp{l$?)-&P1z37M>Z;4MO%2R0`J!)UI9JNw32^issAVmsApyz3;xkL@Q?>?{E
zBL5k=cO=g25a<BT>{fFF=<D>XP4UD0H5$+BTcqkO&+pyVm%B>q$qj$x8mzQ)xcmr?
zz1TMuA}`glTS(Z#sKeUw*B7!~rF8rorK~3y@?7puOsond0m0p3FqT-WVmzZzG>l^_
zI~ogI2uxmzzT1t%(vCabXG3!}<D2^oKa4|rQ(r-VL+cY}4<`~t50cJrTu!}<XfS5N
z{9_M?>m}&=!x@4$6C{x&=CS(0ahH3M7O{zTV}2Y@{G`2-4D>gECU9OC>xHBCuap4l
z59|o~F<^2x#F6w6=!+m5CmzgFqT+Y6D_?@!9#1O_1@4|GGE#biM@Y?X-nyw*=4qaw
zJ`TIatHI?iNwF8?J*~s#Ed!KgCTFi->am|7<Ci1UQp+o)V!17UN3%I<^mkDmjMyXb
zsg8`D+17JfI5_&(m@elRw6%B9nRR_JE%r7UJmDHXHC7hL@&JKxaYkvL65Az4K9UaX
z)F_Cd3Cyv(BYezPU1qft!y@_wLD$~mP-PTxhR93$p?906c;AbKC*g%2o0NQ%-_!UK
zL8G{%qTqe@f0AQLW>8hmiQ5vDj<?959Y(QSgoAY6AR7^D8Sleu6nGGocrGMT%sx7-
z>r+S4iy|8EkdN*pM2BM<E<(_1syxaEBeJZ_zZn=Zcvf$85TKS!TRW^zR&syIvi!NA
z8^QR8d)!<3D6>oL9iZx0@cy^QZONS6cb%`}U&u9fHTZ`pkb~)=?^G%0w_vBC1E^Oq
zwz~~Od2hsqWClL_FwKj>%LktK($umi&a>?e{@BKR=x49%_F})hUuz@~zw6a;o-aQg
zloWwm!b$hsfK-IB9MRljC$BC|Nw7nvW?wpikU3wZ14m*$9(Er&AlF0IfKJAUZ~F5c
z6SwErMus?mQp7abksQgDl?a<#AeWMK`rALUCFZfJF~Bm`Wz;?58!HGuf1?+Q0$I_%
z(I1MyF06fdeG;H;ATZ)Rb5AUKZIi$_W)<R(QSly~OSOlh-lR#1g6fDjhz@@o)7?>v
z9va7@ojleq{!r1ra8B$MN2>kiDu7G3hCDC^_MMP_9d&I8e0Zz%mH#z?!S%O859!@b
zrELAn1FM@qqJf{F_QyXPs+mfacgw`@jme|hLElbv1~xh~R1Q6C48wNVo8p*Cl@xq%
zIy#PJ_+8n+;t><neg$@~cV^eI*`I9$6o&v2I}(Nwky2%F0zOCDe36wEzB&w47<`@@
zMuC)oD47~C1mnTVVuTi9bHA%BJcGDt(Ew{tFMpaOH~Hc954#WPu+Gr0MEY-|=Lj@z
z&JQu}$Z;_i5|-o0;xTfRB9<VB>M#!G%^E(ogYhIg=|z@^p1txIrdYUWb<&*e8RQ-U
z;c}CKN--1kfz(UKr@ALb@4RV%a^+<ftm;XBEc70!6knA0`*Num5keO*f?XSEp2OgQ
z?xft8I(2OxHc}48#Z6NEPB!oS&1Ix{IMS9XG^S^b2Hte$La`+V43RTE<Fes_|J6RC
zC*;q>=$Rlymghsr`7&!%vIM57TH@W4ZFov;wvo4B1f_d@AD$wx%SnwS@*k~W=^Jkf
ziYP@<Z@u<qfnVct?ONt8AaYMh@QihjmX*ExYa<Ttu0F>bI%0X}raAc08`{8614+An
zmL0*|7dHQ#LzDE2jzfGHPdiwJgs{bh^mx+SZ?V<D_(7QaTBdr=v^3$~RH!3I$zonF
zQpq2xA5rj!yUz7ODOPQVD-kYT7Gm`tI-svwPpB1okocv+{c+}mP*rQ&X{4uD*Giu*
zSI|tpLMK0n?u{5pjud1X-Z6pd>m0Vl$(A|xMd6PpI;mzznP-6p$Y)ZTv^k}MLtHO0
zPT&m9O2-K*(aAS=*Ehi0nPX9N%z#*P&lnCdN3{J>3K&H4OR9$+O-t@)A~$7WqfhR{
zyt7D(+fXNN0}i5<MpOu8fo#qBKEPq33-o%z;UF4tb6o@Mzo-&FqDQkiS<zESW$46E
z`kO)2?MD+kTe|e`8%uT~$8socIT=@;N&WZ^a;O@~2SuOD4J1Q}j8>2OZyX;ysR%91
z-KT<VAU8Men2S47T(GP~33-|`x(!BNK<3;g_4k^t$Cjh+u-co#OXU_FFQblFABB3l
zZrSgEF^-@0)jcbE3afiuLYi;1wTQHk#XVfVS4O6&1t*n~w**zlArt6@h{j}8w6V1G
zjm?3`{5<ZE`b-p+@SNs{=YAHO4(5KAr?P^S#Spoe$$gC47XkKI>p$eUY`bQoQh^GT
zzuT(FyXv}Mg=_>Sz$;DfL<$u-55W%`56%dK|6pyZ_JcD5Gch(=Q~kNwJCU0Y#FA!Z
z4jU5mm)-L&6TB<Be(sH9huVsK?B_GT<x(4I6kjIv3^}5>nq;nW|F$LHPfM@e!(qNZ
zNO#}RR5gf}_cVYX@rGAwm&BH|;m=`Oho0zhSIst6(V{tH$eXooDaOs*qi5lDzQ-YH
zLNcnQ?Po!MYbBpQV%&kP-nVH>VGD_y<>tORi2~?h=C#iWE40|V3uU$rC~6%}(r+wx
zLCO;A29+`+9nL(3_5MiQER-ou_A|<|^tMQfU=%5T#A_oFzJ6gP2b$O?k8C28wAN!)
zCHKiFJ!$F0)#J_DMvmWBTZ^3cnN>@k{v#y2dZ3sgesd$@a`M&^6rR96Tk(9v4Zcd?
z#B#e%N?!@995eggprP=@@C}=3-O{P`Ju5zyup`eq;gxd(Te|)7emk<tegcVmLZf#7
z`VV>eN&FZrJ+GPfKA=NvQNf}EgZoUA))dqI6Vm3PfDFf)kK#8))WOLCrel)iX-M1;
z9`g$10M?;Rn9_c2*CV&oL&#f0Bp0rhF|2wvrWgI%A0+0=NMiyUY0oaj{CYAPoU~O|
z6&dni)zuxE!5#ug)cM)k#T6}DAE+S9QR0sSah?RqA-j+r?RQPvqsvrUK>HD6y7@8T
zXT1CX8CH_JisaTqg|(jPdPhBH<u4u`2S#zxtenWxYH$!%6gz2)L*-jH@wq|~{32Ql
zEuByE5-0GXat_3Ed<b*VSuz604OC1!1_e=a2V!k+?0TJ0ESF>m#22<(d2vm`hgwAW
zzT+_8qcX0Up_af!9lh~m7|F*HS-|EWi&VS7(7#s_>*SuGIW>n18+Ai*KoADqvIfqg
zm}PgfAe2qUmUP1&YZk11p47$4>tPRVE>HEc#<cZc&Ns(RoG04JR>UB{FizsmxAvPK
z;PoM0elbX_vBq9ao!FR2%K?#U!@zaEfP6E^Pq_%CBO|`1taPxIWS8`@FyFC+Fd&KC
z4RAH$T^NE18DSCU0qHntC;CHa+4E)bDBULf!p7m{B|yp*>QU?#;vgMU6D)uk^gIA%
z*@qOfm(NN(fA`=uWr)<F3ZR6&`(5~yC3E<JFQ_6m4lI4?PRmB6R#ZYrFnT<+e-f0~
zIproXW+x&v1*9eq{Xx$EJ`BzG3x`MBxIAH6e}p16eZPH%#YKbGN6EiY?+36X=|}Ov
zC<dwJ#`0PRT$2E0JffpL=+fqM$MM&PbB8}xTE%yI2YkjoDzeq}!r3fCeJ-9TmuUfH
zN&y1K0`+uW1H~)V;HG}?n1F@Em~iYAm|eWEemCaAmX87$b|V0k6`5kSt!BsWtc~$;
ztGJV)P$ub`X0IBdWI(V2v~<Ct80|)8jSoN{gnda58Z^f?Q|uPzeR~jnNTckSW4c&N
z6b?VzS?4PSwvE@Isop69H=vYh41h}0swwu!8oG?RV?ma~-y&&nUp)*`RrA!9d4)5m
zgCg`?5#lR2H`OFv)2=zn(vj~Ndm-`1%~n<P9?h@kx-Vdwf>~sa@Y8}XP1xJ&$HIi;
z(~re^i|@-Xe*)@uS+E_lYr7v$KT(UpPPso_5ijWq;k`c!uQoGj#a5#K*wTVR5v>CO
zvTJ-^tCa=$GJRmJ{P>!QEM!bKRM{2J?<>PpoIIBGwhQjO6ANDv*?K1qsL)1Fr14oq
z4H0tmMumNVp*fIgBTz0T#fZ6<<Be^myG=mu2teBJi(BZqz6g5lVht6`LL=U%UFn99
zD;mlW_|+b$ZhGogFrWB!S|p;Wk>ak3L#J*P=`!T2xH*$mjug###f_4bl}GP;QDNN9
zJd3JIAZ^QHZb9IP#0P?!KStZ8p(n~>&mGME(9H<!B+6Ph|1&=q0K*kkpoMn+Nh~!o
zEQw<)g(`OBMv84nk*1K@xy4-(nTyl-1D{)uOh&MJ#IQc~p-piKy!Y+(s7~ps&H_ee
z2`S2Gg*`Sn21B&@gjn&iJ}C&Nka_%si8Ku>gK}&niy|AD!Kj!$D^8f6`?piv1pVsr
z=p~p21?57#$NIhJb<?{d6YHGilIA?iqFJnN9mDhdH97J)j!B9Gl$Gn&ss`AnAUcPQ
zdvoB-?@^#PALo{~u*IL2^e#5b%!L^{d}wRRJXT;JQCSzc8){t2(Ki{1I-xbVUk^gm
z{3)h1ru-IbHj4e6t<d?l_o1IyDQn@Ss`<|Ee0P$00Yz#hC*P#v!!%Dn*8L&Y@`*0c
z(KjF=tZoGTAW=7{_mN_nt|#d*4cGsS5}EC}*M*$CMuCYt^?I%yE8p8|_(oS%4Nol@
z@;0KQ`Z7NvhtkVBNp-{7_<)d_AL)~~gjRG?ID@u%V=Nkle;$FO1!Oo+jgo)vn&<8{
z39K{V#43S*zGX_U&%xLlUkxrx+K!5_i%X*l%H#>6nWoUNfg`NsN=X*quWcTk6BQB(
zWSr31L*S&oM+jR<^X<3yyujYo2(>S!Yh3!~6Y=4iU!F41IgRF9Difp9M5nz4=tJ6V
zN%mjeh!7ZVRAch+ZiE}WaTxFk;PInWk;=pZeVnF+7i0cg1nVt)`T!qT4=Uy*#s_F<
zcV;|~KXA`iJaMADH4i=^EXDtQkU(-5I1^VTuT!bdrU!e8e^WQ_*lN*$B0UsYXkjEI
z_XQmfd|bZ~;)a@wi=#Pz)5D8%XHv{(dk>I6APnNK_(XWVh^i?4CrUlqkdosw@ROTj
zBudIa+u^$vo|gRKqs+lM0$IT?!>S{aV}&QviqhF&8v4dn(WQ+0T!|?_m=;Z!OCm<-
zE_!J82d{zGtc(%<9dSrDuCFY^e3`W0LWY*OqiEHD(P9@<{ZtW)j@A)*+(^qWQ7s-;
z>#(Y&c;G%B0ts)e&!-XtfEN<GdTKHG`cqD#9#fl){YMhOwtQKn@~qu-C#eZDbVpy=
zQCD5?dS=Gm-TIy4naRLSFkBJVQ|G>!jY3V&**HLXRBK%8>)+K`7-=Y{@7~YP*s|JI
z0#UWnhuVdjW(W&Hum;eMlG4N^M*yS2aj1f`_6SB1P9T#^@LjR{5n`jFJSLe-Xy{Bp
zhlL*k`l?2O0K{W2(~rX9L>MhT&ld+qMlh=;-2NTGY&R!$rU4N^#MPr-+3rAvF2<~X
zf`2HwbcQrMfx*{{P%cUzomp*k;T?gJmWitZc=GqMnMX|@Qr1h6)=l6CXdkJ4k(pSs
z!=>b?5U<aIstton5r2~suca`{TwlK)Ml#<spdx(#oF4xaWtWSHj0!(xXxwh_rCB^y
zlm^*faWrfGP-hyah7AFZZmKd84G}#%9UHsyz(5$hu-Zf1+GYZv#y;?TT6TMfP?lt)
zl(Gq1ugUlV-6URL!+%hRl8rezQE||$df=XzzOPESd}*eTC$a}GMcjGTjknQm49NN#
zixcYpI-`guba1CN{-CJ?K676wY!QvCW-8URR~#5z$_dUZR*zV$4iMhtO$?cWvjVy$
z(Xb=M3nO^SlRlk3q@%axUMU$yqGJ5alBME@OPL7TGN4C+^GbC5l!Rg4d?$b8!^>a<
z@}eljDXgL#o`S0suVm~_(n~`&VG{rK=dyNdIF$5c(I?S45`u}9g9vgERF61AjA{w!
zh}@Z^`znV^>#6li(D)ng`zL$|od0t^%|7rp1h6Oj{iOjdb~{W^%f4_Lo@&Kn;HE9Y
zKlwRL`LZ4xS;G~;kWj4j26l%VeJ&!nb=)Fxu$N|G)W|l8s?FI;di2ZcSfpb#&Oi`o
z<ufuerFdLdcU-p(Fz6YQzX20fV1HLu6d|KR;Aydo@*J5fF2~8#@=aPKr`W?Z?W$xq
zz9NZ(oCYvi@8Gkw*kVpJ@FSeg8;tdxHi}>Kc?cSC_Nr1}t5saYl-UC<_z2o)_XvQS
zJl%4n@NFC_c!NYf2EVb~GqFm(uUeh0^Bn#5xvjPS(v)Y7+F#*MX+PvSP6(&uHa@0E
zzmsw73@$|Su@XKWBPS11&5nu-0m6rmJLC9E`F#mWZvvRu85@=ceAhx;#zorvvPZ0P
z|3uZYr*+_G4UnWoyVasUNbwUg+863rCtdj<t5;y6)J$Rd`GO=N=xnT%t&5_#bFBje
zIWjXrp^aP>oJ7RM<Y}?={<vwol&mH3*QRjwHRt<@!oCJ22RimM8oNx?<hQ@i1UG^D
z22hlunw9v0+)!X5*(FbGN2XSEDJX1Z$%Zo0K6f~-04RI)vGpY7;rl%A9-2))bcAXn
zofqdF4e5^P^Xm=6;;BY5DfZe3+V2Uu$ZK})0Xc$g)OqeVQ3Xzz_i6aTT6sgf-T`}X
zyQ-cQQN*1Ibel3Ls0NHW?j;f`+-($4IG${Wlo%0B`%k{?b=@9%`j)F4AOrq`90v=*
zSpwp|0l`0)s5h0)<eAGmzn&gjpZ*F_=>HPm+xN8;eY^R+9zNK-LNo|T9Fth!P0)jx
z5Ze1Zny;0a#U?mq{CKelZ@-s!XmvW!HF$6%EhqT!Agj*^!wc11jWm8^^BF@XE3oO&
za5f*;LcA7!)D7t>TKr-A+cslR&v-Weod<Dt3a-0egZPsz*=W2qG~cCaEOcXYtSH}v
ztL|Nvh<nP(r?N29>7f)3AjCylRt*`$&1JrGAFy<rVT*)Y5DWkR0C7N$zc0lFE`F7{
zDZM*3#NuD;?VJtf-QR^PhC+g-gE>`P$jdf_SIVs1l3T3I2l_0h;n4UG8H%|*d0B`v
zEc74MoBmu`9W8iCr-=Cmpyw^Vh@r%BuTYz5G-Bk|^z&jX(=P*V7Q2r~zwM7r5lm$O
zg#QWo_sS2dNU8I<)#r}7FdL^i^(QMQTz5}*(x`$Ur<!7_$DP=?n*LX3%W8CGR^@^p
zJ}bM^%2nRw8O?cuL#()G0qRgRC`Mp?jg7yY`WN4B;0*ZDTFzHs7yJqad&f&&AO)<u
z2C%pmt-}sT#7vT^%Sd7dH8ANfJ^AVn(__kIhcV!koKPs=u!FiT!Lzc%&YaWE65EwC
z0m3(J(wVu11>AX)I-8V>6p6~|;xof^mmg&^TV4DDlk^Y6EPz=hPO4S7o#-x-Ql}F<
z002M$Nkl<ZazQA%PIojaS$#;%dQv|Fa$_qqXo4U81r`|JaAA}&WX?!vAJ<^FfWBoJ
z5xyx3*K+~!+<5g=JEOBQ>#v;bIBX+=P{!s|%Ybbg01Xrbu+F$se%p?Mj9%24e-)3%
z9#PD=L%D({IE_YY#&PA6H)yb7MFyEvst(`bD&o!^7|^)Uy3Pj6fcc28jErXitS|Y3
z>yTfuu%Z-SE*r2<2wuDi6Rqn+V?@eN+0l`}FM{A00!m1QgS?WJAR910wV)#n@T4eZ
znUxV>Z=ic}Q1lfFCuRZK5L6v>Pe+QC3pA+*nVql>Ga}#)@+_xd1GsQHu2!794q{de
zer7OW`XnAu^Bd;_o!hj^)bSbc>+;MRMj09MsyxKNlXT%#-1lrHRJZCocxI1rvJzbR
zvt(6SC94zHMO;3&6+FcOzosR?%9AfCHkIT3fR9Z>v26n&ruWEm@P`eDZMo5jGi~`B
zPqop@I`*rIV%XOJ8&)gKNV9WIMcUfS5@vN;R^fLr>Mx(KI8W&=FJnbx2D(&!;RE;S
zK;?KdMjf$mq^jdV8wMltV(0=lp8;0kI&}LAW56fyl}n!U6?UDa%Qd-EMLQW915$1L
z>F!9K@s7DI0E4N+kLT7iswW<8f*-QMk;hp+@PMruuU<`}j7bA7BuUoE7{E(ssO*H>
zPxFBVe0Vji(;>)`+Wo<6|C-rYK9_6*mj~<`V2)Y}(0=x)1nKlqRwY~(L6dKv54N1(
zXTdBxpj^38p^fWT=?))yT**)rJhwq+j5R^Q*c9Y@0a`LI>#_Ni2ZQ#A&3h$d+useG
z#sKgRGQU)^ZMUkm48QI}Cu88dkEuo+kD4(rDh<cfzs~IkWc*rqKxzB(l`d@H<%pJd
zTPWSNi8B0pF*qXP?J|(N{9=+J@ZvGdf<KPXI%U}Pz|2$7;W(1qOh=~NSUee5c?gH{
zNpnn^see3GLB4>A=eR0;ZhkTD?#gp^TtWq83LpB|VQ0w@pFXofnNJ+NA~J7)a>*_e
z5fr@e3kr*28HVt}CEp+U)Xasx!V?XP?k+{8fiD;X3+HP@ov!J&6OsyF%NEhFEY3H8
z{NhQuU>4e<kIz-mM=Gv-ZXEn7Ff%OLBCtc3p+2P+Vd%>>u-QxK#)e?NRqAp1iry4l
z;nDeYjtzR20^4%iG61RwH0AEkM#Hw<vflWsul-Q5WdvXV!)TIV=d<bRc+3=B8v)L1
zk7+)pE*?E%@C<lWc%M5SBcJErOffkXM<Z+~KDl8w<P(h-e1>o!l^)jtD3H23YDnNm
zR|pI`T#r|<pa4D&p>tAa(D+O|Jt!T#gMaXgCoei~x|*|qL4I%!T7Qs5gUxLr#_%Yv
z#V<v4!4PMNTlfX*2oynQ@`t|giq20jv;>%6h{t|KUo@m^2thkZU-%V*Tf7TaROnN#
zN?joO1A}{08>O537ux8+V%t0@zh7QYlCTHNBI(=lo<MLao#4~)N+G3d$s{a%VxEo4
zurLc){qEETfHMKxJ`_alZpYm%BsLeeKmFIqKP=eB@nt`kuKqb3z*RF;Is?(0aBPK^
zqvljI!=@u%6<8HJM6dW(Vc|Peqasry-%E~7HR9^(YMYT!pfQI=sPL^!2~Pp!0UF~y
z5MH_mkH~O*z-PPz4sg!JM{qhNdlw6f7_VObfW#{#OgDATh9CxjyF2Fu?4*d_MMxsw
zZFM(;FSv_~3(6lTD!eLZk`$XRIhJq!Q9mG%2RGyB;&`$*3?w<0g6sM<9rp(nu4pO@
zthf&8hVZR$$?xh~2<PrgaOGVO1uFl{ReRgQ1Gl!t58lz{t~p@EN1EBLe)HM3rt>YE
zub$D**UNB9=e3!&wy>ajgH*nckO)^gpQWP!%vyjm6JCGyv<!g8(3!Wl*}dBydYsRB
zw{8%(s6F-0{rTN?4FDG9uJf}R&t3V>i=O^RVQSbb<(lcL$3!FTz~ktc9(<YY1|n_;
zC%I%{K2CQC;+>r(Q9GQZL%3P%;{66$cN&XEW)QLWK<8)5X->rldby%?f;<B>7!~y@
z6!~hw=ww1Ddhm=)Sil|<xoOxu*#eR-<-|Y^7<YdLD0RhKj=?_4#(*sehB!0Us%)f<
z1{;Q8qN_;kz_$_5l7goq8yosgqv`?{9ZyAuQ|rhBI8h$>iqezE$W9r-j4}iuGIg~a
z;Owe%=bf96PG9BNNJYWzUC01t9=deAJFNpdbd9Tp3EZ_^F*JSf@Ikb@u50`M&I4`X
zzMI?Ze(6I;k(;~as<v?Njcxt?x3$y1_szEP;B&rnb3_<p%ZxHhXngDDSbw1&dz@%D
z_ao^|4}`;t-kn*|EMV`urh4J;K1tz*eL({-xZU=OZ4ranwl@~&Rj0r4y|(^>p8b3C
zFB&JRuIJ9(hsRfb+fSX7sZ@3Y6+H$76%>^Ogc=JUsmOt2^e6EH%Q!%x1!n+LlDj9?
znt@IS_dpO9Yhc!S-Zf9U;K4OIbi{NO5A#;Y<1GC<O^3ooUc@5}EaAlX2ar%=I0m|D
zJ<5p1UkFfKM65O0v1fYBm<YZ>-{VEP^1#CYAakU$<KXN;3I}D72fhuUI`EqCNaHFr
z>M-qi=okZ!xaz7JJHw#Y6*>9?Ts(*IIAYuHYY45=i+c8>Lo1rR6hs{i+8!dg)T#?(
zaP{zBgTgOaGD6G*Z#>lY{@DGx^WWKK4{Coc2S3<;f+T~m_?}za-XFcc&D?arFzNu~
zY1!yWOksZ<3mNFHf7-aKpQr`;VuG|8s9C@Z$2AL>`e^`rb&S~yx(gZrDSNfJu(6=I
z&-UE<k&`;iaKzvH^IeJ}sg)>Lbc`&b%0IdBClGbxyNtsWNgUVZM{?|1I0202CtiFi
z^x9bs>_<yd2uz&sei|fLaXKR4$g69l3m+ONi!W&>90^<l)X*-w;DjNq24AIv$ekP<
z%MRqMEhD&tY3agU27PgrAAAkcWvFGq*bCrAnkrwXOUf!f@MSi}!653YocR}00!bQ_
z!qK}1DImucTARe70-Tp{3^E1gO~2?5p=VdHl+lq(An}?NQ74@qg5wIe;MOs+Ca#4U
zVD$9agZY`Z@Xj0Co)6#cfjB|bCskJq@3^royze#-a&BVmE%|Y3kLCW1QXc$*SAE#d
zD;@f&FDgRZo4U**w1j3XZJb#daJyiXv3ieW?Y|J_1r2~0FrB#lLX3v_tKXBtdiOsz
zpD0ljuP<g`Gu_70dX~`P1XeXmg~g%d6g>M*fxEEs3s7k~8-v@Mjm$V;FmN@n*dK6X
zkuATK{DKjJR_OsdXOx5r$tO-@JEEYXhATaEMMua0p$uLw<sGT=hcxgT(<hNw=5Qxl
zqkIE`k`D+t9l1YA*ke|QExgJZ$|_ig<3`Fd157uG=Vcj7Fc}~E4Ecpqp-C%IVd4#v
zDWR8Hc@=J@FM0OTcXO}yR&F}fX0*q0A;;`s;ceHq&BdI>ik|w#xs3_a14DMz_fQ{(
zK;1A2JvS9>RR(}%z?6=0d%+|7+c5yV{By^)g{wrY|3^nK0ICrGQDBOUix3M)XJ!iC
z9r6f-OLi@ZLxy!n^QpN`o4^2{il+nm)l(UYa@A0kCM?*wLijmPmq{GUQhw=J`S6`|
zg@fTjf9i`hCQK_2nu^1#eDUhiD&GQ29S*O^<Desd=%OBkr@yK*^1%bYWEJfs{bU;2
zq9KkOroAjv*)Tjd&S^9z6&vzpxfTa-g5Ts7{zDl>3v3vNjx=RO4>n3S_bjxTtGEBL
zs~MIEhxb|_&+$1{9<L0C4y8wh$Rl29MXf{3m;&m2)yKMiJ7DdZBcM#<-YI0B2%OiQ
z*8u1aNIpz%JTI3)=IEq$|1khM1VkUjs`=uuN8}Dmho&>r*>G{K#t7VMD7tFJ&lLtm
zf9;2Fz?gBczUS<FZEh7#@k9yhq`M>?pAJ!Z=L$<A`Q?EXK5@!c>B6Z#PJZPPFITWC
zJNi&pOyeuBLTIWi#0x$dqDL5AJ@r^y?aBw<BrbUKdPEv+Rk?vz_$9N_$i`K=s3y}x
z9O5<OVpEoz#kugo#nF~4E1Di_Qxmt9oT@h?3@(LR`9oPUi}9za&L*>^DV!bz_*iz#
zXtkltW+p~TJccq#{@F0K4h@9oqCSX0939ou0G8C^H-)=NxOZp_o7=hQE>yz1M0mIS
zh44E5t2)9sI--+*g4A8#WvWsO&eWQLNJnO{F~s<*&IB`Pilo9}NeTvCVfHaNWIaaI
zSn+6ygC#Ysi?t(kC67UgLpL_t=$MrkVbBB?l0yU1rC)`~%Cae2@d0;I*Wfe`AL4tt
zBz@|sMeqm-B?lO8G9A!>yN+c<cxw;?Tu)%O(iuMB@nm6bebpr`-h|MUjzy2G!XaMn
zTzJ_2n%Q7*=<wnCdLHs~eXEhE4~(<Rpg3-*Q}LLjExaMTa9Ix0{_6}{B3qUuuqUtJ
z*OMhEJ&V+njG8?Gt2(G21FT%spCAdu1Tud7r$$@lOu#co3w=8w&wAMm#1Nd*Rc)UO
z;T~md`|b}D-~ILc(hcdtMA5ibA$i_TB{2ALLqkE@jqD1DR97n`?V^@~UqOJC?|G05
z)Q`3NXi0-#gu#K_(yNc7&#ZJqKc;f^mR#R(MI9k}R9<l|jNm#<MaPDw^zU=~yrAQ%
zTy-wLtfbN6Ln4`3^;R;AUt~uu1_vaR4+uN`7?U_k>}My|r{@t`G2>v#-~s0)LzOi6
zM`|lsAqTm^Dau=zgvjD?A5-O++0Y+){D_U~4c9V;7-{I@nDhAQMfgPh^j!M-f=kFJ
z=27nm(U<|K)%91JXXXWhs6~+C1uOR-ZzyA+(4#L4ahHD(x`qS<PPrTs*Qe<=SOz>h
z^)lc#k)L<}?m`BD&wibkf%1DtN7bXh%~LBj0K-C1EQ;SXo(314IVvSsL>2Xw?oGIk
zd*xPsq$`{1ss<kC8I8)F+=F^>hk<s;bx23foF23Jv7nA+qD%2FnH83vMIT`_cEL(g
zFLMZ?c4+Q`K^1?%xQn1iJobw^8|Fh>X+pU4j(G3}Rx$ACptRAN9$O9NPtr4`WkYb?
zCkf$_bs^TKvp6`POKz`SUs7SKPB-*boegG#(xvu{#`z$xhd|?5ne?VUC`0k+rGy?)
z7e(FYRvlDMR7yb=N`|HuWN+K?NKYlv%>p0tYnka;Kvy*(r`ikw<9epZ<N>x11-+=p
zf!bW3(%mWiyU#~+P6MEdMmEITe!qB4Q~$N+kGD;I)BtDY^BOze+{tR=ucqO{3NTrJ
ziMr}rKUyj|55R&{^A@q|J1_M-o6a)c*nu5rzPbxngVcKoG$2#W4lX7YhvC>N%WO(<
znz`auQkSTe(lbgC+V`+N)=iH!2>a==WJ*r>t!Ybclq&f_;}V8W@Qb@tY*_VW0w0{9
z#z=UeakuW)+=1<@*$pIh(WD>N0UBiICdBxF<)wzw!4>JDBbp3#VO`BsyYBuBGQaVt
zWk9g)=`3BB3WHbGK_4Q^l2uN`f*<$io>$SHFC5Cj7*zdwL)ps|_!-OcqFg1T4^czJ
zAxZ)Dzo{P(S(g#uSGA^a+`JjX=X5D$%Y4rL!=N<V5@`rrd-@eW{_~yRg&3#yG%_2H
z4GtPCs)GiocySB{hASF)d38q#JU6<)#;b6^f?Z<n7(6!PPL>=p3`8XLgP0DQa8>*~
zn^I~F--T1*G6ha1jB2W=JCk*x8^8<+>4d}|8mAb=Bi~R1lb3KYm<*KY@Y27Kilste
z2E*0#YzRgKH0TqYVWl-y^_^GcV<3(p6^<Cl(V4xwoojD&rlUd<bbT8}T_QQkQT0{j
zgb*4Ifq5{yj*V`(d3G8Lt~f9T63YeJ5xwoi3*$r?DMKm~dAe4+62jwb2k*#nJ)u~r
zZk}i3pBrKwlba1#>IT1I|A9kFG`8zc7e8WE80lV))e*0ez7MdbUlpFhahJVS<vQni
zfb$uEJ4Jlm6vDJqsSQBwSlR$oEs6mJ(7ebe%e>K}2E?gM=~NxmNYqM1T@eF-F{9%U
zg_P%{IIyC^oivon1ir@kehH$(7&}>(Xet};yMSeyS@t6}ifEZ?)*9I4$s-s>Ip{<#
zj~K(7crPOfoS{r5fsjNtsnCHqu)xQ7(cyhI!AqCWCvt@-28jxba3wU8&QDm1>S!!e
zhL}g9ya|b+v>Wme5qNcoh<qChbXL4jU4AQ6Fv?_!y>1<a@^mBc6B)IOXJ!^GT2&l8
zp@cj+I6+;&Gd4maA7pgHC@{z{D5f)m(j}QEjMQ1G6%d)4{UgWinWPsCI^I$U9;D?k
zoZe7&c~!qvVTyoKhQfx5Jj(BosN%}-ALV;l20$O!nbO@U{JYLYb0Gu3C&0GnRO0oQ
zj<*fg|HGO~6HMb!E47ZLP*f6St;#}><5_vm97yjvlo9*8T+oRKy7FR7hi2e*cTW%n
zH;OJyuSw7u<9Ka!+D)xX4Wl#3^O-FS*Q)L?tnnt@n9lGk52E5jnO#}IDMp3U0mzHH
zKXTC@7umW}X*e-+C!wQ|)*xo>>g9^^Fd%GdffseBe8`1tisXX~HU*iEn<iKrSLk-=
z9eCOcP`y%LIN+s^WteAlZX<9hc?N`D<{@1@m<5LqtSC2OTp}coXY)1~+KZ?&5G5A@
zewA5r+|SS<J+v+>Oa&vrcP;@#`CZ=Bk>bwGFANbkBG0nQK=CDE{kw*UT5!OKb_#-n
z&$cBTy($BsJ+>(wFA<z`AFp4CpUw47fwnyZ7@b^>cmK6knc<9jRJ#l6JDJvw^YaVt
zL=>{lK`UxUr*s9-Z~!wj91LYr3DL>2gF(<C7>SF>gBfdo)`xhYT?K=*py{-paeJ+$
zT~_$O3c+l+S%Sh1eP)|MH8+}XtIH~*jKRX<qVhuq_~DX&>f>Ngjzk)wcjdHR9YWLy
z=k+mQOM8~2m+Uku3MYmKvLRqFX&_42CS}mzX#O#isvn`aP@+=D1M2b+$1uPKG8>t>
zwz8^0CL=)kLYVO2ow5LOr)}$TMq&|pq7Pk=MVxww&R?=cg=8h;e#4KE#CZ%hAw^>b
zu2B*Ld8Ck^8-Gf9W3~k5%>}s_1<ovR0*|_@WdR&E)n>&Vd0iihs!nbsqIL-#A8!~~
zUBC_Gq(oHYF77>)(W=^1pPpM%|ADuZ@w6YEiZc<V1CUU70MgzXMqu-dX0?0OM%#0D
z2<@(Op>AmaR6(@Vo$^<mi*ORYrq?4kPUuHJ(6n48*gd9dVyaiAsjf`7j8YTU)E$sJ
zpLkWXB$^x0V#J@u43Y57w4$r3Ebi6|b9&oPyhfBr?{Cj=TvIP`EZli*o4es)n?1b0
z&0W3M6*{|wLC|<Vx$569;GG7}G;HXn%=ks4*`u0<@r%Z~`*Fu~<03qDwWg_0oxiYt
z)B{BXH9Hk#uB=Q4GxCk(jy$UaOS}-01yp&0i3gbAGkRUO>8R@5HT&AE$})HLewAl$
zn+4vBv}|u4onC397fxz3DWB9Z(^=77U*$m#OAYRza~m??8Z>qmnJpv`Q(ErYYdS>a
zpHE|HC3wvoI66C{dgk?N8yV~;o5FgM0!KLcv7d^?Y;dd&TyzO^eT96)`^k}K3q1Ct
zA?1`^b(x8%D>cd*#ownvCLO5IO&ReG`rx|y3dSH<TNkq$v=3=y(qB77fZK91bJd>c
zhtY$N9J2r~wOG=PazCnYB@mgGssUgy#iWCwe`LDs>#v+@t9n6bNpC4`(=mq6iM*u&
z5CPBrZ<7!06}gb(sG>WW8i;{Q|6wr4#$Rk=u~u_YRWQmF%wqu8K+du{uW#UxPUp#*
zia<4!9Q(Esz&q#ap#BvXRs6=jg*JctHEsUx>)W39+|uT6I^1SB>Zv^Lm>SLQ7#$O)
z(&D|yb8mS%5Y~59M&RUEo@nb2Kd-WCsk5w(t&T}Yqv7dC?p#)rv;bz6@zh_?C_OD(
zIGIO|pIRtyUSIN|fYbx1^oM2xw%8W#xK=N#+|(BJO6tOOdiMk4hOwa2TM0Oc$WDaP
zQ%brlTFdA+8ji<z=l<sDw*I6xZ}rjEnUS71OVG;dO53BEhlPs=Tw*2={JaS#i^`H{
zkpaaWUdC!(ugEUG_g0;Yzpl+*vtM^A85gZvSHAVE-kpC&%R?CrHvUwn3o=s0vqH)^
zS$~@{PCR)49>=#+A1Z_TkgFL7XYu#G{kk^)zB}3;=`go%NiWf?`okJ4Uwx{rJ@%pu
z9=|h*5s0$5jbLJS^xI?_jJa;x!O>k@q06EKuwcnDh1aoF9?eh|W@V)$G_}a0R0;<0
zK$qw{%pzdU?`w{9V`|$s0GN`S)Q9$~tfv$obLTSvhsQ84kXX}QGS>frD79S+6qZV+
z@U9H9qg)QDsB(j7R!rnjfrVG3<W$_D5UL|_&}c&qyrjF~B7^>;Z*NQQx~0t?*wbdX
z%U3Iv;K|VW>Ld&(Ir!uD>JGbf@6BoiS>Z=sXv=@`m<ErIXsV;j*c+eD$bg{XO6k(i
zOd_Ydb~q{|10CbVoz;6K$QK*Fj)N{Uy36nRfw#3iAG)i}U#-_qRTjUjQVN!UEkl+;
zRhB(%@!A7^pMCE~?y(^_^Myy-ij2YhQQbjLYpKJtdEKF@ceAesfQQ>t8;2_^o(as!
zSS-H#mUieDzR$*$S&8dTG#Jmt58Tm~zw|^q@!Mb3Cf2K}op}6M6-&9hB2aDF`oQA`
zGHQ!UI%_YdY%5ea7%Y}-ZE3D8ec;Y^@MquO=B_{JWvJU(d5ibmV*O72e-F0hFFe*p
zTBfQtT@FiwsTEKgC`7I$(eb8mV4GASh9t@rgWOl$9Bl+N8^Q=OBQ{M}VvK2)tYa3&
z%A0}kl%XDJrah(OG$8)*NxE|xfIEb^{S81Nk6t+u2Y{FXD2-<g%O=|5o<&<-piwE&
z;8j^dRb%v(M|#YqB@CErCZiFLX;(1d?zyhMzI4wm?ck^1)%HGco2JG4JS`pLxs!wp
z!>m39g`dCvP}}ps?d|jzA8X5hu1=+6nx0Cl{50V}%cu<Z+^vOz>kcQncpRrgIyRUZ
z0IDRWvkUj%)b{_xd)tC6|Ey*&7wuHxo~~=KE*;X_Y<FDK)_(9E?bM$>(nfzNW1u}9
zW;RTjeOH{&-&1KBrPY<ywpX)}gTMG8>o%qrGBh)pyJ}zC_p!I@Akk_&^_yR4d-5YD
z+=MYER8|bSG3qpi8YtR3isfUU?|vj&!cD!pyQFqL@QWXm0h(B~N`IDp3%6a<4*b*u
zYNL&|{AZ8G+8cI=hfn?~a9@lz>E&%FMio&ULilO8M;aY7kI&C}L$mfN%$Px*bpRsH
zAzJ9pk`6tYWv^==U`oeX9>(*w4FJ=Bz5}o==XIp464su|ru)+{7yv(h(`J#9a=K92
zkr?A$Akf??3ScS|8$YTtNV~YQ*;Hh(tS!y9{XcSFJN)AsEH`MXuMT)QoIAFrxd%S|
z?zW__#hmz^Z?v@spS6Xy{;GrOL{+A(%8hO=oi6d5n>%lOQi}A9_9yoJ_`BQwAG}v<
ze7&7UPr1}iJeeIW-G6hNzxi;Rz2#6l_6I7DK6SM?t8d?>g7K9bm&O{<wwsz}&ok}6
z_59rhBev%OP0io_SZhz{b#cvV*nFf7b2dI!D(WhpN{rf`y!&?u)<=UucX#S&R_(m!
zhu+Z^CI^2<5D}Js`!pL|dFZ(|dg)~RE}vUTOFTjsG<sD;Eog$v1(H!&X0<uPY%to3
zD_Iy$j5}X+qI@ic$RMwiR;qLmQ-_hz3}8e104z;ex^B~P_uuk^KIh`V^ncs$Layn6
z!f5RApYCKD{AkRsZD^jVRs{_-r{LucP8{L|ABI_{&g1S+^Z6r^Hy&tL|I&xs)j$8C
zws`9`mu>J{$Gk8NUwqpQ?W$k?Slj=%AMh)rOykkX(@Dx8<>}B>21w6}E1$RXFdp3P
zY%C7%5zqIv1D|}CHu`jy<8loCEQbSRYng-by!O{Vt|KIewP6=8-7r8Hw3H>vr!r^&
zF32eDd;cA6MtcAkatq?UPey<ZS(i_|7$ALJL>xXm&*uih-Jh9Ak0V;?8ELgUPeBeY
zZF^IUdYrxGu<2YLae@~uLYu{GQhHIGDeAlQ3tnbuzN}7gl~3GLfAMB{OkLv0k72HO
z#{@_^M|HvI>1I1RIn@V3*wfqcot|^G8qW^5y$3KlcE-Q^M+wlAnLs>>;jDIu=mrD%
z^2Sq)jzE0q`zGn(LUGN2H(+2G4adhDuKK&*-wuA_{x*NrIS)QTed(Q)Vw$`EQ}_FB
z-PFl^u0Unu&pJ;^bt^|plh2yl>q6cAy{^?4X!m{czINba@6g>jzKu7@;&P?gAl?7|
zJKHtC^wG9??cNypl*H=lB86Gnd2d3Gqn2*b409WUWoAj6u{U281{)(Oh73a2&!Db=
zvlL?K!8-z8<GZj?U$N;I-woVA7cI%=w9MO%<MG+t^#|N8;M))-A$rsuTWXEvCCY^Z
z^ci5eY)V(vSsvx$&M&vl6Owe}eI>Y{Pw<e@(_NpsSl4*t3Dp#i0da6E{Id*z6r{JY
zW+>gaq8o#aj-S@&zx3!VN!YkS?OC2l8>YgjQDGQNV_=M>l#i<h0b{Hx$ro|JxeLWz
zU%L$Y9^0XINNdo&AGk};STDi)*qTg#nbmZ7zXt7oP1$E;1Q^hiCyZazL0<y+$DPdQ
zB)I#_SZapoGYU)E=wlDV-=dpdm5Zi8m%Z=4P5Tb-X(LrB=MAbwC=*5(1He1*v)g<o
z&0B3Vd-NJIbZ*JK`(@i!dwcIleaOeKsStM>`i~=7HfAK!iyo{E!0i|y2zk^?ov!mV
zg4si|L<JJezziCSB5OMiCaxqxGmQ3kTxoB5ASGVJ;%N$H#rT&v_wV8(e4m$*Y|af}
zbjcr`I-?V}XKm=8PeaD^4QjU%)8U?F0F=Yv-_lxiR1*<?!;D8f+yq#Y`Scuzfw12C
z<DU`|k7|KIRkSm@{0Y|MG|8%_ZcLwMWzE@r-m4EcUas~2q)z8cV+0PA5jd>JQ0k>+
z)L8%7(ZE!e8=AGQUXRwG@N;6pHuUZJ{o0V5d#z_O69r?lao+=XwvDUyc+k52ta~8F
z9lUSR3GywI40#(4W&l|??&QgaLCM;fIk->v4Y=5tW}N|!{-pY1pbYTN7X^=5L-Zkq
z=l}ujAxD|)w#zWE$FHyob^#}@u@~c?;UAft@MK6b+d;0O0Qh$hG%)e9ONPP+vGf#U
zgC|eZIldEk*3@{brvME8spgyv{<ap@+*5z8+1Tiyz|>>bt^0dDfAyeH2Gvi&-LIn5
zibw4OcV&=|7a($?0XJm%5B$izZSQ+;*Wll(C@^^KosGaJ?$g=r<L%_1Jgmb*It8gZ
zsYgR-g!yv^R$2L~4R;<lvUarhv8i^OHf>!2+tgotMjYx<C+X@>JZIDn?8Er6+%{Pa
z(PlYNqsNbYkYXX4SlOC}Y5@CezV6i1xfpQ1(w=HiAMJHnRR;0H7%tStA8;C-F!AXz
zBYm)xeFB}0Ym3=mwyTE?N!OFaUgesZt)3P7ZI{;=p34wrvP!9Q=%0L*VM)qkF!QL@
zzt^Cdz>JT4D_;nq4OjIOW=w4Q=>`H0>wnGzOzEx{{tfbDYlp2y&2>VWZU&%VGad2O
zQk0akvpRhjJK<748x3VA<1S_vmOM%x1@Cb&B20YD&$TLxuaIuH@1ys${U5tGzSoX`
zDV^7`8Z?`FF3Z4i&8xzhs&b%aj#G9lDXiRd%-K~xpvQJ6^}`O!`T>bq={)D1rQkzx
z8BaA>RVqE7mM)q#T>E`*+jf~)6RsUU)lNS1ay#;^C)@H%N81`lMa6r5-=4PTnuG1&
zoj0^Yck2Muem(Bf3}u?~P&X?_b(rV$nYN(Eca(uPV&JXl5#YQ&%T;YA@P(b~f%b!j
z@-r!_I$-cK7&y|~z5gIwyD=d#6(%d{Fi@tsawMOb2xk&#Uh1n{=rbm;vMvw?mo)8J
zE=;}32xYRQFIP{eob){(TUWX1BAqV6hlG4TQR6133foj2ZK&T)>6iiF$J|y1fais0
zA&yZE6EvpQ|NaJmwB^0-vAazc8j@<uA}8(2AQJz5WhK&pJSszQ?vyh(9BBK0_?>zl
zKb5UASMHSS`gY+74bE2|(xB1dlrt~tO~w^%$f$xB5AJIV2luvv@3^HMzE|tuTdr-3
znvVNuX(_*ra8Zw^uKuYHv{zr&9*G{^Fbkl!`MJ92xr5T-IeYJ^pvpCO)3t5S9oI=#
z*A31oiNSyLp{Lptzx9Q7?4j?q4b3z(x@3c+);!~2-K|-`l6K&)dEedbrjI|+_TPSe
zTaYohpdnDZEbA3-K1D^H&*=>N(&Cak?_BN)%=x{DbE>#y2HIIecK{_+RBvwa<VbFQ
zfk%(RI9C-gVxx${?zowDTbHv)RA+)AlfQGyy%2Ml*fHp(qxFPi7y&>f2Q<(2h2y24
z&PcEnT%<1q6JM!!o~Y6Hc&7z!BenB}&S^~P4hjFPjs2|*0PBQpF9A>l1AvwCl*Sub
z*>YK66wSIIYFBkt*1rl(2=36CmTJ*-z`N@jM+fx1_Jv!{|Ll3l!*Q`#)hWK`{^T3&
z`Okg5t?13Fk#=GEIWTrunQh>f5h(x4mmc+|(c$}UZ@2#BhinWM4{dL^*^E>d`?Wkd
z^Pbz<@?U;OBVL0@cTom6<z8RrSZbUR_Zm>s|HWIcvP{!o;Ii_{@%Gqn{!u&e&@+BN
z!3HMoY0{tS(y}7Y`>&op(q7O9C0_o^N7}VNaBsWilkaZ_?z*AP>5$gB9QAYL&mL5z
zaWYZAi>G?Rp)>Z$?<#D=P!0K0#U5t#emfv6f0%_y4hE%oW_u)}gRXBlkC_0jcsX&w
z3wsXGRo^QDL(xmVX0VkvO&Hu$tLVIz*J-JU<5B`~ESGsdfD@n_o0@fMu-EwD&W{n8
z*G#m#SxOm>Zgc*ICo9`@`egChkM_4R0NnkzZ2;C~07j=Zb(NC5<>bQ&SyC#vDl#fN
zGfHEUE@{DOmKYpSMSWEgqaqk6O&fpvK6qD~<5SGrbm({Ti5J=v|LXJY)vrFTb=0!X
zX=x3n2I4?Ue2yxZp(}@qI5)nb^ZrM_{CGS5?WfyyA9-iH<7YnF_TP4W-$^eZpEdLW
zZRoA&hf+86GwG}~S#J8opLAN_%)NBLu<=IUync;lMsF%!$nk~Pqnh%sJoR#$*ByUB
zcg=Z>3+2%~l6wy2V85M>E{8G(YdW#{;vapz9eePpcJq&Zpxyk52ihW!(CDZGx1#-v
z=YID~?dX>tYwCJ_0cb<dt+`7rEX6E<)|#XnusBcDlxopvU)q(8KXhkG935T82Au-c
zfxAof5Ax(O+QH>K;wG}F7yjHghw%<C^1I}=B0&?pA+Tbmv@DJEEJ_$2>kkg4inAYn
zBA}VTZ0>(x5d3nM>V#PW?O2X41kpFWL@nU?Lk7!P17<4&z*)+(b_>tRTW?sgPNdUy
zkNwb-a^WarU-Ti^c`-SPf(2P%Q(dH80lJgY*gpBCCq4&0d{0}rdHZ*N2LG{#pKg!;
z=4W)b{GRTXstN5=@SQvK=2vm)4AJq>Sp&wNVZ(-()@a&vdGU|`rk(uW%k3S%{ONYp
zyYAec5fI-!_uQ!S=r?&5Fr!%jQ$h>?mfxr8v=*hbJks)MKgxRn$Bb+Fg`@gWO5Ov~
zQDLng7nn`B96=ujAnKM~Z#M4cC1g#sD=Np+|N8T7`S~O5=1;x9?Y;RLy+x>9Y3a9m
zM1%hizS@p_?wf6%PNv`Jqpmnp$#d)3IZf52qdU9mX&MJQPotvUMJa&KKuD)W85TMS
zx;o#ib)ifdcbSx5&frRHBQ(7RlFt%Q>$W4}j|}})T3J)N=<s4=hla6RQbQs7Gnqz#
zzmS=YP&TIbyoI^WSejRz>j|2_1|>!OBQT*I<fh{#r;*<7oa46$w&%8O0BGk6_rMg&
zope)cXHJ4mu8}Ed72B1YDd4UIDnK2eEHNyr-U+dQD|!dtQzWmAgsXGw98%f#-Cz8V
zKk`ib?r(m!oz&o8&;VGJHD$USomzuXQ%(xZz(g<4GMr{6z`)VxxHSM)G#xwh@U!jl
zfBu>F&VTUJ?ciNHVd;Vh`8<y2<Oe=_Z(Dir8NJDM#>*uJ!k#<~62?X|0DZ1}PD>2l
zV!V)JpJmTAhg_C9S+qqNw0Vpfvl)d9tg3r>F{4?Z(VJ+>n-~7NmON`GR@zIS{dzm`
z|1<ZVPnuuXo!@UdcTdJ3XOPGQn4?HBD6GYm=#^Z0Var>#%YN;5{vTZBDu*q<T5s9q
z)o!h{T8X<}Q6#mL7{vgPAOI2|k%7S=4KSF&gwEYF{(ipap8LDc(>>kKGZ=up-Oul)
zbIv{Y+?>_B*?))LxVz!XZcW3A(?5Sfrv=~YCfAkubZU+M1oH_K+Ld=+t39;VlY62|
z>a^R9*~Xs&0$))LMy1Yiae81r099cd?!`M|&aVWd=*4PB#4>y;>Mn*DSF6{m)0U(I
zT{1NCB8u<0@rqbQb|8)@lNRS0lguinkFWmI4c+GiR1v!1tCC_;l$M`HB9|?p3oJdr
zyn7S35fo$BEe-p2JpceNJ}?{#2}X!;JMl*ZQ<+&?de>?qVTGK62duR-L53f-;srgs
zOsg})IezWB8&xgoD&?bp`Tg$P6EAnO8eeh6^$fGjrLedcAd$L-fm!%bOPM^<YBFx8
zkWsMKHrKo5XJ6}H`pSddZGZClZte(kE4wIFFta+0!b>yjy55=Ae^y;~&bCL}A6bMR
z-gzb>OGey@>V#&5nVWd)rmMU4=QIpZ9AcK9UQJ}a%*0eMQ_AETAh_b&(5t^2>N-qn
zPwu)}^wpy$x>a7DQRSh?cM~e)s)|&(Osi+1f~msko|62hHRfE=%)h3kgU=CoZR3Gl
zqcsOzJuLM&kiop>BKo}2VuU%;Bfc(D4wnj>w8KSox1w!vaTrQddNSvyly}wZ$;5`1
zWiQ%UXtxm9!6CzUelC`lPH+#O!EX(?&}7#vb1iE+W$7NGWY1ZFj5Y8<mOLuTEM<(Y
zm@VIuS+{HH=_-sov%v903XC()Hq0c8=qVt;ENtlrt98%HfUZB0WL8uqP#1h?=3ce_
z!hJW5yw#V=>G*fmZGYleH>I=gv&ztO`pv4f%pZk@v2%2xmF-n1r_>VLP5P`Vi&-Va
ztju%jYR}T$7Ohi1e6l<B&@*w_1rgdsvHNWH_G`MelKZ_Cv}r1wQK<D-R$VZ5A!qM7
z4TEm{lh1Vr?!Bp-o}W_^sP(sGRnQfuEVLA0DlvKqGiuRi{Zo9@0?w-<np0~&qw+kn
zdcK?0Z9j8507M0aOsFhls1zwi*OZ4<sGMUX&u}*0nRB9_-E7VokkJVz4h9Y4k}oo!
zR3GrGJ0@E~ALT2V)1#!KXa5Bhs7sK4R{N=sLT(r)Xk{@S_Dwr^zVI$5X9J<&!mCw2
z`yfK_nUy%cwVVK}l>lxA8bg7;rMz#~1EBEl-UlrqM>K-9K1$oOW&Z+{TO5HL#`C0*
z)|e5*BpFc>T3y#$gEG%(iEPy4u*<KV>P~4AtJCEjEMGZ8Q@C9qqPt86b0$NmDuDD1
zTo@xtMd*Ui$*u|Y0^pSdTh`e4_3u8`9lY<BZb8e0yD669rqp}UWUqQ5TFwy>!s+8q
zt*(}7QLU@^7)8<R+IR1bUf)0W{inLMXW!^9=w60Syt#|W%0|guUV2p5fYy?V!8*Mg
z#c*1^1BN<eUf^QW5|xQ$bb-nvsug(3uKLP4t(0c%n;4A3v*o8SJu#^Y8p_Q4r*c}z
zLPJ1BF`PS$uTMy>BvK-es5=f!swsRX-pFH6s??y5Fve8oO+=srx+^+p*rRH;;%~Ud
zA7fOiik$%Hxq%8S%H}kXN7BQ-yM8GABUJ#b6^>j1IJ24&q7(HRCX|Ip1}qV%MmZ%+
z!1=2W1&xU&-mFt=M8c41mC?PA{7Q|FHLE^~qA<VlgJ1d*MOu4WvS{t2m5)q~M1m8d
zkeQD{!;b<<>!<8$zL>p_ZKt9ozvbtSd;C0im5$J|Nn;1)F+0m{tiRKRmO?(Y`>OER
z?X{w=_<1IRw#?UFgt%lgr<ZAGwIs^K(6VmcS<~B$Tw%7U+jul_p=CVH7^|?VlsmS>
znD{gIflfB_AN=UgH|8j=t^$xh@(>QPqIIOTW+=6yNht47y9jIBIg6CT^0i>%XId3A
z+0yctAL)*;4M)C_8(|BH|5B*ruhQj}4Ix^Nz>KJ%?Rz4XhV*0@>JW42Tge}OdWYh^
zgJ$r8Q|TnUBM>sIMD14MR^Z69RI0#ugOGYitPaIQF+ifMf1|?Shz&&{&&uAGO*7l&
z+AXz2A+W8+Or-C8bJv!r!ybCC5IBlVhN_}4cnizKhZ04#GLd#yNQnd<W20H^Xqz1I
zWE^+EEj{;Iw?})Xr&Iw@_!-YKOHM0Ca`$|Qhr(lF(R{{-v9q$ia5j|brWMZ%stL}k
zVp!7($hl`;?XLK!PVDVc0YGc^$o_8T3Y|ndEtx4^o-|d@f-uR%7ZmTsr*&3cN2{l_
z5ou&ae6(+Wl2d#-@4oP{+q`z~_vBtU(XAhSL)T)xr4wY@KB}?r9#skxk`H-^-T?A-
zDij%b!cPT1{6k*wVi@VnT}&!HkV!tyIU29xQ$+k8fcRi|#Zbt>>f?een&{L3`nR&(
z;TlK<zrd1$z!W$GkMMyWah%j$5nR#5(&j8nZ*n&ekW?JUQLrG96<*-K&{8-NANe_6
z=mNyw;63w}3q2B5uFU+i)6x}`?zkv~15YSyX7lb_`HZ2qL~6SVU<`T!9qx)CL{bGA
zKneRc6fNjXJ-`u;l<)CZ3p1mPK_YoQ9zV5o^EVvP_Esvg-PO{uH@a2r@SD_<-}H<!
zESZ*~ES;8&p!IDCVeUCiet;nc_>#cTm{Q_x(rrG!-kp2u6?NNJyXg@&2zf`|HHW&D
zV{du5L1+{Rb5Uf*a^o2-Szf6dhuVqNhS433UX9^wzAA$`RU)&x679mqU7j)K*)|?;
zU3>a9RSN1MXbU&J26_pOpDHz!TYNKx1s5@?Olvt<a51#ta!_v$DrpDgZi>R|Uc-3}
zALex#tLQ~u2u#aeVLByD7X~7|0uE1C0mh>&U8-V?&5|VBaHpmj-ies$5m$vV25ngN
z>X8hN19}$n635^ZqR2CB9tsyT4IeV5^@q19wf<B9o67sXSEIlMeoy04;}723uK*l6
zkt)(sWE)#eV1t#91tfFoWCHNH{E^8&)`RH*gq&h51X1>~Q;2p|68_37r!-JkZOVAx
zKM7GKm>xjzS`x~{<VFhOhd!)ulGlWK5nO2vjVaOE&}87cmdiG@yRaK&UjpIlm@rpZ
zUC@LZmoK}piM%T%ReVhDy!qY7yZv|H*v+Z3cw0(5b3)RmB<IybI1qOvUQjQA38WQW
zZn~mfglkW~-ksO&$6e{t?@>I3>O6{WgFaNq^jyfK0C<juO2a^-aq26<Sp`wIn~WYx
z1XAqKa;YvtFCI|^%ggBlkbY>FqCiz#+>=pd$qUIWMNYAiP34|2sF*8HBZNWLiF};2
z+n!U29Q-<;6@nRt-0Aw$-Dg7=J8F?JJpszYx>j5w-$MYEdf491H&fv4&=79MB;q$v
zD=WhIA|R)o%~9(UXt+lqr}cN&OobnulGS9^*hsbhg!TZ8a_Wz<)T%bg(6Vu%gvYz?
z(owS`KE9!<9hnwh@v+q)g@3t#hdU<z7z>k8)=ug^L?+yna62h72!)UhKVF)Hp7_d&
z&};ZwduPe=__u!6-SDN4yVBc<=2(7Wo{Z$o#Bf1F1#a`<Z27XTGh5Onr|aq=T+r!G
z^F-oESw=ECJ*2w<MgqlcbROt6>CltX$5&wqkq{ye6e>;{f8-}UdC1HoFn9yPKYh{+
zt&x-v=tH19z7{{;iAbYEH&6f0!y^;yd0}oM6)a<eKa?vK>DX;n+=vU4k=(7weAg7q
zl0_i!#<_?!%^7X%QC=?lMxfA#0_96rm#G5i8G!eexr{uqF7c`v9=nxvPy8t%W>gFJ
zOF~NMlGscRO{z;<_lfsGZfjcCB_*-<UR{0#<Q5jl!cg)B3z$iebW5=0&oHDW3R)_(
ztR$={Gf#-GHEo+^9%OR2i!s2R*EU)cR$(A+(7;_8hjy1GHr^gM@vX-^<hkObx2vl>
z+OQ`W9OJ7Bi%N@&H1}P3z}u^rbnW@M?>^~ygFT+5SI<cq5&2W;IrE`WXw+(|8#E}m
z9fG%<71wF?N_?(8$VjA6jzSH3rin8QsbWNV^hx0K0?t3VqmQqs#NbEo94H;Ql5LW8
z_e-FcyfAcd<tb)FI#?GySmzgfme`g&#ZE}_0Y{*t7g1y(e})1Ry5*MMv1P_dRZ+QI
zRlv?omV(+<xyFoW8MZ{W#Y;g93l=*+9|Khvh{)3IaV3hh5SRW#pqQI*+5omOGh<Jo
z=N~*!oq?sBbmHJIh1)Rs<S*ePqXr<fD6q^ZP#8v13Tr|);!ufsyqEzhAk%Zj5|s<j
ztR4N=-|AlddmUP$hcRjxBQdfSh`9r{A@BR_UESe7`BXQn+kh@;(+{n_Z_W{iY}^SU
zX>Nw`sk+Xj*%rZVC0|{r+?mi#iN*a8ec=Z%{jwn0o{rTYiHWC@o{e`6Yj;CnQLq?e
zdoR9c;l+biDA?jYs&ZaYFHkJ`2j!R(D0vG)C9nBaAna1e(Myr!eR?251lOR>x9Sxz
z!K?tN1PI59a>ws&s_iO((POQ^C-usX@7hnsGWo<?vPVKzv-~sPC-1Z*WN<Q5)PVRP
z3Du{n8Nv7RP|{AsUG%o)5B8ubzRXN<sk|w{acca6=YS)q%%;XKi9;CPx|<Q)g(u=d
zI8n(ZZP5@NdKR8vV8ue_bq!;V{rR`M=l<;5-Koc4=r(j;|2wUiFPPI~BS-$b-}J3S
znyMGST5!`3Zq2{agbh3lUntC@Di>MHP1z0^@Ebyww^Za8%)q1@K9~(682&Kl5C4&r
z2}EkfSNT{g63l6^B0%?ILp{jlSKb_n989k3j=ptW*X`8<B`$L6RhXlf8GI8*V5mfK
z;Yc{kuK`(L3Jq_*Qp3oK1t%uK^VMd%^*DP5(zK;)Z&v|m@T~hDMpcnIf`;`b(qfXo
zP(-Y^N4&z18jy(&#y%th%9#uui|A8WNV9QT!B}EzvqsO2Yi4LG1PWgGI0OQhdzgd6
zG>6Sth9UC>>?DtkR5<{#y#j56i8f6nMmV5R_^Hf8XK2Aj94^IR*IsvSy*u&kpLb9F
z^RITtzWQKy`k7aJK?g79ykkndaL>ZQKlorbqod55WK1zn0j3&Y4WAz^6D|6<$~i%$
zfp{a`P$Az;8^aViTQiVc1%@AR&L`;d3+zH_7cJ;PC}#r1i{j{qO69r9_GBhWbzsUv
z$zA9%-*o!X=X^;A@o~KPm{T~5oDx-N5>qcq1)9k}3b^MYG7{EPILJx8&9cl)#amS`
zyy~=rfop`dOKebWHwQrQ$;u$~b~eT&Vi2MFH_VhAkws4sVaSa@lmP5|#>|W`g&>kM
z;Eki60R<o7kr<eFn+G7g8NHmtjXpes<piJ>DH)k)BtK*#l=-Q8;m>^HQ+x|7@S#*B
zM3c=uIi^jYZFR<(y1j>lr=@pXMKgJ!fH9<?5^xVecAo26V<z||ooV>D-|Jra`$v3H
z$<?2{M~9L0EZE+8FO80}4`ExLc5s}!S~o3!>4V+zmrit>uW1;fKYC=WPfM8Uv61e{
z{SJhNy@WzsO;2Wt(8{#ZESH3-sYOt#I2@woCm+MxC5Vjl1xY{Ah%m6l@*5A>uIOnr
zQeshOK2H3@FS@IL`vVs}cFWGq6F+*gd+VpqdKW3ZIB16IP03brO5UfpL0<J^tO9WK
zEES+-Q{<q8JG&Pd9@Aq`i|J+Y-6ox((kNPtEv?3O6#zh4H8%L$8+m`t4{i>5Td-t~
zA`3^vF{E%s;#2!k7?}9;M3bW$gy=50Mxmup4q<k6lXC}Z`Sxg{Y)2)j&T3-ITZYe)
zSw%w(_-0kvQmDxzep?id&fI3&-k7R#!PUf=GR(|1dVqwn@GgqVi}C!LuGgB<etUK|
zLX)mvMjhjn4(p(lm&~hM04*Kx;3>28C$y>O#E+ipW@)AGxw*UIeYbW8-m6DFR1tCI
zmoNF)Hc}=#)`v@17C!#o?(A0|^+`a+t4vtUXntUwp3J3&gKYV^15qT~qyxsjYP2PU
z0rv@>@Ca&DMY_>@Dl{Ah1x@iF9q0vko3rxe1zn)>+TZ-dl?<D`kS|B3)&20yJ-13x
z_+R_#kJYxWXm{bzmSV>sV$!mQ3ujx%`@H@fliu0r1Y{e3v#N67c?!v#ouV9Kn%Lno
zmo~g&rU$TP47puN(y_2ki^3yb3PO(6zq?~XLO1h#!YgF0Sh!5tSz;HQCy|(dQO$-j
zUe!TJ*Py$u<tk3g?b_NYpxJ8=`^De$7vc^?!aGkQL$ay}!vcm&4222cF<X;foFgs*
zGmg5y)7ss~^<g6^5!-xgsaw}9|Ar>rE@+3Mx1>U>giWQyeg!fa@`7QnI_M}bla3qO
zJ3ztXqR~}t_dTu(;kbqfQ(9g;aND)rq4(*1y!Tw!EnIWhJp(pQ?JBPwnD+&zAAL`^
z_`tKOd`|j!Hayeg*&{xv3|ImkRk_k5Ei6D`$)HY-<!c$s-L1NG$G;L*WeJjiNE?m=
z(;HD&DsE5$c?893&8Avy(-1xXX~r0K_;RNO+nm?guB}#gRr^Vv|I=@FuYK>a?$G=7
zE~EBlKx6g9Y3%}itvjbpTa!y0zF)!<!sY=cWl#jnGj0uk@ids`P?XMe{T+{jlAxB4
z-S`Bb$b-saL(hzRGnLX{3`GUNZ$NEV0Z{n201jX^7FyYX)=x}UB_SXOD@P{efE#Q6
zL}HdxY>J5C3a~Y5^>XH$-T+ZuSL?|Z$SGa8xtp5ReS8$o)tAbBc12h<oWc(QQ~M+0
z)S->AgAa6>un;#T2FhP0;QV{8*?sxX7|QGF@$iZgD-_J=p4Sr$jAdhUQp6FuWKM5V
z5&b>7!+Jv7g<W|`CR38hG!=llkiHd{7J-|K^gR1X(LSl$j(9eFUM=^2y^nZU7ndB=
z-G<x&IK59#hnKNrVQD07TDuZw^b+y87hiX)#iS<_w>-i+No96cJ(>~H1o=&h2kuws
zv=K^Ys}y%t=y*urh!+(S#vl_3F`%OIApRTLO}MFTvVJ6W0OsNr3M89;*68N54SO<V
zOWKpbvPl4QK#afUq=hP56?7_?&9_#&Q;$5?z4_Slg&(Dl(q&S#rc_(8bn8h{#cPw*
z1LCB#GEJf|#16eET7N21cj+B+06DJ}c<(6?a^^qe;>mFFN0}S-P+TF$yxx|%z3nOh
z?i;4xJd)z}TOQ*m<-#~HigLt>01m~`kx<P|=E*IOz&fo9SQI|RQVK!(+8Z5HU3&2i
zU**-QVDF~<NQX|!tv#z<Zo2q_UUhW1BRQy43QGz*T3ZSuzPP6!;bc58;|?5~S#+MZ
z+y8-E<A4vIyQnqI6!U^IySN6jG5`QT07*naRK2(vh%Kno>IFnteE}fjc&SJMGc+Qz
zk#ba&o9Y2<YL#G01>n3&(B=hg$5o|}7ng9p{({Dq%g-FwS%~B69sI1D)f)f)+pq7g
z{P6AFp*wHvW_45WIC~37-{~85*oazKJr^<|6J=c3!d?L%G}<NZ=?yJj@!5Rsv|2Ka
zXB8LkFepM!`CHO-1?-;Kxatr2>&N7A#|5sc>_=7Xwp(W+mWe*gPXVY^&3Z;;9V915
z&r6P+s^o;IBCW<JDqX@NU$Sw_8_k4~4|k9)pyyg75>^fvA|kZ*UiKqh<-{cTR#gz&
z_=~Y5w?}g?6Iz`aa}MB)!r?cdE>;1I-UDDMLbXw4FXJj5w?11_$P{C_udDV&AU+5p
zw-9<j8_Rvb;Iq<|by<^9Yr3L(;g+igBC(x??$v%hYH{udPisjh&e*Gi7d#9gv^+*q
z`D-46XY=Ru3vRp~u82(QAx(M!13jPt+P#HwC;VSfq356nlRCViu&F)h+_Xdfpki@8
zLFZq&iFI<srV*dJ#`GTOF`QRLz+qmFk8bM7?s+N!wL~r)LT2rrN?}tMk8;_^%Bv^4
zH-7lbjynWy`0WpMH+=2`o+#}(yts++=G@I!snVEJh`~FPvJ>kpooPdq_AJcbIND9d
zjH3_Uc|*5+M%#gf%RL2Nt|gKv#m`FCUhd&U+>j52e@X>uVqLhp6>0BHy2(EA3;M-0
zZm;SzmqgE#!$=f#-*->~B@9@YQSV~U65G8s^wL<HQ=n9QP9yolvqE<z;EI4snO0wJ
zF8@x*h=Xbe*<v`bq8qLlTFft~H>OH}C`F`8NkI&9vol}YX}XZO@(Ag@u8K!zPbNp{
zbwNH9<NxKfq`qARz@T~L3V?k8ei{l!#bQJ?%p{5v4XYH9rS_xc<Dw6i{qT3x1)Hrh
zX-Q=10)<E|J}u2`c8j{od%rT!uDkApKX=m+Umtc_8T5iq1)f)T4p9~vi#_-wApNYu
z68@OsS@1BVe_DO)Bm(dC9s1n8dK`1hElb85{&3gcS#9x!4`%n+4Y#SW96KOsMS?S7
z5e8#JCGHf<i&7r5D$~-+_;w-*%6tIM@PNv|l|W=rvdShEj56<<4lHq>0)=K%Lxp7>
z6@LE2cf6u<+aG;qwD}9geM+r1b)xG<(W5h9`Dqx(#jqvCr0=XIwX1Pn75K`-M~#AL
zEr0ZZw19q3%V~gBZsZet=`$ty&+&-Lh>H94S>yMzt6P4>rNk$42DBA`D$}{Sxo&w$
zu&QjxukPl{Poi|(qvBFwq&Gm}*RNM_NZ!H4AEyUt!a+CZ{UQH^WT&Wk0I%Rz-b&>C
zU`xp#;EkZ@*)zN!P}@}iISDubxRYg4ue16>Nya8-*b-9wr58m4#uAd=otN1=$Pl!Y
zMC!!HokCCMj<_R$5Q4j0YULK6ex+Og)ZHUh0JO}9f9HNrUM*{j>mFs+3+loK$r29X
zS3Y4LZbFAQRPqP6#NmPp?_OO@dhioE2CO-dQ4}Wz7j-<D49GnP-uJIewXP*KuLWyt
zPT}IX^USSRb_*Z9EuP#K&&#??aOvR}bfovRyQJ>2iYsn3=0Fkr(K0!MqQj?Jt5xBy
z=`H}4Lm76^<y}*^ef`XecNiYJ{f6$UPux9nSCU=^p=Cipjyz_vqBj-XTWRzEMTA29
z_TPVVcltZO=r-R};S&Ej2NIc`q(}alE;5%2&u$8z6d@fZ^eE`Uo!52K2S=-f!RN-M
zbsc<i1tvQUj7cgo5vm+zpm0wsO*XVDz&?Ffypp4DY$oEW(D{K+TDpRg?7d<|K$y|>
zC4I<a9G&(gqgK6~r^4G%=0PT6w?$Ft`F8^(-dF(`e-jY<d-x5g?J9uNf}pk-Sux)B
z-D<jtCY9n_1Q0IRneZUtIPJ&S)(|Cfl*%lK2orb<Nd_tfR}R8B{pbt24foW@C*@`|
z{=MS&Kir+rGR?+Q$9>|8E||O4$t)?Q@XDvxi@W4*H%_wgwDrvGS9gbh_x)~t@Yzi<
zOMd#X7rHfW@s(7VEhf87s3o9B#2tIHlRBxVxs82#-I(XjCN)m?3q>M6d)IZYa87;s
z$9iSxC7l?QoYk8_As6T|$H@jGShcKG&?j_X!HnX{w$>S4HGV-r%p#MySyDaqix;~i
znirVVHD{wJXj9ST^KLTuLf94UQBe2DL%~t#%<5S80ac!-zy7l*$h4dh9VbC891tsM
z5P5=vAC((1Wr=eC2X3LXjuNc%*QzE<*H4}8W_1l(s+!koaH3c89XlP*&uFNke6&}5
zPwGAg#@?Hn_~dx?rXGCZ@Dz-b5|NLBvU^JiP2|=&zptL}ta=s1rHyYum+wGSiUkIx
zupyfXO{8*p?3jvjJyHem%65P|1;(55dvx5?j}<6mA`0SI_%<q;lbPe(&|t?}_<;pW
zN{Erkh;aFn2bq>`)~aTm&**mFeP!L-bawg(msaA)AAP(#^&cPV)}PU&peA-iQH2Ix
z&8-t9c#s=>p~Mp=;=#E8f?9jd*B|-gkNfo=!;J9ZC6|-BKhPI_s6aZRiVyK+6UgG?
zqIyIZx+{M7ecgfIxo^v}U{tO%y7lMCKmD}g@Nl>E)91VMZ)rG3xhZtukuIoZD7qUe
z^w{?A-KXoz)J0bToz^-vl?7b{&X_Y7fxJgi$cA*`i8Cvq(c00YSvvZ<=4KX0u9R7_
zJop=T`8e{%^SZ{2xeE0J;3PIkh0F;jQV2T{l&;#Caru<qD?If1d%Jyi-C%Y``Ox);
zR}wXP>*8OC)TI<w!pBZn{waQQ8m=7r$StmbnLlaewV|HGxd)!<mVW$PxBiOC7WXQM
zaFI}iBO8Z(*z`lA$L>k|35##!Fk8aK$S^2tku^g)6tM8cd6G-$0gOBZV4SdJtY8i<
z@|olTN!5~71;4gB9x}ygzw_N(xxCVmFA*&93$1a>3l-@8PpD9mMJAO}Cv+j_p%1;c
zJD|CMk(4s~-uK_!O&!_Sz4bQ_cPl^FSX?#uCL1b{w914BmNFx3#@e*{UgMT|4>PWZ
z;xUp#DxfoJdD@Jy8xKpzUiZ~ud)yu8qLWfk37UeanehqDvM>CGh7_7pxtN;LhNB~Y
z@=49eAL`D0<MHnNam{V0V4rsvRJ16};+JK%4Ru>*rZt>UFN55@s$Rw<`O35IDnOcq
zLVn(daIpZ>U3k8$&?%%a{7)Q|CMqNw>Rs{B2&)aF&P>n0=j!gN|MFAa$$$4ixACHS
z5UM1R%LVsP6mYHBA~Si2!xEd)YU<j9-Tu$s-5vb&-738#-e`(S>YRp<V&AetUYM;&
zZ&|YN^MWuvufzZ3!`<B7*T<a-30w4O@p0%6KGf~iTaIsi^${PZKEI|aM7T~1=qV%7
z@R6Tp*tk>U1z5yQU{=`pVGmuV+8Big#e-9^Q#!acrlR$y7cii<3<1=ltV;;0COgem
zjdnZml-7wS^bqC7dC_m`0YV}oEWNOcjTXnPj@?U(UtpvSs+0l*q_Dd8pxN2gV{fWO
zeYRWBJ@!*O6c{7sM;UcilY&?N*PredH37A#Ie`srq&csbR(0comV9Uy)iY2)WI|mc
zs4luHHnsXQy3Kdrr}YZ4G6It?<0!T-AOGghw3fVFX1yaWk@b`X)cQ?pDeKT@?(t@x
z-DpoRi~d{psRcaPo&DA?x((gzbN;m68sOwwkr{=bjK;(jg=%(2U49L}IA+Xz05kCm
z@4LA>tc@+B6j-h*;}H^%K}#4S9~H8CG)w}%rFHVFK7G$f^oS#8HTG(mcJjZO>CWo-
z@v??Cd;G?PhFQeLX`w)vxFtQ54m31Vs{HorO~`%PoHWYa5GhZ1Uw!?wS7Lk#8KoUQ
z%8!D^?Le+*RLW-VxTZVwhkADYeQIQg>_rsvo6(i;hraj$zt^|)<L5ohasd_|y_HRk
z{aNzP3s6dyt`xVm%Q0H~0Hff$Fv+lo&0QJ>jG-8tzp1i49MnZ`1fsTJ$)F!7?GW0u
zYJOjKS;(WM$f!}7M2X1{wQkCgskU&F9?~6Q=_<FbJ;}(ES_9*d44Y`)&~@JjbshGh
z`)?J=46Pw>5hJzdfln&~X?yGH3%WM!+2h^DD;mpbhn}BYW|C0DndvLFR<0U;_LeKV
zSzYGIgwswLVY}d1Lw@tePw8gjr#o8zDYeKE54CheP??ey1=iM?$sRRBv+-r$hi>f_
zR3R-rdaPS~NL|olx=d7CQz?vVt8w9m8hf)mp~`G#YN1<E<;mQ_K|QQ;<o7<P%{!xI
zA_^phhhYR27sC$Pf4a+<S=r!j#AUrq%(H2uDhkj1d#~+g758=RxLbbgShx0)9%<#Z
zY4y<XXS*vG!A@U)sGGav+HOv*GAmCiWupdTxHXOY-+bW7?t+$t*}hHBrO!1K{wQ$1
zg!9UM-Tu$rtx9s|!rwA5qd4qUo?7AwIPE)Od6dfCCtXF`2aSv%OHpC!xxg7)3(?wf
zC*KhNDP4{;hB_fw8ucw|OAnwx9Fxvj$OBt2wsBw;fK4$haa>Tpf$k4oD5Aq8*Q(b2
zXEd1t^WMCXG>B2gznIf%Dab-CNEu<~*^^w-nF(6fgC8&IaSkTV_G%4!ETvY3C(P%S
znaEV0z)~14l&}O7R8(XV28ebTD+B|dd+CktCG8Vm(_<jKE5Odj^J-;$Bd*BO+90#@
zDzNLz8mE&Bt3Y-MPrNZ)*!Rizs0(_F9vnH>txyQH@oD<>xo&bTdRP=tdNK2QOy#il
zEzGI4TDa|+kykI^V&m*mcUBXI-txOgGvPR@F`)=CW=A}W$4_>zsZze}k3Z{KYCuL(
z!eu38Rzm`=eD^G$<X}-iK>maiX%T5M65R%fbUmj{Q73==v^%KKGfn8~ht&O3Mq_v7
zv>s^Pt34!RrMpPY>It|xRT_)BS&6w8R(EKuyyVS%O9=<vZLx63-*8d+5U-?JaFk!^
z<olu~RruLVHHP98;Fgns;O|rcupD?BK)Wegu08v-q@^|I3v{W)KXC}5ig8(30bu<<
z6wwBZh)R*#j<hZM6nDIEl0pF9{waM;E!q0UnqK*Rq}!`Wxm&*UDQ|NP$T7YO(*?YY
zBl}Rtpm7mU4*eYc$^+fWCy#Ygx|?v1-q&OA>n1%J{pgK(H=8Peja9uwtVzOs>Xwgu
zt{}rzOSnhdVP|eQ?2SqLHMvHHAL#56G2}~yM$0)yMCm#&s;9K5eeY9DENT}TfAnNj
zTJ@*ij9@l&ndzwqp6;&t$erDRyKYSG#?rZzL`)iI3>J3{V@3NwPW<SJZd1dt8LfD@
z(sCR^EY7ErnU^=UTEg&(`J!>vv`$aXszEvPgQrw$YP+#cx{}s@{$0eFTOt`89>g&a
zQR`6=<U9o4_QTudBXl1E;!#|s<rwO?U|-!1{$drtYXaV~ZE!mR={Bnw(zz=Sx+~36
z6Pbjw%e45^fQ)~LXR91{IRZ<Lbv#SFFyovGA$Ys1)}p7i#5Hq%M(f-g-D_WexSKn4
zpu6r1@89vM>!kB;=#2Yc{@aJTQ{R80o7V;%Zs(m*4}c#T!t3733B<?i^4b!6_K_F5
z<uAO^P2YR-C9~+lJzn|VHLP`AczWugr+uq1b1<GbBNt1NZtQSmEAX7|_g_=5?ATvF
z(A}YfNHd2<Uz^{RiMIj3_3$Uf|0xZ{*iD)8k4hja8!{&O%{Lr#dFtp7ZVqt9kY!3e
zE%utM`hr!R_S43v9HNq?YoV7hvv+lGs8v6B0}=++mQEbj1~DCVA5)E80lcID7&nZp
zrrBT4m{P}Y+2Tl7&fO{X4yL*1&n-qnju<-T5`;38Yq`d|8XfllWW({K-uIi>RF8wL
znyLU+Gy(R)Uwqeh;$Qt6_g?hecBS_Y8`d>;eOYJrU(wUroz{ovb<Z0QPp}^E7m1V!
zef*OJZJDQ4lQUdeQ>F3R-#x6Ih5P(c?>o%qNaR@sIs5d>-RYmbpwgk%Um2XTPtv*Y
zD^pU*vk_)mWA#-{^a9H@X4n7ThkXEPq=4QbAoA2(S~7m^KRv8*`HEz%!Yy7SFA@v#
z6+-|TABJaI1EOUeZ-?C$?&<Ba=I>|KSoTvegjQ9__tt`izAOkRdI1>p15rIJjPN(B
z3T9e!6k{sN^0wu<RDpx!R3K^nnKUqugTC9_=>D)h*0B``6Mu{uCz)`e@DE5}ka84$
z0Sv=n7Y824D(A7r3N2?i6{u-t$Z3s9H+2f``9J?o_o@!QaO2LeO0B82eEAzc?T&r<
z2kHqeIs^EfL1ntw^Uek&MXKZo3Q@#O^3f{9i61=Cz4#w~*ez+_{;z{t)Qvc=e&b=!
zVX)oR6@V%&cqR&Dawa<GRLM;%oq6(%6^WO>@}ut6Z#`O;4u3^45re!6ee6H}NZZFX
ze9??(JfF@EetM|eC^@d{+O<_(@|yX08>ovrNhWK;Upl8_>spFsdDlAww+*Zz)08p_
zf2+c)07#qCoY(Yt*TpmLenDxrZIAw9LjZVS%mC6zN3GbE<twix_zP;8nfzeW16zJ!
zpLmsMC<BEh-DML1wJ?UpH4##`aMTis0Qd5<|9wV_+q`AFrb{xO|Fds<((&3)-Rl!?
zP<yx3^6PJPul(IlyO+2?;>@xi-t?2*wEW6^(dsY;ESXPnqU|9{#D@xEkCy4U4xHVR
zH~#*|x_x^2mu}^+LM^_0qC58g{ZPw$&v!FAu+O8FaPB1FtHk0+HwS6h-NwVM=hZvg
zRC=taLVoeDzAupT-F2URe>XG6R^7`HS2lW`);awbzx@5~EiD(%NVXn+iC1Jz26RQN
zz@qUX4@E1>adVzX-(<;j%-fh5`kmD+Li7M;=XF?zi9e+?`&p12A*2L}C)wKa3~}P*
zxtlh-ON5P54_G~b$t%X10Ax7N=Duy!P8EP=GCGh)ssOw+!8S={6ly^-I$eLprA$cm
zUHoW0BKk!LN)Y@*I2K6=E8UAu44erKLJvR=Hah^_&##`qzy4;osB`N#{-cj{`)=0q
zohqSsQjt;4yl}jG>1z*mCv{5?OJcLyap$)PHRhjomy<~|ScTb=>^3USikmAl#Y`Pk
z@2x-n%}2X)dfDivFMXmrq&b1P!@D1UzFcvn@SJ_&HMQbD?%w?VFS<#+Q@{?w=)tHW
zAUzca=60y4=JdJ`m7AslJ;c$a=OlKwtd)-!{^ENbFCE?Zdmq*O5DQ99tjopfwsh9D
zV)5o9&vwVe|Dq}ZWXju+@STTtVh%>=VpZa=m4I7cb+>s`_MFab9Mt71<0xLEI;pU!
zWc=<yNoxA^QN0i(j;)HkAF_!m0;s;Ch<$)`|5*;@u12<ykD)HP0(ee=yrJJ+qXx!?
zh;Bjq+fQrRi;Tfs0L{9k43#VZNipnMIizqX6!lOLpe9i=Pa#2p;^kUu*Yhf9v&>Gb
zrCQav`<1`_sSD6`U-&?G_#VC9t1i>!t_ZjlW?8qwocQT83hyV{VDhG)A&ck4W5SQ|
zJ(EsuJBgFyl9_?RFCQiB1?lvYrWFt6KXt3ux^o)4KJoG!-Bq8ur@QgDKkRt{F7(I=
zrIg@h)0IvuTDdr>GYiN5`bSz$Jl@S{+ufY@U3l(71xS4q2gh9i%y3h|bD1kiOtnD4
zA};5Z?pjRK<)zE&5k1%~t3|!`Gxzz%qFE-e$PbrUt?QPbCEeot`VSsgPwWv5MOM`6
zYZH|Cr|Zv;f*Cyku^^sN@E+V#=;W>**OJ~+eC2Bo>FD$oBljd}{a^plFS|3(yxi@d
z-{(p1npW8Zh`<z1<^i&HVZ@odGSs*``<qdg{<!33OhpCo^2Km=Y95~!638Q~nH#R?
z&TAHxjGfnfIeI1H5tU4Q3V`D!`nVNA*by7{gat1BE2I*WjfW&IkReto4`$ZSJ@#Vv
zgbLAtdv5BkS4D8>uA90!O;l2dE?J3%wX=)L*o*379_wD!y7!qUw1Z8DbGXU3zCx^m
zjNRwVC5uw@ORy1-cpOB0%St7|7FW7^JUqH*4=Ws6Hr05V2`pNbD?g_D`tQ57+kf*l
z>QXOwH(z#RFF8I!WOpEQ7wlO$u4}K@xO71qS?Ia&n5yS6)P<&SGkJ-k@Uy33o?Vf|
zPmB`>6dJwOl3MBwu6M7iNAt#mPj***?9T4m-@LEee~T_NJ+L<}Z8g@VeVC+NQxAg;
zNU#6osqXdfKknC+b;*zSUC;}o>(3A@X8%cxAteX$7W_I7k^fY|o%#9E?&Yulq`TpZ
zAM0Fc4WYGGDo*x$yr^Yg<ivf6PMb_mdH^-xzVNp+Y&K9z4jIY}o-~$PJ^trB!gz|p
zKYj(E2%M2%Kx7hOr;4Jo!v>0JjZrok`)C6V5r|@0L1c)U7MEJ6iD9ae7)|Y9j0#Z=
zk`0+scueb%Zk*wEBI-M#sdaACJ@fMyy0?CDRM%r&ryFtZ=nmX*LpQJIyl1ujmRoUr
zwUUMjwYIK&Xp&14nT!e7b%b=2r?<5o_T<l=>rOuYLbs#|GVktF*l~roG8?U>GMfuO
z1*7~$3f3GDu_YdIqOxSHOv^OIcwdv69FcW&<j1vF>$*MXWi78AQ%~cdZuB|Ky??s@
zZ(hr7Tmm|!8Td(tTar63-i9zTB1M;6+2zK;Bnmw}7;Y$LpTg@8J*7uZU)BW}+9{|^
zNWq`gjCn0Qs%c{mL-Q_@DH~i^+V!#{6*Iz@?#oSe^-@&Ga^_Edtk!J!2=XJ{>#7Kj
z=p2VHGSw|bY)j_C4dUUu1}`#Xqp+XXZc2_HGwfPlT<#Xt;-7f<8NHcs)NesfsKD`_
z0&_23b;;g~+|0i-iTD!BnT;?bYrI?;E3TyHih3`ve(fjSsw&6pKL3GkUUy8+=n&H$
zdbKFU*S(HcPjxSU>*4OGdQFpy>)qacS`AY^bP7V))B(>BQ%|3Oi7Ke~vu}e#-7u{K
zP@F#)Ls52*QkE}<vs=Obr4Z=_jI^_ZrNDXJ9JBGPRvb!PVBB&@4se%)y^9&aCy<T$
zMCFlW>`-AKMdsqmAt5W3ooNL|Lc3y6ic;(QV2m>Ul3wwBK~Hb%4j$E{IwE}cP2Is;
zb(UN`f>}*c&1#%I;f*L1d=+}FCah>;@9e85y0dB>S2Z)grY)+R8=#QT9j41pVl&Ca
zr5@SM^x1J|I<u%qgaitw!7ty+y8I0y-jx9v%22ZrmkoZJV2cAjo37AK{rq_?8mJH|
z9tUo`y4!cX?hjDQzyTjxE8<ftG%~6RJx@t9!_5i<KW4hm>5$TzCM?&vrC4#;x3Hik
zOLglNCUJ>33i{TQii)e;*w!5fTOu8tR#~{jI<y=eee;i#mlIS#stDfr-s9?RJgyUM
zdY@4FWmZEpCOqd4?bkAwy3eYZ{ni2^Qp-n$wXSW>^t@IzoS?VDJOwuqaep6KAbKq7
z?z;kxv>*=A@<;a{o{}%bPXagz#5=<@JQ;CMsTaly)2g-&AJ>v570iKqZgi!^UKfT5
zbot-X9K(qRp6Jdz$CK_W-Tb^RC((WgD)am!fRg+XWPWj%8L<^E(x>R=%rMjgY>A%M
zP1oKAJp{Rf^(FZo-NAp?mi<W~vx#7&3V?v-Z@;!%{@F2IQmKoDlu_EkjXy$m#U{O^
z#ufo>D=^?wRmss^=9U~h=?AbcO=MjIGwGv)D%yR=ExNupPu<oDCV5`e47ZksUe}%a
zo~JNAh$VoKz1LrtII61x!Fqm-g_Wtwn39&BKNl8-<!-WIW2`wut5~fieJq42I(yW@
zflt3lq|^&gjC2VfZj<T}WL(%=v8Gw(HO+Obubl4AoYZsTj~$f^A*8H?E?iroFXiAQ
zbf`nu843>-o;d|JJEMy_Rq0XiX*n}Kjvw)XN&R!CeO*0=dCASKziFF#36l^=3F$6R
z6fFJ3%qDSB<-4h7+G(M9Z0gaIvwEHQ&7VE*ie*+6m=DZAgdd~}d6}$8U-)*RFSMzA
zv$C?Tz|kWe!~wL53UUq6Y7~$FEo%jGUcCtBW3=V8TTy;tg6|bAiJC8c2;cWqC>~Qf
zyELIZN97ZhKXT9?BncNf$wQip9qVq2ig)Vp0rdbz+L_;ydqx(@@I}>bJ%HzgNd+*n
zn$`JfmMS)Mc!cCfQV1hdiLR~bCLeO-Kq`gZ-6q`AKXs!5166(WPsU)My_eI3Q!}02
zbb*61;3n5+sm>#lpVL|`WB2JfCK7`OxC0MG%fncAMnehiZ=2DLI{0Oa65V{lA+tqA
zfSw6om@}<`4}nAw;f!5eMX=Dr+u2+dfx6Y_^^CSMz=n9AQXDk*uCoMdUS?#M8I=ce
z@+GCB6>$mDe6w}&grn@{PvjjJwPco;a>3dKokdU=dzyno>H-rl3NmoSiZctV8Vb>p
zyO5F=s3I?cSi!$TVHiVP2un=Slkq)>s*G8_-Jl{+;i1K)=f-gAf-WhUTF`Jzc$||k
zY5am@p&ykZdlE<s{+uT8MFCXWy0?L!eo;_+HU|o0Ll;RA4#OC3`sGCE1<OJ4NA4_h
zssVAV$<u<Na^?i#rt-+FT7Cux>^z**xff*S#DJ(HK;pCkrX7C+;2FyKoLqrY3M$;`
zYqZT+r&-5T#{~c4PB=SO0P0G=sLVwr056d%ccLc0*_*EDxJG*Q>Ep0&K{@6`Qo^cc
z=wv3sT$QC1wiL{;J^(A4Dy)Fe_4iLC2uXP%y6Y-H?7?R##m7B0PM*+G>asF4-FFhq
z1qD11rM$^SQJzuZr}dBJFVQ1|k+JkwGn#FL8R18~hvMNxg-H>2ylrq;3f%57P7DhL
zQ&~`a>l!XHv;H<=PKBRIuDON1b*YIKl?2KVtvifxfiEIPi2TgGD=i9m6!e(|UGB;9
zt#<rPY7ie`I!3NwxJsLG_{?4nFGRx%ejG1sy*Vpxcy?@5V5kJ>pK*5q1)oZd-T>*r
z`v@%8EiW&*GGGY}8l+`UH~ELRsFd70A|A*GH~$Egzu>(}#f*eJ%)4VDdobvVBAfz`
z-Vi0)VaV)@S5+ZftU^laYwN435T||d3cDixb{`c5y<ZE8j{_-sgkHafNw0=K8%ubi
zHLbfK#_R!bP0>@5AuD+oRXbJy1&eM3M6S6gmBxd^3LK$b{`oN<3}SYhL<})R1S8HA
z6Zs$|q-skTjZy5FGc!a1DLD4f2XxF*kfIBXflNW|?~EWjg%&v0uE}&$ywb}B6WW0{
zt5%N|G8N&hXyR&K<KcxlbxYL}K$+Ho3=!E&w1wlD@xnl8`o@2ftC8X`2)tD|sFvsl
z+q5Xq1vSj2FJ0YNb>YOkjup>~FS`5idO;g-kS6g$`OC-h2s<SG6Am)BeB?%)EF+!O
znB*9~3i=*h+2#p7(-K|n4d6MjX}PyI+GM)G9Di0NT<oT;*3rd9fwSaU-#3seN1^3n
zzNdAdiQ$=F%h6U`_LG>txen44a8&Z2JrtZBAL3U3EWwDhaDrBm4KyGmUd^@mcRs{T
zE>Xc_7BzYrR8;0wv9i47BLdzAE%ya&`kB?FC=-w?%bKfD!!o}&HtPT%3MoK61O%Tp
z2LlC0u4W9tz@yTg($VzU+q5Z6s|#bO=LO4No*mUF6~IqK;i!HiRRDxGd+Sv?w6LIw
zl4ZA;#5@IopsN`nSoq;j+${il3RtAVzr|_X4G?zZ3U10f5;PK4#a7u2flA~`P{vdj
zG;W+wE4sY6<QA2TotYpKR;{cib+YU4jHLj~qrSkJMfkV9gdOQtn1Uyu$T-qu&iE3+
zkVE(<Eh8E>2n9ajDZ^=ZC0BCoRV&PlIT?u1O-JAqrlgxxL+^QnS18kaarfB#(bB0J
znA_7WpF7vBDFZKPLJ&ozvZA37Ln4;9P(jntDRHo~d91z)#Bl|he*#tS3H~!J&NCsQ
zv>_Il)xdU3nvmoM<v9(xDy<^JxEoTgvh#DrRpLXXN!<J`=8&(Ph84kzA#0!*51UMc
zC1Y0XEOA=KFejCjEW?2fO$f8;i^`ZrVUmki<<7PD9D|>dpNWB3=n^g|;QW9)%KV1B
zaF3AC^`{DecMoQ79=rQb;eXupcleA_0sLI}NA>&o4s-^*=5(71`<2&qTTMhXG9W;i
zD9FQ6CBhlw5KVOl0+l$n2r=z}R*@?m%UaG+c#K7FPAW3Ll2@&#GMu{h8c;hSd5CwC
z%0az?RZVuyYfLw<Ev~dIBp#WK1c^)*I`nbl-#>>j^ikxJL-;n1BaC@4ZV8tZ5K)Ao
zjK>&UcLs2~FPBSHcToq9_&8n#*={9lU_%Ap$N{&YA3oSwhUCIl<~}ymqOq5QaH$aU
z4LhKdPe(&`^FmnmNMAw;ShH3TBi!JJ6`X(uSG_W&#~xKQyqo7qQ1t?W%RY=qhp<Bu
zdRD@>Sp*3$DOV;8lpGDmA=1Lk2*kK*grZVWo**3ks9@C_w<3>F=xP0#`vC%0X0;qk
z;inRv+Na`$BLt8SnC1;bqi_?PK|_f0L?#CJ{fDdojG+jMp8L_=aCWT#BvkeTP@8b6
z;7FU0xgBWsmLuKDFJ98b4)4epslg3KA_j{?DhqaXF0j=u!?rL0Bt79UF;jAZgEM~e
zpnzE-1BOB~H@DC&o;&L+wRj|g8Fsqr+zF387&ZmdA};Wr8Popo*{GK7WUKcExj`5*
zw(!{zqQ^qFlDISR$2<fISgN4l3A!O4DlPX0!pY%zXQd_*smiJ<VWUBdNjfS3U*e+h
zX4E5~(qaCCb$<^>1eYv>gL2kx<0QAFiGP}_E(3gPkWf5jwwtU<kMo<0e!hzXMs2sB
z@FJK(sb?TUDfV<GY)1@TC<A$C00=*Tq@?$0E4u=uBCsn=3cweAXmwytGNJ2FJ~D`K
zSye(-E9%LRW}K6-GJw&;KJ+EenSAT64jo66d6Z?$<v&jTJ)wM|ncbb$t`$H*&tbql
zJCo~u=kK_#JNMwTTEEq6INIETgi=UAA#W$93^wCfgcJoVfT~|u6QsvUeBn9~L6C2>
z0x}M`6J``(ph#%$C?vtSv~*L6htBP-ba}bX36+@xe!*!ol7oX*2}jz1N`Il5Cp?|m
zi%0q=9(K&tT^8moJOl3*S<8T$2yEeut53xN-$IO@i>&gCOsXMy@FCy<c)>siI0`zK
zh|=9<@{dYkT|K2e>J31a0wM7Xs7y;7TQ6v$a5Mb~q{=Jh5;*at!eLqR{0wgzlwpSh
zDEx_uLS`VaOalj);iaW8m3XPAH}+KKH63ILRE4PkoG*CRTaL)ZN(pKlEHW^uJUPXZ
zspd_Tw|x9t?hVNSa}Wt!=%7dkdSCOJ`JcPzx^Nu*`<y^`9sfga)C%As!M>p1$Q1xr
zZOvS#VSq01jOa+~lMRcUd%;Bpjl$(ZRz-^Bio5keK^8)$ML4Jdd^@FB1yQP5LdKOu
zp_XRWpIVz7j{C~`QWR8~tpM!F1mbW>E-6eQ$;8Hx;q-=v)-YYX3bMUKjBzEIj~V8r
z#SIgbH3(PYvR9RksmmkbTfM+1RO%5=?WELo;;i@ckY+sRRs*o1!b1~<!!|16EH3${
z-Atvh25_UWG4x<=1_fBCG(@1tp^`ArU<A{jP?2HsSo52S21k+d8BF9&Y!MRSs8JA4
zJQ~WA_VtpR%3RQKk4evd^QzFQhEsEzBglMUJ_^MQFX;E-*&R~qAWf?b&0McDHsh&Z
z2z=M^KO{%003^6$iabPrOTSX>fqrpCmt{_Oq%Hqamn3TU7rVz=MIj9pLc@%Jv+&v<
z5ak-TW(LSlV1tQ3`y{eM^GOjmP9+BfR#XF#U~@XheNL6ZyqDK9Q7UG#3;sY(jxee>
z2+2~yWti!nFw$#5#;vGC1Dwq_t1CKQtix5lSTZxQWdlU0ZAjZ=P|m>`9u7B93wON~
zHRA9*02KfkeMa*kZv6_R<LdAWfsDMEfOo*s2}72T8du!lp`csCA(cJEd0{f+fTUZq
z!ApQGI_{9D1<8Q$F$mS?j>rc+?Sfz}ITbYX6Iu;{uNf6^@CRu|A?C~c2|pj2QYFSx
zVW<oX9>W}5^}JzX@^9h_O+xFg#8F?LDgm(V_fhe<<MLmD9jyW=!2clqAL}=IFF==W
zPU+!<H63ax$>D^7UK{C5h)e+dtptSMuzSLrh%-xdsjw;B%nC`ecTbLj7YY}N#EZAH
z6Y92U7=Vh5)aywn^zdzI_B^$aNhPr|6AbG3wzTN_!w=m^dMQ3yEto#GgY*Ks_a6*3
zV7Gip2ml+!7?<uV``#G_%_!_>?IP7&Fq^c=G#cisAvs{oIHr!Ld2M)U{gQqXX~PMQ
zTDhf5LXV;c&c*0L0SLB1(^H(&-VkIkSolNkAxd$tSxknOz%zWC*sB!~aGb(WjI_tp
zD#BrSLB&6-qrdaIl739}tl)n+Do!&av?~h3fTO!YH30M6lB)Gf9h37qYVYOb?ybc{
z0%Rg=XSTp2tpa11jQkQW=|s}?LG|vv8zv?Oc`-JYakS~BdPkCyVDYOSA{|gY><~!x
zD2A$qA$dt1%B`8!#_QrP{1MsSKly5K#82-JFFni_-U$pf03%vuzCi=mx|Y4Fo<J^t
zAsEsj!?BJV9;l*)WxH>m@dGD$l#a2INkVdzF$-G_r=|y<6|Dr=he1WMtxEFSc{YB8
z#~=3}P#I3DHTPM6<0WlE2{Q%UJc<Ux7miGW%Wx*h+Baaf2^(KFtZk|mn9?oI+_gET
zdPMNrvpkv_xdKp)cT6N%5~MjFNpV~7!hJV(Q@SXGjOC0YDWsl6vS${05v1V+fnEUJ
z+e@U>OBxtP=A?x;ZuKXFVG15_X}4Jxx@;sGn_j57QJI)g05b6kZYeytLTkIQ3z6`L
zKRfhs#5#<J8xKlQ@W^c08^N7Y;;{5hyr3yMjVy3u^NL~hsRanL{95<4Lw&tuR#riH
z7mu#4CrH&3u^Ol_f|ru_O|zOIDrMQCr&$j6(kJ}F&T6~uO&pAmJ8pI_;o)KU2qeFu
zr=LM;#f4w*FLMdU(DG>g2+O<_cVy?vSlgI61Qn}D-~{h{oj)KVSmQ!iik>B_GOId_
z<u@SYX0W0IgG0E5f!5!zAARVyZeqO6KYF~Odt}t^KS7UN0RSxZclvQpz{rYu046eG
z*P75IT)I!>BLtNSW8|$6YRzXPRLG_3Dd5Dn4ouQZ9pW-)?Of^LE@jfdVvu6z8r|JY
zaK?OA=2w}|v;y3#3?)FL<0m*U5)NF<&TRHDH9Hnm`x~x!L4b_1rW0_`qX6bCG9-kY
zkd^<!enz9}0KzA-1P08?D<)fjl9DIAAJ(tgXYbpb2wyYZ6Iu>sf|MbNK?NK9L$Oy5
zqxzNb>?oK53NI+EHp_rhakfVR1<b1Yfo0Ed0e?V_Eh2tkCrt565L1vP@sqUu`3L|Q
zeqQ!tMqiBsm7-PSpZN<k(i*<N!%pSR5RReTnpReD#Lu1p6k{?%-UD_<o9V`R_b@1R
zk4dMeKC&9O0-$@r>7vL9BLu@PrUg9##ryK=2Ixl(8MP!*7)XF35QLNN=|o0GWd=g%
zH3J|~gl@?SSGw_q6EI0da5CaoaUqI#!SRHkGCf^3x^8$;CBZWa%|DrwcJT@r`6nMn
zFj8@YKky5mz*X2n7jSnsm06<jX-TpM5Me{3kOCZQ&sWmH5hXzLTM+DQw*(N3jcmZt
z2}8x3O+U19@a9U9Zmit#FTf@4)f!>QifZGPtf#x}CFt}se+@esKNFKXUWO^OGyf#M
z;f6j$*L>iP1!Y3TSm=gLU%?nG-GP;ZPhTqDgyqRlIb*IQfgfTdtqC)wUK~q<Yiik{
z7ybm0O8HB`xU&&$R`*pL)Wamx>N$_0w2`}eP``Js0#J+ex&ruterz-tSuMQpMjvEw
zmsGLjPf=9@A)-M+m}p84zx0+H;1(Xb|H92MfQDoPr_iWw2~_lOhq!(PHp13ifVz1&
zdhDyNxKVHc&am)aosAZ@pyz}vt_fw<@NN`54DcbpSo7DjSPH;9{uH3Y9pXR86#i{#
ziOXE#6e5wmFko5<YCT{#)%vq!#gN0ToKf)8UWwvH?|?Z8)G*)40`zOV2($2k9C{o>
zL!}td1J?W{4g1O+Z|GpeY!zvcX8R|efPhOrDhnmNAi+0j7`XUCQT9TMeGv2jn1p4B
z7^<g$-8>sx^bAnKFJ^X_&Z<#?AM%uZ!O}0`2u%O*t(I=#uIsz~AH2=jV|-o|?2nai
zcHR8b(j2!30PYX<d#)w2o0)ygoDbklJH|>xfAEJJE(pPz?KUE(kdFnF2@{zq;R`PK
z`3IqbXIbl0NIS*SjGh@Ku_=5r^Lpt>tscJtn#n)(lUXQd&UHBW5f46uJM`D^282P)
zE0ax;;TVee%suWUOemJzR&e?_1szi|Sjs1Pz%j#u8*Ka$S5N$@$AQiax5H4l@D3<r
z*cnfdvQ1h$5^;=NkEw_u=%q*^1pI)77Ap7+e3PzzK}SBswZ<1$;KHq#!d~1BfSGUt
z+`NI4D$Lj;Ed*>|TtKUQ*%EL7P}xynogdUILIt?!K*My<A(3$dDk7ZmK<9>F=9idD
zpf_a&j=Q!&1Nl$t)gKy6_Rx%}*sS-!m^fq40YIM_#vkjqie(hVWFU`m@~pPU)s|RE
zG!dXXAF59v?BQ;aTi6zC!A*=l)e8ymiYJ0cSx>iOhqlwL2|eu)VBE&i7YW9WEUP3O
zwmuUTn$A{btb)0OUQn|ok9ffo<j7p1%9(pj7SZ+3F*trfM+U)0ToMObgL2GJ!3z~K
zO&Si@9zlZ&nX~@1?yUK<9T=4|3wqp=qp_^~S=VN(@Bkk<J_8SKMY=|-&?5YnH{;7q
zg!=dy2FJiB`M|6BLqz+S8%m$RcSQztk&)$MUk712KpMYg&iL7K6IjYin|@RollC4G
z8AlXgNUG;6;O&6B0pOzm7Fg(pe6_Jk^E+(sHkC?Gw8b26Bre=@gZ#!)to{E`G8n62
zCWNtj01AYG;5YPp76PLxp4Ohb^E&qe+C;ZpC9FuW6j~G(63m&PNZs}f5Jb6y5x>N>
zv!VLJg|+t&TiAnw)7>}@Lv+EVHKcH`CT>QcVTKJ_KRCg^RTE6aDcwc6_z?#5v6EqJ
zR_)JvG2?$KpWq#YK(ZZJLb9`wi*I48FcBDpD^q2x@KGpcymOne_pqztiEs;=!;9eP
zjpY0GE2SHoh1l^B-Nd!MXJR`R8n>Ro#5bpf_3$O$Fpgum@Fn~Vrpgf*{PYXRUQhRm
zRN&G*-~*pZj%7cFLtgfiXV8pvBpo93fQLrQf4bVOWDtfB)0)+%m&bfcVKsDFCe-WX
zMlIfX98)nb$Nb#bYU~Q2gzzKj><pwD8%a&*o`C)C1sp2NAt54!U_oSRi5h}U;arS(
zCO&Ax?E*L!d_$x$ZcB1If6fFj4qtJ>jD7Gm(-$hiHklz*>e$i@Oqv6VIQK4?8H2B@
zb!GDik8q$2p^r0LfwyergI`YpdV@3*zYV7mamlRg^^Z+IKJCY8ND(5xCjA<QDrr_D
zW_4nZg2A|$5?0D1!41U84*F~tcf%Hdh)GzI*WvJ!2lG_;1A{cqw0Af~M(Nk$C7(e%
zeInfSv#UPv!BB_Fk)cl%?1Do;mVZwpc}V_=^?)0E6>usPDpM-^x~c*_g*By1KWHe&
zT>7JX`hEQvnvbn6sREEd*k;I*AQy&?ta#5pdjSZmicmsr(k^n%h*Y7`P^!2C^tYo`
z1Fvbb6-r}YHV4t0V<^xkut1#=0(ZcDE0sQ;+xX!GzQ>vrFm5VVxT)IsH7uw1&U)d|
zK+5GUK4FppY0Yz~DkC+J79|ASC<wHMtdy*1pF3AoZ3o*j)rQ%+?_{nt8~!UD;voxm
z;*e=y{UPl9G~iPCth5^jS~sw~;-U0r%%1!G6DD=SNcMt@K0Mn6h=0Ola5O3`?IL@I
zQ|6!HfGT|^|EK`QRCN2lue2F!@-M^ab6UELu76da%ms|x3*fe({U5*G6C9CwO7iux
zi%cqeI-%#UWi9=2OLGVld$^=~;-wwEF1r}NhqqrMDD|9RsstDYFd>LCOrZ33+~qca
zUtj@hz^f%;*L1p!E@8C7T#zxOnkFhMn-*r!9JX|`u1^$}mcKad=rL|><x04~V@y4a
z_RPH!ejG$Sfnfz+{)YWpd%~cjNV7CkYV2Pe(#J5h1O`sv$}HH#H%MAc8>rqtEe%M7
z2Mh&MX+dRIPy02viR197jE4L!W^d!?`6cxPRy7wuPl^J>jX(Q7Jod&PVR}{WI~XoS
zU2+8=0kJdioBEA(=pdQPUO=a@P)>w|a6+`ynAlSX4|CYDr4oFgxP=a!Y~_INaZ>oh
zG-IMBh)_TR3%r8ioW!wDE(B#a*NW!^63&4LJ?t2u74-1yO@=g8yBjVbctmnlck$7^
zX1Jl8SK``Z$Hb}Vfv3R2r}$ed<_M<$7QZ~No_rHOcKp!|ol%d2aFYTtj|insctti4
z5PytgDI6S9V#lI!<OL0b6b?d)=^Ku~B)#AVmtGk<faDl{NF;EwW1T*|F18FGq3J7o
znA5#PE1^nS0n>93dm%P8ESgiL=(qg>-B=iVC9L6^MwH+*;?+Y2TpvDZO`cM1;|*35
zx<7-$zi`jktv}21O#Y2k1{==CIt<j}rI`xg5A_@Q#DaSPpS-<W);;}eFK9bKN~=k*
zKAC%Ol8H+#D!c-XB@`K;L3;2>dKj>VRzM6SN9o1C!W%9UFMK1@0q5301%+2%=>?F0
ziH;t81=pFKl3#d)UZ_G7Ho(&#-AyJM7j%albb%&c5oX0Kaezk30Gjrf9||+{_`?t9
z>@8rawB*jrKb091j&ln-3av^Ak${IXZWu#;>CyNxPqDJ1iA(JeWSEr7xcZo05=uRR
ziar24<d@cA)Gau}03hOqYWNO^@=ctgXC9$9gj|pnJwMWA3k~698jw(=qhV4fh}K+!
zw1#^snHhSq&wxGu``&-^xOe_R>AU(dA%Dp#cQ#xS0cFz1l*!l_^fCQL-nKOFvCa+M
znqIu&g&Lo7%fymkoN<e=qGc`_+XYu471-fI;z$%fXLx8db{CF9qxUaBMN2m94?*DN
z#}e3-#)V`MCUV%^VGns{MU;09fCi4;lb{`o#bIdzP8p0Xwv4O!*_RKvm2q*6-L*m=
zR*-`bN=OY1R=*FB-r*Ub`jXMvl|}|$QGAd~uL!xf6SnCUfb@YM%_4XXfr1igVK(C9
z$TUdsBx~XqpHhIL^1^Lfm;zjJ(~!XEt!n&3j_E-70uF%|U5I$gnRw78r|>UxH$-ty
z-N6mH)nHq991BmzsX#Iau6XGdDutyRf9CJMvEw@ZF%_-<-%0Mzjfpn^e#t|Ch6*(h
z%Mc?gRs;_I=H1<#ZVzU=y)zSnL5NbdR+Rx^k%(?d!%_w4#4T=t=x=X?w((OB2g*|Q
zz~FEdR!N-HAq1#F<VR~6g-0{EE&%2%S_HsUS(r4HMj>K*(kb)-0@5?V+WI-eU3eN|
z0Gld#j1c4lk1a9FM!uy&!;c_)U48{V3TvW=J6%w3HCC^KZNDxQ6b$h}Vdm&6x&y{6
zm~^v0-B{gENagJ<!bS}^{PPFjvYEc=L9_T<$CpXZ0i3|cjbDbFcGCmT+m!=$fVM+S
zcir6A&~{^Ee&W7C^C>&&$^kHjL+pHXSkM7C^&vC!A(bcjVNTd#cl!Yo5c<*snCK4P
ze`|O6Gxx;uxZK82Z@cv;thdzzD9p0_@NNCLCtyLpk<`5Q1nmFVd)*7z)H6$xM%|Qv
za6&b05t+GBnb|E#xq~y{Mu8~qpp~+K(JK9{>q9{^4f)c=!=5l11~bAGniY-NF?-A|
z_-N@#`hrvFf#<panuH3$qBgY4%$si*YwDeX<h_O|ID-q3f}Ff1epHRUJN{W0WSGF#
zAS(ggku2U9bYW#U^?WDoo%AFVdK_9>)ayy?lV_iRE1jJP6u+c10;tPUrMm?Y2ULw|
zSmm7Z81e~!eUlUuf85@~iNuBddbCvXNp%tGMn-Zd_s*nKzAK-2$ZiNR(DM*^gh}v8
zJ>ho6C-3U!ZXEl@-^<ea!{XcS0jP##W6+=L_frUtqxOI5j&7C<4~pa{1PH4BhU_iv
zOk4^pLUth$BIfi1K55||sevIBe#W(@V2un8K1CHH^fCI`bJhIbAt*=V$UR$suoC-X
zd~hIyp~N2DlH>_SaRF>$BQlXJW~aEDW&ubz!pgw#xBTR3SbLU_+*)2*uVLr`+C6%h
z@T>shS?QKLCS8D(seAvze?uctQ^zaKsTXj2kS*+9B80iZRfA(*(JH_eA@m@aD!L3l
ze5J8Cl^7K};SQ>BsLnEkS%D}IRCigcnJ_NK130Sm_kQr^Zr?|48w_eR+xG<apGE`S
z8R~6U0FYNkU>`CJUGx=F;D!|^1rMkan9`eP%yef>N~T1RtpKZF(~x?}?pTp`{v1}q
zh!B50y*{O!M*c*2J&Y*~(vuV2HfD%vz55-44X-8ueL@U=f>P4crXNlGt!qA^9`!A7
z#z+Q)ocQRd@QS#Eo6N*9aR5r--eB*9ZvZMpa0+tzCXvJ{_H=gKgr$tkRd2{6*R`SH
z0wlhI)1V4!QtMrcn_+S7l_%PSkTi&<@q<VbGXj3qA^mIk=^#A-4T~$kJOa&df;|`x
z&nV<U8|)U)kuNi>c4#G1h6X<sCW)w0!DKfz0Gy9u7|bhLV=7wzZ>Y>YKPKL`;FqNW
zD3t%bban`;85mvd|LA+Vy*m21M=$lz74yXqLbssG*Mf86;Tj6ThCn4$nZu{|w@ZO3
zr9?1|e>J9|Bn~hc76pr+14}rKo3vYxieOc*z%YY85Pt1OKm?o~4~{7)%WD03*dy=S
z!#xUd=Fk?WH&@e^CMxkDlu#KyF1V$83v)5|76x;#OeMQLILpB|-$*7*XmWriU=qi+
zv`Eilg;Vhx0Ko#s`fDn-j6>>y+rvUFl-wM3{8BE(9GND-?4==$Hsiz|47~wS&Ou~_
zn$&|#@a^#B5ftknAcD%^2%(xQ6&DQh_#WMtx$wbTJC?*RL0z`ipRg}m1)v&<%Lu-#
z->VQFRq=+vq0il;jS$R&rqmENg3Bz@xYtBX2!mC~z)8Q*`Nm(sW|D+2v?Do5_y`p^
zxo4j`3!MGg5}W4)cm;+#1M&|_@dt$nC*0D<XTo*i1261C2WUeotjO?@(Gt7oCn*$g
z<E308wAzD$b^E6dT)+<U1YR3b@RKm%hb`SjwaOpgpwA?pTTcbS(^vtMcs*Q5Ccn7%
zbc2iJCFn*_@Ex&9zR(9%#xHy#{D?1bftNHw$B|VSDgdteVklO8qP{n85z1hcgKp4F
z&g5nXKKP3g#-e(o+||?N%KU?$zVlL+{n&Z?^~=@z!`@}907_ih9ms_QeVmKOP8t(}
z2Y>S(y@95cMAeWzdSAnmsPSj<HUVTNiV*F+2RxTw`#6peN))AORFVdwqO#JE6;YI}
zj8I5Qk-d_cz4w+#R?03TWRJ|Zy?NVY+`n_~w>Rqfe4p><`+T40_xk@|uitsSF6Z3m
zT<02R-RHip3zlV3lE-R8sI?s~VuwPC`QPn296w|vQIUEo?&tmDsh4JZXDrF$Fp(vg
z7en?ThZSbB{3VXr9^}0m#Jd=m;_T^tvunrchtp#{gF(lH_HDazN6dis$>@WCG=ju1
zo;}$+f263`yP2-ea-0f&(hvUd@Xu5m0)kU}M6O=G{Y_fFddIMh8c*2i&^`Q7StL<k
z1=>X}+3BmzcBxYMlU@r`Fd_9lU{*Ps$`H!5y~oG>)ZVxdO@^NQ=YDKm<aOVV^tKJW
zD`cTf@8(K!;-`8w{6lXp=H#L8dl_zanqSLHcCq?+a!@0Q;5OHXOYY(MHA+|LiFmLF
zjEzhMjC3;{W)0+sSm(swFcIH7QgC?ZVQo<&!u`edCk#VRTl3RD-^RK7{r+A(_7Or_
z6$vt(#UFvfUT-5BSkpW-Yr^{~xvh^xF50X3<VGF-+<dokr?TeJ0-leAby|tN#O>~O
ztQA)K#&a$dmg*Bq>b_;>SxJ7K5>98%7|n1|?f4j9Y(e5RaWc*QL{15I28@`P!`o5{
zg$bC)t_~@Q`C*zr_=<JkX1AH~^Rt|MoHIJ#RBh*dXu-IkSVo}2FhQX0#dl}r!%qn5
zxe18a+IF#o{PIw@+<No#Y8I7^<HVNGT(KPwPLB61b5qRseK=z*IM{UQIl=xqC$)Uw
zz@3<_8`~AhN=3qNp`RJ!aMdT|#WkWU&98qQ7VWr2bKumJ)f1wSv|5WSIy1jLtM|4D
zZTsxK{b)dWuu)d2wXJ|b_5DRxM_yUt81C*${^cu#w~mWO&T4gY==u1IhY{u!kcoF`
z#2nng@KuQKA=$o5XBWaplij#7AMJF*YP}~pN8ki}D9#m5APkR+>xb224w}od{L-gh
zo|?*!Q<pX-`=0DNa3J6`C7p*o8&kAJ*wy_}2V2e-P&W6Ln=`W?b@5StS7<O3Am`TY
zYIAv+{}EP-vUN`UCnm&vMyc*#*L_d&dpdUNdBw{!Ml82?I>+xJsXDsE9K6uV`tHMp
zpN@OYzd!oIyfC4@oMk>reem9y^A{NjlR|k~lk%SU@Ued9VUngW@@AuTisE7#Weg*}
zBFTlhxwT6QqaZNlsC_n{xQvupj_5jD8ihEy{3(v7yc0bibhArs^indXi3X%7C>vHg
z?iKg@+pSiZk!oY#Fa>qLeNv7+@n!pCD-q=D5u*j+E?*MckgLr_M<zYku%sOJkJY?C
zxQ|RawC!@=<Goe<r&{T_$PX!XUhDhhhfmikT!?*I9=LcUe82bZ@0N+DY<GVOyRIR&
zP_fLls#WV2S-E`h`W1#Ag0XJjSJ4)_49~gvdE<pIB}V3&rjv9u_0q{dczAGrMa(-%
z?BZmm43BRP(Q&I=GAmnGIwCvoem=Nkxj4A}`*gB#Y~FPFI8m!@xsy<lV+{p;UWUt#
z&j+1S4-xNsaiB_6v#l(Px8n8qdFlSP>rMhjls@Ab-fjkd;J5uAJQ7IXbHI-5@JTk#
z2kNQk9_Rj~+f6)pOrg+lA>rnm1I&ko&M8PpMunAew@eE;5S-c5zQ@1P;nZ`zA}+yH
zMykS-ytM4vj5DvA-xF|de;B|f9{Ai=^X1@S?{6Qq_yoF77LTgzBrSTQ%E?1$XB|u?
z_{(y1Da4tnZ-C+}wm&XP%g?iu`hK-$nZEMpi$^R8`-w0SowgE|WJewqneSwlH{Y>z
zaIu78-1Svg?$v|BT0h-BAdx+cE)+|yw+RyB8@<9;z5T+rVwqPmCZ_d@m?hsF`n9}N
zzlEpnG+zuWN&l7`YAc+Vipz6J{I@ek(p;<)-0^`ukCuaCI|1p@B0-V-W|vEM7rLWm
zX`W=cGaJd#=C{6gqt!G%^6Y(xtXq>^H|;+D`zreF?7Esklw68)JH0S+tEA*Ss%J>_
z1<RDV%&o4Gerx7ZJ5?QBSm!PIO(L6c;KhThJ8uxH>z+PZdVqPqZ1WiH%o&IJqShfA
z%hi6H#2J&R>xbkx3WR7h!vnkg42pu<$S+bn$u9D#m?I13Vd9>4Vk0?wEY=AA%LOh!
z#?vQu(7O;R%RaoD?!(v_dxbpNUa3bYgeKUoOb=n17<|8+wDeg-<$T~(;adNN2elLW
zw0R$VnuH_R!VVI-Q3!Ab?UfxGTTL>ra&x{-Ffj2Y<I?gsss%nmff&o9vq$Q#6>s~@
zd@86ED{*}4`P79j%hPinJQ;gf&epM!>y8){8;E`v=1A9|6A#e7^~!9o?+wE;n?=fO
z#hHSIPC6&DA8G}H8ixn3D=PACx&A}eZa^pL)gGc|jkKiNQ}(?@xutBXp0Yf*!3X}6
zWI@c)oZ_0azV}Gn-ZLd`g?njqD^nSbZh5o#$5+aGcVX;9r3zV}^zqwz%ow=NxNqkY
z6?$&Yl%yEdM<`KOLj84nh>?@Bnx#bE*>dHT@B*sC@t1htWvkyYUOu!Myu{w;Au060
zcr4G0H?(N#W}NXmqT>~-E=E42=|3%a)8}&ob7XXe-8-DLd>Ic*s$KaWFZ(bC<6vWO
zg0g^U%d3R5dook@2y3%dTxa!XeNt0*N;4w*!Du4alsxH`53KeFj0c&jPs}A$mxP~b
z={&ns@w10k8O#1evi`&YOV)=&JBdwA`!d5@viBJid?Gw$6+vh{&aj(Fb@jGO<>lLN
z4u<x(d{CCn-$N37e%VMkQ{@Q(=~Bvx%h$v5X&JfH<81>codg&$%#ZfV=nckiKVsVB
zrQCR6zqi0(dGM_H^KAO%QNHY<fo#IGou`df5b3;f{>dhL#8s9c;nR;3DFO{{BX7VT
zH!o0Wt8gqRLIzjH`9HksPAassCEu;%!~Ip`_|3+x722%ij_E7@PU5{sZI%4h2zKOE
zFis_#8^$(Fo1`9;d-g5E?U&Ad>iK;+JVCK5`BvAzd7rcSdh&MJ7s`X<R)M70-d%{H
zGuhSoEcq=Z$L(S&in@A;O_D}OrT8y5n)my=Eu<E{qpq;$ZxDFZzD@PMk;wFsQOoTQ
zKel0+<qCZ?4GDH%DmD^BbXa&#*?SjgmNgKll|0nF(y8~{*5pbamdfhuHbpa<-0-^Y
z0P3_i0#Aag)hEFHZ-hdSMu40%Aw&tWNM3&WlVw%@SaJWmYxLjVk)@n@Es7aDjy=6y
z%*MfDX;p7xg<Cg|mA!XHoABV!VSj~N)up~en)BU`_DdY*s`d;7`C%tckx5ren9zF6
zWNIy9ic>M~<oVv4+*dfY`|{^ex#pb=movXHaQG6DDxPU+out;e&ys`Pp8JS2CO=x7
zvov3Vg84Qf<uAH@7^Okg3T%Z%kDfry4U5s^t{ti3-_;KIkYvVL3pStDoASUKw0>u5
zPwHXSka#Up!ec0T$z)}Bi7lZ(7sV$EUFBZ?@%#w+OPX}%`v&Jsb5vNAevSzAlZ3`3
zNj_f*m2@x`wJ14hS;%9$WmQPPg!n=H1-|2ky;S_Q9~7i?MQ_|)SeCczjkIH8q9LkI
z%d9T)CpVRj+B-JcoK_`1XX_q!ujuHN)lnNI3*H0~yQ;CvxxXAsj*3~@)^yuAoanIA
ze<Iawtx_eYPf9<(ypN60$#mw73DN1~Jxn)bZJVTr+sO;2Zp22g<lXh$bN2pm#*#vY
zRdI7eJ3oi(@+Md8w$o}JE<gQKvfa|KGL3-ti?eC<;H2eNV}d*^q28~1>~oE~jc<!_
zw|hv)l@gwJ*DSqw;@V{5*UqKfz_TL=lgm;`ZpVRPu$)EnjMGLW1>=mPiKGZIUf|Cd
zyH##)JxgNPetE1xj8*Q{q|Ic?jTp^i+Wt2T@0YpdRgh|b7xyBkC*PNQZgM|wV|9_Q
z{+XT_YyX)_(k`|91~p;Q;O>a+pE%j`HE84B_<GqGHB-2dm0?bZUzW3VIrN^{MmCdC
zh|K@Vktnj$m5p6)D&zu%C&ZgiU)j5z{Sl#WwWZwCS{s#VyGFV;k<&f3+aeSyX4Pah
z&nF%~&aARPs_`nmc3T-yT`SizwSF}L_leiw|Fc>p)cs5|?Vy&wpApj$^eSDdkWN<e
z(oqVgsS@X#i-%UL_%USyg@<IA82c-8-*Ha6K40-n20AlxTpQe{jrf}9edT}Ok}O6;
zW!7cZUcZy?+<V2HV|+qxz1H+)^@-wVcO}k?`N`^6@|kyI5>?_K*5(~Gl~3AImM$&+
zYOF^4@{GhpX&E(9TgE92Wz!a^R8`4LGB^EzUO8TcEHb7%W{22ka(rZ(e&qBsrcE97
zSh<5XpY6FnaWM@#-9F3o{m^T(u3KbN`a?U9&5gC0gwh|bJKuF$?{%7}AZ_crV~K6M
z;s-CEJG9Lz#^Xk4Jr`M>Ojl^5W@u4f;>$#;4iDv?VJeEQ(8PDV0&LyUg?YNW1=X;v
zwaD!}IVUsqN>A&&XDY@w#7=mcX#3ghE+Qv9(^eaNRMIrS>T)!nTC2DfgMioMY`9zq
zM^>x=L4y)$W3K;7XcKejWQJmh>o$2zM84Hr#;ei?ak=pZ5~X%KZZqz=81S;F%!2gk
z-65?TOY`P_29n<W&RW%HV+4gd*+_PEETo2=ykg2`$+UCIaircu^y}^~A<BM*r!P>n
z8zp*T4o-BtTa^c-Rm8W8l~WEfz9rN(Vg7mkkp1GBv0aTb=Nx!%^UeG;{dws6@tzaP
zEx#;gdlFWRC6so>`hE}QBx(nLmiCms*D7YPzWJz8uM>l`Bu1Gpf@efR=%`T4XPV>~
zjE_;qm1Fm<)5CkX1rtB8v~keSMU_o4#CGxQFMmTYzsx@Ji{m}!d<g%KyOeJ$9#-oY
z-OL^$B@8@Z%b6YLE#h%a@~M$yxbng&Bl+yE11i|VL4~^ABHT)56+%pw_NI3h9&|;j
z*cVA$Dz$ZzTDaH6Zb_tbg(fGA#yw_>;sN^Sw0b+XnjCf?Z>+n2!%UswInhg}17Z2Y
zaziYXGuHX%JHemorP6(Ea`(~-n_8$q{mqei_Sq#a@3*6E-K(yN#_2?i=ie~WSY4f)
zm_1<1pYNSNVUZOX(|7uu0EZBpj)f?vKE>MuNmL?(Y+)7gv8LT0{8?6PsS_~AoKHS)
z3#+R(B$e*;bY#0(bf#Y;^uoT73zp}AnRy@0&2E`N?oT@e6l|2X4sGWlrf}|>5qWW!
zQ|TZDQyYiuo#jy<gQ>HWW@IN%-4T<1PFmGPYd!PYfQw%5*zI&e0lLG4Tui0cjw|o!
z{go0SpUrdO-Hca9%6WD2kXnIR(sRyJd$BSE&5M4SOvFnCS5I6bzIl<WtBg%DV=?vV
zY>K(>-34tjL_RN1Dnxy8Lg~&#sVt`be%NdNsQ0bNu`J!010(s=X|X$oIIrCy8p#%)
z>76&y6ihnxF`4-uA?qhD=UK7gw|?<GZ&}}bI(qhc;vT(bwS39>r4jXgpI2X9y_-bD
zM_AgoyRL)c-Gf+faX+1fbjIED-`{KxQIdOMuf1??+mH(NVCwy}^ehd>)N_k^E4AXy
zepcFrB3ed?LXp>s__mq!$q<k~5E$Ps6`f@?7vy_mfbOgpR|Nk)&C48=%e~{6+C$v&
zUq31@d=S<xR=f0>&|#U8_)+4U_Ag#otAbLi2**WjrO_w8J_!>e5B=C~t=M2!{l9<p
z^nHzFRGTyJCOCMquv3~DYf=6p-8>U>-Zh|x&ssQl=B?gP#i#Ll0p6~8k}u+Z<RRIw
zYYWr-Q#C25umq28myrz(8?o!1<K7Z7b8Sn@yJyA$zIQ{be{i=ic)syrxMr81V3{0!
zv)k^vAOW+dUpklTx4ef0U)u<F{37iB9!~vGLHY$}2>;`=W3F4X@+}oc8-PnjncOYJ
zfOJ5nZIne9`~wZFPYQX_%h!}+&d&4HGt|TCpMtX(nSVwRT2zaeUOh3$@|d?sVEd=L
zt>yL|z9x_F3oZV5Vr@N5V*i!uaMt!-e=l7V;jYl39cKOS$3;)yl2mz_&*O_#6Ixbz
z9UH1hG_G-Z(fba8-IB$TmDlD-q<Pbx%(v-w^NMxtSQWG4_E9b>{v?MzGlF)Sog=#l
zy*P!(t~Y#&C(sbh<Pp)@dvorE;*|-~(LiITQ2!h%1!2pdMXHL13IS!NJNNFRA>fQZ
zNmvw<cZ%{>4=w!`_8a?&d2i%@=KrR{&2PW8i9jm#va%iHi*EMC!hqYaZfV71Yxz>P
zG?7#llZ8pS@{m|hNUOj8S{&y6txs>lY9%F+amK~M!Hth1Y1xB&=S-3aDXm+EjjZaS
z>sWe2$Ax1T4Zl6go%!%igDZE%dWU);)t2)_LQTUo?W=au3&^ya@-V%{>oY^b?0(}&
zviOSVNdo5Dd*lHkm+grV8*|eV@2|Pw&ob)$iVdCUs6J$>MeijJVo)AmV!LtpE{*3^
zBkLUwLPR|~A8*B~hrMaCzQlet#>!`YNmn!Q{aE2D&-lr&(#4svZ&?VBq%n5bHv~+c
z6Bs1iulR<lsO(Htu><#)aN4chR-Dp)igDX+zL>tlYqjGb9Z%O}Q^I9)q1XLNS!{}3
z^*zk`b~j`%iZmHxwXN&*Y2H^2trD0Jb`vTeG*Y2<vSCf<sP`?4uhg_%AUoUh*pQjc
zKgO;c(;0CltH<xvl`SMX<XgE;BT@aqJIsEKkBic+g8zlNrBCM9iomaxlV$x%4D&^T
z3C3o-IJVqWBEqO$ncMnGBJTqWNqCW7LE`ElO*`SC&uu*=tfCR+`W(|lr@hG!o;M?*
z5-q#haDnplE06PEd^odKMJ@Qp<W9Iyc+AMZs;Q{(C5a&IX$#CyWqmACr||ZwuYjjS
z3z5NPPt*JRDJ(8Dq}UhbCu6n!qI?Ns*^KLSRkwnF%!096xZv6^l{}u$?rk?}P-2J)
zVw1kCa?fiS>u`7Z($yYy0y_uHM>XpEvfobUNIN*~QW>^&j=e>pXRw>B;He11v~sD~
zgA5DNsuzbErDwbmTOY(@o50qdyCe^a5jpt<$M)neM3&^_-A}ZQ99CuX#CB15=Qmg^
zmyNscdichS$Uk03le+Kv+f{!H`Cw-UQ9g|I4ZD*Z;>+I}<fhG~3STq#^j@-Zv{4CA
zXtAPE0nw^DFH725G)OLP+hNXjmeT69e{O!06a`<MhzVt`%ee}jIO^S1#6_VzcjpR}
z!YL?LyS9e5`RAV~YYBMY_e0}yew0Vvqtc?JYT-G~49<#?%6zeXwt3m3%t`ikbi1`}
zy*Ubu!*3N9RGvn<a^$U74U8KsCLJ?n7U;fp`_3*2cn^fKDCg<S>fRz`Bqr~5s9n`s
z$&FPJa5`2Vr!!}NGCQ$>CQC@+42!pFhfL@vk*l2SUTNok&fLtQOw1+^4-jKj*F9N&
z&v|TLT`_0G#~1DfP1#a3hHjmo)e3V~Pe`fH9p|*kYDg+1&2c{P)gy%R^a{Z&x0*cX
zj&z<Vf&BAy`;NXEzIHHXpJMBvWHb{MMQw_JoV|n&_`WeF>({<qH26S?Scm7^*&C6~
zyW)n`;$*Y--6#qvIm`U0Wr!!AtKcSA*YXlW&FU(Z4v7xa<>ChI=E1&I_U|JC40MaZ
z)<}9h!E4oc;#IkQ42}9c5(Gc*ycNtf7xB*bIzh<kqY!QFf3>EJ|FOL&*HB1;UHF#r
zW9naC?tU#}VWeTUMat=@1(ws9k&cA1JuI|K?WT8%>J?74AiAQuum+_JAI;j!ZmutE
z>P_ymDOY#<8cA<Gs`jWc)=qb_JIFTQPO<dZn<t84qc-|cWWKL|h?%#|=U>%XAnx>2
z_~m!2*h>o=?rCheEzey)YwJ;!+Y{$Y1D|a9X|V6u9tHv5qKa9E?8MxensL#`f;~pV
z%qPzCRi~^><bhul%UYJdL%?yA&`haCpl(8B)HmYGy}^0@-Z!dq#V3P41aV0?tM~hM
zcF?|0rP6p~BpJ-s<)N9PWn_23*DP({J83b@F4?S}yL<*Z*27#J<AmqP4vgn0*s(6#
zH)f<IyfZPVjy51Gan{_ntG^@f7bSJV`-o2a0fJ=_GKaT5-R;?vr?QR3b=WMQ5*?p!
ztA6}Ztmqj}i)3h=DA6A7(RebJZl2Oeg*oCA*<CYda`(IF=|m`GO=piM2rOq6ugt3q
z9}C@XcVrTAn3|)i?P|J4wYZ#ZAhRGv^yFoSMPers)fxQl<s%o30xl}v_Tc5>$o5*#
zWFxvXVS)48caBvYkIJst;&B7HEFgcIvvlec^Bn@Q_SGv}6$yzSIC?%(uHYXGIa}%a
z#YDwl^}``iKO-RwRcGzk)njfV8J2@RO|565J@SUY-?X8Bq0ny1=BZ4Za{g-u<Bp<0
zy(3TAB>0vZwLAT@BstHi?0aW(JjhSQ|D@g%?on#zw!`U`B@vR{2k6V)Jx;L?ax~E&
zQt3z@7~VTQku!0OYQmne<U?(s#=|AK1cE{GWqH=9Io)_RIcCA$Jr<MF#@#2Wo@p`g
zwJ6<f5aFxj|GZmj)PV%UTYJOyizeexerngiOj)KPcAmaj?t~XnZ7(bH^JpQp{Nk@+
zp9>G`e9rx_oi1#r7pGbohIX(toq1yasgLR4#ntArh4;kXGZU%T{KDyOZb`t%o%%_+
z&6TN}rk;Z)<^`QpF**0bx#W-`hOZKwF}DVL_UyeSVJR8?{iN9K1exL8)OI0sS!L8V
zfgyRAvUenE(^^E$lkTFUI>x-CI}_~@3)6vB1-a)9lUy%(G9HxtIO;Ea(aq?((eb{9
z%V`{6TBc~p91~6pSyFeie5K+w?^VID95okye0kZ{_BQov*=p^mjMuV{S*8cKYX^$d
zmR)k~bUk#bZ|R<Hve_Kpe2ZsuQ(3xM#(4HpdSi>*$EKF5k5rF#XGpUAavkJ!>&gCR
ze04xP;~}a10&D9PzO5;@`V!tg`H0op^~2{nk%L7qt7%GG&G{r5o5ak1r9?5t2hskT
z_a&S-jPG3$63i*nes=fios5--er?7Bk>o7f59+5CRE~`nG3h-kay`2{=&eU9hfN~y
zPsWRTzd7DI`-o%mp0n`Fi-x9gj}D%oDjXKQ{{D4Imvb=V)PsY4XD+&N%G({dv?4?A
zyySU+id1^EH<Oq8U4F}$Tq4&l%wg{jjz==C?Oi^c6UWVS@zVEQRVDjOfL}tAr?%_f
z0gYa}hx>YxwJt@?75J}4W|!!1Ykl>jzUc#L#(<l6%SZAm#ugJEGyfe@8R>R?!~JwW
zZgZ)af6O-Pvd_7p&UY@|eZSpe!+os0q*hl)>4hv#0X_v6XBSaI=l*j3hg~(LUkFVE
z?~Bwvvys%+AUt0C{OZ#DGVPOnoqj{f>LE8$nX|=D@Um~+K{XJ1U0*}u>UeUw+V<Bc
z2TxP6o_ebh;w3OOm@&Zk@cXiQOQDqko34_E+Vh*STS`Ws4ae1GbKJx%-n33OI#Zca
zD(3a6LZz(gds1TC;F#O+j=adcv>{&;-Xp65SUwANp8-y6j1-YYe8sTcNM#_yLnYPK
z^lc55Re92tp`WDM8@w!i#B83#XP#FgOA}53f7<BfiO&=?!Yq&b1h}gYUn-8pCOgR3
z4;0H++j-8lPr4rtB`1_u=4Q-dVYo)UbqA@jA6v&&%dpq4xk7BYiv-;#&x#x+DK*@0
z7w`TywpR1-!6R<3$^)w>bX+uVQdmx$mM-~n;RfGZ=GBzbyO+xO@3$W>#X5SFrHxl2
zm&@+=@aJTkUG0qOJvUuLce61v+u2NI$D29If=)70!ylceBoY!dv6w~AT?@8`a|6~?
z<QZu;PnMQvb%y(z5{K$K-;cLVtt=1j)K;mvQP}U@vH0`erSbB{(DX-L{^U{Wp9#pm
z?N5mG;uY&ZMs}H{KHug<sZ9>~Ws0<}M_G0Uh)53=Kb&!RjCj~%C?9L;O%72lTWdwp
zX-6Nwa(>SbMXEw!+N(xg#3NpsUs;mnB8kXZoUdG-=K6U4+x~sio?TXf(_5;J8@w6C
zo;XD-UVYyoyvbp;x-7E6_NJR*n(=~v&(55Cfimx6Ni0q-P^Cv(DPTwLq@*gFe4|qI
zqwh#QDPzIB5NA155JM?r9nYRCTluOlNoVqs+#}HxNp_lhTR!xc9`uwmlY8tPAa?r2
zOS>cQzE#K!8FO<v$sOUcl0N%*$Jx9TqW7wTO-00)u91-T>IvPx*rVg|^^Uf1z_GBX
zfiZsHD(#?;12=eSj<7R?lW9c_J@?=9Qs~Kk-({AIOd82rU%=n*c7A$&X3C)V`Q;G;
z@l4l)!71~^%dGW_adnbsQ&I&>W&$KwkM@d3hF7l^UD-V%q}XcK`)wdI`<w7^5Vpsi
zYH3-8Ni}wFa&)jqtCuACVAc1<ChJb>hh;Bx?Uk(K>+}aTB0e?@r|nrBt;~rF5FWi`
ztf+DBOgyRf#Ee2+hCKr-O)b-?&gzc>B<Gg(ScJ;icGX+W)n|!+eq-%=@nzDz&P#Mp
z6t%Csst`{Q&!iq%68V!_>JC$Tj>~<05{^zvvA?E*VlIl@=sSMIu=SQ^G((P2zog&b
z0|ob{*n8Ab56@A3B9}5u5BvNkVLCReLZFY&+odjohQU14WQFcm&4}kwt)&Ycm!w#h
zOPh1{4nGqPh$3DU@<&b=G|O)5inNkT+?R7JYo`5VgHrHR&jWhJsSAA1$}?ArhgQl@
zBnE1XB|HUxX~4Rk;EDm(XCXQ;i-Vb8ZT`)`jKnZ$4*9KERpIPoPh6JgMBBbLaQ3}g
z$V{P@_;x1XO_1dq*4_3F3l?5f{ExOxMN~I`&1z@4+imx`|A6SZ1zT&wKpC?~6E5*h
zTH(o(IsA?i<XMG*A6K?K{o?D~p6IA$n7pvXF1C2qTw~B}SJ0?%zaND`LFw{IeL1lf
z*1OfOyporlbqDpA>PC+3sx(%zl_#<b=+vb%88_o*oQ*TR5sBGJbiYvS;;_$Cm3yft
z+DXiOY0A|5zV-15f3Bu!bEbY^((&lv$8GH2ntr~xntV^UB|5u=W4CHc!`V--Dqr_%
zT`X9kb_n5DmUyUdF%_L#F?%FEvu_~{^U=h7Kz-uImEehoN0>R@6D`MMs)%EW70&C5
zoos0HpKfqL_+^wXuIQYL(tksxJ5r@LO+MZz9~tW?n5jM0SpU>%?ihpeD2MBT+}Sbe
zBNz32KaL)M&HK(%3uAX^&`#jOr6HoK$6|R_)ZJ~4KR@4$+o@v}B}#Lu=-7{1kIJOW
z8K>h+_t-xxH+<Vu!7^BQ{#TUI4*CPh#WQ!}MJN|bj8gSIjpqtdwL7HpJIPl?3Mb?f
z96wxHt{nJqCAHnZGK!c#x>{i8tGm^{TW&hh>ECXW%#%$D%8@^<t)3EbiEJq8u}c`&
zHojL0@`1gLl|Ik4cX!0iw!P>}`SdZ%`}l=i;S<F7C`PJx9kAZY;5>c)1kHKlYgs+b
z7M@y1j!^1fzRP3ExRaLLR9PplVW$;QhBBQ|-+`?u$LND+sNNkj*H9v*tfRDF`m&94
zZZ&q){Phubez`;Shdj(UU%j*OHOczguhOuGzO>}hFR%HKM}{l&&h2VeIs^>2d@h{C
zCR$76WwN&H_-M2$|Llr_J$K&o40#^oXnBR1Z2}|TJ-11wU5$(E5*DK@JH{rv?J}qK
zjUa1>t|)>1>3%HRN%j+p3%ZM}`qdq9do8wCw2H3nYe~1w&5$6vl5~p)KQUq^RtN4e
zj(v6OzQ@L@f1X5Qhm0%Djwro04d(Ri*Lk?vl3KRP?$BNN=Bg}g9slLHy2Vq;%-KPk
zpo4?^mTI&TMIKMgs_7>GxN%3Kd|ID~4g2b$@q+ihVTaG=q$`;71ibZG{Be(#Loie%
zX7}jA?j~-_O!Vhwla)c1EE+1B@*a$A`8DeHex>2q0T(GACWe~p;apcvbN5<f#UI=#
z3vE;KVLHMq8v9CzmA8kxHg)j2Ul*{OJ8OAbbxXvF$+zu&o>g>cvdbaace_K+HTkLQ
z^4HwM7gds_?Bet1ln7%8eOy;nj|%!@nU%*K4%Trm4o(V(S_tXxej9GR(jVN`Ilqrk
z&RGA~>4r*{JTot|r0B8o{*@=Pk*Z3TL-`Zilxb%)L>c)TlxA0-CM(Bj=DmC`|6)3L
z_{Z!|ow4(=<VnF4k+-7z8yF}v&e{$zzWn0Ec1Fi|>wD|T2hQ~JZT|k(o-OaoW!kO%
zT$MJ&)>r7F8O10C+11190gJ~cB}~d<i2`3-|5C%yv&H{-j2HXKrPfmm+b0*(R$@uE
zJhAhgs*&>ykym-SgP4nz@W<9=YfF+sm7R}%?c%O^zAuLG=|$-Z-C`##b~&+u_d`ls
z(&^3_UMFt6Q&TEKsqnEW)GQ^cX5kRYerm7V5od%kCn|!ldt56=nV7U3D|o9NKHTUl
zDU`My96EQzg;z&}@R(*;;ib1n%d;+uF-#hfo!NO^*u?R0t>_|oi|t+aZFymtud!Ej
zZBrKy2EE`a>C`M>X*fVMH;*V|&+*9=^L_qtwP8Hl`kGa}>I-9xr?uNQbH(bM(5U>%
z{m-|*`0#Lb)~Uf-b<$KWv0)z@#T}tV!JU+uZ><}?tY#m!6;`xD^x`naDQB2(aWHBZ
z3dtPRBHropLE{ah7!SSY>h8vHS|XNFLAI4HpZ3eG+k8_rJMM7gZuulhXLOL4|NYCA
zGnA8|Y2mA-({B2+qvpL4Y4L>Pam!l^1Vpjy-furwR`&dyy)J5LBgC+C`2*&Gb*?Mv
z*QyGS4tBq$8P(M!;}ad{?wSwy<UNU#1Xm5x{)^Aa$}iSj$a18UJY&mEeZ?;|iOgXC
zOgI_mOLlY0fEz@u%{`^tu~F)VE%z;bS}Y}ngJh?N#uk@bQ*KVUfd6&qWGX4=@Jy^K
zoP}X*{$MB9=r%Kixk`%!VeL|Jeci5864{Z|H*(x}KkZhBX13)+1(IaHF7Brm;5y0O
zpJ4aVcl2>lU%8Alu}s7F$_q5^!cwG-wKP*Ejn}PH=_TZ{{Hn*!6Mx*6q(WE|aG3Ap
zl@m9PTf5YX=I}jJ&sj08ZxzG*tUX{pcU2&BI^dJ)3*-$(h4`~xc=EmGS_Zdw+glsP
zx1QS{wrhfuFUv4dzIJ~>p>cA+;k)%d-7ShAWW%(ronGtDeHyJlV6ia9#C(C`r(wi?
zw;4{oB8edXuSdQ}w7%FDdoV$`#i--0wcR;Kr~2|&M&Z$x&XFM@x}R#OMw_UDZ|k$G
zF*IO9Uh*rvT<rFq^?Q7JdFe1>OjwAdnwafbopT;qIW;dh8BKQgz{2AKeG27WGmm2h
zzhpZn?^aCipXuJIOM0?}@2-#G-Qa*sx0??O^4a&kJ^BzEIQWux{JMl!IHTpj@R1av
zEzw=CzP}idoqkHc{6I%}{HZ{*M0TkPmXx8+O7|)&k~$?wEKykHIy9baKchVsUUDq4
zE7t8EyTGrGl7zQ1Zu8UiAzJU3LTO&T!#?#1HJ-mW)B4n&B~8o4i$DlrDwv=E0$Qpn
z#E^6cRt~pGKU=CjokXLUxaS<_-B0IFYjDW4`}=TK`$UlMQi>3y<f^m7>=Zoy!jJm-
zd;`K1#;kN`#AqRKvVeWm<5=6o9=aD5OLwY7i50vry;HCZ^?PT3Q~Y+334_Jmff*|x
z4j);#+oPOgB?8;{SzcUw_T{A9LS)K;pU*~G$aH;6;;js2XCkcysFwo-6UC{DIV4n%
zrWkd_Tqogbm|{+%Qw&U!)f;3!I(Cf1FyHSmM?;jbEdRN>J?$@*Bn6Kg3}io;&q*s{
zKrT>*c^-uIR=eD#)>tm~z3BRf(I(2zTiu4{dTC4&B~@y!EjXlyaladBp&FW&Z{_`x
z%r$tAH<7?~>hMCST<~~&m-)SYU2K8Uwqy4c-e4~54$&qQcJ$x#s9eu#;k~ZxY;M7n
zh6@>6XKi6PZ9&65m+gBJF3De2x3!eUWIy#1q(2mOOXyW_oO;IyVI7T@C$;#)ZR$Z`
zc8?b*I4n5aAK$F(soAx4rptMY@b$-`tC(ItViloerqys3*OswM%}XUa`l1-ZdID<i
zgTME=;(JHm)G(_vG1p1B<D`kcy~xfKh5X7Z2N_L{zhTq~F(sGP`=RT_q10XzhjDG(
z?kDu_2is7vZR_)ehtFg)u#L32&$aFd1<)tno9c^oJ|gnLfZD)WxO^b*;&y>u??d;I
zFPfXZdKPLjyVCRPaBb=3r5!z1lQqNnez{X8tpr{eiHoX!m7S#0*6S?c#!4R>FAvx`
z=S$qySd`K6X(^&(OX(-=QLEGr<DFYYc6#|ER;~qxZe1<BZ&YvT#ZZ)=m(EH&XPf?Q
z_n6?I9rK~EPvs8W>6qf%g(kY>T%sgyW$CMrj#?RvoD_b(s&a{j?Bc-C{7_x{=(mYF
zr4_~KZv!6|uAUE7ZB5>GZm5fjaYmZJE{65v5=Wb2{Ul`p9dW44V#lk!{>|jt859`$
z5D!|yOQi28ms2qVB%an*=VFMBPVKv<W}UoEqH&K$wHWpm^>G6FTvo!L;tbS}Z2in$
zbiCstQMDF$<Yc^LpYbd*iedKUP4Qedp3@7d7=>M{$0NQZX*UWc5(Jz}wGwb4lOh&4
zf>AEi;uh48q*tU&$(lE`PR_WpVw$`lOW0<rq#@2~JzqL~hENnUKwP!$*YgqE7wP@&
zx|V@2J~_CBuhNmIcwkg~+XI&3tUw20jdQo6$%<*`oU9pWz8rmV3+okju2pW!z_$Ri
z<z$NH+6R6DCqJJHgvgH~YE9lo4G}iIT}iVnx+ZW+@N$~w$T<%7Ju@>i3&@d$7)<M~
zWj<3&;l2qc?cIVZ2_G~)u9F<M4yAo1l`kedu{%wM_)ejj-?gs8*ms!Fohfk+)tNat
zCn8j0?hvdbl+nM6+J5uILM$;mP;>NH&@SE+4<(E#4JPR2^q6MO<XPMi>ZETQdY_nU
zn?@1F-mow(?!mcW$<fK8YLZ{bG%jPkVx99)_RgR&F&VFQl@9;(QWNvcn03gB`=2Ee
z2{Jz0n__)A_uj!iC88~)BHzoD^5XT9h?Q&KsA%LCvW7)sI*lXPg`K}LkIs~*DohjT
zhTS2cN=a=J6Qv*wx43S3IG>-Har+A)Y?f*)E6JWgJql{9SlMds=mc|C^W0Q|qr)S4
z60AFeU~+FX_1z<?E0)uwYEK6T{RlJ&Qi=?OuqnHXJf`wPmUkE2AuKUqXAvk`$RwGW
z8(_v}YGi6!>HvOQW;o7&f8#}@e~g~)Yn-a09xdVb`$7ghKM%^#ixBJ>*;ZtIrHt>W
z=@A=u!&g4^LA#BKgE%a`Ulum|T*(@sxMUkb^7&*^O5&d9mfE}Xcf7c9K;zaMD{y8K
zco9=ro+I@l=sHed%fM`TAUdTZ?()RGK&eOqgX!~!C>Xs6`1sV0E$lL+71C|l|4=t9
z$tr{NpA<;HkghW1SWmVRO#Zq?0FubHn^)fpsahWgWexzU00;>f!B3Em;<EqrPXs|2
z0SIma4p{e}=KHVE2XavZkOB|}pbEf$mmrQi0N986U*Y-h=mU7e@r5$~Z_)(loD4wl
z-yzfAp#gX?0>}gKTN>(^Ln_jSkmT3xNUV7a;;-F+_&uyg!C$)`347XvWO!nbijPAG
z#Qlqu2kQP~dH~u`?%&3Ha(EHQ)P)29S)FcI1E@lrWc~tR{U2?f%C*S1_yGjc_#?r!
z^>1BQfF6{+69AeZ&lKlY#7?{nu@(OgpbV5@{vFNj#9%$H4%Tn9{f=iNS_bs3Ml!v+
z{?wxrFoMU=|2hFWs;JOwKj4@-+^j?#r797Z+cf}c5oeHZ2A4bkShu+yU$zr3U+?Fs
zQjZkJ4{l}!_lD~KMgh>@08bE(d4y35DzEFEI>cTA$PaRt+YoATIr_X-M(bd?7J>LE
z?piy(zq1TZf3$rKKi;ApnH>6UO&R<vIzZhw%O0rHjLPA9ryk_>h?6u}@3*SaGUUGj
zupK_*@HXo4IQ59LOf8r{*mt82mfd7=eS>s<{<)t1NAm#W<^TZa52fRyUWYi|tipjL
z$RU7d2Z<kuomd4btD9^C;J*fU8gO+W-(2Sgp8>%BXc>?H7kRL53*h|=ihxgye`g*5
zGBtos*a@x~NCz*2yKEx@!EFtkZq*|8;+1R98?xeX;4=;%*RKhEc9yOK^H#gw$6dDR
zH<~zJxPE`=0A>1bbpSZ<{6bTrB?fVqgY<ugx8V6LsDC3>gTi0opnU+&Te;?S8n`~S
z2<#8r(Kc9K;{oTyMFv9sdLC}riWdjwq5o_SK)WCwxg=p2<?~jy8RY|c;Q+_ib&U_K
zbG%st+J63lw;3PT<{}N}1lNCq9>fFffRF3#M#M=9><N(Lpb5=O5{L0(!Ti6R1JITS
z5#YM>yWfg<0J`gNw*^;T%Uy0YfM;0O0(k#K+-^5*;G(+V>YM?d%PlaT0A5Rg^9JP3
z@L75-Uu(nTIEYoP<Kz1}-Ks;d8)s79U(Ep!dwuLb`wXD6ctTkLc-{rN0Dw8HbCZE%
z_;dXk*2A&Iwd3(x5%)XIsD7{yl;zKMs5@+f_2^ivm2tFi^{@@{`{dmZhZdg%|I`6A
zz<U%r_Bff_5U;y!fHodl(PyuFZHOzNhpUHm?TFXCcI53Hum%9YJ`e{ltFu%+;wcAY
zxZRBQ+1!T5!R4S2=m-1b>Em&6&n=th;J1AM#D-@MdR~?$j-vcgxqxh*_gc|&8ok$m
zJIrfv_PO2$YeyE$4IY4e9$*c@eSn_rx4`>Zx)PLY&~x;)cs1fF3&$7-aJ|9z9(pGN
zG@b9%p!*r>0mlM@%PnvQfqm^D3C=gLuc0m(Z+qbo<J0;b2~<eoD+3<1Bi{EqP=IHd
zt<*Op<V6LN?%xEU5eYCVLoCJe!27EPmETjY4e$ng7~Cf;#d8rq!xALbw*iGj=NiOD
zCJ%x49CZ8vuG^g^#O`J>;-XrFBsf(exzVl2d$&5oL9PJkT!F45?|Yr-zJ2@PJCf)G
z&Ia`|RKM`Yop>=}E`?u1pp2fGBb^ICZXmyWCs@0UpkFC6G5C*n-SNR$B=jY`Khyx+
z4ltHANM>Lw0_*=wvs2)%=iUs?!#Z?LxhYm6m7jkb$Mr5HAG*<bgZzC|o7Z_y49z3n
zs!gbD!$8Khw7!PGa}})nkv0a_a4U-Eu2h9g4E-+q!tBagS6mip3T0|R5-dA@tM9Ix
zL3$fzk%gJ%^?E-oc;~1=no394>tNxJcPvsE+XLp{C*r5}+qsW~KgJ+FK(Fd_EWUr$
zrtwGXvb_cncbOJ2_Dx9XhmA2R3?Bw(0N9&y?MRYUFZy1F9mWUe!Tq-e2?MmDZd1cc
zC?B{l+`#<#KSGBErJd~9j=0JHK+EvQaOXV0?E+)fiA3nZ`!nvY0LR)D+=Jja7KV?Y
z-#TUQ#t~nIE)>$8H}0rVen5&5Pc;5TFX9LA93_7s^D|3mb!9r(&p>Wp`EJnG1E3p$
z=PN$Jv4=7QsCA%cD!e;8+$u$!lnTK*>BFNTsZQNUieu-dXFy94M-$4H7rJpi`fD{I
zK7b~CN58)H9h}W|s9cbDiuDF>Kn%*xfhQWF2Wj>oK{_q?DkSwy50JkT@mJ_Y{1tHk
z?*aIf<pt&&oGotPzUiq^j{NxC{}1bK63mO2Vl$Hd7K87G1ZlURbiMC(f%CN!$?)i2
zZ}Zn`1m{&d@;R^z-2<7v;EcH4f_TeyA)(qEG(ZQzH9-4D>f_`KeY~-rqfMJpodOj5
z5In#;JwBzs?LyCtoRA)T)o*!I!88)3--pi8X8A)Ox3ANKW0vi+F;}6F+R#1N(=db5
zf;l{U{lFN8Ki<$2H2#D90gC<LOle=2p)j@!%wyxa4)BbQHfvmOPcQ>_Jn-Ja4&lxP
zxM!ivA8dz^zz1**fUyL9eC}b8bdRp}exZ-rkwB$>00XEVo7ZHBE<8gzke+(H{IlqK
z@{#LC$6}qxAM!^$?m+^9`~gaRNMpeyiU#*Vgemymkf}fct`WG$V1j!#RI?Avf5-Ya
zQvuM|8GOsbZ$xjcDsT?;AnBf9Z-71hY10^o=(MfLKM45s|F);#_`|cN2b^Ir!QA_9
zC*pgz=TG_J+Gj+Oz>oKqKz79eBuHrpi8km*<-@lPv`--*KoS3l=3m3d5x;xAi0{1~
zq_uQI-*3qnq_KGDw|xNDbEe0}nHKg4?0JO&Bv={D6PSZ9zC-J@!}T!Wyy*Hvehk=y
zeMsE%jdcb(Fs_|JXx|K%A;e$452YERGJ?D_8Tw6!bq1hNmN0<?DGvhNVHBeD`oSFh
z_Pw-@Uh#esj7vX~;k+SZs3urDV61TchmZ`XjkXwr0dQ9ItjiDIC%)k9gL>xpj;zy#
zvcm)_(1W@r6Yx>!M}n1xkr0(pBt&@xiFi1KltfJ<%>}baOW_<SPa&~}BS?_q5Q-BF
za3DZ^L)8b6f&eU1mo<YzN%SNVtv86a1p<6H)}P(6$Vb~zbdDjPK!rg-3pWOz-6ui&
z1QM(=jGoo-9S9T5;n@M@ugSp8Gn5%8Jt}`F#2djZqIi%VDv!z-5(*$hc@)(N${DIU
z3V05IdY~VG-*SkD>atdk_5->>9hE>|6dy-32*?g;Ltgl?!1IK3p}f5fxc5I?{{i6a
zhIJ#I>$VB^P4Y`Y`C)?V9@0knsg464YXHiqUO=W0Wheuz$H@|g#{+q=5|ka+jxR%6
zIGoM+puA4!Pg+1PFjswzxO1YfVIGV<m`9C`{R2eZe1D@xg$F-!{NQ>3bG^nB@(oj+
zScf1*D9grk7|>($Gt?^t>VTJREe}`40z8Pj0T2i6i_%!5qqadi+ie0F>smreqi0Zk
z%9F5oG2vZ*{r<eR2SQ;Zyu-lvEaU^_fP8TP=&DSBI=~a;Xq_5tTPs66^cjnrA0Qii
zhWNkXp!9HkAe~U<@%4TiynwF1jmtQ?cHnz_EhXdE4n7C<@Lh(cTtB$BM^L_DfM0~#
zB;YZLlY1?Pb^i>YEKt7Rai&l@o9q4&2S+zl8P_*lbrRh_xqiQ$-GX?zH|Ie3Jg5Mi
z1Grysa|`7Md{uBcS_U*B-AGW6lV$4n^8IPFegkI%5B7)saD71zaKn^0Xv6lfbzYDU
zm@6%4r(PfXzx;lOdH~Va-(}z5fpZL;8*tns)qp&zI9{*}dE%aD&@z0Eyg!3P0l=5T
zRX{)dGwie04{cv7<MDAi;pjrVaKI}H9fK)!FO~yYHYLH$WBz9u;DzFG6HNxdc{zs4
z3VB7{pG9SaIbIH29lm}|hc$UO`oMNP4!(?k-spqs1N!3W!}Ioo&Bl8T$mRB@ynj9e
z95@G^0MI#u??O0-kY@CQIUL-FInY6E28luIKpSjd16Yri0S?6bM*#g%daw;w-WUg*
zUZLRph}QpY-9VXsJ9GY&9sdmQ*4NS0$PyB3Fo>QJQK&399bz8L1KH<+9CK(MqYldG
zGfpP7Z4GA~7vBfsZEC}pQ5^sexbLFDxNTbVZ~<}P<@-B1z*hl)Cb*wtfDZ6Xg*;*&
zEZ}5DWx$sgkXZEvbUa}Waq#)(GOXKNAG3xFb%eCxxe4cdlk89imA@nNpE#hOKB@rt
z0l!b-ogUr=;M$J`;~lHMh=T{X9Llm@hj05Mk6U|=Q~$M&3;V(S8Vt_t#FyY6xN+7%
z_6C2-^*?zA{Z#<09{}IMw{*A`SWn=5hie!&o=|=$&o2bZ6{oTEdk*U2(K=ACfosR<
z3FZsXfcp#Hjp3R1NBWn>{ZIV>P57PAiKjg|@(bKEz&#G!2jQB6^8xoElnIqjeF>Ep
z${eo=WyZ^m8*}`4!@hya;7$x^{W0c{7vrCD{BNECJ$OfQ1F)Xpnu2F@h<Y!2ABOif
zI4|hgx_;iyfoI%%0k*+2F%Wz=z<Xkj@9>{;L)xJL{;jfa)*H|k1ds>dw*>7u)frgy
z{s-4^w0=Lj=VPA$S;097_fCe(Ac_O+e1DPhK;3^#?#(*DGT;UENCxl^ix$-VPf{pA
z7W|X`|E*`h8?GxU0B~(p0r>9{#0doe`~0o<(f=)7@O*$=@cqXD0L~E}81e1@FaLid
z@c)$&fN^Gw00aT7$C>>bcGcP*fNS3XfaMy%@_%gK0@{pgeE!Zk(z%BFzt(n*Zy3nY
zG}JkVe2wo%<DmRN?30Hw@Kpiu2k}raJ_@#V*H7coCqMy?&%Y!G=qCuE697`1Gm7|X
z)B+!01@OC7Ag_T>41xnbN9(~e@X5itXp?57K5zZI7Se#r;BO~@59J2$@I?g1t-O%}
zzT>r69()e%u(&v%jTj&J>?rjEjX{C7^aL350%)uygTEsHz=dlG83tnw<4y1}D^9nd
z&vGL!1;*Xr+cwHDh63l?#J72?GyqySdl4XO`Ojnk?QqOd{I?4A>+vWsuEhEVh^Yd!
z@o^Yvz7}_aFK@JicmmkA7JuRcd~};+5d13{09$GRo$&7EtM(K1(ct4lpuYzC>Y?8i
z`dBvC<H{iR1o*X}?;qE`DXwD;AKLEMd|91<596OQfI4)}ldQS{4Sb9QE<OT{`2fCH
z7>j^wgY|g8;lj9xjXGR>!$!OWE^Z>x0t48fY28N&<p4EM_ld^*Nz^BS^PA)11z>!E
zi!{zx0sZ&*cmiB}L<{mpvJQE36U3E)I0M+WIfrFO7#jiWL7V~f+1Ka7ZHcD!F#u1f
z?(cyQ5%u$<u>m;#&?mm`{|5DLGSJ_TYlFUT7=z%x76X9B4gkMA-oFo@p}!vW^8;K+
zEA-L256Tki4in(tiTWZ?AA1`bs~GsC8VNJ0MqE_BA&$Ur4}F(!fj`Yrx(ac>Uxox5
zS0cWTL7d#(3e*Pz+unefKll5kNZ8A2B*5SY@&@?&p)6<&#r<+5$N-#IVBUs0(EWhg
zsR3^|_DD(mDDaJ75KrYgq^ab$xE7@9OF!7_wTLh9J;U<mGy#0A-s*5)G@?G4&21gE
z;5$aA3HABn{hq#REl647`q{(?@TFj%R7c?N0pr?II*yX~kv5K`z3E4)(s8&2G2KYa
za}3%BzZGMiVUS3ZCiMAR!XT1h`x7m<l}{llHn1OVo-5LZ0o^v#X59XL8r3n`dR+%W
z(8&OHguXmqRh)mb?fWF~YjvT%3OFWk-@vmUjRyha2jdCC!5IHo^TXzb^rP{wkPh^b
z!oDzO1nP{bn?z$2V4NQGGvoZq>pn%u+Y<H*(d-5OW?X$yY#-t$-vjsqnG`TcUG50#
zbBA#=UxK@T^B*<kPXYUPH&T~_8z<=Fg!X(WEA*#z)lH#mpsRig%=;|xskI|P57zyC
zkT=RdRHF~o7y8~Xbrb0M1$ld`HlTWR)lMTGciPZ0^eLvh0AJ1n5Zj_shx#z<^Kj!G
z2G%#~s|0>Rh}Q+)hcI>mmSL>XTR<aNeO-UZ8y)|M$Iy>5h~RDEoj``dSg0%R?9K&$
zrV0Af;5iEGKDf6aH90sNT%tuc(y+!K#uGpv0rY7@p3qkbeP*x><1fAMf^`FUttH4?
z5SCM{aXv5T`>K3Dz3v}_cCPYw&|Zo21wr50C}!Q}3j9wqz-}>w<N^7nMwXHAhrn+H
z{Djb7)mbr%)Mn10<AKwE0oWsYkSy1AUzZeM%?SBJy`g^v`h=jL2HI$24WQ2g_;FC5
z4z3=yL*EoC&ze7G-7lsB{9m9B^=Ym7g&-{`52`<S7ejjpevAQI^lk$3s*$cmblh<M
zB%E&t+95XlJ<z9t^T$9L@cs}~Uep(Y^Wot7<NQ2$e-D%a`oKoJet|je2mU8?PCId@
zAA0_wYY^J@AU)K!4SW<hUlQJr0rE9J2Hpn%ZTt{Wd|>NY_t*Sc2cDy~$B}nNz{h8|
z9;afti9b3A%>~n_9Sz#&q5U4Ux1%<FVEX{}cW5)m18j$KZ1^1Tw){1mO>H<luus7_
zKp#9vaI^e&F9gq_0FYE$;M+v?gfif4^Y|QZ+s5TU9_VWTHYU^t4{h7{GRX05urCfK
zfq!#--L32X#~5@%8&-nhC`xO?c8s%yqqb#WSA%xvzqX;{ZSfoJ&}I$gig>tg6Y2zN
z{-*mT8PL55*GZK2D9Qt88^_sDQ9Cl;R*vRtw&wLZXg|i;opJW>In?$V`EX>je^U_8
z@2_$on*{){$3a{;kQv&zaCY8B)HV!lc~FiGdn&LAuiIB~c2*Q0*omVa%pmb#EI0X9
z|Lz@FAIbpVJE^w7p9}UK)CX^y#n}z<w$L^ED6l2s?WEA=4A&f7OPlP67JsGhe^m$A
z!@1}L0Ae<#kTg5o{)cM<wP)gOvLJ`ga18J^*VrdRV4Y9Ft}t~15d5$B{Ihz{j~ajl
z0QBY3+c<}wUC@6T_hcA}0Ou||d*guLAMWe&q{+==4Z8h%Y>t2qUXD&k^uI|}pxpuh
z<3H2wUu^?)p)BydVE_Q0n-E|b&ewm0=f5iJ{~!86I|)3D7y+!?Nr=J2-$-D*;XJql
z$XkO@ki)vaJm2snLA&Zi|3YVOD2V%d+Kk@!J;3iB!7}_kn)#XKPDlrjzc~l>maSzV
z9_C>axRY=C9ToKVOmM%C;sw5W*X~1>fAp1V$j730b$DOL|GokIzJt%sAQlzoIA}oH
zzN33s7198FspqGbJN?o4br461#--zO7%K|DZP4!wa6g7QY!A_GN5+AkYyG9*y&rzV
z1!{vhYw(=`;{%<fY7y|a_|R`O`0W1>#1sSh;rEP(Vl7e-ir(?yn1;oHILhy-14zgB
zS)?DtUBx`_MDN#4`P0bvk04eG+>JXc=D=MY#NmQCwo!1Wfw7k$p>qV|MBqIH##`q3
zk0IX^C&2GWbt9NsEGT0U7*7Iy9_8<_;668o<b?EsJ8wJep9cZ@{^5Q41Bkb*{xS&8
z*HL6~b``{+_aSLc{oos80lmY*`(r`CB+}osh|*i@@BZF&1W9;0j#MSjB836CyGFX*
z1o|BJWE9j*Ap!CO;Qc#}!a&n6B*_GQXNLkBQpJ&2G>!&$|H8#@;Nns6@g^W{1IA~7
z`wsLsmPO4X74OkGMAs5_;8*9nr?@){{>}jJ2DtkU?w)|&8^B#60^BX&ooQiar4#T*
z*E7gfF_jDGod>>;aQ<kV&l-K-g7*&Yy$gNVQy?x2z32V5jsXn|SRb!Dz5ZUs`S^g3
zZ0%k0{@DzIsX%=(fBDV=G^C(h)yZ?nNAqbw3*5oMoe7qUqp-;2Ai96hbqm+tUnQs$
Xqyr!nK;9a-f&4dl|Ell5QuluV>1G2$

literal 76552
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


From 665ab3dfd0000aa2fbe5a5b0a5caceb32c54a1b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 10 May 2024 10:04:55 +0200
Subject: [PATCH 792/930] Update android icon assets

---
 osu.Android/Resources/drawable/monochrome.xml |  30 ++++--------------
 .../Resources/mipmap-hdpi/ic_launcher.png     | Bin 6403 -> 6088 bytes
 .../mipmap-hdpi/ic_launcher_foreground.png    | Bin 7232 -> 17696 bytes
 .../Resources/mipmap-mdpi/ic_launcher.png     | Bin 3582 -> 3280 bytes
 .../mipmap-mdpi/ic_launcher_foreground.png    | Bin 4040 -> 14331 bytes
 .../Resources/mipmap-xhdpi/ic_launcher.png    | Bin 9537 -> 8745 bytes
 .../mipmap-xhdpi/ic_launcher_foreground.png   | Bin 11248 -> 22749 bytes
 .../Resources/mipmap-xxhdpi/ic_launcher.png   | Bin 16409 -> 15300 bytes
 .../mipmap-xxhdpi/ic_launcher_foreground.png  | Bin 21398 -> 35969 bytes
 .../Resources/mipmap-xxxhdpi/ic_launcher.png  | Bin 25006 -> 22562 bytes
 .../mipmap-xxxhdpi/ic_launcher_foreground.png | Bin 35444 -> 50294 bytes
 11 files changed, 7 insertions(+), 23 deletions(-)

diff --git a/osu.Android/Resources/drawable/monochrome.xml b/osu.Android/Resources/drawable/monochrome.xml
index e12af03bfb..600c070c3e 100644
--- a/osu.Android/Resources/drawable/monochrome.xml
+++ b/osu.Android/Resources/drawable/monochrome.xml
@@ -1,24 +1,8 @@
-<vector xmlns:android="http://schemas.android.com/apk/res/android"
-    android:width="108dp"
-    android:height="108dp"
-    android:viewportWidth="108"
-    android:viewportHeight="108">
-  <path
-      android:pathData="M73.92,44.43C74.82,44.43 75.43,45.1 75.43,46.02V54.54C75.43,55.46 74.82,56.13 73.92,56.13C73,56.13 72.41,55.46 72.41,54.54V46.02C72.41,45.1 73,44.43 73.92,44.43ZM73.92,61.55C72.82,61.55 71.95,60.68 71.95,59.58C71.95,58.51 72.82,57.64 73.92,57.64C75.02,57.64 75.89,58.51 75.89,59.58C75.89,60.68 75.02,61.55 73.92,61.55Z"
-      android:fillColor="#000000"/>
-  <path
-      android:pathData="M68.41,48.55C69.33,48.55 69.92,49.22 69.92,50.11V55.77C69.92,59.94 67.35,61.55 64.22,61.55C61.08,61.55 58.5,59.94 58.5,55.77V50.11C58.5,49.22 59.09,48.55 60.01,48.55C60.91,48.55 61.52,49.22 61.52,50.11V55.56C61.52,57.84 62.48,58.74 64.22,58.74C65.94,58.74 66.9,57.84 66.9,55.56V50.11C66.9,49.22 67.51,48.55 68.41,48.55Z"
-      android:fillColor="#000000"/>
-  <path
-      android:pathData="M49.94,52.01C49.94,52.85 50.81,53.16 52.47,53.54C54.78,54.1 56.98,54.69 56.98,57.53C56.98,60.3 54.93,61.55 51.99,61.55C49.56,61.55 47.79,60.71 46.97,59.73C46.33,58.97 46.41,58.3 47.02,57.71C47.79,56.97 48.46,57.28 48.89,57.66C49.58,58.3 50.43,58.97 52.07,58.97C53.29,58.97 54.06,58.56 54.06,57.74C54.06,56.92 53.24,56.64 51.09,56.05C48.97,55.46 47.08,54.9 47.08,52.36C47.08,49.52 49.38,48.35 51.94,48.35C53.4,48.35 55.06,48.73 56.08,49.83C56.52,50.27 56.85,50.88 56.08,51.72C55.32,52.52 54.75,52.29 54.22,51.88C53.73,51.52 52.88,50.91 51.6,50.91C50.73,50.91 49.94,51.19 49.94,52.01Z"
-      android:fillColor="#000000"/>
-  <path
-      android:pathData="M38.79,61.55C34.9,61.55 32.11,58.74 32.11,54.95C32.11,51.14 34.9,48.35 38.79,48.35C42.68,48.35 45.47,51.14 45.47,54.95C45.47,58.74 42.68,61.55 38.79,61.55ZM38.79,58.74C41.04,58.74 42.45,57.1 42.45,54.95C42.45,52.8 41.04,51.14 38.79,51.14C36.54,51.14 35.13,52.8 35.13,54.95C35.13,57.1 36.54,58.74 38.79,58.74Z"
-      android:fillColor="#000000"/>
-  <path
-      android:pathData="M86,54C86,71.67 71.67,86 54,86C36.33,86 22,71.67 22,54C22,36.33 36.33,22 54,22C71.67,22 86,36.33 86,54ZM25.2,54C25.2,69.91 38.09,82.8 54,82.8C69.91,82.8 82.8,69.91 82.8,54C82.8,38.09 69.91,25.2 54,25.2C38.09,25.2 25.2,38.09 25.2,54Z"
-      android:fillColor="#000000"/>
-  <path
-      android:pathData="M36.78,54.99C36.78,56.09 37.65,56.96 38.75,56.96C39.85,56.96 40.72,56.09 40.72,54.99C40.72,53.91 39.85,53.04 38.75,53.04C37.65,53.04 36.78,53.91 36.78,54.99Z"
-      android:fillColor="#000000"/>
+<vector android:height="108dp" android:viewportHeight="434"
+    android:viewportWidth="434" android:width="108dp" xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="#000000" android:pathData="M299.36,178.05C303.08,178.05 305.62,180.81 305.62,184.62V219.92C305.62,223.74 303.08,226.5 299.36,226.5C295.55,226.5 293.11,223.74 293.11,219.92V184.62C293.11,180.81 295.55,178.05 299.36,178.05ZM299.36,248.97C294.81,248.97 291.2,245.37 291.2,240.81C291.2,236.35 294.81,232.75 299.36,232.75C303.92,232.75 307.53,236.35 307.53,240.81C307.53,245.37 303.92,248.97 299.36,248.97Z"/>
+    <path android:fillColor="#000000" android:pathData="M276.52,195.12C280.34,195.12 282.77,197.87 282.77,201.58V225.01C282.77,242.29 272.12,248.97 259.19,248.97C246.15,248.97 235.49,242.29 235.49,225.01V201.58C235.49,197.87 237.93,195.12 241.75,195.12C245.46,195.12 248,197.87 248,201.58V224.16C248,233.6 251.98,237.31 259.19,237.31C266.29,237.31 270.27,233.6 270.27,224.16V201.58C270.27,197.87 272.81,195.12 276.52,195.12Z"/>
+    <path android:fillColor="#000000" android:pathData="M200.02,209.43C200.02,212.93 203.63,214.2 210.52,215.79C220.06,218.12 229.18,220.56 229.18,232.33C229.18,243.78 220.7,248.97 208.51,248.97C198.43,248.97 191.12,245.47 187.73,241.44C185.08,238.26 185.4,235.51 187.94,233.07C191.12,229.99 193.88,231.27 195.68,232.86C198.54,235.51 202.04,238.26 208.82,238.26C213.91,238.26 217.09,236.57 217.09,233.18C217.09,229.78 213.7,228.62 204.8,226.18C196,223.74 188.15,221.41 188.15,210.91C188.15,199.15 197.69,194.27 208.29,194.27C214.34,194.27 221.23,195.86 225.47,200.42C227.27,202.22 228.65,204.76 225.47,208.26C222.29,211.55 219.96,210.6 217.73,208.9C215.71,207.41 212.22,204.87 206.92,204.87C203.31,204.87 200.02,206.04 200.02,209.43Z"/>
+    <path android:fillColor="#000000" android:pathData="M153.74,248.97C138.46,248.97 127.5,237.27 127.5,221.53C127.5,205.68 138.46,194.09 153.74,194.09C169.03,194.09 179.99,205.68 179.99,221.53C179.99,237.27 169.03,248.97 153.74,248.97ZM153.74,237.27C162.59,237.27 168.12,230.46 168.12,221.53C168.12,212.6 162.59,205.68 153.74,205.68C144.89,205.68 139.36,212.6 139.36,221.53C139.36,230.46 144.89,237.27 153.74,237.27Z"/>
+    <path android:fillColor="#000000" android:pathData="M349,217.5C349,290.13 290.13,349 217.5,349C144.88,349 86,290.13 86,217.5C86,144.88 144.88,86 217.5,86C290.13,86 349,144.88 349,217.5ZM99.15,217.5C99.15,282.86 152.14,335.85 217.5,335.85C282.86,335.85 335.85,282.86 335.85,217.5C335.85,152.14 282.86,99.15 217.5,99.15C152.14,99.15 99.15,152.14 99.15,217.5Z"/>
 </vector>
diff --git a/osu.Android/Resources/mipmap-hdpi/ic_launcher.png b/osu.Android/Resources/mipmap-hdpi/ic_launcher.png
index 7870430484b7a5d9433afea0af2fe479ac0e967c..a1f717cf6c414a2587644f19444e404289b33a16 100644
GIT binary patch
literal 6088
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
O0000<MNUMnLSTY-DO524

literal 6403
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
Rc+vm>002ovPDHLkV1m2~j8Omp

diff --git a/osu.Android/Resources/mipmap-hdpi/ic_launcher_foreground.png b/osu.Android/Resources/mipmap-hdpi/ic_launcher_foreground.png
index b2ec3e49da191d5840d72a7ae2e5421dd468fecf..36651206e8c7c4aed92db0369b84c279ab962465 100644
GIT binary patch
literal 17696
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
KQZ*oxkpBZPcw#^R

literal 7232
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
J)gYU&{{u_AA{+n!

diff --git a/osu.Android/Resources/mipmap-mdpi/ic_launcher.png b/osu.Android/Resources/mipmap-mdpi/ic_launcher.png
index 2a01d8f78115ce669ea5cfe523d8a87dbaa3fbf8..c68ed7a2d5581f653155bcae3b31f653b860ee91 100644
GIT binary patch
delta 3277
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
LNkvXXu0mjfGHE*h

delta 3581
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
D#&zr+

diff --git a/osu.Android/Resources/mipmap-mdpi/ic_launcher_foreground.png b/osu.Android/Resources/mipmap-mdpi/ic_launcher_foreground.png
index e22f2565625261d8ad104f2d09c70ffccb5d2ee8..85f308442952d8b6e5dab778b955d5055e9abeda 100644
GIT binary patch
literal 14331
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

literal 4040
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

diff --git a/osu.Android/Resources/mipmap-xhdpi/ic_launcher.png b/osu.Android/Resources/mipmap-xhdpi/ic_launcher.png
index b5e1a9e3798869f72105dec0643dfe18e8634a54..28be07512ad61c4d8caae199e300b5746ac047b0 100644
GIT binary patch
literal 8745
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
Tsg}M000000NkvXXu0mjff3M09

literal 9537
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

diff --git a/osu.Android/Resources/mipmap-xhdpi/ic_launcher_foreground.png b/osu.Android/Resources/mipmap-xhdpi/ic_launcher_foreground.png
index 1cc3fa9072d0bddb5511ec97d47bd80a7513c78a..613b817f0a54e6a0d14e606d07fe4fa8611554a4 100644
GIT binary patch
literal 22749
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

literal 11248
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

diff --git a/osu.Android/Resources/mipmap-xxhdpi/ic_launcher.png b/osu.Android/Resources/mipmap-xxhdpi/ic_launcher.png
index 8a37b0449edc0cc117c875b33408d618f09328a6..4330a939d9f16d4428d4fa07729c737a67b0cbb4 100644
GIT binary patch
literal 15300
zcmV;#J3GXQP)<h;3K|Lk000e1NJLTq0058x0058(1^@s6=SJeV00009a7bBm000XU
z000XU0RWnu7ytkO0drDELIAGL9O(c600d`2O+f$vv5yP<VFdsHJ6TCYK~#7F?R^QD
zUBz|gxo_{iTdkG^2Jr*}1jt6hEV5bD0unYS!2xVfW)cb8I37EhKsNhJh5(Ln;>^qk
z&SH`eY(x@&HUx|vkO4bJEj9x}Aa;zlmV~6%-uw2JJM~x9satn>y}tKa!W{8<x9_`4
z-Kzhdy-qpwD@N_@?aksVD?Ura=LEGK6Z>53Yu1NlOPt=RzT8ghZ+y1v?~NTD9o_UR
zL=L@=NrUBT@i|jGDgc8|GgX!ZfZUDZ8=rNgK-Ed_Q+i(kNCT!_e3pwx18}l*WRL)p
zBR<6+i|vm06PG&b0i;2*QUj))jtX)+#Q#={&$^?XI~|n(@;Ht2M|9MHrW7eK2_W4^
zM<E?m09v+eSvH@~uX3E&AI0PG=5#tujx#flkjv%dr&uh?Hi-7nG~3fDhNDA>x!aB=
zu5?rY=<Ku4ZcnE(w<HpYb_|f~x+H)^qobpg$z<f<Rg;E>h9ppu$)vnDw`XKzM7Bq?
zlcq<`Y5}DCpe)f5PDeC=gs5s4gLO+ho@h^{QgWa`{FdYG$6(gh)>e%Z4G#}fEEba>
z!FHigFkr%`yzP<V?Y1KsNJk`q036Y@TLeG=AgZgYll!p^(D2_Na3So&n_p>Sz}D2%
z(BR;p1PnM2zyxuIzj?d7?U6vb{zw#UM-+erZnDCucZcXOSX2@m;5yJPKo~&$&3Xq0
z3x8uUZBSK;02X{8wg3`v8U_-$5`(>R?UADGh|-Z_bc9fQ`^C444tj;b!(@vB3=#&9
z^`GGHl_mx*zR?z&@HdOt%8|QDJn=U1qTNbI2+cSL(&Fk~ig5Ztzp%vtbPfy>M2LM1
zlvi+rN)z7;9Fe&VzQKV2DgYa8Lpv+o9&z7Jf#ns?KmU9u%^+3Re6a|=oNRW%-wN>D
zMJ2)uc-z5gFhKm~g9F)C7Y3BAp-L0D4DJVo9__(4i&TIMps7}S#66ou8*W^<@Fb_R
zv$KO{h-QQXDP6~Tm{e?POv1qM8yyr^Jb=|upqXsTkGT$8VE{Y+u7*Aa8W<RmdZ6Hl
zokF~=m<ipe>KsUb=SBgZ@6!b1RCw!IK?Rt2&;TmD<<$fah?RFJ$^b9>r66k2PPC_5
zdKo~A`wHMT7YfBy#~d?nWcTjf&r=ntsvM}jeZ`&P>yK!P!~g<e5NFB@eWbMqZD0#E
z9*^Dm)KgF0L{*}yJn>{i)(2D;5|MxRlhqJu6$g+8&ssWiQY(H{sIwY+QAGhHz_Uby
zr_xDWA5b)PYY=Uu3Q@%zi2^*UJ^;^*Q!~aujKxZ-5LLtq)8K(~u(~GF2NXpaB->@P
zS>Z0~e3i;fWe1Q2o)74VqRN1%tN<zn9*$k%1JhTTn=|GF_q7MxpqXe7`T=dQlhe?S
z%DDr|52CWQG)iGc2f+adg8LtxgHGZoJK{#w^qt_I98U|j2j9_oJa&Mzd~F3_I4r^m
zXn48M7R1`7pOjXT%BonGrAM@>E+XlEg&E+%AfYqRS?D149-{;C_E#ea%EZZF7&H*P
z$!%?IBs{ou!U<Wbudk=(<|djqZyrT;O@DvC`1H}<y?d#vtBW>o-Xi~=Y&Y8B5St5f
zJ`vi5m#czY5g=Mx4ikUc04n9@;oKPv7Q6k;O~qS|&clG>ZL5a(;6Xe8{PXFglTM-~
zOU{(v#~gDEO@{!g&6_t%Fm2qpkzRfERk?30Vu0YK!i!`RXEs(L!=SSqexfn}XazV=
z$iob9aCRQQVK(vGhTkd~&jMEgXfC_#*J<Ixh1Af{K$Ru{>DgzWrDvXbMsh00@p6SY
z0S*8{Ff@udO{5B`x*Iz>)-I)K(6m}NR%{C$0Pe%0D@fov_`Uo9QUkSQ$r4(*a-{?f
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
W+Dai_<Clm40000<MNUMnLSTZ&R)z8a

literal 16409
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

diff --git a/osu.Android/Resources/mipmap-xxhdpi/ic_launcher_foreground.png b/osu.Android/Resources/mipmap-xxhdpi/ic_launcher_foreground.png
index 1b856a31b2e86d2f1ebe55e79debb0ac94f36b23..ec7d60283808e5b9cd2a05d2e24d170027487b20 100644
GIT binary patch
literal 35969
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
F{})kc|3?4-

literal 21398
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
JIpTig{{TBU2Ppsm

diff --git a/osu.Android/Resources/mipmap-xxxhdpi/ic_launcher.png b/osu.Android/Resources/mipmap-xxxhdpi/ic_launcher.png
index 65751e15c9432447c18a4af6a03ec970ad82c945..2e722ee884f65d1932e8cf3683d2b10c28251bda 100644
GIT binary patch
literal 22562
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
JPDHLkV1h{Eakc;e

literal 25006
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
E0Sm8>N&o-=

diff --git a/osu.Android/Resources/mipmap-xxxhdpi/ic_launcher_foreground.png b/osu.Android/Resources/mipmap-xxxhdpi/ic_launcher_foreground.png
index 05c6829a47625e8c647bcd3141594d1d5cea7b3a..f22db0c6168001e8f817147c13be1f55b9689cb0 100644
GIT binary patch
literal 50294
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
b4K6~sK2-DAr_w6ie_ugXMW#&3B>4XTf+;mb

literal 35444
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
Wm9}oz-ruXr00f?{elF{r5}E)w6xqZ8


From ca608a8443cfaa7ac6b8f1204235e750fd9fe89c Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 18:36:44 +0800
Subject: [PATCH 793/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index e784e4e0b2..5452a648d1 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.410.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From 4add1bf8163c4463c296b04cfcddf76b77acbd5e Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 18:38:11 +0800
Subject: [PATCH 794/930] Update metadata assets

---
 assets/lazer-nuget.png | Bin 11930 -> 17094 bytes
 assets/lazer.png       | Bin 328536 -> 448852 bytes
 2 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/assets/lazer-nuget.png b/assets/lazer-nuget.png
index fed2f45149d74aee14421e74fa75dc117469d01a..fabfcc223e742536a3939e4ebbf0187484146450 100644
GIT binary patch
literal 17094
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
BHID!Q

literal 11930
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
b!4O3$rBAdmT`k@`=Kuv673nHTP~iUodp;H%

diff --git a/assets/lazer.png b/assets/lazer.png
index 2ee44225bf02b4bcd19b0f6590f0695027f3f1ee..f564b93d6f58e2e2243b8b07d1f578ff6c8ebbc1 100644
GIT binary patch
literal 448852
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%0D!~I%{lm~n1A3s6Z)B|<re$A?F;{JDEpx8OUn5B
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%0AV1l?--1cn%xmxk
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
XR#}gv+Z#gw^pC#Ib?q`uOvL{IyBilS

literal 328536
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


From b026309e36a2bfec75ecc893016de53472445af4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 20:32:21 +0800
Subject: [PATCH 795/930] Add setting to allow hiding all country flags

There have been enough requests for this at this point to implement it.
---
 osu.Game/Configuration/OsuConfigManager.cs    |  5 ++-
 .../Localisation/OnlineSettingsStrings.cs     |  5 +++
 .../Online/AlertsAndPrivacySettings.cs        |  5 +++
 osu.Game/Users/Drawables/UpdateableFlag.cs    | 31 +++++++++++++++----
 4 files changed, 39 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Configuration/OsuConfigManager.cs b/osu.Game/Configuration/OsuConfigManager.cs
index f4a4c553d8..affcaffe02 100644
--- a/osu.Game/Configuration/OsuConfigManager.cs
+++ b/osu.Game/Configuration/OsuConfigManager.cs
@@ -200,6 +200,8 @@ namespace osu.Game.Configuration
             SetDefault(OsuSetting.EditorLimitedDistanceSnap, false);
             SetDefault(OsuSetting.EditorShowSpeedChanges, false);
 
+            SetDefault(OsuSetting.HideCountryFlags, false);
+
             SetDefault(OsuSetting.MultiplayerRoomFilter, RoomPermissionsFilter.All);
 
             SetDefault(OsuSetting.LastProcessedMetadataId, -1);
@@ -435,6 +437,7 @@ namespace osu.Game.Configuration
         TouchDisableGameplayTaps,
         ModSelectTextSearchStartsActive,
         UserOnlineStatus,
-        MultiplayerRoomFilter
+        MultiplayerRoomFilter,
+        HideCountryFlags,
     }
 }
diff --git a/osu.Game/Localisation/OnlineSettingsStrings.cs b/osu.Game/Localisation/OnlineSettingsStrings.cs
index 0660bac172..8e8c81cf59 100644
--- a/osu.Game/Localisation/OnlineSettingsStrings.cs
+++ b/osu.Game/Localisation/OnlineSettingsStrings.cs
@@ -79,6 +79,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString DiscordPresenceOff => new TranslatableString(getKey(@"discord_presence_off"), @"Off");
 
+        /// <summary>
+        /// "Hide country flags"
+        /// </summary>
+        public static LocalisableString HideCountryFlags => new TranslatableString(getKey(@"hide_country_flags"), @"Hide country flags");
+
         private static string getKey(string key) => $"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs b/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs
index e7b6aa56a8..7bd0829add 100644
--- a/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Online/AlertsAndPrivacySettings.cs
@@ -28,6 +28,11 @@ namespace osu.Game.Overlays.Settings.Sections.Online
                     LabelText = OnlineSettingsStrings.NotifyOnPrivateMessage,
                     Current = config.GetBindable<bool>(OsuSetting.NotifyOnPrivateMessage)
                 },
+                new SettingsCheckbox
+                {
+                    LabelText = OnlineSettingsStrings.HideCountryFlags,
+                    Current = config.GetBindable<bool>(OsuSetting.HideCountryFlags)
+                },
             };
         }
     }
diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index 8f8d7052e5..136478c7bb 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.cs
@@ -3,9 +3,11 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Input.Events;
+using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 
@@ -13,14 +15,20 @@ namespace osu.Game.Users.Drawables
 {
     public partial class UpdateableFlag : ModelBackedDrawable<CountryCode>
     {
+        private CountryCode countryCode;
+
         public CountryCode CountryCode
         {
-            get => Model;
-            set => Model = value;
+            get => countryCode;
+            set
+            {
+                countryCode = value;
+                updateModel();
+            }
         }
 
         /// <summary>
-        /// Whether to show a place holder on unknown country.
+        /// Whether to show a placeholder on unknown country.
         /// </summary>
         public bool ShowPlaceholderOnUnknown = true;
 
@@ -30,9 +38,21 @@ namespace osu.Game.Users.Drawables
         /// </summary>
         public Action? Action;
 
+        private readonly Bindable<bool> hideFlags = new BindableBool();
+
+        [Resolved]
+        private RankingsOverlay? rankingsOverlay { get; set; }
+
         public UpdateableFlag(CountryCode countryCode = CountryCode.Unknown)
         {
             CountryCode = countryCode;
+            hideFlags.BindValueChanged(_ => updateModel());
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager config)
+        {
+            config.BindWith(OsuSetting.HideCountryFlags, hideFlags);
         }
 
         protected override Drawable? CreateDrawable(CountryCode countryCode)
@@ -54,14 +74,13 @@ namespace osu.Game.Users.Drawables
             };
         }
 
-        [Resolved]
-        private RankingsOverlay? rankingsOverlay { get; set; }
-
         protected override bool OnClick(ClickEvent e)
         {
             Action?.Invoke();
             rankingsOverlay?.ShowCountry(CountryCode);
             return true;
         }
+
+        private void updateModel() => Model = hideFlags.Value ? CountryCode.Unknown : countryCode;
     }
 }

From e887f93eca53131304d345517b798421fe363829 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 22:45:59 +0800
Subject: [PATCH 796/930] Always show placeholder on unknown / missing country

---
 osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs         | 1 -
 .../Overlays/BeatmapSet/Scores/TopScoreUserSection.cs     | 1 -
 osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs    | 1 -
 osu.Game/Overlays/Rankings/Tables/RankingsTable.cs        | 1 -
 osu.Game/Users/Drawables/UpdateableFlag.cs                | 8 --------
 5 files changed, 12 deletions(-)

diff --git a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
index 7a817c43eb..a6868efb5d 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/ScoreTable.cs
@@ -160,7 +160,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                 new UpdateableFlag(score.User.CountryCode)
                 {
                     Size = new Vector2(19, 14),
-                    ShowPlaceholderOnUnknown = false,
                 },
                 username,
 #pragma warning disable 618
diff --git a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
index 9dc2ce204f..13ba9fb74b 100644
--- a/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
+++ b/osu.Game/Overlays/BeatmapSet/Scores/TopScoreUserSection.cs
@@ -118,7 +118,6 @@ namespace osu.Game.Overlays.BeatmapSet.Scores
                                 Origin = Anchor.CentreLeft,
                                 Size = new Vector2(19, 14),
                                 Margin = new MarginPadding { Top = 3 }, // makes spacing look more even
-                                ShowPlaceholderOnUnknown = false,
                             },
                         }
                     }
diff --git a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
index c9e5068b2a..165a576c03 100644
--- a/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
+++ b/osu.Game/Overlays/Profile/Header/TopHeaderContainer.cs
@@ -165,7 +165,6 @@ namespace osu.Game.Overlays.Profile.Header
                                                         userFlag = new UpdateableFlag
                                                         {
                                                             Size = new Vector2(28, 20),
-                                                            ShowPlaceholderOnUnknown = false,
                                                         },
                                                         userCountryContainer = new OsuHoverContainer
                                                         {
diff --git a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
index 27d894cdc2..b9f7e443ca 100644
--- a/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
+++ b/osu.Game/Overlays/Rankings/Tables/RankingsTable.cs
@@ -99,7 +99,6 @@ namespace osu.Game.Overlays.Rankings.Tables
                 new UpdateableFlag(GetCountryCode(item))
                 {
                     Size = new Vector2(28, 20),
-                    ShowPlaceholderOnUnknown = false,
                 },
                 CreateFlagContent(item)
             }
diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index 136478c7bb..ac52599bc9 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.cs
@@ -27,11 +27,6 @@ namespace osu.Game.Users.Drawables
             }
         }
 
-        /// <summary>
-        /// Whether to show a placeholder on unknown country.
-        /// </summary>
-        public bool ShowPlaceholderOnUnknown = true;
-
         /// <summary>
         /// Perform an action in addition to showing the country ranking.
         /// This should be used to perform auxiliary tasks and not as a primary action for clicking a flag (to maintain a consistent UX).
@@ -57,9 +52,6 @@ namespace osu.Game.Users.Drawables
 
         protected override Drawable? CreateDrawable(CountryCode countryCode)
         {
-            if (countryCode == CountryCode.Unknown && !ShowPlaceholderOnUnknown)
-                return null;
-
             return new Container
             {
                 RelativeSizeAxes = Axes.Both,

From ea35ad46899b3a11ed026377a351f6f3d46593de Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Fri, 10 May 2024 23:26:43 +0800
Subject: [PATCH 797/930] Fix nullability inspection

---
 osu.Game/Users/Drawables/UpdateableFlag.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Users/Drawables/UpdateableFlag.cs b/osu.Game/Users/Drawables/UpdateableFlag.cs
index ac52599bc9..6a587212a3 100644
--- a/osu.Game/Users/Drawables/UpdateableFlag.cs
+++ b/osu.Game/Users/Drawables/UpdateableFlag.cs
@@ -50,7 +50,7 @@ namespace osu.Game.Users.Drawables
             config.BindWith(OsuSetting.HideCountryFlags, hideFlags);
         }
 
-        protected override Drawable? CreateDrawable(CountryCode countryCode)
+        protected override Drawable CreateDrawable(CountryCode countryCode)
         {
             return new Container
             {

From f64cf5c037f839da3ee3d2a6e686bab1c1bcad0a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 May 2024 09:25:07 +0300
Subject: [PATCH 798/930] Fix button extending beyond unranked indicator width

---
 osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index 08b0407a79..2ceddedeb5 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -73,7 +73,8 @@ namespace osu.Game.Screens.Select.FooterV2
             {
                 UnrankedBadge = new ContainerWithTooltip
                 {
-                    Position = new Vector2(BUTTON_WIDTH + 5f, -5f),
+                    Margin = new MarginPadding { Left = BUTTON_WIDTH + 5f },
+                    Y = -5f,
                     Depth = float.MaxValue,
                     Origin = Anchor.BottomLeft,
                     Shear = barShear,
@@ -233,14 +234,14 @@ namespace osu.Game.Screens.Select.FooterV2
 
                 if (Current.Value.Any(m => !m.Ranked))
                 {
-                    UnrankedBadge.MoveToX(BUTTON_WIDTH + 5, duration, easing);
+                    UnrankedBadge.MoveToX(0, duration, easing);
                     UnrankedBadge.FadeIn(duration, easing);
 
-                    this.ResizeWidthTo(BUTTON_WIDTH + UnrankedBadge.DrawWidth + 10, duration, easing);
+                    this.ResizeWidthTo(BUTTON_WIDTH + 5 + UnrankedBadge.DrawWidth, duration, easing);
                 }
                 else
                 {
-                    UnrankedBadge.MoveToX(BUTTON_WIDTH + 5 - UnrankedBadge.DrawWidth, duration, easing);
+                    UnrankedBadge.MoveToX(-UnrankedBadge.DrawWidth, duration, easing);
                     UnrankedBadge.FadeOut(duration, easing);
 
                     this.ResizeWidthTo(BUTTON_WIDTH, duration, easing);

From da096376af7b84ec7c6590e976a1505ab33a394a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 May 2024 09:31:32 +0300
Subject: [PATCH 799/930] Fix DI error in mod tooltip

---
 .../Screens/Select/FooterV2/FooterButtonModsV2.cs | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index 2ceddedeb5..02eb2028c5 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -267,13 +267,16 @@ namespace osu.Game.Screens.Select.FooterV2
         {
             public readonly Bindable<IReadOnlyList<Mod>> Mods = new Bindable<IReadOnlyList<Mod>>();
 
+            [Resolved]
+            private OverlayColourProvider colourProvider { get; set; } = null!;
+
             protected override void LoadComplete()
             {
                 base.LoadComplete();
                 Mods.BindValueChanged(v => Text = FooterButtonModsV2Strings.Mods(v.NewValue.Count).ToUpper(), true);
             }
 
-            public ITooltip<IReadOnlyList<Mod>> GetCustomTooltip() => new ModTooltip();
+            public ITooltip<IReadOnlyList<Mod>> GetCustomTooltip() => new ModTooltip(colourProvider);
 
             public IReadOnlyList<Mod>? TooltipContent => Mods.Value;
 
@@ -281,8 +284,16 @@ namespace osu.Game.Screens.Select.FooterV2
             {
                 private ModDisplay extendedModDisplay = null!;
 
+                [Cached]
+                private OverlayColourProvider colourProvider;
+
+                public ModTooltip(OverlayColourProvider colourProvider)
+                {
+                    this.colourProvider = colourProvider;
+                }
+
                 [BackgroundDependencyLoader]
-                private void load(OverlayColourProvider colourProvider)
+                private void load()
                 {
                     AutoSizeAxes = Axes.Both;
                     CornerRadius = CORNER_RADIUS;

From ac7598cb6868764478daa50b195e4a39aef7da91 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 May 2024 20:25:47 +0800
Subject: [PATCH 800/930] Move localisation to existing file to avoid silly new
 class

---
 .../Localisation/FooterButtonModsV2Strings.cs | 19 -------------------
 .../Localisation/ModSelectOverlayStrings.cs   |  8 +++++++-
 .../Select/FooterV2/FooterButtonModsV2.cs     |  2 +-
 3 files changed, 8 insertions(+), 21 deletions(-)
 delete mode 100644 osu.Game/Localisation/FooterButtonModsV2Strings.cs

diff --git a/osu.Game/Localisation/FooterButtonModsV2Strings.cs b/osu.Game/Localisation/FooterButtonModsV2Strings.cs
deleted file mode 100644
index 2cb297d8ef..0000000000
--- a/osu.Game/Localisation/FooterButtonModsV2Strings.cs
+++ /dev/null
@@ -1,19 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Localisation;
-
-namespace osu.Game.Localisation
-{
-    public static class FooterButtonModsV2Strings
-    {
-        private const string prefix = @"osu.Game.Resources.Localisation.FooterButtonModsV2";
-
-        /// <summary>
-        /// "{0} mods"
-        /// </summary>
-        public static LocalisableString Mods(int count) => new TranslatableString(getKey(@"mods"), @"{0} mods", count);
-
-        private static string getKey(string key) => $@"{prefix}:{key}";
-    }
-}
diff --git a/osu.Game/Localisation/ModSelectOverlayStrings.cs b/osu.Game/Localisation/ModSelectOverlayStrings.cs
index 7a9bb698d8..cf01081772 100644
--- a/osu.Game/Localisation/ModSelectOverlayStrings.cs
+++ b/osu.Game/Localisation/ModSelectOverlayStrings.cs
@@ -14,10 +14,16 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString ModSelectTitle => new TranslatableString(getKey(@"mod_select_title"), @"Mod Select");
 
+        /// <summary>
+        /// "{0} mods"
+        /// </summary>
+        public static LocalisableString Mods(int count) => new TranslatableString(getKey(@"mods"), @"{0} mods", count);
+
         /// <summary>
         /// "Mods provide different ways to enjoy gameplay. Some have an effect on the score you can achieve during ranked play. Others are just for fun."
         /// </summary>
-        public static LocalisableString ModSelectDescription => new TranslatableString(getKey(@"mod_select_description"), @"Mods provide different ways to enjoy gameplay. Some have an effect on the score you can achieve during ranked play. Others are just for fun.");
+        public static LocalisableString ModSelectDescription => new TranslatableString(getKey(@"mod_select_description"),
+            @"Mods provide different ways to enjoy gameplay. Some have an effect on the score you can achieve during ranked play. Others are just for fun.");
 
         /// <summary>
         /// "Mod Customisation"
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index 02eb2028c5..d0351ac348 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -273,7 +273,7 @@ namespace osu.Game.Screens.Select.FooterV2
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                Mods.BindValueChanged(v => Text = FooterButtonModsV2Strings.Mods(v.NewValue.Count).ToUpper(), true);
+                Mods.BindValueChanged(v => Text = ModSelectOverlayStrings.Mods(v.NewValue.Count).ToUpper(), true);
             }
 
             public ITooltip<IReadOnlyList<Mod>> GetCustomTooltip() => new ModTooltip(colourProvider);

From a988bbd3cb6125c4f300f3d092d32b5e962365dc Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Sat, 11 May 2024 20:58:51 +0800
Subject: [PATCH 801/930] Tidy up `UnrankedBadge` implementation

---
 .../TestSceneFooterButtonModsV2.cs            |  12 +-
 .../Select/FooterV2/FooterButtonModsV2.cs     | 116 +++++++++---------
 2 files changed, 65 insertions(+), 63 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
index af2eea6062..4aca9dde3d 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
@@ -7,7 +7,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
+using osu.Framework.Testing;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Mods;
@@ -97,15 +97,12 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestUnrankedBadge()
         {
             AddStep(@"Add unranked mod", () => changeMods(new[] { new OsuModDeflate() }));
-            AddUntilStep("Unranked badge shown", () => footerButtonMods.UnrankedBadge.Alpha == 1);
+            AddUntilStep("Unranked badge shown", () => footerButtonMods.ChildrenOfType<FooterButtonModsV2.UnrankedBadge>().Single().Alpha == 1);
             AddStep(@"Clear selected mod", () => changeMods(Array.Empty<Mod>()));
-            AddUntilStep("Unranked badge not shown", () => footerButtonMods.UnrankedBadge.Alpha == 0);
+            AddUntilStep("Unranked badge not shown", () => footerButtonMods.ChildrenOfType<FooterButtonModsV2.UnrankedBadge>().Single().Alpha == 0);
         }
 
-        private void changeMods(IReadOnlyList<Mod> mods)
-        {
-            footerButtonMods.Current.Value = mods;
-        }
+        private void changeMods(IReadOnlyList<Mod> mods) => footerButtonMods.Current.Value = mods;
 
         private bool assertModsMultiplier(IEnumerable<Mod> mods)
         {
@@ -117,7 +114,6 @@ namespace osu.Game.Tests.Visual.UserInterface
 
         private partial class TestFooterButtonModsV2 : FooterButtonModsV2
         {
-            public new Container UnrankedBadge => base.UnrankedBadge;
             public new OsuSpriteText MultiplierText => base.MultiplierText;
         }
     }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
index d0351ac348..44db49b927 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
@@ -32,6 +32,11 @@ namespace osu.Game.Screens.Select.FooterV2
     {
         // todo: see https://github.com/ppy/osu-framework/issues/3271
         private const float torus_scale_factor = 1.2f;
+        private const float bar_shear_width = 7f;
+        private const float bar_height = 37f;
+        private const float mod_display_portion = 0.65f;
+
+        private static readonly Vector2 bar_shear = new Vector2(bar_shear_width / bar_height, 0);
 
         private readonly BindableWithCurrent<IReadOnlyList<Mod>> current = new BindableWithCurrent<IReadOnlyList<Mod>>(Array.Empty<Mod>());
 
@@ -43,7 +48,7 @@ namespace osu.Game.Screens.Select.FooterV2
 
         private Container modDisplayBar = null!;
 
-        protected Container UnrankedBadge { get; private set; } = null!;
+        private Drawable unrankedBadge = null!;
 
         private ModDisplay modDisplay = null!;
         private OsuSpriteText modCountText = null!;
@@ -59,58 +64,19 @@ namespace osu.Game.Screens.Select.FooterV2
         [BackgroundDependencyLoader]
         private void load()
         {
-            const float bar_shear_width = 7f;
-            const float bar_height = 37f;
-            const float mod_display_portion = 0.65f;
-
-            var barShear = new Vector2(bar_shear_width / bar_height, 0);
-
             Text = "Mods";
             Icon = FontAwesome.Solid.ExchangeAlt;
             AccentColour = colours.Lime1;
 
             AddRange(new[]
             {
-                UnrankedBadge = new ContainerWithTooltip
-                {
-                    Margin = new MarginPadding { Left = BUTTON_WIDTH + 5f },
-                    Y = -5f,
-                    Depth = float.MaxValue,
-                    Origin = Anchor.BottomLeft,
-                    Shear = barShear,
-                    CornerRadius = CORNER_RADIUS,
-                    AutoSizeAxes = Axes.X,
-                    Height = bar_height,
-                    Masking = true,
-                    BorderColour = Color4.White,
-                    BorderThickness = 2f,
-                    TooltipText = ModSelectOverlayStrings.UnrankedExplanation,
-                    Children = new Drawable[]
-                    {
-                        new Box
-                        {
-                            Colour = colours.Orange2,
-                            RelativeSizeAxes = Axes.Both,
-                        },
-                        new OsuSpriteText
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Shear = -barShear,
-                            Text = ModSelectOverlayStrings.Unranked.ToUpper(),
-                            Margin = new MarginPadding { Horizontal = 15 },
-                            UseFullGlyphHeight = false,
-                            Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
-                            Colour = Color4.Black,
-                        }
-                    }
-                },
+                unrankedBadge = new UnrankedBadge(),
                 modDisplayBar = new Container
                 {
                     Y = -5f,
                     Depth = float.MaxValue,
                     Origin = Anchor.BottomLeft,
-                    Shear = barShear,
+                    Shear = bar_shear,
                     CornerRadius = CORNER_RADIUS,
                     Size = new Vector2(BUTTON_WIDTH, bar_height),
                     Masking = true,
@@ -140,7 +106,7 @@ namespace osu.Game.Screens.Select.FooterV2
                             {
                                 Anchor = Anchor.Centre,
                                 Origin = Anchor.Centre,
-                                Shear = -barShear,
+                                Shear = -bar_shear,
                                 UseFullGlyphHeight = false,
                                 Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold)
                             }
@@ -162,7 +128,7 @@ namespace osu.Game.Screens.Select.FooterV2
                                 {
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
-                                    Shear = -barShear,
+                                    Shear = -bar_shear,
                                     Scale = new Vector2(0.6f),
                                     Current = { BindTarget = Current },
                                     ExpansionMode = ExpansionMode.AlwaysContracted,
@@ -171,7 +137,7 @@ namespace osu.Game.Screens.Select.FooterV2
                                 {
                                     Anchor = Anchor.Centre,
                                     Origin = Anchor.Centre,
-                                    Shear = -barShear,
+                                    Shear = -bar_shear,
                                     Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
                                     Mods = { BindTarget = Current },
                                 }
@@ -216,8 +182,8 @@ namespace osu.Game.Screens.Select.FooterV2
                 modDisplay.FadeOut(duration, easing);
                 modCountText.FadeOut(duration, easing);
 
-                UnrankedBadge.MoveToY(20, duration, easing);
-                UnrankedBadge.FadeOut(duration, easing);
+                unrankedBadge.MoveToY(20, duration, easing);
+                unrankedBadge.FadeOut(duration, easing);
 
                 // add delay to let unranked indicator hide first before resizing the button back to its original width.
                 this.Delay(duration).ResizeWidthTo(BUTTON_WIDTH, duration, easing);
@@ -234,21 +200,21 @@ namespace osu.Game.Screens.Select.FooterV2
 
                 if (Current.Value.Any(m => !m.Ranked))
                 {
-                    UnrankedBadge.MoveToX(0, duration, easing);
-                    UnrankedBadge.FadeIn(duration, easing);
+                    unrankedBadge.MoveToX(0, duration, easing);
+                    unrankedBadge.FadeIn(duration, easing);
 
-                    this.ResizeWidthTo(BUTTON_WIDTH + 5 + UnrankedBadge.DrawWidth, duration, easing);
+                    this.ResizeWidthTo(BUTTON_WIDTH + 5 + unrankedBadge.DrawWidth, duration, easing);
                 }
                 else
                 {
-                    UnrankedBadge.MoveToX(-UnrankedBadge.DrawWidth, duration, easing);
-                    UnrankedBadge.FadeOut(duration, easing);
+                    unrankedBadge.MoveToX(-unrankedBadge.DrawWidth, duration, easing);
+                    unrankedBadge.FadeOut(duration, easing);
 
                     this.ResizeWidthTo(BUTTON_WIDTH, duration, easing);
                 }
 
                 modDisplayBar.MoveToY(-5, duration, Easing.OutQuint);
-                UnrankedBadge.MoveToY(-5, duration, easing);
+                unrankedBadge.MoveToY(-5, duration, easing);
                 modDisplayBar.FadeIn(duration, easing);
             }
 
@@ -327,9 +293,49 @@ namespace osu.Game.Screens.Select.FooterV2
             }
         }
 
-        private partial class ContainerWithTooltip : Container, IHasTooltip
+        internal partial class UnrankedBadge : CompositeDrawable, IHasTooltip
         {
-            public LocalisableString TooltipText { get; set; }
+            public LocalisableString TooltipText { get; }
+
+            public UnrankedBadge()
+            {
+                Margin = new MarginPadding { Left = BUTTON_WIDTH + 5f };
+                Y = -5f;
+                Depth = float.MaxValue;
+                Origin = Anchor.BottomLeft;
+                Shear = bar_shear;
+                CornerRadius = CORNER_RADIUS;
+                AutoSizeAxes = Axes.X;
+                Height = bar_height;
+                Masking = true;
+                BorderColour = Color4.White;
+                BorderThickness = 2f;
+                TooltipText = ModSelectOverlayStrings.UnrankedExplanation;
+            }
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                InternalChildren = new Drawable[]
+                {
+                    new Box
+                    {
+                        Colour = colours.Orange2,
+                        RelativeSizeAxes = Axes.Both,
+                    },
+                    new OsuSpriteText
+                    {
+                        Anchor = Anchor.Centre,
+                        Origin = Anchor.Centre,
+                        Shear = -bar_shear,
+                        Text = ModSelectOverlayStrings.Unranked.ToUpper(),
+                        Margin = new MarginPadding { Horizontal = 15 },
+                        UseFullGlyphHeight = false,
+                        Font = OsuFont.Torus.With(size: 14 * torus_scale_factor, weight: FontWeight.Bold),
+                        Colour = Color4.Black,
+                    }
+                };
+            }
         }
     }
 }

From 4cf6ab40f6534dc0a8f479b3d561b5a3bcd8b403 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 11 May 2024 22:33:18 +0300
Subject: [PATCH 802/930] Use `MustDisposeResource` annotation to appease
 ReSharper inspections

---
 osu.Game/Database/EmptyRealmSet.cs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
index 02dfa50fe5..c34974cb03 100644
--- a/osu.Game/Database/EmptyRealmSet.cs
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -6,6 +6,7 @@ using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.ComponentModel;
+using JetBrains.Annotations;
 using Realms;
 using Realms.Schema;
 
@@ -15,8 +16,12 @@ namespace osu.Game.Database
     {
         private IList<T> emptySet => Array.Empty<T>();
 
+        [MustDisposeResource]
         public IEnumerator<T> GetEnumerator() => emptySet.GetEnumerator();
+
+        [MustDisposeResource]
         IEnumerator IEnumerable.GetEnumerator() => emptySet.GetEnumerator();
+
         public int Count => emptySet.Count;
         public T this[int index] => emptySet[index];
         public int IndexOf(object? item) => item == null ? -1 : emptySet.IndexOf((T)item);

From 5e8f6df79952b26793c4bca8b74cfcdf1c0a90a3 Mon Sep 17 00:00:00 2001
From: Thomas Mok <42684333+tomm13@users.noreply.github.com>
Date: Sun, 12 May 2024 01:55:18 +0100
Subject: [PATCH 803/930] Add glow to footerV2 buttons

---
 osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
index 2c841f6ae6..d856780dfe 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
@@ -5,6 +5,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Effects;
 using osu.Framework.Graphics.Shapes;
@@ -68,6 +69,7 @@ namespace osu.Game.Screens.Select.FooterV2
         protected Container TextContainer;
         private readonly Box bar;
         private readonly Box backgroundBox;
+        private readonly Box glowBox;
 
         public FooterButtonV2()
         {
@@ -93,6 +95,10 @@ namespace osu.Game.Screens.Select.FooterV2
                     {
                         RelativeSizeAxes = Axes.Both
                     },
+                    glowBox = new Box
+                    {
+                        RelativeSizeAxes = Axes.Both
+                    },
                     // For elements that should not be sheared.
                     new Container
                     {
@@ -211,6 +217,7 @@ namespace osu.Game.Screens.Select.FooterV2
             }
 
             backgroundBox.FadeColour(backgroundColour, transition_length, Easing.OutQuint);
+            glowBox.Colour = ColourInfo.GradientVertical(buttonAccentColour.Opacity(0f), buttonAccentColour.Opacity(0.2f));
         }
     }
 }

From fa6ccc854d5324d08baf4e6ee77ce7373d75ef0a Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sun, 12 May 2024 05:24:20 +0300
Subject: [PATCH 804/930] Revert behavioural changes on options button

---
 .../Select/FooterV2/BeatmapOptionsPopover.cs  |  4 +--
 .../Select/FooterV2/FooterButtonOptionsV2.cs  | 31 +------------------
 2 files changed, 2 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs b/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
index 648f536bb1..d98164c306 100644
--- a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
+++ b/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
@@ -188,9 +188,7 @@ namespace osu.Game.Screens.Select.FooterV2
         protected override void UpdateState(ValueChangedEvent<Visibility> state)
         {
             base.UpdateState(state);
-            // intentionally scheduling to let the button have a chance whether the popover will hide from clicking the button or clicking outside
-            // see the "hidingFromClick" field in FooterButtonOptionsV2.
-            Schedule(() => footerButton.OverlayState.Value = state.NewValue);
+            footerButton.OverlayState.Value = state.NewValue;
         }
     }
 }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs b/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
index 2ed8480b46..555215056a 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
+++ b/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
@@ -3,11 +3,9 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
-using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Input.Bindings;
 
@@ -15,11 +13,6 @@ namespace osu.Game.Screens.Select.FooterV2
 {
     public partial class FooterButtonOptionsV2 : FooterButtonV2, IHasPopover
     {
-        /// <summary>
-        /// True if the next click is for hiding the popover.
-        /// </summary>
-        private bool hidingFromClick;
-
         [BackgroundDependencyLoader]
         private void load(OsuColour colour)
         {
@@ -28,29 +21,7 @@ namespace osu.Game.Screens.Select.FooterV2
             AccentColour = colour.Purple1;
             Hotkey = GlobalAction.ToggleBeatmapOptions;
 
-            Action = () =>
-            {
-                if (OverlayState.Value == Visibility.Hidden && !hidingFromClick)
-                    this.ShowPopover();
-
-                hidingFromClick = false;
-            };
-        }
-
-        protected override bool OnMouseDown(MouseDownEvent e)
-        {
-            if (OverlayState.Value == Visibility.Visible)
-                hidingFromClick = true;
-
-            return base.OnMouseDown(e);
-        }
-
-        protected override void Flash()
-        {
-            if (hidingFromClick)
-                return;
-
-            base.Flash();
+            Action = this.ShowPopover;
         }
 
         public Popover GetPopover() => new BeatmapOptionsPopover(this);

From 260c224619289efa6e6f603c8cd8584ad445eeed Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 May 2024 01:23:40 +0900
Subject: [PATCH 805/930] Add failing test

---
 .../TestSceneOsuTouchInput.cs                 | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
index 5bf7c0326a..d3711c0cc6 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
@@ -19,6 +19,7 @@ using osu.Game.Beatmaps.ControlPoints;
 using osu.Game.Configuration;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Objects.Drawables;
+using osu.Game.Rulesets.Osu.UI;
 using osu.Game.Rulesets.Osu.UI.Cursor;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Tests.Visual;
@@ -578,6 +579,25 @@ namespace osu.Game.Rulesets.Osu.Tests
             assertKeyCounter(1, 1);
         }
 
+        [Test]
+        [Solo]
+        public void TestTouchJudgedCircle()
+        {
+            addHitCircleAt(TouchSource.Touch1);
+            addHitCircleAt(TouchSource.Touch2);
+
+            beginTouch(TouchSource.Touch1);
+            endTouch(TouchSource.Touch1);
+
+            // Hold the second touch (this becomes the primary touch).
+            beginTouch(TouchSource.Touch2);
+
+            // Touch again on the first circle.
+            // Because it's been judged, the cursor should not move here.
+            beginTouch(TouchSource.Touch1);
+            checkPosition(TouchSource.Touch2);
+        }
+
         private void addHitCircleAt(TouchSource source)
         {
             AddStep($"Add circle at {source}", () =>
@@ -590,6 +610,7 @@ namespace osu.Game.Rulesets.Osu.Tests
                 {
                     Clock = new FramedClock(new ManualClock()),
                     Position = mainContent.ToLocalSpace(getSanePositionForSource(source)),
+                    CheckHittable = (_, _, _) => ClickAction.Hit
                 });
             });
         }

From ff0c0d54c9127df3006bcb4249fea225d5cc3f6f Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Tue, 14 May 2024 01:23:55 +0900
Subject: [PATCH 806/930] Fix taps on judged circles changing cursor position

---
 osu.Game.Rulesets.Osu/OsuInputManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/OsuInputManager.cs b/osu.Game.Rulesets.Osu/OsuInputManager.cs
index ceac1989a6..65bd585e98 100644
--- a/osu.Game.Rulesets.Osu/OsuInputManager.cs
+++ b/osu.Game.Rulesets.Osu/OsuInputManager.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Rulesets.Osu
             //
             // Based on user feedback of more nuanced scenarios (where touch doesn't behave as expected),
             // this can be expanded to a more complex implementation, but I'd still want to keep it as simple as we can.
-            NonPositionalInputQueue.OfType<DrawableHitCircle.HitReceptor>().Any(c => c.ReceivePositionalInputAt(screenSpacePosition));
+            NonPositionalInputQueue.OfType<DrawableHitCircle.HitReceptor>().Any(c => c.CanBeHit() && c.ReceivePositionalInputAt(screenSpacePosition));
 
         public OsuInputManager(RulesetInfo ruleset)
             : base(ruleset, 0, SimultaneousBindingMode.Unique)

From 20e28964352c140bb71198c4be743b6189a5edfd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 13 May 2024 18:48:08 +0200
Subject: [PATCH 807/930] Remove leftover `[Solo]` attribute

---
 osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
index d3711c0cc6..bf0ab8efa0 100644
--- a/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
+++ b/osu.Game.Rulesets.Osu.Tests/TestSceneOsuTouchInput.cs
@@ -580,7 +580,6 @@ namespace osu.Game.Rulesets.Osu.Tests
         }
 
         [Test]
-        [Solo]
         public void TestTouchJudgedCircle()
         {
             addHitCircleAt(TouchSource.Touch1);

From cfb2c8272b1db1d774678d127a3b2ee70e264b7d Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 13 May 2024 22:56:15 +0800
Subject: [PATCH 808/930] Set a rudimentary lifetime end to improve seek
 performance in scrolling rulesets

---
 .../Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
index 4e72291b9c..e70e181a50 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Rulesets.UI.Scrolling
             // Scroll info is not available until loaded.
             // The lifetime of all entries will be updated in the first Update.
             if (IsLoaded)
-                setComputedLifetimeStart(entry);
+                setComputedLifetime(entry);
 
             base.Add(entry);
         }
@@ -171,7 +171,7 @@ namespace osu.Game.Rulesets.UI.Scrolling
             layoutComputed.Clear();
 
             foreach (var entry in Entries)
-                setComputedLifetimeStart(entry);
+                setComputedLifetime(entry);
 
             algorithm.Value.Reset();
 
@@ -234,12 +234,13 @@ namespace osu.Game.Rulesets.UI.Scrolling
             return algorithm.Value.GetDisplayStartTime(entry.HitObject.StartTime, startOffset, timeRange.Value, scrollLength);
         }
 
-        private void setComputedLifetimeStart(HitObjectLifetimeEntry entry)
+        private void setComputedLifetime(HitObjectLifetimeEntry entry)
         {
             double computedStartTime = computeDisplayStartTime(entry);
 
             // always load the hitobject before its first judgement offset
             entry.LifetimeStart = Math.Min(entry.HitObject.StartTime - entry.HitObject.MaximumJudgementOffset, computedStartTime);
+            entry.LifetimeEnd = entry.HitObject.GetEndTime() + timeRange.Value;
         }
 
         private void updateLayoutRecursive(DrawableHitObject hitObject, double? parentHitObjectStartTime = null)
@@ -261,7 +262,7 @@ namespace osu.Game.Rulesets.UI.Scrolling
 
                 // Nested hitobjects don't need to scroll, but they do need accurate positions and start lifetime
                 updatePosition(obj, hitObject.HitObject.StartTime, parentHitObjectStartTime);
-                setComputedLifetimeStart(obj.Entry);
+                setComputedLifetime(obj.Entry);
             }
         }
 

From 7f3fde2a25d0d78277a6794cc48ec856691e689a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 11:13:06 +0200
Subject: [PATCH 809/930] Add failing test case

---
 .../Visual/Navigation/TestScenePresentScore.cs      | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 004d1de116..212783d047 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -145,6 +145,19 @@ namespace osu.Game.Tests.Visual.Navigation
             presentAndConfirm(secondImport, type);
         }
 
+        [Test]
+        public void TestPresentTwoImportsWithSameOnlineIDButDifferentHashes([Values] ScorePresentType type)
+        {
+            AddStep("enter song select", () => Game.ChildrenOfType<ButtonSystem>().Single().OnSolo?.Invoke());
+            AddUntilStep("song select is current", () => Game.ScreenStack.CurrentScreen is PlaySongSelect songSelect && songSelect.BeatmapSetsLoaded);
+
+            var firstImport = importScore(1);
+            presentAndConfirm(firstImport, type);
+
+            var secondImport = importScore(1);
+            presentAndConfirm(secondImport, type);
+        }
+
         private void returnToMenu()
         {
             // if we don't pause, there's a chance the track may change at the main menu out of our control (due to reaching the end of the track).

From 03a279a48d476b2529d01d975022cb927eb80875 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 11:14:46 +0200
Subject: [PATCH 810/930] Use hash rather than online ID as primary lookup key
 when presenting score

Something I ran into when investigating
https://github.com/ppy/osu/issues/28169.

If there are two scores with the same online ID available in the
database - for instance, one being recorded locally, and one recorded by
spectator server, of one single play - the lookup code would use online
ID first to find the score and pick any first one that matched. This
could lead to the wrong replay being refetched and presented / exported.

(In the case of the aforementioned issue, I was confused as to whether
after restarting spectator server midway through a play and importing
the replay saved by spectator server after the restart, I was seeing a
complete replay with no dropped frames, even though there was nothing in
the code that prevented the frame drop. It turns out that I was getting
presented the locally recorded replay instead all along.)

Instead, jiggle the fallback preference to use hash first.
---
 osu.Game/Scoring/ScoreManager.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 1ba5c7d4cf..0c707ffa19 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -88,15 +88,15 @@ namespace osu.Game.Scoring
         {
             ScoreInfo? databasedScoreInfo = null;
 
+            if (originalScoreInfo is ScoreInfo scoreInfo)
+                databasedScoreInfo = Query(s => s.Hash == scoreInfo.Hash);
+
             if (originalScoreInfo.OnlineID > 0)
-                databasedScoreInfo = Query(s => s.OnlineID == originalScoreInfo.OnlineID);
+                databasedScoreInfo ??= Query(s => s.OnlineID == originalScoreInfo.OnlineID);
 
             if (originalScoreInfo.LegacyOnlineID > 0)
                 databasedScoreInfo ??= Query(s => s.LegacyOnlineID == originalScoreInfo.LegacyOnlineID);
 
-            if (originalScoreInfo is ScoreInfo scoreInfo)
-                databasedScoreInfo ??= Query(s => s.Hash == scoreInfo.Hash);
-
             if (databasedScoreInfo == null)
             {
                 Logger.Log("The requested score could not be found locally.", LoggingTarget.Information);

From 4f6777a0a12fe204a399a19bcc7a1fa54a369f2c Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 16:00:18 +0900
Subject: [PATCH 811/930] Remove existing per-column touch input

---
 osu.Game.Rulesets.Mania/UI/Column.cs | 36 +---------------------------
 1 file changed, 1 insertion(+), 35 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/Column.cs b/osu.Game.Rulesets.Mania/UI/Column.cs
index 6cd55bb099..c05a8f2a29 100644
--- a/osu.Game.Rulesets.Mania/UI/Column.cs
+++ b/osu.Game.Rulesets.Mania/UI/Column.cs
@@ -93,8 +93,7 @@ namespace osu.Game.Rulesets.Mania.UI
                 // For input purposes, the background is added at the highest depth, but is then proxied back below all other elements externally
                 // (see `Stage.columnBackgrounds`).
                 BackgroundContainer,
-                TopLevelContainer,
-                new ColumnTouchInputArea(this)
+                TopLevelContainer
             };
 
             var background = new SkinnableDrawable(new ManiaSkinComponentLookup(ManiaSkinComponents.ColumnBackground), _ => new DefaultColumnBackground())
@@ -181,38 +180,5 @@ namespace osu.Game.Rulesets.Mania.UI
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos)
             // This probably shouldn't exist as is, but the columns in the stage are separated by a 1px border
             => DrawRectangle.Inflate(new Vector2(Stage.COLUMN_SPACING / 2, 0)).Contains(ToLocalSpace(screenSpacePos));
-
-        public partial class ColumnTouchInputArea : Drawable
-        {
-            private readonly Column column;
-
-            [Resolved(canBeNull: true)]
-            private ManiaInputManager maniaInputManager { get; set; }
-
-            private KeyBindingContainer<ManiaAction> keyBindingContainer;
-
-            public ColumnTouchInputArea(Column column)
-            {
-                RelativeSizeAxes = Axes.Both;
-
-                this.column = column;
-            }
-
-            protected override void LoadComplete()
-            {
-                keyBindingContainer = maniaInputManager?.KeyBindingContainer;
-            }
-
-            protected override bool OnTouchDown(TouchDownEvent e)
-            {
-                keyBindingContainer?.TriggerPressed(column.Action.Value);
-                return true;
-            }
-
-            protected override void OnTouchUp(TouchUpEvent e)
-            {
-                keyBindingContainer?.TriggerReleased(column.Action.Value);
-            }
-        }
     }
 }

From ef40197713009fd58c04ddc4f516a6cefd001ed8 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 17:11:15 +0900
Subject: [PATCH 812/930] Add mania touch overlay

Adjust default anchor/origin
---
 osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs  |  20 ++-
 .../UI/ManiaTouchInputOverlay.cs              | 144 ++++++++++++++++++
 2 files changed, 161 insertions(+), 3 deletions(-)
 create mode 100644 osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs

diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
index b3420c49f3..7610e48582 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
@@ -7,6 +7,7 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System;
 using System.Collections.Generic;
+using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Mania.Beatmaps;
@@ -60,10 +61,23 @@ namespace osu.Game.Rulesets.Mania.UI
                 throw new ArgumentException("Can't have zero or fewer stages.");
 
             GridContainer playfieldGrid;
-            AddInternal(playfieldGrid = new GridContainer
+
+            RelativeSizeAxes = Axes.Y;
+            AutoSizeAxes = Axes.X;
+
+            AddRangeInternal(new Drawable[]
             {
-                RelativeSizeAxes = Axes.Both,
-                Content = new[] { new Drawable[stageDefinitions.Count] }
+                playfieldGrid = new GridContainer
+                {
+                    RelativeSizeAxes = Axes.Y,
+                    AutoSizeAxes = Axes.X,
+                    Content = new[] { new Drawable[stageDefinitions.Count] },
+                    ColumnDimensions = Enumerable.Range(0, stageDefinitions.Count).Select(_ => new Dimension(GridSizeMode.AutoSize)).ToArray()
+                },
+                new ManiaTouchInputOverlay
+                {
+                    RelativeSizeAxes = Axes.Both,
+                }
             });
 
             var normalColumnAction = ManiaAction.Key1;
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
new file mode 100644
index 0000000000..476461959d
--- /dev/null
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
@@ -0,0 +1,144 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Input.Events;
+using osu.Game.Configuration;
+using osu.Game.Skinning;
+using osuTK;
+
+namespace osu.Game.Rulesets.Mania.UI
+{
+    public partial class ManiaTouchInputOverlay : CompositeDrawable, ISerialisableDrawable
+    {
+        [SettingSource("Spacing", "The spacing between input receptors.")]
+        public BindableFloat Spacing { get; } = new BindableFloat(10)
+        {
+            Precision = 1,
+            MinValue = 0,
+            MaxValue = 100,
+        };
+
+        [Resolved]
+        private ManiaPlayfield playfield { get; set; } = null!;
+
+        public ManiaTouchInputOverlay()
+        {
+            Anchor = Anchor.BottomCentre;
+            Origin = Anchor.BottomCentre;
+            RelativeSizeAxes = Axes.Both;
+            Height = 0.5f;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            List<Drawable> receptorGridContent = new List<Drawable>();
+            List<Dimension> receptorGridDimensions = new List<Dimension>();
+
+            bool first = true;
+
+            foreach (var stage in playfield.Stages)
+            {
+                foreach (var column in stage.Columns)
+                {
+                    if (!first)
+                    {
+                        receptorGridContent.Add(new Gutter { Spacing = { BindTarget = Spacing } });
+                        receptorGridDimensions.Add(new Dimension(GridSizeMode.AutoSize));
+                    }
+
+                    receptorGridContent.Add(new InputReceptor());
+                    receptorGridDimensions.Add(new Dimension());
+
+                    first = false;
+                }
+            }
+
+            InternalChild = new GridContainer
+            {
+                RelativeSizeAxes = Axes.Both,
+                Content = new[] { receptorGridContent.ToArray() },
+                ColumnDimensions = receptorGridDimensions.ToArray()
+            };
+        }
+
+        public bool UsesFixedAnchor { get; set; }
+
+        public partial class InputReceptor : CompositeDrawable
+        {
+            private readonly Box highlightOverlay;
+
+            public InputReceptor()
+            {
+                RelativeSizeAxes = Axes.Both;
+
+                InternalChildren = new Drawable[]
+                {
+                    new Container
+                    {
+                        RelativeSizeAxes = Axes.Both,
+                        Masking = true,
+                        CornerRadius = 10,
+                        Children = new Drawable[]
+                        {
+                            new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Alpha = 0.15f,
+                            },
+                            highlightOverlay = new Box
+                            {
+                                RelativeSizeAxes = Axes.Both,
+                                Alpha = 0,
+                                Blending = BlendingParameters.Additive,
+                            }
+                        }
+                    }
+                };
+            }
+
+            protected override bool OnTouchDown(TouchDownEvent e)
+            {
+                updateHighlight(true);
+                return true;
+            }
+
+            protected override void OnTouchUp(TouchUpEvent e)
+            {
+                updateHighlight(false);
+            }
+
+            protected override bool OnMouseDown(MouseDownEvent e)
+            {
+                updateHighlight(true);
+                return true;
+            }
+
+            protected override void OnMouseUp(MouseUpEvent e)
+            {
+                updateHighlight(false);
+            }
+
+            private void updateHighlight(bool enabled)
+            {
+                highlightOverlay.FadeTo(enabled ? 0.1f : 0, enabled ? 80 : 400, Easing.OutQuint);
+            }
+        }
+
+        private partial class Gutter : Drawable
+        {
+            public readonly IBindable<float> Spacing = new Bindable<float>();
+
+            public Gutter()
+            {
+                Spacing.BindValueChanged(s => Size = new Vector2(s.NewValue));
+            }
+        }
+    }
+}

From 39337f5189fb371ba91c6b5145374213cbbfba71 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 17:25:05 +0900
Subject: [PATCH 813/930] Hook up input manager

---
 .../UI/ManiaTouchInputOverlay.cs              | 35 +++++++++++++++----
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
index 476461959d..10de89e950 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
@@ -53,7 +53,7 @@ namespace osu.Game.Rulesets.Mania.UI
                         receptorGridDimensions.Add(new Dimension(GridSizeMode.AutoSize));
                     }
 
-                    receptorGridContent.Add(new InputReceptor());
+                    receptorGridContent.Add(new InputReceptor { Action = { BindTarget = column.Action } });
                     receptorGridDimensions.Add(new Dimension());
 
                     first = false;
@@ -72,8 +72,15 @@ namespace osu.Game.Rulesets.Mania.UI
 
         public partial class InputReceptor : CompositeDrawable
         {
+            public readonly IBindable<ManiaAction> Action = new Bindable<ManiaAction>();
+
             private readonly Box highlightOverlay;
 
+            [Resolved]
+            private ManiaInputManager? inputManager { get; set; }
+
+            private bool isPressed;
+
             public InputReceptor()
             {
                 RelativeSizeAxes = Axes.Both;
@@ -105,29 +112,43 @@ namespace osu.Game.Rulesets.Mania.UI
 
             protected override bool OnTouchDown(TouchDownEvent e)
             {
-                updateHighlight(true);
+                updateButton(true);
                 return true;
             }
 
             protected override void OnTouchUp(TouchUpEvent e)
             {
-                updateHighlight(false);
+                updateButton(false);
             }
 
             protected override bool OnMouseDown(MouseDownEvent e)
             {
-                updateHighlight(true);
+                updateButton(true);
                 return true;
             }
 
             protected override void OnMouseUp(MouseUpEvent e)
             {
-                updateHighlight(false);
+                updateButton(false);
             }
 
-            private void updateHighlight(bool enabled)
+            private void updateButton(bool press)
             {
-                highlightOverlay.FadeTo(enabled ? 0.1f : 0, enabled ? 80 : 400, Easing.OutQuint);
+                if (press == isPressed)
+                    return;
+
+                isPressed = press;
+
+                if (press)
+                {
+                    inputManager?.KeyBindingContainer?.TriggerPressed(Action.Value);
+                    highlightOverlay.FadeTo(0.1f, 80, Easing.OutQuint);
+                }
+                else
+                {
+                    inputManager?.KeyBindingContainer?.TriggerReleased(Action.Value);
+                    highlightOverlay.FadeTo(0, 400, Easing.OutQuint);
+                }
             }
         }
 

From e3f2e1ba08c79e01b9dc9a0d76ff9bf21f41c32e Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 18:20:30 +0900
Subject: [PATCH 814/930] Add opacity setting

---
 .../UI/ManiaTouchInputOverlay.cs                 | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
index 10de89e950..ddff064133 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
@@ -16,7 +16,7 @@ namespace osu.Game.Rulesets.Mania.UI
 {
     public partial class ManiaTouchInputOverlay : CompositeDrawable, ISerialisableDrawable
     {
-        [SettingSource("Spacing", "The spacing between input receptors.")]
+        [SettingSource("Spacing", "The spacing between receptors.")]
         public BindableFloat Spacing { get; } = new BindableFloat(10)
         {
             Precision = 1,
@@ -24,6 +24,14 @@ namespace osu.Game.Rulesets.Mania.UI
             MaxValue = 100,
         };
 
+        [SettingSource("Opacity", "The receptor opacity.")]
+        public BindableFloat Opacity { get; } = new BindableFloat(1)
+        {
+            Precision = 0.1f,
+            MinValue = 0,
+            MaxValue = 1
+        };
+
         [Resolved]
         private ManiaPlayfield playfield { get; set; } = null!;
 
@@ -68,6 +76,12 @@ namespace osu.Game.Rulesets.Mania.UI
             };
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+            Opacity.BindValueChanged(o => Alpha = o.NewValue, true);
+        }
+
         public bool UsesFixedAnchor { get; set; }
 
         public partial class InputReceptor : CompositeDrawable

From a761a7bced2deacea3f7ee9c2e765c59e7cd0670 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 4 Apr 2024 18:20:51 +0900
Subject: [PATCH 815/930] Hook up touch device mod

---
 .../Mods/TestSceneModTouchDevice.cs           | 64 +++++++++++++++++++
 osu.Game.Rulesets.Mania/ManiaRuleset.cs       |  8 +++
 osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs  | 14 +++-
 3 files changed, 84 insertions(+), 2 deletions(-)
 create mode 100644 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
new file mode 100644
index 0000000000..4c5e4933ef
--- /dev/null
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
@@ -0,0 +1,64 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Linq;
+using NUnit.Framework;
+using osu.Framework.Graphics;
+using osu.Framework.Input;
+using osu.Framework.Testing;
+using osu.Game.Rulesets.Mania.UI;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Skinning;
+using osu.Game.Tests.Visual;
+
+namespace osu.Game.Rulesets.Mania.Tests.Mods
+{
+    public partial class TestSceneModTouchDevice : ModTestScene
+    {
+        protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
+
+        [Test]
+        public void TestOverlayVisibleWithMod() => CreateModTest(new ModTestData
+        {
+            Mod = new ModTouchDevice(),
+            Autoplay = false,
+            PassCondition = () => getSkinnableOverlay()?.IsPresent == true
+        });
+
+        [Test]
+        public void TestOverlayNotVisibleWithoutMod() => CreateModTest(new ModTestData
+        {
+            Autoplay = false,
+            PassCondition = () => getSkinnableOverlay()?.IsPresent == false
+        });
+
+        [Test]
+        public void TestPressReceptors()
+        {
+            CreateModTest(new ModTestData
+            {
+                Mod = new ModTouchDevice(),
+                Autoplay = false,
+                PassCondition = () => true
+            });
+
+            for (int i = 0; i < 4; i++)
+            {
+                int index = i;
+
+                AddStep($"touch receptor {index}", () => InputManager.BeginTouch(new Touch(TouchSource.Touch1, getReceptor(index).ScreenSpaceDrawQuad.Centre)));
+
+                AddAssert("action sent",
+                    () => this.ChildrenOfType<ManiaInputManager>().SelectMany(m => m.KeyBindingContainer.PressedActions),
+                    () => Does.Contain(getReceptor(index).Action.Value));
+
+                AddStep($"release receptor {index}", () => InputManager.EndTouch(new Touch(TouchSource.Touch1, getReceptor(index).ScreenSpaceDrawQuad.Centre)));
+            }
+        }
+
+        private Drawable? getSkinnableOverlay() => this.ChildrenOfType<SkinnableDrawable>()
+                                                       .SingleOrDefault(d => d.Lookup.Equals(new ManiaSkinComponentLookup(ManiaSkinComponents.TouchOverlay)));
+
+        private ManiaTouchInputOverlay.InputReceptor getReceptor(int index) => this.ChildrenOfType<ManiaTouchInputOverlay.InputReceptor>().ElementAt(index);
+    }
+}
diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index b5614e2b56..23004e36a0 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -163,6 +163,9 @@ namespace osu.Game.Rulesets.Mania
 
             if (mods.HasFlagFast(LegacyMods.ScoreV2))
                 yield return new ModScoreV2();
+
+            if (mods.HasFlagFast(LegacyMods.TouchDevice))
+                yield return new ModTouchDevice();
         }
 
         public override LegacyMods ConvertToLegacyMods(Mod[] mods)
@@ -225,6 +228,10 @@ namespace osu.Game.Rulesets.Mania
                     case ManiaModRandom:
                         value |= LegacyMods.Random;
                         break;
+
+                    case ModTouchDevice:
+                        value |= LegacyMods.TouchDevice;
+                        break;
                 }
             }
 
@@ -296,6 +303,7 @@ namespace osu.Game.Rulesets.Mania
                 case ModType.System:
                     return new Mod[]
                     {
+                        new ModTouchDevice(),
                         new ModScoreV2(),
                     };
 
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
index 7610e48582..385a47f8b8 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
@@ -12,6 +12,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
+using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI.Scrolling;
@@ -26,6 +27,8 @@ namespace osu.Game.Rulesets.Mania.UI
 
         private readonly List<Stage> stages = new List<Stage>();
 
+        private readonly ManiaTouchInputOverlay touchOverlay;
+
         public override Quad SkinnableComponentScreenSpaceDrawQuad
         {
             get
@@ -74,9 +77,9 @@ namespace osu.Game.Rulesets.Mania.UI
                     Content = new[] { new Drawable[stageDefinitions.Count] },
                     ColumnDimensions = Enumerable.Range(0, stageDefinitions.Count).Select(_ => new Dimension(GridSizeMode.AutoSize)).ToArray()
                 },
-                new ManiaTouchInputOverlay
+                touchOverlay = new ManiaTouchInputOverlay
                 {
-                    RelativeSizeAxes = Axes.Both,
+                    RelativeSizeAxes = Axes.Both
                 }
             });
 
@@ -97,6 +100,13 @@ namespace osu.Game.Rulesets.Mania.UI
             }
         }
 
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            touchOverlay.Alpha = Mods?.Any(m => m is ModTouchDevice) == true ? 1 : 0;
+        }
+
         public override void Add(HitObject hitObject) => getStageByColumn(((ManiaHitObject)hitObject).Column).Add(hitObject);
 
         public override bool Remove(HitObject hitObject) => getStageByColumn(((ManiaHitObject)hitObject).Column).Remove(hitObject);

From cb49147d1e17d14c8b6a63c5a2e3b535a36f57a9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 12:57:30 +0200
Subject: [PATCH 816/930] Apply NRT to `ScorePanelList`

---
 osu.Game/Screens/Ranking/ResultsScreen.cs  |  2 ++
 osu.Game/Screens/Ranking/ScorePanelList.cs | 19 +++++++------------
 2 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ResultsScreen.cs b/osu.Game/Screens/Ranking/ResultsScreen.cs
index 1c3518909d..44b270db53 100644
--- a/osu.Game/Screens/Ranking/ResultsScreen.cs
+++ b/osu.Game/Screens/Ranking/ResultsScreen.cs
@@ -3,6 +3,7 @@
 
 using System;
 using System.Collections.Generic;
+using System.Diagnostics;
 using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -329,6 +330,7 @@ namespace osu.Game.Screens.Ranking
         {
             if (state.NewValue == Visibility.Visible)
             {
+                Debug.Assert(SelectedScore.Value != null);
                 // Detach the panel in its original location, and move into the desired location in the local container.
                 var expandedPanel = ScorePanelList.GetPanelForScore(SelectedScore.Value);
                 var screenSpacePos = expandedPanel.ScreenSpaceDrawQuad.TopLeft;
diff --git a/osu.Game/Screens/Ranking/ScorePanelList.cs b/osu.Game/Screens/Ranking/ScorePanelList.cs
index 95c90e35a0..e711bed729 100644
--- a/osu.Game/Screens/Ranking/ScorePanelList.cs
+++ b/osu.Game/Screens/Ranking/ScorePanelList.cs
@@ -1,14 +1,11 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Diagnostics;
 using System.Linq;
 using System.Threading;
-using JetBrains.Annotations;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -64,14 +61,14 @@ namespace osu.Game.Screens.Ranking
         /// <summary>
         /// An action to be invoked if a <see cref="ScorePanel"/> is clicked while in an expanded state.
         /// </summary>
-        public Action PostExpandAction;
+        public Action? PostExpandAction;
 
-        public readonly Bindable<ScoreInfo> SelectedScore = new Bindable<ScoreInfo>();
+        public readonly Bindable<ScoreInfo?> SelectedScore = new Bindable<ScoreInfo?>();
 
         private readonly CancellationTokenSource loadCancellationSource = new CancellationTokenSource();
         private readonly Flow flow;
         private readonly Scroll scroll;
-        private ScorePanel expandedPanel;
+        private ScorePanel? expandedPanel;
 
         /// <summary>
         /// Creates a new <see cref="ScorePanelList"/>.
@@ -174,7 +171,7 @@ namespace osu.Game.Screens.Ranking
         /// Brings a <see cref="ScoreInfo"/> to the centre of the screen and expands it.
         /// </summary>
         /// <param name="score">The <see cref="ScoreInfo"/> to present.</param>
-        private void selectedScoreChanged(ValueChangedEvent<ScoreInfo> score)
+        private void selectedScoreChanged(ValueChangedEvent<ScoreInfo?> score)
         {
             // avoid contracting panels unnecessarily when TriggerChange is fired manually.
             if (score.OldValue != null && !score.OldValue.Equals(score.NewValue))
@@ -317,7 +314,7 @@ namespace osu.Game.Screens.Ranking
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
-            loadCancellationSource?.Cancel();
+            loadCancellationSource.Cancel();
         }
 
         private partial class Flow : FillFlowContainer<ScorePanelTrackingContainer>
@@ -326,11 +323,9 @@ namespace osu.Game.Screens.Ranking
 
             public int GetPanelIndex(ScoreInfo score) => applySorting(Children).TakeWhile(s => !s.Panel.Score.Equals(score)).Count();
 
-            [CanBeNull]
-            public ScoreInfo GetPreviousScore(ScoreInfo score) => applySorting(Children).TakeWhile(s => !s.Panel.Score.Equals(score)).LastOrDefault()?.Panel.Score;
+            public ScoreInfo? GetPreviousScore(ScoreInfo score) => applySorting(Children).TakeWhile(s => !s.Panel.Score.Equals(score)).LastOrDefault()?.Panel.Score;
 
-            [CanBeNull]
-            public ScoreInfo GetNextScore(ScoreInfo score) => applySorting(Children).SkipWhile(s => !s.Panel.Score.Equals(score)).ElementAtOrDefault(1)?.Panel.Score;
+            public ScoreInfo? GetNextScore(ScoreInfo score) => applySorting(Children).SkipWhile(s => !s.Panel.Score.Equals(score)).ElementAtOrDefault(1)?.Panel.Score;
 
             private IEnumerable<ScorePanelTrackingContainer> applySorting(IEnumerable<Drawable> drawables) => drawables.OfType<ScorePanelTrackingContainer>()
                                                                                                                        .OrderByDescending(GetLayoutPosition)

From 10a8e84046ac4e8abb06e44ab112e2b3274bb2d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:01:26 +0200
Subject: [PATCH 817/930] Apply NRT to `StatisticsPanel`

---
 .../Ranking/Statistics/StatisticsPanel.cs       | 17 +++++++----------
 1 file changed, 7 insertions(+), 10 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
index 19bd0c4393..f9f5254bc2 100644
--- a/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
+++ b/osu.Game/Screens/Ranking/Statistics/StatisticsPanel.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
@@ -28,19 +26,20 @@ namespace osu.Game.Screens.Ranking.Statistics
     {
         public const float SIDE_PADDING = 30;
 
-        public readonly Bindable<ScoreInfo> Score = new Bindable<ScoreInfo>();
+        public readonly Bindable<ScoreInfo?> Score = new Bindable<ScoreInfo?>();
 
         protected override bool StartHidden => true;
 
         [Resolved]
-        private BeatmapManager beatmapManager { get; set; }
+        private BeatmapManager beatmapManager { get; set; } = null!;
 
         private readonly Container content;
         private readonly LoadingSpinner spinner;
 
         private bool wasOpened;
-        private Sample popInSample;
-        private Sample popOutSample;
+        private Sample? popInSample;
+        private Sample? popOutSample;
+        private CancellationTokenSource? loadCancellation;
 
         public StatisticsPanel()
         {
@@ -71,9 +70,7 @@ namespace osu.Game.Screens.Ranking.Statistics
             popOutSample = audio.Samples.Get(@"Results/statistics-panel-pop-out");
         }
 
-        private CancellationTokenSource loadCancellation;
-
-        private void populateStatistics(ValueChangedEvent<ScoreInfo> score)
+        private void populateStatistics(ValueChangedEvent<ScoreInfo?> score)
         {
             loadCancellation?.Cancel();
             loadCancellation = null;
@@ -187,7 +184,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
                 LoadComponentAsync(container, d =>
                 {
-                    if (!Score.Value.Equals(newScore))
+                    if (Score.Value?.Equals(newScore) != true)
                         return;
 
                     spinner.Hide();

From 77a7f475ee25314cc7d68e612f8bfbf2beae2ace Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:03:46 +0200
Subject: [PATCH 818/930] Apply NRT to `ScorePanel`

---
 osu.Game/Screens/Ranking/ScorePanel.cs | 34 ++++++++++++--------------
 1 file changed, 15 insertions(+), 19 deletions(-)

diff --git a/osu.Game/Screens/Ranking/ScorePanel.cs b/osu.Game/Screens/Ranking/ScorePanel.cs
index 1f7ba3692a..e283749e32 100644
--- a/osu.Game/Screens/Ranking/ScorePanel.cs
+++ b/osu.Game/Screens/Ranking/ScorePanel.cs
@@ -1,10 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
-using JetBrains.Annotations;
 using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -83,8 +80,7 @@ namespace osu.Game.Screens.Ranking
         private static readonly Color4 contracted_top_layer_colour = Color4Extensions.FromHex("#353535");
         private static readonly Color4 contracted_middle_layer_colour = Color4Extensions.FromHex("#353535");
 
-        [CanBeNull]
-        public event Action<PanelState> StateChanged;
+        public event Action<PanelState>? StateChanged;
 
         /// <summary>
         /// The position of the score in the rankings.
@@ -94,28 +90,30 @@ namespace osu.Game.Screens.Ranking
         /// <summary>
         /// An action to be invoked if this <see cref="ScorePanel"/> is clicked while in an expanded state.
         /// </summary>
-        public Action PostExpandAction;
+        public Action? PostExpandAction;
 
         public readonly ScoreInfo Score;
 
         [Resolved]
-        private OsuGameBase game { get; set; }
+        private OsuGameBase game { get; set; } = null!;
 
-        private AudioContainer audioContent;
+        private AudioContainer audioContent = null!;
 
         private bool displayWithFlair;
 
-        private Container topLayerContainer;
-        private Drawable topLayerBackground;
-        private Container topLayerContentContainer;
-        private Drawable topLayerContent;
+        private Container topLayerContainer = null!;
+        private Drawable topLayerBackground = null!;
+        private Container topLayerContentContainer = null!;
+        private Drawable? topLayerContent;
 
-        private Container middleLayerContainer;
-        private Drawable middleLayerBackground;
-        private Container middleLayerContentContainer;
-        private Drawable middleLayerContent;
+        private Container middleLayerContainer = null!;
+        private Drawable middleLayerBackground = null!;
+        private Container middleLayerContentContainer = null!;
+        private Drawable? middleLayerContent;
 
-        private DrawableSample samplePanelFocus;
+        private ScorePanelTrackingContainer? trackingContainer;
+
+        private DrawableSample? samplePanelFocus;
 
         public ScorePanel(ScoreInfo score, bool isNewLocalScore = false)
         {
@@ -334,8 +332,6 @@ namespace osu.Game.Screens.Ranking
                || topLayerContainer.ReceivePositionalInputAt(screenSpacePos)
                || middleLayerContainer.ReceivePositionalInputAt(screenSpacePos);
 
-        private ScorePanelTrackingContainer trackingContainer;
-
         /// <summary>
         /// Creates a <see cref="ScorePanelTrackingContainer"/> which this <see cref="ScorePanel"/> can reside inside.
         /// The <see cref="ScorePanelTrackingContainer"/> will track the size of this <see cref="ScorePanel"/>.

From 2f2257f6cec8254ca48432d6811a0cb823f0364c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:07:49 +0200
Subject: [PATCH 819/930] Apply NRT to `PerformanceBreakdownChart`

---
 .../Statistics/PerformanceBreakdownChart.cs   | 22 ++++++++-----------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
index 8b13f0951c..b5eed2d12a 100644
--- a/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
+++ b/osu.Game/Screens/Ranking/Statistics/PerformanceBreakdownChart.cs
@@ -1,13 +1,10 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
@@ -31,16 +28,16 @@ namespace osu.Game.Screens.Ranking.Statistics
         private readonly ScoreInfo score;
         private readonly IBeatmap playableBeatmap;
 
-        private Drawable spinner;
-        private Drawable content;
-        private GridContainer chart;
-        private OsuSpriteText achievedPerformance;
-        private OsuSpriteText maximumPerformance;
+        private Drawable spinner = null!;
+        private Drawable content = null!;
+        private GridContainer chart = null!;
+        private OsuSpriteText achievedPerformance = null!;
+        private OsuSpriteText maximumPerformance = null!;
 
         private readonly CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
 
         [Resolved]
-        private BeatmapDifficultyCache difficultyCache { get; set; }
+        private BeatmapDifficultyCache difficultyCache { get; set; } = null!;
 
         public PerformanceBreakdownChart(ScoreInfo score, IBeatmap playableBeatmap)
         {
@@ -147,7 +144,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
             new PerformanceBreakdownCalculator(playableBeatmap, difficultyCache)
                 .CalculateAsync(score, cancellationTokenSource.Token)
-                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely())));
+                .ContinueWith(t => Schedule(() => setPerformanceValue(t.GetResultSafely()!)));
         }
 
         private void setPerformanceValue(PerformanceBreakdown breakdown)
@@ -189,8 +186,7 @@ namespace osu.Game.Screens.Ranking.Statistics
             maximumPerformance.Text = Math.Round(perfectAttribute.Value, MidpointRounding.AwayFromZero).ToLocalisableString();
         }
 
-        [CanBeNull]
-        private Drawable[] createAttributeRow(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
+        private Drawable[]? createAttributeRow(PerformanceDisplayAttribute attribute, PerformanceDisplayAttribute perfectAttribute)
         {
             // Don't display the attribute if its maximum is 0
             // For example, flashlight bonus would be zero if flashlight mod isn't on
@@ -239,7 +235,7 @@ namespace osu.Game.Screens.Ranking.Statistics
 
         protected override void Dispose(bool isDisposing)
         {
-            cancellationTokenSource?.Cancel();
+            cancellationTokenSource.Cancel();
             base.Dispose(isDisposing);
         }
     }

From 237ae8b46a2c66af53a350e6972696d2cda79686 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:09:57 +0200
Subject: [PATCH 820/930] Apply NRT to `SimpleStatisticsItem`

---
 osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs
index 23ccc3d0b7..d8de1b07b5 100644
--- a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs
+++ b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticItem.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics;
@@ -61,7 +59,7 @@ namespace osu.Game.Screens.Ranking.Statistics
     /// </summary>
     public partial class SimpleStatisticItem<TValue> : SimpleStatisticItem
     {
-        private TValue value;
+        private TValue value = default!;
 
         /// <summary>
         /// The statistic's value to be displayed.
@@ -80,7 +78,7 @@ namespace osu.Game.Screens.Ranking.Statistics
         /// Used to convert <see cref="Value"/> to a text representation.
         /// Defaults to using <see cref="object.ToString"/>.
         /// </summary>
-        protected virtual string DisplayValue(TValue value) => value.ToString();
+        protected virtual string DisplayValue(TValue value) => value!.ToString() ?? string.Empty;
 
         public SimpleStatisticItem(string name)
             : base(name)

From 8e16b57d09663ecfd310487bb58db523b533e4b7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:10:36 +0200
Subject: [PATCH 821/930] Apply NRT to `SimpleStatisticTable`

---
 .../Screens/Ranking/Statistics/SimpleStatisticTable.cs     | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
index 4abf0007a7..da79fdb12b 100644
--- a/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
+++ b/osu.Game/Screens/Ranking/Statistics/SimpleStatisticTable.cs
@@ -1,12 +1,9 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
-using JetBrains.Annotations;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
@@ -24,14 +21,14 @@ namespace osu.Game.Screens.Ranking.Statistics
         private readonly SimpleStatisticItem[] items;
         private readonly int columnCount;
 
-        private FillFlowContainer[] columns;
+        private FillFlowContainer[] columns = null!;
 
         /// <summary>
         /// Creates a statistic row for the supplied <see cref="SimpleStatisticItem"/>s.
         /// </summary>
         /// <param name="columnCount">The number of columns to layout the <paramref name="items"/> into.</param>
         /// <param name="items">The <see cref="SimpleStatisticItem"/>s to display in this row.</param>
-        public SimpleStatisticTable(int columnCount, [ItemNotNull] IEnumerable<SimpleStatisticItem> items)
+        public SimpleStatisticTable(int columnCount, IEnumerable<SimpleStatisticItem> items)
         {
             ArgumentOutOfRangeException.ThrowIfNegativeOrZero(columnCount);
 

From e7721b073cbd09651b48b9253e2d7d963339f5e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:11:21 +0200
Subject: [PATCH 822/930] Apply NRT to `ContractedPanelTopContent`

---
 .../Screens/Ranking/Contracted/ContractedPanelTopContent.cs   | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
index 93bc7c41e1..06d127b972 100644
--- a/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
+++ b/osu.Game/Screens/Ranking/Contracted/ContractedPanelTopContent.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -16,7 +14,7 @@ namespace osu.Game.Screens.Ranking.Contracted
     {
         public readonly Bindable<int?> ScorePosition = new Bindable<int?>();
 
-        private OsuSpriteText text;
+        private OsuSpriteText text = null!;
 
         public ContractedPanelTopContent()
         {

From ced1c79490f61b6d203d3777c740139e1cd7ff51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:14:52 +0200
Subject: [PATCH 823/930] Apply NRT to `AccuracyCircle`

---
 .../Expanded/Accuracy/AccuracyCircle.cs       | 42 +++++++++----------
 1 file changed, 20 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
index f04e4a6444..cebc54f490 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/AccuracyCircle.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -93,17 +91,17 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
 
         private readonly ScoreInfo score;
 
-        private CircularProgress accuracyCircle;
-        private GradedCircles gradedCircles;
-        private Container<RankBadge> badges;
-        private RankText rankText;
+        private CircularProgress accuracyCircle = null!;
+        private GradedCircles gradedCircles = null!;
+        private Container<RankBadge> badges = null!;
+        private RankText rankText = null!;
 
-        private PoolableSkinnableSample scoreTickSound;
-        private PoolableSkinnableSample badgeTickSound;
-        private PoolableSkinnableSample badgeMaxSound;
-        private PoolableSkinnableSample swooshUpSound;
-        private PoolableSkinnableSample rankImpactSound;
-        private PoolableSkinnableSample rankApplauseSound;
+        private PoolableSkinnableSample? scoreTickSound;
+        private PoolableSkinnableSample? badgeTickSound;
+        private PoolableSkinnableSample? badgeMaxSound;
+        private PoolableSkinnableSample? swooshUpSound;
+        private PoolableSkinnableSample? rankImpactSound;
+        private PoolableSkinnableSample? rankApplauseSound;
 
         private readonly Bindable<double> tickPlaybackRate = new Bindable<double>();
 
@@ -119,7 +117,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
         private readonly bool withFlair;
 
         private readonly bool isFailedSDueToMisses;
-        private RankText failedSRankText;
+        private RankText failedSRankText = null!;
 
         public AccuracyCircle(ScoreInfo score, bool withFlair = false)
         {
@@ -229,8 +227,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
 
                 this.Delay(swoosh_pre_delay).Schedule(() =>
                 {
-                    swooshUpSound.VolumeTo(swoosh_volume);
-                    swooshUpSound.Play();
+                    swooshUpSound!.VolumeTo(swoosh_volume);
+                    swooshUpSound!.Play();
                 });
             }
 
@@ -287,8 +285,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                         this.TransformBindableTo(tickPlaybackRate, score_tick_debounce_rate_start);
                         this.TransformBindableTo(tickPlaybackRate, score_tick_debounce_rate_end, ACCURACY_TRANSFORM_DURATION, Easing.OutSine);
 
-                        scoreTickSound.FrequencyTo(1 + targetAccuracy, ACCURACY_TRANSFORM_DURATION, Easing.OutSine);
-                        scoreTickSound.VolumeTo(score_tick_volume_start).Then().VolumeTo(score_tick_volume_end, ACCURACY_TRANSFORM_DURATION, Easing.OutSine);
+                        scoreTickSound!.FrequencyTo(1 + targetAccuracy, ACCURACY_TRANSFORM_DURATION, Easing.OutSine);
+                        scoreTickSound!.VolumeTo(score_tick_volume_start).Then().VolumeTo(score_tick_volume_end, ACCURACY_TRANSFORM_DURATION, Easing.OutSine);
 
                         isTicking = true;
                     });
@@ -314,8 +312,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                                 {
                                     var dink = badgeNum < badges.Count - 1 ? badgeTickSound : badgeMaxSound;
 
-                                    dink.FrequencyTo(1 + badgeNum++ * 0.05);
-                                    dink.Play();
+                                    dink!.FrequencyTo(1 + badgeNum++ * 0.05);
+                                    dink!.Play();
                                 });
                             }
                         }
@@ -331,7 +329,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                         Schedule(() =>
                         {
                             isTicking = false;
-                            rankImpactSound.Play();
+                            rankImpactSound!.Play();
                         });
 
                         const double applause_pre_delay = 545f;
@@ -341,8 +339,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
                         {
                             Schedule(() =>
                             {
-                                rankApplauseSound.VolumeTo(applause_volume);
-                                rankApplauseSound.Play();
+                                rankApplauseSound!.VolumeTo(applause_volume);
+                                rankApplauseSound!.Play();
                             });
                         }
                     }

From b937b94bd2feb31995cbb2b0e0c0cc8126195b77 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:15:21 +0200
Subject: [PATCH 824/930] Apply NRT to `RankBadge`

---
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
index 8aea6045eb..0e798c7d6e 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankBadge.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -34,8 +32,8 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
 
         public readonly ScoreRank Rank;
 
-        private Drawable rankContainer;
-        private Drawable overlay;
+        private Drawable rankContainer = null!;
+        private Drawable overlay = null!;
 
         /// <summary>
         /// Creates a new <see cref="RankBadge"/>.

From 414f023817027d0433d99b921177e5f98b0ff2e6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:15:51 +0200
Subject: [PATCH 825/930] Apply NRT to `RankText`

---
 osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
index b7adcb032f..76e59b32b8 100644
--- a/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Accuracy/RankText.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -23,9 +21,9 @@ namespace osu.Game.Screens.Ranking.Expanded.Accuracy
     {
         private readonly ScoreRank rank;
 
-        private BufferedContainer flash;
-        private BufferedContainer superFlash;
-        private GlowingSpriteText rankText;
+        private BufferedContainer flash = null!;
+        private BufferedContainer superFlash = null!;
+        private GlowingSpriteText rankText = null!;
 
         public RankText(ScoreRank rank)
         {

From ee9144c3bddd0b16b7bd18dd51222bfdadec5f18 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 13:17:31 +0200
Subject: [PATCH 826/930] Apply NRT to results statistics displays

---
 .../Ranking/Expanded/Statistics/AccuracyStatistic.cs        | 4 +---
 .../Screens/Ranking/Expanded/Statistics/ComboStatistic.cs   | 4 +---
 .../Screens/Ranking/Expanded/Statistics/CounterStatistic.cs | 4 +---
 .../Ranking/Expanded/Statistics/PerformanceStatistic.cs     | 6 ++----
 .../Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs | 6 ++----
 5 files changed, 7 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
index f1f2c47e20..a4672a475c 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/AccuracyStatistic.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Graphics;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
@@ -22,7 +20,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     {
         private readonly double accuracy;
 
-        private RollingCounter<double> counter;
+        private RollingCounter<double> counter = null!;
 
         /// <summary>
         /// Creates a new <see cref="AccuracyStatistic"/>.
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
index 6290cee6da..7c91a37b77 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/ComboStatistic.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Colour;
@@ -22,7 +20,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     {
         private readonly bool isPerfect;
 
-        private Drawable perfectText;
+        private Drawable perfectText = null!;
 
         /// <summary>
         /// Creates a new <see cref="ComboStatistic"/>.
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
index 8528dac83b..4042724c75 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/CounterStatistic.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Localisation;
@@ -21,7 +19,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
         private readonly int count;
         private readonly int? maxCount;
 
-        private RollingCounter<int> counter;
+        private RollingCounter<int> counter = null!;
 
         /// <summary>
         /// Creates a new <see cref="CounterStatistic"/>.
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
index 8366f8d7ef..7ea3cbe917 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/PerformanceStatistic.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -32,7 +30,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         private readonly CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
 
-        private RollingCounter<int> counter;
+        private RollingCounter<int> counter = null!;
 
         public PerformanceStatistic(ScoreInfo score)
             : base(BeatmapsetsStrings.ShowScoreboardHeaderspp)
@@ -107,7 +105,7 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
 
         protected override void Dispose(bool isDisposing)
         {
-            cancellationTokenSource?.Cancel();
+            cancellationTokenSource.Cancel();
             base.Dispose(isDisposing);
         }
 
diff --git a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
index 686b6c7d47..9de60f013d 100644
--- a/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
+++ b/osu.Game/Screens/Ranking/Expanded/Statistics/StatisticDisplay.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Extensions.LocalisationExtensions;
@@ -21,10 +19,10 @@ namespace osu.Game.Screens.Ranking.Expanded.Statistics
     /// </summary>
     public abstract partial class StatisticDisplay : CompositeDrawable
     {
-        protected SpriteText HeaderText { get; private set; }
+        protected SpriteText HeaderText { get; private set; } = null!;
 
         private readonly LocalisableString header;
-        private Drawable content;
+        private Drawable content = null!;
 
         /// <summary>
         /// Creates a new <see cref="StatisticDisplay"/>.

From 12e98fe55df37690f24de1450c1f59a9e75dd274 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 May 2024 15:24:32 +0800
Subject: [PATCH 827/930] Move out of playfield so touch overlay is not
 affected by playfield position

---
 .../UI/DrawableManiaRuleset.cs                | 10 ++++++-
 osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs  | 30 ++-----------------
 .../UI/ManiaTouchInputOverlay.cs              |  5 ++--
 3 files changed, 15 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index 275b1311de..a948117748 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
@@ -31,6 +31,7 @@ using osu.Game.Skinning;
 
 namespace osu.Game.Rulesets.Mania.UI
 {
+    [Cached]
     public partial class DrawableManiaRuleset : DrawableScrollingRuleset<ManiaHitObject>
     {
         /// <summary>
@@ -43,7 +44,7 @@ namespace osu.Game.Rulesets.Mania.UI
         /// </summary>
         public const double MAX_TIME_RANGE = 11485;
 
-        protected new ManiaPlayfield Playfield => (ManiaPlayfield)base.Playfield;
+        public new ManiaPlayfield Playfield => (ManiaPlayfield)base.Playfield;
 
         public new ManiaBeatmap Beatmap => (ManiaBeatmap)base.Beatmap;
 
@@ -103,6 +104,11 @@ namespace osu.Game.Rulesets.Mania.UI
             configScrollSpeed.BindValueChanged(speed => this.TransformTo(nameof(smoothTimeRange), ComputeScrollTime(speed.NewValue), 200, Easing.OutQuint));
 
             TimeRange.Value = smoothTimeRange = ComputeScrollTime(configScrollSpeed.Value);
+
+            KeyBindingInputManager.Add(touchOverlay = new ManiaTouchInputOverlay
+            {
+                RelativeSizeAxes = Axes.Both
+            });
         }
 
         protected override void AdjustScrollSpeed(int amount) => configScrollSpeed.Value += amount;
@@ -116,6 +122,8 @@ namespace osu.Game.Rulesets.Mania.UI
         private ScheduledDelegate? pendingSkinChange;
         private float hitPosition;
 
+        private ManiaTouchInputOverlay touchOverlay = null!;
+
         private void onSkinChange()
         {
             // schedule required to avoid calls after disposed.
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
index 385a47f8b8..b3420c49f3 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaPlayfield.cs
@@ -7,12 +7,10 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using System;
 using System.Collections.Generic;
-using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics.Primitives;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Objects;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.UI.Scrolling;
@@ -27,8 +25,6 @@ namespace osu.Game.Rulesets.Mania.UI
 
         private readonly List<Stage> stages = new List<Stage>();
 
-        private readonly ManiaTouchInputOverlay touchOverlay;
-
         public override Quad SkinnableComponentScreenSpaceDrawQuad
         {
             get
@@ -64,23 +60,10 @@ namespace osu.Game.Rulesets.Mania.UI
                 throw new ArgumentException("Can't have zero or fewer stages.");
 
             GridContainer playfieldGrid;
-
-            RelativeSizeAxes = Axes.Y;
-            AutoSizeAxes = Axes.X;
-
-            AddRangeInternal(new Drawable[]
+            AddInternal(playfieldGrid = new GridContainer
             {
-                playfieldGrid = new GridContainer
-                {
-                    RelativeSizeAxes = Axes.Y,
-                    AutoSizeAxes = Axes.X,
-                    Content = new[] { new Drawable[stageDefinitions.Count] },
-                    ColumnDimensions = Enumerable.Range(0, stageDefinitions.Count).Select(_ => new Dimension(GridSizeMode.AutoSize)).ToArray()
-                },
-                touchOverlay = new ManiaTouchInputOverlay
-                {
-                    RelativeSizeAxes = Axes.Both
-                }
+                RelativeSizeAxes = Axes.Both,
+                Content = new[] { new Drawable[stageDefinitions.Count] }
             });
 
             var normalColumnAction = ManiaAction.Key1;
@@ -100,13 +83,6 @@ namespace osu.Game.Rulesets.Mania.UI
             }
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            touchOverlay.Alpha = Mods?.Any(m => m is ModTouchDevice) == true ? 1 : 0;
-        }
-
         public override void Add(HitObject hitObject) => getStageByColumn(((ManiaHitObject)hitObject).Column).Add(hitObject);
 
         public override bool Remove(HitObject hitObject) => getStageByColumn(((ManiaHitObject)hitObject).Column).Remove(hitObject);
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
index ddff064133..a51a3a605b 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
@@ -33,12 +33,13 @@ namespace osu.Game.Rulesets.Mania.UI
         };
 
         [Resolved]
-        private ManiaPlayfield playfield { get; set; } = null!;
+        private DrawableManiaRuleset drawableRuleset { get; set; } = null!;
 
         public ManiaTouchInputOverlay()
         {
             Anchor = Anchor.BottomCentre;
             Origin = Anchor.BottomCentre;
+
             RelativeSizeAxes = Axes.Both;
             Height = 0.5f;
         }
@@ -51,7 +52,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
             bool first = true;
 
-            foreach (var stage in playfield.Stages)
+            foreach (var stage in drawableRuleset.Playfield.Stages)
             {
                 foreach (var column in stage.Columns)
                 {

From 390557634a76d457d3412d207efe68417bcd7773 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 May 2024 19:16:07 +0800
Subject: [PATCH 828/930] Rename touch area class to match existing usage (see
 taiko)

---
 osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs | 2 +-
 osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs            | 4 ++--
 .../UI/{ManiaTouchInputOverlay.cs => ManiaTouchInputArea.cs}  | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)
 rename osu.Game.Rulesets.Mania/UI/{ManiaTouchInputOverlay.cs => ManiaTouchInputArea.cs} (97%)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
index 4c5e4933ef..829cd0b62e 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
@@ -59,6 +59,6 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         private Drawable? getSkinnableOverlay() => this.ChildrenOfType<SkinnableDrawable>()
                                                        .SingleOrDefault(d => d.Lookup.Equals(new ManiaSkinComponentLookup(ManiaSkinComponents.TouchOverlay)));
 
-        private ManiaTouchInputOverlay.InputReceptor getReceptor(int index) => this.ChildrenOfType<ManiaTouchInputOverlay.InputReceptor>().ElementAt(index);
+        private ManiaTouchInputArea.InputReceptor getReceptor(int index) => this.ChildrenOfType<ManiaTouchInputArea.InputReceptor>().ElementAt(index);
     }
 }
diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index a948117748..5974b76d65 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
@@ -105,7 +105,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
             TimeRange.Value = smoothTimeRange = ComputeScrollTime(configScrollSpeed.Value);
 
-            KeyBindingInputManager.Add(touchOverlay = new ManiaTouchInputOverlay
+            KeyBindingInputManager.Add(touchArea = new ManiaTouchInputArea
             {
                 RelativeSizeAxes = Axes.Both
             });
@@ -122,7 +122,7 @@ namespace osu.Game.Rulesets.Mania.UI
         private ScheduledDelegate? pendingSkinChange;
         private float hitPosition;
 
-        private ManiaTouchInputOverlay touchOverlay = null!;
+        private ManiaTouchInputArea touchArea = null!;
 
         private void onSkinChange()
         {
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
similarity index 97%
rename from osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
rename to osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
index a51a3a605b..0cb12128e8 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputOverlay.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
@@ -14,7 +14,7 @@ using osuTK;
 
 namespace osu.Game.Rulesets.Mania.UI
 {
-    public partial class ManiaTouchInputOverlay : CompositeDrawable, ISerialisableDrawable
+    public partial class ManiaTouchInputArea : CompositeDrawable, ISerialisableDrawable
     {
         [SettingSource("Spacing", "The spacing between receptors.")]
         public BindableFloat Spacing { get; } = new BindableFloat(10)
@@ -35,7 +35,7 @@ namespace osu.Game.Rulesets.Mania.UI
         [Resolved]
         private DrawableManiaRuleset drawableRuleset { get; set; } = null!;
 
-        public ManiaTouchInputOverlay()
+        public ManiaTouchInputArea()
         {
             Anchor = Anchor.BottomCentre;
             Origin = Anchor.BottomCentre;

From 5c9a90cb40320cf2f22e4b6ba9f94a7ab0d4e632 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 May 2024 19:28:14 +0800
Subject: [PATCH 829/930] Tidy class and change to be a `VisibilityContainer`
 similar to taiko implementation

---
 .../Mods/TestSceneModTouchDevice.cs           | 11 ++--
 .../UI/DrawableManiaRuleset.cs                |  7 +--
 .../UI/ManiaTouchInputArea.cs                 | 54 +++++++++++++++----
 3 files changed, 50 insertions(+), 22 deletions(-)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
index 829cd0b62e..451cb617ee 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
+++ b/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
@@ -3,12 +3,10 @@
 
 using System.Linq;
 using NUnit.Framework;
-using osu.Framework.Graphics;
 using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Rulesets.Mania.UI;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Skinning;
 using osu.Game.Tests.Visual;
 
 namespace osu.Game.Rulesets.Mania.Tests.Mods
@@ -22,14 +20,14 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
         {
             Mod = new ModTouchDevice(),
             Autoplay = false,
-            PassCondition = () => getSkinnableOverlay()?.IsPresent == true
+            PassCondition = () => getTouchOverlay()?.IsPresent == true
         });
 
         [Test]
         public void TestOverlayNotVisibleWithoutMod() => CreateModTest(new ModTestData
         {
             Autoplay = false,
-            PassCondition = () => getSkinnableOverlay()?.IsPresent == false
+            PassCondition = () => getTouchOverlay()?.IsPresent == false
         });
 
         [Test]
@@ -56,9 +54,8 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
             }
         }
 
-        private Drawable? getSkinnableOverlay() => this.ChildrenOfType<SkinnableDrawable>()
-                                                       .SingleOrDefault(d => d.Lookup.Equals(new ManiaSkinComponentLookup(ManiaSkinComponents.TouchOverlay)));
+        private ManiaTouchInputArea? getTouchOverlay() => this.ChildrenOfType<ManiaTouchInputArea>().SingleOrDefault();
 
-        private ManiaTouchInputArea.InputReceptor getReceptor(int index) => this.ChildrenOfType<ManiaTouchInputArea.InputReceptor>().ElementAt(index);
+        private ManiaTouchInputArea.ColumnInputReceptor getReceptor(int index) => this.ChildrenOfType<ManiaTouchInputArea.ColumnInputReceptor>().ElementAt(index);
     }
 }
diff --git a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
index 5974b76d65..ce53862c76 100644
--- a/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/UI/DrawableManiaRuleset.cs
@@ -105,10 +105,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
             TimeRange.Value = smoothTimeRange = ComputeScrollTime(configScrollSpeed.Value);
 
-            KeyBindingInputManager.Add(touchArea = new ManiaTouchInputArea
-            {
-                RelativeSizeAxes = Axes.Both
-            });
+            KeyBindingInputManager.Add(new ManiaTouchInputArea());
         }
 
         protected override void AdjustScrollSpeed(int amount) => configScrollSpeed.Value += amount;
@@ -122,8 +119,6 @@ namespace osu.Game.Rulesets.Mania.UI
         private ScheduledDelegate? pendingSkinChange;
         private float hitPosition;
 
-        private ManiaTouchInputArea touchArea = null!;
-
         private void onSkinChange()
         {
             // schedule required to avoid calls after disposed.
diff --git a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
index 0cb12128e8..32e4616a25 100644
--- a/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
+++ b/osu.Game.Rulesets.Mania/UI/ManiaTouchInputArea.cs
@@ -9,13 +9,19 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Configuration;
-using osu.Game.Skinning;
 using osuTK;
 
 namespace osu.Game.Rulesets.Mania.UI
 {
-    public partial class ManiaTouchInputArea : CompositeDrawable, ISerialisableDrawable
+    /// <summary>
+    /// An overlay that captures and displays osu!mania mouse and touch input.
+    /// </summary>
+    public partial class ManiaTouchInputArea : VisibilityContainer
     {
+        // visibility state affects our child. we always want to handle input.
+        public override bool PropagatePositionalInputSubTree => true;
+        public override bool PropagateNonPositionalInputSubTree => true;
+
         [SettingSource("Spacing", "The spacing between receptors.")]
         public BindableFloat Spacing { get; } = new BindableFloat(10)
         {
@@ -35,6 +41,8 @@ namespace osu.Game.Rulesets.Mania.UI
         [Resolved]
         private DrawableManiaRuleset drawableRuleset { get; set; } = null!;
 
+        private GridContainer gridContainer = null!;
+
         public ManiaTouchInputArea()
         {
             Anchor = Anchor.BottomCentre;
@@ -62,16 +70,17 @@ namespace osu.Game.Rulesets.Mania.UI
                         receptorGridDimensions.Add(new Dimension(GridSizeMode.AutoSize));
                     }
 
-                    receptorGridContent.Add(new InputReceptor { Action = { BindTarget = column.Action } });
+                    receptorGridContent.Add(new ColumnInputReceptor { Action = { BindTarget = column.Action } });
                     receptorGridDimensions.Add(new Dimension());
 
                     first = false;
                 }
             }
 
-            InternalChild = new GridContainer
+            InternalChild = gridContainer = new GridContainer
             {
                 RelativeSizeAxes = Axes.Both,
+                AlwaysPresent = true,
                 Content = new[] { receptorGridContent.ToArray() },
                 ColumnDimensions = receptorGridDimensions.ToArray()
             };
@@ -83,9 +92,36 @@ namespace osu.Game.Rulesets.Mania.UI
             Opacity.BindValueChanged(o => Alpha = o.NewValue, true);
         }
 
-        public bool UsesFixedAnchor { get; set; }
+        protected override bool OnKeyDown(KeyDownEvent e)
+        {
+            // Hide whenever the keyboard is used.
+            Hide();
+            return false;
+        }
 
-        public partial class InputReceptor : CompositeDrawable
+        protected override bool OnMouseDown(MouseDownEvent e)
+        {
+            Show();
+            return true;
+        }
+
+        protected override bool OnTouchDown(TouchDownEvent e)
+        {
+            Show();
+            return true;
+        }
+
+        protected override void PopIn()
+        {
+            gridContainer.FadeIn(500, Easing.OutQuint);
+        }
+
+        protected override void PopOut()
+        {
+            gridContainer.FadeOut(300);
+        }
+
+        public partial class ColumnInputReceptor : CompositeDrawable
         {
             public readonly IBindable<ManiaAction> Action = new Bindable<ManiaAction>();
 
@@ -96,7 +132,7 @@ namespace osu.Game.Rulesets.Mania.UI
 
             private bool isPressed;
 
-            public InputReceptor()
+            public ColumnInputReceptor()
             {
                 RelativeSizeAxes = Axes.Both;
 
@@ -128,7 +164,7 @@ namespace osu.Game.Rulesets.Mania.UI
             protected override bool OnTouchDown(TouchDownEvent e)
             {
                 updateButton(true);
-                return true;
+                return false; // handled by parent container to show overlay.
             }
 
             protected override void OnTouchUp(TouchUpEvent e)
@@ -139,7 +175,7 @@ namespace osu.Game.Rulesets.Mania.UI
             protected override bool OnMouseDown(MouseDownEvent e)
             {
                 updateButton(true);
-                return true;
+                return false; // handled by parent container to show overlay.
             }
 
             protected override void OnMouseUp(MouseUpEvent e)

From 636e2004711fe91474574a0acdc1ebd3519e8cc4 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 May 2024 21:56:00 +0800
Subject: [PATCH 830/930] Update tests in line with new structure

---
 ...ice.cs => TestSceneManiaTouchInputArea.cs} | 30 ++++++-------------
 1 file changed, 9 insertions(+), 21 deletions(-)
 rename osu.Game.Rulesets.Mania.Tests/{Mods/TestSceneModTouchDevice.cs => TestSceneManiaTouchInputArea.cs} (64%)

diff --git a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaTouchInputArea.cs
similarity index 64%
rename from osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
rename to osu.Game.Rulesets.Mania.Tests/TestSceneManiaTouchInputArea.cs
index 451cb617ee..30c0113bff 100644
--- a/osu.Game.Rulesets.Mania.Tests/Mods/TestSceneModTouchDevice.cs
+++ b/osu.Game.Rulesets.Mania.Tests/TestSceneManiaTouchInputArea.cs
@@ -3,42 +3,28 @@
 
 using System.Linq;
 using NUnit.Framework;
+using osu.Framework.Graphics.Containers;
 using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Rulesets.Mania.UI;
-using osu.Game.Rulesets.Mods;
 using osu.Game.Tests.Visual;
 
-namespace osu.Game.Rulesets.Mania.Tests.Mods
+namespace osu.Game.Rulesets.Mania.Tests
 {
-    public partial class TestSceneModTouchDevice : ModTestScene
+    public partial class TestSceneManiaTouchInputArea : PlayerTestScene
     {
         protected override Ruleset CreatePlayerRuleset() => new ManiaRuleset();
 
         [Test]
-        public void TestOverlayVisibleWithMod() => CreateModTest(new ModTestData
+        public void TestTouchAreaNotInitiallyVisible()
         {
-            Mod = new ModTouchDevice(),
-            Autoplay = false,
-            PassCondition = () => getTouchOverlay()?.IsPresent == true
-        });
-
-        [Test]
-        public void TestOverlayNotVisibleWithoutMod() => CreateModTest(new ModTestData
-        {
-            Autoplay = false,
-            PassCondition = () => getTouchOverlay()?.IsPresent == false
-        });
+            AddAssert("touch area not visible", () => getTouchOverlay()?.State.Value == Visibility.Hidden);
+        }
 
         [Test]
         public void TestPressReceptors()
         {
-            CreateModTest(new ModTestData
-            {
-                Mod = new ModTouchDevice(),
-                Autoplay = false,
-                PassCondition = () => true
-            });
+            AddAssert("touch area not visible", () => getTouchOverlay()?.State.Value == Visibility.Hidden);
 
             for (int i = 0; i < 4; i++)
             {
@@ -51,6 +37,8 @@ namespace osu.Game.Rulesets.Mania.Tests.Mods
                     () => Does.Contain(getReceptor(index).Action.Value));
 
                 AddStep($"release receptor {index}", () => InputManager.EndTouch(new Touch(TouchSource.Touch1, getReceptor(index).ScreenSpaceDrawQuad.Centre)));
+
+                AddAssert("touch area visible", () => getTouchOverlay()?.State.Value == Visibility.Visible);
             }
         }
 

From f781dc3300267bf99d57b5331aa4c3ed4a48d7a9 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 May 2024 22:38:31 +0800
Subject: [PATCH 831/930] Remove touch mod addition to mania

Feels a bit pointless? I dunno.
---
 osu.Game.Rulesets.Mania/ManiaRuleset.cs | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/ManiaRuleset.cs b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
index 23004e36a0..b5614e2b56 100644
--- a/osu.Game.Rulesets.Mania/ManiaRuleset.cs
+++ b/osu.Game.Rulesets.Mania/ManiaRuleset.cs
@@ -163,9 +163,6 @@ namespace osu.Game.Rulesets.Mania
 
             if (mods.HasFlagFast(LegacyMods.ScoreV2))
                 yield return new ModScoreV2();
-
-            if (mods.HasFlagFast(LegacyMods.TouchDevice))
-                yield return new ModTouchDevice();
         }
 
         public override LegacyMods ConvertToLegacyMods(Mod[] mods)
@@ -228,10 +225,6 @@ namespace osu.Game.Rulesets.Mania
                     case ManiaModRandom:
                         value |= LegacyMods.Random;
                         break;
-
-                    case ModTouchDevice:
-                        value |= LegacyMods.TouchDevice;
-                        break;
                 }
             }
 
@@ -303,7 +296,6 @@ namespace osu.Game.Rulesets.Mania
                 case ModType.System:
                     return new Mod[]
                     {
-                        new ModTouchDevice(),
                         new ModScoreV2(),
                     };
 

From cff865b556399e1b15206d4d080147d473277f84 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 14 May 2024 23:54:07 +0800
Subject: [PATCH 832/930] Continue loading even when osu! logo is being dragged
 at loading screen

Closes https://github.com/ppy/osu/issues/28130.
---
 osu.Game/Screens/Play/PlayerLoader.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/PlayerLoader.cs b/osu.Game/Screens/Play/PlayerLoader.cs
index 4f7e21dddf..51a0c94ff0 100644
--- a/osu.Game/Screens/Play/PlayerLoader.cs
+++ b/osu.Game/Screens/Play/PlayerLoader.cs
@@ -113,7 +113,7 @@ namespace osu.Game.Screens.Play
             // not ready if the user is hovering one of the panes (logo is excluded), unless they are idle.
             (IsHovered || osuLogo?.IsHovered == true || idleTracker.IsIdle.Value)
             // not ready if the user is dragging a slider or otherwise.
-            && inputManager.DraggedDrawable == null
+            && (inputManager.DraggedDrawable == null || inputManager.DraggedDrawable is OsuLogo)
             // not ready if a focused overlay is visible, like settings.
             && inputManager.FocusedDrawable == null;
 

From 3d190f7e88ff4beb32addcef83e20f2087de0061 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Tue, 14 May 2024 18:41:15 +0200
Subject: [PATCH 833/930] Remove redundant cast

---
 osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
index 967cdb0e54..c229039dc3 100644
--- a/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
+++ b/osu.Game.Rulesets.Mania/Edit/ManiaHitObjectComposer.cs
@@ -28,7 +28,7 @@ namespace osu.Game.Rulesets.Mania.Edit
         {
         }
 
-        public new ManiaPlayfield Playfield => ((ManiaPlayfield)drawableRuleset.Playfield);
+        public new ManiaPlayfield Playfield => drawableRuleset.Playfield;
 
         public IScrollingInfo ScrollingInfo => drawableRuleset.ScrollingInfo;
 

From a3960bf7155f6019dd552783b2266f7896df2d34 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 15 May 2024 14:17:28 +0800
Subject: [PATCH 834/930] Add inline comment explaining `LifetimeEnd` set for
 future visitors

---
 .../Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs   | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
index e70e181a50..7841e65935 100644
--- a/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
+++ b/osu.Game/Rulesets/UI/Scrolling/ScrollingHitObjectContainer.cs
@@ -240,6 +240,13 @@ namespace osu.Game.Rulesets.UI.Scrolling
 
             // always load the hitobject before its first judgement offset
             entry.LifetimeStart = Math.Min(entry.HitObject.StartTime - entry.HitObject.MaximumJudgementOffset, computedStartTime);
+
+            // This is likely not entirely correct, but sets a sane expectation of the ending lifetime.
+            // A more correct lifetime will be overwritten after a DrawableHitObject is assigned via DrawableHitObject.updateState.
+            //
+            // It is required that we set a lifetime end here to ensure that in scenarios like loading a Player instance to a seeked
+            // location in a beatmap doesn't churn every hit object into a DrawableHitObject. Even in a pooled scenario, the overhead
+            // of this can be quite crippling.
             entry.LifetimeEnd = entry.HitObject.GetEndTime() + timeRange.Value;
         }
 

From c4ac6d20a09b5704dd484b633142f517b527e2c2 Mon Sep 17 00:00:00 2001
From: OliBomby <olivierschipper@gmail.com>
Date: Wed, 15 May 2024 23:40:51 +0200
Subject: [PATCH 835/930] fix code quality

---
 .../Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index a1f6a1732a..c188d23a58 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -12,9 +12,6 @@ namespace osu.Game.Screens.Edit.Compose.Components
 {
     public partial class SelectionBoxScaleHandle : SelectionBoxDragHandle
     {
-        [Resolved]
-        private SelectionBox selectionBox { get; set; } = null!;
-
         [Resolved]
         private SelectionScaleHandler? scaleHandler { get; set; }
 

From 21f5d891bb28a2edd835b4d4a2e69895b5ecf5dd Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Thu, 16 May 2024 04:36:14 +0300
Subject: [PATCH 836/930] Rename and move footer classes to appropriate places

---
 .../TestSceneScreenFooter.cs}                 | 25 ++++++++++---------
 ....cs => TestSceneScreenFooterButtonMods.cs} | 16 ++++++------
 .../FooterV2.cs => Footer/ScreenFooter.cs}    | 12 ++++-----
 .../ScreenFooterButton.cs}                    |  6 ++---
 .../Footer}/BeatmapOptionsPopover.cs          |  7 +++---
 .../Footer/ScreenFooterButtonMods.cs}         |  5 ++--
 .../Footer/ScreenFooterButtonOptions.cs}      |  5 ++--
 .../Footer/ScreenFooterButtonRandom.cs}       |  5 ++--
 8 files changed, 43 insertions(+), 38 deletions(-)
 rename osu.Game.Tests/Visual/{SongSelect/TestSceneSongSelectFooterV2.cs => UserInterface/TestSceneScreenFooter.cs} (89%)
 rename osu.Game.Tests/Visual/UserInterface/{TestSceneFooterButtonModsV2.cs => TestSceneScreenFooterButtonMods.cs} (90%)
 rename osu.Game/Screens/{Select/FooterV2/FooterV2.cs => Footer/ScreenFooter.cs} (86%)
 rename osu.Game/Screens/{Select/FooterV2/FooterButtonV2.cs => Footer/ScreenFooterButton.cs} (97%)
 rename osu.Game/Screens/{Select/FooterV2 => SelectV2/Footer}/BeatmapOptionsPopover.cs (96%)
 rename osu.Game/Screens/{Select/FooterV2/FooterButtonModsV2.cs => SelectV2/Footer/ScreenFooterButtonMods.cs} (98%)
 rename osu.Game/Screens/{Select/FooterV2/FooterButtonOptionsV2.cs => SelectV2/Footer/ScreenFooterButtonOptions.cs} (83%)
 rename osu.Game/Screens/{Select/FooterV2/FooterButtonRandomV2.cs => SelectV2/Footer/ScreenFooterButtonRandom.cs} (97%)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooter.cs
similarity index 89%
rename from osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooter.cs
index 93402e42ce..162609df70 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestSceneSongSelectFooterV2.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooter.cs
@@ -15,15 +15,16 @@ using osu.Game.Overlays.Mods;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Screens.Select.FooterV2;
+using osu.Game.Screens.Footer;
+using osu.Game.Screens.SelectV2.Footer;
 using osuTK.Input;
 
-namespace osu.Game.Tests.Visual.SongSelect
+namespace osu.Game.Tests.Visual.UserInterface
 {
-    public partial class TestSceneSongSelectFooterV2 : OsuManualInputManagerTestScene
+    public partial class TestSceneScreenFooter : OsuManualInputManagerTestScene
     {
-        private FooterButtonRandomV2 randomButton = null!;
-        private FooterButtonModsV2 modsButton = null!;
+        private ScreenFooterButtonRandom randomButton = null!;
+        private ScreenFooterButtonMods modsButton = null!;
 
         private bool nextRandomCalled;
         private bool previousRandomCalled;
@@ -39,25 +40,25 @@ namespace osu.Game.Tests.Visual.SongSelect
             nextRandomCalled = false;
             previousRandomCalled = false;
 
-            FooterV2 footer;
+            ScreenFooter footer;
 
             Children = new Drawable[]
             {
                 new PopoverContainer
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Child = footer = new FooterV2(),
+                    Child = footer = new ScreenFooter(),
                 },
                 overlay = new DummyOverlay()
             };
 
-            footer.AddButton(modsButton = new FooterButtonModsV2 { Current = SelectedMods }, overlay);
-            footer.AddButton(randomButton = new FooterButtonRandomV2
+            footer.AddButton(modsButton = new ScreenFooterButtonMods { Current = SelectedMods }, overlay);
+            footer.AddButton(randomButton = new ScreenFooterButtonRandom
             {
                 NextRandom = () => nextRandomCalled = true,
                 PreviousRandom = () => previousRandomCalled = true
             });
-            footer.AddButton(new FooterButtonOptionsV2());
+            footer.AddButton(new ScreenFooterButtonOptions());
 
             overlay.Hide();
         });
@@ -98,7 +99,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         {
             AddStep("enable options", () =>
             {
-                var optionsButton = this.ChildrenOfType<FooterButtonV2>().Last();
+                var optionsButton = this.ChildrenOfType<ScreenFooterButton>().Last();
 
                 optionsButton.Enabled.Value = true;
                 optionsButton.TriggerClick();
@@ -108,7 +109,7 @@ namespace osu.Game.Tests.Visual.SongSelect
         [Test]
         public void TestState()
         {
-            AddToggleStep("set options enabled state", state => this.ChildrenOfType<FooterButtonV2>().Last().Enabled.Value = state);
+            AddToggleStep("set options enabled state", state => this.ChildrenOfType<ScreenFooterButton>().Last().Enabled.Value = state);
         }
 
         [Test]
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooterButtonMods.cs
similarity index 90%
rename from osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
rename to osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooterButtonMods.cs
index 4aca9dde3d..df2109ace8 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneFooterButtonModsV2.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneScreenFooterButtonMods.cs
@@ -12,21 +12,21 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Rulesets.Osu.Mods;
-using osu.Game.Screens.Select.FooterV2;
+using osu.Game.Screens.SelectV2.Footer;
 using osu.Game.Utils;
 
 namespace osu.Game.Tests.Visual.UserInterface
 {
-    public partial class TestSceneFooterButtonModsV2 : OsuTestScene
+    public partial class TestSceneScreenFooterButtonMods : OsuTestScene
     {
-        private readonly TestFooterButtonModsV2 footerButtonMods;
+        private readonly TestScreenFooterButtonMods footerButtonMods;
 
         [Cached]
         private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Aquamarine);
 
-        public TestSceneFooterButtonModsV2()
+        public TestSceneScreenFooterButtonMods()
         {
-            Add(footerButtonMods = new TestFooterButtonModsV2
+            Add(footerButtonMods = new TestScreenFooterButtonMods
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.CentreLeft,
@@ -97,9 +97,9 @@ namespace osu.Game.Tests.Visual.UserInterface
         public void TestUnrankedBadge()
         {
             AddStep(@"Add unranked mod", () => changeMods(new[] { new OsuModDeflate() }));
-            AddUntilStep("Unranked badge shown", () => footerButtonMods.ChildrenOfType<FooterButtonModsV2.UnrankedBadge>().Single().Alpha == 1);
+            AddUntilStep("Unranked badge shown", () => footerButtonMods.ChildrenOfType<ScreenFooterButtonMods.UnrankedBadge>().Single().Alpha == 1);
             AddStep(@"Clear selected mod", () => changeMods(Array.Empty<Mod>()));
-            AddUntilStep("Unranked badge not shown", () => footerButtonMods.ChildrenOfType<FooterButtonModsV2.UnrankedBadge>().Single().Alpha == 0);
+            AddUntilStep("Unranked badge not shown", () => footerButtonMods.ChildrenOfType<ScreenFooterButtonMods.UnrankedBadge>().Single().Alpha == 0);
         }
 
         private void changeMods(IReadOnlyList<Mod> mods) => footerButtonMods.Current.Value = mods;
@@ -112,7 +112,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             return expectedValue == footerButtonMods.MultiplierText.Current.Value;
         }
 
-        private partial class TestFooterButtonModsV2 : FooterButtonModsV2
+        private partial class TestScreenFooterButtonMods : ScreenFooterButtonMods
         {
             public new OsuSpriteText MultiplierText => base.MultiplierText;
         }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterV2.cs b/osu.Game/Screens/Footer/ScreenFooter.cs
similarity index 86%
rename from osu.Game/Screens/Select/FooterV2/FooterV2.cs
rename to osu.Game/Screens/Footer/ScreenFooter.cs
index 370c28e2a5..01013bb466 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterV2.cs
+++ b/osu.Game/Screens/Footer/ScreenFooter.cs
@@ -11,9 +11,9 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Overlays;
 using osuTK;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.Footer
 {
-    public partial class FooterV2 : InputBlockingContainer
+    public partial class ScreenFooter : InputBlockingContainer
     {
         //Should be 60, setting to 50 for now for the sake of matching the current BackButton height.
         private const int height = 50;
@@ -23,7 +23,7 @@ namespace osu.Game.Screens.Select.FooterV2
 
         /// <param name="button">The button to be added.</param>
         /// <param name="overlay">The <see cref="OverlayContainer"/> to be toggled by this button.</param>
-        public void AddButton(FooterButtonV2 button, OverlayContainer? overlay = null)
+        public void AddButton(ScreenFooterButton button, OverlayContainer? overlay = null)
         {
             if (overlay != null)
             {
@@ -46,9 +46,9 @@ namespace osu.Game.Screens.Select.FooterV2
             }
         }
 
-        private FillFlowContainer<FooterButtonV2> buttons = null!;
+        private FillFlowContainer<ScreenFooterButton> buttons = null!;
 
-        public FooterV2()
+        public ScreenFooter()
         {
             RelativeSizeAxes = Axes.X;
             Height = height;
@@ -66,7 +66,7 @@ namespace osu.Game.Screens.Select.FooterV2
                     RelativeSizeAxes = Axes.Both,
                     Colour = colourProvider.Background5
                 },
-                buttons = new FillFlowContainer<FooterButtonV2>
+                buttons = new FillFlowContainer<ScreenFooterButton>
                 {
                     Position = new Vector2(TwoLayerButton.SIZE_EXTENDED.X + padding, 10),
                     Anchor = Anchor.BottomLeft,
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs b/osu.Game/Screens/Footer/ScreenFooterButton.cs
similarity index 97%
rename from osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
rename to osu.Game/Screens/Footer/ScreenFooterButton.cs
index 80103242f8..b3b3c9a8ec 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonV2.cs
+++ b/osu.Game/Screens/Footer/ScreenFooterButton.cs
@@ -21,9 +21,9 @@ using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.Footer
 {
-    public partial class FooterButtonV2 : OsuClickableContainer, IKeyBindingHandler<GlobalAction>
+    public partial class ScreenFooterButton : OsuClickableContainer, IKeyBindingHandler<GlobalAction>
     {
         // This should be 12 by design, but an extra allowance is added due to the corner radius specification.
         private const float shear_width = 13.5f;
@@ -70,7 +70,7 @@ namespace osu.Game.Screens.Select.FooterV2
         private readonly Box glowBox;
         private readonly Box flashLayer;
 
-        public FooterButtonV2()
+        public ScreenFooterButton()
         {
             Size = new Vector2(BUTTON_WIDTH, BUTTON_HEIGHT);
 
diff --git a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs b/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
similarity index 96%
rename from osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
rename to osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
index d98164c306..f73be15a36 100644
--- a/osu.Game/Screens/Select/FooterV2/BeatmapOptionsPopover.cs
+++ b/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
@@ -20,24 +20,25 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
+using osu.Game.Screens.Select;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
 using WebCommonStrings = osu.Game.Resources.Localisation.Web.CommonStrings;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.SelectV2.Footer
 {
     public partial class BeatmapOptionsPopover : OsuPopover
     {
         private FillFlowContainer buttonFlow = null!;
-        private readonly FooterButtonOptionsV2 footerButton;
+        private readonly ScreenFooterButtonOptions footerButton;
 
         private WorkingBeatmap beatmapWhenOpening = null!;
 
         [Resolved]
         private IBindable<WorkingBeatmap> beatmap { get; set; } = null!;
 
-        public BeatmapOptionsPopover(FooterButtonOptionsV2 footerButton)
+        public BeatmapOptionsPopover(ScreenFooterButtonOptions footerButton)
         {
             this.footerButton = footerButton;
         }
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonMods.cs
similarity index 98%
rename from osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
rename to osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonMods.cs
index 44db49b927..49961c60f8 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonModsV2.cs
+++ b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonMods.cs
@@ -21,14 +21,15 @@ using osu.Game.Graphics.Sprites;
 using osu.Game.Localisation;
 using osu.Game.Overlays;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Footer;
 using osu.Game.Screens.Play.HUD;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Graphics;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.SelectV2.Footer
 {
-    public partial class FooterButtonModsV2 : FooterButtonV2, IHasCurrentValue<IReadOnlyList<Mod>>
+    public partial class ScreenFooterButtonMods : ScreenFooterButton, IHasCurrentValue<IReadOnlyList<Mod>>
     {
         // todo: see https://github.com/ppy/osu-framework/issues/3271
         private const float torus_scale_factor = 1.2f;
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonOptions.cs
similarity index 83%
rename from osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
rename to osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonOptions.cs
index 555215056a..74fe3e3d11 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonOptionsV2.cs
+++ b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonOptions.cs
@@ -8,10 +8,11 @@ using osu.Framework.Graphics.Sprites;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics;
 using osu.Game.Input.Bindings;
+using osu.Game.Screens.Footer;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.SelectV2.Footer
 {
-    public partial class FooterButtonOptionsV2 : FooterButtonV2, IHasPopover
+    public partial class ScreenFooterButtonOptions : ScreenFooterButton, IHasPopover
     {
         [BackgroundDependencyLoader]
         private void load(OsuColour colour)
diff --git a/osu.Game/Screens/Select/FooterV2/FooterButtonRandomV2.cs b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonRandom.cs
similarity index 97%
rename from osu.Game/Screens/Select/FooterV2/FooterButtonRandomV2.cs
rename to osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonRandom.cs
index 70d1c0c19e..e8e850a9ce 100644
--- a/osu.Game/Screens/Select/FooterV2/FooterButtonRandomV2.cs
+++ b/osu.Game/Screens/SelectV2/Footer/ScreenFooterButtonRandom.cs
@@ -10,12 +10,13 @@ using osu.Framework.Input.Events;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Input.Bindings;
+using osu.Game.Screens.Footer;
 using osuTK;
 using osuTK.Input;
 
-namespace osu.Game.Screens.Select.FooterV2
+namespace osu.Game.Screens.SelectV2.Footer
 {
-    public partial class FooterButtonRandomV2 : FooterButtonV2
+    public partial class ScreenFooterButtonRandom : ScreenFooterButton
     {
         public Action? NextRandom { get; set; }
         public Action? PreviousRandom { get; set; }

From 97de73b99c47b2c0787ece0efa8431272df49c8a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 May 2024 08:21:52 +0200
Subject: [PATCH 837/930] Do not change mania column width on mobile platforms

- Closes https://github.com/ppy/osu/issues/25852
- Reverts https://github.com/ppy/osu/pull/25336 /
  https://github.com/ppy/osu/pull/25777

With the columns not being directly touchable anymore after
https://github.com/ppy/osu/pull/28173 I see very little point to this
continuing to exist.
---
 osu.Game.Rulesets.Mania/UI/ColumnFlow.cs | 36 ------------------------
 1 file changed, 36 deletions(-)

diff --git a/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs b/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs
index 1593e8e76f..f444448797 100644
--- a/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs
+++ b/osu.Game.Rulesets.Mania/UI/ColumnFlow.cs
@@ -3,15 +3,12 @@
 
 #nullable disable
 
-using System;
-using osu.Framework;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Game.Rulesets.Mania.Beatmaps;
 using osu.Game.Rulesets.Mania.Skinning;
 using osu.Game.Skinning;
-using osuTK;
 
 namespace osu.Game.Rulesets.Mania.UI
 {
@@ -62,12 +59,6 @@ namespace osu.Game.Rulesets.Mania.UI
             onSkinChanged();
         }
 
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-            updateMobileSizing();
-        }
-
         private void onSkinChanged()
         {
             for (int i = 0; i < stageDefinition.Columns; i++)
@@ -92,8 +83,6 @@ namespace osu.Game.Rulesets.Mania.UI
 
                 columns[i].Width = width.Value;
             }
-
-            updateMobileSizing();
         }
 
         /// <summary>
@@ -106,31 +95,6 @@ namespace osu.Game.Rulesets.Mania.UI
             Content[column] = columns[column].Child = content;
         }
 
-        private void updateMobileSizing()
-        {
-            if (!IsLoaded || !RuntimeInfo.IsMobile)
-                return;
-
-            // GridContainer+CellContainer containing this stage (gets split up for dual stages).
-            Vector2? containingCell = this.FindClosestParent<Stage>()?.Parent?.DrawSize;
-
-            // Will be null in tests.
-            if (containingCell == null)
-                return;
-
-            float aspectRatio = containingCell.Value.X / containingCell.Value.Y;
-
-            // 2.83 is a mostly arbitrary scale-up (170 / 60, based on original implementation for argon)
-            float mobileAdjust = 2.83f * Math.Min(1, 7f / stageDefinition.Columns);
-            // 1.92 is a "reference" mobile screen aspect ratio for phones.
-            // We should scale it back for cases like tablets which aren't so extreme.
-            mobileAdjust *= aspectRatio / 1.92f;
-
-            // Best effort until we have better mobile support.
-            for (int i = 0; i < stageDefinition.Columns; i++)
-                columns[i].Width *= mobileAdjust;
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);

From 5dd64a7c86bae98bc991386ba92faff97d6a205d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 May 2024 14:49:56 +0200
Subject: [PATCH 838/930] Fix duplicated localisation key in
 `DeleteConfiormationContentStrings`

Noticed via `osu-resources` build warnings.

There are also a few other warnings about
https://github.com/ppy/osu/pull/27472. Seems something in crowdin
innards may still be exporting those strings even though they have been
fixed already. Not sure how to address that.

Probably need these to be detected via static analysis at this point
since it's happened again. Might look into the feasibility of making
that happen.
---
 osu.Game/Localisation/DeleteConfirmationContentStrings.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
index 563fbf5654..d781fadbce 100644
--- a/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
+++ b/osu.Game/Localisation/DeleteConfirmationContentStrings.cs
@@ -32,7 +32,7 @@ namespace osu.Game.Localisation
         /// <summary>
         /// "Are you sure you want to delete all scores? This cannot be undone!"
         /// </summary>
-        public static LocalisableString Scores => new TranslatableString(getKey(@"collections"), @"Are you sure you want to delete all scores? This cannot be undone!");
+        public static LocalisableString Scores => new TranslatableString(getKey(@"scores"), @"Are you sure you want to delete all scores? This cannot be undone!");
 
         /// <summary>
         /// "Are you sure you want to delete all mod presets?"

From f2f03f08cb0dd79de4587a2ec63da97f3cb375da Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 May 2024 17:36:19 +0200
Subject: [PATCH 839/930] Fix xmldoc mismatches in localisation files

This is enforced by the localisation analyser after
https://github.com/ppy/osu-localisation-analyser/pull/62, but it appears
the analyser was never actually bumped game-side after that change and
I'm not super sure why, as there does not appear to be a reason to _not_
do that. So this commit does it.
---
 .../FirstRunOverlayImportFromStableScreenStrings.cs             | 2 +-
 osu.Game/Localisation/NotificationsStrings.cs                   | 2 +-
 osu.Game/osu.Game.csproj                                        | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
index 04fecab3df..521a77fe20 100644
--- a/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
+++ b/osu.Game/Localisation/FirstRunOverlayImportFromStableScreenStrings.cs
@@ -47,7 +47,7 @@ namespace osu.Game.Localisation
         public static LocalisableString Calculating => new TranslatableString(getKey(@"calculating"), @"calculating...");
 
         /// <summary>
-        /// "{0} items"
+        /// "{0} item(s)"
         /// </summary>
         public static LocalisableString Items(int arg0) => new TranslatableString(getKey(@"items"), @"{0} item(s)", arg0);
 
diff --git a/osu.Game/Localisation/NotificationsStrings.cs b/osu.Game/Localisation/NotificationsStrings.cs
index 3188ca5533..698fe230b2 100644
--- a/osu.Game/Localisation/NotificationsStrings.cs
+++ b/osu.Game/Localisation/NotificationsStrings.cs
@@ -114,7 +114,7 @@ Please try changing your audio device to a working setting.");
         public static LocalisableString MismatchingBeatmapForReplay => new TranslatableString(getKey(@"mismatching_beatmap_for_replay"), @"Your local copy of the beatmap for this replay appears to be different than expected. You may need to update or re-download it.");
 
         /// <summary>
-        /// "You are now running osu! {version}.
+        /// "You are now running osu! {0}.
         /// Click to see what's new!"
         /// </summary>
         public static LocalisableString GameVersionAfterUpdate(string version) => new TranslatableString(getKey(@"game_version_after_update"), @"You are now running osu! {0}.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 5452a648d1..7588b2b3c8 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -30,7 +30,7 @@
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="7.0.0" />
     <PackageReference Include="Microsoft.Toolkit.HighPerformance" Version="7.1.2" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2023.1117.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2024.318.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

From a3dfd99f7d5895fb0bf5f0c8398245a42b6d2848 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 16 May 2024 18:23:19 +0200
Subject: [PATCH 840/930] Fix discord arbitrarily refusing to work on "too
 short" strings

Closes https://github.com/ppy/osu/issues/28192.
---
 osu.Desktop/DiscordRichPresence.cs | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 74ebd38f2c..3e0a9099cb 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -164,8 +164,8 @@ namespace osu.Desktop
             // user activity
             if (activity.Value != null)
             {
-                presence.State = truncate(activity.Value.GetStatus(hideIdentifiableInformation));
-                presence.Details = truncate(activity.Value.GetDetails(hideIdentifiableInformation) ?? string.Empty);
+                presence.State = clampLength(activity.Value.GetStatus(hideIdentifiableInformation));
+                presence.Details = clampLength(activity.Value.GetDetails(hideIdentifiableInformation) ?? string.Empty);
 
                 if (getBeatmapID(activity.Value) is int beatmapId && beatmapId > 0)
                 {
@@ -271,8 +271,15 @@ namespace osu.Desktop
 
         private static readonly int ellipsis_length = Encoding.UTF8.GetByteCount(new[] { '…' });
 
-        private static string truncate(string str)
+        private static string clampLength(string str)
         {
+            // For whatever reason, discord decides that strings shorter than 2 characters cannot possibly be valid input, because... reasons?
+            // And yes, that is two *characters*, or *codepoints*, not *bytes* as further down below (as determined by empirical testing).
+            // That seems very questionable, and isn't even documented anywhere. So to *make it* accept such valid input,
+            // just tack on enough of U+200B ZERO WIDTH SPACEs at the end.
+            if (str.Length < 2)
+                return str.PadRight(2, '\u200B');
+
             if (Encoding.UTF8.GetByteCount(str) <= 128)
                 return str;
 

From 2f9d74286dd5401450f071659323415c3329d3b7 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Fri, 17 May 2024 11:15:17 +0900
Subject: [PATCH 841/930] Bump once more

---
 .config/dotnet-tools.json | 2 +-
 osu.Game/osu.Game.csproj  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 99906f0895..ace7db82f8 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -21,7 +21,7 @@
       ]
     },
     "ppy.localisationanalyser.tools": {
-      "version": "2023.1117.0",
+      "version": "2024.517.0",
       "commands": [
         "localisation"
       ]
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 7588b2b3c8..f91995feff 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -30,7 +30,7 @@
     <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="7.0.0" />
     <PackageReference Include="Microsoft.Toolkit.HighPerformance" Version="7.1.2" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
-    <PackageReference Include="ppy.LocalisationAnalyser" Version="2024.318.0">
+    <PackageReference Include="ppy.LocalisationAnalyser" Version="2024.517.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>

From 61a415fed2ae74c50223015d957bcc55b8a11c5c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 May 2024 10:32:39 +0200
Subject: [PATCH 842/930] Add client/server models & operations for "daily
 challenge" feature

---
 osu.Game/Online/Metadata/DailyChallengeInfo.cs   | 16 ++++++++++++++++
 osu.Game/Online/Metadata/IMetadataClient.cs      |  6 ++++++
 osu.Game/Online/Metadata/IMetadataServer.cs      |  7 ++++++-
 osu.Game/Online/Metadata/MetadataClient.cs       |  9 +++++++++
 osu.Game/Online/Metadata/OnlineMetadataClient.cs | 11 +++++++++++
 osu.Game/Online/Rooms/RoomCategory.cs            |  3 +++
 .../Tests/Visual/Metadata/TestMetadataClient.cs  |  9 +++++++++
 7 files changed, 60 insertions(+), 1 deletion(-)
 create mode 100644 osu.Game/Online/Metadata/DailyChallengeInfo.cs

diff --git a/osu.Game/Online/Metadata/DailyChallengeInfo.cs b/osu.Game/Online/Metadata/DailyChallengeInfo.cs
new file mode 100644
index 0000000000..7c49556653
--- /dev/null
+++ b/osu.Game/Online/Metadata/DailyChallengeInfo.cs
@@ -0,0 +1,16 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using MessagePack;
+
+namespace osu.Game.Online.Metadata
+{
+    [MessagePackObject]
+    [Serializable]
+    public struct DailyChallengeInfo
+    {
+        [Key(0)]
+        public long RoomID { get; set; }
+    }
+}
diff --git a/osu.Game/Online/Metadata/IMetadataClient.cs b/osu.Game/Online/Metadata/IMetadataClient.cs
index 7102554ae9..ee7a726bfc 100644
--- a/osu.Game/Online/Metadata/IMetadataClient.cs
+++ b/osu.Game/Online/Metadata/IMetadataClient.cs
@@ -20,5 +20,11 @@ namespace osu.Game.Online.Metadata
         /// Delivers an update of the <see cref="UserPresence"/> of the user with the supplied <paramref name="userId"/>.
         /// </summary>
         Task UserPresenceUpdated(int userId, UserPresence? status);
+
+        /// <summary>
+        /// Delivers an update of the current "daily challenge" status.
+        /// Null value means there is no "daily challenge" currently active.
+        /// </summary>
+        Task DailyChallengeUpdated(DailyChallengeInfo? info);
     }
 }
diff --git a/osu.Game/Online/Metadata/IMetadataServer.cs b/osu.Game/Online/Metadata/IMetadataServer.cs
index 9780045333..8bf3f8f56b 100644
--- a/osu.Game/Online/Metadata/IMetadataServer.cs
+++ b/osu.Game/Online/Metadata/IMetadataServer.cs
@@ -7,7 +7,12 @@ using osu.Game.Users;
 namespace osu.Game.Online.Metadata
 {
     /// <summary>
-    /// Metadata server is responsible for keeping the osu! client up-to-date with any changes.
+    /// Metadata server is responsible for keeping the osu! client up-to-date with various real-time happenings, such as:
+    /// <list type="bullet">
+    /// <item>beatmap updates via BSS,</item>
+    /// <item>online user activity/status updates,</item>
+    /// <item>other real-time happenings, such as current "daily challenge" status.</item>
+    /// </list>
     /// </summary>
     public interface IMetadataServer
     {
diff --git a/osu.Game/Online/Metadata/MetadataClient.cs b/osu.Game/Online/Metadata/MetadataClient.cs
index 8e99a9b2cb..b619970494 100644
--- a/osu.Game/Online/Metadata/MetadataClient.cs
+++ b/osu.Game/Online/Metadata/MetadataClient.cs
@@ -59,6 +59,15 @@ namespace osu.Game.Online.Metadata
 
         #endregion
 
+        #region Daily Challenge
+
+        public abstract IBindable<DailyChallengeInfo?> DailyChallengeInfo { get; }
+
+        /// <inheritdoc/>
+        public abstract Task DailyChallengeUpdated(DailyChallengeInfo? info);
+
+        #endregion
+
         #region Disconnection handling
 
         public event Action? Disconnecting;
diff --git a/osu.Game/Online/Metadata/OnlineMetadataClient.cs b/osu.Game/Online/Metadata/OnlineMetadataClient.cs
index 3805d12688..b94f26a71d 100644
--- a/osu.Game/Online/Metadata/OnlineMetadataClient.cs
+++ b/osu.Game/Online/Metadata/OnlineMetadataClient.cs
@@ -26,6 +26,9 @@ namespace osu.Game.Online.Metadata
         public override IBindableDictionary<int, UserPresence> UserStates => userStates;
         private readonly BindableDictionary<int, UserPresence> userStates = new BindableDictionary<int, UserPresence>();
 
+        public override IBindable<DailyChallengeInfo?> DailyChallengeInfo => dailyChallengeInfo;
+        private readonly Bindable<DailyChallengeInfo?> dailyChallengeInfo = new Bindable<DailyChallengeInfo?>();
+
         private readonly string endpoint;
 
         private IHubClientConnector? connector;
@@ -58,6 +61,7 @@ namespace osu.Game.Online.Metadata
                     // https://github.com/dotnet/aspnetcore/issues/15198
                     connection.On<BeatmapUpdates>(nameof(IMetadataClient.BeatmapSetsUpdated), ((IMetadataClient)this).BeatmapSetsUpdated);
                     connection.On<int, UserPresence?>(nameof(IMetadataClient.UserPresenceUpdated), ((IMetadataClient)this).UserPresenceUpdated);
+                    connection.On<DailyChallengeInfo?>(nameof(IMetadataClient.DailyChallengeUpdated), ((IMetadataClient)this).DailyChallengeUpdated);
                     connection.On(nameof(IStatefulUserHubClient.DisconnectRequested), ((IMetadataClient)this).DisconnectRequested);
                 };
 
@@ -101,6 +105,7 @@ namespace osu.Game.Online.Metadata
                 {
                     isWatchingUserPresence.Value = false;
                     userStates.Clear();
+                    dailyChallengeInfo.Value = null;
                 });
                 return;
             }
@@ -229,6 +234,12 @@ namespace osu.Game.Online.Metadata
             }
         }
 
+        public override Task DailyChallengeUpdated(DailyChallengeInfo? info)
+        {
+            Schedule(() => dailyChallengeInfo.Value = info);
+            return Task.CompletedTask;
+        }
+
         public override async Task DisconnectRequested()
         {
             await base.DisconnectRequested().ConfigureAwait(false);
diff --git a/osu.Game/Online/Rooms/RoomCategory.cs b/osu.Game/Online/Rooms/RoomCategory.cs
index 17afb0dc7f..4534e7de59 100644
--- a/osu.Game/Online/Rooms/RoomCategory.cs
+++ b/osu.Game/Online/Rooms/RoomCategory.cs
@@ -13,5 +13,8 @@ namespace osu.Game.Online.Rooms
 
         [Description("Featured Artist")]
         FeaturedArtist,
+
+        [Description("Daily Challenge")]
+        DailyChallenge,
     }
 }
diff --git a/osu.Game/Tests/Visual/Metadata/TestMetadataClient.cs b/osu.Game/Tests/Visual/Metadata/TestMetadataClient.cs
index 16cbf879df..b589e66d8b 100644
--- a/osu.Game/Tests/Visual/Metadata/TestMetadataClient.cs
+++ b/osu.Game/Tests/Visual/Metadata/TestMetadataClient.cs
@@ -21,6 +21,9 @@ namespace osu.Game.Tests.Visual.Metadata
         public override IBindableDictionary<int, UserPresence> UserStates => userStates;
         private readonly BindableDictionary<int, UserPresence> userStates = new BindableDictionary<int, UserPresence>();
 
+        public override IBindable<DailyChallengeInfo?> DailyChallengeInfo => dailyChallengeInfo;
+        private readonly Bindable<DailyChallengeInfo?> dailyChallengeInfo = new Bindable<DailyChallengeInfo?>();
+
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
@@ -77,5 +80,11 @@ namespace osu.Game.Tests.Visual.Metadata
             => Task.FromResult(new BeatmapUpdates(Array.Empty<int>(), queueId));
 
         public override Task BeatmapSetsUpdated(BeatmapUpdates updates) => Task.CompletedTask;
+
+        public override Task DailyChallengeUpdated(DailyChallengeInfo? info)
+        {
+            dailyChallengeInfo.Value = info;
+            return Task.CompletedTask;
+        }
     }
 }

From a4f8ed2a0ef48d8acf77877606b9d733e4170e58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 May 2024 10:39:24 +0200
Subject: [PATCH 843/930] Add button to access daily challenge playlist from
 main menu

---
 .../UserInterface/TestSceneMainMenuButton.cs  |  83 +++++++
 .../UpdateableOnlineBeatmapSetCover.cs        |   6 +-
 osu.Game/Graphics/OsuIcon.cs                  |   4 +
 osu.Game/Localisation/ButtonSystemStrings.cs  |   7 +-
 osu.Game/Screens/Menu/ButtonSystem.cs         |  57 +++--
 osu.Game/Screens/Menu/DailyChallengeButton.cs | 209 ++++++++++++++++++
 osu.Game/Screens/Menu/MainMenu.cs             |   6 +
 osu.Game/Screens/Menu/MainMenuButton.cs       | 183 +++++++++------
 .../Screens/OnlinePlay/Playlists/Playlists.cs |   3 +
 9 files changed, 476 insertions(+), 82 deletions(-)
 create mode 100644 osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
 create mode 100644 osu.Game/Screens/Menu/DailyChallengeButton.cs

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
new file mode 100644
index 0000000000..921e28d607
--- /dev/null
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
@@ -0,0 +1,83 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using NUnit.Framework;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
+using osu.Game.Graphics;
+using osu.Game.Localisation;
+using osu.Game.Online.API;
+using osu.Game.Online.Metadata;
+using osu.Game.Online.Rooms;
+using osu.Game.Screens.Menu;
+using osuTK.Input;
+using Color4 = osuTK.Graphics.Color4;
+
+namespace osu.Game.Tests.Visual.UserInterface
+{
+    [TestFixture]
+    public partial class TestSceneMainMenuButton : OsuTestScene
+    {
+        [Resolved]
+        private MetadataClient metadataClient { get; set; } = null!;
+
+        private DummyAPIAccess dummyAPI => (DummyAPIAccess)API;
+
+        [Test]
+        public void TestStandardButton()
+        {
+            AddStep("add button", () => Child = new MainMenuButton(
+                ButtonSystemStrings.Solo, @"button-default-select", OsuIcon.Player, new Color4(102, 68, 204, 255), _ => { }, 0, Key.P)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                ButtonSystemState = ButtonSystemState.TopLevel,
+            });
+        }
+
+        [Test]
+        public void TestDailyChallengeButton()
+        {
+            AddStep("add button", () => Child = new DailyChallengeButton(@"button-default-select", new Color4(102, 68, 204, 255), _ => { }, 0, Key.D)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                ButtonSystemState = ButtonSystemState.TopLevel,
+            });
+
+            AddStep("set up API", () => dummyAPI.HandleRequest = req =>
+            {
+                switch (req)
+                {
+                    case GetRoomRequest getRoomRequest:
+                        if (getRoomRequest.RoomId != 1234)
+                            return false;
+
+                        var beatmap = CreateAPIBeatmap();
+                        beatmap.OnlineID = 1001;
+                        getRoomRequest.TriggerSuccess(new Room
+                        {
+                            RoomID = { Value = 1234 },
+                            Playlist =
+                            {
+                                new PlaylistItem(beatmap)
+                            },
+                            EndDate = { Value = DateTimeOffset.Now.AddSeconds(30) }
+                        });
+                        return true;
+
+                    default:
+                        return false;
+                }
+            });
+
+            AddStep("beatmap of the day active", () => metadataClient.DailyChallengeUpdated(new DailyChallengeInfo
+            {
+                RoomID = 1234,
+            }));
+
+            AddStep("beatmap of the day not active", () => metadataClient.DailyChallengeUpdated(null));
+        }
+    }
+}
diff --git a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
index 93b0dd5c15..2a6b6f90e3 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
@@ -43,7 +43,11 @@ namespace osu.Game.Beatmaps.Drawables
         protected override double TransformDuration => 400;
 
         protected override DelayedLoadWrapper CreateDelayedLoadWrapper(Func<Drawable> createContentFunc, double timeBeforeLoad)
-            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad);
+            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+            };
 
         protected override Drawable CreateDrawable(IBeatmapSetOnlineInfo model)
         {
diff --git a/osu.Game/Graphics/OsuIcon.cs b/osu.Game/Graphics/OsuIcon.cs
index 32e780f11c..9879ef5d14 100644
--- a/osu.Game/Graphics/OsuIcon.cs
+++ b/osu.Game/Graphics/OsuIcon.cs
@@ -120,6 +120,7 @@ namespace osu.Game.Graphics
         public static IconUsage Cross => get(OsuIconMapping.Cross);
         public static IconUsage CrossCircle => get(OsuIconMapping.CrossCircle);
         public static IconUsage Crown => get(OsuIconMapping.Crown);
+        public static IconUsage DailyChallenge => get(OsuIconMapping.DailyChallenge);
         public static IconUsage Debug => get(OsuIconMapping.Debug);
         public static IconUsage Delete => get(OsuIconMapping.Delete);
         public static IconUsage Details => get(OsuIconMapping.Details);
@@ -218,6 +219,9 @@ namespace osu.Game.Graphics
             [Description(@"crown")]
             Crown,
 
+            [Description(@"daily-challenge")]
+            DailyChallenge,
+
             [Description(@"debug")]
             Debug,
 
diff --git a/osu.Game/Localisation/ButtonSystemStrings.cs b/osu.Game/Localisation/ButtonSystemStrings.cs
index ba4abf63a6..b0a205eebe 100644
--- a/osu.Game/Localisation/ButtonSystemStrings.cs
+++ b/osu.Game/Localisation/ButtonSystemStrings.cs
@@ -1,4 +1,4 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Localisation;
@@ -54,6 +54,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString Exit => new TranslatableString(getKey(@"exit"), @"exit");
 
+        /// <summary>
+        /// "daily challenge"
+        /// </summary>
+        public static LocalisableString DailyChallenge => new TranslatableString(getKey(@"daily_challenge"), @"daily challenge");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 15a2740160..33d2a8d348 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -24,6 +24,7 @@ using osu.Game.Input;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Online.API;
+using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osuTK;
 using osuTK.Graphics;
@@ -46,6 +47,7 @@ namespace osu.Game.Screens.Menu
         public Action? OnSettings;
         public Action? OnMultiplayer;
         public Action? OnPlaylists;
+        public Action<Room>? OnDailyChallenge;
 
         private readonly IBindable<bool> isIdle = new BindableBool();
 
@@ -102,10 +104,13 @@ namespace osu.Game.Screens.Menu
 
             buttonArea.AddRange(new Drawable[]
             {
-                new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, OsuIcon.Settings, new Color4(85, 85, 85, 255), () => OnSettings?.Invoke(), -WEDGE_WIDTH, Key.O, Key.S),
-                backButton = new MainMenuButton(ButtonSystemStrings.Back, @"back-to-top", OsuIcon.PrevCircle, new Color4(51, 58, 94, 255), () => State = ButtonSystemState.TopLevel,
-                    -WEDGE_WIDTH)
+                new MainMenuButton(ButtonSystemStrings.Settings, string.Empty, OsuIcon.Settings, new Color4(85, 85, 85, 255), _ => OnSettings?.Invoke(), Key.O, Key.S)
                 {
+                    Padding = new MarginPadding { Right = WEDGE_WIDTH },
+                },
+                backButton = new MainMenuButton(ButtonSystemStrings.Back, @"back-to-top", OsuIcon.PrevCircle, new Color4(51, 58, 94, 255), _ => State = ButtonSystemState.TopLevel)
+                {
+                    Padding = new MarginPadding { Right = WEDGE_WIDTH },
                     VisibleStateMin = ButtonSystemState.Play,
                     VisibleStateMax = ButtonSystemState.Edit,
                 },
@@ -127,21 +132,31 @@ namespace osu.Game.Screens.Menu
         [BackgroundDependencyLoader]
         private void load(AudioManager audio, IdleTracker? idleTracker, GameHost host)
         {
-            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Solo, @"button-default-select", OsuIcon.Player, new Color4(102, 68, 204, 255), () => OnSolo?.Invoke(), WEDGE_WIDTH, Key.P));
-            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Multi, @"button-default-select", OsuIcon.Online, new Color4(94, 63, 186, 255), onMultiplayer, 0, Key.M));
-            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Playlists, @"button-default-select", OsuIcon.Tournament, new Color4(94, 63, 186, 255), onPlaylists, 0, Key.L));
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Solo, @"button-default-select", OsuIcon.Player, new Color4(102, 68, 204, 255), _ => OnSolo?.Invoke(), Key.P)
+            {
+                Padding = new MarginPadding { Left = WEDGE_WIDTH },
+            });
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Multi, @"button-default-select", OsuIcon.Online, new Color4(94, 63, 186, 255), onMultiplayer, Key.M));
+            buttonsPlay.Add(new MainMenuButton(ButtonSystemStrings.Playlists, @"button-default-select", OsuIcon.Tournament, new Color4(94, 63, 186, 255), onPlaylists, Key.L));
+            buttonsPlay.Add(new DailyChallengeButton(@"button-default-select", new Color4(94, 63, 186, 255), onDailyChallenge, Key.D));
             buttonsPlay.ForEach(b => b.VisibleState = ButtonSystemState.Play);
 
-            buttonsEdit.Add(new MainMenuButton(EditorStrings.BeatmapEditor.ToLower(), @"button-default-select", OsuIcon.Beatmap, new Color4(238, 170, 0, 255), () => OnEditBeatmap?.Invoke(), WEDGE_WIDTH, Key.B, Key.E));
-            buttonsEdit.Add(new MainMenuButton(SkinEditorStrings.SkinEditor.ToLower(), @"button-default-select", OsuIcon.SkinB, new Color4(220, 160, 0, 255), () => OnEditSkin?.Invoke(), 0, Key.S));
+            buttonsEdit.Add(new MainMenuButton(EditorStrings.BeatmapEditor.ToLower(), @"button-default-select", OsuIcon.Beatmap, new Color4(238, 170, 0, 255), _ => OnEditBeatmap?.Invoke(), Key.B, Key.E)
+            {
+                Padding = new MarginPadding { Left = WEDGE_WIDTH},
+            });
+            buttonsEdit.Add(new MainMenuButton(SkinEditorStrings.SkinEditor.ToLower(), @"button-default-select", OsuIcon.SkinB, new Color4(220, 160, 0, 255), _ => OnEditSkin?.Invoke(), Key.S));
             buttonsEdit.ForEach(b => b.VisibleState = ButtonSystemState.Edit);
 
-            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Play, @"button-play-select", OsuIcon.Logo, new Color4(102, 68, 204, 255), () => State = ButtonSystemState.Play, WEDGE_WIDTH, Key.P, Key.M, Key.L));
-            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Edit, @"button-play-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), () => State = ButtonSystemState.Edit, 0, Key.E));
-            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-default-select", OsuIcon.Beatmap, new Color4(165, 204, 0, 255), () => OnBeatmapListing?.Invoke(), 0, Key.B, Key.D));
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Play, @"button-play-select", OsuIcon.Logo, new Color4(102, 68, 204, 255), _ => State = ButtonSystemState.Play, Key.P, Key.M, Key.L)
+            {
+                Padding = new MarginPadding { Left = WEDGE_WIDTH },
+            });
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Edit, @"button-play-select", OsuIcon.EditCircle, new Color4(238, 170, 0, 255), _ => State = ButtonSystemState.Edit, Key.E));
+            buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Browse, @"button-default-select", OsuIcon.Beatmap, new Color4(165, 204, 0, 255), _ => OnBeatmapListing?.Invoke(), Key.B, Key.D));
 
             if (host.CanExit)
-                buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Exit, string.Empty, OsuIcon.CrossCircle, new Color4(238, 51, 153, 255), () => OnExit?.Invoke(), 0, Key.Q));
+                buttonsTopLevel.Add(new MainMenuButton(ButtonSystemStrings.Exit, string.Empty, OsuIcon.CrossCircle, new Color4(238, 51, 153, 255), _ => OnExit?.Invoke(), Key.Q));
 
             buttonArea.AddRange(buttonsPlay);
             buttonArea.AddRange(buttonsEdit);
@@ -164,7 +179,7 @@ namespace osu.Game.Screens.Menu
             sampleLogoSwoosh = audio.Samples.Get(@"Menu/osu-logo-swoosh");
         }
 
-        private void onMultiplayer()
+        private void onMultiplayer(MainMenuButton _)
         {
             if (api.State.Value != APIState.Online)
             {
@@ -175,7 +190,7 @@ namespace osu.Game.Screens.Menu
             OnMultiplayer?.Invoke();
         }
 
-        private void onPlaylists()
+        private void onPlaylists(MainMenuButton _)
         {
             if (api.State.Value != APIState.Online)
             {
@@ -186,6 +201,20 @@ namespace osu.Game.Screens.Menu
             OnPlaylists?.Invoke();
         }
 
+        private void onDailyChallenge(MainMenuButton button)
+        {
+            if (api.State.Value != APIState.Online)
+            {
+                loginOverlay?.Show();
+                return;
+            }
+
+            var dailyChallengeButton = (DailyChallengeButton)button;
+
+            if (dailyChallengeButton.Room != null)
+                OnDailyChallenge?.Invoke(dailyChallengeButton.Room);
+        }
+
         private void updateIdleState(bool isIdle)
         {
             if (!ReturnToTopOnIdle)
diff --git a/osu.Game/Screens/Menu/DailyChallengeButton.cs b/osu.Game/Screens/Menu/DailyChallengeButton.cs
new file mode 100644
index 0000000000..907fd04148
--- /dev/null
+++ b/osu.Game/Screens/Menu/DailyChallengeButton.cs
@@ -0,0 +1,209 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Colour;
+using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Cursor;
+using osu.Framework.Graphics.Shapes;
+using osu.Framework.Threading;
+using osu.Game.Beatmaps.Drawables;
+using osu.Game.Beatmaps.Drawables.Cards;
+using osu.Game.Graphics;
+using osu.Game.Graphics.Sprites;
+using osu.Game.Localisation;
+using osu.Game.Online.API;
+using osu.Game.Online.API.Requests.Responses;
+using osu.Game.Online.Metadata;
+using osu.Game.Online.Rooms;
+using osu.Game.Overlays;
+using osuTK;
+using osuTK.Graphics;
+using osuTK.Input;
+
+namespace osu.Game.Screens.Menu
+{
+    public partial class DailyChallengeButton : MainMenuButton, IHasCustomTooltip<APIBeatmapSet?>
+    {
+        public Room? Room { get; private set; }
+
+        private readonly OsuSpriteText countdown;
+        private ScheduledDelegate? scheduledCountdownUpdate;
+
+        private UpdateableOnlineBeatmapSetCover cover = null!;
+        private IBindable<DailyChallengeInfo?> info = null!;
+        private BufferedContainer background = null!;
+
+        [Resolved]
+        private IAPIProvider api { get; set; } = null!;
+
+        public DailyChallengeButton(string sampleName, Color4 colour, Action<MainMenuButton>? clickAction = null, params Key[] triggerKeys)
+            : base(ButtonSystemStrings.DailyChallenge, sampleName, OsuIcon.DailyChallenge, colour, clickAction, triggerKeys)
+        {
+            BaseSize = new Vector2(ButtonSystem.BUTTON_WIDTH * 1.3f, ButtonArea.BUTTON_AREA_HEIGHT);
+
+            Content.Add(countdown = new OsuSpriteText
+            {
+                Shadow = true,
+                AllowMultiline = false,
+                Anchor = Anchor.BottomCentre,
+                Origin = Anchor.BottomCentre,
+                Margin = new MarginPadding
+                {
+                    Left = -3,
+                    Bottom = 22,
+                },
+                Font = OsuFont.Default.With(size: 12),
+                Alpha = 0,
+            });
+        }
+
+        protected override Drawable CreateBackground(Colour4 accentColour) => background = new BufferedContainer
+        {
+            Children = new Drawable[]
+            {
+                cover = new UpdateableOnlineBeatmapSetCover
+                {
+                    RelativeSizeAxes = Axes.Y,
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    RelativePositionAxes = Axes.X,
+                    X = -0.5f,
+                },
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = ColourInfo.GradientVertical(accentColour.Opacity(0), accentColour),
+                    Blending = BlendingParameters.Additive,
+                },
+                new Box
+                {
+                    RelativeSizeAxes = Axes.Both,
+                    Colour = accentColour.Opacity(0.7f)
+                },
+            },
+        };
+
+        [BackgroundDependencyLoader]
+        private void load(MetadataClient metadataClient)
+        {
+            info = metadataClient.DailyChallengeInfo.GetBoundCopy();
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            info.BindValueChanged(updateDisplay, true);
+            FinishTransforms(true);
+
+            cover.MoveToX(-0.5f, 10000, Easing.InOutSine)
+                 .Then().MoveToX(0.5f, 10000, Easing.InOutSine)
+                 .Loop();
+        }
+
+        protected override void Update()
+        {
+            base.Update();
+
+            cover.Width = 2 * background.DrawWidth;
+        }
+
+        private void updateDisplay(ValueChangedEvent<DailyChallengeInfo?> info)
+        {
+            UpdateState();
+
+            scheduledCountdownUpdate?.Cancel();
+            scheduledCountdownUpdate = null;
+
+            if (info.NewValue == null)
+            {
+                Room = null;
+                cover.OnlineInfo = TooltipContent = null;
+            }
+            else
+            {
+                var roomRequest = new GetRoomRequest(info.NewValue.Value.RoomID);
+
+                roomRequest.Success += room =>
+                {
+                    Room = room;
+                    cover.OnlineInfo = TooltipContent = room.Playlist.FirstOrDefault()?.Beatmap.BeatmapSet as APIBeatmapSet;
+
+                    updateCountdown();
+                    Scheduler.AddDelayed(updateCountdown, 1000, true);
+                };
+                api.Queue(roomRequest);
+            }
+        }
+
+        private void updateCountdown()
+        {
+            if (Room == null)
+                return;
+
+            var remaining = (Room.EndDate.Value - DateTimeOffset.Now) ?? TimeSpan.Zero;
+
+            if (remaining <= TimeSpan.Zero)
+            {
+                countdown.FadeOut(250, Easing.OutQuint);
+            }
+            else
+            {
+                if (countdown.Alpha == 0)
+                    countdown.FadeIn(250, Easing.OutQuint);
+
+                countdown.Text = remaining.ToString(@"hh\:mm\:ss");
+            }
+        }
+
+        protected override void UpdateState()
+        {
+            if (info.IsNotNull() && info.Value == null)
+            {
+                ContractStyle = 0;
+                State = ButtonState.Contracted;
+                return;
+            }
+
+            base.UpdateState();
+        }
+
+        public ITooltip<APIBeatmapSet?> GetCustomTooltip() => new DailyChallengeTooltip();
+
+        public APIBeatmapSet? TooltipContent { get; private set; }
+
+        internal partial class DailyChallengeTooltip : CompositeDrawable, ITooltip<APIBeatmapSet?>
+        {
+            [Cached]
+            private OverlayColourProvider colourProvider = new OverlayColourProvider(OverlayColourScheme.Purple);
+
+            private APIBeatmapSet? lastContent;
+
+            [BackgroundDependencyLoader]
+            private void load()
+            {
+                AutoSizeAxes = Axes.Both;
+            }
+
+            public void Move(Vector2 pos) => Position = pos;
+
+            public void SetContent(APIBeatmapSet? content)
+            {
+                if (content == lastContent)
+                    return;
+
+                lastContent = content;
+
+                ClearInternal();
+                if (content != null)
+                    AddInternal(new BeatmapCardNano(content));
+            }
+        }
+    }
+}
diff --git a/osu.Game/Screens/Menu/MainMenu.cs b/osu.Game/Screens/Menu/MainMenu.cs
index 235c5d5c56..722e776e3d 100644
--- a/osu.Game/Screens/Menu/MainMenu.cs
+++ b/osu.Game/Screens/Menu/MainMenu.cs
@@ -147,6 +147,12 @@ namespace osu.Game.Screens.Menu
                             OnSolo = loadSoloSongSelect,
                             OnMultiplayer = () => this.Push(new Multiplayer()),
                             OnPlaylists = () => this.Push(new Playlists()),
+                            OnDailyChallenge = room =>
+                            {
+                                Playlists playlistsScreen;
+                                this.Push(playlistsScreen = new Playlists());
+                                playlistsScreen.Join(room);
+                            },
                             OnExit = () =>
                             {
                                 exitConfirmedViaHoldOrClick = true;
diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index 1dc79e9b1a..fe8fb91766 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -38,11 +38,8 @@ namespace osu.Game.Screens.Menu
 
         public readonly Key[] TriggerKeys;
 
-        private readonly Container iconText;
-        private readonly Container box;
-        private readonly Box boxHoverLayer;
-        private readonly SpriteIcon icon;
-        private readonly string sampleName;
+        protected override Container<Drawable> Content => content;
+        private readonly Container content;
 
         /// <summary>
         /// The menu state for which we are visible for (assuming only one).
@@ -59,7 +56,24 @@ namespace osu.Game.Screens.Menu
         public ButtonSystemState VisibleStateMin = ButtonSystemState.TopLevel;
         public ButtonSystemState VisibleStateMax = ButtonSystemState.TopLevel;
 
-        private readonly Action? clickAction;
+        public new MarginPadding Padding
+        {
+            get => Content.Padding;
+            set => Content.Padding = value;
+        }
+
+        protected Vector2 BaseSize { get; init; } = new Vector2(ButtonSystem.BUTTON_WIDTH, ButtonArea.BUTTON_AREA_HEIGHT);
+
+        private readonly Action<MainMenuButton>? clickAction;
+
+        private readonly Container background;
+        private readonly Drawable backgroundContent;
+        private readonly Box boxHoverLayer;
+        private readonly SpriteIcon icon;
+
+        private Vector2 initialSize => BaseSize + Padding.Total;
+
+        private readonly string sampleName;
         private Sample? sampleClick;
         private Sample? sampleHover;
         private SampleChannel? sampleChannel;
@@ -68,9 +82,9 @@ namespace osu.Game.Screens.Menu
                                           // Allow keyboard interaction based on state rather than waiting for delayed animations.
                                           || state == ButtonState.Expanded;
 
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => box.ReceivePositionalInputAt(screenSpacePos);
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => background.ReceivePositionalInputAt(screenSpacePos);
 
-        public MainMenuButton(LocalisableString text, string sampleName, IconUsage symbol, Color4 colour, Action? clickAction = null, float extraWidth = 0, params Key[] triggerKeys)
+        public MainMenuButton(LocalisableString text, string sampleName, IconUsage symbol, Color4 colour, Action<MainMenuButton>? clickAction = null, params Key[] triggerKeys)
         {
             this.sampleName = sampleName;
             this.clickAction = clickAction;
@@ -79,11 +93,9 @@ namespace osu.Game.Screens.Menu
             AutoSizeAxes = Axes.Both;
             Alpha = 0;
 
-            Vector2 boxSize = new Vector2(ButtonSystem.BUTTON_WIDTH + Math.Abs(extraWidth), ButtonArea.BUTTON_AREA_HEIGHT);
-
-            Children = new Drawable[]
+            AddRangeInternal(new Drawable[]
             {
-                box = new Container
+                background = new Container
                 {
                     // box needs to be always present to ensure the button is always sized correctly for flow
                     AlwaysPresent = true,
@@ -98,35 +110,46 @@ namespace osu.Game.Screens.Menu
                     },
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    Scale = new Vector2(0, 1),
-                    Size = boxSize,
-                    Shear = new Vector2(ButtonSystem.WEDGE_WIDTH / boxSize.Y, 0),
                     Children = new[]
                     {
-                        new Box
+                        backgroundContent = CreateBackground(colour).With(bg =>
                         {
-                            EdgeSmoothness = new Vector2(1.5f, 0),
-                            RelativeSizeAxes = Axes.Both,
-                            Colour = colour,
-                        },
+                            bg.RelativeSizeAxes = Axes.Y;
+                            bg.X = -ButtonSystem.WEDGE_WIDTH;
+                            bg.Anchor = Anchor.Centre;
+                            bg.Origin = Anchor.Centre;
+                        }),
                         boxHoverLayer = new Box
                         {
                             EdgeSmoothness = new Vector2(1.5f, 0),
                             RelativeSizeAxes = Axes.Both,
                             Blending = BlendingParameters.Additive,
                             Colour = Color4.White,
+                            Depth = float.MinValue,
                             Alpha = 0,
                         },
                     }
                 },
-                iconText = new Container
+                content = new Container
                 {
-                    AutoSizeAxes = Axes.Both,
-                    Position = new Vector2(extraWidth / 2, 0),
+                    RelativeSizeAxes = Axes.Both,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
                     Children = new Drawable[]
                     {
+                        new OsuSpriteText
+                        {
+                            Shadow = true,
+                            AllowMultiline = false,
+                            Anchor = Anchor.BottomCentre,
+                            Origin = Anchor.BottomCentre,
+                            Margin = new MarginPadding
+                            {
+                                Left = -3,
+                                Bottom = 7,
+                            },
+                            Text = text
+                        },
                         icon = new SpriteIcon
                         {
                             Shadow = true,
@@ -136,20 +159,36 @@ namespace osu.Game.Screens.Menu
                             Position = new Vector2(0, 0),
                             Margin = new MarginPadding { Top = -4 },
                             Icon = symbol
-                        },
-                        new OsuSpriteText
-                        {
-                            Shadow = true,
-                            AllowMultiline = false,
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Position = new Vector2(0, 35),
-                            Margin = new MarginPadding { Left = -3 },
-                            Text = text
                         }
                     }
                 }
-            };
+            });
+        }
+
+        protected virtual Drawable CreateBackground(Colour4 accentColour) => new Container
+        {
+            Child = new Box
+            {
+                EdgeSmoothness = new Vector2(1.5f, 0),
+                RelativeSizeAxes = Axes.Both,
+                Colour = accentColour,
+            }
+        };
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            background.Size = initialSize;
+            background.Shear = new Vector2(ButtonSystem.WEDGE_WIDTH / initialSize.Y, 0);
+
+            // for whatever reason, attempting to size the background "just in time" to cover the visible width
+            // results in gaps when the width changes are quick (only visible when testing menu at 100% speed, not visible slowed down).
+            // to ensure there's no missing backdrop, just use a ballpark that should be enough to always cover the width and then some.
+            // note that while on a code inspections it would seem that `1.5 * initialSize.X` would be enough, elastic usings are used in this button
+            // (which can exceed the [0;1] range during interpolation).
+            backgroundContent.Width = 2 * initialSize.X;
+            backgroundContent.Shear = -background.Shear;
         }
 
         private bool rightward;
@@ -179,15 +218,15 @@ namespace osu.Game.Screens.Menu
         {
             if (State != ButtonState.Expanded) return true;
 
-            sampleHover?.Play();
-
-            box.ScaleTo(new Vector2(1.5f, 1), 500, Easing.OutElastic);
-
             double duration = TimeUntilNextBeat;
 
             icon.ClearTransforms();
             icon.RotateTo(rightward ? -BOUNCE_ROTATION : BOUNCE_ROTATION, duration, Easing.InOutSine);
             icon.ScaleTo(new Vector2(HOVER_SCALE, HOVER_SCALE * BOUNCE_COMPRESSION), duration, Easing.Out);
+
+            sampleHover?.Play();
+            background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(1.5f, 1)), 500, Easing.OutElastic);
+
             return true;
         }
 
@@ -199,7 +238,7 @@ namespace osu.Game.Screens.Menu
             icon.ScaleTo(Vector2.One, 200, Easing.Out);
 
             if (State == ButtonState.Expanded)
-                box.ScaleTo(new Vector2(1, 1), 500, Easing.OutElastic);
+                background.ResizeTo(initialSize, 500, Easing.OutElastic);
         }
 
         [BackgroundDependencyLoader]
@@ -246,7 +285,7 @@ namespace osu.Game.Screens.Menu
             sampleChannel = sampleClick?.GetChannel();
             sampleChannel?.Play();
 
-            clickAction?.Invoke();
+            clickAction?.Invoke(this);
 
             boxHoverLayer.ClearTransforms();
             boxHoverLayer.Alpha = 0.9f;
@@ -254,13 +293,13 @@ namespace osu.Game.Screens.Menu
         }
 
         public override bool HandleNonPositionalInput => state == ButtonState.Expanded;
-        public override bool HandlePositionalInput => state != ButtonState.Exploded && box.Scale.X >= 0.8f;
+        public override bool HandlePositionalInput => state != ButtonState.Exploded && background.Width / initialSize.X >= 0.8f;
 
         public void StopSamplePlayback() => sampleChannel?.Stop();
 
         protected override void Update()
         {
-            iconText.Alpha = Math.Clamp((box.Scale.X - 0.5f) / 0.3f, 0, 1);
+            content.Alpha = Math.Clamp((background.Width / initialSize.X - 0.5f) / 0.3f, 0, 1);
             base.Update();
         }
 
@@ -285,12 +324,12 @@ namespace osu.Game.Screens.Menu
                         switch (ContractStyle)
                         {
                             default:
-                                box.ScaleTo(new Vector2(0, 1), 500, Easing.OutExpo);
+                                background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 500, Easing.OutExpo);
                                 this.FadeOut(500);
                                 break;
 
                             case 1:
-                                box.ScaleTo(new Vector2(0, 1), 400, Easing.InSine);
+                                background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 400, Easing.InSine);
                                 this.FadeOut(800);
                                 break;
                         }
@@ -299,13 +338,13 @@ namespace osu.Game.Screens.Menu
 
                     case ButtonState.Expanded:
                         const int expand_duration = 500;
-                        box.ScaleTo(new Vector2(1, 1), expand_duration, Easing.OutExpo);
+                        background.ResizeTo(initialSize, expand_duration, Easing.OutExpo);
                         this.FadeIn(expand_duration / 6f);
                         break;
 
                     case ButtonState.Exploded:
                         const int explode_duration = 200;
-                        box.ScaleTo(new Vector2(2, 1), explode_duration, Easing.OutExpo);
+                        background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(2, 1)), explode_duration, Easing.OutExpo);
                         this.FadeOut(explode_duration / 4f * 3);
                         break;
                 }
@@ -314,32 +353,44 @@ namespace osu.Game.Screens.Menu
             }
         }
 
+        private ButtonSystemState buttonSystemState;
+
         public ButtonSystemState ButtonSystemState
         {
+            get => buttonSystemState;
             set
             {
-                ContractStyle = 0;
+                if (buttonSystemState == value)
+                    return;
 
-                switch (value)
-                {
-                    case ButtonSystemState.Initial:
+                buttonSystemState = value;
+                UpdateState();
+            }
+        }
+
+        protected virtual void UpdateState()
+        {
+            ContractStyle = 0;
+
+            switch (ButtonSystemState)
+            {
+                case ButtonSystemState.Initial:
+                    State = ButtonState.Contracted;
+                    break;
+
+                case ButtonSystemState.EnteringMode:
+                    ContractStyle = 1;
+                    State = ButtonState.Contracted;
+                    break;
+
+                default:
+                    if (ButtonSystemState <= VisibleStateMax && ButtonSystemState >= VisibleStateMin)
+                        State = ButtonState.Expanded;
+                    else if (ButtonSystemState < VisibleStateMin)
                         State = ButtonState.Contracted;
-                        break;
-
-                    case ButtonSystemState.EnteringMode:
-                        ContractStyle = 1;
-                        State = ButtonState.Contracted;
-                        break;
-
-                    default:
-                        if (value <= VisibleStateMax && value >= VisibleStateMin)
-                            State = ButtonState.Expanded;
-                        else if (value < VisibleStateMin)
-                            State = ButtonState.Contracted;
-                        else
-                            State = ButtonState.Exploded;
-                        break;
-                }
+                    else
+                        State = ButtonState.Exploded;
+                    break;
             }
         }
     }
diff --git a/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs b/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs
index f1d2384c2f..9e615ffa98 100644
--- a/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs
+++ b/osu.Game/Screens/OnlinePlay/Playlists/Playlists.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using osu.Game.Online.Rooms;
 using osu.Game.Screens.OnlinePlay.Lounge;
 
 namespace osu.Game.Screens.OnlinePlay.Playlists
@@ -10,5 +11,7 @@ namespace osu.Game.Screens.OnlinePlay.Playlists
         protected override string ScreenTitle => "Playlists";
 
         protected override LoungeSubScreen CreateLounge() => new PlaylistsLoungeSubScreen();
+
+        public void Join(Room room) => Schedule(() => Lounge.Join(room, string.Empty));
     }
 }

From c9b7aaf442c89fcf4f27cfea3171ed4b4a90d8e1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 May 2024 11:50:23 +0200
Subject: [PATCH 844/930] Fix formatting

---
 osu.Game/Screens/Menu/ButtonSystem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Menu/ButtonSystem.cs b/osu.Game/Screens/Menu/ButtonSystem.cs
index 33d2a8d348..e9fff9bb07 100644
--- a/osu.Game/Screens/Menu/ButtonSystem.cs
+++ b/osu.Game/Screens/Menu/ButtonSystem.cs
@@ -143,7 +143,7 @@ namespace osu.Game.Screens.Menu
 
             buttonsEdit.Add(new MainMenuButton(EditorStrings.BeatmapEditor.ToLower(), @"button-default-select", OsuIcon.Beatmap, new Color4(238, 170, 0, 255), _ => OnEditBeatmap?.Invoke(), Key.B, Key.E)
             {
-                Padding = new MarginPadding { Left = WEDGE_WIDTH},
+                Padding = new MarginPadding { Left = WEDGE_WIDTH },
             });
             buttonsEdit.Add(new MainMenuButton(SkinEditorStrings.SkinEditor.ToLower(), @"button-default-select", OsuIcon.SkinB, new Color4(220, 160, 0, 255), _ => OnEditSkin?.Invoke(), Key.S));
             buttonsEdit.ForEach(b => b.VisibleState = ButtonSystemState.Edit);

From a4142937e75ec240b91f930614354dae5c63d9fd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 May 2024 12:53:25 +0200
Subject: [PATCH 845/930] Update resources

---
 osu.Game/osu.Game.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index f91995feff..821a7f1fab 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -36,7 +36,7 @@
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
     <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.517.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />

From 2027d481eecdd433f91f23a498ca7c7ee81dfa6c Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 May 2024 06:38:25 +0300
Subject: [PATCH 846/930] Remove `TreatWarningsAsErrors` flags from local
 builds for developer convenience

---
 Directory.Build.props | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Directory.Build.props b/Directory.Build.props
index 2d289d0f22..5ba12b845b 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -2,7 +2,6 @@
 <Project>
   <PropertyGroup Label="C#">
     <LangVersion>12.0</LangVersion>
-    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <Nullable>enable</Nullable>
   </PropertyGroup>
   <PropertyGroup>

From 0af32c5d4b0092f737bb91c3cac3498aebd40df8 Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Sat, 18 May 2024 07:45:01 +0200
Subject: [PATCH 847/930] Added a minimum value for the scale calculated by the
 CS value.

---
 osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs b/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
index 2a5a11161b..1d3416f494 100644
--- a/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             // It works out to under 1 game pixel and is generally not meaningful to gameplay, but is to replay playback accuracy.
             const float broken_gamefield_rounding_allowance = 1.00041f;
 
-            return (float)(1.0f - 0.7f * IBeatmapDifficultyInfo.DifficultyRange(circleSize)) / 2 * (applyFudge ? broken_gamefield_rounding_allowance : 1);
+            return (float)Math.Max(0.02, (1.0f - 0.7f * IBeatmapDifficultyInfo.DifficultyRange(circleSize)) / 2 * (applyFudge ? broken_gamefield_rounding_allowance : 1));
         }
 
         public static int CalculateDifficultyPeppyStars(BeatmapDifficulty difficulty, int objectCount, int drainLength)

From a912e56ca995db8560785761209f68dcc93a0e43 Mon Sep 17 00:00:00 2001
From: Salman Ahmed <frenzibyte@gmail.com>
Date: Sat, 18 May 2024 11:04:40 +0300
Subject: [PATCH 848/930] Fix checkboxes applying extra padding

---
 osu.Game/Graphics/UserInterface/OsuCheckbox.cs | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
index b7b405a7e8..caab3d97f8 100644
--- a/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
+++ b/osu.Game/Graphics/UserInterface/OsuCheckbox.cs
@@ -52,8 +52,6 @@ namespace osu.Game.Graphics.UserInterface
             AutoSizeAxes = Axes.Y;
             RelativeSizeAxes = Axes.X;
 
-            const float nub_padding = 5;
-
             Children = new Drawable[]
             {
                 LabelTextFlowContainer = new OsuTextFlowContainer(ApplyLabelParameters)
@@ -69,15 +67,13 @@ namespace osu.Game.Graphics.UserInterface
             {
                 Nub.Anchor = Anchor.CentreRight;
                 Nub.Origin = Anchor.CentreRight;
-                Nub.Margin = new MarginPadding { Right = nub_padding };
-                LabelTextFlowContainer.Padding = new MarginPadding { Right = Nub.DEFAULT_EXPANDED_SIZE + nub_padding * 2 };
+                LabelTextFlowContainer.Padding = new MarginPadding { Right = Nub.DEFAULT_EXPANDED_SIZE + 10f };
             }
             else
             {
                 Nub.Anchor = Anchor.CentreLeft;
                 Nub.Origin = Anchor.CentreLeft;
-                Nub.Margin = new MarginPadding { Left = nub_padding };
-                LabelTextFlowContainer.Padding = new MarginPadding { Left = Nub.DEFAULT_EXPANDED_SIZE + nub_padding * 2 };
+                LabelTextFlowContainer.Padding = new MarginPadding { Left = Nub.DEFAULT_EXPANDED_SIZE + 10f };
             }
 
             Nub.Current.BindTo(Current);

From a12a20e8b503bdb2a5647bebefe05de33b0553be Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Sat, 18 May 2024 18:37:44 +0200
Subject: [PATCH 849/930] Change Inputkeys to Ctrl+Up/Ctrl+Down

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index 5dacb6db4d..b0a1684512 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -182,8 +182,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
             new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
             new KeyBinding(InputKey.BackSpace, GlobalAction.DeselectAllMods),
-            new KeyBinding(InputKey.PageUp, GlobalAction.IncreaseSpeed),
-            new KeyBinding(InputKey.PageDown, GlobalAction.DecreaseSpeed),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Up }, GlobalAction.IncreaseSpeed),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Down }, GlobalAction.DecreaseSpeed),
         };
 
         private static IEnumerable<KeyBinding> audioControlKeyBindings => new[]

From 80064c4b98d955431ac423578b3a9c55b3f4ae7e Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Sat, 18 May 2024 18:38:23 +0200
Subject: [PATCH 850/930] Speedchange now also works in Modselect

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 25293e8e20..572379ea2c 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -27,6 +27,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Select;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
@@ -63,6 +64,9 @@ namespace osu.Game.Overlays.Mods
 
         private Func<Mod, bool> isValidMod = _ => true;
 
+        [Resolved]
+        private SongSelect? songSelect { get; set; }
+
         /// <summary>
         /// A function determining whether each mod in the column should be displayed.
         /// A return value of <see langword="true"/> means that the mod is not filtered and therefore its corresponding panel should be displayed.
@@ -752,6 +756,14 @@ namespace osu.Game.Overlays.Mods
 
                     return true;
                 }
+
+                case GlobalAction.IncreaseSpeed:
+                    songSelect!.ChangeSpeed(0.05);
+                    return true;
+
+                case GlobalAction.DecreaseSpeed:
+                    songSelect!.ChangeSpeed(-0.05);
+                    return true;
             }
 
             return base.OnPressed(e);

From 99f30d92c84789670b40ae3989cd52b2dc3a3dc2 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Sat, 18 May 2024 18:38:31 +0200
Subject: [PATCH 851/930] Add Unit Tests

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 78 +++++++++++++++++++
 1 file changed, 78 insertions(+)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index e03ffd48f1..938b858110 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -87,6 +87,84 @@ namespace osu.Game.Tests.Visual.SongSelect
             AddStep("delete all beatmaps", () => manager.Delete());
         }
 
+        [Test]
+        public void TestSpeedChange()
+        {
+            createSongSelect();
+            changeMods();
+
+            AddStep("decreasing speed without mods", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.95);
+
+            AddStep("decreasing speed with halftime", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("halftime at 0.9", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.9);
+
+            AddStep("increasing speed with halftime", () => songSelect?.ChangeSpeed(+0.05));
+            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.95);
+
+            AddStep("increasing speed with halftime to nomod", () => songSelect?.ChangeSpeed(+0.05));
+            AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
+
+            AddStep("increasing speed without mods", () => songSelect?.ChangeSpeed(+0.05));
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.05);
+
+            AddStep("increasing speed with doubletime", () => songSelect?.ChangeSpeed(+0.05));
+            AddAssert("doubletime at 1.1", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.1);
+
+            AddStep("decreasing speed with doubletime", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.05);
+
+            OsuModNightcore nc = new OsuModNightcore
+            {
+                SpeedChange = { Value = 1.05 }
+            };
+            changeMods(nc);
+            AddStep("increasing speed with nightcore", () => songSelect?.ChangeSpeed(+0.05));
+            AddAssert("nightcore at 1.1", () => songSelect!.Mods.Value.Single() is ModNightcore mod && mod.SpeedChange.Value == 1.1);
+
+            AddStep("decreasing speed with nightcore", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModNightcore mod && mod.SpeedChange.Value == 1.05);
+
+            AddStep("decreasing speed with nightcore to nomod", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
+
+            AddStep("decreasing speed nomod, nightcore was selected", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.95);
+
+            AddStep("decreasing speed with daycore", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("daycore at 0.9", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.9);
+
+            AddStep("increasing speed with daycore", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.95);
+
+            OsuModDoubleTime dt = new OsuModDoubleTime
+            {
+                SpeedChange = { Value = 1.02 },
+                AdjustPitch = { Value = true },
+            };
+            changeMods(dt);
+            AddStep("decreasing speed from doubletime 1.02 with adjustpitch enabled", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("halftime at 0.97 with adjustpitch enabled", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.97 && mod.AdjustPitch.Value);
+
+            OsuModHalfTime ht = new OsuModHalfTime
+            {
+                SpeedChange = { Value = 0.97 },
+                AdjustPitch = { Value = true },
+            };
+            Mod[] modlist = { ht, new OsuModHardRock(), new OsuModHidden() };
+            changeMods(modlist);
+            AddStep("decreasing speed from halftime 0.97 with adjustpitch enabled, HDHR enabled", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("doubletime at 1.02 with adjustpitch enabled, HDHR still enabled", () => songSelect!.Mods.Value.Count(mod => (mod is ModDoubleTime modDt && modDt.AdjustPitch.Value && modDt.SpeedChange.Value == 1.02) || mod is ModHardRock || mod is ModHidden) == 3);
+
+            changeMods(new ModWindUp());
+            AddStep("windup active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("windup still active", () => songSelect!.Mods.Value.First() is ModWindUp);
+
+            changeMods(new ModAdaptiveSpeed());
+            AddStep("adaptivespeed active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("adaptivespeed still active", () => songSelect!.Mods.Value.First() is ModAdaptiveSpeed);
+        }
+
         [Test]
         public void TestPlaceholderBeatmapPresence()
         {

From 3fdbd735ce063653bb92b7570df716e700a9b529 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Sat, 18 May 2024 18:40:51 +0200
Subject: [PATCH 852/930] change to single Function, Nightcore now switches
 into Daycore, keep Adjustpitch after change

---
 osu.Game/Screens/Select/SongSelect.cs | 182 +++++++++++++++-----------
 1 file changed, 109 insertions(+), 73 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index de0f24aa90..e1447b284a 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -98,6 +98,9 @@ namespace osu.Game.Screens.Select
             new OsuMenuItem(@"Select", MenuItemType.Highlighted, () => FinaliseSelection(getBeatmap()))
         };
 
+        [Resolved]
+        private OsuGameBase? game { get; set; }
+
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; } = null!;
 
@@ -144,6 +147,10 @@ namespace osu.Game.Screens.Select
 
         private Bindable<bool> configBackgroundBlur = null!;
 
+        private bool lastPitchState;
+
+        private bool usedPitchMods;
+
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, OsuColour colours, ManageCollectionsDialog? manageCollectionsDialog, DifficultyRecommender? recommender, OsuConfigManager config)
         {
@@ -809,94 +816,123 @@ namespace osu.Game.Screens.Select
             return false;
         }
 
-        private void increaseSpeed()
+        public void ChangeSpeed(double delta)
         {
-            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
-            var stateDoubleTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModDoubleTime);
-            bool rateModActive = ModSelect.AllAvailableMods.Count(pair => pair.Mod is ModRateAdjust && pair.Active.Value) > 0;
-            const double stepsize = 0.05d;
-            double newRate = 1d + stepsize;
+            // Mod Change from 0.95 DC to 1.0 none to 1.05 DT/NC ?
 
-            // If no mod rateAdjust mod is currently active activate DoubleTime with speed newRate
-            if (!rateModActive)
-            {
-                stateDoubleTime.Active.Value = true;
-                ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
+            if (game == null) return;
+
+            ModNightcore modNc = (ModNightcore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModNightcore) > 0)).Mods.First(mod => mod is ModNightcore);
+            ModDoubleTime modDt = (ModDoubleTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDoubleTime) > 0)).Mods.First(mod => mod is ModDoubleTime);
+            ModDaycore modDc = (ModDaycore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDaycore) > 0)).Mods.First(mod => mod is ModDaycore);
+            ModHalfTime modHt = (ModHalfTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModHalfTime) > 0)).Mods.First(mod => mod is ModHalfTime);
+            bool rateModActive = selectedMods.Value.Count(mod => mod is ModRateAdjust) > 0;
+            bool incompatiableModActive = selectedMods.Value.Count(mod => modDt.IncompatibleMods.Count(incompatibleMod => (mod.GetType().IsSubclassOf(incompatibleMod) || mod.GetType() == incompatibleMod) && incompatibleMod != typeof(ModRateAdjust)) > 0) > 0;
+            double newRate = 1d + delta;
+            bool isPositive = delta > 0;
+
+            if (incompatiableModActive)
                 return;
-            }
 
-            // Find current active rateAdjust mod and modify speed, enable DoubleTime if necessary
-            foreach (var state in rateAdjustStates)
+            if (rateModActive)
             {
-                ModRateAdjust mod = (ModRateAdjust)state.Mod;
+                ModRateAdjust mod = (ModRateAdjust)selectedMods.Value.First(mod => mod is ModRateAdjust);
 
-                if (!state.Active.Value) continue;
+                // Find current active rateAdjust mod and modify speed, enable HalfTime if necessary
+                newRate = mod.SpeedChange.Value + delta;
 
-                newRate = mod.SpeedChange.Value + stepsize;
-
-                if (mod.Acronym == "DT" || mod.Acronym == "NC")
-                    mod.SpeedChange.Value = newRate;
-                else
+                if (newRate == 1.0)
                 {
-                    if (newRate == 1.0d)
-                        state.Active.Value = false;
+                    lastPitchState = false;
+                    usedPitchMods = false;
 
-                    if (newRate > 1d)
-                    {
-                        state.Active.Value = false;
-                        stateDoubleTime.Active.Value = true;
-                        ((ModDoubleTime)stateDoubleTime.Mod).SpeedChange.Value = newRate;
-                        break;
-                    }
+                    if (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) lastPitchState = true;
 
-                    if (newRate < 1d)
-                        mod.SpeedChange.Value = newRate;
+                    if (mod is ModHalfTime htmod && htmod.AdjustPitch.Value) lastPitchState = true;
+
+                    if (mod is ModNightcore || mod is ModDaycore) usedPitchMods = true;
+
+                    //Disable RateAdjustMods
+                    selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
+                    return;
                 }
-            }
-        }
 
-        private void decreaseSpeed()
-        {
-            var rateAdjustStates = ModSelect.AllAvailableMods.Where(pair => pair.Mod is ModRateAdjust);
-            var stateHalfTime = ModSelect.AllAvailableMods.First(pair => pair.Mod is ModHalfTime);
-            bool rateModActive = ModSelect.AllAvailableMods.Count(pair => pair.Mod is ModRateAdjust && pair.Active.Value) > 0;
-            const double stepsize = 0.05d;
-            double newRate = 1d - stepsize;
-
-            // If no mod rateAdjust mod is currently active activate HalfTime with speed newRate
-            if (!rateModActive)
-            {
-                stateHalfTime.Active.Value = true;
-                ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
-                return;
-            }
-
-            // Find current active rateAdjust mod and modify speed, enable HalfTime if necessary
-            foreach (var state in rateAdjustStates)
-            {
-                ModRateAdjust mod = (ModRateAdjust)state.Mod;
-
-                if (!state.Active.Value) continue;
-
-                newRate = mod.SpeedChange.Value - stepsize;
-
-                if (mod.Acronym == "HT" || mod.Acronym == "DC")
-                    mod.SpeedChange.Value = newRate;
-                else
+                if (((mod is ModDoubleTime || mod is ModNightcore) && newRate < mod.SpeedChange.MinValue)
+                    || ((mod is ModHalfTime || mod is ModDaycore) && newRate > mod.SpeedChange.MaxValue))
                 {
-                    if (newRate == 1.0d)
-                        state.Active.Value = false;
+                    bool adjustPitch = (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) || (mod is ModHalfTime htmod && htmod.AdjustPitch.Value);
 
-                    if (newRate < 1d)
+                    //Disable RateAdjustMods
+                    selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
+
+                    ModRateAdjust? oppositeMod = null;
+
+                    switch (mod)
                     {
-                        state.Active.Value = false;
-                        stateHalfTime.Active.Value = true;
-                        ((ModHalfTime)stateHalfTime.Mod).SpeedChange.Value = newRate;
-                        break;
+                        case ModDoubleTime:
+                            modHt.AdjustPitch.Value = adjustPitch;
+                            oppositeMod = modHt;
+                            break;
+
+                        case ModHalfTime:
+                            modDt.AdjustPitch.Value = adjustPitch;
+                            oppositeMod = modDt;
+                            break;
+
+                        case ModNightcore:
+                            oppositeMod = modDc;
+                            break;
+
+                        case ModDaycore:
+                            oppositeMod = modNc;
+                            break;
                     }
 
-                    if (newRate > 1d)
-                        mod.SpeedChange.Value = newRate;
+                    if (oppositeMod == null) return;
+
+                    oppositeMod.SpeedChange.Value = newRate;
+                    selectedMods.Value = selectedMods.Value.Append(oppositeMod).ToList();
+                    return;
+                }
+
+                if (newRate > mod.SpeedChange.MaxValue && (mod is ModDoubleTime || mod is ModNightcore))
+                    newRate = mod.SpeedChange.MaxValue;
+
+                if (newRate < mod.SpeedChange.MinValue && (mod is ModHalfTime || mod is ModDaycore))
+                    newRate = mod.SpeedChange.MinValue;
+
+                mod.SpeedChange.Value = newRate;
+            }
+            else
+            {
+                // If no ModRateAdjust is actived activate one
+                if (isPositive)
+                {
+                    if (!usedPitchMods)
+                    {
+                        modDt.SpeedChange.Value = newRate;
+                        modDt.AdjustPitch.Value = lastPitchState;
+                        selectedMods.Value = selectedMods.Value.Append(modDt).ToList();
+                    }
+                    else
+                    {
+                        modNc.SpeedChange.Value = newRate;
+                        selectedMods.Value = selectedMods.Value.Append(modNc).ToList();
+                    }
+                }
+                else
+                {
+                    if (!usedPitchMods)
+                    {
+                        modHt.SpeedChange.Value = newRate;
+                        modHt.AdjustPitch.Value = lastPitchState;
+                        selectedMods.Value = selectedMods.Value.Append(modHt).ToList();
+                    }
+                    else
+                    {
+                        modDc.SpeedChange.Value = newRate;
+                        selectedMods.Value = selectedMods.Value.Append(modDc).ToList();
+                    }
                 }
             }
         }
@@ -1111,11 +1147,11 @@ namespace osu.Game.Screens.Select
                     return true;
 
                 case GlobalAction.IncreaseSpeed:
-                    increaseSpeed();
+                    ChangeSpeed(0.05);
                     return true;
 
                 case GlobalAction.DecreaseSpeed:
-                    decreaseSpeed();
+                    ChangeSpeed(-0.05);
                     return true;
             }
 

From 614cbdf0a404487ebbeea3d98766781800a9ad0f Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 18 May 2024 22:51:58 +0300
Subject: [PATCH 853/930] Reduce container nesting in PathControlPointPiece

---
 .../Components/PathControlPointPiece.cs       | 50 +++++++------------
 1 file changed, 17 insertions(+), 33 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
index c6e05d3ca3..9d819f6cc0 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointPiece.cs
@@ -8,9 +8,9 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Input.Events;
 using osu.Framework.Localisation;
 using osu.Game.Graphics;
@@ -40,7 +40,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         public readonly PathControlPoint ControlPoint;
 
         private readonly T hitObject;
-        private readonly Container marker;
+        private readonly Circle circle;
         private readonly Drawable markerRing;
 
         [Resolved]
@@ -60,38 +60,22 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             Origin = Anchor.Centre;
             AutoSizeAxes = Axes.Both;
 
-            InternalChildren = new Drawable[]
+            InternalChildren = new[]
             {
-                marker = new Container
+                circle = new Circle
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    AutoSizeAxes = Axes.Both,
-                    Children = new[]
-                    {
-                        new Circle
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Size = new Vector2(20),
-                        },
-                        markerRing = new CircularContainer
-                        {
-                            Anchor = Anchor.Centre,
-                            Origin = Anchor.Centre,
-                            Size = new Vector2(28),
-                            Masking = true,
-                            BorderThickness = 2,
-                            BorderColour = Color4.White,
-                            Alpha = 0,
-                            Child = new Box
-                            {
-                                RelativeSizeAxes = Axes.Both,
-                                Alpha = 0,
-                                AlwaysPresent = true
-                            }
-                        }
-                    }
+                    Size = new Vector2(20),
+                },
+                markerRing = new CircularProgress
+                {
+                    Anchor = Anchor.Centre,
+                    Origin = Anchor.Centre,
+                    Size = new Vector2(28),
+                    Alpha = 0,
+                    InnerRadius = 0.1f,
+                    Progress = 1
                 }
             };
         }
@@ -115,7 +99,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         }
 
         // The connecting path is excluded from positional input
-        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => marker.ReceivePositionalInputAt(screenSpacePos);
+        public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => circle.ReceivePositionalInputAt(screenSpacePos);
 
         protected override bool OnHover(HoverEvent e)
         {
@@ -209,8 +193,8 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             if (IsHovered || IsSelected.Value)
                 colour = colour.Lighten(1);
 
-            marker.Colour = colour;
-            marker.Scale = new Vector2(hitObject.Scale);
+            Colour = colour;
+            Scale = new Vector2(hitObject.Scale);
         }
 
         private Color4 getColourFromNodeType()

From be642c8c428966665fff99b0383a9d5404da801f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Sun, 19 May 2024 09:41:08 +0200
Subject: [PATCH 854/930] Fix total score without mods migration failing on
 custom ruleset scores when custom ruleset cannot be loaded

Closes https://github.com/ppy/osu/issues/28209.

Yes this means that such scores will have a zero total score without
mods in DB and thus might up getting their total recalculated to zero
when we try a mod multiplier rebalance (unless we skip scores with zero
completely I suppose). I also don't really care about that right now.
---
 osu.Game/Database/RealmAccess.cs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 63f61228f3..1ece81be50 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -1134,7 +1134,17 @@ namespace osu.Game.Database
 
                 case 41:
                     foreach (var score in migration.NewRealm.All<ScoreInfo>())
-                        LegacyScoreDecoder.PopulateTotalScoreWithoutMods(score);
+                    {
+                        try
+                        {
+                            // this can fail e.g. if a user has a score set on a ruleset that can no longer be loaded.
+                            LegacyScoreDecoder.PopulateTotalScoreWithoutMods(score);
+                        }
+                        catch (Exception ex)
+                        {
+                            Logger.Log($@"Failed to populate total score without mods for score {score.ID}: {ex}", LoggingTarget.Database);
+                        }
+                    }
 
                     break;
             }

From e4858a975dda5a07d7b39b3b0b875167ff4cf5d1 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sun, 19 May 2024 14:07:40 +0200
Subject: [PATCH 855/930] Show mouse and joystick settings on mobile

---
 osu.Game/OsuGameBase.cs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5533ee8337..5e4ec5a61d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -578,17 +578,17 @@ namespace osu.Game
                 {
                     case ITabletHandler th:
                         return new TabletSettings(th);
-
-                    case MouseHandler mh:
-                        return new MouseSettings(mh);
-
-                    case JoystickHandler jh:
-                        return new JoystickSettings(jh);
                 }
             }
 
             switch (handler)
             {
+                case MouseHandler mh:
+                    return new MouseSettings(mh);
+
+                case JoystickHandler jh:
+                    return new JoystickSettings(jh);
+
                 case TouchHandler th:
                     return new TouchSettings(th);
 

From 04acc58b7405836a205d05c4d0e1840884385988 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Sun, 19 May 2024 14:12:21 +0200
Subject: [PATCH 856/930] Don't show warning on android

Unsure about iOS.
---
 .../Settings/Sections/Input/MouseSettings.cs      | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
index 7805ed5834..6eb512fa35 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/MouseSettings.cs
@@ -105,12 +105,17 @@ namespace osu.Game.Overlays.Settings.Sections.Input
 
             highPrecisionMouse.Current.BindValueChanged(highPrecision =>
             {
-                if (RuntimeInfo.OS != RuntimeInfo.Platform.Windows)
+                switch (RuntimeInfo.OS)
                 {
-                    if (highPrecision.NewValue)
-                        highPrecisionMouse.SetNoticeText(MouseSettingsStrings.HighPrecisionPlatformWarning, true);
-                    else
-                        highPrecisionMouse.ClearNoticeText();
+                    case RuntimeInfo.Platform.Linux:
+                    case RuntimeInfo.Platform.macOS:
+                    case RuntimeInfo.Platform.iOS:
+                        if (highPrecision.NewValue)
+                            highPrecisionMouse.SetNoticeText(MouseSettingsStrings.HighPrecisionPlatformWarning, true);
+                        else
+                            highPrecisionMouse.ClearNoticeText();
+
+                        break;
                 }
             }, true);
         }

From 609268786f540e42996b711eab525f1e531044c4 Mon Sep 17 00:00:00 2001
From: James Wilson <tsunyoku@gmail.com>
Date: Sun, 19 May 2024 13:28:46 +0100
Subject: [PATCH 857/930] remove unneeded extra `Previous` calls from
 `RhythmEvaluator`

---
 .../Difficulty/Evaluators/RhythmEvaluator.cs                  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
index 05939bb3ab..f23e8329fa 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
@@ -66,10 +66,10 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
                     }
                     else
                     {
-                        if (current.Previous(i - 1).BaseObject is Slider) // bpm change is into slider, this is easy acc window
+                        if (currObj.BaseObject is Slider) // bpm change is into slider, this is easy acc window
                             effectiveRatio *= 0.125;
 
-                        if (current.Previous(i).BaseObject is Slider) // bpm change was from a slider, this is easier typically than circle -> circle
+                        if (prevObj.BaseObject is Slider) // bpm change was from a slider, this is easier typically than circle -> circle
                             effectiveRatio *= 0.25;
 
                         if (previousIslandSize == islandSize) // repeated island size (ex: triplet -> triplet)

From f31928875bc8510f6bfe38b95902dbb12f5e415d Mon Sep 17 00:00:00 2001
From: James Wilson <tsunyoku@gmail.com>
Date: Sun, 19 May 2024 16:26:51 +0100
Subject: [PATCH 858/930] Reduce `Previous` calls in `RhythmEvaluator` by
 optimising loop logic

---
 .../Difficulty/Evaluators/RhythmEvaluator.cs              | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
index 05939bb3ab..a121b1de0b 100644
--- a/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
+++ b/osu.Game.Rulesets.Osu/Difficulty/Evaluators/RhythmEvaluator.cs
@@ -36,11 +36,12 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
             while (rhythmStart < historicalNoteCount - 2 && current.StartTime - current.Previous(rhythmStart).StartTime < history_time_max)
                 rhythmStart++;
 
+            OsuDifficultyHitObject prevObj = (OsuDifficultyHitObject)current.Previous(rhythmStart);
+            OsuDifficultyHitObject lastObj = (OsuDifficultyHitObject)current.Previous(rhythmStart + 1);
+
             for (int i = rhythmStart; i > 0; i--)
             {
                 OsuDifficultyHitObject currObj = (OsuDifficultyHitObject)current.Previous(i - 1);
-                OsuDifficultyHitObject prevObj = (OsuDifficultyHitObject)current.Previous(i);
-                OsuDifficultyHitObject lastObj = (OsuDifficultyHitObject)current.Previous(i + 1);
 
                 double currHistoricalDecay = (history_time_max - (current.StartTime - currObj.StartTime)) / history_time_max; // scales note 0 to 1 from history to now
 
@@ -100,6 +101,9 @@ namespace osu.Game.Rulesets.Osu.Difficulty.Evaluators
                     startRatio = effectiveRatio;
                     islandSize = 1;
                 }
+
+                lastObj = prevObj;
+                prevObj = currObj;
             }
 
             return Math.Sqrt(4 + rhythmComplexitySum * rhythm_multiplier) / 2; //produces multiplier that can be applied to strain. range [1, infinity) (not really though)

From c03f68413a11770c6d59f3d363dc7d16f21ebdfe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 09:43:25 +0200
Subject: [PATCH 859/930] Fix skin editor closest origin selection spazzing out
 on scaled sprites

Closes https://github.com/ppy/osu/issues/28215.

`drawable.Position` is a location in the parent's coordinate space, and
`drawable.OriginPosition` is in the drawable's local space and
additionally does not take scale into account.
---
 osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index 75bb77fa73..28b2435346 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -425,9 +425,9 @@ namespace osu.Game.Overlays.SkinEditor
         {
             if (origin == drawable.Origin) return;
 
-            var previousOrigin = drawable.OriginPosition;
+            var previousOrigin = drawable.ToParentSpace(drawable.OriginPosition);
             drawable.Origin = origin;
-            drawable.Position += drawable.OriginPosition - previousOrigin;
+            drawable.Position += drawable.ToParentSpace(drawable.OriginPosition) - previousOrigin;
         }
 
         private static void adjustScaleFromAnchor(ref Vector2 scale, Anchor reference)

From 3da3b91be51526c1d40e016ddf9002134f9d788c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 10:14:08 +0200
Subject: [PATCH 860/930] Improve closest origin selection to include effects
 of rotation/flip

Closes https://github.com/ppy/osu/issues/28237.

Solution as proposed here:
https://github.com/ppy/osu/pull/28089#issuecomment-2095372157

For flips and rotations by 90 degrees this does what you would expect it
to. For arbitrary rotations it *sort of kind of* attempts to do this but
the results are a bit wonky - probably still better than what was there
before, though?
---
 .../SkinEditor/SkinSelectionHandler.cs        | 36 +++++++++++++++++--
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index 28b2435346..21909cdc10 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -5,6 +5,7 @@ using System;
 using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
@@ -421,12 +422,41 @@ namespace osu.Game.Overlays.SkinEditor
             drawable.Position -= drawable.AnchorPosition - previousAnchor;
         }
 
-        private static void applyOrigin(Drawable drawable, Anchor origin)
+        private static void applyOrigin(Drawable drawable, Anchor screenSpaceOrigin)
         {
-            if (origin == drawable.Origin) return;
+            var boundingBox = drawable.ScreenSpaceDrawQuad.AABBFloat;
+
+            var targetScreenSpacePosition = screenSpaceOrigin.PositionOnQuad(boundingBox);
+
+            Anchor localOrigin = Anchor.TopLeft;
+            float smallestDistanceFromTargetPosition = float.PositiveInfinity;
+
+            void checkOrigin(Anchor originToTest)
+            {
+                Vector2 positionToTest = drawable.ToScreenSpace(originToTest.PositionOnQuad(drawable.DrawRectangle));
+                float testedDistance = Vector2.Distance(targetScreenSpacePosition, positionToTest);
+
+                if (testedDistance < smallestDistanceFromTargetPosition)
+                {
+                    localOrigin = originToTest;
+                    smallestDistanceFromTargetPosition = testedDistance;
+                }
+            }
+
+            checkOrigin(Anchor.TopLeft);
+            checkOrigin(Anchor.TopCentre);
+            checkOrigin(Anchor.TopRight);
+
+            checkOrigin(Anchor.CentreLeft);
+            checkOrigin(Anchor.Centre);
+            checkOrigin(Anchor.CentreRight);
+
+            checkOrigin(Anchor.BottomLeft);
+            checkOrigin(Anchor.BottomCentre);
+            checkOrigin(Anchor.BottomRight);
 
             var previousOrigin = drawable.ToParentSpace(drawable.OriginPosition);
-            drawable.Origin = origin;
+            drawable.Origin = localOrigin;
             drawable.Position += drawable.ToParentSpace(drawable.OriginPosition) - previousOrigin;
         }
 

From fe0af7e720cf17fdbf49842c94ba2d05f6055daf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 11:36:39 +0200
Subject: [PATCH 861/930] Fix unnecessary padding of empty strings for discord
 RPC purposes

Closes https://github.com/ppy/osu/issues/28248.

Destroy all software.
---
 osu.Desktop/DiscordRichPresence.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Desktop/DiscordRichPresence.cs b/osu.Desktop/DiscordRichPresence.cs
index 3e0a9099cb..780d367900 100644
--- a/osu.Desktop/DiscordRichPresence.cs
+++ b/osu.Desktop/DiscordRichPresence.cs
@@ -273,7 +273,11 @@ namespace osu.Desktop
 
         private static string clampLength(string str)
         {
-            // For whatever reason, discord decides that strings shorter than 2 characters cannot possibly be valid input, because... reasons?
+            // Empty strings are fine to discord even though single-character strings are not. Make it make sense.
+            if (string.IsNullOrEmpty(str))
+                return str;
+
+            // As above, discord decides that *non-empty* strings shorter than 2 characters cannot possibly be valid input, because... reasons?
             // And yes, that is two *characters*, or *codepoints*, not *bytes* as further down below (as determined by empirical testing).
             // That seems very questionable, and isn't even documented anywhere. So to *make it* accept such valid input,
             // just tack on enough of U+200B ZERO WIDTH SPACEs at the end.

From 85f85dee9ef28b4b65678d58f6e3f54abf0fe2f6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 14:46:28 +0200
Subject: [PATCH 862/930] Enable NRT in `TestScenePresentScore`

---
 .../Visual/Navigation/TestScenePresentScore.cs     | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 212783d047..2d4302c0df 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -1,8 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-#nullable disable
-
 using System;
 using System.Linq;
 using NUnit.Framework;
@@ -26,7 +24,7 @@ namespace osu.Game.Tests.Visual.Navigation
 {
     public partial class TestScenePresentScore : OsuGameTestScene
     {
-        private BeatmapSetInfo beatmap;
+        private BeatmapSetInfo beatmap = null!;
 
         [SetUpSteps]
         public new void SetUpSteps()
@@ -64,7 +62,7 @@ namespace osu.Game.Tests.Visual.Navigation
                             Ruleset = new OsuRuleset().RulesetInfo
                         },
                     }
-                })?.Value;
+                })!.Value;
             });
         }
 
@@ -171,9 +169,9 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("wait for menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
         }
 
-        private Func<ScoreInfo> importScore(int i, RulesetInfo ruleset = null)
+        private Func<ScoreInfo> importScore(int i, RulesetInfo? ruleset = null)
         {
-            ScoreInfo imported = null;
+            ScoreInfo? imported = null;
             AddStep($"import score {i}", () =>
             {
                 imported = Game.ScoreManager.Import(new ScoreInfo
@@ -188,14 +186,14 @@ namespace osu.Game.Tests.Visual.Navigation
 
             AddAssert($"import {i} succeeded", () => imported != null);
 
-            return () => imported;
+            return () => imported!;
         }
 
         /// <summary>
         /// Some tests test waiting for a particular screen twice in a row, but expect a new instance each time.
         /// There's a case where they may succeed incorrectly if we don't compare against the previous instance.
         /// </summary>
-        private IScreen lastWaitedScreen;
+        private IScreen lastWaitedScreen = null!;
 
         private void presentAndConfirm(Func<ScoreInfo> getImport, ScorePresentType type)
         {

From 3b15c223be4a38c624f68abd30561638d46ea14d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 14:48:02 +0200
Subject: [PATCH 863/930] Add failing test case

---
 .../Navigation/TestScenePresentScore.cs       | 25 +++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
index 2d4302c0df..2c2335de13 100644
--- a/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
+++ b/osu.Game.Tests/Visual/Navigation/TestScenePresentScore.cs
@@ -156,6 +156,27 @@ namespace osu.Game.Tests.Visual.Navigation
             presentAndConfirm(secondImport, type);
         }
 
+        [Test]
+        public void TestScoreRefetchIgnoresEmptyHash()
+        {
+            AddStep("enter song select", () => Game.ChildrenOfType<ButtonSystem>().Single().OnSolo?.Invoke());
+            AddUntilStep("song select is current", () => Game.ScreenStack.CurrentScreen is PlaySongSelect songSelect && songSelect.BeatmapSetsLoaded);
+
+            importScore(-1, hash: string.Empty);
+            importScore(3, hash: @"deadbeef");
+
+            // oftentimes a `PresentScore()` call will be given a `ScoreInfo` which is converted from an online score,
+            // in which cases the hash will generally not be available.
+            AddStep("present score", () => Game.PresentScore(new ScoreInfo { OnlineID = 3, Hash = string.Empty }));
+
+            AddUntilStep("wait for results", () => lastWaitedScreen != Game.ScreenStack.CurrentScreen && Game.ScreenStack.CurrentScreen is ResultsScreen);
+            AddUntilStep("correct score displayed", () =>
+            {
+                var score = ((ResultsScreen)Game.ScreenStack.CurrentScreen).Score!;
+                return score.OnlineID == 3 && score.Hash == "deadbeef";
+            });
+        }
+
         private void returnToMenu()
         {
             // if we don't pause, there's a chance the track may change at the main menu out of our control (due to reaching the end of the track).
@@ -169,14 +190,14 @@ namespace osu.Game.Tests.Visual.Navigation
             AddUntilStep("wait for menu", () => Game.ScreenStack.CurrentScreen is MainMenu);
         }
 
-        private Func<ScoreInfo> importScore(int i, RulesetInfo? ruleset = null)
+        private Func<ScoreInfo> importScore(int i, RulesetInfo? ruleset = null, string? hash = null)
         {
             ScoreInfo? imported = null;
             AddStep($"import score {i}", () =>
             {
                 imported = Game.ScoreManager.Import(new ScoreInfo
                 {
-                    Hash = Guid.NewGuid().ToString(),
+                    Hash = hash ?? Guid.NewGuid().ToString(),
                     OnlineID = i,
                     BeatmapInfo = beatmap.Beatmaps.First(),
                     Ruleset = ruleset ?? new OsuRuleset().RulesetInfo,

From ed498f6eed66a4c801604484dbcbea883b229cbc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 20 May 2024 14:48:36 +0200
Subject: [PATCH 864/930] Do not attempt to match score by equality of hash if
 it's empty

Closes https://github.com/ppy/osu/issues/28216.

The affected user's database contained six sentakki scores with an empty
hash. When an online score is being imported, an online model (which
does not have a hash) will be transmogrified into a `ScoreInfo` with
an empty hash, which would end up accidentally matching those scores
and basically breaking everything at that point.

To fix, avoid attempting to match anything on empty hash. This does not
break online score matching because for those cases the actual online ID
of the score will be used.
---
 osu.Game/Scoring/ScoreManager.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Scoring/ScoreManager.cs b/osu.Game/Scoring/ScoreManager.cs
index 0c707ffa19..df4735b5e6 100644
--- a/osu.Game/Scoring/ScoreManager.cs
+++ b/osu.Game/Scoring/ScoreManager.cs
@@ -88,7 +88,7 @@ namespace osu.Game.Scoring
         {
             ScoreInfo? databasedScoreInfo = null;
 
-            if (originalScoreInfo is ScoreInfo scoreInfo)
+            if (originalScoreInfo is ScoreInfo scoreInfo && !string.IsNullOrEmpty(scoreInfo.Hash))
                 databasedScoreInfo = Query(s => s.Hash == scoreInfo.Hash);
 
             if (originalScoreInfo.OnlineID > 0)

From db8b72eb37464d50ec5092f7180082507e7fc2b0 Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Mon, 20 May 2024 16:23:16 +0200
Subject: [PATCH 865/930] Clamped Difficulty Ranges to [0,10]

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 6fa78fa8e6..059451e228 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -383,21 +383,24 @@ namespace osu.Game.Beatmaps.Formats
             switch (pair.Key)
             {
                 case @"HPDrainRate":
-                    difficulty.DrainRate = Parsing.ParseFloat(pair.Value);
+                    difficulty.DrainRate = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
                     break;
 
                 case @"CircleSize":
                     difficulty.CircleSize = Parsing.ParseFloat(pair.Value);
+                    //If the mode is not Mania, clamp circle size to [0,10]
+                    if (!beatmap.BeatmapInfo.Ruleset.OnlineID.Equals(3))
+                        difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 0, 10);
                     break;
 
                 case @"OverallDifficulty":
-                    difficulty.OverallDifficulty = Parsing.ParseFloat(pair.Value);
+                    difficulty.OverallDifficulty = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
                     if (!hasApproachRate)
                         difficulty.ApproachRate = difficulty.OverallDifficulty;
                     break;
 
                 case @"ApproachRate":
-                    difficulty.ApproachRate = Parsing.ParseFloat(pair.Value);
+                    difficulty.ApproachRate = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
                     hasApproachRate = true;
                     break;
 

From e740b8bcc358653d12ff528fb33e6c42cf505559 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 May 2024 14:36:11 +0800
Subject: [PATCH 866/930] Fix single frame glitching in skin editor

https://github.com/ppy/osu/pull/28257#discussion_r1606999574
---
 osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
index 21909cdc10..8fd9c1b559 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionHandler.cs
@@ -455,9 +455,10 @@ namespace osu.Game.Overlays.SkinEditor
             checkOrigin(Anchor.BottomCentre);
             checkOrigin(Anchor.BottomRight);
 
-            var previousOrigin = drawable.ToParentSpace(drawable.OriginPosition);
+            Vector2 offset = drawable.ToParentSpace(localOrigin.PositionOnQuad(drawable.DrawRectangle)) - drawable.ToParentSpace(drawable.Origin.PositionOnQuad(drawable.DrawRectangle));
+
             drawable.Origin = localOrigin;
-            drawable.Position += drawable.ToParentSpace(drawable.OriginPosition) - previousOrigin;
+            drawable.Position += offset;
         }
 
         private static void adjustScaleFromAnchor(ref Vector2 scale, Anchor reference)

From d7d569cf4e68acdbcc9cec844337f93bdb207a54 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 21 May 2024 14:34:53 +0800
Subject: [PATCH 867/930] Temporary rollback of framework / SDL3

---
 osu.Android.props                             |  2 +-
 osu.Android/AndroidJoystickSettings.cs        | 76 +++++++++++++++
 osu.Android/AndroidMouseSettings.cs           | 97 +++++++++++++++++++
 osu.Android/OsuGameAndroid.cs                 | 22 +++++
 osu.Desktop/OsuGameDesktop.cs                 | 11 +--
 osu.Desktop/Program.cs                        | 33 +++----
 .../Components/PathControlPointVisualiser.cs  |  2 +-
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs      |  3 +-
 osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs  |  3 +-
 .../Screens/Ladder/LadderDragContainer.cs     |  2 +-
 osu.Game/Database/EmptyRealmSet.cs            |  5 -
 .../UserInterface/ExpandableSlider.cs         |  8 +-
 .../Graphics/UserInterface/OsuSliderBar.cs    |  9 +-
 .../Graphics/UserInterface/OsuTabControl.cs   | 24 ++---
 .../Graphics/UserInterface/PageTabControl.cs  | 14 +--
 .../UserInterface/RoundedSliderBar.cs         |  5 +-
 .../UserInterface/ShearedSliderBar.cs         |  5 +-
 .../UserInterfaceV2/LabelledSliderBar.cs      |  4 +-
 .../UserInterfaceV2/SliderWithTextBoxInput.cs |  8 +-
 osu.Game/OsuGameBase.cs                       | 12 +--
 .../BeatmapListingCardSizeTabControl.cs       | 12 +--
 ...BeatmapSearchMultipleSelectionFilterRow.cs |  4 -
 .../Overlays/BeatmapListing/FilterTabItem.cs  | 12 +--
 .../BeatmapSet/BeatmapRulesetSelector.cs      |  2 +-
 .../OverlayPanelDisplayStyleControl.cs        | 14 +--
 osu.Game/Overlays/OverlayRulesetTabItem.cs    | 14 +--
 osu.Game/Overlays/OverlayStreamItem.cs        | 12 +--
 osu.Game/Overlays/OverlayTabControl.cs        | 14 +--
 .../Overlays/Settings/Sections/SizeSlider.cs  |  3 +-
 .../Settings/SettingsPercentageSlider.cs      |  4 +-
 osu.Game/Overlays/Settings/SettingsSlider.cs  |  6 +-
 .../Toolbar/ToolbarRulesetSelector.cs         | 16 ++-
 .../Toolbar/ToolbarRulesetTabButton.cs        | 12 ---
 osu.Game/Rulesets/Mods/DifficultyBindable.cs  |  2 +-
 .../Objects/Drawables/DrawableHitObject.cs    |  3 +-
 .../Scoring/LegacyDrainingHealthProcessor.cs  |  7 --
 .../Rulesets/UI/FrameStabilityContainer.cs    |  2 +-
 .../Timeline/TimelineTickDisplay.cs           |  3 +-
 osu.Game/Screens/Edit/Editor.cs               | 14 ++-
 .../IndeterminateSliderWithTextBoxInput.cs    |  8 +-
 .../Match/Components/MatchTypePicker.cs       | 11 +--
 .../Play/PlayerSettings/PlayerSliderBar.cs    |  4 +-
 osu.Game/osu.Game.csproj                      |  4 +-
 osu.iOS.props                                 |  2 +-
 44 files changed, 304 insertions(+), 226 deletions(-)
 create mode 100644 osu.Android/AndroidJoystickSettings.cs
 create mode 100644 osu.Android/AndroidMouseSettings.cs

diff --git a/osu.Android.props b/osu.Android.props
index e20ac2e0b7..2d7a9d2652 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.329.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Android/AndroidJoystickSettings.cs b/osu.Android/AndroidJoystickSettings.cs
new file mode 100644
index 0000000000..bf69461f0d
--- /dev/null
+++ b/osu.Android/AndroidJoystickSettings.cs
@@ -0,0 +1,76 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Framework.Allocation;
+using osu.Framework.Android.Input;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+
+namespace osu.Android
+{
+    public partial class AndroidJoystickSettings : SettingsSubsection
+    {
+        protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
+
+        private readonly AndroidJoystickHandler joystickHandler;
+
+        private readonly Bindable<bool> enabled = new BindableBool(true);
+
+        private SettingsSlider<float> deadzoneSlider = null!;
+
+        private Bindable<float> handlerDeadzone = null!;
+
+        private Bindable<float> localDeadzone = null!;
+
+        public AndroidJoystickSettings(AndroidJoystickHandler joystickHandler)
+        {
+            this.joystickHandler = joystickHandler;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            // use local bindable to avoid changing enabled state of game host's bindable.
+            handlerDeadzone = joystickHandler.DeadzoneThreshold.GetBoundCopy();
+            localDeadzone = handlerDeadzone.GetUnboundCopy();
+
+            Children = new Drawable[]
+            {
+                new SettingsCheckbox
+                {
+                    LabelText = CommonStrings.Enabled,
+                    Current = enabled
+                },
+                deadzoneSlider = new SettingsSlider<float>
+                {
+                    LabelText = JoystickSettingsStrings.DeadzoneThreshold,
+                    KeyboardStep = 0.01f,
+                    DisplayAsPercentage = true,
+                    Current = localDeadzone,
+                },
+            };
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            enabled.BindTo(joystickHandler.Enabled);
+            enabled.BindValueChanged(e => deadzoneSlider.Current.Disabled = !e.NewValue, true);
+
+            handlerDeadzone.BindValueChanged(val =>
+            {
+                bool disabled = localDeadzone.Disabled;
+
+                localDeadzone.Disabled = false;
+                localDeadzone.Value = val.NewValue;
+                localDeadzone.Disabled = disabled;
+            }, true);
+
+            localDeadzone.BindValueChanged(val => handlerDeadzone.Value = val.NewValue);
+        }
+    }
+}
diff --git a/osu.Android/AndroidMouseSettings.cs b/osu.Android/AndroidMouseSettings.cs
new file mode 100644
index 0000000000..fd01b11164
--- /dev/null
+++ b/osu.Android/AndroidMouseSettings.cs
@@ -0,0 +1,97 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using Android.OS;
+using osu.Framework.Allocation;
+using osu.Framework.Android.Input;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Localisation;
+using osu.Game.Configuration;
+using osu.Game.Localisation;
+using osu.Game.Overlays.Settings;
+using osu.Game.Overlays.Settings.Sections.Input;
+
+namespace osu.Android
+{
+    public partial class AndroidMouseSettings : SettingsSubsection
+    {
+        private readonly AndroidMouseHandler mouseHandler;
+
+        protected override LocalisableString Header => MouseSettingsStrings.Mouse;
+
+        private Bindable<double> handlerSensitivity = null!;
+
+        private Bindable<double> localSensitivity = null!;
+
+        private Bindable<bool> relativeMode = null!;
+
+        public AndroidMouseSettings(AndroidMouseHandler mouseHandler)
+        {
+            this.mouseHandler = mouseHandler;
+        }
+
+        [BackgroundDependencyLoader]
+        private void load(OsuConfigManager osuConfig)
+        {
+            // use local bindable to avoid changing enabled state of game host's bindable.
+            handlerSensitivity = mouseHandler.Sensitivity.GetBoundCopy();
+            localSensitivity = handlerSensitivity.GetUnboundCopy();
+
+            relativeMode = mouseHandler.UseRelativeMode.GetBoundCopy();
+
+            // High precision/pointer capture is only available on Android 8.0 and up
+            if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
+            {
+                AddRange(new Drawable[]
+                {
+                    new SettingsCheckbox
+                    {
+                        LabelText = MouseSettingsStrings.HighPrecisionMouse,
+                        TooltipText = MouseSettingsStrings.HighPrecisionMouseTooltip,
+                        Current = relativeMode,
+                        Keywords = new[] { @"raw", @"input", @"relative", @"cursor", @"captured", @"pointer" },
+                    },
+                    new MouseSettings.SensitivitySetting
+                    {
+                        LabelText = MouseSettingsStrings.CursorSensitivity,
+                        Current = localSensitivity,
+                    },
+                });
+            }
+
+            AddRange(new Drawable[]
+            {
+                new SettingsCheckbox
+                {
+                    LabelText = MouseSettingsStrings.DisableMouseWheelVolumeAdjust,
+                    TooltipText = MouseSettingsStrings.DisableMouseWheelVolumeAdjustTooltip,
+                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableWheel),
+                },
+                new SettingsCheckbox
+                {
+                    LabelText = MouseSettingsStrings.DisableClicksDuringGameplay,
+                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableButtons),
+                },
+            });
+        }
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            relativeMode.BindValueChanged(relative => localSensitivity.Disabled = !relative.NewValue, true);
+
+            handlerSensitivity.BindValueChanged(val =>
+            {
+                bool disabled = localSensitivity.Disabled;
+
+                localSensitivity.Disabled = false;
+                localSensitivity.Value = val.NewValue;
+                localSensitivity.Disabled = disabled;
+            }, true);
+
+            localSensitivity.BindValueChanged(val => handlerSensitivity.Value = val.NewValue);
+        }
+    }
+}
diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index a235913ef3..52cfb67f42 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.cs
@@ -5,9 +5,13 @@ using System;
 using Android.App;
 using Microsoft.Maui.Devices;
 using osu.Framework.Allocation;
+using osu.Framework.Android.Input;
 using osu.Framework.Extensions.ObjectExtensions;
+using osu.Framework.Input.Handlers;
 using osu.Framework.Platform;
 using osu.Game;
+using osu.Game.Overlays.Settings;
+using osu.Game.Overlays.Settings.Sections.Input;
 using osu.Game.Updater;
 using osu.Game.Utils;
 
@@ -84,6 +88,24 @@ namespace osu.Android
 
         protected override BatteryInfo CreateBatteryInfo() => new AndroidBatteryInfo();
 
+        public override SettingsSubsection CreateSettingsSubsectionFor(InputHandler handler)
+        {
+            switch (handler)
+            {
+                case AndroidMouseHandler mh:
+                    return new AndroidMouseSettings(mh);
+
+                case AndroidJoystickHandler jh:
+                    return new AndroidJoystickSettings(jh);
+
+                case AndroidTouchHandler th:
+                    return new TouchSettings(th);
+
+                default:
+                    return base.CreateSettingsSubsectionFor(handler);
+            }
+        }
+
         private class AndroidBatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel => Battery.ChargeLevel;
diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index e8783c997a..2b232db274 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -22,7 +22,7 @@ using osu.Game.IPC;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Performance;
 using osu.Game.Utils;
-using SDL;
+using SDL2;
 
 namespace osu.Desktop
 {
@@ -161,7 +161,7 @@ namespace osu.Desktop
             host.Window.Title = Name;
         }
 
-        protected override BatteryInfo CreateBatteryInfo() => new SDL3BatteryInfo();
+        protected override BatteryInfo CreateBatteryInfo() => new SDL2BatteryInfo();
 
         protected override void Dispose(bool isDisposing)
         {
@@ -170,14 +170,13 @@ namespace osu.Desktop
             archiveImportIPCChannel?.Dispose();
         }
 
-        private unsafe class SDL3BatteryInfo : BatteryInfo
+        private class SDL2BatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel
             {
                 get
                 {
-                    int percentage;
-                    SDL3.SDL_GetPowerInfo(null, &percentage);
+                    SDL.SDL_GetPowerInfo(out _, out int percentage);
 
                     if (percentage == -1)
                         return null;
@@ -186,7 +185,7 @@ namespace osu.Desktop
                 }
             }
 
-            public override bool OnBattery => SDL3.SDL_GetPowerInfo(null, null) == SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
+            public override bool OnBattery => SDL.SDL_GetPowerInfo(out _, out _) == SDL.SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
         }
     }
 }
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 23e56cdce9..2d7ec5aa5f 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -13,7 +13,7 @@ using osu.Framework.Platform;
 using osu.Game;
 using osu.Game.IPC;
 using osu.Game.Tournament;
-using SDL;
+using SDL2;
 using Squirrel;
 
 namespace osu.Desktop
@@ -52,19 +52,16 @@ namespace osu.Desktop
                 // See https://www.mongodb.com/docs/realm/sdk/dotnet/compatibility/
                 if (windowsVersion.Major < 6 || (windowsVersion.Major == 6 && windowsVersion.Minor <= 2))
                 {
-                    unsafe
-                    {
-                        // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
-                        // disabling it ourselves.
-                        // We could also better detect compatibility mode if required:
-                        // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
-                        SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
-                            "Your operating system is too old to run osu!"u8,
-                            "This version of osu! requires at least Windows 8.1 to run.\n"u8
-                            + "Please upgrade your operating system or consider using an older version of osu!.\n\n"u8
-                            + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!"u8, null);
-                        return;
-                    }
+                    // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
+                    // disabling it ourselves.
+                    // We could also better detect compatibility mode if required:
+                    // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
+                    SDL.SDL_ShowSimpleMessageBox(SDL.SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
+                        "Your operating system is too old to run osu!",
+                        "This version of osu! requires at least Windows 8.1 to run.\n"
+                        + "Please upgrade your operating system or consider using an older version of osu!.\n\n"
+                        + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!", IntPtr.Zero);
+                    return;
                 }
 
                 setupSquirrel();
@@ -107,13 +104,7 @@ namespace osu.Desktop
                 }
             }
 
-            var hostOptions = new HostOptions
-            {
-                IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null,
-                FriendlyGameName = OsuGameBase.GAME_NAME,
-            };
-
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, hostOptions))
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null }))
             {
                 if (!host.IsPrimaryInstance)
                 {
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index afc2d407e9..836d348ff4 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         }
 
         // Generally all the control points are within the visible area all the time.
-        public override bool UpdateSubTreeMasking() => true;
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => true;
 
         /// <summary>
         /// Handles correction of invalid path types.
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 93c3450904..4933eb4041 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -8,6 +8,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
@@ -36,7 +37,7 @@ namespace osu.Game.Rulesets.Osu.UI
 
         // For osu! gameplay, everything is always on screen.
         // Skipping masking calculations improves performance in intense beatmaps (ie. https://osu.ppy.sh/beatmapsets/150945#osu/372245)
-        public override bool UpdateSubTreeMasking() => false;
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
 
         public SmokeContainer Smoke { get; }
         public FollowPointRenderer FollowPoints { get; }
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index bdcb341fb4..0510f08068 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
@@ -7,6 +7,7 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Graphics.Primitives;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Judgements;
@@ -344,7 +345,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         {
             public void Add(Drawable proxy) => AddInternal(proxy);
 
-            public override bool UpdateSubTreeMasking()
+            public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds)
             {
                 // DrawableHitObject disables masking.
                 // Hitobject content is proxied and unproxied based on hit status and the IsMaskedAway value could get stuck because of this.
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
index 111dede815..3a2db4fc71 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Tournament.Screens.Ladder
 
         protected override bool ComputeIsMaskedAway(RectangleF maskingBounds) => false;
 
-        public override bool UpdateSubTreeMasking() => false;
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
 
         protected override void OnDrag(DragEvent e)
         {
diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
index c34974cb03..02dfa50fe5 100644
--- a/osu.Game/Database/EmptyRealmSet.cs
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -6,7 +6,6 @@ using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.ComponentModel;
-using JetBrains.Annotations;
 using Realms;
 using Realms.Schema;
 
@@ -16,12 +15,8 @@ namespace osu.Game.Database
     {
         private IList<T> emptySet => Array.Empty<T>();
 
-        [MustDisposeResource]
         public IEnumerator<T> GetEnumerator() => emptySet.GetEnumerator();
-
-        [MustDisposeResource]
         IEnumerator IEnumerable.GetEnumerator() => emptySet.GetEnumerator();
-
         public int Count => emptySet.Count;
         public T this[int index] => emptySet[index];
         public int IndexOf(object? item) => item == null ? -1 : emptySet.IndexOf((T)item);
diff --git a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index a7a8561b94..121a1eef49 100644
--- a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using Vector2 = osuTK.Vector2;
+using osuTK;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -18,7 +18,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandable, IHasCurrentValue<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
         where TSlider : RoundedSliderBar<T>, new()
     {
         private readonly OsuSpriteText label;
@@ -129,7 +129,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T> : ExpandableSlider<T, RoundedSliderBar<T>>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 9cb6356cab..191a7ca246 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Numerics;
 using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -16,7 +15,7 @@ using osu.Game.Utils;
 namespace osu.Game.Graphics.UserInterface
 {
     public abstract partial class OsuSliderBar<T> : SliderBar<T>, IHasTooltip
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         public bool PlaySamplesOnAdjust { get; set; } = true;
 
@@ -86,11 +85,11 @@ namespace osu.Game.Graphics.UserInterface
         private LocalisableString getTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
-                return int.CreateTruncating(value).ToString("N0");
+                return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
 
-            double floatValue = double.CreateTruncating(value);
+            double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
 
-            decimal decimalPrecision = normalise(decimal.CreateTruncating(CurrentNumber.Precision), max_decimal_digits);
+            decimal decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), max_decimal_digits);
 
             // Find the number of significant digits (we could have less than 5 after normalize())
             int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index 5ce384c53c..f24977927f 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -8,8 +8,6 @@ using System.Linq;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
@@ -145,6 +143,13 @@ namespace osu.Game.Graphics.UserInterface
                     FadeUnhovered();
             }
 
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours)
+            {
+                if (accentColour == default)
+                    AccentColour = colours.Blue;
+            }
+
             public OsuTabItem(T value)
                 : base(value)
             {
@@ -191,21 +196,10 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect)
+                    new HoverClickSounds(HoverSampleSet.TabSelect)
                 };
             }
 
-            private Sample selectSample;
-
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours, AudioManager audio)
-            {
-                if (accentColour == default)
-                    AccentColour = colours.Blue;
-
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
-            }
-
             protected override void OnActivated()
             {
                 Text.Font = Text.Font.With(weight: FontWeight.Bold);
@@ -217,8 +211,6 @@ namespace osu.Game.Graphics.UserInterface
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
                 FadeUnhovered();
             }
-
-            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageTabControl.cs b/osu.Game/Graphics/UserInterface/PageTabControl.cs
index 44c659f945..2fe8acfbd5 100644
--- a/osu.Game/Graphics/UserInterface/PageTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/PageTabControl.cs
@@ -7,8 +7,6 @@ using System;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
@@ -55,8 +53,6 @@ namespace osu.Game.Graphics.UserInterface
                 }
             }
 
-            private Sample selectSample = null!;
-
             public PageTabItem(T value)
                 : base(value)
             {
@@ -82,18 +78,12 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect)
+                    new HoverClickSounds(HoverSampleSet.TabSelect)
                 };
 
                 Active.BindValueChanged(active => Text.Font = Text.Font.With(Typeface.Torus, weight: active.NewValue ? FontWeight.Bold : FontWeight.Medium), true);
             }
 
-            [BackgroundDependencyLoader]
-            private void load(AudioManager audio)
-            {
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
-            }
-
             protected virtual LocalisableString CreateText() => (Value as Enum)?.GetLocalisableDescription() ?? Value.ToString();
 
             protected override bool OnHover(HoverEvent e)
@@ -122,8 +112,6 @@ namespace osu.Game.Graphics.UserInterface
             protected override void OnActivated() => slideActive();
 
             protected override void OnDeactivated() => slideInactive();
-
-            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
index 56047173bb..0981881ead 100644
--- a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Numerics;
+using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -11,12 +11,11 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
-using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class RoundedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         protected readonly Nub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
index 0df1c1d204..60a6670492 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Numerics;
+using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -12,12 +12,11 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
 using static osu.Game.Graphics.UserInterface.ShearedNub;
-using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class ShearedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         protected readonly ShearedNub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
index 4912a21fab..4585d3a4c9 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
@@ -1,14 +1,14 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class LabelledSliderBar<TNumber> : LabelledComponent<SettingsSlider<TNumber>, TNumber>
-        where TNumber : struct, INumber<TNumber>, IMinMaxValue<TNumber>
+        where TNumber : struct, IEquatable<TNumber>, IComparable<TNumber>, IConvertible
     {
         public LabelledSliderBar()
             : base(true)
diff --git a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
index abd828e98f..e5ba7f61bf 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,12 +10,12 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using Vector2 = osuTK.Vector2;
+using osuTK;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class SliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -138,7 +138,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         {
             if (updatingFromTextBox) return;
 
-            decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
+            decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
             textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
         }
     }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index 5e4ec5a61d..a8866876f4 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -75,12 +75,6 @@ namespace osu.Game
     {
         public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv", ".mpg", ".wmv", ".m4v" };
 
-#if DEBUG
-        public const string GAME_NAME = "osu! (development)";
-#else
-        public const string GAME_NAME = "osu!";
-#endif
-
         public const string OSU_PROTOCOL = "osu://";
 
         public const string CLIENT_STREAM_NAME = @"lazer";
@@ -247,7 +241,11 @@ namespace osu.Game
 
         public OsuGameBase()
         {
-            Name = GAME_NAME;
+            Name = @"osu!";
+
+#if DEBUG
+            Name += " (development)";
+#endif
 
             allowableExceptions = UnhandledExceptionsBeforeCrash;
         }
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
index 63a533c92e..9cd0031e3d 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
@@ -5,8 +5,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -49,15 +47,13 @@ namespace osu.Game.Overlays.BeatmapListing
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
 
-            private Sample selectSample = null!;
-
             public TabItem(BeatmapCardSize value)
                 : base(value)
             {
             }
 
             [BackgroundDependencyLoader]
-            private void load(AudioManager audio)
+            private void load()
             {
                 AutoSizeAxes = Axes.Both;
                 Masking = true;
@@ -83,10 +79,8 @@ namespace osu.Game.Overlays.BeatmapListing
                             Icon = getIconForCardSize(Value)
                         }
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect)
+                    new HoverClickSounds(HoverSampleSet.TabSelect)
                 };
-
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             private static IconUsage getIconForCardSize(BeatmapCardSize cardSize)
@@ -117,8 +111,6 @@ namespace osu.Game.Overlays.BeatmapListing
                     updateState();
             }
 
-            protected override void OnActivatedByUser() => selectSample.Play();
-
             protected override void OnDeactivated()
             {
                 if (IsLoaded)
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index 4bd25f6561..e59beb43ff 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -128,11 +128,7 @@ namespace osu.Game.Overlays.BeatmapListing
             protected override bool OnClick(ClickEvent e)
             {
                 base.OnClick(e);
-
-                // this tab item implementation is not managed by a TabControl,
-                // therefore we have to manually update Active state and play select sound when this tab item is clicked.
                 Active.Toggle();
-                SelectSample.Play();
                 return true;
             }
         }
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index ee188d34ce..831cf812ff 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -5,8 +5,6 @@
 
 using System;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -26,15 +24,13 @@ namespace osu.Game.Overlays.BeatmapListing
 
         private OsuSpriteText text;
 
-        protected Sample SelectSample { get; private set; } = null!;
-
         public FilterTabItem(T value)
             : base(value)
         {
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             AutoSizeAxes = Axes.Both;
             AddRangeInternal(new Drawable[]
@@ -44,12 +40,10 @@ namespace osu.Game.Overlays.BeatmapListing
                     Font = OsuFont.GetFont(size: 13, weight: FontWeight.Regular),
                     Text = LabelFor(Value)
                 },
-                new HoverSounds(HoverSampleSet.TabSelect)
+                new HoverClickSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
-
-            SelectSample = audio.Samples.Get(@"UI/tabselect-select");
         }
 
         protected override void LoadComplete()
@@ -77,8 +71,6 @@ namespace osu.Game.Overlays.BeatmapListing
 
         protected override void OnDeactivated() => UpdateState();
 
-        protected override void OnActivatedByUser() => SelectSample.Play();
-
         /// <summary>
         /// Returns the label text to be used for the supplied <paramref name="value"/>.
         /// </summary>
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
index 29744f27fc..426fbcdb8d 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 // propagate value to tab items first to enable only available rulesets.
                 beatmapSet.Value = value;
 
-                Current.Value = TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value)?.Value;
+                SelectTab(TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value));
             }
         }
 
diff --git a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
index c2bea0ed91..d7d6bd4a2a 100644
--- a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
+++ b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
@@ -11,8 +11,6 @@ using osuTK;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osuTK.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
@@ -67,8 +65,6 @@ namespace osu.Game.Overlays
 
             private readonly SpriteIcon icon;
 
-            private Sample selectSample = null!;
-
             public PanelDisplayTabItem(OverlayPanelDisplayStyle value)
                 : base(value)
             {
@@ -82,22 +78,14 @@ namespace osu.Game.Overlays
                         RelativeSizeAxes = Axes.Both,
                         FillMode = FillMode.Fit
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect)
+                    new HoverClickSounds()
                 });
             }
 
-            [BackgroundDependencyLoader]
-            private void load(AudioManager audio)
-            {
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
-            }
-
             protected override void OnActivated() => updateState();
 
             protected override void OnDeactivated() => updateState();
 
-            protected override void OnActivatedByUser() => selectSample.Play();
-
             protected override bool OnHover(HoverEvent e)
             {
                 updateState();
diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index b245486adf..6d318820b3 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -10,8 +10,6 @@ using osu.Game.Rulesets;
 using osuTK.Graphics;
 using osuTK;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
@@ -41,8 +39,6 @@ namespace osu.Game.Overlays
 
         public LocalisableString TooltipText => Value.Name;
 
-        private Sample selectSample = null!;
-
         public OverlayRulesetTabItem(RulesetInfo value)
             : base(value)
         {
@@ -63,18 +59,12 @@ namespace osu.Game.Overlays
                         Icon = value.CreateInstance().CreateIcon(),
                     },
                 },
-                new HoverSounds(HoverSampleSet.TabSelect)
+                new HoverClickSounds()
             });
 
             Enabled.Value = true;
         }
 
-        [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
-        {
-            selectSample = audio.Samples.Get(@"UI/tabselect-select");
-        }
-
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -100,8 +90,6 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
-        protected override void OnActivatedByUser() => selectSample.Play();
-
         private void updateState()
         {
             AccentColour = Enabled.Value ? getActiveColour() : colourProvider.Foreground1;
diff --git a/osu.Game/Overlays/OverlayStreamItem.cs b/osu.Game/Overlays/OverlayStreamItem.cs
index f0ae0b41fc..45181c13e4 100644
--- a/osu.Game/Overlays/OverlayStreamItem.cs
+++ b/osu.Game/Overlays/OverlayStreamItem.cs
@@ -11,8 +11,6 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osuTK.Graphics;
@@ -51,10 +49,8 @@ namespace osu.Game.Overlays
             Margin = new MarginPadding(PADDING);
         }
 
-        private Sample selectSample;
-
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, OsuColour colours, AudioManager audio)
+        private void load(OverlayColourProvider colourProvider, OsuColour colours)
         {
             AddRange(new Drawable[]
             {
@@ -91,11 +87,9 @@ namespace osu.Game.Overlays
                     CollapsedSize = 2,
                     Expanded = true
                 },
-                new HoverSounds(HoverSampleSet.TabSelect)
+                new HoverClickSounds()
             });
 
-            selectSample = audio.Samples.Get(@"UI/tabselect-select");
-
             SelectedItem.BindValueChanged(_ => updateState(), true);
         }
 
@@ -111,8 +105,6 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
-        protected override void OnActivatedByUser() => selectSample.Play();
-
         protected override bool OnHover(HoverEvent e)
         {
             updateState();
diff --git a/osu.Game/Overlays/OverlayTabControl.cs b/osu.Game/Overlays/OverlayTabControl.cs
index a27caa13f1..884e31868f 100644
--- a/osu.Game/Overlays/OverlayTabControl.cs
+++ b/osu.Game/Overlays/OverlayTabControl.cs
@@ -4,8 +4,6 @@
 #nullable disable
 
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
@@ -82,8 +80,6 @@ namespace osu.Game.Overlays
                 }
             }
 
-            private Sample selectSample = null!;
-
             public OverlayTabItem(T value)
                 : base(value)
             {
@@ -105,16 +101,10 @@ namespace osu.Game.Overlays
                         ExpandedSize = 5f,
                         CollapsedSize = 0
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect)
+                    new HoverClickSounds(HoverSampleSet.TabSelect)
                 };
             }
 
-            [BackgroundDependencyLoader]
-            private void load(AudioManager audio)
-            {
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
-            }
-
             protected override bool OnHover(HoverEvent e)
             {
                 base.OnHover(e);
@@ -146,8 +136,6 @@ namespace osu.Game.Overlays
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
             }
 
-            protected override void OnActivatedByUser() => selectSample.Play();
-
             private void updateState()
             {
                 if (Active.Value)
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index 14ef58ff88..c73831d8d1 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using System.Numerics;
 using System.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
@@ -13,7 +12,7 @@ namespace osu.Game.Overlays.Settings.Sections
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
     public partial class SizeSlider<T> : RoundedSliderBar<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>, IFormattable
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
     {
         public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
index d7a09d3392..fa59d18de1 100644
--- a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
@@ -13,7 +13,7 @@ namespace osu.Game.Overlays.Settings
     /// Mostly provided for convenience of use with <see cref="SettingSourceAttribute"/>.
     /// </summary>
     public partial class SettingsPercentageSlider<TValue> : SettingsSlider<TValue>
-        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
+        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
     {
         protected override Drawable CreateControl() => ((RoundedSliderBar<TValue>)base.CreateControl()).With(sliderBar => sliderBar.DisplayAsPercentage = true);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index 2460d78099..6c81fece13 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
@@ -9,12 +9,12 @@ using osu.Game.Graphics.UserInterface;
 namespace osu.Game.Overlays.Settings
 {
     public partial class SettingsSlider<T> : SettingsSlider<T, RoundedSliderBar<T>>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
     }
 
     public partial class SettingsSlider<TValue, TSlider> : SettingsItem<TValue>
-        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
+        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
         where TSlider : RoundedSliderBar<TValue>, new()
     {
         protected override Drawable CreateControl() => new TSlider
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index d49c340ed4..723c24597a 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
@@ -3,8 +3,11 @@
 
 #nullable disable
 
+using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -21,6 +24,8 @@ namespace osu.Game.Overlays.Toolbar
     {
         protected Drawable ModeButtonLine { get; private set; }
 
+        private readonly Dictionary<string, Sample> selectionSamples = new Dictionary<string, Sample>();
+
         public ToolbarRulesetSelector()
         {
             RelativeSizeAxes = Axes.Y;
@@ -28,7 +33,7 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
             AddRangeInternal(new[]
             {
@@ -54,6 +59,9 @@ namespace osu.Game.Overlays.Toolbar
                     }
                 },
             });
+
+            foreach (var ruleset in Rulesets.AvailableRulesets)
+                selectionSamples[ruleset.ShortName] = audio.Samples.Get($"UI/ruleset-select-{ruleset.ShortName}");
         }
 
         protected override void LoadComplete()
@@ -80,6 +88,10 @@ namespace osu.Game.Overlays.Toolbar
             if (SelectedTab != null)
             {
                 ModeButtonLine.MoveToX(SelectedTab.DrawPosition.X, !hasInitialPosition ? 0 : 500, Easing.OutElasticQuarter);
+
+                if (hasInitialPosition)
+                    selectionSamples[SelectedTab.Value.ShortName]?.Play();
+
                 hasInitialPosition = true;
             }
         }
@@ -109,7 +121,7 @@ namespace osu.Game.Overlays.Toolbar
 
                 RulesetInfo found = Rulesets.AvailableRulesets.ElementAtOrDefault(requested);
                 if (found != null)
-                    SelectItem(found);
+                    Current.Value = found;
                 return true;
             }
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
index 0315bede64..3287ac6eaa 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
@@ -2,8 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -19,8 +17,6 @@ namespace osu.Game.Overlays.Toolbar
     {
         private readonly RulesetButton ruleset;
 
-        private Sample? selectSample;
-
         public ToolbarRulesetTabButton(RulesetInfo value)
             : base(value)
         {
@@ -38,18 +34,10 @@ namespace osu.Game.Overlays.Toolbar
             ruleset.SetIcon(rInstance.CreateIcon());
         }
 
-        [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
-        {
-            selectSample = audio.Samples.Get($@"UI/ruleset-select-{Value.ShortName}");
-        }
-
         protected override void OnActivated() => ruleset.Active = true;
 
         protected override void OnDeactivated() => ruleset.Active = false;
 
-        protected override void OnActivatedByUser() => selectSample?.Play();
-
         private partial class RulesetButton : ToolbarButton
         {
             protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds();
diff --git a/osu.Game/Rulesets/Mods/DifficultyBindable.cs b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
index 5f6fd21860..a207048882 100644
--- a/osu.Game/Rulesets/Mods/DifficultyBindable.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mods
             }
         }
 
-        private float maxValue = 10; // matches default max value of `CurrentNumber`
+        private float maxValue;
 
         public float MaxValue
         {
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index 3ce6cc3cef..de05219212 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -15,6 +15,7 @@ using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -631,7 +632,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         #endregion
 
-        public override bool UpdateSubTreeMasking() => false;
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
 
         protected override void UpdateAfterChildren()
         {
diff --git a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
index 25c5b3643a..7cee5ebecf 100644
--- a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
@@ -129,13 +129,6 @@ namespace osu.Game.Rulesets.Scoring
                     OnIterationFail?.Invoke($"FAILED drop {testDrop}: recovery too low ({recovery} < {hpRecoveryAvailable})");
                 }
 
-                if (!fail && double.IsInfinity(HpMultiplierNormal))
-                {
-                    OnIterationSuccess?.Invoke("Drain computation algorithm diverged to infinity. PASSING with zero drop, resetting HP multiplier to 1.");
-                    HpMultiplierNormal = 1;
-                    return 0;
-                }
-
                 if (!fail)
                 {
                     OnIterationSuccess?.Invoke($"PASSED drop {testDrop}");
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index c4feb249f4..b49924762e 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.UI
                     break;
 
                 base.UpdateSubTree();
-                UpdateSubTreeMasking();
+                UpdateSubTreeMasking(this, ScreenSpaceDrawQuad.AABBFloat);
             } while (state == PlaybackState.RequiresCatchUp && stopwatch.ElapsedMilliseconds < max_catchup_milliseconds);
 
             return true;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index e16c8519e5..c3adb43032 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -7,6 +7,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
+using osu.Framework.Graphics.Primitives;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -19,7 +20,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     public partial class TimelineTickDisplay : TimelinePart<PointVisualisation>
     {
         // With current implementation every tick in the sub-tree should be visible, no need to check whether they are masked away.
-        public override bool UpdateSubTreeMasking() => false;
+        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
 
         [Resolved]
         private EditorBeatmap beatmap { get; set; } = null!;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 980c613311..1c14c9e154 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -372,7 +372,7 @@ namespace osu.Game.Screens.Edit
                                     }
                                 }
                             },
-                            screenSwitcher = new EditorScreenSwitcherControl
+                            new EditorScreenSwitcherControl
                             {
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,
@@ -662,23 +662,23 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorComposeMode:
-                    screenSwitcher.SelectItem(EditorScreenMode.Compose);
+                    Mode.Value = EditorScreenMode.Compose;
                     return true;
 
                 case GlobalAction.EditorDesignMode:
-                    screenSwitcher.SelectItem(EditorScreenMode.Design);
+                    Mode.Value = EditorScreenMode.Design;
                     return true;
 
                 case GlobalAction.EditorTimingMode:
-                    screenSwitcher.SelectItem(EditorScreenMode.Timing);
+                    Mode.Value = EditorScreenMode.Timing;
                     return true;
 
                 case GlobalAction.EditorSetupMode:
-                    screenSwitcher.SelectItem(EditorScreenMode.SongSetup);
+                    Mode.Value = EditorScreenMode.SongSetup;
                     return true;
 
                 case GlobalAction.EditorVerifyMode:
-                    screenSwitcher.SelectItem(EditorScreenMode.Verify);
+                    Mode.Value = EditorScreenMode.Verify;
                     return true;
 
                 case GlobalAction.EditorTestGameplay:
@@ -959,8 +959,6 @@ namespace osu.Game.Screens.Edit
         [CanBeNull]
         private ScheduledDelegate playbackDisabledDebounce;
 
-        private EditorScreenSwitcherControl screenSwitcher;
-
         private void updateSampleDisabledState()
         {
             bool shouldDisableSamples = clock.SeekingOrStopped.Value
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 26f374ba85..151d469415 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -12,7 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using Vector2 = osuTK.Vector2;
+using osuTK;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Edit.Timing
     /// by providing an "indeterminate state".
     /// </summary>
     public partial class IndeterminateSliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T?>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -136,7 +136,7 @@ namespace osu.Game.Screens.Edit.Timing
                 slider.Current.Value = nonNullValue;
 
                 // use the value from the slider to ensure that any precision/min/max set on it via the initial indeterminate value have been applied correctly.
-                decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
+                decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
                 textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
                 textBox.PlaceholderText = string.Empty;
             }
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
index 477336e8ea..995fce085e 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
@@ -4,8 +4,6 @@
 #nullable disable
 
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -80,17 +78,14 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                             },
                         },
                     },
-                    new HoverSounds(HoverSampleSet.TabSelect),
+                    new HoverClickSounds(),
                 };
             }
 
-            private Sample selectSample;
-
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours, AudioManager audio)
+            private void load(OsuColour colours)
             {
                 selection.Colour = colours.Yellow;
-                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             protected override bool OnHover(HoverEvent e)
@@ -114,8 +109,6 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
             {
                 selection.FadeOut(transition_duration, Easing.OutQuint);
             }
-
-            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 1fc1155c0b..88b778fafb 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Numerics;
+using System;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
@@ -11,7 +11,7 @@ using osu.Game.Overlays.Settings;
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public partial class PlayerSliderBar<T> : SettingsSlider<T>
-        where T : struct, INumber<T>, IMinMaxValue<T>
+        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
     {
         public RoundedSliderBar<T> Bar => (RoundedSliderBar<T>)Control;
 
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index f91995feff..30ea2369d0 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,8 +35,8 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.517.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index 103ef50e0c..b2e3fc0779 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.329.0" />
   </ItemGroup>
 </Project>

From 1127a69359f6eb9305d74a85dff8579278135997 Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Tue, 21 May 2024 10:15:53 +0200
Subject: [PATCH 868/930] Moved DIfficulty Clamping to occur after the file has
 been parsed This is to handle potential issues with the ruleset being parsed
 after circle size has been parsed.

---
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs  | 35 ++++++++++++++-----
 1 file changed, 27 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 059451e228..2acabe2518 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -85,6 +85,8 @@ namespace osu.Game.Beatmaps.Formats
 
             base.ParseStreamInto(stream, beatmap);
 
+            applyDifficultyRestrictions(beatmap.Difficulty);
+
             flushPendingPoints();
 
             // Objects may be out of order *only* if a user has manually edited an .osu file.
@@ -102,6 +104,26 @@ namespace osu.Game.Beatmaps.Formats
             }
         }
 
+        /// <summary>
+        /// Clamp Difficulty settings to be within the normal range.
+        /// </summary>
+        private void applyDifficultyRestrictions(BeatmapDifficulty difficulty)
+        {
+            difficulty.DrainRate = Math.Clamp(difficulty.DrainRate, 0, 10);
+            //If the mode is not Mania, clamp circle size to [0,10]
+            if (!beatmap.BeatmapInfo.Ruleset.OnlineID.Equals(3))
+                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 0, 10);
+            //If it is Mania, it must be within [1,20] - dual stages with 10 keys each.
+            //The lower bound should be 4, but there are ranked maps that are lower than this.
+            else
+                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 1, 20);
+            difficulty.OverallDifficulty = Math.Clamp(difficulty.OverallDifficulty, 0, 10);
+            difficulty.ApproachRate = Math.Clamp(difficulty.ApproachRate, 0, 10);
+
+            difficulty.SliderMultiplier = Math.Clamp(difficulty.SliderMultiplier, 0.4, 3.6);
+            difficulty.SliderTickRate = Math.Clamp(difficulty.SliderTickRate, 0.5, 8);
+        }
+
         /// <summary>
         /// Processes the beatmap such that a new combo is started the first hitobject following each break.
         /// </summary>
@@ -383,33 +405,30 @@ namespace osu.Game.Beatmaps.Formats
             switch (pair.Key)
             {
                 case @"HPDrainRate":
-                    difficulty.DrainRate = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
+                    difficulty.DrainRate = Parsing.ParseFloat(pair.Value);
                     break;
 
                 case @"CircleSize":
                     difficulty.CircleSize = Parsing.ParseFloat(pair.Value);
-                    //If the mode is not Mania, clamp circle size to [0,10]
-                    if (!beatmap.BeatmapInfo.Ruleset.OnlineID.Equals(3))
-                        difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 0, 10);
                     break;
 
                 case @"OverallDifficulty":
-                    difficulty.OverallDifficulty = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
+                    difficulty.OverallDifficulty = Parsing.ParseFloat(pair.Value);
                     if (!hasApproachRate)
                         difficulty.ApproachRate = difficulty.OverallDifficulty;
                     break;
 
                 case @"ApproachRate":
-                    difficulty.ApproachRate = Math.Clamp(Parsing.ParseFloat(pair.Value), 0, 10);
+                    difficulty.ApproachRate = Parsing.ParseFloat(pair.Value);
                     hasApproachRate = true;
                     break;
 
                 case @"SliderMultiplier":
-                    difficulty.SliderMultiplier = Math.Clamp(Parsing.ParseDouble(pair.Value), 0.4, 3.6);
+                    difficulty.SliderMultiplier = Parsing.ParseDouble(pair.Value);
                     break;
 
                 case @"SliderTickRate":
-                    difficulty.SliderTickRate = Math.Clamp(Parsing.ParseDouble(pair.Value), 0.5, 8);
+                    difficulty.SliderTickRate = Parsing.ParseDouble(pair.Value);
                     break;
             }
         }

From 45fcbea182d1076ae9239984f76ed9b36b458c5b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 17 May 2024 14:43:06 +0200
Subject: [PATCH 869/930] Compute total score without mods during standardised
 score conversion

This is going to be used by server-side flows. Note that the server-side
overload of `UpdateFromLegacy()` was not calling
`LegacyScoreDecoder.PopulateTotalScoreWithoutMods()`.

Computing the score without mods inline reduces reflection overheads
from constructing mod instances, which feels pretty important for
server-side flows.

There is one weird kink in the treatment of stable scores with score V2
active - they get the *legacy* multipliers unapplied for them because
that made the most sense. For all intents and purposes this matters
mostly for client-side replays with score V2. I'm not sure whether
scores with SV2 ever make it to submission in stable.

There may be minute differences in converted score due to rounding
shenanigans but I don't think it's worth doing a reverify for this.
---
 .../StandardisedScoreMigrationTools.cs        | 67 ++++++++++---------
 1 file changed, 34 insertions(+), 33 deletions(-)

diff --git a/osu.Game/Database/StandardisedScoreMigrationTools.cs b/osu.Game/Database/StandardisedScoreMigrationTools.cs
index 7d09ebdb40..db44731bed 100644
--- a/osu.Game/Database/StandardisedScoreMigrationTools.cs
+++ b/osu.Game/Database/StandardisedScoreMigrationTools.cs
@@ -16,7 +16,6 @@ using osu.Game.Rulesets.Objects;
 using osu.Game.Rulesets.Scoring;
 using osu.Game.Rulesets.Scoring.Legacy;
 using osu.Game.Scoring;
-using osu.Game.Scoring.Legacy;
 
 namespace osu.Game.Database
 {
@@ -248,8 +247,7 @@ namespace osu.Game.Database
             // warning: ordering is important here - both total score and ranks are dependent on accuracy!
             score.Accuracy = computeAccuracy(score, scoreProcessor);
             score.Rank = computeRank(score, scoreProcessor);
-            score.TotalScore = convertFromLegacyTotalScore(score, ruleset, beatmap);
-            LegacyScoreDecoder.PopulateTotalScoreWithoutMods(score);
+            (score.TotalScoreWithoutMods, score.TotalScore) = convertFromLegacyTotalScore(score, ruleset, beatmap);
         }
 
         /// <summary>
@@ -273,7 +271,7 @@ namespace osu.Game.Database
             // warning: ordering is important here - both total score and ranks are dependent on accuracy!
             score.Accuracy = computeAccuracy(score, scoreProcessor);
             score.Rank = computeRank(score, scoreProcessor);
-            score.TotalScore = convertFromLegacyTotalScore(score, ruleset, difficulty, attributes);
+            (score.TotalScoreWithoutMods, score.TotalScore) = convertFromLegacyTotalScore(score, ruleset, difficulty, attributes);
         }
 
         /// <summary>
@@ -283,17 +281,13 @@ namespace osu.Game.Database
         /// <param name="ruleset">The <see cref="Ruleset"/> in which the score was set.</param>
         /// <param name="beatmap">The <see cref="WorkingBeatmap"/> applicable for this score.</param>
         /// <returns>The standardised total score.</returns>
-        private static long convertFromLegacyTotalScore(ScoreInfo score, Ruleset ruleset, WorkingBeatmap beatmap)
+        private static (long withoutMods, long withMods) convertFromLegacyTotalScore(ScoreInfo score, Ruleset ruleset, WorkingBeatmap beatmap)
         {
             if (!score.IsLegacyScore)
-                return score.TotalScore;
+                return (score.TotalScoreWithoutMods, score.TotalScore);
 
             if (ruleset is not ILegacyRuleset legacyRuleset)
-                return score.TotalScore;
-
-            var mods = score.Mods;
-            if (mods.Any(mod => mod is ModScoreV2))
-                return score.TotalScore;
+                return (score.TotalScoreWithoutMods, score.TotalScore);
 
             var playableBeatmap = beatmap.GetPlayableBeatmap(ruleset.RulesetInfo, score.Mods);
 
@@ -302,8 +296,13 @@ namespace osu.Game.Database
 
             ILegacyScoreSimulator sv1Simulator = legacyRuleset.CreateLegacyScoreSimulator();
             LegacyScoreAttributes attributes = sv1Simulator.Simulate(beatmap, playableBeatmap);
+            var legacyBeatmapConversionDifficultyInfo = LegacyBeatmapConversionDifficultyInfo.FromBeatmap(beatmap.Beatmap);
 
-            return convertFromLegacyTotalScore(score, ruleset, LegacyBeatmapConversionDifficultyInfo.FromBeatmap(beatmap.Beatmap), attributes);
+            var mods = score.Mods;
+            if (mods.Any(mod => mod is ModScoreV2))
+                return ((long)Math.Round(score.TotalScore / sv1Simulator.GetLegacyScoreMultiplier(mods, legacyBeatmapConversionDifficultyInfo)), score.TotalScore);
+
+            return convertFromLegacyTotalScore(score, ruleset, legacyBeatmapConversionDifficultyInfo, attributes);
         }
 
         /// <summary>
@@ -314,15 +313,15 @@ namespace osu.Game.Database
         /// <param name="difficulty">The beatmap difficulty.</param>
         /// <param name="attributes">The legacy scoring attributes for the beatmap which the score was set on.</param>
         /// <returns>The standardised total score.</returns>
-        private static long convertFromLegacyTotalScore(ScoreInfo score, Ruleset ruleset, LegacyBeatmapConversionDifficultyInfo difficulty, LegacyScoreAttributes attributes)
+        private static (long withoutMods, long withMods) convertFromLegacyTotalScore(ScoreInfo score, Ruleset ruleset, LegacyBeatmapConversionDifficultyInfo difficulty, LegacyScoreAttributes attributes)
         {
             if (!score.IsLegacyScore)
-                return score.TotalScore;
+                return (score.TotalScoreWithoutMods, score.TotalScore);
 
             Debug.Assert(score.LegacyTotalScore != null);
 
             if (ruleset is not ILegacyRuleset legacyRuleset)
-                return score.TotalScore;
+                return (score.TotalScoreWithoutMods, score.TotalScore);
 
             double legacyModMultiplier = legacyRuleset.CreateLegacyScoreSimulator().GetLegacyScoreMultiplier(score.Mods, difficulty);
             int maximumLegacyAccuracyScore = attributes.AccuracyScore;
@@ -354,17 +353,18 @@ namespace osu.Game.Database
 
             double modMultiplier = score.Mods.Select(m => m.ScoreMultiplier).Aggregate(1.0, (c, n) => c * n);
 
-            long convertedTotalScore;
+            long convertedTotalScoreWithoutMods;
 
             switch (score.Ruleset.OnlineID)
             {
                 case 0:
                     if (score.MaxCombo == 0 || score.Accuracy == 0)
                     {
-                        return (long)Math.Round((
+                        convertedTotalScoreWithoutMods = (long)Math.Round(
                             0
                             + 500000 * Math.Pow(score.Accuracy, 5)
-                            + bonusProportion) * modMultiplier);
+                            + bonusProportion);
+                        break;
                     }
 
                     // see similar check above.
@@ -372,10 +372,11 @@ namespace osu.Game.Database
                     // are either pointless or wildly wrong.
                     if (maximumLegacyComboScore + maximumLegacyBonusScore == 0)
                     {
-                        return (long)Math.Round((
+                        convertedTotalScoreWithoutMods = (long)Math.Round(
                             500000 * comboProportion // as above, zero if mods result in zero multiplier, one otherwise
                             + 500000 * Math.Pow(score.Accuracy, 5)
-                            + bonusProportion) * modMultiplier);
+                            + bonusProportion);
+                        break;
                     }
 
                     // Assumptions:
@@ -472,17 +473,17 @@ namespace osu.Game.Database
 
                     double newComboScoreProportion = estimatedComboPortionInStandardisedScore / maximumAchievableComboPortionInStandardisedScore;
 
-                    convertedTotalScore = (long)Math.Round((
+                    convertedTotalScoreWithoutMods = (long)Math.Round(
                         500000 * newComboScoreProportion * score.Accuracy
                         + 500000 * Math.Pow(score.Accuracy, 5)
-                        + bonusProportion) * modMultiplier);
+                        + bonusProportion);
                     break;
 
                 case 1:
-                    convertedTotalScore = (long)Math.Round((
+                    convertedTotalScoreWithoutMods = (long)Math.Round(
                         250000 * comboProportion
                         + 750000 * Math.Pow(score.Accuracy, 3.6)
-                        + bonusProportion) * modMultiplier);
+                        + bonusProportion);
                     break;
 
                 case 2:
@@ -507,28 +508,28 @@ namespace osu.Game.Database
                         ? 0
                         : (double)score.Statistics.GetValueOrDefault(HitResult.SmallTickHit) / score.MaximumStatistics.GetValueOrDefault(HitResult.SmallTickHit);
 
-                    convertedTotalScore = (long)Math.Round((
+                    convertedTotalScoreWithoutMods = (long)Math.Round(
                         comboPortion * estimateComboProportionForCatch(attributes.MaxCombo, score.MaxCombo, score.Statistics.GetValueOrDefault(HitResult.Miss))
                         + dropletsPortion * dropletsHit
-                        + bonusProportion) * modMultiplier);
+                        + bonusProportion);
                     break;
 
                 case 3:
-                    convertedTotalScore = (long)Math.Round((
+                    convertedTotalScoreWithoutMods = (long)Math.Round(
                         850000 * comboProportion
                         + 150000 * Math.Pow(score.Accuracy, 2 + 2 * score.Accuracy)
-                        + bonusProportion) * modMultiplier);
+                        + bonusProportion);
                     break;
 
                 default:
-                    convertedTotalScore = score.TotalScore;
-                    break;
+                    return (score.TotalScoreWithoutMods, score.TotalScore);
             }
 
-            if (convertedTotalScore < 0)
-                throw new InvalidOperationException($"Total score conversion operation returned invalid total of {convertedTotalScore}");
+            if (convertedTotalScoreWithoutMods < 0)
+                throw new InvalidOperationException($"Total score conversion operation returned invalid total of {convertedTotalScoreWithoutMods}");
 
-            return convertedTotalScore;
+            long convertedTotalScore = (long)Math.Round(convertedTotalScoreWithoutMods * modMultiplier);
+            return (convertedTotalScoreWithoutMods, convertedTotalScore);
         }
 
         /// <summary>

From 148afd120127c58655ed35190fb7456ce1f0e973 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Tue, 21 May 2024 14:47:34 +0200
Subject: [PATCH 870/930] Change Speedchange behaviour to keep changing while
 holding key, Add Toast to nofity user what just happend

---
 osu.Game/Localisation/ToastStrings.cs     |  5 +++++
 osu.Game/Overlays/OSD/SpeedChangeToast.cs | 17 +++++++++++++++
 osu.Game/Screens/Select/SongSelect.cs     | 26 ++++++++++++++++-------
 3 files changed, 40 insertions(+), 8 deletions(-)
 create mode 100644 osu.Game/Overlays/OSD/SpeedChangeToast.cs

diff --git a/osu.Game/Localisation/ToastStrings.cs b/osu.Game/Localisation/ToastStrings.cs
index da798a3937..33027966dd 100644
--- a/osu.Game/Localisation/ToastStrings.cs
+++ b/osu.Game/Localisation/ToastStrings.cs
@@ -49,6 +49,11 @@ namespace osu.Game.Localisation
         /// </summary>
         public static LocalisableString UrlCopied => new TranslatableString(getKey(@"url_copied"), @"URL copied");
 
+        /// <summary>
+        /// "Speed Changed"
+        /// </summary>
+        public static LocalisableString SpeedChanged => new TranslatableString(getKey(@"speed_changed"), @"Speed Changed");
+
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
 }
diff --git a/osu.Game/Overlays/OSD/SpeedChangeToast.cs b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
new file mode 100644
index 0000000000..73ba23622b
--- /dev/null
+++ b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
@@ -0,0 +1,17 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Configuration;
+using osu.Game.Input.Bindings;
+using osu.Game.Localisation;
+
+namespace osu.Game.Overlays.OSD
+{
+    public partial class SpeedChangeToast : Toast
+    {
+        public SpeedChangeToast(OsuConfigManager config, double delta)
+            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChanged, config.LookupKeyBindings(GlobalAction.IncreaseSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseSpeed))
+        {
+        }
+    }
+}
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index e1447b284a..7eb2be9100 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -30,6 +30,7 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
+using osu.Game.Overlays.OSD;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Backgrounds;
@@ -151,6 +152,12 @@ namespace osu.Game.Screens.Select
 
         private bool usedPitchMods;
 
+        [Resolved]
+        private OnScreenDisplay? onScreenDisplay { get; set; }
+
+        [Resolved]
+        private OsuConfigManager? config { get; set; }
+
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, OsuColour colours, ManageCollectionsDialog? manageCollectionsDialog, DifficultyRecommender? recommender, OsuConfigManager config)
         {
@@ -819,7 +826,7 @@ namespace osu.Game.Screens.Select
         public void ChangeSpeed(double delta)
         {
             // Mod Change from 0.95 DC to 1.0 none to 1.05 DT/NC ?
-
+            onScreenDisplay?.Display(new SpeedChangeToast(config!, delta));
             if (game == null) return;
 
             ModNightcore modNc = (ModNightcore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModNightcore) > 0)).Mods.First(mod => mod is ModNightcore);
@@ -1135,17 +1142,10 @@ namespace osu.Game.Screens.Select
 
         public virtual bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            if (e.Repeat)
-                return false;
-
             if (!this.IsCurrentScreen()) return false;
 
             switch (e.Action)
             {
-                case GlobalAction.Select:
-                    FinaliseSelection();
-                    return true;
-
                 case GlobalAction.IncreaseSpeed:
                     ChangeSpeed(0.05);
                     return true;
@@ -1155,6 +1155,16 @@ namespace osu.Game.Screens.Select
                     return true;
             }
 
+            if (e.Repeat)
+                return false;
+
+            switch (e.Action)
+            {
+                case GlobalAction.Select:
+                    FinaliseSelection();
+                    return true;
+            }
+
             return false;
         }
 

From 3403789c6fef04827679b27715b653778b7d0aed Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Tue, 21 May 2024 16:11:20 +0200
Subject: [PATCH 871/930] Toast now only shows when speed is actually changed

---
 osu.Game/Screens/Select/SongSelect.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 7eb2be9100..b78134392b 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -825,8 +825,6 @@ namespace osu.Game.Screens.Select
 
         public void ChangeSpeed(double delta)
         {
-            // Mod Change from 0.95 DC to 1.0 none to 1.05 DT/NC ?
-            onScreenDisplay?.Display(new SpeedChangeToast(config!, delta));
             if (game == null) return;
 
             ModNightcore modNc = (ModNightcore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModNightcore) > 0)).Mods.First(mod => mod is ModNightcore);
@@ -841,6 +839,8 @@ namespace osu.Game.Screens.Select
             if (incompatiableModActive)
                 return;
 
+            onScreenDisplay?.Display(new SpeedChangeToast(config!, delta));
+
             if (rateModActive)
             {
                 ModRateAdjust mod = (ModRateAdjust)selectedMods.Value.First(mod => mod is ModRateAdjust);

From 99d99cede03993796aa4f8fe5f1d344a9cfe9472 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 11:59:34 +0800
Subject: [PATCH 872/930] Basic cleanup

Before I gave up on attempting to fix the method.
---
 osu.Game/Screens/Select/SongSelect.cs | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index b78134392b..18d5799bae 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -100,7 +100,7 @@ namespace osu.Game.Screens.Select
         };
 
         [Resolved]
-        private OsuGameBase? game { get; set; }
+        private OsuGameBase game { get; set; } = null!;
 
         [Resolved]
         private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; } = null!;
@@ -156,7 +156,7 @@ namespace osu.Game.Screens.Select
         private OnScreenDisplay? onScreenDisplay { get; set; }
 
         [Resolved]
-        private OsuConfigManager? config { get; set; }
+        private OsuConfigManager config { get; set; } = null!;
 
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, OsuColour colours, ManageCollectionsDialog? manageCollectionsDialog, DifficultyRecommender? recommender, OsuConfigManager config)
@@ -825,21 +825,19 @@ namespace osu.Game.Screens.Select
 
         public void ChangeSpeed(double delta)
         {
-            if (game == null) return;
-
             ModNightcore modNc = (ModNightcore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModNightcore) > 0)).Mods.First(mod => mod is ModNightcore);
             ModDoubleTime modDt = (ModDoubleTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDoubleTime) > 0)).Mods.First(mod => mod is ModDoubleTime);
             ModDaycore modDc = (ModDaycore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDaycore) > 0)).Mods.First(mod => mod is ModDaycore);
             ModHalfTime modHt = (ModHalfTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModHalfTime) > 0)).Mods.First(mod => mod is ModHalfTime);
             bool rateModActive = selectedMods.Value.Count(mod => mod is ModRateAdjust) > 0;
-            bool incompatiableModActive = selectedMods.Value.Count(mod => modDt.IncompatibleMods.Count(incompatibleMod => (mod.GetType().IsSubclassOf(incompatibleMod) || mod.GetType() == incompatibleMod) && incompatibleMod != typeof(ModRateAdjust)) > 0) > 0;
+            bool incompatibleModActive = selectedMods.Value.Count(mod => modDt.IncompatibleMods.Count(incompatibleMod => (mod.GetType().IsSubclassOf(incompatibleMod) || mod.GetType() == incompatibleMod) && incompatibleMod != typeof(ModRateAdjust)) > 0) > 0;
             double newRate = 1d + delta;
             bool isPositive = delta > 0;
 
-            if (incompatiableModActive)
+            if (incompatibleModActive)
                 return;
 
-            onScreenDisplay?.Display(new SpeedChangeToast(config!, delta));
+            onScreenDisplay?.Display(new SpeedChangeToast(config, delta));
 
             if (rateModActive)
             {
@@ -912,7 +910,7 @@ namespace osu.Game.Screens.Select
             }
             else
             {
-                // If no ModRateAdjust is actived activate one
+                // If no ModRateAdjust is active, activate one
                 if (isPositive)
                 {
                     if (!usedPitchMods)

From 02a388cba6493207a170728abd607d80bfdecb3a Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 12:03:48 +0800
Subject: [PATCH 873/930] Fix enum not being at end (and adjust naming)

---
 osu.Game/Input/Bindings/GlobalActionContainer.cs | 16 ++++++++--------
 .../GlobalActionKeyBindingStrings.cs             |  8 ++++----
 osu.Game/Overlays/Mods/ModSelectOverlay.cs       |  4 ++--
 osu.Game/Overlays/OSD/SpeedChangeToast.cs        |  2 +-
 osu.Game/Screens/Select/SongSelect.cs            |  4 ++--
 5 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/osu.Game/Input/Bindings/GlobalActionContainer.cs b/osu.Game/Input/Bindings/GlobalActionContainer.cs
index b0a1684512..09db7461d6 100644
--- a/osu.Game/Input/Bindings/GlobalActionContainer.cs
+++ b/osu.Game/Input/Bindings/GlobalActionContainer.cs
@@ -182,8 +182,8 @@ namespace osu.Game.Input.Bindings
             new KeyBinding(new[] { InputKey.Shift, InputKey.F2 }, GlobalAction.SelectPreviousRandom),
             new KeyBinding(InputKey.F3, GlobalAction.ToggleBeatmapOptions),
             new KeyBinding(InputKey.BackSpace, GlobalAction.DeselectAllMods),
-            new KeyBinding(new[] { InputKey.Control, InputKey.Up }, GlobalAction.IncreaseSpeed),
-            new KeyBinding(new[] { InputKey.Control, InputKey.Down }, GlobalAction.DecreaseSpeed),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Up }, GlobalAction.IncreaseModSpeed),
+            new KeyBinding(new[] { InputKey.Control, InputKey.Down }, GlobalAction.DecreaseModSpeed),
         };
 
         private static IEnumerable<KeyBinding> audioControlKeyBindings => new[]
@@ -411,12 +411,6 @@ namespace osu.Game.Input.Bindings
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.EditorToggleRotateControl))]
         EditorToggleRotateControl,
 
-        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.IncreaseSpeed))]
-        IncreaseSpeed,
-
-        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DecreaseSpeed))]
-        DecreaseSpeed,
-
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.IncreaseOffset))]
         IncreaseOffset,
 
@@ -428,6 +422,12 @@ namespace osu.Game.Input.Bindings
 
         [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.StepReplayBackward))]
         StepReplayBackward,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.IncreaseModSpeed))]
+        IncreaseModSpeed,
+
+        [LocalisableDescription(typeof(GlobalActionKeyBindingStrings), nameof(GlobalActionKeyBindingStrings.DecreaseModSpeed))]
+        DecreaseModSpeed,
     }
 
     public enum GlobalActionCategory
diff --git a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
index d0cbf52f07..18a1d3e4fe 100644
--- a/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
+++ b/osu.Game/Localisation/GlobalActionKeyBindingStrings.cs
@@ -370,14 +370,14 @@ namespace osu.Game.Localisation
         public static LocalisableString EditorToggleRotateControl => new TranslatableString(getKey(@"editor_toggle_rotate_control"), @"Toggle rotate control");
 
         /// <summary>
-        /// "Increase Speed"
+        /// "Increase mod speed"
         /// </summary>
-        public static LocalisableString IncreaseSpeed => new TranslatableString(getKey(@"increase_speed"), @"Increase Speed");
+        public static LocalisableString IncreaseModSpeed => new TranslatableString(getKey(@"increase_mod_speed"), @"Increase mod speed");
 
         /// <summary>
-        /// "Decrease Speed"
+        /// "Decrease mod speed"
         /// </summary>
-        public static LocalisableString DecreaseSpeed => new TranslatableString(getKey(@"decrease_speed"), @"Decrease Speed");
+        public static LocalisableString DecreaseModSpeed => new TranslatableString(getKey(@"decrease_mod_speed"), @"Decrease mod speed");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 572379ea2c..3b8090a4b2 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -757,11 +757,11 @@ namespace osu.Game.Overlays.Mods
                     return true;
                 }
 
-                case GlobalAction.IncreaseSpeed:
+                case GlobalAction.IncreaseModSpeed:
                     songSelect!.ChangeSpeed(0.05);
                     return true;
 
-                case GlobalAction.DecreaseSpeed:
+                case GlobalAction.DecreaseModSpeed:
                     songSelect!.ChangeSpeed(-0.05);
                     return true;
             }
diff --git a/osu.Game/Overlays/OSD/SpeedChangeToast.cs b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
index 73ba23622b..231ef86526 100644
--- a/osu.Game/Overlays/OSD/SpeedChangeToast.cs
+++ b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
@@ -10,7 +10,7 @@ namespace osu.Game.Overlays.OSD
     public partial class SpeedChangeToast : Toast
     {
         public SpeedChangeToast(OsuConfigManager config, double delta)
-            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChanged, config.LookupKeyBindings(GlobalAction.IncreaseSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseSpeed))
+            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChanged, config.LookupKeyBindings(GlobalAction.IncreaseModSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseModSpeed))
         {
         }
     }
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 18d5799bae..257f6583a4 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -1144,11 +1144,11 @@ namespace osu.Game.Screens.Select
 
             switch (e.Action)
             {
-                case GlobalAction.IncreaseSpeed:
+                case GlobalAction.IncreaseModSpeed:
                     ChangeSpeed(0.05);
                     return true;
 
-                case GlobalAction.DecreaseSpeed:
+                case GlobalAction.DecreaseModSpeed:
                     ChangeSpeed(-0.05);
                     return true;
             }

From f979200712aa0336de04e30fb2b3bebd714b5920 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 12:06:51 +0800
Subject: [PATCH 874/930] Use null conditional rather than implicit not-null

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 3b8090a4b2..ad589e8fa9 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -758,11 +758,11 @@ namespace osu.Game.Overlays.Mods
                 }
 
                 case GlobalAction.IncreaseModSpeed:
-                    songSelect!.ChangeSpeed(0.05);
+                    songSelect?.ChangeSpeed(0.05);
                     return true;
 
                 case GlobalAction.DecreaseModSpeed:
-                    songSelect!.ChangeSpeed(-0.05);
+                    songSelect?.ChangeSpeed(-0.05);
                     return true;
             }
 

From d0b1ebff5a616ca89391a87699df320edbb695a3 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 16:29:39 +0800
Subject: [PATCH 875/930] Revert "Temporary rollback of framework / SDL3"

This reverts commit d7d569cf4e68acdbcc9cec844337f93bdb207a54.
---
 osu.Android.props                             |  2 +-
 osu.Android/AndroidJoystickSettings.cs        | 76 ---------------
 osu.Android/AndroidMouseSettings.cs           | 97 -------------------
 osu.Android/OsuGameAndroid.cs                 | 22 -----
 osu.Desktop/OsuGameDesktop.cs                 | 11 ++-
 osu.Desktop/Program.cs                        | 33 ++++---
 .../Components/PathControlPointVisualiser.cs  |  2 +-
 osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs      |  3 +-
 osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs  |  3 +-
 .../Screens/Ladder/LadderDragContainer.cs     |  2 +-
 osu.Game/Database/EmptyRealmSet.cs            |  5 +
 .../UserInterface/ExpandableSlider.cs         |  8 +-
 .../Graphics/UserInterface/OsuSliderBar.cs    |  9 +-
 .../Graphics/UserInterface/OsuTabControl.cs   | 24 +++--
 .../Graphics/UserInterface/PageTabControl.cs  | 14 ++-
 .../UserInterface/RoundedSliderBar.cs         |  5 +-
 .../UserInterface/ShearedSliderBar.cs         |  5 +-
 .../UserInterfaceV2/LabelledSliderBar.cs      |  4 +-
 .../UserInterfaceV2/SliderWithTextBoxInput.cs |  8 +-
 osu.Game/OsuGameBase.cs                       | 12 ++-
 .../BeatmapListingCardSizeTabControl.cs       | 12 ++-
 ...BeatmapSearchMultipleSelectionFilterRow.cs |  4 +
 .../Overlays/BeatmapListing/FilterTabItem.cs  | 12 ++-
 .../BeatmapSet/BeatmapRulesetSelector.cs      |  2 +-
 .../OverlayPanelDisplayStyleControl.cs        | 14 ++-
 osu.Game/Overlays/OverlayRulesetTabItem.cs    | 14 ++-
 osu.Game/Overlays/OverlayStreamItem.cs        | 12 ++-
 osu.Game/Overlays/OverlayTabControl.cs        | 14 ++-
 .../Overlays/Settings/Sections/SizeSlider.cs  |  3 +-
 .../Settings/SettingsPercentageSlider.cs      |  4 +-
 osu.Game/Overlays/Settings/SettingsSlider.cs  |  6 +-
 .../Toolbar/ToolbarRulesetSelector.cs         | 16 +--
 .../Toolbar/ToolbarRulesetTabButton.cs        | 12 +++
 osu.Game/Rulesets/Mods/DifficultyBindable.cs  |  2 +-
 .../Objects/Drawables/DrawableHitObject.cs    |  3 +-
 .../Scoring/LegacyDrainingHealthProcessor.cs  |  7 ++
 .../Rulesets/UI/FrameStabilityContainer.cs    |  2 +-
 .../Timeline/TimelineTickDisplay.cs           |  3 +-
 osu.Game/Screens/Edit/Editor.cs               | 14 +--
 .../IndeterminateSliderWithTextBoxInput.cs    |  8 +-
 .../Match/Components/MatchTypePicker.cs       | 11 ++-
 .../Play/PlayerSettings/PlayerSliderBar.cs    |  4 +-
 osu.Game/osu.Game.csproj                      |  4 +-
 osu.iOS.props                                 |  2 +-
 44 files changed, 226 insertions(+), 304 deletions(-)
 delete mode 100644 osu.Android/AndroidJoystickSettings.cs
 delete mode 100644 osu.Android/AndroidMouseSettings.cs

diff --git a/osu.Android.props b/osu.Android.props
index 2d7a9d2652..e20ac2e0b7 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.509.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Android/AndroidJoystickSettings.cs b/osu.Android/AndroidJoystickSettings.cs
deleted file mode 100644
index bf69461f0d..0000000000
--- a/osu.Android/AndroidJoystickSettings.cs
+++ /dev/null
@@ -1,76 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Localisation;
-using osu.Game.Localisation;
-using osu.Game.Overlays.Settings;
-
-namespace osu.Android
-{
-    public partial class AndroidJoystickSettings : SettingsSubsection
-    {
-        protected override LocalisableString Header => JoystickSettingsStrings.JoystickGamepad;
-
-        private readonly AndroidJoystickHandler joystickHandler;
-
-        private readonly Bindable<bool> enabled = new BindableBool(true);
-
-        private SettingsSlider<float> deadzoneSlider = null!;
-
-        private Bindable<float> handlerDeadzone = null!;
-
-        private Bindable<float> localDeadzone = null!;
-
-        public AndroidJoystickSettings(AndroidJoystickHandler joystickHandler)
-        {
-            this.joystickHandler = joystickHandler;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load()
-        {
-            // use local bindable to avoid changing enabled state of game host's bindable.
-            handlerDeadzone = joystickHandler.DeadzoneThreshold.GetBoundCopy();
-            localDeadzone = handlerDeadzone.GetUnboundCopy();
-
-            Children = new Drawable[]
-            {
-                new SettingsCheckbox
-                {
-                    LabelText = CommonStrings.Enabled,
-                    Current = enabled
-                },
-                deadzoneSlider = new SettingsSlider<float>
-                {
-                    LabelText = JoystickSettingsStrings.DeadzoneThreshold,
-                    KeyboardStep = 0.01f,
-                    DisplayAsPercentage = true,
-                    Current = localDeadzone,
-                },
-            };
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            enabled.BindTo(joystickHandler.Enabled);
-            enabled.BindValueChanged(e => deadzoneSlider.Current.Disabled = !e.NewValue, true);
-
-            handlerDeadzone.BindValueChanged(val =>
-            {
-                bool disabled = localDeadzone.Disabled;
-
-                localDeadzone.Disabled = false;
-                localDeadzone.Value = val.NewValue;
-                localDeadzone.Disabled = disabled;
-            }, true);
-
-            localDeadzone.BindValueChanged(val => handlerDeadzone.Value = val.NewValue);
-        }
-    }
-}
diff --git a/osu.Android/AndroidMouseSettings.cs b/osu.Android/AndroidMouseSettings.cs
deleted file mode 100644
index fd01b11164..0000000000
--- a/osu.Android/AndroidMouseSettings.cs
+++ /dev/null
@@ -1,97 +0,0 @@
-// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
-// See the LICENCE file in the repository root for full licence text.
-
-using Android.OS;
-using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
-using osu.Framework.Bindables;
-using osu.Framework.Graphics;
-using osu.Framework.Localisation;
-using osu.Game.Configuration;
-using osu.Game.Localisation;
-using osu.Game.Overlays.Settings;
-using osu.Game.Overlays.Settings.Sections.Input;
-
-namespace osu.Android
-{
-    public partial class AndroidMouseSettings : SettingsSubsection
-    {
-        private readonly AndroidMouseHandler mouseHandler;
-
-        protected override LocalisableString Header => MouseSettingsStrings.Mouse;
-
-        private Bindable<double> handlerSensitivity = null!;
-
-        private Bindable<double> localSensitivity = null!;
-
-        private Bindable<bool> relativeMode = null!;
-
-        public AndroidMouseSettings(AndroidMouseHandler mouseHandler)
-        {
-            this.mouseHandler = mouseHandler;
-        }
-
-        [BackgroundDependencyLoader]
-        private void load(OsuConfigManager osuConfig)
-        {
-            // use local bindable to avoid changing enabled state of game host's bindable.
-            handlerSensitivity = mouseHandler.Sensitivity.GetBoundCopy();
-            localSensitivity = handlerSensitivity.GetUnboundCopy();
-
-            relativeMode = mouseHandler.UseRelativeMode.GetBoundCopy();
-
-            // High precision/pointer capture is only available on Android 8.0 and up
-            if (Build.VERSION.SdkInt >= BuildVersionCodes.O)
-            {
-                AddRange(new Drawable[]
-                {
-                    new SettingsCheckbox
-                    {
-                        LabelText = MouseSettingsStrings.HighPrecisionMouse,
-                        TooltipText = MouseSettingsStrings.HighPrecisionMouseTooltip,
-                        Current = relativeMode,
-                        Keywords = new[] { @"raw", @"input", @"relative", @"cursor", @"captured", @"pointer" },
-                    },
-                    new MouseSettings.SensitivitySetting
-                    {
-                        LabelText = MouseSettingsStrings.CursorSensitivity,
-                        Current = localSensitivity,
-                    },
-                });
-            }
-
-            AddRange(new Drawable[]
-            {
-                new SettingsCheckbox
-                {
-                    LabelText = MouseSettingsStrings.DisableMouseWheelVolumeAdjust,
-                    TooltipText = MouseSettingsStrings.DisableMouseWheelVolumeAdjustTooltip,
-                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableWheel),
-                },
-                new SettingsCheckbox
-                {
-                    LabelText = MouseSettingsStrings.DisableClicksDuringGameplay,
-                    Current = osuConfig.GetBindable<bool>(OsuSetting.MouseDisableButtons),
-                },
-            });
-        }
-
-        protected override void LoadComplete()
-        {
-            base.LoadComplete();
-
-            relativeMode.BindValueChanged(relative => localSensitivity.Disabled = !relative.NewValue, true);
-
-            handlerSensitivity.BindValueChanged(val =>
-            {
-                bool disabled = localSensitivity.Disabled;
-
-                localSensitivity.Disabled = false;
-                localSensitivity.Value = val.NewValue;
-                localSensitivity.Disabled = disabled;
-            }, true);
-
-            localSensitivity.BindValueChanged(val => handlerSensitivity.Value = val.NewValue);
-        }
-    }
-}
diff --git a/osu.Android/OsuGameAndroid.cs b/osu.Android/OsuGameAndroid.cs
index 52cfb67f42..a235913ef3 100644
--- a/osu.Android/OsuGameAndroid.cs
+++ b/osu.Android/OsuGameAndroid.cs
@@ -5,13 +5,9 @@ using System;
 using Android.App;
 using Microsoft.Maui.Devices;
 using osu.Framework.Allocation;
-using osu.Framework.Android.Input;
 using osu.Framework.Extensions.ObjectExtensions;
-using osu.Framework.Input.Handlers;
 using osu.Framework.Platform;
 using osu.Game;
-using osu.Game.Overlays.Settings;
-using osu.Game.Overlays.Settings.Sections.Input;
 using osu.Game.Updater;
 using osu.Game.Utils;
 
@@ -88,24 +84,6 @@ namespace osu.Android
 
         protected override BatteryInfo CreateBatteryInfo() => new AndroidBatteryInfo();
 
-        public override SettingsSubsection CreateSettingsSubsectionFor(InputHandler handler)
-        {
-            switch (handler)
-            {
-                case AndroidMouseHandler mh:
-                    return new AndroidMouseSettings(mh);
-
-                case AndroidJoystickHandler jh:
-                    return new AndroidJoystickSettings(jh);
-
-                case AndroidTouchHandler th:
-                    return new TouchSettings(th);
-
-                default:
-                    return base.CreateSettingsSubsectionFor(handler);
-            }
-        }
-
         private class AndroidBatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel => Battery.ChargeLevel;
diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index 2b232db274..e8783c997a 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -22,7 +22,7 @@ using osu.Game.IPC;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Performance;
 using osu.Game.Utils;
-using SDL2;
+using SDL;
 
 namespace osu.Desktop
 {
@@ -161,7 +161,7 @@ namespace osu.Desktop
             host.Window.Title = Name;
         }
 
-        protected override BatteryInfo CreateBatteryInfo() => new SDL2BatteryInfo();
+        protected override BatteryInfo CreateBatteryInfo() => new SDL3BatteryInfo();
 
         protected override void Dispose(bool isDisposing)
         {
@@ -170,13 +170,14 @@ namespace osu.Desktop
             archiveImportIPCChannel?.Dispose();
         }
 
-        private class SDL2BatteryInfo : BatteryInfo
+        private unsafe class SDL3BatteryInfo : BatteryInfo
         {
             public override double? ChargeLevel
             {
                 get
                 {
-                    SDL.SDL_GetPowerInfo(out _, out int percentage);
+                    int percentage;
+                    SDL3.SDL_GetPowerInfo(null, &percentage);
 
                     if (percentage == -1)
                         return null;
@@ -185,7 +186,7 @@ namespace osu.Desktop
                 }
             }
 
-            public override bool OnBattery => SDL.SDL_GetPowerInfo(out _, out _) == SDL.SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
+            public override bool OnBattery => SDL3.SDL_GetPowerInfo(null, null) == SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
         }
     }
 }
diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 2d7ec5aa5f..23e56cdce9 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -13,7 +13,7 @@ using osu.Framework.Platform;
 using osu.Game;
 using osu.Game.IPC;
 using osu.Game.Tournament;
-using SDL2;
+using SDL;
 using Squirrel;
 
 namespace osu.Desktop
@@ -52,16 +52,19 @@ namespace osu.Desktop
                 // See https://www.mongodb.com/docs/realm/sdk/dotnet/compatibility/
                 if (windowsVersion.Major < 6 || (windowsVersion.Major == 6 && windowsVersion.Minor <= 2))
                 {
-                    // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
-                    // disabling it ourselves.
-                    // We could also better detect compatibility mode if required:
-                    // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
-                    SDL.SDL_ShowSimpleMessageBox(SDL.SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
-                        "Your operating system is too old to run osu!",
-                        "This version of osu! requires at least Windows 8.1 to run.\n"
-                        + "Please upgrade your operating system or consider using an older version of osu!.\n\n"
-                        + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!", IntPtr.Zero);
-                    return;
+                    unsafe
+                    {
+                        // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
+                        // disabling it ourselves.
+                        // We could also better detect compatibility mode if required:
+                        // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
+                        SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
+                            "Your operating system is too old to run osu!"u8,
+                            "This version of osu! requires at least Windows 8.1 to run.\n"u8
+                            + "Please upgrade your operating system or consider using an older version of osu!.\n\n"u8
+                            + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!"u8, null);
+                        return;
+                    }
                 }
 
                 setupSquirrel();
@@ -104,7 +107,13 @@ namespace osu.Desktop
                 }
             }
 
-            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, new HostOptions { IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null }))
+            var hostOptions = new HostOptions
+            {
+                IPCPort = !tournamentClient ? OsuGame.IPC_PORT : null,
+                FriendlyGameName = OsuGameBase.GAME_NAME,
+            };
+
+            using (DesktopGameHost host = Host.GetSuitableDesktopHost(gameName, hostOptions))
             {
                 if (!host.IsPrimaryInstance)
                 {
diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
index 836d348ff4..afc2d407e9 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/PathControlPointVisualiser.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         }
 
         // Generally all the control points are within the visible area all the time.
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => true;
+        public override bool UpdateSubTreeMasking() => true;
 
         /// <summary>
         /// Handles correction of invalid path types.
diff --git a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
index 4933eb4041..93c3450904 100644
--- a/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
+++ b/osu.Game.Rulesets.Osu/UI/OsuPlayfield.cs
@@ -8,7 +8,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Primitives;
 using osu.Game.Beatmaps;
 using osu.Game.Rulesets.Judgements;
 using osu.Game.Rulesets.Objects;
@@ -37,7 +36,7 @@ namespace osu.Game.Rulesets.Osu.UI
 
         // For osu! gameplay, everything is always on screen.
         // Skipping masking calculations improves performance in intense beatmaps (ie. https://osu.ppy.sh/beatmapsets/150945#osu/372245)
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         public SmokeContainer Smoke { get; }
         public FollowPointRenderer FollowPoints { get; }
diff --git a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
index 0510f08068..bdcb341fb4 100644
--- a/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
+++ b/osu.Game.Rulesets.Taiko/UI/TaikoPlayfield.cs
@@ -7,7 +7,6 @@ using System.Linq;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
-using osu.Framework.Graphics.Primitives;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Objects.Drawables;
 using osu.Game.Rulesets.Judgements;
@@ -345,7 +344,7 @@ namespace osu.Game.Rulesets.Taiko.UI
         {
             public void Add(Drawable proxy) => AddInternal(proxy);
 
-            public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds)
+            public override bool UpdateSubTreeMasking()
             {
                 // DrawableHitObject disables masking.
                 // Hitobject content is proxied and unproxied based on hit status and the IsMaskedAway value could get stuck because of this.
diff --git a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
index 3a2db4fc71..111dede815 100644
--- a/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
+++ b/osu.Game.Tournament/Screens/Ladder/LadderDragContainer.cs
@@ -22,7 +22,7 @@ namespace osu.Game.Tournament.Screens.Ladder
 
         protected override bool ComputeIsMaskedAway(RectangleF maskingBounds) => false;
 
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         protected override void OnDrag(DragEvent e)
         {
diff --git a/osu.Game/Database/EmptyRealmSet.cs b/osu.Game/Database/EmptyRealmSet.cs
index 02dfa50fe5..c34974cb03 100644
--- a/osu.Game/Database/EmptyRealmSet.cs
+++ b/osu.Game/Database/EmptyRealmSet.cs
@@ -6,6 +6,7 @@ using System.Collections;
 using System.Collections.Generic;
 using System.Collections.Specialized;
 using System.ComponentModel;
+using JetBrains.Annotations;
 using Realms;
 using Realms.Schema;
 
@@ -15,8 +16,12 @@ namespace osu.Game.Database
     {
         private IList<T> emptySet => Array.Empty<T>();
 
+        [MustDisposeResource]
         public IEnumerator<T> GetEnumerator() => emptySet.GetEnumerator();
+
+        [MustDisposeResource]
         IEnumerator IEnumerable.GetEnumerator() => emptySet.GetEnumerator();
+
         public int Count => emptySet.Count;
         public T this[int index] => emptySet[index];
         public int IndexOf(object? item) => item == null ? -1 : emptySet.IndexOf((T)item);
diff --git a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
index 121a1eef49..a7a8561b94 100644
--- a/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
+++ b/osu.Game/Graphics/UserInterface/ExpandableSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,7 +10,7 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Sprites;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
@@ -18,7 +18,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T, TSlider> : CompositeDrawable, IExpandable, IHasCurrentValue<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
         where TSlider : RoundedSliderBar<T>, new()
     {
         private readonly OsuSpriteText label;
@@ -129,7 +129,7 @@ namespace osu.Game.Graphics.UserInterface
     /// An <see cref="IExpandable"/> implementation for the UI slider bar control.
     /// </summary>
     public partial class ExpandableSlider<T> : ExpandableSlider<T, RoundedSliderBar<T>>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
index 191a7ca246..9cb6356cab 100644
--- a/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/OsuSliderBar.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Allocation;
 using osu.Framework.Audio;
@@ -15,7 +16,7 @@ using osu.Game.Utils;
 namespace osu.Game.Graphics.UserInterface
 {
     public abstract partial class OsuSliderBar<T> : SliderBar<T>, IHasTooltip
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         public bool PlaySamplesOnAdjust { get; set; } = true;
 
@@ -85,11 +86,11 @@ namespace osu.Game.Graphics.UserInterface
         private LocalisableString getTooltipText(T value)
         {
             if (CurrentNumber.IsInteger)
-                return value.ToInt32(NumberFormatInfo.InvariantInfo).ToString("N0");
+                return int.CreateTruncating(value).ToString("N0");
 
-            double floatValue = value.ToDouble(NumberFormatInfo.InvariantInfo);
+            double floatValue = double.CreateTruncating(value);
 
-            decimal decimalPrecision = normalise(CurrentNumber.Precision.ToDecimal(NumberFormatInfo.InvariantInfo), max_decimal_digits);
+            decimal decimalPrecision = normalise(decimal.CreateTruncating(CurrentNumber.Precision), max_decimal_digits);
 
             // Find the number of significant digits (we could have less than 5 after normalize())
             int significantDigits = FormatUtils.FindPrecision(decimalPrecision);
diff --git a/osu.Game/Graphics/UserInterface/OsuTabControl.cs b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
index f24977927f..5ce384c53c 100644
--- a/osu.Game/Graphics/UserInterface/OsuTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/OsuTabControl.cs
@@ -8,6 +8,8 @@ using System.Linq;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Bindables;
 using osu.Framework.Extensions;
 using osu.Framework.Extensions.Color4Extensions;
@@ -143,13 +145,6 @@ namespace osu.Game.Graphics.UserInterface
                     FadeUnhovered();
             }
 
-            [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
-            {
-                if (accentColour == default)
-                    AccentColour = colours.Blue;
-            }
-
             public OsuTabItem(T value)
                 : base(value)
             {
@@ -196,10 +191,21 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
             }
 
+            private Sample selectSample;
+
+            [BackgroundDependencyLoader]
+            private void load(OsuColour colours, AudioManager audio)
+            {
+                if (accentColour == default)
+                    AccentColour = colours.Blue;
+
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override void OnActivated()
             {
                 Text.Font = Text.Font.With(weight: FontWeight.Bold);
@@ -211,6 +217,8 @@ namespace osu.Game.Graphics.UserInterface
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
                 FadeUnhovered();
             }
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/PageTabControl.cs b/osu.Game/Graphics/UserInterface/PageTabControl.cs
index 2fe8acfbd5..44c659f945 100644
--- a/osu.Game/Graphics/UserInterface/PageTabControl.cs
+++ b/osu.Game/Graphics/UserInterface/PageTabControl.cs
@@ -7,6 +7,8 @@ using System;
 using osuTK;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
@@ -53,6 +55,8 @@ namespace osu.Game.Graphics.UserInterface
                 }
             }
 
+            private Sample selectSample = null!;
+
             public PageTabItem(T value)
                 : base(value)
             {
@@ -78,12 +82,18 @@ namespace osu.Game.Graphics.UserInterface
                         Origin = Anchor.BottomLeft,
                         Anchor = Anchor.BottomLeft,
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
 
                 Active.BindValueChanged(active => Text.Font = Text.Font.With(Typeface.Torus, weight: active.NewValue ? FontWeight.Bold : FontWeight.Medium), true);
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected virtual LocalisableString CreateText() => (Value as Enum)?.GetLocalisableDescription() ?? Value.ToString();
 
             protected override bool OnHover(HoverEvent e)
@@ -112,6 +122,8 @@ namespace osu.Game.Graphics.UserInterface
             protected override void OnActivated() => slideActive();
 
             protected override void OnDeactivated() => slideInactive();
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
index 0981881ead..56047173bb 100644
--- a/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/RoundedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osuTK;
+using System.Numerics;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -11,11 +11,12 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class RoundedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         protected readonly Nub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
index 60a6670492..0df1c1d204 100644
--- a/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
+++ b/osu.Game/Graphics/UserInterface/ShearedSliderBar.cs
@@ -2,7 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
-using osuTK;
+using System.Numerics;
 using osuTK.Graphics;
 using osu.Framework.Allocation;
 using osu.Framework.Extensions.Color4Extensions;
@@ -12,11 +12,12 @@ using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Overlays;
 using static osu.Game.Graphics.UserInterface.ShearedNub;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterface
 {
     public partial class ShearedSliderBar<T> : OsuSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         protected readonly ShearedNub Nub;
         protected readonly Box LeftBox;
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
index 4585d3a4c9..4912a21fab 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledSliderBar.cs
@@ -1,14 +1,14 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Game.Overlays.Settings;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class LabelledSliderBar<TNumber> : LabelledComponent<SettingsSlider<TNumber>, TNumber>
-        where TNumber : struct, IEquatable<TNumber>, IComparable<TNumber>, IConvertible
+        where TNumber : struct, INumber<TNumber>, IMinMaxValue<TNumber>
     {
         public LabelledSliderBar()
             : base(true)
diff --git a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
index e5ba7f61bf..abd828e98f 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -10,12 +10,12 @@ using osu.Framework.Graphics.UserInterface;
 using osu.Framework.Localisation;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Graphics.UserInterfaceV2
 {
     public partial class SliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -138,7 +138,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         {
             if (updatingFromTextBox) return;
 
-            decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
+            decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
             textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
         }
     }
diff --git a/osu.Game/OsuGameBase.cs b/osu.Game/OsuGameBase.cs
index a8866876f4..5e4ec5a61d 100644
--- a/osu.Game/OsuGameBase.cs
+++ b/osu.Game/OsuGameBase.cs
@@ -75,6 +75,12 @@ namespace osu.Game
     {
         public static readonly string[] VIDEO_EXTENSIONS = { ".mp4", ".mov", ".avi", ".flv", ".mpg", ".wmv", ".m4v" };
 
+#if DEBUG
+        public const string GAME_NAME = "osu! (development)";
+#else
+        public const string GAME_NAME = "osu!";
+#endif
+
         public const string OSU_PROTOCOL = "osu://";
 
         public const string CLIENT_STREAM_NAME = @"lazer";
@@ -241,11 +247,7 @@ namespace osu.Game
 
         public OsuGameBase()
         {
-            Name = @"osu!";
-
-#if DEBUG
-            Name += " (development)";
-#endif
+            Name = GAME_NAME;
 
             allowableExceptions = UnhandledExceptionsBeforeCrash;
         }
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
index 9cd0031e3d..63a533c92e 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapListingCardSizeTabControl.cs
@@ -5,6 +5,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -47,13 +49,15 @@ namespace osu.Game.Overlays.BeatmapListing
             [Resolved]
             private OverlayColourProvider colourProvider { get; set; }
 
+            private Sample selectSample = null!;
+
             public TabItem(BeatmapCardSize value)
                 : base(value)
             {
             }
 
             [BackgroundDependencyLoader]
-            private void load()
+            private void load(AudioManager audio)
             {
                 AutoSizeAxes = Axes.Both;
                 Masking = true;
@@ -79,8 +83,10 @@ namespace osu.Game.Overlays.BeatmapListing
                             Icon = getIconForCardSize(Value)
                         }
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
+
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             private static IconUsage getIconForCardSize(BeatmapCardSize cardSize)
@@ -111,6 +117,8 @@ namespace osu.Game.Overlays.BeatmapListing
                     updateState();
             }
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             protected override void OnDeactivated()
             {
                 if (IsLoaded)
diff --git a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
index e59beb43ff..4bd25f6561 100644
--- a/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
+++ b/osu.Game/Overlays/BeatmapListing/BeatmapSearchMultipleSelectionFilterRow.cs
@@ -128,7 +128,11 @@ namespace osu.Game.Overlays.BeatmapListing
             protected override bool OnClick(ClickEvent e)
             {
                 base.OnClick(e);
+
+                // this tab item implementation is not managed by a TabControl,
+                // therefore we have to manually update Active state and play select sound when this tab item is clicked.
                 Active.Toggle();
+                SelectSample.Play();
                 return true;
             }
         }
diff --git a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
index 831cf812ff..ee188d34ce 100644
--- a/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
+++ b/osu.Game/Overlays/BeatmapListing/FilterTabItem.cs
@@ -5,6 +5,8 @@
 
 using System;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -24,13 +26,15 @@ namespace osu.Game.Overlays.BeatmapListing
 
         private OsuSpriteText text;
 
+        protected Sample SelectSample { get; private set; } = null!;
+
         public FilterTabItem(T value)
             : base(value)
         {
         }
 
         [BackgroundDependencyLoader]
-        private void load()
+        private void load(AudioManager audio)
         {
             AutoSizeAxes = Axes.Both;
             AddRangeInternal(new Drawable[]
@@ -40,10 +44,12 @@ namespace osu.Game.Overlays.BeatmapListing
                     Font = OsuFont.GetFont(size: 13, weight: FontWeight.Regular),
                     Text = LabelFor(Value)
                 },
-                new HoverClickSounds(HoverSampleSet.TabSelect)
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
+
+            SelectSample = audio.Samples.Get(@"UI/tabselect-select");
         }
 
         protected override void LoadComplete()
@@ -71,6 +77,8 @@ namespace osu.Game.Overlays.BeatmapListing
 
         protected override void OnDeactivated() => UpdateState();
 
+        protected override void OnActivatedByUser() => SelectSample.Play();
+
         /// <summary>
         /// Returns the label text to be used for the supplied <paramref name="value"/>.
         /// </summary>
diff --git a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
index 426fbcdb8d..29744f27fc 100644
--- a/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
+++ b/osu.Game/Overlays/BeatmapSet/BeatmapRulesetSelector.cs
@@ -21,7 +21,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 // propagate value to tab items first to enable only available rulesets.
                 beatmapSet.Value = value;
 
-                SelectTab(TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value));
+                Current.Value = TabContainer.TabItems.FirstOrDefault(t => t.Enabled.Value)?.Value;
             }
         }
 
diff --git a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
index d7d6bd4a2a..c2bea0ed91 100644
--- a/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
+++ b/osu.Game/Overlays/OverlayPanelDisplayStyleControl.cs
@@ -11,6 +11,8 @@ using osuTK;
 using osu.Framework.Input.Events;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osuTK.Graphics;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
@@ -65,6 +67,8 @@ namespace osu.Game.Overlays
 
             private readonly SpriteIcon icon;
 
+            private Sample selectSample = null!;
+
             public PanelDisplayTabItem(OverlayPanelDisplayStyle value)
                 : base(value)
             {
@@ -78,14 +82,22 @@ namespace osu.Game.Overlays
                         RelativeSizeAxes = Axes.Both,
                         FillMode = FillMode.Fit
                     },
-                    new HoverClickSounds()
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 });
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override void OnActivated() => updateState();
 
             protected override void OnDeactivated() => updateState();
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             protected override bool OnHover(HoverEvent e)
             {
                 updateState();
diff --git a/osu.Game/Overlays/OverlayRulesetTabItem.cs b/osu.Game/Overlays/OverlayRulesetTabItem.cs
index 6d318820b3..b245486adf 100644
--- a/osu.Game/Overlays/OverlayRulesetTabItem.cs
+++ b/osu.Game/Overlays/OverlayRulesetTabItem.cs
@@ -10,6 +10,8 @@ using osu.Game.Rulesets;
 using osuTK.Graphics;
 using osuTK;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.Containers;
@@ -39,6 +41,8 @@ namespace osu.Game.Overlays
 
         public LocalisableString TooltipText => Value.Name;
 
+        private Sample selectSample = null!;
+
         public OverlayRulesetTabItem(RulesetInfo value)
             : base(value)
         {
@@ -59,12 +63,18 @@ namespace osu.Game.Overlays
                         Icon = value.CreateInstance().CreateIcon(),
                     },
                 },
-                new HoverClickSounds()
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
             Enabled.Value = true;
         }
 
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            selectSample = audio.Samples.Get(@"UI/tabselect-select");
+        }
+
         protected override void LoadComplete()
         {
             base.LoadComplete();
@@ -90,6 +100,8 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
+        protected override void OnActivatedByUser() => selectSample.Play();
+
         private void updateState()
         {
             AccentColour = Enabled.Value ? getActiveColour() : colourProvider.Foreground1;
diff --git a/osu.Game/Overlays/OverlayStreamItem.cs b/osu.Game/Overlays/OverlayStreamItem.cs
index 45181c13e4..f0ae0b41fc 100644
--- a/osu.Game/Overlays/OverlayStreamItem.cs
+++ b/osu.Game/Overlays/OverlayStreamItem.cs
@@ -11,6 +11,8 @@ using osu.Framework.Graphics.Containers;
 using osu.Game.Graphics.UserInterface;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Game.Graphics.Sprites;
 using osu.Game.Graphics;
 using osuTK.Graphics;
@@ -49,8 +51,10 @@ namespace osu.Game.Overlays
             Margin = new MarginPadding(PADDING);
         }
 
+        private Sample selectSample;
+
         [BackgroundDependencyLoader]
-        private void load(OverlayColourProvider colourProvider, OsuColour colours)
+        private void load(OverlayColourProvider colourProvider, OsuColour colours, AudioManager audio)
         {
             AddRange(new Drawable[]
             {
@@ -87,9 +91,11 @@ namespace osu.Game.Overlays
                     CollapsedSize = 2,
                     Expanded = true
                 },
-                new HoverClickSounds()
+                new HoverSounds(HoverSampleSet.TabSelect)
             });
 
+            selectSample = audio.Samples.Get(@"UI/tabselect-select");
+
             SelectedItem.BindValueChanged(_ => updateState(), true);
         }
 
@@ -105,6 +111,8 @@ namespace osu.Game.Overlays
 
         protected override void OnDeactivated() => updateState();
 
+        protected override void OnActivatedByUser() => selectSample.Play();
+
         protected override bool OnHover(HoverEvent e)
         {
             updateState();
diff --git a/osu.Game/Overlays/OverlayTabControl.cs b/osu.Game/Overlays/OverlayTabControl.cs
index 884e31868f..a27caa13f1 100644
--- a/osu.Game/Overlays/OverlayTabControl.cs
+++ b/osu.Game/Overlays/OverlayTabControl.cs
@@ -4,6 +4,8 @@
 #nullable disable
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Graphics.UserInterface;
@@ -80,6 +82,8 @@ namespace osu.Game.Overlays
                 }
             }
 
+            private Sample selectSample = null!;
+
             public OverlayTabItem(T value)
                 : base(value)
             {
@@ -101,10 +105,16 @@ namespace osu.Game.Overlays
                         ExpandedSize = 5f,
                         CollapsedSize = 0
                     },
-                    new HoverClickSounds(HoverSampleSet.TabSelect)
+                    new HoverSounds(HoverSampleSet.TabSelect)
                 };
             }
 
+            [BackgroundDependencyLoader]
+            private void load(AudioManager audio)
+            {
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
+            }
+
             protected override bool OnHover(HoverEvent e)
             {
                 base.OnHover(e);
@@ -136,6 +146,8 @@ namespace osu.Game.Overlays
                 Text.Font = Text.Font.With(weight: FontWeight.Medium);
             }
 
+            protected override void OnActivatedByUser() => selectSample.Play();
+
             private void updateState()
             {
                 if (Active.Value)
diff --git a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
index c73831d8d1..14ef58ff88 100644
--- a/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
+++ b/osu.Game/Overlays/Settings/Sections/SizeSlider.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterface;
@@ -12,7 +13,7 @@ namespace osu.Game.Overlays.Settings.Sections
     /// A slider intended to show a "size" multiplier number, where 1x is 1.0.
     /// </summary>
     public partial class SizeSlider<T> : RoundedSliderBar<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible, IFormattable
+        where T : struct, INumber<T>, IMinMaxValue<T>, IFormattable
     {
         public override LocalisableString TooltipText => Current.Value.ToString(@"0.##x", NumberFormatInfo.CurrentInfo);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
index fa59d18de1..d7a09d3392 100644
--- a/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsPercentageSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Game.Configuration;
 using osu.Game.Graphics.UserInterface;
@@ -13,7 +13,7 @@ namespace osu.Game.Overlays.Settings
     /// Mostly provided for convenience of use with <see cref="SettingSourceAttribute"/>.
     /// </summary>
     public partial class SettingsPercentageSlider<TValue> : SettingsSlider<TValue>
-        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
+        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
     {
         protected override Drawable CreateControl() => ((RoundedSliderBar<TValue>)base.CreateControl()).With(sliderBar => sliderBar.DisplayAsPercentage = true);
     }
diff --git a/osu.Game/Overlays/Settings/SettingsSlider.cs b/osu.Game/Overlays/Settings/SettingsSlider.cs
index 6c81fece13..2460d78099 100644
--- a/osu.Game/Overlays/Settings/SettingsSlider.cs
+++ b/osu.Game/Overlays/Settings/SettingsSlider.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterface;
@@ -9,12 +9,12 @@ using osu.Game.Graphics.UserInterface;
 namespace osu.Game.Overlays.Settings
 {
     public partial class SettingsSlider<T> : SettingsSlider<T, RoundedSliderBar<T>>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
     }
 
     public partial class SettingsSlider<TValue, TSlider> : SettingsItem<TValue>
-        where TValue : struct, IEquatable<TValue>, IComparable<TValue>, IConvertible
+        where TValue : struct, INumber<TValue>, IMinMaxValue<TValue>
         where TSlider : RoundedSliderBar<TValue>, new()
     {
         protected override Drawable CreateControl() => new TSlider
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
index 723c24597a..d49c340ed4 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetSelector.cs
@@ -3,11 +3,8 @@
 
 #nullable disable
 
-using System.Collections.Generic;
 using System.Linq;
 using osu.Framework.Allocation;
-using osu.Framework.Audio;
-using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -24,8 +21,6 @@ namespace osu.Game.Overlays.Toolbar
     {
         protected Drawable ModeButtonLine { get; private set; }
 
-        private readonly Dictionary<string, Sample> selectionSamples = new Dictionary<string, Sample>();
-
         public ToolbarRulesetSelector()
         {
             RelativeSizeAxes = Axes.Y;
@@ -33,7 +28,7 @@ namespace osu.Game.Overlays.Toolbar
         }
 
         [BackgroundDependencyLoader]
-        private void load(AudioManager audio)
+        private void load()
         {
             AddRangeInternal(new[]
             {
@@ -59,9 +54,6 @@ namespace osu.Game.Overlays.Toolbar
                     }
                 },
             });
-
-            foreach (var ruleset in Rulesets.AvailableRulesets)
-                selectionSamples[ruleset.ShortName] = audio.Samples.Get($"UI/ruleset-select-{ruleset.ShortName}");
         }
 
         protected override void LoadComplete()
@@ -88,10 +80,6 @@ namespace osu.Game.Overlays.Toolbar
             if (SelectedTab != null)
             {
                 ModeButtonLine.MoveToX(SelectedTab.DrawPosition.X, !hasInitialPosition ? 0 : 500, Easing.OutElasticQuarter);
-
-                if (hasInitialPosition)
-                    selectionSamples[SelectedTab.Value.ShortName]?.Play();
-
                 hasInitialPosition = true;
             }
         }
@@ -121,7 +109,7 @@ namespace osu.Game.Overlays.Toolbar
 
                 RulesetInfo found = Rulesets.AvailableRulesets.ElementAtOrDefault(requested);
                 if (found != null)
-                    Current.Value = found;
+                    SelectItem(found);
                 return true;
             }
 
diff --git a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
index 3287ac6eaa..0315bede64 100644
--- a/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
+++ b/osu.Game/Overlays/Toolbar/ToolbarRulesetTabButton.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Extensions.Color4Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.UserInterface;
@@ -17,6 +19,8 @@ namespace osu.Game.Overlays.Toolbar
     {
         private readonly RulesetButton ruleset;
 
+        private Sample? selectSample;
+
         public ToolbarRulesetTabButton(RulesetInfo value)
             : base(value)
         {
@@ -34,10 +38,18 @@ namespace osu.Game.Overlays.Toolbar
             ruleset.SetIcon(rInstance.CreateIcon());
         }
 
+        [BackgroundDependencyLoader]
+        private void load(AudioManager audio)
+        {
+            selectSample = audio.Samples.Get($@"UI/ruleset-select-{Value.ShortName}");
+        }
+
         protected override void OnActivated() => ruleset.Active = true;
 
         protected override void OnDeactivated() => ruleset.Active = false;
 
+        protected override void OnActivatedByUser() => selectSample?.Play();
+
         private partial class RulesetButton : ToolbarButton
         {
             protected override HoverSounds CreateHoverSounds(HoverSampleSet sampleSet) => new HoverSounds();
diff --git a/osu.Game/Rulesets/Mods/DifficultyBindable.cs b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
index a207048882..5f6fd21860 100644
--- a/osu.Game/Rulesets/Mods/DifficultyBindable.cs
+++ b/osu.Game/Rulesets/Mods/DifficultyBindable.cs
@@ -48,7 +48,7 @@ namespace osu.Game.Rulesets.Mods
             }
         }
 
-        private float maxValue;
+        private float maxValue = 10; // matches default max value of `CurrentNumber`
 
         public float MaxValue
         {
diff --git a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
index de05219212..3ce6cc3cef 100644
--- a/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
+++ b/osu.Game/Rulesets/Objects/Drawables/DrawableHitObject.cs
@@ -15,7 +15,6 @@ using osu.Framework.Extensions.ListExtensions;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Extensions.TypeExtensions;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Lists;
 using osu.Framework.Threading;
 using osu.Framework.Utils;
@@ -632,7 +631,7 @@ namespace osu.Game.Rulesets.Objects.Drawables
 
         #endregion
 
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         protected override void UpdateAfterChildren()
         {
diff --git a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
index 7cee5ebecf..25c5b3643a 100644
--- a/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
+++ b/osu.Game/Rulesets/Scoring/LegacyDrainingHealthProcessor.cs
@@ -129,6 +129,13 @@ namespace osu.Game.Rulesets.Scoring
                     OnIterationFail?.Invoke($"FAILED drop {testDrop}: recovery too low ({recovery} < {hpRecoveryAvailable})");
                 }
 
+                if (!fail && double.IsInfinity(HpMultiplierNormal))
+                {
+                    OnIterationSuccess?.Invoke("Drain computation algorithm diverged to infinity. PASSING with zero drop, resetting HP multiplier to 1.");
+                    HpMultiplierNormal = 1;
+                    return 0;
+                }
+
                 if (!fail)
                 {
                     OnIterationSuccess?.Invoke($"PASSED drop {testDrop}");
diff --git a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
index b49924762e..c4feb249f4 100644
--- a/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
+++ b/osu.Game/Rulesets/UI/FrameStabilityContainer.cs
@@ -119,7 +119,7 @@ namespace osu.Game.Rulesets.UI
                     break;
 
                 base.UpdateSubTree();
-                UpdateSubTreeMasking(this, ScreenSpaceDrawQuad.AABBFloat);
+                UpdateSubTreeMasking();
             } while (state == PlaybackState.RequiresCatchUp && stopwatch.ElapsedMilliseconds < max_catchup_milliseconds);
 
             return true;
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
index c3adb43032..e16c8519e5 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/TimelineTickDisplay.cs
@@ -7,7 +7,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Caching;
 using osu.Framework.Graphics;
-using osu.Framework.Graphics.Primitives;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Graphics;
@@ -20,7 +19,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
     public partial class TimelineTickDisplay : TimelinePart<PointVisualisation>
     {
         // With current implementation every tick in the sub-tree should be visible, no need to check whether they are masked away.
-        public override bool UpdateSubTreeMasking(Drawable source, RectangleF maskingBounds) => false;
+        public override bool UpdateSubTreeMasking() => false;
 
         [Resolved]
         private EditorBeatmap beatmap { get; set; } = null!;
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 1c14c9e154..980c613311 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -372,7 +372,7 @@ namespace osu.Game.Screens.Edit
                                     }
                                 }
                             },
-                            new EditorScreenSwitcherControl
+                            screenSwitcher = new EditorScreenSwitcherControl
                             {
                                 Anchor = Anchor.BottomRight,
                                 Origin = Anchor.BottomRight,
@@ -662,23 +662,23 @@ namespace osu.Game.Screens.Edit
                     return true;
 
                 case GlobalAction.EditorComposeMode:
-                    Mode.Value = EditorScreenMode.Compose;
+                    screenSwitcher.SelectItem(EditorScreenMode.Compose);
                     return true;
 
                 case GlobalAction.EditorDesignMode:
-                    Mode.Value = EditorScreenMode.Design;
+                    screenSwitcher.SelectItem(EditorScreenMode.Design);
                     return true;
 
                 case GlobalAction.EditorTimingMode:
-                    Mode.Value = EditorScreenMode.Timing;
+                    screenSwitcher.SelectItem(EditorScreenMode.Timing);
                     return true;
 
                 case GlobalAction.EditorSetupMode:
-                    Mode.Value = EditorScreenMode.SongSetup;
+                    screenSwitcher.SelectItem(EditorScreenMode.SongSetup);
                     return true;
 
                 case GlobalAction.EditorVerifyMode:
-                    Mode.Value = EditorScreenMode.Verify;
+                    screenSwitcher.SelectItem(EditorScreenMode.Verify);
                     return true;
 
                 case GlobalAction.EditorTestGameplay:
@@ -959,6 +959,8 @@ namespace osu.Game.Screens.Edit
         [CanBeNull]
         private ScheduledDelegate playbackDisabledDebounce;
 
+        private EditorScreenSwitcherControl screenSwitcher;
+
         private void updateSampleDisabledState()
         {
             bool shouldDisableSamples = clock.SeekingOrStopped.Value
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 151d469415..26f374ba85 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using System.Globalization;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
@@ -12,7 +12,7 @@ using osu.Framework.Localisation;
 using osu.Game.Graphics.UserInterfaceV2;
 using osu.Game.Overlays.Settings;
 using osu.Game.Utils;
-using osuTK;
+using Vector2 = osuTK.Vector2;
 
 namespace osu.Game.Screens.Edit.Timing
 {
@@ -22,7 +22,7 @@ namespace osu.Game.Screens.Edit.Timing
     /// by providing an "indeterminate state".
     /// </summary>
     public partial class IndeterminateSliderWithTextBoxInput<T> : CompositeDrawable, IHasCurrentValue<T?>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         /// <summary>
         /// A custom step value for each key press which actuates a change on this control.
@@ -136,7 +136,7 @@ namespace osu.Game.Screens.Edit.Timing
                 slider.Current.Value = nonNullValue;
 
                 // use the value from the slider to ensure that any precision/min/max set on it via the initial indeterminate value have been applied correctly.
-                decimal decimalValue = slider.Current.Value.ToDecimal(NumberFormatInfo.InvariantInfo);
+                decimal decimalValue = decimal.CreateTruncating(slider.Current.Value);
                 textBox.Text = decimalValue.ToString($@"N{FormatUtils.FindPrecision(decimalValue)}");
                 textBox.PlaceholderText = string.Empty;
             }
diff --git a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
index 995fce085e..477336e8ea 100644
--- a/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
+++ b/osu.Game/Screens/OnlinePlay/Match/Components/MatchTypePicker.cs
@@ -4,6 +4,8 @@
 #nullable disable
 
 using osu.Framework.Allocation;
+using osu.Framework.Audio;
+using osu.Framework.Audio.Sample;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
@@ -78,14 +80,17 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
                             },
                         },
                     },
-                    new HoverClickSounds(),
+                    new HoverSounds(HoverSampleSet.TabSelect),
                 };
             }
 
+            private Sample selectSample;
+
             [BackgroundDependencyLoader]
-            private void load(OsuColour colours)
+            private void load(OsuColour colours, AudioManager audio)
             {
                 selection.Colour = colours.Yellow;
+                selectSample = audio.Samples.Get(@"UI/tabselect-select");
             }
 
             protected override bool OnHover(HoverEvent e)
@@ -109,6 +114,8 @@ namespace osu.Game.Screens.OnlinePlay.Match.Components
             {
                 selection.FadeOut(transition_duration, Easing.OutQuint);
             }
+
+            protected override void OnActivatedByUser() => selectSample.Play();
         }
     }
 }
diff --git a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
index 88b778fafb..1fc1155c0b 100644
--- a/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
+++ b/osu.Game/Screens/Play/PlayerSettings/PlayerSliderBar.cs
@@ -1,7 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System;
+using System.Numerics;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Game.Graphics;
@@ -11,7 +11,7 @@ using osu.Game.Overlays.Settings;
 namespace osu.Game.Screens.Play.PlayerSettings
 {
     public partial class PlayerSliderBar<T> : SettingsSlider<T>
-        where T : struct, IEquatable<T>, IComparable<T>, IConvertible
+        where T : struct, INumber<T>, IMinMaxValue<T>
     {
         public RoundedSliderBar<T> Bar => (RoundedSliderBar<T>)Control;
 
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 30ea2369d0..f91995feff 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,8 +35,8 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.329.0" />
-    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.517.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
     <PackageReference Include="SharpCompress" Version="0.36.0" />
diff --git a/osu.iOS.props b/osu.iOS.props
index b2e3fc0779..103ef50e0c 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.329.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.509.0" />
   </ItemGroup>
 </Project>

From b25987ffe726cd5815aa8f84919180db47a88ddc Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Wed, 22 May 2024 11:37:55 +0200
Subject: [PATCH 876/930] Changed allowed mania keys, and reverted 0af32c5

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs           | 6 +++---
 osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 2acabe2518..e5567b2215 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -111,12 +111,12 @@ namespace osu.Game.Beatmaps.Formats
         {
             difficulty.DrainRate = Math.Clamp(difficulty.DrainRate, 0, 10);
             //If the mode is not Mania, clamp circle size to [0,10]
-            if (!beatmap.BeatmapInfo.Ruleset.OnlineID.Equals(3))
+            if (beatmap.BeatmapInfo.Ruleset.OnlineID != 3)
                 difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 0, 10);
-            //If it is Mania, it must be within [1,20] - dual stages with 10 keys each.
+            //If it is Mania, it must be within [1,18] - copying what stable does https://github.com/ppy/osu/pull/28200#discussion_r1609522988
             //The lower bound should be 4, but there are ranked maps that are lower than this.
             else
-                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 1, 20);
+                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 1, 18);
             difficulty.OverallDifficulty = Math.Clamp(difficulty.OverallDifficulty, 0, 10);
             difficulty.ApproachRate = Math.Clamp(difficulty.ApproachRate, 0, 10);
 
diff --git a/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs b/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
index 1d3416f494..2a5a11161b 100644
--- a/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
+++ b/osu.Game/Rulesets/Objects/Legacy/LegacyRulesetExtensions.cs
@@ -55,7 +55,7 @@ namespace osu.Game.Rulesets.Objects.Legacy
             // It works out to under 1 game pixel and is generally not meaningful to gameplay, but is to replay playback accuracy.
             const float broken_gamefield_rounding_allowance = 1.00041f;
 
-            return (float)Math.Max(0.02, (1.0f - 0.7f * IBeatmapDifficultyInfo.DifficultyRange(circleSize)) / 2 * (applyFudge ? broken_gamefield_rounding_allowance : 1));
+            return (float)(1.0f - 0.7f * IBeatmapDifficultyInfo.DifficultyRange(circleSize)) / 2 * (applyFudge ? broken_gamefield_rounding_allowance : 1);
         }
 
         public static int CalculateDifficultyPeppyStars(BeatmapDifficulty difficulty, int objectCount, int drainLength)

From 97fe59cb24cc2f26ff2d099ef6da09c95d9fd6ba Mon Sep 17 00:00:00 2001
From: tsunyoku <tsunyoku@gmail.com>
Date: Wed, 22 May 2024 10:38:47 +0100
Subject: [PATCH 877/930] set `Ranked` to `true` for `OsuModTraceable`

---
 osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
index 9671f53bea..75ad00e169 100644
--- a/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
+++ b/osu.Game.Rulesets.Osu/Mods/OsuModTraceable.cs
@@ -19,6 +19,7 @@ namespace osu.Game.Rulesets.Osu.Mods
         public override ModType Type => ModType.Fun;
         public override LocalisableString Description => "Put your faith in the approach circles...";
         public override double ScoreMultiplier => 1;
+        public override bool Ranked => true;
 
         public override Type[] IncompatibleMods => new[] { typeof(IHidesApproachCircles), typeof(OsuModDepth) };
 

From f3cae73e2ed892469e1879f834f4c8472e06cf13 Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Wed, 22 May 2024 13:26:00 +0200
Subject: [PATCH 878/930] Added tests for difficulty clamping

---
 .../Formats/LegacyBeatmapDecoderTest.cs       | 30 +++++++++++++++++++
 .../out-of-range-difficulties-mania.osu       |  5 ++++
 .../Resources/out-of-range-difficulties.osu   | 10 +++++++
 3 files changed, 45 insertions(+)
 create mode 100644 osu.Game.Tests/Resources/out-of-range-difficulties-mania.osu
 create mode 100644 osu.Game.Tests/Resources/out-of-range-difficulties.osu

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index 02432a1935..e6daba2016 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -1188,5 +1188,35 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(beatmap.HitObjects[0].GetEndTime(), Is.EqualTo(3153));
             }
         }
+
+        [Test]
+        public void TestBeatmapDifficultyIsClamped()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("out-of-range-difficulties.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream).Difficulty;
+                Assert.That(decoded.DrainRate, Is.EqualTo(10));
+                Assert.That(decoded.CircleSize, Is.EqualTo(10));
+                Assert.That(decoded.OverallDifficulty, Is.EqualTo(10));
+                Assert.That(decoded.ApproachRate, Is.EqualTo(10));
+                Assert.That(decoded.SliderMultiplier, Is.EqualTo(3.6));
+                Assert.That(decoded.SliderTickRate, Is.EqualTo(8));
+            }
+        }
+        [Test]
+        public void TestManiaBeatmapDifficultyCircleSizeClamp()
+        {
+            var decoder = new LegacyBeatmapDecoder { ApplyOffsets = false };
+
+            using (var resStream = TestResources.OpenResource("out-of-range-difficulties-mania.osu"))
+            using (var stream = new LineBufferedReader(resStream))
+            {
+                var decoded = decoder.Decode(stream).Difficulty;
+                Assert.That(decoded.CircleSize, Is.EqualTo(14));
+            }
+        }
     }
 }
diff --git a/osu.Game.Tests/Resources/out-of-range-difficulties-mania.osu b/osu.Game.Tests/Resources/out-of-range-difficulties-mania.osu
new file mode 100644
index 0000000000..7dc2e51ad9
--- /dev/null
+++ b/osu.Game.Tests/Resources/out-of-range-difficulties-mania.osu
@@ -0,0 +1,5 @@
+[General]
+Mode: 3
+
+[Difficulty]
+CircleSize:14
\ No newline at end of file
diff --git a/osu.Game.Tests/Resources/out-of-range-difficulties.osu b/osu.Game.Tests/Resources/out-of-range-difficulties.osu
new file mode 100644
index 0000000000..5029395614
--- /dev/null
+++ b/osu.Game.Tests/Resources/out-of-range-difficulties.osu
@@ -0,0 +1,10 @@
+[General]
+Mode: 0
+
+[Difficulty]
+HPDrainRate:25
+CircleSize:25
+OverallDifficulty:25
+ApproachRate:30
+SliderMultiplier:30
+SliderTickRate:30
\ No newline at end of file

From 57da4229ff621a12a43ae704bbd21884a9039d74 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Wed, 22 May 2024 13:58:59 +0200
Subject: [PATCH 879/930] Add speed value to Toast

---
 osu.Game/Localisation/ToastStrings.cs     | 4 ++--
 osu.Game/Overlays/OSD/SpeedChangeToast.cs | 5 +++--
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/ToastStrings.cs b/osu.Game/Localisation/ToastStrings.cs
index 33027966dd..25899153f8 100644
--- a/osu.Game/Localisation/ToastStrings.cs
+++ b/osu.Game/Localisation/ToastStrings.cs
@@ -50,9 +50,9 @@ namespace osu.Game.Localisation
         public static LocalisableString UrlCopied => new TranslatableString(getKey(@"url_copied"), @"URL copied");
 
         /// <summary>
-        /// "Speed Changed"
+        /// "Speed changed to"
         /// </summary>
-        public static LocalisableString SpeedChanged => new TranslatableString(getKey(@"speed_changed"), @"Speed Changed");
+        public static LocalisableString SpeedChangedTo => new TranslatableString(getKey(@"speed_changed"), @"Speed changed to");
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
diff --git a/osu.Game/Overlays/OSD/SpeedChangeToast.cs b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
index 231ef86526..df4f825541 100644
--- a/osu.Game/Overlays/OSD/SpeedChangeToast.cs
+++ b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
@@ -1,6 +1,7 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
+using System.Threading;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
@@ -9,8 +10,8 @@ namespace osu.Game.Overlays.OSD
 {
     public partial class SpeedChangeToast : Toast
     {
-        public SpeedChangeToast(OsuConfigManager config, double delta)
-            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChanged, config.LookupKeyBindings(GlobalAction.IncreaseModSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseModSpeed))
+        public SpeedChangeToast(OsuConfigManager config, double newSpeed)
+            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChangedTo + " " + newSpeed.ToString(Thread.CurrentThread.CurrentCulture), config.LookupKeyBindings(GlobalAction.IncreaseModSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseModSpeed))
         {
         }
     }

From abc67ebbaccfdc3d36ef1853f766829685e1308e Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Wed, 22 May 2024 13:59:26 +0200
Subject: [PATCH 880/930] Fix test not running due to floating point number
 inaccuacy

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 26 +++++++++----------
 1 file changed, 13 insertions(+), 13 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 938b858110..af8b2a7760 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -94,25 +94,25 @@ namespace osu.Game.Tests.Visual.SongSelect
             changeMods();
 
             AddStep("decreasing speed without mods", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.95);
+            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
 
             AddStep("decreasing speed with halftime", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.9", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.9);
+            AddAssert("halftime at 0.9", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.9);
 
             AddStep("increasing speed with halftime", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.95);
+            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
 
             AddStep("increasing speed with halftime to nomod", () => songSelect?.ChangeSpeed(+0.05));
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
             AddStep("increasing speed without mods", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.05);
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
 
             AddStep("increasing speed with doubletime", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("doubletime at 1.1", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.1);
+            AddAssert("doubletime at 1.1", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.1);
 
             AddStep("decreasing speed with doubletime", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && mod.SpeedChange.Value == 1.05);
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
 
             OsuModNightcore nc = new OsuModNightcore
             {
@@ -120,22 +120,22 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
             changeMods(nc);
             AddStep("increasing speed with nightcore", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("nightcore at 1.1", () => songSelect!.Mods.Value.Single() is ModNightcore mod && mod.SpeedChange.Value == 1.1);
+            AddAssert("nightcore at 1.1", () => songSelect!.Mods.Value.Single() is ModNightcore mod && Math.Round(mod.SpeedChange.Value, 2) == 1.1);
 
             AddStep("decreasing speed with nightcore", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModNightcore mod && mod.SpeedChange.Value == 1.05);
+            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModNightcore mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
 
             AddStep("decreasing speed with nightcore to nomod", () => songSelect?.ChangeSpeed(-0.05));
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
             AddStep("decreasing speed nomod, nightcore was selected", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.95);
+            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
 
             AddStep("decreasing speed with daycore", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("daycore at 0.9", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.9);
+            AddAssert("daycore at 0.9", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.9);
 
             AddStep("increasing speed with daycore", () => songSelect?.ChangeSpeed(0.05));
-            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && mod.SpeedChange.Value == 0.95);
+            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
 
             OsuModDoubleTime dt = new OsuModDoubleTime
             {
@@ -144,7 +144,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
             changeMods(dt);
             AddStep("decreasing speed from doubletime 1.02 with adjustpitch enabled", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.97 with adjustpitch enabled", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && mod.SpeedChange.Value == 0.97 && mod.AdjustPitch.Value);
+            AddAssert("halftime at 0.97 with adjustpitch enabled", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.97 && mod.AdjustPitch.Value);
 
             OsuModHalfTime ht = new OsuModHalfTime
             {
@@ -154,7 +154,7 @@ namespace osu.Game.Tests.Visual.SongSelect
             Mod[] modlist = { ht, new OsuModHardRock(), new OsuModHidden() };
             changeMods(modlist);
             AddStep("decreasing speed from halftime 0.97 with adjustpitch enabled, HDHR enabled", () => songSelect?.ChangeSpeed(0.05));
-            AddAssert("doubletime at 1.02 with adjustpitch enabled, HDHR still enabled", () => songSelect!.Mods.Value.Count(mod => (mod is ModDoubleTime modDt && modDt.AdjustPitch.Value && modDt.SpeedChange.Value == 1.02) || mod is ModHardRock || mod is ModHidden) == 3);
+            AddAssert("doubletime at 1.02 with adjustpitch enabled, HDHR still enabled", () => songSelect!.Mods.Value.Count(mod => (mod is ModDoubleTime modDt && modDt.AdjustPitch.Value && Math.Round(modDt.SpeedChange.Value, 2) == 1.02) || mod is ModHardRock || mod is ModHidden) == 3);
 
             changeMods(new ModWindUp());
             AddStep("windup active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));

From 0df634574fc5b680e168d59966a2d537a2baa160 Mon Sep 17 00:00:00 2001
From: Fabian van Oeffelt <fabiano2002@gmx.de>
Date: Wed, 22 May 2024 13:59:33 +0200
Subject: [PATCH 881/930] Improve readability

---
 osu.Game/Screens/Select/SongSelect.cs | 223 ++++++++++++++------------
 1 file changed, 119 insertions(+), 104 deletions(-)

diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 257f6583a4..b3823d7a0f 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -823,123 +823,138 @@ namespace osu.Game.Screens.Select
             return false;
         }
 
+        private Mod getRateMod(ModType modType, Type type)
+        {
+            var modList = game.AvailableMods.Value[modType];
+            var multiMod = (MultiMod)modList.First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(mod2 => mod2.GetType().IsSubclassOf(type)) > 0);
+            var mod = multiMod.Mods.First(mod => mod.GetType().IsSubclassOf(type));
+            return mod;
+        }
+
         public void ChangeSpeed(double delta)
         {
-            ModNightcore modNc = (ModNightcore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModNightcore) > 0)).Mods.First(mod => mod is ModNightcore);
-            ModDoubleTime modDt = (ModDoubleTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyIncrease].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDoubleTime) > 0)).Mods.First(mod => mod is ModDoubleTime);
-            ModDaycore modDc = (ModDaycore)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModDaycore) > 0)).Mods.First(mod => mod is ModDaycore);
-            ModHalfTime modHt = (ModHalfTime)((MultiMod)game.AvailableMods.Value[ModType.DifficultyReduction].First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(modType => modType is ModHalfTime) > 0)).Mods.First(mod => mod is ModHalfTime);
+            ModNightcore modNc = (ModNightcore)getRateMod(ModType.DifficultyIncrease, typeof(ModNightcore));
+            ModDoubleTime modDt = (ModDoubleTime)getRateMod(ModType.DifficultyIncrease, typeof(ModDoubleTime));
+            ModDaycore modDc = (ModDaycore)getRateMod(ModType.DifficultyReduction, typeof(ModDaycore));
+            ModHalfTime modHt = (ModHalfTime)getRateMod(ModType.DifficultyReduction, typeof(ModHalfTime));
             bool rateModActive = selectedMods.Value.Count(mod => mod is ModRateAdjust) > 0;
             bool incompatibleModActive = selectedMods.Value.Count(mod => modDt.IncompatibleMods.Count(incompatibleMod => (mod.GetType().IsSubclassOf(incompatibleMod) || mod.GetType() == incompatibleMod) && incompatibleMod != typeof(ModRateAdjust)) > 0) > 0;
-            double newRate = 1d + delta;
+            double newRate = Math.Round(1d + delta, 2);
             bool isPositive = delta > 0;
 
             if (incompatibleModActive)
                 return;
 
-            onScreenDisplay?.Display(new SpeedChangeToast(config, delta));
-
-            if (rateModActive)
+            if (!rateModActive)
             {
-                ModRateAdjust mod = (ModRateAdjust)selectedMods.Value.First(mod => mod is ModRateAdjust);
+                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
 
-                // Find current active rateAdjust mod and modify speed, enable HalfTime if necessary
-                newRate = mod.SpeedChange.Value + delta;
-
-                if (newRate == 1.0)
-                {
-                    lastPitchState = false;
-                    usedPitchMods = false;
-
-                    if (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) lastPitchState = true;
-
-                    if (mod is ModHalfTime htmod && htmod.AdjustPitch.Value) lastPitchState = true;
-
-                    if (mod is ModNightcore || mod is ModDaycore) usedPitchMods = true;
-
-                    //Disable RateAdjustMods
-                    selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
-                    return;
-                }
-
-                if (((mod is ModDoubleTime || mod is ModNightcore) && newRate < mod.SpeedChange.MinValue)
-                    || ((mod is ModHalfTime || mod is ModDaycore) && newRate > mod.SpeedChange.MaxValue))
-                {
-                    bool adjustPitch = (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) || (mod is ModHalfTime htmod && htmod.AdjustPitch.Value);
-
-                    //Disable RateAdjustMods
-                    selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
-
-                    ModRateAdjust? oppositeMod = null;
-
-                    switch (mod)
-                    {
-                        case ModDoubleTime:
-                            modHt.AdjustPitch.Value = adjustPitch;
-                            oppositeMod = modHt;
-                            break;
-
-                        case ModHalfTime:
-                            modDt.AdjustPitch.Value = adjustPitch;
-                            oppositeMod = modDt;
-                            break;
-
-                        case ModNightcore:
-                            oppositeMod = modDc;
-                            break;
-
-                        case ModDaycore:
-                            oppositeMod = modNc;
-                            break;
-                    }
-
-                    if (oppositeMod == null) return;
-
-                    oppositeMod.SpeedChange.Value = newRate;
-                    selectedMods.Value = selectedMods.Value.Append(oppositeMod).ToList();
-                    return;
-                }
-
-                if (newRate > mod.SpeedChange.MaxValue && (mod is ModDoubleTime || mod is ModNightcore))
-                    newRate = mod.SpeedChange.MaxValue;
-
-                if (newRate < mod.SpeedChange.MinValue && (mod is ModHalfTime || mod is ModDaycore))
-                    newRate = mod.SpeedChange.MinValue;
-
-                mod.SpeedChange.Value = newRate;
-            }
-            else
-            {
                 // If no ModRateAdjust is active, activate one
-                if (isPositive)
-                {
-                    if (!usedPitchMods)
-                    {
-                        modDt.SpeedChange.Value = newRate;
-                        modDt.AdjustPitch.Value = lastPitchState;
-                        selectedMods.Value = selectedMods.Value.Append(modDt).ToList();
-                    }
-                    else
-                    {
-                        modNc.SpeedChange.Value = newRate;
-                        selectedMods.Value = selectedMods.Value.Append(modNc).ToList();
-                    }
-                }
-                else
-                {
-                    if (!usedPitchMods)
-                    {
-                        modHt.SpeedChange.Value = newRate;
-                        modHt.AdjustPitch.Value = lastPitchState;
-                        selectedMods.Value = selectedMods.Value.Append(modHt).ToList();
-                    }
-                    else
-                    {
-                        modDc.SpeedChange.Value = newRate;
-                        selectedMods.Value = selectedMods.Value.Append(modDc).ToList();
-                    }
-                }
+                ModRateAdjust? newMod = null;
+
+                if (isPositive && !usedPitchMods)
+                    newMod = modDt;
+
+                if (isPositive && usedPitchMods)
+                    newMod = modNc;
+
+                if (!isPositive && !usedPitchMods)
+                    newMod = modHt;
+
+                if (!isPositive && usedPitchMods)
+                    newMod = modDc;
+
+                if (!usedPitchMods && newMod is ModDoubleTime newModDt)
+                    newModDt.AdjustPitch.Value = lastPitchState;
+
+                if (!usedPitchMods && newMod is ModHalfTime newModHt)
+                    newModHt.AdjustPitch.Value = lastPitchState;
+
+                newMod!.SpeedChange.Value = newRate;
+                selectedMods.Value = selectedMods.Value.Append(newMod).ToList();
+                return;
             }
+
+            ModRateAdjust mod = (ModRateAdjust)selectedMods.Value.First(mod => mod is ModRateAdjust);
+            newRate = Math.Round(mod.SpeedChange.Value + delta, 2);
+
+            // Disable RateAdjustMods if newRate is 1
+            if (newRate == 1.0)
+            {
+                lastPitchState = false;
+                usedPitchMods = false;
+
+                if (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value)
+                    lastPitchState = true;
+
+                if (mod is ModHalfTime htmod && htmod.AdjustPitch.Value)
+                    lastPitchState = true;
+
+                if (mod is ModNightcore || mod is ModDaycore)
+                    usedPitchMods = true;
+
+                //Disable RateAdjustMods
+                selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
+
+                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
+
+                return;
+            }
+
+            bool overMaxRateLimit = (mod is ModHalfTime || mod is ModDaycore) && newRate > mod.SpeedChange.MaxValue;
+            bool underMinRateLimit = (mod is ModDoubleTime || mod is ModNightcore) && newRate < mod.SpeedChange.MinValue;
+
+            // Swap mod to opposite mod if newRate exceeds max/min speed values
+            if (overMaxRateLimit || underMinRateLimit)
+            {
+                bool adjustPitch = (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) || (mod is ModHalfTime htmod && htmod.AdjustPitch.Value);
+
+                //Disable RateAdjustMods
+                selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
+
+                ModRateAdjust? oppositeMod = null;
+
+                switch (mod)
+                {
+                    case ModDoubleTime:
+                        modHt.AdjustPitch.Value = adjustPitch;
+                        oppositeMod = modHt;
+                        break;
+
+                    case ModHalfTime:
+                        modDt.AdjustPitch.Value = adjustPitch;
+                        oppositeMod = modDt;
+                        break;
+
+                    case ModNightcore:
+                        oppositeMod = modDc;
+                        break;
+
+                    case ModDaycore:
+                        oppositeMod = modNc;
+                        break;
+                }
+
+                if (oppositeMod == null) return;
+
+                oppositeMod.SpeedChange.Value = newRate;
+                selectedMods.Value = selectedMods.Value.Append(oppositeMod).ToList();
+
+                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
+
+                return;
+            }
+
+            // Cap newRate to max/min values and change rate of current active mod
+            if (newRate > mod.SpeedChange.MaxValue && (mod is ModDoubleTime || mod is ModNightcore))
+                newRate = mod.SpeedChange.MaxValue;
+
+            if (newRate < mod.SpeedChange.MinValue && (mod is ModHalfTime || mod is ModDaycore))
+                newRate = mod.SpeedChange.MinValue;
+
+            mod.SpeedChange.Value = newRate;
+
+            onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
         }
 
         protected override void Dispose(bool isDisposing)

From 8d02ac5e219ad064e553c560d076224683ad2651 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 21:20:34 +0800
Subject: [PATCH 882/930] Update framework

---
 osu.Android.props        | 2 +-
 osu.Game/osu.Game.csproj | 2 +-
 osu.iOS.props            | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index e20ac2e0b7..8fefce3a60 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.522.1" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index f91995feff..686dd8fffa 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.522.1" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 103ef50e0c..29a0350fde 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.509.0" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.522.1" />
   </ItemGroup>
 </Project>

From 66ceda1d674ce57395419b9157daec91128d403f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 21:27:53 +0800
Subject: [PATCH 883/930] Update focus specifications in line with framework
 changes

---
 .../Screens/Ladder/Components/LadderEditorSettings.cs       | 2 +-
 osu.Game/Collections/ManageCollectionsDialog.cs             | 2 +-
 osu.Game/Graphics/UserInterface/FocusedTextBox.cs           | 2 +-
 osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs        | 2 +-
 osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs | 2 +-
 osu.Game/Overlays/AccountCreation/ScreenEntry.cs            | 2 +-
 osu.Game/Overlays/Comments/ReplyCommentEditor.cs            | 2 +-
 osu.Game/Overlays/Login/LoginForm.cs                        | 2 +-
 osu.Game/Overlays/Login/LoginPanel.cs                       | 4 ++--
 osu.Game/Overlays/Login/SecondFactorAuthForm.cs             | 2 +-
 osu.Game/Overlays/LoginOverlay.cs                           | 2 +-
 osu.Game/Overlays/Mods/AddPresetPopover.cs                  | 2 +-
 osu.Game/Overlays/Mods/EditPresetPopover.cs                 | 2 +-
 osu.Game/Overlays/Mods/ModSelectOverlay.cs                  | 2 +-
 osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs  | 2 +-
 .../Settings/Sections/Input/KeyBindingsSubsection.cs        | 2 +-
 osu.Game/Overlays/SettingsPanel.cs                          | 2 +-
 .../Screens/Edit/Compose/Components/BeatDivisorControl.cs   | 2 +-
 .../Compose/Components/Timeline/DifficultyPointPiece.cs     | 2 +-
 .../Edit/Compose/Components/Timeline/SamplePointPiece.cs    | 2 +-
 osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs   | 2 +-
 osu.Game/Screens/Edit/Setup/MetadataSection.cs              | 2 +-
 .../Edit/Timing/IndeterminateSliderWithTextBoxInput.cs      | 2 +-
 osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs    | 6 +++---
 osu.Game/Screens/Select/FilterControl.cs                    | 2 +-
 osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs   | 2 +-
 26 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs b/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs
index 9f0fa19915..08ed815253 100644
--- a/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs
+++ b/osu.Game.Tournament/Screens/Ladder/Components/LadderEditorSettings.cs
@@ -58,7 +58,7 @@ namespace osu.Game.Tournament.Screens.Ladder.Components
             editorInfo.Selected.ValueChanged += selection =>
             {
                 // ensure any ongoing edits are committed out to the *current* selection before changing to a new one.
-                GetContainingInputManager().TriggerFocusContention(null);
+                GetContainingFocusManager().TriggerFocusContention(null);
 
                 // Required to avoid cyclic failure in BindableWithCurrent (TriggerChange called during the Current_Set process).
                 // Arguable a framework issue but since we haven't hit it anywhere else a local workaround seems best.
diff --git a/osu.Game/Collections/ManageCollectionsDialog.cs b/osu.Game/Collections/ManageCollectionsDialog.cs
index 16645d6796..ea663f45fe 100644
--- a/osu.Game/Collections/ManageCollectionsDialog.cs
+++ b/osu.Game/Collections/ManageCollectionsDialog.cs
@@ -137,7 +137,7 @@ namespace osu.Game.Collections
             this.ScaleTo(0.9f, exit_duration);
 
             // Ensure that textboxes commit
-            GetContainingInputManager()?.TriggerFocusContention(this);
+            GetContainingFocusManager()?.TriggerFocusContention(this);
         }
     }
 }
diff --git a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
index 338f32f321..4ec93995a4 100644
--- a/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
+++ b/osu.Game/Graphics/UserInterface/FocusedTextBox.cs
@@ -31,7 +31,7 @@ namespace osu.Game.Graphics.UserInterface
             if (!allowImmediateFocus)
                 return;
 
-            Scheduler.Add(() => GetContainingInputManager().ChangeFocus(this));
+            Scheduler.Add(() => GetContainingFocusManager().ChangeFocus(this));
         }
 
         public new void KillFocus() => base.KillFocus();
diff --git a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
index 8b9d35e343..863ad5a173 100644
--- a/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/LabelledTextBox.cs
@@ -57,7 +57,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
         protected override void OnFocus(FocusEvent e)
         {
             base.OnFocus(e);
-            GetContainingInputManager().ChangeFocus(Component);
+            GetContainingFocusManager().ChangeFocus(Component);
         }
 
         protected override OsuTextBox CreateComponent() => CreateTextBox().With(t =>
diff --git a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
index abd828e98f..4c16cb4951 100644
--- a/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
+++ b/osu.Game/Graphics/UserInterfaceV2/SliderWithTextBoxInput.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Graphics.UserInterfaceV2
             Current.BindValueChanged(updateTextBoxFromSlider, true);
         }
 
-        public bool TakeFocus() => GetContainingInputManager().ChangeFocus(textBox);
+        public bool TakeFocus() => GetContainingFocusManager().ChangeFocus(textBox);
 
         private bool updatingFromTextBox;
 
diff --git a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
index f57c7d22a2..53e51e0611 100644
--- a/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
+++ b/osu.Game/Overlays/AccountCreation/ScreenEntry.cs
@@ -243,7 +243,7 @@ namespace osu.Game.Overlays.AccountCreation
 
             if (nextTextBox != null)
             {
-                Schedule(() => GetContainingInputManager().ChangeFocus(nextTextBox));
+                Schedule(() => GetContainingFocusManager().ChangeFocus(nextTextBox));
                 return true;
             }
 
diff --git a/osu.Game/Overlays/Comments/ReplyCommentEditor.cs b/osu.Game/Overlays/Comments/ReplyCommentEditor.cs
index 8e9e82507d..caf19829ee 100644
--- a/osu.Game/Overlays/Comments/ReplyCommentEditor.cs
+++ b/osu.Game/Overlays/Comments/ReplyCommentEditor.cs
@@ -39,7 +39,7 @@ namespace osu.Game.Overlays.Comments
             base.LoadComplete();
 
             if (!TextBox.ReadOnly)
-                GetContainingInputManager().ChangeFocus(TextBox);
+                GetContainingFocusManager().ChangeFocus(TextBox);
         }
 
         protected override void OnCommit(string text)
diff --git a/osu.Game/Overlays/Login/LoginForm.cs b/osu.Game/Overlays/Login/LoginForm.cs
index 80dfca93d2..418721f371 100644
--- a/osu.Game/Overlays/Login/LoginForm.cs
+++ b/osu.Game/Overlays/Login/LoginForm.cs
@@ -150,7 +150,7 @@ namespace osu.Game.Overlays.Login
 
         protected override void OnFocus(FocusEvent e)
         {
-            Schedule(() => { GetContainingInputManager().ChangeFocus(string.IsNullOrEmpty(username.Text) ? username : password); });
+            Schedule(() => { GetContainingFocusManager().ChangeFocus(string.IsNullOrEmpty(username.Text) ? username : password); });
         }
     }
 }
diff --git a/osu.Game/Overlays/Login/LoginPanel.cs b/osu.Game/Overlays/Login/LoginPanel.cs
index a8adf4ce8c..845d20ccaf 100644
--- a/osu.Game/Overlays/Login/LoginPanel.cs
+++ b/osu.Game/Overlays/Login/LoginPanel.cs
@@ -186,7 +186,7 @@ namespace osu.Game.Overlays.Login
             }
 
             if (form != null)
-                ScheduleAfterChildren(() => GetContainingInputManager()?.ChangeFocus(form));
+                ScheduleAfterChildren(() => GetContainingFocusManager()?.ChangeFocus(form));
         });
 
         private void updateDropdownCurrent(UserStatus? status)
@@ -216,7 +216,7 @@ namespace osu.Game.Overlays.Login
 
         protected override void OnFocus(FocusEvent e)
         {
-            if (form != null) GetContainingInputManager().ChangeFocus(form);
+            if (form != null) GetContainingFocusManager().ChangeFocus(form);
             base.OnFocus(e);
         }
     }
diff --git a/osu.Game/Overlays/Login/SecondFactorAuthForm.cs b/osu.Game/Overlays/Login/SecondFactorAuthForm.cs
index dcd3119f33..82e328c036 100644
--- a/osu.Game/Overlays/Login/SecondFactorAuthForm.cs
+++ b/osu.Game/Overlays/Login/SecondFactorAuthForm.cs
@@ -141,7 +141,7 @@ namespace osu.Game.Overlays.Login
 
         protected override void OnFocus(FocusEvent e)
         {
-            Schedule(() => { GetContainingInputManager().ChangeFocus(codeTextBox); });
+            Schedule(() => { GetContainingFocusManager().ChangeFocus(codeTextBox); });
         }
     }
 }
diff --git a/osu.Game/Overlays/LoginOverlay.cs b/osu.Game/Overlays/LoginOverlay.cs
index c0aff6aae9..8dc454c0a0 100644
--- a/osu.Game/Overlays/LoginOverlay.cs
+++ b/osu.Game/Overlays/LoginOverlay.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Overlays
             this.FadeIn(transition_time, Easing.OutQuint);
             FadeEdgeEffectTo(WaveContainer.SHADOW_OPACITY, WaveContainer.APPEAR_DURATION, Easing.Out);
 
-            ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(panel));
+            ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(panel));
         }
 
         protected override void PopOut()
diff --git a/osu.Game/Overlays/Mods/AddPresetPopover.cs b/osu.Game/Overlays/Mods/AddPresetPopover.cs
index b782b5d6ba..50aa5a2eb4 100644
--- a/osu.Game/Overlays/Mods/AddPresetPopover.cs
+++ b/osu.Game/Overlays/Mods/AddPresetPopover.cs
@@ -89,7 +89,7 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(nameTextBox));
+            ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(nameTextBox));
 
             nameTextBox.Current.BindValueChanged(s =>
             {
diff --git a/osu.Game/Overlays/Mods/EditPresetPopover.cs b/osu.Game/Overlays/Mods/EditPresetPopover.cs
index 9554ba8ce2..8fa6b35162 100644
--- a/osu.Game/Overlays/Mods/EditPresetPopover.cs
+++ b/osu.Game/Overlays/Mods/EditPresetPopover.cs
@@ -136,7 +136,7 @@ namespace osu.Game.Overlays.Mods
         {
             base.LoadComplete();
 
-            ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(nameTextBox));
+            ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(nameTextBox));
         }
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 25293e8e20..54124e10c7 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -949,7 +949,7 @@ namespace osu.Game.Overlays.Mods
                     RequestScroll?.Invoke(this);
 
                 // Killing focus is done here because it's the only feasible place on ModSelectOverlay you can click on without triggering any action.
-                Scheduler.Add(() => GetContainingInputManager().ChangeFocus(null));
+                Scheduler.Add(() => GetContainingFocusManager().ChangeFocus(null));
 
                 return true;
             }
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
index e82cebe9f4..3f6eeca10e 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingRow.cs
@@ -465,7 +465,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             }
 
             if (HasFocus)
-                GetContainingInputManager().ChangeFocus(null);
+                GetContainingFocusManager().ChangeFocus(null);
 
             cancelAndClearButtons.FadeOut(300, Easing.OutQuint);
             cancelAndClearButtons.BypassAutoSizeAxes |= Axes.Y;
diff --git a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
index dd0a88bfb1..db3b56b9f0 100644
--- a/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
+++ b/osu.Game/Overlays/Settings/Sections/Input/KeyBindingsSubsection.cs
@@ -106,7 +106,7 @@ namespace osu.Game.Overlays.Settings.Sections.Input
             {
                 var next = Children.SkipWhile(c => c != sender).Skip(1).FirstOrDefault();
                 if (next != null)
-                    GetContainingInputManager().ChangeFocus(next);
+                    GetContainingFocusManager().ChangeFocus(next);
             }
         }
     }
diff --git a/osu.Game/Overlays/SettingsPanel.cs b/osu.Game/Overlays/SettingsPanel.cs
index 748673035b..d5c642d24f 100644
--- a/osu.Game/Overlays/SettingsPanel.cs
+++ b/osu.Game/Overlays/SettingsPanel.cs
@@ -201,7 +201,7 @@ namespace osu.Game.Overlays
 
             searchTextBox.HoldFocus = false;
             if (searchTextBox.HasFocus)
-                GetContainingInputManager().ChangeFocus(null);
+                GetContainingFocusManager().ChangeFocus(null);
         }
 
         public override bool AcceptsFocus => true;
diff --git a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
index 40b97d2137..005b96bfef 100644
--- a/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/BeatDivisorControl.cs
@@ -580,7 +580,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             {
                 base.LoadComplete();
 
-                GetContainingInputManager().ChangeFocus(this);
+                GetContainingFocusManager().ChangeFocus(this);
                 SelectAll();
             }
         }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
index fc240c570b..d9084a7477 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/DifficultyPointPiece.cs
@@ -138,7 +138,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(sliderVelocitySlider));
+                ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(sliderVelocitySlider));
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
index 28841fc9e5..5c4a9faaca 100644
--- a/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/Timeline/SamplePointPiece.cs
@@ -142,7 +142,7 @@ namespace osu.Game.Screens.Edit.Compose.Components.Timeline
             protected override void LoadComplete()
             {
                 base.LoadComplete();
-                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(volume));
+                ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(volume));
             }
 
             private static string? getCommonBank(IList<HitSampleInfo>[] relevantSamples) => relevantSamples.Select(GetBankValue).Distinct().Count() == 1 ? GetBankValue(relevantSamples.First()) : null;
diff --git a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
index 79288e2977..5abf40dda7 100644
--- a/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
+++ b/osu.Game/Screens/Edit/Setup/LabelledTextBoxWithPopover.cs
@@ -45,7 +45,7 @@ namespace osu.Game.Screens.Edit.Setup
                 OnFocused?.Invoke();
                 base.OnFocus(e);
 
-                GetContainingInputManager().TriggerFocusContention(this);
+                GetContainingFocusManager().TriggerFocusContention(this);
             }
         }
     }
diff --git a/osu.Game/Screens/Edit/Setup/MetadataSection.cs b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
index 752f590308..660c470204 100644
--- a/osu.Game/Screens/Edit/Setup/MetadataSection.cs
+++ b/osu.Game/Screens/Edit/Setup/MetadataSection.cs
@@ -73,7 +73,7 @@ namespace osu.Game.Screens.Edit.Setup
             base.LoadComplete();
 
             if (string.IsNullOrEmpty(ArtistTextBox.Current.Value))
-                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(ArtistTextBox));
+                ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(ArtistTextBox));
 
             ArtistTextBox.Current.BindValueChanged(artist => transferIfRomanised(artist.NewValue, RomanisedArtistTextBox));
             TitleTextBox.Current.BindValueChanged(title => transferIfRomanised(title.NewValue, RomanisedTitleTextBox));
diff --git a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
index 26f374ba85..4f7a1bf589 100644
--- a/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
+++ b/osu.Game/Screens/Edit/Timing/IndeterminateSliderWithTextBoxInput.cs
@@ -126,7 +126,7 @@ namespace osu.Game.Screens.Edit.Timing
         protected override void OnFocus(FocusEvent e)
         {
             base.OnFocus(e);
-            GetContainingInputManager().ChangeFocus(textBox);
+            GetContainingFocusManager().ChangeFocus(textBox);
         }
 
         private void updateState()
diff --git a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
index 66bbf92e58..2f6a220c82 100644
--- a/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
+++ b/osu.Game/Screens/OnlinePlay/Lounge/DrawableLoungeRoom.cs
@@ -248,21 +248,21 @@ namespace osu.Game.Screens.OnlinePlay.Lounge
             {
                 base.LoadComplete();
 
-                ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(passwordTextBox));
+                ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(passwordTextBox));
                 passwordTextBox.OnCommit += (_, _) => performJoin();
             }
 
             private void performJoin()
             {
                 lounge?.Join(room, passwordTextBox.Text, null, joinFailed);
-                GetContainingInputManager().TriggerFocusContention(passwordTextBox);
+                GetContainingFocusManager().TriggerFocusContention(passwordTextBox);
             }
 
             private void joinFailed(string error) => Schedule(() =>
             {
                 passwordTextBox.Text = string.Empty;
 
-                GetContainingInputManager().ChangeFocus(passwordTextBox);
+                GetContainingFocusManager().ChangeFocus(passwordTextBox);
 
                 errorText.Text = error;
                 errorText
diff --git a/osu.Game/Screens/Select/FilterControl.cs b/osu.Game/Screens/Select/FilterControl.cs
index 73c122dda6..30eb4a8491 100644
--- a/osu.Game/Screens/Select/FilterControl.cs
+++ b/osu.Game/Screens/Select/FilterControl.cs
@@ -245,7 +245,7 @@ namespace osu.Game.Screens.Select
             searchTextBox.ReadOnly = true;
             searchTextBox.HoldFocus = false;
             if (searchTextBox.HasFocus)
-                GetContainingInputManager().ChangeFocus(searchTextBox);
+                GetContainingFocusManager().ChangeFocus(searchTextBox);
         }
 
         public void Activate()
diff --git a/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs b/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
index f73be15a36..2827a9cb50 100644
--- a/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
+++ b/osu.Game/Screens/SelectV2/Footer/BeatmapOptionsPopover.cs
@@ -78,7 +78,7 @@ namespace osu.Game.Screens.SelectV2.Footer
         {
             base.LoadComplete();
 
-            ScheduleAfterChildren(() => GetContainingInputManager().ChangeFocus(this));
+            ScheduleAfterChildren(() => GetContainingFocusManager().ChangeFocus(this));
 
             beatmap.BindValueChanged(_ => Hide());
         }

From f7ca18b52ec4e8dbc704d58a7cfef0c301201524 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Wed, 22 May 2024 15:52:57 +0200
Subject: [PATCH 884/930] Menial cleanups

---
 .../Beatmaps/Formats/LegacyBeatmapDecoder.cs     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index e5567b2215..8ea1d55a0d 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -105,18 +105,18 @@ namespace osu.Game.Beatmaps.Formats
         }
 
         /// <summary>
-        /// Clamp Difficulty settings to be within the normal range.
+        /// Ensures that all <see cref="BeatmapDifficulty"/> settings are within the allowed ranges.
+        /// See also: https://github.com/peppy/osu-stable-reference/blob/0e425c0d525ef21353c8293c235cc0621d28338b/osu!/GameplayElements/Beatmaps/Beatmap.cs#L567-L614
         /// </summary>
         private void applyDifficultyRestrictions(BeatmapDifficulty difficulty)
         {
             difficulty.DrainRate = Math.Clamp(difficulty.DrainRate, 0, 10);
-            //If the mode is not Mania, clamp circle size to [0,10]
-            if (beatmap.BeatmapInfo.Ruleset.OnlineID != 3)
-                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 0, 10);
-            //If it is Mania, it must be within [1,18] - copying what stable does https://github.com/ppy/osu/pull/28200#discussion_r1609522988
-            //The lower bound should be 4, but there are ranked maps that are lower than this.
-            else
-                difficulty.CircleSize = Math.Clamp(difficulty.CircleSize, 1, 18);
+
+            // mania uses "circle size" for key count, thus different allowable range
+            difficulty.CircleSize = beatmap.BeatmapInfo.Ruleset.OnlineID != 3
+                ? Math.Clamp(difficulty.CircleSize, 0, 10)
+                : Math.Clamp(difficulty.CircleSize, 1, 18);
+
             difficulty.OverallDifficulty = Math.Clamp(difficulty.OverallDifficulty, 0, 10);
             difficulty.ApproachRate = Math.Clamp(difficulty.ApproachRate, 0, 10);
 

From 093be3d723ef18bcb3e7eaac1642c0006b62f922 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 21:55:53 +0800
Subject: [PATCH 885/930] Cast remaining test usages to `IFocusManager` to
 remove obsolete notice

---
 .../TestSceneHitObjectSampleAdjustments.cs      |  3 ++-
 .../Editing/TestSceneLabelledTimeSignature.cs   |  9 +++++----
 .../UserInterface/TestSceneModSelectOverlay.cs  |  3 ++-
 .../TestSceneSliderWithTextBoxInput.cs          | 17 +++++++++--------
 4 files changed, 18 insertions(+), 14 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSampleAdjustments.cs b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSampleAdjustments.cs
index 1415ff4b0f..0e12ed68e4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSampleAdjustments.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneHitObjectSampleAdjustments.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using System.Collections.Generic;
 using Humanizer;
 using NUnit.Framework;
+using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Audio;
 using osu.Game.Beatmaps;
@@ -396,7 +397,7 @@ namespace osu.Game.Tests.Visual.Editing
             textBox.Current.Value = bank;
             // force a commit via keyboard.
             // this is needed when testing attempting to set empty bank - which should revert to the previous value, but only on commit.
-            InputManager.ChangeFocus(textBox);
+            ((IFocusManager)InputManager).ChangeFocus(textBox);
             InputManager.Key(Key.Enter);
         });
 
diff --git a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
index e91596b872..3d7d0797d4 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneLabelledTimeSignature.cs
@@ -6,6 +6,7 @@
 using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Graphics;
+using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps.Timing;
 using osu.Game.Graphics.UserInterface;
@@ -62,12 +63,12 @@ namespace osu.Game.Tests.Visual.Editing
             createLabelledTimeSignature(TimeSignature.SimpleQuadruple);
             AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
 
-            AddStep("focus text box", () => InputManager.ChangeFocus(numeratorTextBox));
+            AddStep("focus text box", () => ((IFocusManager)InputManager).ChangeFocus(numeratorTextBox));
 
             AddStep("set numerator to 7", () => numeratorTextBox.Current.Value = "7");
             AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
 
-            AddStep("drop focus", () => InputManager.ChangeFocus(null));
+            AddStep("drop focus", () => ((IFocusManager)InputManager).ChangeFocus(null));
             AddAssert("current is 7/4", () => timeSignature.Current.Value.Equals(new TimeSignature(7)));
         }
 
@@ -77,12 +78,12 @@ namespace osu.Game.Tests.Visual.Editing
             createLabelledTimeSignature(TimeSignature.SimpleQuadruple);
             AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
 
-            AddStep("focus text box", () => InputManager.ChangeFocus(numeratorTextBox));
+            AddStep("focus text box", () => ((IFocusManager)InputManager).ChangeFocus(numeratorTextBox));
 
             AddStep("set numerator to 0", () => numeratorTextBox.Current.Value = "0");
             AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
 
-            AddStep("drop focus", () => InputManager.ChangeFocus(null));
+            AddStep("drop focus", () => ((IFocusManager)InputManager).ChangeFocus(null));
             AddAssert("current is 4/4", () => timeSignature.Current.Value.Equals(TimeSignature.SimpleQuadruple));
             AddAssert("numerator is 4", () => numeratorTextBox.Current.Value == "4");
         }
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
index 8ddbd84890..a1452ddb31 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneModSelectOverlay.cs
@@ -10,6 +10,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Extensions.ObjectExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
+using osu.Framework.Input;
 using osu.Framework.Localisation;
 using osu.Framework.Testing;
 using osu.Framework.Utils;
@@ -623,7 +624,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddStep("press tab", () => InputManager.Key(Key.Tab));
             AddAssert("search text box focused", () => modSelectOverlay.SearchTextBox.HasFocus);
 
-            AddStep("unfocus search text box externally", () => InputManager.ChangeFocus(null));
+            AddStep("unfocus search text box externally", () => ((IFocusManager)InputManager).ChangeFocus(null));
 
             AddStep("press tab", () => InputManager.Key(Key.Tab));
             AddAssert("search text box focused", () => modSelectOverlay.SearchTextBox.HasFocus);
diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneSliderWithTextBoxInput.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneSliderWithTextBoxInput.cs
index d23fcebae3..06b9623508 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneSliderWithTextBoxInput.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneSliderWithTextBoxInput.cs
@@ -5,6 +5,7 @@ using System.Linq;
 using NUnit.Framework;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
+using osu.Framework.Input;
 using osu.Framework.Testing;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Graphics.UserInterfaceV2;
@@ -42,7 +43,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("set instantaneous to false", () => sliderWithTextBoxInput.Instantaneous = false);
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("change text", () => textBox.Text = "3");
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.Zero);
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.Zero);
@@ -61,7 +62,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("textbox changed", () => textBox.Current.Value, () => Is.EqualTo("-5"));
             AddAssert("current changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("set text to invalid", () => textBox.Text = "garbage");
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
@@ -71,12 +72,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("set text to invalid", () => textBox.Text = "garbage");
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("lose focus", () => InputManager.ChangeFocus(null));
+            AddStep("lose focus", () => ((IFocusManager)InputManager).ChangeFocus(null));
             AddAssert("text restored", () => textBox.Text, () => Is.EqualTo("-5"));
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
@@ -87,7 +88,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         {
             AddStep("set instantaneous to true", () => sliderWithTextBoxInput.Instantaneous = true);
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("change text", () => textBox.Text = "3");
             AddAssert("slider moved", () => slider.Current.Value, () => Is.EqualTo(3));
             AddAssert("current changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(3));
@@ -106,7 +107,7 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("textbox not changed", () => textBox.Current.Value, () => Is.EqualTo("-5"));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("set text to invalid", () => textBox.Text = "garbage");
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
@@ -116,12 +117,12 @@ namespace osu.Game.Tests.Visual.UserInterface
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("focus textbox", () => InputManager.ChangeFocus(textBox));
+            AddStep("focus textbox", () => ((IFocusManager)InputManager).ChangeFocus(textBox));
             AddStep("set text to invalid", () => textBox.Text = "garbage");
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));
 
-            AddStep("lose focus", () => InputManager.ChangeFocus(null));
+            AddStep("lose focus", () => ((IFocusManager)InputManager).ChangeFocus(null));
             AddAssert("text restored", () => textBox.Text, () => Is.EqualTo("-5"));
             AddAssert("slider not moved", () => slider.Current.Value, () => Is.EqualTo(-5));
             AddAssert("current not changed", () => sliderWithTextBoxInput.Current.Value, () => Is.EqualTo(-5));

From 0d13848421de5198fc438fd7f4a2420c265dc31b Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 23 May 2024 00:21:19 +0900
Subject: [PATCH 886/930] Add whitespace to appease R#

---
 osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs | 1 +
 1 file changed, 1 insertion(+)

diff --git a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
index e6daba2016..a4cd888823 100644
--- a/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
+++ b/osu.Game.Tests/Beatmaps/Formats/LegacyBeatmapDecoderTest.cs
@@ -1206,6 +1206,7 @@ namespace osu.Game.Tests.Beatmaps.Formats
                 Assert.That(decoded.SliderTickRate, Is.EqualTo(8));
             }
         }
+
         [Test]
         public void TestManiaBeatmapDifficultyCircleSizeClamp()
         {

From 73cb363eba003fd329477ab778f28610d0b9e596 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Wed, 22 May 2024 23:25:59 +0800
Subject: [PATCH 887/930] Make some more methods static

---
 osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
index 8ea1d55a0d..c2f4097889 100644
--- a/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
+++ b/osu.Game/Beatmaps/Formats/LegacyBeatmapDecoder.cs
@@ -85,7 +85,7 @@ namespace osu.Game.Beatmaps.Formats
 
             base.ParseStreamInto(stream, beatmap);
 
-            applyDifficultyRestrictions(beatmap.Difficulty);
+            applyDifficultyRestrictions(beatmap.Difficulty, beatmap);
 
             flushPendingPoints();
 
@@ -108,7 +108,7 @@ namespace osu.Game.Beatmaps.Formats
         /// Ensures that all <see cref="BeatmapDifficulty"/> settings are within the allowed ranges.
         /// See also: https://github.com/peppy/osu-stable-reference/blob/0e425c0d525ef21353c8293c235cc0621d28338b/osu!/GameplayElements/Beatmaps/Beatmap.cs#L567-L614
         /// </summary>
-        private void applyDifficultyRestrictions(BeatmapDifficulty difficulty)
+        private static void applyDifficultyRestrictions(BeatmapDifficulty difficulty, Beatmap beatmap)
         {
             difficulty.DrainRate = Math.Clamp(difficulty.DrainRate, 0, 10);
 
@@ -127,7 +127,7 @@ namespace osu.Game.Beatmaps.Formats
         /// <summary>
         /// Processes the beatmap such that a new combo is started the first hitobject following each break.
         /// </summary>
-        private void postProcessBreaks(Beatmap beatmap)
+        private static void postProcessBreaks(Beatmap beatmap)
         {
             int currentBreak = 0;
             bool forceNewCombo = false;
@@ -183,7 +183,7 @@ namespace osu.Game.Beatmaps.Formats
         /// This method's intention is to restore those legacy defaults.
         /// See also: https://osu.ppy.sh/wiki/en/Client/File_formats/Osu_%28file_format%29
         /// </summary>
-        private void applyLegacyDefaults(BeatmapInfo beatmapInfo)
+        private static void applyLegacyDefaults(BeatmapInfo beatmapInfo)
         {
             beatmapInfo.WidescreenStoryboard = false;
             beatmapInfo.SamplesMatchPlaybackRate = false;

From c3a2a1361d045dbfd7c409fcd003ddc33dd54164 Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Wed, 22 May 2024 10:39:42 +0200
Subject: [PATCH 888/930] SliderBody's Size getter updates size to the
 body/path's Size

---
 .../Sliders/Components/SliderBodyPiece.cs           | 12 +++++++++++-
 .../Skinning/Default/ManualSliderBody.cs            | 13 ++++++++++---
 2 files changed, 21 insertions(+), 4 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
index 075e9e6aa1..14d72a2d36 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
@@ -61,10 +61,20 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
                 body.SetVertices(vertices);
             }
 
-            Size = body.Size;
             OriginPosition = body.PathOffset;
         }
 
+        public override Vector2 Size
+        {
+            get
+            {
+                if (base.Size != body.Size)
+                    Size = body.Size;
+                return base.Size;
+            }
+            set => base.Size = value;
+        }
+
         public void RecyclePath() => body.RecyclePath();
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => body.ReceivePositionalInputAt(screenSpacePos);
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
index d171f56f40..99d954059c 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
@@ -11,10 +11,17 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
     /// </summary>
     public partial class ManualSliderBody : SliderBody
     {
-        public new void SetVertices(IReadOnlyList<Vector2> vertices)
+        public new void SetVertices(IReadOnlyList<Vector2> vertices) => base.SetVertices(vertices);
+
+        public override Vector2 Size
         {
-            base.SetVertices(vertices);
-            Size = Path.Size;
+            get
+            {
+                if (base.Size != Path.Size)
+                    Size = Path.Size;
+                return base.Size;
+            }
+            set => base.Size = value;
         }
     }
 }

From fd9f8bd3e098ed85b84c562afd884e1191018d25 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 01:20:58 +0800
Subject: [PATCH 889/930] Update framework

---
 osu.Android.props                          | 2 +-
 osu.Game/Collections/CollectionDropdown.cs | 7 ++++++-
 osu.Game/osu.Game.csproj                   | 2 +-
 osu.iOS.props                              | 2 +-
 4 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/osu.Android.props b/osu.Android.props
index 8fefce3a60..1f241c6db5 100644
--- a/osu.Android.props
+++ b/osu.Android.props
@@ -10,7 +10,7 @@
     <EmbedAssembliesIntoApk>true</EmbedAssembliesIntoApk>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.522.1" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2024.523.0" />
   </ItemGroup>
   <PropertyGroup>
     <!-- Fody does not handle Android build well, and warns when unchanged.
diff --git a/osu.Game/Collections/CollectionDropdown.cs b/osu.Game/Collections/CollectionDropdown.cs
index 15dd644073..c04689b097 100644
--- a/osu.Game/Collections/CollectionDropdown.cs
+++ b/osu.Game/Collections/CollectionDropdown.cs
@@ -202,7 +202,7 @@ namespace osu.Game.Collections
             [BackgroundDependencyLoader]
             private void load()
             {
-                AddInternal(addOrRemoveButton = new IconButton
+                AddInternal(addOrRemoveButton = new NoFocusChangeIconButton
                 {
                     Anchor = Anchor.CentreRight,
                     Origin = Anchor.CentreRight,
@@ -271,6 +271,11 @@ namespace osu.Game.Collections
             }
 
             protected override Drawable CreateContent() => (Content)base.CreateContent();
+
+            private partial class NoFocusChangeIconButton : IconButton
+            {
+                public override bool ChangeFocusOnClick => false;
+            }
         }
     }
 }
diff --git a/osu.Game/osu.Game.csproj b/osu.Game/osu.Game.csproj
index 686dd8fffa..8a1a769f4f 100644
--- a/osu.Game/osu.Game.csproj
+++ b/osu.Game/osu.Game.csproj
@@ -35,7 +35,7 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="11.5.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2024.522.1" />
+    <PackageReference Include="ppy.osu.Framework" Version="2024.523.0" />
     <PackageReference Include="ppy.osu.Game.Resources" Version="2024.510.0" />
     <PackageReference Include="Sentry" Version="4.3.0" />
     <!-- Held back due to 0.34.0 failing AOT compilation on ZstdSharp.dll dependency. -->
diff --git a/osu.iOS.props b/osu.iOS.props
index 29a0350fde..eba9abd3b8 100644
--- a/osu.iOS.props
+++ b/osu.iOS.props
@@ -23,6 +23,6 @@
     <RuntimeIdentifier>iossimulator-x64</RuntimeIdentifier>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.522.1" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2024.523.0" />
   </ItemGroup>
 </Project>

From f85a1339d9e8b0a185aa48d38912ba971556bd73 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 14:12:27 +0800
Subject: [PATCH 890/930] Unload daily challenge background less aggressively

---
 .../UpdateableOnlineBeatmapSetCover.cs          | 17 +++++++++++------
 osu.Game/Screens/Menu/DailyChallengeButton.cs   |  2 +-
 2 files changed, 12 insertions(+), 7 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
index 2a6b6f90e3..5bce472613 100644
--- a/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
+++ b/osu.Game/Beatmaps/Drawables/UpdateableOnlineBeatmapSetCover.cs
@@ -27,8 +27,17 @@ namespace osu.Game.Beatmaps.Drawables
             set => base.Masking = value;
         }
 
-        public UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType coverType = BeatmapSetCoverType.Cover)
+        protected override double LoadDelay { get; }
+
+        private readonly double timeBeforeUnload;
+
+        protected override double TransformDuration => 400;
+
+        public UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType coverType = BeatmapSetCoverType.Cover, double timeBeforeLoad = 500, double timeBeforeUnload = 1000)
         {
+            LoadDelay = timeBeforeLoad;
+            this.timeBeforeUnload = timeBeforeUnload;
+
             this.coverType = coverType;
 
             InternalChild = new Box
@@ -38,12 +47,8 @@ namespace osu.Game.Beatmaps.Drawables
             };
         }
 
-        protected override double LoadDelay => 500;
-
-        protected override double TransformDuration => 400;
-
         protected override DelayedLoadWrapper CreateDelayedLoadWrapper(Func<Drawable> createContentFunc, double timeBeforeLoad)
-            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad)
+            => new DelayedLoadUnloadWrapper(createContentFunc, timeBeforeLoad, timeBeforeUnload)
             {
                 Anchor = Anchor.Centre,
                 Origin = Anchor.Centre,
diff --git a/osu.Game/Screens/Menu/DailyChallengeButton.cs b/osu.Game/Screens/Menu/DailyChallengeButton.cs
index 907fd04148..28b3747fbf 100644
--- a/osu.Game/Screens/Menu/DailyChallengeButton.cs
+++ b/osu.Game/Screens/Menu/DailyChallengeButton.cs
@@ -67,7 +67,7 @@ namespace osu.Game.Screens.Menu
         {
             Children = new Drawable[]
             {
-                cover = new UpdateableOnlineBeatmapSetCover
+                cover = new UpdateableOnlineBeatmapSetCover(timeBeforeLoad: 0, timeBeforeUnload: 600_000)
                 {
                     RelativeSizeAxes = Axes.Y,
                     Anchor = Anchor.Centre,

From 84fe3699f641b3489eda5730a2f94ea2317e53ad Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 14:31:20 +0800
Subject: [PATCH 891/930] Reorder test steps to work better on multiple runs

---
 .../UserInterface/TestSceneMainMenuButton.cs     | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs b/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
index 921e28d607..5914898cb1 100644
--- a/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
+++ b/osu.Game.Tests/Visual/UserInterface/TestSceneMainMenuButton.cs
@@ -39,12 +39,7 @@ namespace osu.Game.Tests.Visual.UserInterface
         [Test]
         public void TestDailyChallengeButton()
         {
-            AddStep("add button", () => Child = new DailyChallengeButton(@"button-default-select", new Color4(102, 68, 204, 255), _ => { }, 0, Key.D)
-            {
-                Anchor = Anchor.Centre,
-                Origin = Anchor.Centre,
-                ButtonSystemState = ButtonSystemState.TopLevel,
-            });
+            AddStep("beatmap of the day not active", () => metadataClient.DailyChallengeUpdated(null));
 
             AddStep("set up API", () => dummyAPI.HandleRequest = req =>
             {
@@ -72,12 +67,17 @@ namespace osu.Game.Tests.Visual.UserInterface
                 }
             });
 
+            AddStep("add button", () => Child = new DailyChallengeButton(@"button-default-select", new Color4(102, 68, 204, 255), _ => { }, 0, Key.D)
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                ButtonSystemState = ButtonSystemState.TopLevel,
+            });
+
             AddStep("beatmap of the day active", () => metadataClient.DailyChallengeUpdated(new DailyChallengeInfo
             {
                 RoomID = 1234,
             }));
-
-            AddStep("beatmap of the day not active", () => metadataClient.DailyChallengeUpdated(null));
         }
     }
 }

From 88a2f74326183605a7130c3a74cdd09ebb6a9b36 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 16:00:23 +0800
Subject: [PATCH 892/930] Adjust animation

---
 osu.Game/Screens/Menu/DailyChallengeButton.cs | 23 ++++++++++++-------
 1 file changed, 15 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Screens/Menu/DailyChallengeButton.cs b/osu.Game/Screens/Menu/DailyChallengeButton.cs
index 28b3747fbf..3e514d0c1f 100644
--- a/osu.Game/Screens/Menu/DailyChallengeButton.cs
+++ b/osu.Game/Screens/Menu/DailyChallengeButton.cs
@@ -12,6 +12,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Threading;
+using osu.Framework.Utils;
 using osu.Game.Beatmaps.Drawables;
 using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Graphics;
@@ -72,8 +73,7 @@ namespace osu.Game.Screens.Menu
                     RelativeSizeAxes = Axes.Y,
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
-                    RelativePositionAxes = Axes.X,
-                    X = -0.5f,
+                    RelativePositionAxes = Axes.Both,
                 },
                 new Box
                 {
@@ -100,18 +100,25 @@ namespace osu.Game.Screens.Menu
             base.LoadComplete();
 
             info.BindValueChanged(updateDisplay, true);
-            FinishTransforms(true);
-
-            cover.MoveToX(-0.5f, 10000, Easing.InOutSine)
-                 .Then().MoveToX(0.5f, 10000, Easing.InOutSine)
-                 .Loop();
         }
 
         protected override void Update()
         {
             base.Update();
 
-            cover.Width = 2 * background.DrawWidth;
+            if (cover.LatestTransformEndTime == Time.Current)
+            {
+                const double duration = 3000;
+
+                float scale = 1 + RNG.NextSingle();
+
+                cover.ScaleTo(scale, duration, Easing.InOutSine)
+                     .RotateTo(RNG.NextSingle(-4, 4) * (scale - 1), duration, Easing.InOutSine)
+                     .MoveTo(new Vector2(
+                         RNG.NextSingle(-0.5f, 0.5f) * (scale - 1),
+                         RNG.NextSingle(-0.5f, 0.5f) * (scale - 1)
+                     ), duration, Easing.InOutSine);
+            }
         }
 
         private void updateDisplay(ValueChangedEvent<DailyChallengeInfo?> info)

From a3639e0ce3c8cec679432624f571c71443c84978 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 17:19:11 +0800
Subject: [PATCH 893/930] Remove unused field

---
 osu.Game/Screens/Menu/DailyChallengeButton.cs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/DailyChallengeButton.cs b/osu.Game/Screens/Menu/DailyChallengeButton.cs
index 3e514d0c1f..7dbd90eeba 100644
--- a/osu.Game/Screens/Menu/DailyChallengeButton.cs
+++ b/osu.Game/Screens/Menu/DailyChallengeButton.cs
@@ -38,7 +38,6 @@ namespace osu.Game.Screens.Menu
 
         private UpdateableOnlineBeatmapSetCover cover = null!;
         private IBindable<DailyChallengeInfo?> info = null!;
-        private BufferedContainer background = null!;
 
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
@@ -64,7 +63,7 @@ namespace osu.Game.Screens.Menu
             });
         }
 
-        protected override Drawable CreateBackground(Colour4 accentColour) => background = new BufferedContainer
+        protected override Drawable CreateBackground(Colour4 accentColour) => new BufferedContainer
         {
             Children = new Drawable[]
             {

From 357e55ae1f9d4d19fc7e28f508a73d2ca05e8751 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Thu, 23 May 2024 17:39:59 +0800
Subject: [PATCH 894/930] Make gradient layer a bit more dynamic

---
 osu.Game/Screens/Menu/DailyChallengeButton.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/osu.Game/Screens/Menu/DailyChallengeButton.cs b/osu.Game/Screens/Menu/DailyChallengeButton.cs
index 7dbd90eeba..c365994736 100644
--- a/osu.Game/Screens/Menu/DailyChallengeButton.cs
+++ b/osu.Game/Screens/Menu/DailyChallengeButton.cs
@@ -39,6 +39,8 @@ namespace osu.Game.Screens.Menu
         private UpdateableOnlineBeatmapSetCover cover = null!;
         private IBindable<DailyChallengeInfo?> info = null!;
 
+        private Box gradientLayer = null!;
+
         [Resolved]
         private IAPIProvider api { get; set; } = null!;
 
@@ -74,10 +76,10 @@ namespace osu.Game.Screens.Menu
                     Origin = Anchor.Centre,
                     RelativePositionAxes = Axes.Both,
                 },
-                new Box
+                gradientLayer = new Box
                 {
                     RelativeSizeAxes = Axes.Both,
-                    Colour = ColourInfo.GradientVertical(accentColour.Opacity(0), accentColour),
+                    Colour = ColourInfo.GradientVertical(accentColour.Opacity(0.2f), accentColour),
                     Blending = BlendingParameters.Additive,
                 },
                 new Box
@@ -117,6 +119,10 @@ namespace osu.Game.Screens.Menu
                          RNG.NextSingle(-0.5f, 0.5f) * (scale - 1),
                          RNG.NextSingle(-0.5f, 0.5f) * (scale - 1)
                      ), duration, Easing.InOutSine);
+
+                gradientLayer.FadeIn(duration / 2)
+                             .Then()
+                             .FadeOut(duration / 2);
             }
         }
 

From bfa23ec7a47ed41be7ffc40e46b28fd5fff2b648 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 11:46:48 +0200
Subject: [PATCH 895/930] Fix main menu button animation not playing on initial
 show

---
 osu.Game/Screens/Menu/MainMenuButton.cs | 69 ++++++++++++++-----------
 1 file changed, 38 insertions(+), 31 deletions(-)

diff --git a/osu.Game/Screens/Menu/MainMenuButton.cs b/osu.Game/Screens/Menu/MainMenuButton.cs
index fe8fb91766..29a661066c 100644
--- a/osu.Game/Screens/Menu/MainMenuButton.cs
+++ b/osu.Game/Screens/Menu/MainMenuButton.cs
@@ -179,7 +179,6 @@ namespace osu.Game.Screens.Menu
         {
             base.LoadComplete();
 
-            background.Size = initialSize;
             background.Shear = new Vector2(ButtonSystem.WEDGE_WIDTH / initialSize.Y, 0);
 
             // for whatever reason, attempting to size the background "just in time" to cover the visible width
@@ -189,6 +188,9 @@ namespace osu.Game.Screens.Menu
             // (which can exceed the [0;1] range during interpolation).
             backgroundContent.Width = 2 * initialSize.X;
             backgroundContent.Shear = -background.Shear;
+
+            animateState();
+            FinishTransforms(true);
         }
 
         private bool rightward;
@@ -318,41 +320,46 @@ namespace osu.Game.Screens.Menu
 
                 state = value;
 
-                switch (state)
-                {
-                    case ButtonState.Contracted:
-                        switch (ContractStyle)
-                        {
-                            default:
-                                background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 500, Easing.OutExpo);
-                                this.FadeOut(500);
-                                break;
-
-                            case 1:
-                                background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 400, Easing.InSine);
-                                this.FadeOut(800);
-                                break;
-                        }
-
-                        break;
-
-                    case ButtonState.Expanded:
-                        const int expand_duration = 500;
-                        background.ResizeTo(initialSize, expand_duration, Easing.OutExpo);
-                        this.FadeIn(expand_duration / 6f);
-                        break;
-
-                    case ButtonState.Exploded:
-                        const int explode_duration = 200;
-                        background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(2, 1)), explode_duration, Easing.OutExpo);
-                        this.FadeOut(explode_duration / 4f * 3);
-                        break;
-                }
+                animateState();
 
                 StateChanged?.Invoke(State);
             }
         }
 
+        private void animateState()
+        {
+            switch (state)
+            {
+                case ButtonState.Contracted:
+                    switch (ContractStyle)
+                    {
+                        default:
+                            background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 500, Easing.OutExpo);
+                            this.FadeOut(500);
+                            break;
+
+                        case 1:
+                            background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(0, 1)), 400, Easing.InSine);
+                            this.FadeOut(800);
+                            break;
+                    }
+
+                    break;
+
+                case ButtonState.Expanded:
+                    const int expand_duration = 500;
+                    background.ResizeTo(initialSize, expand_duration, Easing.OutExpo);
+                    this.FadeIn(expand_duration / 6f);
+                    break;
+
+                case ButtonState.Exploded:
+                    const int explode_duration = 200;
+                    background.ResizeTo(Vector2.Multiply(initialSize, new Vector2(2, 1)), explode_duration, Easing.OutExpo);
+                    this.FadeOut(explode_duration / 4f * 3);
+                    break;
+            }
+        }
+
         private ButtonSystemState buttonSystemState;
 
         public ButtonSystemState ButtonSystemState

From 3411ebc4af5711c275e21b843b264bc7d96f864b Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 23 May 2024 12:50:06 +0200
Subject: [PATCH 896/930] Move `SDL3BatteryInfo` to separate file

---
 osu.Desktop/OsuGameDesktop.cs  | 20 --------------------
 osu.Desktop/SDL3BatteryInfo.cs | 27 +++++++++++++++++++++++++++
 2 files changed, 27 insertions(+), 20 deletions(-)
 create mode 100644 osu.Desktop/SDL3BatteryInfo.cs

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index e8783c997a..b1e1a8f118 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -22,7 +22,6 @@ using osu.Game.IPC;
 using osu.Game.Online.Multiplayer;
 using osu.Game.Performance;
 using osu.Game.Utils;
-using SDL;
 
 namespace osu.Desktop
 {
@@ -169,24 +168,5 @@ namespace osu.Desktop
             osuSchemeLinkIPCChannel?.Dispose();
             archiveImportIPCChannel?.Dispose();
         }
-
-        private unsafe class SDL3BatteryInfo : BatteryInfo
-        {
-            public override double? ChargeLevel
-            {
-                get
-                {
-                    int percentage;
-                    SDL3.SDL_GetPowerInfo(null, &percentage);
-
-                    if (percentage == -1)
-                        return null;
-
-                    return percentage / 100.0;
-                }
-            }
-
-            public override bool OnBattery => SDL3.SDL_GetPowerInfo(null, null) == SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
-        }
     }
 }
diff --git a/osu.Desktop/SDL3BatteryInfo.cs b/osu.Desktop/SDL3BatteryInfo.cs
new file mode 100644
index 0000000000..89084b5a15
--- /dev/null
+++ b/osu.Desktop/SDL3BatteryInfo.cs
@@ -0,0 +1,27 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Utils;
+using SDL;
+
+namespace osu.Desktop
+{
+    internal unsafe class SDL3BatteryInfo : BatteryInfo
+    {
+        public override double? ChargeLevel
+        {
+            get
+            {
+                int percentage;
+                SDL3.SDL_GetPowerInfo(null, &percentage);
+
+                if (percentage == -1)
+                    return null;
+
+                return percentage / 100.0;
+            }
+        }
+
+        public override bool OnBattery => SDL3.SDL_GetPowerInfo(null, null) == SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
+    }
+}

From 45ed86f46cdf413d1acaa189f0faea7a10b0ad44 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 23 May 2024 12:53:33 +0200
Subject: [PATCH 897/930] Add back `SDL2BatteryInfo`

---
 osu.Desktop/OsuGameDesktop.cs  |  2 +-
 osu.Desktop/SDL2BatteryInfo.cs | 25 +++++++++++++++++++++++++
 2 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 osu.Desktop/SDL2BatteryInfo.cs

diff --git a/osu.Desktop/OsuGameDesktop.cs b/osu.Desktop/OsuGameDesktop.cs
index b1e1a8f118..3e06dad4c5 100644
--- a/osu.Desktop/OsuGameDesktop.cs
+++ b/osu.Desktop/OsuGameDesktop.cs
@@ -160,7 +160,7 @@ namespace osu.Desktop
             host.Window.Title = Name;
         }
 
-        protected override BatteryInfo CreateBatteryInfo() => new SDL3BatteryInfo();
+        protected override BatteryInfo CreateBatteryInfo() => FrameworkEnvironment.UseSDL3 ? new SDL3BatteryInfo() : new SDL2BatteryInfo();
 
         protected override void Dispose(bool isDisposing)
         {
diff --git a/osu.Desktop/SDL2BatteryInfo.cs b/osu.Desktop/SDL2BatteryInfo.cs
new file mode 100644
index 0000000000..9ca2dc3a5c
--- /dev/null
+++ b/osu.Desktop/SDL2BatteryInfo.cs
@@ -0,0 +1,25 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using osu.Game.Utils;
+
+namespace osu.Desktop
+{
+    internal class SDL2BatteryInfo : BatteryInfo
+    {
+        public override double? ChargeLevel
+        {
+            get
+            {
+                SDL2.SDL.SDL_GetPowerInfo(out _, out int percentage);
+
+                if (percentage == -1)
+                    return null;
+
+                return percentage / 100.0;
+            }
+        }
+
+        public override bool OnBattery => SDL2.SDL.SDL_GetPowerInfo(out _, out _) == SDL2.SDL.SDL_PowerState.SDL_POWERSTATE_ON_BATTERY;
+    }
+}

From ccf8473aae70b4898c7289c2601a07e418e23257 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 23 May 2024 13:00:18 +0200
Subject: [PATCH 898/930] Use appropriate `SDL_ShowSimpleMessageBox`

---
 osu.Desktop/Program.cs | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 23e56cdce9..0d8de8dce7 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -28,6 +28,14 @@ namespace osu.Desktop
 
         private static LegacyTcpIpcProvider? legacyIpc;
 
+        private static unsafe void showMessageBox(string title, string message)
+        {
+            if (FrameworkEnvironment.UseSDL3)
+                SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR, title, message, null);
+            else
+                SDL2.SDL.SDL_ShowSimpleMessageBox(SDL2.SDL.SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR, title, message, IntPtr.Zero);
+        }
+
         [STAThread]
         public static void Main(string[] args)
         {
@@ -52,19 +60,15 @@ namespace osu.Desktop
                 // See https://www.mongodb.com/docs/realm/sdk/dotnet/compatibility/
                 if (windowsVersion.Major < 6 || (windowsVersion.Major == 6 && windowsVersion.Minor <= 2))
                 {
-                    unsafe
-                    {
-                        // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
-                        // disabling it ourselves.
-                        // We could also better detect compatibility mode if required:
-                        // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
-                        SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
-                            "Your operating system is too old to run osu!"u8,
-                            "This version of osu! requires at least Windows 8.1 to run.\n"u8
-                            + "Please upgrade your operating system or consider using an older version of osu!.\n\n"u8
-                            + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!"u8, null);
-                        return;
-                    }
+                    // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
+                    // disabling it ourselves.
+                    // We could also better detect compatibility mode if required:
+                    // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
+                    showMessageBox("Your operating system is too old to run osu!",
+                        "This version of osu! requires at least Windows 8.1 to run.\n"
+                        + "Please upgrade your operating system or consider using an older version of osu!.\n\n"
+                        + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!");
+                    return;
                 }
 
                 setupSquirrel();

From 070668c96f4494958b0e1b4464dd4059e9ba0ec5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 13:55:11 +0200
Subject: [PATCH 899/930] Use `ShiftPressed` instead of explicitly checking
 both physical keys

Not only is this simpler, but it also is more correct (for explanation
why, try holding both shift keys while dragging, and just releasing one
of them - the previous code would briefly turn aspect ratio off).
---
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs    | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index c188d23a58..12787a1c55 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -51,9 +51,9 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
-            if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
+            if (IsDragged)
             {
-                applyScale(shouldLockAspectRatio: true);
+                applyScale(shouldLockAspectRatio: e.ShiftPressed);
                 return true;
             }
 
@@ -64,8 +64,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
         {
             base.OnKeyUp(e);
 
-            if (IsDragged && (e.Key == Key.ShiftLeft || e.Key == Key.ShiftRight))
-                applyScale(shouldLockAspectRatio: false);
+            if (IsDragged)
+                applyScale(shouldLockAspectRatio: e.ShiftPressed);
         }
 
         protected override void OnDragEnd(DragEndEvent e)

From 9e86a08405db8a88fec2066975843b13ae831eed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 14:07:43 +0200
Subject: [PATCH 900/930] Simplify scale origin computation

---
 .../Components/SelectionBoxScaleHandle.cs      | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 12787a1c55..352a4985d6 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -2,6 +2,7 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using osu.Framework.Allocation;
+using osu.Framework.Extensions;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
@@ -102,21 +103,8 @@ namespace osu.Game.Screens.Edit.Compose.Components
                 ? new Vector2((rawScale.X + rawScale.Y) * 0.5f)
                 : rawScale;
 
-            scaleHandler!.Update(newScale, getOriginPosition(), getAdjustAxis());
-        }
-
-        private Vector2 getOriginPosition()
-        {
-            var quad = scaleHandler!.OriginalSurroundingQuad!.Value;
-            Vector2 origin = quad.TopLeft;
-
-            if ((originalAnchor & Anchor.x0) > 0)
-                origin.X += quad.Width;
-
-            if ((originalAnchor & Anchor.y0) > 0)
-                origin.Y += quad.Height;
-
-            return origin;
+            var scaleOrigin = originalAnchor.Opposite().PositionOnQuad(scaleHandler!.OriginalSurroundingQuad!.Value);
+            scaleHandler!.Update(newScale, scaleOrigin, getAdjustAxis());
         }
 
         private Axes getAdjustAxis()

From abca62d5f0e545cd167305d292f09944a6397cd1 Mon Sep 17 00:00:00 2001
From: Susko3 <Susko3@protonmail.com>
Date: Thu, 23 May 2024 14:24:42 +0200
Subject: [PATCH 901/930] Revert "Use appropriate `SDL_ShowSimpleMessageBox`"

This reverts commit ccf8473aae70b4898c7289c2601a07e418e23257.
---
 osu.Desktop/Program.cs | 30 +++++++++++++-----------------
 1 file changed, 13 insertions(+), 17 deletions(-)

diff --git a/osu.Desktop/Program.cs b/osu.Desktop/Program.cs
index 0d8de8dce7..23e56cdce9 100644
--- a/osu.Desktop/Program.cs
+++ b/osu.Desktop/Program.cs
@@ -28,14 +28,6 @@ namespace osu.Desktop
 
         private static LegacyTcpIpcProvider? legacyIpc;
 
-        private static unsafe void showMessageBox(string title, string message)
-        {
-            if (FrameworkEnvironment.UseSDL3)
-                SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR, title, message, null);
-            else
-                SDL2.SDL.SDL_ShowSimpleMessageBox(SDL2.SDL.SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR, title, message, IntPtr.Zero);
-        }
-
         [STAThread]
         public static void Main(string[] args)
         {
@@ -60,15 +52,19 @@ namespace osu.Desktop
                 // See https://www.mongodb.com/docs/realm/sdk/dotnet/compatibility/
                 if (windowsVersion.Major < 6 || (windowsVersion.Major == 6 && windowsVersion.Minor <= 2))
                 {
-                    // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
-                    // disabling it ourselves.
-                    // We could also better detect compatibility mode if required:
-                    // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
-                    showMessageBox("Your operating system is too old to run osu!",
-                        "This version of osu! requires at least Windows 8.1 to run.\n"
-                        + "Please upgrade your operating system or consider using an older version of osu!.\n\n"
-                        + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!");
-                    return;
+                    unsafe
+                    {
+                        // If users running in compatibility mode becomes more of a common thing, we may want to provide better guidance or even consider
+                        // disabling it ourselves.
+                        // We could also better detect compatibility mode if required:
+                        // https://stackoverflow.com/questions/10744651/how-i-can-detect-if-my-application-is-running-under-compatibility-mode#comment58183249_10744730
+                        SDL3.SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags.SDL_MESSAGEBOX_ERROR,
+                            "Your operating system is too old to run osu!"u8,
+                            "This version of osu! requires at least Windows 8.1 to run.\n"u8
+                            + "Please upgrade your operating system or consider using an older version of osu!.\n\n"u8
+                            + "If you are running a newer version of windows, please check you don't have \"Compatibility mode\" turned on for osu!"u8, null);
+                        return;
+                    }
                 }
 
                 setupSquirrel();

From f17f70dca7eeb60690d83435d0bdba399fdd38bd Mon Sep 17 00:00:00 2001
From: Aurelian <romanresistance@gmail.com>
Date: Thu, 23 May 2024 14:36:49 +0200
Subject: [PATCH 902/930] Changed Size to be handled by AutoSizeAxes

---
 .../Sliders/Components/SliderBodyPiece.cs           | 13 ++-----------
 .../Skinning/Default/ManualSliderBody.cs            | 13 +++++--------
 2 files changed, 7 insertions(+), 19 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
index 14d72a2d36..44c754d8f5 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
@@ -3,6 +3,7 @@
 
 using System.Collections.Generic;
 using osu.Framework.Allocation;
+using osu.Framework.Graphics;
 using osu.Game.Graphics;
 using osu.Game.Rulesets.Osu.Objects;
 using osu.Game.Rulesets.Osu.Skinning.Default;
@@ -41,6 +42,7 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
         private void load(OsuColour colours)
         {
             body.BorderColour = colours.Yellow;
+            AutoSizeAxes = Axes.Both;
         }
 
         private int? lastVersion;
@@ -64,17 +66,6 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
             OriginPosition = body.PathOffset;
         }
 
-        public override Vector2 Size
-        {
-            get
-            {
-                if (base.Size != body.Size)
-                    Size = body.Size;
-                return base.Size;
-            }
-            set => base.Size = value;
-        }
-
         public void RecyclePath() => body.RecyclePath();
 
         public override bool ReceivePositionalInputAt(Vector2 screenSpacePos) => body.ReceivePositionalInputAt(screenSpacePos);
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
index 99d954059c..2fc18da254 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
@@ -2,6 +2,8 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
+using osu.Framework.Allocation;
+using osu.Framework.Graphics;
 using osuTK;
 
 namespace osu.Game.Rulesets.Osu.Skinning.Default
@@ -13,15 +15,10 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
     {
         public new void SetVertices(IReadOnlyList<Vector2> vertices) => base.SetVertices(vertices);
 
-        public override Vector2 Size
+        [BackgroundDependencyLoader]
+        private void load()
         {
-            get
-            {
-                if (base.Size != Path.Size)
-                    Size = Path.Size;
-                return base.Size;
-            }
-            set => base.Size = value;
+            AutoSizeAxes = Axes.Both;
         }
     }
 }

From ac5c031a3a077cc5072b7f6b331623aa91681d58 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 14:18:29 +0200
Subject: [PATCH 903/930] Simplify original state management in skin selection
 scale handler

---
 .../SkinEditor/SkinSelectionScaleHandler.cs   | 47 ++++++++++---------
 1 file changed, 25 insertions(+), 22 deletions(-)

diff --git a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
index 0c2ee6aae3..08df8df7e2 100644
--- a/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
+++ b/osu.Game/Overlays/SkinEditor/SkinSelectionScaleHandler.cs
@@ -53,13 +53,8 @@ namespace osu.Game.Overlays.SkinEditor
 
         private bool allSelectedSupportManualSizing(Axes axis) => selectedItems.All(b => (b as CompositeDrawable)?.AutoSizeAxes.HasFlagFast(axis) == false);
 
-        private Drawable[]? objectsInScale;
-
+        private Dictionary<Drawable, OriginalDrawableState>? objectsInScale;
         private Vector2? defaultOrigin;
-        private Dictionary<Drawable, float>? originalWidths;
-        private Dictionary<Drawable, float>? originalHeights;
-        private Dictionary<Drawable, Vector2>? originalScales;
-        private Dictionary<Drawable, Vector2>? originalPositions;
 
         private bool isFlippedX;
         private bool isFlippedY;
@@ -71,12 +66,8 @@ namespace osu.Game.Overlays.SkinEditor
 
             changeHandler?.BeginChange();
 
-            objectsInScale = selectedItems.Cast<Drawable>().ToArray();
-            originalWidths = objectsInScale.ToDictionary(d => d, d => d.Width);
-            originalHeights = objectsInScale.ToDictionary(d => d, d => d.Height);
-            originalScales = objectsInScale.ToDictionary(d => d, d => d.Scale);
-            originalPositions = objectsInScale.ToDictionary(d => d, d => d.ToScreenSpace(d.OriginPosition));
-            OriginalSurroundingQuad = ToLocalSpace(GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.ScreenSpaceDrawQuad.GetVertices().ToArray())));
+            objectsInScale = selectedItems.Cast<Drawable>().ToDictionary(d => d, d => new OriginalDrawableState(d));
+            OriginalSurroundingQuad = ToLocalSpace(GeometryUtils.GetSurroundingQuad(objectsInScale.SelectMany(d => d.Key.ScreenSpaceDrawQuad.GetVertices().ToArray())));
             defaultOrigin = OriginalSurroundingQuad.Value.Centre;
 
             isFlippedX = false;
@@ -88,7 +79,7 @@ namespace osu.Game.Overlays.SkinEditor
             if (objectsInScale == null)
                 throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
 
-            Debug.Assert(originalWidths != null && originalHeights != null && originalScales != null && originalPositions != null && defaultOrigin != null && OriginalSurroundingQuad != null);
+            Debug.Assert(defaultOrigin != null && OriginalSurroundingQuad != null);
 
             var actualOrigin = ToScreenSpace(origin ?? defaultOrigin.Value);
 
@@ -132,9 +123,9 @@ namespace osu.Game.Overlays.SkinEditor
                 return;
             }
 
-            foreach (var b in objectsInScale)
+            foreach (var (b, originalState) in objectsInScale)
             {
-                UpdatePosition(b, GeometryUtils.GetScaledPosition(scale, actualOrigin, originalPositions[b]));
+                UpdatePosition(b, GeometryUtils.GetScaledPosition(scale, actualOrigin, originalState.ScreenSpaceOriginPosition));
 
                 var currentScale = scale;
                 if (Precision.AlmostEquals(MathF.Abs(b.Rotation) % 180, 90))
@@ -143,15 +134,15 @@ namespace osu.Game.Overlays.SkinEditor
                 switch (adjustAxis)
                 {
                     case Axes.X:
-                        b.Width = MathF.Abs(originalWidths[b] * currentScale.X);
+                        b.Width = MathF.Abs(originalState.Width * currentScale.X);
                         break;
 
                     case Axes.Y:
-                        b.Height = MathF.Abs(originalHeights[b] * currentScale.Y);
+                        b.Height = MathF.Abs(originalState.Height * currentScale.Y);
                         break;
 
                     case Axes.Both:
-                        b.Scale = originalScales[b] * currentScale;
+                        b.Scale = originalState.Scale * currentScale;
                         break;
                 }
             }
@@ -165,11 +156,23 @@ namespace osu.Game.Overlays.SkinEditor
             changeHandler?.EndChange();
 
             objectsInScale = null;
-            originalPositions = null;
-            originalWidths = null;
-            originalHeights = null;
-            originalScales = null;
             defaultOrigin = null;
         }
+
+        private struct OriginalDrawableState
+        {
+            public float Width { get; }
+            public float Height { get; }
+            public Vector2 Scale { get; }
+            public Vector2 ScreenSpaceOriginPosition { get; }
+
+            public OriginalDrawableState(Drawable drawable)
+            {
+                Width = drawable.Width;
+                Height = drawable.Height;
+                Scale = drawable.Scale;
+                ScreenSpaceOriginPosition = drawable.ToScreenSpace(drawable.OriginPosition);
+            }
+        }
     }
 }

From f7bcccacb03358667fa40d0603bb01d3233bf591 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 14:41:59 +0200
Subject: [PATCH 904/930] Simplify original state management in osu! scale
 handler

---
 .../Edit/OsuSelectionScaleHandler.cs          | 54 ++++++++++---------
 1 file changed, 29 insertions(+), 25 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 7d5240fb69..b0299c5668 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -55,12 +55,8 @@ namespace osu.Game.Rulesets.Osu.Edit
             CanScaleDiagonally.Value = CanScaleX.Value && CanScaleY.Value;
         }
 
-        private OsuHitObject[]? objectsInScale;
-
+        private Dictionary<OsuHitObject, OriginalHitObjectState>? objectsInScale;
         private Vector2? defaultOrigin;
-        private Dictionary<OsuHitObject, Vector2>? originalPositions;
-        private Dictionary<IHasPath, Vector2[]>? originalPathControlPointPositions;
-        private Dictionary<IHasPath, PathType?[]>? originalPathControlPointTypes;
 
         public override void Begin()
         {
@@ -69,18 +65,11 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             changeHandler?.BeginChange();
 
-            objectsInScale = selectedMovableObjects.ToArray();
-            OriginalSurroundingQuad = objectsInScale.Length == 1 && objectsInScale.First() is Slider slider
+            objectsInScale = selectedMovableObjects.ToDictionary(ho => ho, ho => new OriginalHitObjectState(ho));
+            OriginalSurroundingQuad = objectsInScale.Count == 1 && objectsInScale.First().Key is Slider slider
                 ? GeometryUtils.GetSurroundingQuad(slider.Path.ControlPoints.Select(p => p.Position))
-                : GeometryUtils.GetSurroundingQuad(objectsInScale);
+                : GeometryUtils.GetSurroundingQuad(objectsInScale.Keys);
             defaultOrigin = OriginalSurroundingQuad.Value.Centre;
-            originalPositions = objectsInScale.ToDictionary(obj => obj, obj => obj.Position);
-            originalPathControlPointPositions = objectsInScale.OfType<IHasPath>().ToDictionary(
-                obj => obj,
-                obj => obj.Path.ControlPoints.Select(point => point.Position).ToArray());
-            originalPathControlPointTypes = objectsInScale.OfType<IHasPath>().ToDictionary(
-                obj => obj,
-                obj => obj.Path.ControlPoints.Select(p => p.Type).ToArray());
         }
 
         public override void Update(Vector2 scale, Vector2? origin = null, Axes adjustAxis = Axes.Both)
@@ -88,22 +77,26 @@ namespace osu.Game.Rulesets.Osu.Edit
             if (objectsInScale == null)
                 throw new InvalidOperationException($"Cannot {nameof(Update)} a scale operation without calling {nameof(Begin)} first!");
 
-            Debug.Assert(originalPositions != null && originalPathControlPointPositions != null && defaultOrigin != null && originalPathControlPointTypes != null && OriginalSurroundingQuad != null);
+            Debug.Assert(defaultOrigin != null && OriginalSurroundingQuad != null);
 
             Vector2 actualOrigin = origin ?? defaultOrigin.Value;
 
             // for the time being, allow resizing of slider paths only if the slider is
             // the only hit object selected. with a group selection, it's likely the user
             // is not looking to change the duration of the slider but expand the whole pattern.
-            if (objectsInScale.Length == 1 && objectsInScale.First() is Slider slider)
-                scaleSlider(slider, scale, originalPathControlPointPositions[slider], originalPathControlPointTypes[slider]);
+            if (objectsInScale.Count == 1 && objectsInScale.First().Key is Slider slider)
+            {
+                var originalInfo = objectsInScale[slider];
+                Debug.Assert(originalInfo.PathControlPointPositions != null && originalInfo.PathControlPointTypes != null);
+                scaleSlider(slider, scale, originalInfo.PathControlPointPositions, originalInfo.PathControlPointTypes);
+            }
             else
             {
                 scale = getClampedScale(OriginalSurroundingQuad.Value, actualOrigin, scale);
 
-                foreach (var ho in objectsInScale)
+                foreach (var (ho, originalState) in objectsInScale)
                 {
-                    ho.Position = GeometryUtils.GetScaledPosition(scale, actualOrigin, originalPositions[ho]);
+                    ho.Position = GeometryUtils.GetScaledPosition(scale, actualOrigin, originalState.Position);
                 }
             }
 
@@ -119,9 +112,6 @@ namespace osu.Game.Rulesets.Osu.Edit
 
             objectsInScale = null;
             OriginalSurroundingQuad = null;
-            originalPositions = null;
-            originalPathControlPointPositions = null;
-            originalPathControlPointTypes = null;
             defaultOrigin = null;
         }
 
@@ -193,7 +183,7 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private void moveSelectionInBounds()
         {
-            Quad quad = GeometryUtils.GetSurroundingQuad(objectsInScale!);
+            Quad quad = GeometryUtils.GetSurroundingQuad(objectsInScale!.Keys);
 
             Vector2 delta = Vector2.Zero;
 
@@ -207,8 +197,22 @@ namespace osu.Game.Rulesets.Osu.Edit
             if (quad.BottomRight.Y > OsuPlayfield.BASE_SIZE.Y)
                 delta.Y -= quad.BottomRight.Y - OsuPlayfield.BASE_SIZE.Y;
 
-            foreach (var h in objectsInScale!)
+            foreach (var (h, _) in objectsInScale!)
                 h.Position += delta;
         }
+
+        private struct OriginalHitObjectState
+        {
+            public Vector2 Position { get; }
+            public Vector2[]? PathControlPointPositions { get; }
+            public PathType?[]? PathControlPointTypes { get; }
+
+            public OriginalHitObjectState(OsuHitObject hitObject)
+            {
+                Position = hitObject.Position;
+                PathControlPointPositions = (hitObject as IHasPath)?.Path.ControlPoints.Select(p => p.Position).ToArray();
+                PathControlPointTypes = (hitObject as IHasPath)?.Path.ControlPoints.Select(p => p.Type).ToArray();
+            }
+        }
     }
 }

From 3e34b2d37ed895f9eb707be9921964795c2e750e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 14:56:08 +0200
Subject: [PATCH 905/930] Bring back clamping in osu! scale handler

Being able to flip doesn't really feel all that good and `master` was
already clamping, so let's just bring that back for now. Flipping can be
reconsidered in a follow-up if it actually can be made to behave well.
---
 osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index b0299c5668..75b404684f 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -9,6 +9,7 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
+using osu.Framework.Logging;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
@@ -120,6 +121,8 @@ namespace osu.Game.Rulesets.Osu.Edit
 
         private void scaleSlider(Slider slider, Vector2 scale, Vector2[] originalPathPositions, PathType?[] originalPathTypes)
         {
+            scale = Vector2.ComponentMax(scale, new Vector2(Precision.FLOAT_EPSILON));
+
             // Maintain the path types in case they were defaulted to bezier at some point during scaling
             for (int i = 0; i < slider.Path.ControlPoints.Count; i++)
             {
@@ -178,7 +181,8 @@ namespace osu.Game.Rulesets.Osu.Edit
             if (!Precision.AlmostEquals(selectionQuad.BottomRight.Y - origin.Y, 0))
                 scale.Y = selectionQuad.BottomRight.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, br2.Y, br1.Y) : MathHelper.Clamp(scale.Y, br1.Y, br2.Y);
 
-            return scale;
+            Logger.Log($"scale = {scale}");
+            return Vector2.ComponentMax(scale, new Vector2(Precision.FLOAT_EPSILON));
         }
 
         private void moveSelectionInBounds()

From 128029e2af5bd0d23db7935761807487ded1eb15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 15:08:43 +0200
Subject: [PATCH 906/930] Fix aspect ratio lock applying when shift pressed on
 a non-corner anchor

It doesn't make sense and it wasn't doing the right thing.
---
 .../Edit/Compose/Components/SelectionBoxScaleHandle.cs   | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
index 352a4985d6..eca0c08ba1 100644
--- a/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
+++ b/osu.Game/Screens/Edit/Compose/Components/SelectionBoxScaleHandle.cs
@@ -3,6 +3,7 @@
 
 using osu.Framework.Allocation;
 using osu.Framework.Extensions;
+using osu.Framework.Extensions.EnumExtensions;
 using osu.Framework.Graphics;
 using osu.Framework.Input.Events;
 using osu.Framework.Utils;
@@ -47,14 +48,14 @@ namespace osu.Game.Screens.Edit.Compose.Components
 
             rawScale = convertDragEventToScaleMultiplier(e);
 
-            applyScale(shouldLockAspectRatio: e.ShiftPressed);
+            applyScale(shouldLockAspectRatio: isCornerAnchor(originalAnchor) && e.ShiftPressed);
         }
 
         protected override bool OnKeyDown(KeyDownEvent e)
         {
             if (IsDragged)
             {
-                applyScale(shouldLockAspectRatio: e.ShiftPressed);
+                applyScale(shouldLockAspectRatio: isCornerAnchor(originalAnchor) && e.ShiftPressed);
                 return true;
             }
 
@@ -66,7 +67,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
             base.OnKeyUp(e);
 
             if (IsDragged)
-                applyScale(shouldLockAspectRatio: e.ShiftPressed);
+                applyScale(shouldLockAspectRatio: isCornerAnchor(originalAnchor) && e.ShiftPressed);
         }
 
         protected override void OnDragEnd(DragEndEvent e)
@@ -123,5 +124,7 @@ namespace osu.Game.Screens.Edit.Compose.Components
                     return Axes.Both;
             }
         }
+
+        private bool isCornerAnchor(Anchor anchor) => !anchor.HasFlagFast(Anchor.x1) && !anchor.HasFlagFast(Anchor.y1);
     }
 }

From d8ba95f87712a7e407a8e28c9c41cc8035b9826a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Thu, 23 May 2024 15:13:42 +0200
Subject: [PATCH 907/930] Remove leftover log

whooops.
---
 osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
index 75b404684f..af03c4d925 100644
--- a/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
+++ b/osu.Game.Rulesets.Osu/Edit/OsuSelectionScaleHandler.cs
@@ -9,7 +9,6 @@ using osu.Framework.Allocation;
 using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Primitives;
-using osu.Framework.Logging;
 using osu.Framework.Utils;
 using osu.Game.Rulesets.Edit;
 using osu.Game.Rulesets.Objects;
@@ -181,7 +180,6 @@ namespace osu.Game.Rulesets.Osu.Edit
             if (!Precision.AlmostEquals(selectionQuad.BottomRight.Y - origin.Y, 0))
                 scale.Y = selectionQuad.BottomRight.Y - origin.Y < 0 ? MathHelper.Clamp(scale.Y, br2.Y, br1.Y) : MathHelper.Clamp(scale.Y, br1.Y, br2.Y);
 
-            Logger.Log($"scale = {scale}");
             return Vector2.ComponentMax(scale, new Vector2(Precision.FLOAT_EPSILON));
         }
 

From b1c7afd75b273c1f7f12738e1a48db7c2c956002 Mon Sep 17 00:00:00 2001
From: Dan Balasescu <smoogipoo@smgi.me>
Date: Thu, 23 May 2024 23:45:04 +0900
Subject: [PATCH 908/930] Move to ctor

---
 .../Blueprints/Sliders/Components/SliderBodyPiece.cs  | 11 ++++++-----
 .../Skinning/Default/ManualSliderBody.cs              |  8 +++-----
 2 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
index 44c754d8f5..12626a77ed 100644
--- a/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
+++ b/osu.Game.Rulesets.Osu/Edit/Blueprints/Sliders/Components/SliderBodyPiece.cs
@@ -28,21 +28,22 @@ namespace osu.Game.Rulesets.Osu.Edit.Blueprints.Sliders.Components
 
         public SliderBodyPiece()
         {
-            InternalChild = body = new ManualSliderBody
-            {
-                AccentColour = Color4.Transparent
-            };
+            AutoSizeAxes = Axes.Both;
 
             // SliderSelectionBlueprint relies on calling ReceivePositionalInputAt on this drawable to determine whether selection should occur.
             // Without AlwaysPresent, a movement in a parent container (ie. the editor composer area resizing) could cause incorrect input handling.
             AlwaysPresent = true;
+
+            InternalChild = body = new ManualSliderBody
+            {
+                AccentColour = Color4.Transparent
+            };
         }
 
         [BackgroundDependencyLoader]
         private void load(OsuColour colours)
         {
             body.BorderColour = colours.Yellow;
-            AutoSizeAxes = Axes.Both;
         }
 
         private int? lastVersion;
diff --git a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
index 2fc18da254..127d13730a 100644
--- a/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
+++ b/osu.Game.Rulesets.Osu/Skinning/Default/ManualSliderBody.cs
@@ -2,7 +2,6 @@
 // See the LICENCE file in the repository root for full licence text.
 
 using System.Collections.Generic;
-using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osuTK;
 
@@ -13,12 +12,11 @@ namespace osu.Game.Rulesets.Osu.Skinning.Default
     /// </summary>
     public partial class ManualSliderBody : SliderBody
     {
-        public new void SetVertices(IReadOnlyList<Vector2> vertices) => base.SetVertices(vertices);
-
-        [BackgroundDependencyLoader]
-        private void load()
+        public ManualSliderBody()
         {
             AutoSizeAxes = Axes.Both;
         }
+
+        public new void SetVertices(IReadOnlyList<Vector2> vertices) => base.SetVertices(vertices);
     }
 }

From a80dbba9d0d4fc836b899b1825692170c1c843d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 10:21:40 +0200
Subject: [PATCH 909/930] Update to not use obsoleted method

---
 osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs | 2 +-
 osu.Game/Screens/Edit/Editor.cs                           | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
index 5930c077a4..8b6f31d599 100644
--- a/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
+++ b/osu.Game.Tests/Visual/Editing/TestSceneMetadataSection.cs
@@ -65,7 +65,7 @@ namespace osu.Game.Tests.Visual.Editing
             // It's important values are committed immediately on focus loss so the editor exit sequence detects them.
             AddAssert("value immediately changed on focus loss", () =>
             {
-                InputManager.TriggerFocusContention(metadataSection);
+                ((IFocusManager)InputManager).TriggerFocusContention(metadataSection);
                 return editorBeatmap.Metadata.Artist;
             }, () => Is.EqualTo("Example ArtistExample Artist"));
         }
diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 47b2a53607..55ab03a590 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -723,7 +723,7 @@ namespace osu.Game.Screens.Edit
             //
             // This is important to ensure that if the user is still editing a textbox, it will commit
             // (and potentially block the exit procedure for save).
-            GetContainingInputManager().TriggerFocusContention(this);
+            GetContainingFocusManager().TriggerFocusContention(this);
 
             if (!ExitConfirmed)
             {

From 807d982a721ec043990d1871f41316763d3b5b15 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 10:24:50 +0200
Subject: [PATCH 910/930] Move workaround to subscreen

---
 osu.Game/Screens/Edit/Editor.cs            |  6 +-----
 osu.Game/Screens/Edit/EditorScreen.cs      |  5 +++++
 osu.Game/Screens/Edit/Setup/SetupScreen.cs | 12 ++++++++++++
 3 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/osu.Game/Screens/Edit/Editor.cs b/osu.Game/Screens/Edit/Editor.cs
index 55ab03a590..07c32983f5 100644
--- a/osu.Game/Screens/Edit/Editor.cs
+++ b/osu.Game/Screens/Edit/Editor.cs
@@ -719,11 +719,7 @@ namespace osu.Game.Screens.Edit
 
         public override bool OnExiting(ScreenExitEvent e)
         {
-            // Before exiting, trigger a focus loss.
-            //
-            // This is important to ensure that if the user is still editing a textbox, it will commit
-            // (and potentially block the exit procedure for save).
-            GetContainingFocusManager().TriggerFocusContention(this);
+            currentScreen?.OnExiting(e);
 
             if (!ExitConfirmed)
             {
diff --git a/osu.Game/Screens/Edit/EditorScreen.cs b/osu.Game/Screens/Edit/EditorScreen.cs
index 3bc870b898..a795b310a2 100644
--- a/osu.Game/Screens/Edit/EditorScreen.cs
+++ b/osu.Game/Screens/Edit/EditorScreen.cs
@@ -6,6 +6,7 @@ using osu.Framework.Bindables;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Cursor;
+using osu.Framework.Screens;
 
 namespace osu.Game.Screens.Edit
 {
@@ -37,6 +38,10 @@ namespace osu.Game.Screens.Edit
 
         protected override void PopOut() => this.FadeOut();
 
+        public virtual void OnExiting(ScreenExitEvent e)
+        {
+        }
+
         #region Clipboard operations
 
         public BindableBool CanCut { get; } = new BindableBool();
diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index 266ea1f929..5345db0a4f 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -5,6 +5,7 @@ using System.Collections.Generic;
 using osu.Framework.Allocation;
 using osu.Framework.Graphics;
 using osu.Framework.Graphics.Shapes;
+using osu.Framework.Screens;
 using osu.Game.Graphics.Containers;
 using osu.Game.Overlays;
 
@@ -55,6 +56,17 @@ namespace osu.Game.Screens.Edit.Setup
             }));
         }
 
+        public override void OnExiting(ScreenExitEvent e)
+        {
+            base.OnExiting(e);
+
+            // Before exiting, trigger a focus loss.
+            //
+            // This is important to ensure that if the user is still editing a textbox, it will commit
+            // (and potentially block the exit procedure for save).
+            GetContainingFocusManager().TriggerFocusContention(this);
+        }
+
         private partial class SetupScreenSectionsContainer : SectionsContainer<SetupSection>
         {
             protected override UserTrackingScrollContainer CreateScrollContainer()

From 7255cc3344e75ec0e0eb1fd99eab94da1f50f784 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 11:25:29 +0200
Subject: [PATCH 911/930] Fix tests dying on a nullref

---
 osu.Game/Screens/Edit/Setup/SetupScreen.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Edit/Setup/SetupScreen.cs b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
index 5345db0a4f..7a7907d08a 100644
--- a/osu.Game/Screens/Edit/Setup/SetupScreen.cs
+++ b/osu.Game/Screens/Edit/Setup/SetupScreen.cs
@@ -64,7 +64,7 @@ namespace osu.Game.Screens.Edit.Setup
             //
             // This is important to ensure that if the user is still editing a textbox, it will commit
             // (and potentially block the exit procedure for save).
-            GetContainingFocusManager().TriggerFocusContention(this);
+            GetContainingFocusManager()?.TriggerFocusContention(this);
         }
 
         private partial class SetupScreenSectionsContainer : SectionsContainer<SetupSection>

From 9045ec24abc5e844da7cc646fcc7fcbb620e75bc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 12:04:09 +0200
Subject: [PATCH 912/930] Rewrite test

---
 .../SongSelect/TestScenePlaySongSelect.cs     | 64 ++++++++++---------
 1 file changed, 34 insertions(+), 30 deletions(-)

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index af8b2a7760..7f0c209215 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -93,49 +93,49 @@ namespace osu.Game.Tests.Visual.SongSelect
             createSongSelect();
             changeMods();
 
-            AddStep("decreasing speed without mods", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("half time activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("decreasing speed with halftime", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.9", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.9);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("half time speed changed to 0.9x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.9).Within(0.005));
 
-            AddStep("increasing speed with halftime", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("halftime at 0.95", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("half time speed changed to 0.95x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("increasing speed with halftime to nomod", () => songSelect?.ChangeSpeed(+0.05));
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
-            AddStep("increasing speed without mods", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("double time activated at 1.05x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
-            AddStep("increasing speed with doubletime", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("doubletime at 1.1", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.1);
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("double time speed changed to 1.1x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.1).Within(0.005));
 
-            AddStep("decreasing speed with doubletime", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModDoubleTime mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("double time speed changed to 1.05x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
             OsuModNightcore nc = new OsuModNightcore
             {
                 SpeedChange = { Value = 1.05 }
             };
             changeMods(nc);
-            AddStep("increasing speed with nightcore", () => songSelect?.ChangeSpeed(+0.05));
-            AddAssert("nightcore at 1.1", () => songSelect!.Mods.Value.Single() is ModNightcore mod && Math.Round(mod.SpeedChange.Value, 2) == 1.1);
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("nightcore speed changed to 1.1x", () => songSelect!.Mods.Value.OfType<ModNightcore>().Single().SpeedChange.Value, () => Is.EqualTo(1.1).Within(0.005));
 
-            AddStep("decreasing speed with nightcore", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("doubletime at 1.05", () => songSelect!.Mods.Value.Single() is ModNightcore mod && Math.Round(mod.SpeedChange.Value, 2) == 1.05);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("nightcore speed changed to 1.05x", () => songSelect!.Mods.Value.OfType<ModNightcore>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
-            AddStep("decreasing speed with nightcore to nomod", () => songSelect?.ChangeSpeed(-0.05));
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
-            AddStep("decreasing speed nomod, nightcore was selected", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("decreasing speed with daycore", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("daycore at 0.9", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.9);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.9).Within(0.005));
 
-            AddStep("increasing speed with daycore", () => songSelect?.ChangeSpeed(0.05));
-            AddAssert("daycore at 0.95", () => songSelect!.Mods.Value.Single() is ModDaycore mod && Math.Round(mod.SpeedChange.Value, 2) == 0.95);
+            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
             OsuModDoubleTime dt = new OsuModDoubleTime
             {
@@ -143,8 +143,9 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AdjustPitch = { Value = true },
             };
             changeMods(dt);
-            AddStep("decreasing speed from doubletime 1.02 with adjustpitch enabled", () => songSelect?.ChangeSpeed(-0.05));
-            AddAssert("halftime at 0.97 with adjustpitch enabled", () => songSelect!.Mods.Value.Single() is ModHalfTime mod && Math.Round(mod.SpeedChange.Value, 2) == 0.97 && mod.AdjustPitch.Value);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            AddAssert("half time activated at 0.97x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.97).Within(0.005));
+            AddAssert("adjust pitch preserved", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().AdjustPitch.Value, () => Is.True);
 
             OsuModHalfTime ht = new OsuModHalfTime
             {
@@ -153,16 +154,19 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
             Mod[] modlist = { ht, new OsuModHardRock(), new OsuModHidden() };
             changeMods(modlist);
-            AddStep("decreasing speed from halftime 0.97 with adjustpitch enabled, HDHR enabled", () => songSelect?.ChangeSpeed(0.05));
-            AddAssert("doubletime at 1.02 with adjustpitch enabled, HDHR still enabled", () => songSelect!.Mods.Value.Count(mod => (mod is ModDoubleTime modDt && modDt.AdjustPitch.Value && Math.Round(modDt.SpeedChange.Value, 2) == 1.02) || mod is ModHardRock || mod is ModHidden) == 3);
+            AddStep("decrease speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("double time activated at 1.02x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.02).Within(0.005));
+            AddAssert("double time activated at 1.02x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().AdjustPitch.Value, () => Is.True);
+            AddAssert("HD still enabled", () => songSelect!.Mods.Value.OfType<ModHidden>().SingleOrDefault(), () => Is.Not.Null);
+            AddAssert("HR still enabled", () => songSelect!.Mods.Value.OfType<ModHardRock>().SingleOrDefault(), () => Is.Not.Null);
 
             changeMods(new ModWindUp());
             AddStep("windup active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
             AddAssert("windup still active", () => songSelect!.Mods.Value.First() is ModWindUp);
 
             changeMods(new ModAdaptiveSpeed());
-            AddStep("adaptivespeed active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
-            AddAssert("adaptivespeed still active", () => songSelect!.Mods.Value.First() is ModAdaptiveSpeed);
+            AddStep("adaptive speed active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
+            AddAssert("adaptive speed still active", () => songSelect!.Mods.Value.First() is ModAdaptiveSpeed);
         }
 
         [Test]

From 63406b6feb2215111626903bceef923ffb5ca46d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 12:59:24 +0200
Subject: [PATCH 913/930] Rewrite implementation

---
 .../SongSelect/TestScenePlaySongSelect.cs     |  51 ++++--
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    |  11 +-
 .../Screens/Select/ModSpeedHotkeyHandler.cs   | 105 ++++++++++++
 osu.Game/Screens/Select/SongSelect.cs         | 152 +-----------------
 4 files changed, 149 insertions(+), 170 deletions(-)
 create mode 100644 osu.Game/Screens/Select/ModSpeedHotkeyHandler.cs

diff --git a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
index 7f0c209215..6581ce0323 100644
--- a/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
+++ b/osu.Game.Tests/Visual/SongSelect/TestScenePlaySongSelect.cs
@@ -93,25 +93,25 @@ namespace osu.Game.Tests.Visual.SongSelect
             createSongSelect();
             changeMods();
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("half time activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("half time speed changed to 0.9x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.9).Within(0.005));
 
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("half time speed changed to 0.95x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("double time activated at 1.05x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("double time speed changed to 1.1x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.1).Within(0.005));
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("double time speed changed to 1.05x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
             OsuModNightcore nc = new OsuModNightcore
@@ -119,22 +119,23 @@ namespace osu.Game.Tests.Visual.SongSelect
                 SpeedChange = { Value = 1.05 }
             };
             changeMods(nc);
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+
+            increaseModSpeed();
             AddAssert("nightcore speed changed to 1.1x", () => songSelect!.Mods.Value.OfType<ModNightcore>().Single().SpeedChange.Value, () => Is.EqualTo(1.1).Within(0.005));
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("nightcore speed changed to 1.05x", () => songSelect!.Mods.Value.OfType<ModNightcore>().Single().SpeedChange.Value, () => Is.EqualTo(1.05).Within(0.005));
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("no mods selected", () => songSelect!.Mods.Value.Count == 0);
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+            decreaseModSpeed();
             AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.9).Within(0.005));
 
-            AddStep("increase speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("daycore activated at 0.95x", () => songSelect!.Mods.Value.OfType<ModDaycore>().Single().SpeedChange.Value, () => Is.EqualTo(0.95).Within(0.005));
 
             OsuModDoubleTime dt = new OsuModDoubleTime
@@ -143,7 +144,8 @@ namespace osu.Game.Tests.Visual.SongSelect
                 AdjustPitch = { Value = true },
             };
             changeMods(dt);
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(-0.05));
+
+            decreaseModSpeed();
             AddAssert("half time activated at 0.97x", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().SpeedChange.Value, () => Is.EqualTo(0.97).Within(0.005));
             AddAssert("adjust pitch preserved", () => songSelect!.Mods.Value.OfType<ModHalfTime>().Single().AdjustPitch.Value, () => Is.True);
 
@@ -154,19 +156,34 @@ namespace osu.Game.Tests.Visual.SongSelect
             };
             Mod[] modlist = { ht, new OsuModHardRock(), new OsuModHidden() };
             changeMods(modlist);
-            AddStep("decrease speed", () => songSelect?.ChangeSpeed(0.05));
+
+            increaseModSpeed();
             AddAssert("double time activated at 1.02x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().SpeedChange.Value, () => Is.EqualTo(1.02).Within(0.005));
             AddAssert("double time activated at 1.02x", () => songSelect!.Mods.Value.OfType<ModDoubleTime>().Single().AdjustPitch.Value, () => Is.True);
             AddAssert("HD still enabled", () => songSelect!.Mods.Value.OfType<ModHidden>().SingleOrDefault(), () => Is.Not.Null);
             AddAssert("HR still enabled", () => songSelect!.Mods.Value.OfType<ModHardRock>().SingleOrDefault(), () => Is.Not.Null);
 
             changeMods(new ModWindUp());
-            AddStep("windup active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("windup still active", () => songSelect!.Mods.Value.First() is ModWindUp);
 
             changeMods(new ModAdaptiveSpeed());
-            AddStep("adaptive speed active, trying to change speed", () => songSelect?.ChangeSpeed(0.05));
+            increaseModSpeed();
             AddAssert("adaptive speed still active", () => songSelect!.Mods.Value.First() is ModAdaptiveSpeed);
+
+            void increaseModSpeed() => AddStep("increase mod speed", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.Up);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
+
+            void decreaseModSpeed() => AddStep("decrease mod speed", () =>
+            {
+                InputManager.PressKey(Key.ControlLeft);
+                InputManager.Key(Key.Down);
+                InputManager.ReleaseKey(Key.ControlLeft);
+            });
         }
 
         [Test]
diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index ad589e8fa9..f8c67f4a10 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -64,9 +64,6 @@ namespace osu.Game.Overlays.Mods
 
         private Func<Mod, bool> isValidMod = _ => true;
 
-        [Resolved]
-        private SongSelect? songSelect { get; set; }
-
         /// <summary>
         /// A function determining whether each mod in the column should be displayed.
         /// A return value of <see langword="true"/> means that the mod is not filtered and therefore its corresponding panel should be displayed.
@@ -138,6 +135,7 @@ namespace osu.Game.Overlays.Mods
         private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
         private FillFlowContainer footerContentFlow = null!;
         private DeselectAllModsButton deselectAllModsButton = null!;
+        private ModSpeedHotkeyHandler modSpeedHotkeyHandler = null!;
 
         private Container aboveColumnsContent = null!;
         private RankingInformationDisplay? rankingInformationDisplay;
@@ -190,7 +188,8 @@ namespace osu.Game.Overlays.Mods
                     Anchor = Anchor.BottomCentre,
                     Origin = Anchor.BottomCentre,
                     Height = 0
-                }
+                },
+                modSpeedHotkeyHandler = new ModSpeedHotkeyHandler(),
             });
 
             MainAreaContent.AddRange(new Drawable[]
@@ -758,11 +757,11 @@ namespace osu.Game.Overlays.Mods
                 }
 
                 case GlobalAction.IncreaseModSpeed:
-                    songSelect?.ChangeSpeed(0.05);
+                    modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
                     return true;
 
                 case GlobalAction.DecreaseModSpeed:
-                    songSelect?.ChangeSpeed(-0.05);
+                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
                     return true;
             }
 
diff --git a/osu.Game/Screens/Select/ModSpeedHotkeyHandler.cs b/osu.Game/Screens/Select/ModSpeedHotkeyHandler.cs
new file mode 100644
index 0000000000..af64002bcf
--- /dev/null
+++ b/osu.Game/Screens/Select/ModSpeedHotkeyHandler.cs
@@ -0,0 +1,105 @@
+// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using System.Collections.Generic;
+using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Bindables;
+using osu.Framework.Graphics;
+using osu.Framework.Utils;
+using osu.Game.Configuration;
+using osu.Game.Overlays;
+using osu.Game.Overlays.OSD;
+using osu.Game.Rulesets.Mods;
+using osu.Game.Utils;
+
+namespace osu.Game.Screens.Select
+{
+    public partial class ModSpeedHotkeyHandler : Component
+    {
+        [Resolved]
+        private Bindable<IReadOnlyList<Mod>> selectedMods { get; set; } = null!;
+
+        [Resolved]
+        private OsuConfigManager config { get; set; } = null!;
+
+        [Resolved]
+        private OnScreenDisplay? onScreenDisplay { get; set; }
+
+        private ModRateAdjust? lastActiveRateAdjustMod;
+
+        protected override void LoadComplete()
+        {
+            base.LoadComplete();
+
+            selectedMods.BindValueChanged(val =>
+            {
+                lastActiveRateAdjustMod = val.NewValue.OfType<ModRateAdjust>().SingleOrDefault() ?? lastActiveRateAdjustMod;
+            }, true);
+        }
+
+        public bool ChangeSpeed(double delta, IEnumerable<Mod> availableMods)
+        {
+            double targetSpeed = (selectedMods.Value.OfType<ModRateAdjust>().SingleOrDefault()?.SpeedChange.Value ?? 1) + delta;
+
+            if (Precision.AlmostEquals(targetSpeed, 1, 0.005))
+            {
+                selectedMods.Value = selectedMods.Value.Where(m => m is not ModRateAdjust).ToList();
+                onScreenDisplay?.Display(new SpeedChangeToast(config, targetSpeed));
+                return true;
+            }
+
+            ModRateAdjust? targetMod;
+
+            if (lastActiveRateAdjustMod is ModDaycore || lastActiveRateAdjustMod is ModNightcore)
+            {
+                targetMod = targetSpeed < 1
+                    ? availableMods.OfType<ModDaycore>().SingleOrDefault()
+                    : availableMods.OfType<ModNightcore>().SingleOrDefault();
+            }
+            else
+            {
+                targetMod = targetSpeed < 1
+                    ? availableMods.OfType<ModHalfTime>().SingleOrDefault()
+                    : availableMods.OfType<ModDoubleTime>().SingleOrDefault();
+            }
+
+            if (targetMod == null)
+                return false;
+
+            // preserve other settings from latest rate adjust mod instance seen
+            if (lastActiveRateAdjustMod != null)
+            {
+                foreach (var (_, sourceProperty) in lastActiveRateAdjustMod.GetSettingsSourceProperties())
+                {
+                    if (sourceProperty.Name == nameof(ModRateAdjust.SpeedChange))
+                        continue;
+
+                    var targetProperty = targetMod.GetType().GetProperty(sourceProperty.Name);
+
+                    if (targetProperty == null)
+                        continue;
+
+                    var targetBindable = (IBindable)targetProperty.GetValue(targetMod)!;
+                    var sourceBindable = (IBindable)sourceProperty.GetValue(lastActiveRateAdjustMod)!;
+
+                    if (targetBindable.GetType() != sourceBindable.GetType())
+                        continue;
+
+                    lastActiveRateAdjustMod.CopyAdjustedSetting(targetBindable, sourceBindable);
+                }
+            }
+
+            targetMod.SpeedChange.Value = targetSpeed;
+
+            var intendedMods = selectedMods.Value.Where(m => m is not ModRateAdjust).Append(targetMod).ToList();
+
+            if (!ModUtils.CheckCompatibleSet(intendedMods))
+                return false;
+
+            selectedMods.Value = intendedMods;
+            onScreenDisplay?.Display(new SpeedChangeToast(config, targetMod.SpeedChange.Value));
+            return true;
+        }
+    }
+}
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index b3823d7a0f..14e3931fce 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -30,7 +30,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Overlays;
 using osu.Game.Overlays.Mods;
-using osu.Game.Overlays.OSD;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
 using osu.Game.Screens.Backgrounds;
@@ -40,6 +39,7 @@ using osu.Game.Screens.Play;
 using osu.Game.Screens.Select.Details;
 using osu.Game.Screens.Select.Options;
 using osu.Game.Skinning;
+using osu.Game.Utils;
 using osuTK;
 using osuTK.Graphics;
 using osuTK.Input;
@@ -137,6 +137,7 @@ namespace osu.Game.Screens.Select
         private double audioFeedbackLastPlaybackTime;
 
         private IDisposable? modSelectOverlayRegistration;
+        private ModSpeedHotkeyHandler modSpeedHotkeyHandler = null!;
 
         private AdvancedStats advancedStats = null!;
 
@@ -148,16 +149,6 @@ namespace osu.Game.Screens.Select
 
         private Bindable<bool> configBackgroundBlur = null!;
 
-        private bool lastPitchState;
-
-        private bool usedPitchMods;
-
-        [Resolved]
-        private OnScreenDisplay? onScreenDisplay { get; set; }
-
-        [Resolved]
-        private OsuConfigManager config { get; set; } = null!;
-
         [BackgroundDependencyLoader(true)]
         private void load(AudioManager audio, OsuColour colours, ManageCollectionsDialog? manageCollectionsDialog, DifficultyRecommender? recommender, OsuConfigManager config)
         {
@@ -333,6 +324,7 @@ namespace osu.Game.Screens.Select
                 {
                     RelativeSizeAxes = Axes.Both,
                 },
+                modSpeedHotkeyHandler = new ModSpeedHotkeyHandler(),
             });
 
             if (ShowFooter)
@@ -823,140 +815,6 @@ namespace osu.Game.Screens.Select
             return false;
         }
 
-        private Mod getRateMod(ModType modType, Type type)
-        {
-            var modList = game.AvailableMods.Value[modType];
-            var multiMod = (MultiMod)modList.First(mod => mod is MultiMod multiMod && multiMod.Mods.Count(mod2 => mod2.GetType().IsSubclassOf(type)) > 0);
-            var mod = multiMod.Mods.First(mod => mod.GetType().IsSubclassOf(type));
-            return mod;
-        }
-
-        public void ChangeSpeed(double delta)
-        {
-            ModNightcore modNc = (ModNightcore)getRateMod(ModType.DifficultyIncrease, typeof(ModNightcore));
-            ModDoubleTime modDt = (ModDoubleTime)getRateMod(ModType.DifficultyIncrease, typeof(ModDoubleTime));
-            ModDaycore modDc = (ModDaycore)getRateMod(ModType.DifficultyReduction, typeof(ModDaycore));
-            ModHalfTime modHt = (ModHalfTime)getRateMod(ModType.DifficultyReduction, typeof(ModHalfTime));
-            bool rateModActive = selectedMods.Value.Count(mod => mod is ModRateAdjust) > 0;
-            bool incompatibleModActive = selectedMods.Value.Count(mod => modDt.IncompatibleMods.Count(incompatibleMod => (mod.GetType().IsSubclassOf(incompatibleMod) || mod.GetType() == incompatibleMod) && incompatibleMod != typeof(ModRateAdjust)) > 0) > 0;
-            double newRate = Math.Round(1d + delta, 2);
-            bool isPositive = delta > 0;
-
-            if (incompatibleModActive)
-                return;
-
-            if (!rateModActive)
-            {
-                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
-
-                // If no ModRateAdjust is active, activate one
-                ModRateAdjust? newMod = null;
-
-                if (isPositive && !usedPitchMods)
-                    newMod = modDt;
-
-                if (isPositive && usedPitchMods)
-                    newMod = modNc;
-
-                if (!isPositive && !usedPitchMods)
-                    newMod = modHt;
-
-                if (!isPositive && usedPitchMods)
-                    newMod = modDc;
-
-                if (!usedPitchMods && newMod is ModDoubleTime newModDt)
-                    newModDt.AdjustPitch.Value = lastPitchState;
-
-                if (!usedPitchMods && newMod is ModHalfTime newModHt)
-                    newModHt.AdjustPitch.Value = lastPitchState;
-
-                newMod!.SpeedChange.Value = newRate;
-                selectedMods.Value = selectedMods.Value.Append(newMod).ToList();
-                return;
-            }
-
-            ModRateAdjust mod = (ModRateAdjust)selectedMods.Value.First(mod => mod is ModRateAdjust);
-            newRate = Math.Round(mod.SpeedChange.Value + delta, 2);
-
-            // Disable RateAdjustMods if newRate is 1
-            if (newRate == 1.0)
-            {
-                lastPitchState = false;
-                usedPitchMods = false;
-
-                if (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value)
-                    lastPitchState = true;
-
-                if (mod is ModHalfTime htmod && htmod.AdjustPitch.Value)
-                    lastPitchState = true;
-
-                if (mod is ModNightcore || mod is ModDaycore)
-                    usedPitchMods = true;
-
-                //Disable RateAdjustMods
-                selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
-
-                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
-
-                return;
-            }
-
-            bool overMaxRateLimit = (mod is ModHalfTime || mod is ModDaycore) && newRate > mod.SpeedChange.MaxValue;
-            bool underMinRateLimit = (mod is ModDoubleTime || mod is ModNightcore) && newRate < mod.SpeedChange.MinValue;
-
-            // Swap mod to opposite mod if newRate exceeds max/min speed values
-            if (overMaxRateLimit || underMinRateLimit)
-            {
-                bool adjustPitch = (mod is ModDoubleTime dtmod && dtmod.AdjustPitch.Value) || (mod is ModHalfTime htmod && htmod.AdjustPitch.Value);
-
-                //Disable RateAdjustMods
-                selectedMods.Value = selectedMods.Value.Where(search => search is not ModRateAdjust).ToList();
-
-                ModRateAdjust? oppositeMod = null;
-
-                switch (mod)
-                {
-                    case ModDoubleTime:
-                        modHt.AdjustPitch.Value = adjustPitch;
-                        oppositeMod = modHt;
-                        break;
-
-                    case ModHalfTime:
-                        modDt.AdjustPitch.Value = adjustPitch;
-                        oppositeMod = modDt;
-                        break;
-
-                    case ModNightcore:
-                        oppositeMod = modDc;
-                        break;
-
-                    case ModDaycore:
-                        oppositeMod = modNc;
-                        break;
-                }
-
-                if (oppositeMod == null) return;
-
-                oppositeMod.SpeedChange.Value = newRate;
-                selectedMods.Value = selectedMods.Value.Append(oppositeMod).ToList();
-
-                onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
-
-                return;
-            }
-
-            // Cap newRate to max/min values and change rate of current active mod
-            if (newRate > mod.SpeedChange.MaxValue && (mod is ModDoubleTime || mod is ModNightcore))
-                newRate = mod.SpeedChange.MaxValue;
-
-            if (newRate < mod.SpeedChange.MinValue && (mod is ModHalfTime || mod is ModDaycore))
-                newRate = mod.SpeedChange.MinValue;
-
-            mod.SpeedChange.Value = newRate;
-
-            onScreenDisplay?.Display(new SpeedChangeToast(config, newRate));
-        }
-
         protected override void Dispose(bool isDisposing)
         {
             base.Dispose(isDisposing);
@@ -1160,11 +1018,11 @@ namespace osu.Game.Screens.Select
             switch (e.Action)
             {
                 case GlobalAction.IncreaseModSpeed:
-                    ChangeSpeed(0.05);
+                    modSpeedHotkeyHandler.ChangeSpeed(0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
                     return true;
 
                 case GlobalAction.DecreaseModSpeed:
-                    ChangeSpeed(-0.05);
+                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
                     return true;
             }
 

From 345fb60679c3017f75b1b2d9dd54c210fde50a25 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 13:08:17 +0200
Subject: [PATCH 914/930] Fix toast strings

---
 osu.Game/Localisation/ToastStrings.cs     | 4 ++--
 osu.Game/Overlays/OSD/SpeedChangeToast.cs | 3 +--
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/osu.Game/Localisation/ToastStrings.cs b/osu.Game/Localisation/ToastStrings.cs
index 25899153f8..942540cfc5 100644
--- a/osu.Game/Localisation/ToastStrings.cs
+++ b/osu.Game/Localisation/ToastStrings.cs
@@ -50,9 +50,9 @@ namespace osu.Game.Localisation
         public static LocalisableString UrlCopied => new TranslatableString(getKey(@"url_copied"), @"URL copied");
 
         /// <summary>
-        /// "Speed changed to"
+        /// "Speed changed to {0:N2}x"
         /// </summary>
-        public static LocalisableString SpeedChangedTo => new TranslatableString(getKey(@"speed_changed"), @"Speed changed to");
+        public static LocalisableString SpeedChangedTo(double speed) => new TranslatableString(getKey(@"speed_changed"), @"Speed changed to {0:N2}x", speed);
 
         private static string getKey(string key) => $@"{prefix}:{key}";
     }
diff --git a/osu.Game/Overlays/OSD/SpeedChangeToast.cs b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
index df4f825541..49d3985b04 100644
--- a/osu.Game/Overlays/OSD/SpeedChangeToast.cs
+++ b/osu.Game/Overlays/OSD/SpeedChangeToast.cs
@@ -1,7 +1,6 @@
 // Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
 // See the LICENCE file in the repository root for full licence text.
 
-using System.Threading;
 using osu.Game.Configuration;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
@@ -11,7 +10,7 @@ namespace osu.Game.Overlays.OSD
     public partial class SpeedChangeToast : Toast
     {
         public SpeedChangeToast(OsuConfigManager config, double newSpeed)
-            : base(CommonStrings.Beatmaps, ToastStrings.SpeedChangedTo + " " + newSpeed.ToString(Thread.CurrentThread.CurrentCulture), config.LookupKeyBindings(GlobalAction.IncreaseModSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseModSpeed))
+            : base(ModSelectOverlayStrings.ModCustomisation, ToastStrings.SpeedChangedTo(newSpeed), config.LookupKeyBindings(GlobalAction.IncreaseModSpeed) + " / " + config.LookupKeyBindings(GlobalAction.DecreaseModSpeed))
         {
         }
     }

From 8cac87e4960253eae950f68c88923ad6dcf622dc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 13:09:07 +0200
Subject: [PATCH 915/930] Fix speed controls in mod select overlay not handling
 repeat

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index f8c67f4a10..bc87bb4e3d 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -704,6 +704,17 @@ namespace osu.Game.Overlays.Mods
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
+            switch (e.Action)
+            {
+                case GlobalAction.IncreaseModSpeed:
+                    modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
+                    return true;
+
+                case GlobalAction.DecreaseModSpeed:
+                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
+                    return true;
+            }
+
             if (e.Repeat)
                 return false;
 
@@ -755,14 +766,6 @@ namespace osu.Game.Overlays.Mods
 
                     return true;
                 }
-
-                case GlobalAction.IncreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-                    return true;
-
-                case GlobalAction.DecreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-                    return true;
             }
 
             return base.OnPressed(e);

From b1b207960a46337b0a64036d575a23b846f638c4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 13:09:44 +0200
Subject: [PATCH 916/930] Actually use return value

---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs | 6 ++----
 osu.Game/Screens/Select/SongSelect.cs      | 6 ++----
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index bc87bb4e3d..8489b06f47 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -707,12 +707,10 @@ namespace osu.Game.Overlays.Mods
             switch (e.Action)
             {
                 case GlobalAction.IncreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-                    return true;
+                    return modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
 
                 case GlobalAction.DecreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-                    return true;
+                    return modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
             }
 
             if (e.Repeat)
diff --git a/osu.Game/Screens/Select/SongSelect.cs b/osu.Game/Screens/Select/SongSelect.cs
index 14e3931fce..269ca37ff5 100644
--- a/osu.Game/Screens/Select/SongSelect.cs
+++ b/osu.Game/Screens/Select/SongSelect.cs
@@ -1018,12 +1018,10 @@ namespace osu.Game.Screens.Select
             switch (e.Action)
             {
                 case GlobalAction.IncreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
-                    return true;
+                    return modSpeedHotkeyHandler.ChangeSpeed(0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
 
                 case GlobalAction.DecreaseModSpeed:
-                    modSpeedHotkeyHandler.ChangeSpeed(-0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
-                    return true;
+                    return modSpeedHotkeyHandler.ChangeSpeed(-0.05, ModUtils.FlattenMods(game.AvailableMods.Value.SelectMany(kv => kv.Value)));
             }
 
             if (e.Repeat)

From cab8cf741073959dc314516bac3e3fb63dcc262b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Fri, 24 May 2024 13:14:06 +0200
Subject: [PATCH 917/930] Move mod speed hotkey handler to user mod select
 overlay

The very base class is the wrong place for it because
`FreeModSelectOverlay` inherits from it, and that one has different
assumptions and rules than "user" selection. In particular, in non-user
selection, more than one rate adjust mod may be active, which breaks the
mod speed hotkey's basic assumptions.
---
 osu.Game/Overlays/Mods/ModSelectOverlay.cs    | 12 ---------
 .../Overlays/Mods/UserModSelectOverlay.cs     | 26 +++++++++++++++++++
 2 files changed, 26 insertions(+), 12 deletions(-)

diff --git a/osu.Game/Overlays/Mods/ModSelectOverlay.cs b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
index 8489b06f47..d2d7ace936 100644
--- a/osu.Game/Overlays/Mods/ModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/ModSelectOverlay.cs
@@ -27,7 +27,6 @@ using osu.Game.Graphics.UserInterface;
 using osu.Game.Input.Bindings;
 using osu.Game.Localisation;
 using osu.Game.Rulesets.Mods;
-using osu.Game.Screens.Select;
 using osu.Game.Utils;
 using osuTK;
 using osuTK.Input;
@@ -135,7 +134,6 @@ namespace osu.Game.Overlays.Mods
         private FillFlowContainer<ShearedButton> footerButtonFlow = null!;
         private FillFlowContainer footerContentFlow = null!;
         private DeselectAllModsButton deselectAllModsButton = null!;
-        private ModSpeedHotkeyHandler modSpeedHotkeyHandler = null!;
 
         private Container aboveColumnsContent = null!;
         private RankingInformationDisplay? rankingInformationDisplay;
@@ -189,7 +187,6 @@ namespace osu.Game.Overlays.Mods
                     Origin = Anchor.BottomCentre,
                     Height = 0
                 },
-                modSpeedHotkeyHandler = new ModSpeedHotkeyHandler(),
             });
 
             MainAreaContent.AddRange(new Drawable[]
@@ -704,15 +701,6 @@ namespace osu.Game.Overlays.Mods
 
         public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
         {
-            switch (e.Action)
-            {
-                case GlobalAction.IncreaseModSpeed:
-                    return modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-
-                case GlobalAction.DecreaseModSpeed:
-                    return modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
-            }
-
             if (e.Repeat)
                 return false;
 
diff --git a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
index 49469b99f3..16d71e557b 100644
--- a/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
+++ b/osu.Game/Overlays/Mods/UserModSelectOverlay.cs
@@ -3,18 +3,30 @@
 
 using System.Collections.Generic;
 using System.Linq;
+using osu.Framework.Allocation;
+using osu.Framework.Input.Events;
+using osu.Game.Input.Bindings;
 using osu.Game.Rulesets.Mods;
+using osu.Game.Screens.Select;
 using osu.Game.Utils;
 
 namespace osu.Game.Overlays.Mods
 {
     public partial class UserModSelectOverlay : ModSelectOverlay
     {
+        private ModSpeedHotkeyHandler modSpeedHotkeyHandler = null!;
+
         public UserModSelectOverlay(OverlayColourScheme colourScheme = OverlayColourScheme.Green)
             : base(colourScheme)
         {
         }
 
+        [BackgroundDependencyLoader]
+        private void load()
+        {
+            Add(modSpeedHotkeyHandler = new ModSpeedHotkeyHandler());
+        }
+
         protected override ModColumn CreateModColumn(ModType modType) => new UserModColumn(modType, false);
 
         protected override IReadOnlyList<Mod> ComputeNewModsFromSelection(IReadOnlyList<Mod> oldSelection, IReadOnlyList<Mod> newSelection)
@@ -38,6 +50,20 @@ namespace osu.Game.Overlays.Mods
             return modsAfterRemoval.ToList();
         }
 
+        public override bool OnPressed(KeyBindingPressEvent<GlobalAction> e)
+        {
+            switch (e.Action)
+            {
+                case GlobalAction.IncreaseModSpeed:
+                    return modSpeedHotkeyHandler.ChangeSpeed(0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
+
+                case GlobalAction.DecreaseModSpeed:
+                    return modSpeedHotkeyHandler.ChangeSpeed(-0.05, AllAvailableMods.Where(state => state.ValidForSelection.Value).Select(state => state.Mod));
+            }
+
+            return base.OnPressed(e);
+        }
+
         private partial class UserModColumn : ModColumn
         {
             public UserModColumn(ModType modType, bool allowIncompatibleSelection)

From 1e90e5e38e22e43c7bbcbb6ee5d11d82aac77216 Mon Sep 17 00:00:00 2001
From: Andrei Zavatski <megaman9919@gmail.com>
Date: Sat, 25 May 2024 13:24:25 +0300
Subject: [PATCH 918/930] Use sb element path as a name

---
 osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs | 1 +
 osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
index fae9ec7f2e..f66f84af7a 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardAnimation.cs
@@ -83,6 +83,7 @@ namespace osu.Game.Storyboards.Drawables
             Origin = animation.Origin;
             Position = animation.InitialPosition;
             Loop = animation.LoopType == AnimationLoopType.LoopForever;
+            Name = animation.Path;
 
             LifetimeStart = animation.StartTime;
             LifetimeEnd = animation.EndTimeForDisplay;
diff --git a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
index ec875219b6..c5d70ddecc 100644
--- a/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
+++ b/osu.Game/Storyboards/Drawables/DrawableStoryboardSprite.cs
@@ -85,6 +85,7 @@ namespace osu.Game.Storyboards.Drawables
             Sprite = sprite;
             Origin = sprite.Origin;
             Position = sprite.InitialPosition;
+            Name = sprite.Path;
 
             LifetimeStart = sprite.StartTime;
             LifetimeEnd = sprite.EndTimeForDisplay;

From 76f13b21da3ed79e9daf3d7421342bdb29762dae Mon Sep 17 00:00:00 2001
From: Joppe27 <joppe27@hotmail.com>
Date: Sat, 25 May 2024 23:28:51 +0200
Subject: [PATCH 919/930] Correct scale of taiko-glow element

---
 osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
index 623243e9e1..487106d879 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
@@ -21,6 +21,8 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
 
         private Sprite sprite = null!;
 
+        private const float base_scale = 0.8f;
+
         [BackgroundDependencyLoader(true)]
         private void load(ISkinSource skin, HealthProcessor? healthProcessor)
         {
@@ -30,7 +32,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                 Origin = Anchor.Centre,
                 Anchor = Anchor.Centre,
                 Alpha = 0,
-                Scale = new Vector2(0.7f),
+                Scale = new Vector2(base_scale),
                 Colour = new Colour4(255, 228, 0, 255),
             };
 
@@ -58,8 +60,8 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
             if (!result.IsHit || !isKiaiActive)
                 return;
 
-            sprite.ScaleTo(0.85f).Then()
-                  .ScaleTo(0.7f, 80, Easing.OutQuad);
+            sprite.ScaleTo(base_scale + 0.15f).Then()
+                  .ScaleTo(base_scale, 80, Easing.OutQuad);
         }
     }
 }

From a62b9fa633437bd31dd375bf6c9b12a8591ff225 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 11:42:36 +0900
Subject: [PATCH 920/930] Revert windows 16px icon to original version

This also fixes the 48px version looking uncanny due to smaller paddings.
---
 osu.Desktop/lazer.ico | Bin 76679 -> 76679 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/osu.Desktop/lazer.ico b/osu.Desktop/lazer.ico
index 24c1c29ba269aaeb38a9b9c604a1c364c986a753..d5dbf933c1c6795b54b485b349aa76f914707996 100644
GIT binary patch
delta 11340
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
b&=ZDEW}Izh;E>_$Qd7_DezO;xnO^@5U$|tB

delta 11404
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


From 0d6adf160bcff5da41e5e2262b7e223163670179 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 14:20:28 +0900
Subject: [PATCH 921/930] Share scale factor with hit target

---
 .../Skinning/Legacy/LegacyKiaiGlow.cs                  |  8 +++-----
 .../Skinning/Legacy/TaikoLegacyHitTarget.cs            | 10 ++++++++--
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
index 487106d879..9877efa127 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/LegacyKiaiGlow.cs
@@ -21,8 +21,6 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
 
         private Sprite sprite = null!;
 
-        private const float base_scale = 0.8f;
-
         [BackgroundDependencyLoader(true)]
         private void load(ISkinSource skin, HealthProcessor? healthProcessor)
         {
@@ -32,7 +30,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                 Origin = Anchor.Centre,
                 Anchor = Anchor.Centre,
                 Alpha = 0,
-                Scale = new Vector2(base_scale),
+                Scale = new Vector2(TaikoLegacyHitTarget.SCALE),
                 Colour = new Colour4(255, 228, 0, 255),
             };
 
@@ -60,8 +58,8 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
             if (!result.IsHit || !isKiaiActive)
                 return;
 
-            sprite.ScaleTo(base_scale + 0.15f).Then()
-                  .ScaleTo(base_scale, 80, Easing.OutQuad);
+            sprite.ScaleTo(TaikoLegacyHitTarget.SCALE + 0.15f).Then()
+                  .ScaleTo(TaikoLegacyHitTarget.SCALE, 80, Easing.OutQuad);
         }
     }
 }
diff --git a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
index 0b43f1c845..2a008d81d9 100644
--- a/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
+++ b/osu.Game.Rulesets.Taiko/Skinning/Legacy/TaikoLegacyHitTarget.cs
@@ -12,6 +12,12 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
 {
     public partial class TaikoLegacyHitTarget : CompositeDrawable
     {
+        /// <summary>
+        /// In stable this is 0.7f (see https://github.com/peppy/osu-stable-reference/blob/7519cafd1823f1879c0d9c991ba0e5c7fd3bfa02/osu!/GameModes/Play/Rulesets/Taiko/RulesetTaiko.cs#L592)
+        /// but for whatever reason this doesn't match visually.
+        /// </summary>
+        public const float SCALE = 0.8f;
+
         [BackgroundDependencyLoader]
         private void load(ISkinSource skin)
         {
@@ -22,7 +28,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                 new Sprite
                 {
                     Texture = skin.GetTexture("approachcircle"),
-                    Scale = new Vector2(0.83f),
+                    Scale = new Vector2(SCALE + 0.03f),
                     Alpha = 0.47f, // eyeballed to match stable
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
@@ -30,7 +36,7 @@ namespace osu.Game.Rulesets.Taiko.Skinning.Legacy
                 new Sprite
                 {
                     Texture = skin.GetTexture("taikobigcircle"),
-                    Scale = new Vector2(0.8f),
+                    Scale = new Vector2(SCALE),
                     Alpha = 0.22f, // eyeballed to match stable
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,

From 11c3d11db9b66097d61f877cb2e9b602bf90b5e5 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 14:38:43 +0900
Subject: [PATCH 922/930] Fix cinema mod not hiding playfield skin layer

---
 osu.Game/Rulesets/Mods/ModCinema.cs |  2 ++
 osu.Game/Screens/Play/HUDOverlay.cs | 15 +++++++++------
 2 files changed, 11 insertions(+), 6 deletions(-)

diff --git a/osu.Game/Rulesets/Mods/ModCinema.cs b/osu.Game/Rulesets/Mods/ModCinema.cs
index 7c88a8a588..0c00eb6ae0 100644
--- a/osu.Game/Rulesets/Mods/ModCinema.cs
+++ b/osu.Game/Rulesets/Mods/ModCinema.cs
@@ -36,6 +36,8 @@ namespace osu.Game.Rulesets.Mods
         {
             overlay.ShowHud.Value = false;
             overlay.ShowHud.Disabled = true;
+
+            overlay.PlayfieldSkinLayer.Hide();
         }
 
         public void ApplyToPlayer(Player player)
diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 9d7a05bc90..16dfff8c19 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -109,7 +109,10 @@ namespace osu.Game.Screens.Play
 
         private readonly List<Drawable> hideTargets;
 
-        private readonly Drawable playfieldComponents;
+        /// <summary>
+        /// The container for skin components attached to <see cref="TargetArea.Playfield"/>
+        /// </summary>
+        internal readonly Drawable PlayfieldSkinLayer;
 
         public HUDOverlay([CanBeNull] DrawableRuleset drawableRuleset, IReadOnlyList<Mod> mods, bool alwaysShowLeaderboard = true)
         {
@@ -129,7 +132,7 @@ namespace osu.Game.Screens.Play
                 drawableRuleset != null
                     ? (rulesetComponents = new HUDComponentsContainer(drawableRuleset.Ruleset.RulesetInfo) { AlwaysPresent = true, })
                     : Empty(),
-                playfieldComponents = drawableRuleset != null
+                PlayfieldSkinLayer = drawableRuleset != null
                     ? new SkinComponentsContainer(new SkinComponentsContainerLookup(SkinComponentsContainerLookup.TargetArea.Playfield, drawableRuleset.Ruleset.RulesetInfo)) { AlwaysPresent = true, }
                     : Empty(),
                 topRightElements = new FillFlowContainer
@@ -247,10 +250,10 @@ namespace osu.Game.Screens.Play
             {
                 Quad playfieldScreenSpaceDrawQuad = drawableRuleset.Playfield.SkinnableComponentScreenSpaceDrawQuad;
 
-                playfieldComponents.Position = ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft);
-                playfieldComponents.Width = (ToLocalSpace(playfieldScreenSpaceDrawQuad.TopRight) - ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft)).Length;
-                playfieldComponents.Height = (ToLocalSpace(playfieldScreenSpaceDrawQuad.BottomLeft) - ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft)).Length;
-                playfieldComponents.Rotation = drawableRuleset.Playfield.Rotation;
+                PlayfieldSkinLayer.Position = ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft);
+                PlayfieldSkinLayer.Width = (ToLocalSpace(playfieldScreenSpaceDrawQuad.TopRight) - ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft)).Length;
+                PlayfieldSkinLayer.Height = (ToLocalSpace(playfieldScreenSpaceDrawQuad.BottomLeft) - ToLocalSpace(playfieldScreenSpaceDrawQuad.TopLeft)).Length;
+                PlayfieldSkinLayer.Rotation = drawableRuleset.Playfield.Rotation;
             }
 
             float? lowestTopScreenSpaceLeft = null;

From bdfce4b9dafc90314e6b55f448e899d164ca1d97 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 May 2024 08:26:00 +0200
Subject: [PATCH 923/930] Fix xmldoc reference

---
 osu.Game/Screens/Play/HUDOverlay.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/Play/HUDOverlay.cs b/osu.Game/Screens/Play/HUDOverlay.cs
index 16dfff8c19..0c0941573c 100644
--- a/osu.Game/Screens/Play/HUDOverlay.cs
+++ b/osu.Game/Screens/Play/HUDOverlay.cs
@@ -110,7 +110,7 @@ namespace osu.Game.Screens.Play
         private readonly List<Drawable> hideTargets;
 
         /// <summary>
-        /// The container for skin components attached to <see cref="TargetArea.Playfield"/>
+        /// The container for skin components attached to <see cref="SkinComponentsContainerLookup.TargetArea.Playfield"/>
         /// </summary>
         internal readonly Drawable PlayfieldSkinLayer;
 

From b6471f0b9cd4ebb3dee155990e89b44e1e2a14f8 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 17:09:35 +0900
Subject: [PATCH 924/930] Allow previewing audio of playlist items

---
 .../Drawables/Cards/BeatmapCardThumbnail.cs   |  5 +-
 osu.Game/Overlays/BeatmapSet/BasicStats.cs    |  5 +-
 .../Overlays/BeatmapSet/Buttons/PlayButton.cs |  5 +-
 .../BeatmapSet/Buttons/PreviewButton.cs       |  6 +--
 osu.Game/Overlays/BeatmapSet/Details.cs       |  1 +
 .../OnlinePlay/DrawableRoomPlaylistItem.cs    | 49 ++++++++++++++++---
 6 files changed, 51 insertions(+), 20 deletions(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index cd498c474a..e70d115715 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -8,7 +8,6 @@ using osu.Framework.Graphics;
 using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Game.Beatmaps.Drawables.Cards.Buttons;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Overlays;
 using osu.Framework.Graphics.UserInterface;
 using osuTK;
@@ -36,14 +35,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public BeatmapCardThumbnail(APIBeatmapSet beatmapSetInfo)
+        public BeatmapCardThumbnail(IBeatmapSetInfo beatmapSetInfo)
         {
             InternalChildren = new Drawable[]
             {
                 new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
                 {
                     RelativeSizeAxes = Axes.Both,
-                    OnlineInfo = beatmapSetInfo
+                    OnlineInfo = beatmapSetInfo as IBeatmapSetOnlineInfo
                 },
                 background = new Box
                 {
diff --git a/osu.Game/Overlays/BeatmapSet/BasicStats.cs b/osu.Game/Overlays/BeatmapSet/BasicStats.cs
index 0b1befe7b9..364874cdf7 100644
--- a/osu.Game/Overlays/BeatmapSet/BasicStats.cs
+++ b/osu.Game/Overlays/BeatmapSet/BasicStats.cs
@@ -16,7 +16,6 @@ using osu.Game.Beatmaps;
 using osu.Game.Extensions;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Sprites;
-using osu.Game.Online.API.Requests.Responses;
 using osu.Game.Resources.Localisation.Web;
 using osuTK;
 
@@ -26,9 +25,9 @@ namespace osu.Game.Overlays.BeatmapSet
     {
         private readonly Statistic length, bpm, circleCount, sliderCount;
 
-        private APIBeatmapSet beatmapSet;
+        private IBeatmapSetInfo beatmapSet;
 
-        public APIBeatmapSet BeatmapSet
+        public IBeatmapSetInfo BeatmapSet
         {
             get => beatmapSet;
             set
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
index 5f9cdf5065..921f136de9 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PlayButton.cs
@@ -11,6 +11,7 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Sprites;
 using osu.Framework.Input.Events;
 using osu.Game.Audio;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.UserInterface;
 using osu.Game.Online.API.Requests.Responses;
@@ -28,9 +29,9 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
         [CanBeNull]
         public PreviewTrack Preview { get; private set; }
 
-        private APIBeatmapSet beatmapSet;
+        private IBeatmapSetInfo beatmapSet;
 
-        public APIBeatmapSet BeatmapSet
+        public IBeatmapSetInfo BeatmapSet
         {
             get => beatmapSet;
             set
diff --git a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
index 2254514a44..1eff4a7c11 100644
--- a/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
+++ b/osu.Game/Overlays/BeatmapSet/Buttons/PreviewButton.cs
@@ -8,9 +8,9 @@ using osu.Framework.Graphics.Containers;
 using osu.Framework.Graphics.Shapes;
 using osu.Framework.Input.Events;
 using osu.Game.Audio;
+using osu.Game.Beatmaps;
 using osu.Game.Graphics;
 using osu.Game.Graphics.Containers;
-using osu.Game.Online.API.Requests.Responses;
 using osuTK;
 
 namespace osu.Game.Overlays.BeatmapSet.Buttons
@@ -24,7 +24,7 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         public IBindable<bool> Playing => playButton.Playing;
 
-        public APIBeatmapSet BeatmapSet
+        public IBeatmapSetInfo BeatmapSet
         {
             get => playButton.BeatmapSet;
             set => playButton.BeatmapSet = value;
@@ -32,8 +32,6 @@ namespace osu.Game.Overlays.BeatmapSet.Buttons
 
         public PreviewButton()
         {
-            Height = 42;
-
             Children = new Drawable[]
             {
                 background = new Box
diff --git a/osu.Game/Overlays/BeatmapSet/Details.cs b/osu.Game/Overlays/BeatmapSet/Details.cs
index d656a6b14b..7d69cb7329 100644
--- a/osu.Game/Overlays/BeatmapSet/Details.cs
+++ b/osu.Game/Overlays/BeatmapSet/Details.cs
@@ -68,6 +68,7 @@ namespace osu.Game.Overlays.BeatmapSet
                 preview = new PreviewButton
                 {
                     RelativeSizeAxes = Axes.X,
+                    Height = 42,
                 },
                 new DetailBox
                 {
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 1b8e2d8be6..b28269c6e6 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -22,6 +22,7 @@ using osu.Framework.Localisation;
 using osu.Framework.Logging;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Collections;
 using osu.Game.Database;
 using osu.Game.Graphics;
@@ -32,6 +33,7 @@ using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
+using osu.Game.Overlays.BeatmapSet.Buttons;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;
@@ -81,7 +83,7 @@ namespace osu.Game.Screens.OnlinePlay
         private Mod[] requiredMods = Array.Empty<Mod>();
 
         private Container maskingContainer;
-        private Container difficultyIconContainer;
+        private FillFlowContainer difficultyIconContainer;
         private LinkFlowContainer beatmapText;
         private LinkFlowContainer authorText;
         private ExplicitContentBeatmapBadge explicitContent;
@@ -93,6 +95,7 @@ namespace osu.Game.Screens.OnlinePlay
         private Drawable removeButton;
         private PanelBackground panelBackground;
         private FillFlowContainer mainFillFlow;
+        private BeatmapCardThumbnail thumbnail;
 
         [Resolved]
         private RealmAccess realm { get; set; }
@@ -282,10 +285,23 @@ namespace osu.Game.Screens.OnlinePlay
 
             if (beatmap != null)
             {
-                difficultyIconContainer.Child = new DifficultyIcon(beatmap, ruleset, requiredMods)
+                difficultyIconContainer.Children = new Drawable[]
                 {
-                    Size = new Vector2(icon_height),
-                    TooltipType = DifficultyIconTooltipType.Extended,
+                    thumbnail = new BeatmapCardThumbnail(beatmap.BeatmapSet!)
+                    {
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                        Width = 60,
+                        RelativeSizeAxes = Axes.Y,
+                        Dimmed = { Value = IsHovered }
+                    },
+                    new DifficultyIcon(beatmap, ruleset, requiredMods)
+                    {
+                        Size = new Vector2(icon_height),
+                        TooltipType = DifficultyIconTooltipType.Extended,
+                        Anchor = Anchor.CentreLeft,
+                        Origin = Anchor.CentreLeft,
+                    },
                 };
             }
             else
@@ -329,7 +345,7 @@ namespace osu.Game.Screens.OnlinePlay
 
         protected override Drawable CreateContent()
         {
-            Action<SpriteText> fontParameters = s => s.Font = OsuFont.Default.With(weight: FontWeight.SemiBold);
+            Action<SpriteText> fontParameters = s => s.Font = OsuFont.Default.With(size: 14, weight: FontWeight.SemiBold);
 
             return maskingContainer = new Container
             {
@@ -364,12 +380,15 @@ namespace osu.Game.Screens.OnlinePlay
                         {
                             new Drawable[]
                             {
-                                difficultyIconContainer = new Container
+                                difficultyIconContainer = new FillFlowContainer
                                 {
                                     Anchor = Anchor.CentreLeft,
                                     Origin = Anchor.CentreLeft,
-                                    AutoSizeAxes = Axes.Both,
-                                    Margin = new MarginPadding { Left = 8, Right = 8 },
+                                    AutoSizeAxes = Axes.X,
+                                    RelativeSizeAxes = Axes.Y,
+                                    Direction = FillDirection.Horizontal,
+                                    Spacing = new Vector2(4),
+                                    Margin = new MarginPadding { Right = 8 },
                                 },
                                 mainFillFlow = new MainFlow(() => SelectedItem.Value == Model || !AllowSelection)
                                 {
@@ -484,6 +503,20 @@ namespace osu.Game.Screens.OnlinePlay
             },
         };
 
+        protected override bool OnHover(HoverEvent e)
+        {
+            if (thumbnail != null)
+                thumbnail.Dimmed.Value = true;
+            return base.OnHover(e);
+        }
+
+        protected override void OnHoverLost(HoverLostEvent e)
+        {
+            if (thumbnail != null)
+                thumbnail.Dimmed.Value = false;
+            base.OnHoverLost(e);
+        }
+
         protected override bool OnClick(ClickEvent e)
         {
             if (AllowSelection && valid.Value)

From 1e2cac3e92f3cec02d28639a1314db80ae0bf022 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 May 2024 11:44:55 +0200
Subject: [PATCH 925/930] Remove unused using directive

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index b28269c6e6..090236d6e2 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -33,7 +33,6 @@ using osu.Game.Online.Chat;
 using osu.Game.Online.Rooms;
 using osu.Game.Overlays;
 using osu.Game.Overlays.BeatmapSet;
-using osu.Game.Overlays.BeatmapSet.Buttons;
 using osu.Game.Resources.Localisation.Web;
 using osu.Game.Rulesets;
 using osu.Game.Rulesets.Mods;

From 1f41261fc7d5e0c0f5a77cc064a1ba3c1d525ff5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 May 2024 12:01:02 +0200
Subject: [PATCH 926/930] Fix test failure

---
 .../Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs        | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
index 6446ebd35f..bd62a8b131 100644
--- a/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
+++ b/osu.Game.Tests/Visual/Multiplayer/TestSceneDrawableRoomPlaylist.cs
@@ -16,6 +16,7 @@ using osu.Framework.Platform;
 using osu.Framework.Testing;
 using osu.Game.Beatmaps;
 using osu.Game.Beatmaps.Drawables;
+using osu.Game.Beatmaps.Drawables.Cards;
 using osu.Game.Database;
 using osu.Game.Graphics.Containers;
 using osu.Game.Graphics.Cursor;
@@ -317,13 +318,13 @@ namespace osu.Game.Tests.Visual.Multiplayer
                 p.RequestResults = _ => resultsRequested = true;
             });
 
+            AddUntilStep("wait for load", () => playlist.ChildrenOfType<DrawableLinkCompiler>().Any() && playlist.ChildrenOfType<BeatmapCardThumbnail>().First().DrawWidth > 0);
             AddStep("move mouse to first item title", () =>
             {
                 var drawQuad = playlist.ChildrenOfType<LinkFlowContainer>().First().ScreenSpaceDrawQuad;
                 var location = (drawQuad.TopLeft + drawQuad.BottomLeft) / 2 + new Vector2(drawQuad.Width * 0.2f, 0);
                 InputManager.MoveMouseTo(location);
             });
-            AddUntilStep("wait for text load", () => playlist.ChildrenOfType<DrawableLinkCompiler>().Any());
             AddAssert("first item title not hovered", () => playlist.ChildrenOfType<DrawableLinkCompiler>().First().IsHovered, () => Is.False);
             AddStep("click left mouse", () => InputManager.Click(MouseButton.Left));
             AddUntilStep("first item selected", () => playlist.ChildrenOfType<DrawableRoomPlaylistItem>().First().IsSelectedItem, () => Is.True);

From d97622491297efa4ee4699b06748588b2ea84a07 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 19:59:25 +0900
Subject: [PATCH 927/930] Standardise padding on both sides of difficulty icon

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 090236d6e2..72866d1694 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -387,7 +387,7 @@ namespace osu.Game.Screens.OnlinePlay
                                     RelativeSizeAxes = Axes.Y,
                                     Direction = FillDirection.Horizontal,
                                     Spacing = new Vector2(4),
-                                    Margin = new MarginPadding { Right = 8 },
+                                    Margin = new MarginPadding { Right = 4 },
                                 },
                                 mainFillFlow = new MainFlow(() => SelectedItem.Value == Model || !AllowSelection)
                                 {

From 75d961e6f2cc74b631a1980be91f3525e4551b80 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 20:03:46 +0900
Subject: [PATCH 928/930] Pass the same thing in twice for better maybe

---
 .../Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs          | 2 +-
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs         | 2 +-
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs        | 2 +-
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs     | 4 ++--
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs       | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
index f44fe2b90c..f5f9d121cc 100644
--- a/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
+++ b/osu.Game.Tests/Visual/Beatmaps/TestSceneBeatmapCardThumbnail.cs
@@ -34,7 +34,7 @@ namespace osu.Game.Tests.Visual.Beatmaps
                 var beatmapSet = CreateAPIBeatmapSet(Ruleset.Value);
                 beatmapSet.OnlineID = 241526; // ID hardcoded to ensure that the preview track exists online.
 
-                Child = thumbnail = new BeatmapCardThumbnail(beatmapSet)
+                Child = thumbnail = new BeatmapCardThumbnail(beatmapSet, beatmapSet)
                 {
                     Anchor = Anchor.Centre,
                     Origin = Anchor.Centre,
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
index 175c15ea7b..2c2761ff0c 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardExtra.cs
@@ -61,7 +61,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        thumbnail = new BeatmapCardThumbnail(BeatmapSet)
+                        thumbnail = new BeatmapCardThumbnail(BeatmapSet, BeatmapSet)
                         {
                             Name = @"Left (icon) area",
                             Size = new Vector2(height),
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
index 18e1584a98..c6ba4f234a 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardNormal.cs
@@ -62,7 +62,7 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                     RelativeSizeAxes = Axes.Both,
                     Children = new Drawable[]
                     {
-                        thumbnail = new BeatmapCardThumbnail(BeatmapSet)
+                        thumbnail = new BeatmapCardThumbnail(BeatmapSet, BeatmapSet)
                         {
                             Name = @"Left (icon) area",
                             Size = new Vector2(height),
diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index e70d115715..5d2717a787 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -35,14 +35,14 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         [Resolved]
         private OverlayColourProvider colourProvider { get; set; } = null!;
 
-        public BeatmapCardThumbnail(IBeatmapSetInfo beatmapSetInfo)
+        public BeatmapCardThumbnail(IBeatmapSetInfo beatmapSetInfo, IBeatmapSetOnlineInfo onlineInfo)
         {
             InternalChildren = new Drawable[]
             {
                 new UpdateableOnlineBeatmapSetCover(BeatmapSetCoverType.List)
                 {
                     RelativeSizeAxes = Axes.Both,
-                    OnlineInfo = beatmapSetInfo as IBeatmapSetOnlineInfo
+                    OnlineInfo = onlineInfo
                 },
                 background = new Box
                 {
diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index 72866d1694..e9126a1404 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -286,7 +286,7 @@ namespace osu.Game.Screens.OnlinePlay
             {
                 difficultyIconContainer.Children = new Drawable[]
                 {
-                    thumbnail = new BeatmapCardThumbnail(beatmap.BeatmapSet!)
+                    thumbnail = new BeatmapCardThumbnail(beatmap.BeatmapSet!, (IBeatmapSetOnlineInfo)beatmap.BeatmapSet!)
                     {
                         Anchor = Anchor.CentreLeft,
                         Origin = Anchor.CentreLeft,

From aad0982e26ba3fe57caf1df7999d7d582c413097 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 27 May 2024 20:33:24 +0900
Subject: [PATCH 929/930] Adjust size of play button / progress to match
 `BeatmapCardThumbnail` usage

---
 osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
index 5d2717a787..7b668d7dc4 100644
--- a/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
+++ b/osu.Game/Beatmaps/Drawables/Cards/BeatmapCardThumbnail.cs
@@ -61,7 +61,6 @@ namespace osu.Game.Beatmaps.Drawables.Cards
                         {
                             Anchor = Anchor.Centre,
                             Origin = Anchor.Centre,
-                            Size = new Vector2(50),
                             InnerRadius = 0.2f
                         },
                         content = new Container
@@ -92,6 +91,9 @@ namespace osu.Game.Beatmaps.Drawables.Cards
         {
             base.Update();
             progress.Progress = playButton.Progress.Value;
+
+            playButton.Scale = new Vector2(DrawWidth / 100);
+            progress.Size = new Vector2(50 * DrawWidth / 100);
         }
 
         private void updateState()

From 405c72c0d66ef895cbb5d34aa6c32e5d81dd5d2c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Bart=C5=82omiej=20Dach?= <dach.bartlomiej@gmail.com>
Date: Mon, 27 May 2024 13:36:44 +0200
Subject: [PATCH 930/930] Fix mod display not being aligned with mapper text

---
 osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
index e9126a1404..ab32ca2558 100644
--- a/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
+++ b/osu.Game/Screens/OnlinePlay/DrawableRoomPlaylistItem.cs
@@ -416,6 +416,8 @@ namespace osu.Game.Screens.OnlinePlay
                                                 new FillFlowContainer
                                                 {
                                                     AutoSizeAxes = Axes.Both,
+                                                    Anchor = Anchor.CentreLeft,
+                                                    Origin = Anchor.CentreLeft,
                                                     Direction = FillDirection.Horizontal,
                                                     Spacing = new Vector2(10f, 0),
                                                     Children = new Drawable[]
@@ -438,7 +440,8 @@ namespace osu.Game.Screens.OnlinePlay
                                                     Child = modDisplay = new ModDisplay
                                                     {
                                                         Scale = new Vector2(0.4f),
-                                                        ExpansionMode = ExpansionMode.AlwaysExpanded
+                                                        ExpansionMode = ExpansionMode.AlwaysExpanded,
+                                                        Margin = new MarginPadding { Vertical = -6 },
                                                     }
                                                 }
                                             }